CreateStringBuilder()

Syntax

Ergebnis = CreateStringBuilder(#StringBuilder [, InkrementLänge])

Erstellt ein neues StringBuilder-Objekt.

Parameter

#StringBuilder	Die Nummer zur Identifizierung des neuen String-Builders. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
InkrementLänge (optional)	Die Länge (in Zeichen), um die der interne Puffer bei Bedarf an mehr Speicherplatz erweitert wird. Falls nicht angegeben, wird eine Standardinkrementlänge von 8192 Zeichen verwendet.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn der String-Builder erfolgreich erstellt wurde, und Null, wenn ein Fehler aufgetreten ist. Wenn #PB_Any als Parameter für #StringBuilder verwendet wurde, wird im Erfolgsfall die neu generierte Nummer zurückgegeben.

Anmerkungen

Ein neuer String-Builder beginnt mit einem leeren String. Verwenden Sie AppendStringBuilderString() oder AppendStringBuilderStringN(), um Inhalt hinzuzufügen. Wenn das Erstellen des Strings abgeschlossen ist, verwenden Sie GetStringBuilderString(), um das Endergebnis abzurufen.

Beispiel

  CreateStringBuilder(0)

  AppendStringBuilderString(0, "Hello ")
  AppendStringBuilderString(0, "World!")
    
  Result$ = GetStringBuilderString(0)
  Debug Result$

Siehe auch

AppendStringBuilderString(), AppendStringBuilderStringN(), GetStringBuilderString(), ResetStringBuilder(), FreeStringBuilder()

Unterstützte OS

Alle