11. Anlage
 
zurück
11.1.3.1. Das Paket Strings


Das Paket Strings enthält die Deklarationen, die für alle Pakete der Zeichenkettenbehandlung nötig sind.

Hierzu gehören die Konstanten Space und Wide_Space, die ein Leerzeichen für Character und Wide_Character definieren, entsprechende Ausnahmen, sowie die folgenden fünf Typen:


1) Alignment (Ausrichtung) wird von den Prozeduren verwendet, bei denen die Ergebniszeichenkette nicht unbedingt die gesamte Länge der Zielzeichenkette füllt. Hierbei wird die Ergebniszeichenkette dann in der Zielzeichenkette entsprechend ausgerichtet:

Der Wertebereich von Alignment ist:
Left - die Ergebniszeichenkette steht links in der Zielzeichenkette, die rechte Seite wird mit Füllzeichen aufgefüllt.
Right - die Ergebniszeichenkette steht rechts in der Zielzeichenkette, die linke Seite wird mit Füllzeichen aufgefüllt.
Center - die Ergebniszeichenkette steht in der Mitte der Zielzeichenkette, die linke und rechte Seite werden mit Füllzeichen aufgefüllt. Läßt sich eine Zeichenkette nicht einwandfrei zentrieren, erscheint auf der rechten Seite ein Füllzeichen mehr.


2) Membership (Mitgliedschaft) wird beim Durchsuchen einer Zeichenkette nach Zeichen aus einem bestimmten Zeichensatz verwendet.

Der Wertebereich von Membership ist:
Inside - es wird nach Zeichen gesucht, die im Zeichensatz enthalten sind.
Outside - es wird nach Zeichen gesucht, die nicht im Zeichensatz enthalten sind.


3) Direction (Richtung) wird beim Durchsuchen einer Zeichenkette nach Zeichen oder Zeichenketten verwendet.

Der Wertebereich von Direction ist:
Forward - die Suche beginnt am Anfang der Zeichenkette und meldet das erste Auftreten der Suchzeichenkette.
Backward - die Suche beginnt am Ende der Zeichenkette und meldet somit das letzte Vorkommen innerhalb dieser Zeichenkette.


4) Trim_End (Beschneiden-Ende) wird beim beschneiden (trimmen) einer Zeichenkette verwendet.

Der Wertebereich von Trim_End ist:
Left - die Leerzeichen an der linken Seite werden entfernt.
Right - die Leerzeichen an der rechten Seite werden entfernt.
Both - die Leerzeichen an beiden Seiten der Zeichenkette werden entfernt.


5) Truncation (Abschneidung) wird von den Prozeduren verwendet, bei denen die Ergebniszeichenkette größer sein kann als die Zielzeichenkette.

Der Wertebereich von Truncation ist:
Left - wenn die Ergebniszeichenkette zu lang ist, wird die Zielzeichenkette von der rechten Seite her aufgefüllt, die Zeichen die an der linken Seite nicht mehr in die Zielzeichenkette passen, werden fallengelassen.
Right - wenn die Ergebniszeichenkette zu lang ist, wird die Zielzeichenkette von der linken Seite her aufgefüllt, die Zeichen die an der rechten Seite nicht mehr in die Zielzeichenkette passen, werden fallengelassen.
Error - wenn die Zeichenkette zu lang ist wird die Ausnahme Length_Error ausgelöst.


Bei den Definitionen der Ausnahmen handelt es sich um die folgenden:

Length_Error
Wird von Prozeduren zur Zeichenkettenbehandlung ausgelöst, wenn eine Ergebniszeichenkette
(z. B. beim Einfügen oder Ersetzen) länger ist, als die Zielzeichenkette und nicht angegeben
wurde, daß die Zeichenkette dann abgeschnitten werden soll.

Pattern_Error
Wird von Suchfunktionen ausgelöst, wenn die zu suchende Zeichenkette eine leere
Zeichenkette ist.

Index_Error
Wird von Funktionen und Prozeduren zur Zeichenkettenbehandlung ausgelöst, wenn die
Indexposition, an der eine Zeichenkette eingefügt oder ersetzt werden soll, außerhalb der
Grenzen der zu bearbeitenden Zeichenkette liegt.

Translation_Error
Wird bei der Erstellung einer Zeichen-auf-Zeichen-Abbildung ausgelöst, wenn sich die Anzahl
der Ursprungszeichen von denen der Zielzeichen unterscheidet oder ein Ursprungszeichen
mehrfach abgebildet werden soll.

Spezifikation des Paketes Ada.Strings


 
zurück
 Index   Ada Tour - Dokumentation  
© 2003 Förderverein Ada Deutschland e.V.