CopyMemoryString()

Syntax

Ergebnis = CopyMemoryString(*String [, @*ZielMemoryID])

Kopiert den String von der angegebenen Adresse zur Ziel-Speicheradresse (sofern diese angegeben wurde), oder an das Ende des vorherigen Puffers (wenn die Ziel-Adresse weggelassen wurde).

Parameter

*String	Die Adresse des zu kopierenden Strings. Der String muss mit einem Null-Zeichen abgeschlossen ("null-terminiert") sein. Der String wird im PB String-Format erwartet.
@*ZielMemoryID (optional)	Der Zeiger auf eine Variable, welche die Adresse des Zielpuffers enthält. Nachdem der String kopiert wurde, wird die Variable "*ZielMemoryID" auf das Null-Zeichen am Ende des kopierten Strings verweisen, wodurch ein weiterer Aufruf dieser Funktion den neuen String an den vorherigen anfügt. Wird dieser Parameter weggelassen, wird die Adresse des vorherigen Aufrufs verwendet.

Rückgabewert

Gibt den Wert von "*ZielMemoryID" zurück, nachdem der String kopiert wurde.

Beispiel

  *Puffer = AllocateMemory(1000)
  *Pointer = *Puffer
  CopyMemoryString("Hello", @*Pointer)
  CopyMemoryString(" World")  ; Dieser String wird einfach nach "Hello" im Speicherpuffer eingefügt
  *Pointer-4                  ; Setzt den Zeiger um 2 Unicode-Zeichen zurück (auf das 'l' von 'World')
  CopyMemoryString("LD")      ; Schließlich werden die letzten beiden Zeichen groß geschrieben
  Debug PeekS(*Puffer)

Siehe auch

CopyMemory(), PeekS(), PokeS()

Unterstützte OS

Alle