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

CxiString

class CxiString

CxiString ist eine Hilfsklasse zur Aufnahme von Zeichenketten. Die Daten werden von der Klasse dynamisch verwaltet.

Memberfunktionen:

CxiString ()
initialisiert das Objekt mit einer leeren Zeichenkette (Länge 0)

CxiString (const char *ptr)
CxiString (const CxiString& str)
initialisieren das Objekt mit einer Kopie des Parameters

~CxiString ()
löscht das Objekt

const char * QueryPointer () const
operator const char * () const
liefern einen Zeiger auf den Datenbereich des Strings, der Bereich darf nicht verändert werden (Es gibt keinen NULL-String, sondern nur einen Leerstring, daher wird niemals ein NULL-Zeiger geliefert)

int operator ! () const
liefert 1, wenn der String leer ist, sonst 0

char operator [] (int index) const
liefert das index-te Zeichen des Strings; das erste Zeichen hat den Index 0; bei falschem Index wird '\0' geliefert

char operator * () const
liefert das erste Zeichen des Strings; bei einem Leerstring wird '\0' geliefert

friend CxiString operator + (const CxiString& str1, const CxiString& str2)
friend CxiString operator & (const CxiString& str1, const CxiString& str2)
fügt zwei Strings aneinander und liefert das Ergebnis zurück

CxiString& operator = (const CxiString& str)
CxiString& operator = (const char *ptr)
ersetzen den Inhalt des Strings durch eine Kopie des Parameters

CxiString& operator += (const CxiString& str)
CxiString& operator += (const char *ptr)
CxiString& operator &= (const CxiString& str)
CxiString& operator &= (const char *ptr)
hängt str bzw. ptr an den String an

unsigned int Length ()
liefert die Länge (Anzahl Zeichen) des Strings

CxiString operator () (int start) const
liefert den Teilstring ab der Stelle start bis zum Ende der Zeichenkette

CxiString operator () (int start, int len) const
liefert den Teilstring ab der Stelle start in der Länge len, maximal jedoch bis zum Ende der Zeichenkette

friend int operator == (const CxiString& str1, const CxiString& str2)
friend int operator != (const CxiString& str1, const CxiString& str2)
friend int operator <= (const CxiString& str1, const CxiString& str2)
friend int operator >= (const CxiString& str1, const CxiString& str2)
friend int operator < (const CxiString& str1, const CxiString& str2)
friend int operator > (const CxiString& str1, const CxiString& str2)
vergleichen zwei Strings lexikographisch und liefern jeweils 0 oder 1

CxiString (const String& svstr)
operator String () const
stellen Operatoren zur Konvertierung von und nach String-Objekten von StarView zur Verfügung, dazu muss der StarView-Header vor CXIB.H eingebunden werden.

Portabilität:
Diese Klasse ist in allen unterstützten Systemen verfügbar.

Siehe auch:
CxiErrorString - Fehlermeldung als Zeichenkette
CxiTimeString - Datum/Zeit als Zeichenkette
EnumVarName - Abfrage von Variablennamen
GetAsStr - Variable als Zeichenkette auslesen