Sprung zum Seitenende Struktur Themen A...Z Titel << >>

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

StringNameMap - Konvertierung in Namensdarstellung

[C] char * cxiStringNameMap (char *target, const char *source)

[S3:SPEZIAL] Hilfsfunktion zur Konvertierung von Variablennamen

target:
Puffer für umgewandelten String

source:
Umzuwandelnder Quellstring oder NULL

return:
target

Diese Funktion wird vom CXI-System verwendet, 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.

Folgende Zeichenumsetzungen werden vorgenommen:
- Buchstaben, Ziffern und zulässige Sonderzeichen werden unverändert übernommen.
- Sprachabhängige Sonderzeichen werden soweit möglich in Standardzeichen umgesetzt.
- Alle sonstigen Zeichen werden durch Unterstreichungszeichen ('_') ersetzt.

Es erfolgt keine Umsetzung von Klein- auf Großbuchstaben!

Portabilität:
Diese Funktion ist ab Version 2.05 definiert und in allen unterstützten Systemen verfügbar. Sie ersetzt die nicht mehr vorhandene Funktion cxiStringConvert. Ab Version 2.07 61 werden ungültige Zeichen nicht mehr in Leerzeichen, sondern in Unterstreichungszeichen umgesetzt.

Siehe auch:
CxiName - Variablennamen
cxiStringByteMap - Konvertierung allgemein
cxiStringCaseMap - Konvertierung in Großbuchstaben

Beispiel:
Die folgende Konvertierungstabelle (Ausschnitt) wird bei DOS und OS/2 (erweiterter ASCII-Zeichensatz, Codepage 437 oder 850/858) eingesetzt:

[Graphik: Konvertierungsbeispiel]


[i] CXI-Basis-Programmierreferenz
Version 2.10 72 (1014-001), erstellt am 15. April 2000
Textseite 88 von 855, Thema 8280 (StringNameMap)
[c] Copyright (c) 1996-2000 by TeraConnect GmbH

Sprung zum Seitenanfang Struktur Themen A...Z Titel << >>