class String : public StorableObject

Diese Klasse verwaltet einen String

Inheritance:


Public

Anfragen und Tests
friend bool operator== (const String&, const String&)
Test auf Gleichheit
friend bool operator!= (const String&, const String&)
Test auf Ungleichheit
bool beginsWith( const String& string )
Test, ob der String mit dem angegebenen String anfaengt
int length()
Liefert die Laenge des Strings
Fehlerklassen
class StringException: public Exception
Allgemeine Fehlerklasse
class ConversionException: public StringException
Umwandlungsfehlerklasse
Inhalt ändern
friend String operator+ (const String&, const String&)
Einen zweiten String angängen
const String& operator= (const String& s)
Zuweisung eines neuen Wertes
Konvertierungen
const char* cString()
cString (also Char-Ptr zurueckgeben)
int asInt()
Liefert einen Int, indem es den eigenen Wert als Dezimalzahl interpretiert
virtual String toString()
Beschreibung als String fuer die Ausgabe auf einem Terminal
Strings anlegen und zerstören
String(const char* newValue="")
Neuer String aus einer Zeichenkette
String(const int newValue)
Neuer String aus einem int-Wert
String(const long newValue)
Neuer String aus einem long-Wert
String(const double newValue)
Neuer String aus einem double-Wert
String(const String& s)
Der Copy-Konstruktor
virtual StorableObject* copy()
Legt eine Kopie des Objekts auf dem Heap an
virtual ~String()
Destruktor
Teilstrings erfragen
String leftString( int charCount )
Liefert einen Teilstring, links beginnend
String rightString( int charCount )
Liefert einen Teilstring, rechts endend
String subString( int leftIndex, int charCount = UNDEF_INT )
Liefert einen Teilstring

Private Fields

int len
Laenge des Strings
char* value
Char-Pointer, der auf den eigentlichen Inhalt zeigt.

Private Methods

String(int length, char dummyParameter)
Konstruktor für uninitialisierten String der gegebenen Läenge

Inherited from StorableObject:

Public

Ausgabe auf dem Terminal

void printOn(ostream& = cout)
Ausgabe der Beschreibung auf einen Stream
virtual String toString()
Beschreibung als String fuer die Ausgabe auf einem Terminal

Objekte anlegen und zerstören

virtual StorableObject* copy()
Legt eine Kopie des Objekts auf dem Heap an und liefert einen Zeiger darauf zurück
virtual ~StorableObject()
Der virtuelle Destruktor

Documentation

Diese Klasse verwaltet einen String.

Quelltext

[Header] | [Implementierung]

CVS Informationen zum Interface

 
  **************************************************
  *
  * Aktueller Stand
  *
  *   $RCSfile: String.h,v $
  *   $Revision: 1.26 $
  *   $Date: 1998/08/14 13:21:24 $
  *   $Author: myritz $ 
  *
  **************************************************
  
Fehlerklassen

class StringException: public Exception
Allgemeine Fehlerklasse

class ConversionException: public StringException
Umwandlungsfehlerklasse. Sie wird bei fehlschlagenden Umwandlungen, z.b. in einen int-Wert erzeugt.

Strings anlegen und zerstören

String(const char* newValue="")
Neuer String aus einer Zeichenkette
Parameters:
newValue - Der String wird mit dieser Zeichenkette initialisiert.

String(const int newValue)
Neuer String aus einem int-Wert
Parameters:
newValue - Der String wird mit einer Zeichenkette, die diesen int-Wert darstellt, initialisiert.

String(const long newValue)
Neuer String aus einem long-Wert
Parameters:
newValue - Der String wird mit einer Zeichenkette, die diesen long-Wert darstellt, initialisiert.

String(const double newValue)
Neuer String aus einem double-Wert
Parameters:
newValue - Der String wird mit einer Zeichenkette, die diesen double-Wert darstellt, initialisiert.

String(const String& s)
Der Copy-Konstruktor
Parameters:
s - Der String wird mit den Werten des Strings s initialisiert.

virtual StorableObject* copy()
Legt eine Kopie des Objekts auf dem Heap an
Returns:
Zeiger auf die neu allozierte Kopie
See Also:
StorableObject::copy

virtual ~String()
Destruktor. Der Belegte Speicher wird wieder freigegeben.

Anfragen und Tests

friend bool operator== (const String&, const String&)
Test auf Gleichheit

friend bool operator!= (const String&, const String&)
Test auf Ungleichheit

bool beginsWith( const String& string )
Test, ob der String mit dem angegebenen String anfaengt
Returns:
YES, wenn der Anfang des Strings mit dem Argument uebereinstimmt, NO sonst.
Parameters:
string - wird mit dem Anfang des Strings verglichen.

int length()
Liefert die Laenge des Strings. Das abschließende 0-Byte wird nicht mitgezählt.
Returns:
Anzahl der Zeichen im String.

Inhalt ändern

friend String operator+ (const String&, const String&)
Einen zweiten String angängen

const String& operator= (const String& s)
Zuweisung eines neuen Wertes

Teilstrings erfragen

String leftString( int charCount )
Liefert einen Teilstring, links beginnend
Returns:
Anfangsstueck des Strings mit der gewaehlten Laenge
Parameters:
charCount - Laenge des Teilstrings. Ist die Laenge kleiner als 0, wird ein leerer String zurueckgegeben. Ist die Laenge groesser als die Stringlaenge, wird der gesamte String zurueckgegeben.

String rightString( int charCount )
Liefert einen Teilstring, rechts endend
Returns:
Endstueck des Strings mit der gewaehlten Laenge
Parameters:
charCount - Laenge des Teilstrings. Ist die Laenge kleiner als 0, wird ein leerer String zurueckgegeben. Ist die Laenge groesser als die Stringlaenge, wird der gesamte String zurueckgegeben.

String subString( int leftIndex, int charCount = UNDEF_INT )
Liefert einen Teilstring
Returns:
Teilstueck des Strings in der gewaehlten Laenge, beginnend ab dem gewaehlten Index.
Parameters:
leftIndex - Index bei dem der Teilstring anfangen soll. Das erste Zeichen des Strings hat den Index 0. Ist der Index kleiner als 0, wird bei 0 begonnen. Ist der Index groesser als die Stringlaenge, dann wird ein leerer String zurückgegeben.
charCount - Laenge des Teilstrings. Ist die Laenge kleiner als 0, wird ein leerer String zurueckgegeben. Falls die Laenge ab dem Index die Laenge des Strings ueberschreitet, wird sie so gesetzt, das sie bis zum Ende des Strings reicht.

Konvertierungen

const char* cString()
cString (also Char-Ptr zurueckgeben). Der String darf nicht geändert werden. Der gelieferte Pointer ist nur solange gültig, wie das String-Objekt existiert, daß ihn geliefert hat.
Returns:
Char-Zeiger auf den String

int asInt()
Liefert einen Int, indem es den eigenen Wert als Dezimalzahl interpretiert.

Hier sollte eigentlich eine String::ConversionException erzeugt werden, falls die Konvertierung fehlschlägt. Wer es schafft, atoi den entsprechenden Fehlerstatus zu entlocken, darf mir gerne die neue Routine zukommen lassen.

Returns:
der ensprechende int-Wert. Schlägt die Konvertierung fehl, wird 0 geliefert.

virtual String toString()
Beschreibung als String fuer die Ausgabe auf einem Terminal. String selbst liefert nur sich selbst zurück, die allgemeine ( Foo ... ) Konvention verletzend.
Returns:
Der String selbst

char* value
Char-Pointer, der auf den eigentlichen Inhalt zeigt.

int len
Laenge des Strings

String(int length, char dummyParameter)
Konstruktor für uninitialisierten String der gegebenen Läenge. Der Konstruktor wird von operator+ und subString verwendet.
Parameters:
length - Die gewünschte Länge
dummyParameter - , dessen Wert nicht interpretiert wird. Er ist notwendig, um den Konstruktor von String(int) zu unterscheiden.


This class has no child classes.

alphabetic index hierarchy of classes


Hauptseite

Einleitung | Architektur | Dynamische Zusammenhänge | Referenzhandbuch | FAQ | Anhang A | Anhang B

generated by doc++