CharArrayToString

Kopiert wandelt Teil des Arrays des Typs uchar in die Rückgabezeile um.

string  CharArrayToString(
   uchar   array[],             // Array
   int     start=0,             // Anfangsposition im Array 
   int     count=-1             // Anzahl der Zeichen 
   uint    codepage=CP_ACP      // Codeseite 
   );

Parameter

array[]

[in]  Array des Typs uchar.

start=0

[in] Position, aus der Kopieren anfängt.  Default-Wert ist 0.

count=-1

[in]  Zahl der Arrayelementen für Kopieren. Bestimmt die Länge der sich ergebenden Zeichenkette. Default-Wert ist -1, was bedeutet Kopieren bis zum Arrayende oder bis zur abschließenden 0.

codepage=CP_ACP

[in]  Wert der Codeseite. Für die gebräuchlichsten Codepages gibt es entsprechende Konstanten.

Rückgabewert

Zeichenkette.

 

Beispiel:

//+------------------------------------------------------------------+
//| Skript Programm Start Funktion                                   |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- ein Array der Zeichencodes erstellen
   uchar array[]= { 84, 104, 105, 115,  32, 105, 115,  32,  97,  32,
                   116, 101, 115, 116,  32, 111, 102,  32, 116, 104,
                   101,  32,  67, 104,  97, 114,  65, 114, 114,  97,
                   121,  84, 111,  83, 116, 114, 105, 110, 103,  40,
                    41,  32, 102, 117, 110,  99, 116, 105, 111, 110
                  };
//--- ein in eine Zeichenkette umgewandeltes Array von Codes in das Journal ausdrucken
   Print(CharArrayToString(array));
 
//--- ein Array mit Codes der Zeichen und abschließenden Null erstellen
   uchar array_z[]= { 84, 104, 105, 115,  32, 105, 115,  32,  97,  32,
                     116, 101, 115, 116,   0,  32, 111, 102,  32, 116,
                     104, 101,  32,  67, 104,  97, 114,  65, 114, 114,
                      97, 121,  84, 111,  83, 116, 114, 105, 110, 103,
                      40,  41,  32, 102, 117, 110,  99, 116, 105, 111, 110
                    };
//--- das zweite Array von Codes mit der abschließenden Null im Journal ausgeben
   PrintFormat("%s ...", CharArrayToString(array_z));
 
   /*
  Ergebnis:
   This is a test of the CharArrayToString() function
   This is a test ...
   */
  }

Siehe auch

StringToCharArray, ShortArrayToString, Verwenden von Codepages