CXI-Basis-Programmierreferenz / Version 2 / Tools / Hilfsfunktionen /

StringByteMap - Konvertierung einer Zeichenkette

char * cxiStringByteMap (char *target, const char *source, CxiLong options)

Hilfsfunktionen zur Konvertierung von Zeichenketten

target:
Puffer für umgewandelten String

source:
Umzuwandelnder Quellstring oder NULL

options:
ODER-Verknüpfung von Optionen (siehe Text)

return:
target

Diese Funktion wird vom CXI-System verwendet, um Konvertierungen durchzuführen und um Variablennamen in die interne Darstellung umzuwandeln und ungültige Zeichen abzufangen.

Ist source==NULL, so muss target auf einen nullterminierten String zeigen; dieser wird dann an Ort und Stelle konvertiert.

Bei source!=NULL zeigt target auf einen uninitialisierten Puffer, der mindestens strlen(source)+1 Bytes groß sein muss; die Zeichen werden aus source gelesen und konvertiert nach target geschrieben, target wird mit einem Nullbyte abgeschlossen.

Die Funktion cxiStringByteMap führt folgende Konvertierungen durch:

1. Falls die Option cxiOptStrToNative angegeben ist, wird die Zeichenkette vom externen Format in die interne Darstellung (Zeichensatz, Codepage) umgewandelt.

2. Falls die Option cxiOptStrToName angegeben ist, werden Umsetzungen für die Namensdarstellung (siehe cxiStringNameMap) vorgenommen.

3. Falls die Option cxiOptStrToUpper angegeben ist, werden Kleinbuchstaben in Großbuchstaben (siehe cxiStringCaseMap) umgewandelt.

4. Falls die Option cxiOptStrToExternal angegeben ist, wird die Zeichenkette vom internen Format (Zeichensatz, Codepage) in die externe Darstellung umgewandelt.

Portabilität:
Diese Funktion ist ab Version 2.05 definiert und in allen unterstützten Systemen verfügbar.

Siehe auch:
CxiName - Variablennamen
cxiStringCaseMap - Konvertierung in Großbuchstaben
cxiStringNameMap - Konvertierung in Namensdarstellung