Inhaltsverzeichnis

Alphanumeric/Alphabetic

Achtung - diese Seite ist in noch Bearbeitung und beschreibt eine Funktionalität der noch geändert werden kann!

Diese Klasse wird verwendet für alphanumerische Zeichenfolgen. Für die Formatangabe muss eine von der Klasse AlphanumericFormat abgeleitete Klasse definiert werden.

public sealed class Alphanumeric<TFormat>
	where TFormat : AlphanumericFormat;

Diese Klasse wird verwendet für alphabetische Zeichenfolgen. Für die Formatangabe muss eine von der Klasse AlphabeticFormat abgeleitete Klasse definiert werden.

public sealed class Alphabetic<TFormat>
	where TFormat : AlphabeticFormat;

Eigenschaften/Methoden

Die meisten Eigenschaften und Methoden für Alphanumeric und Alphabetic sind gleich. Deshalb verwenden sie eine gemeinsame Basisklasse StringElement.

Formatangaben

Length

public int Length;

Anzahl erlaubter Zeichen.

Methoden

Substitute

public string Substitute(int start, string value);
public string Substitute(int start, int length, string value);

Liefert den Wert das Datenelementes als Zeichenfolge, wobei der Text ab der angegebenen Position in der angegebenen Länge oder bis zum Ende durch den angegebenen neuen Text ersetzt wird. Der neue Text wird, falls notwendig, bis zur erforderlichen Länge rechts mit Leerzeichen aufgefüllt.

Diese Methode wird u.A. bei Zuweisungen mit einem sog. Reference Modifier verwendet, und steht auch als Erweiterungsmethode für Zeichenfolgen zur Verfügung.

Substring

public string Substring(int start);
public string SubString(int start, int length);

Ruft den Wert das Datenelementes als Teilzeichenfolge ab. Sie beginnt an der angegebene Position und hat ein angegebene Länge, oder wird bis ans Ende fortgesetzt.

Diese Methode entspricht die .NET String.Substring() Funktion, und wird für die Umsetzung von Ausdrücke mit einem sog. Reference Modifier verwendet.

Upto

public string Upto(string stopAt = null);

Liefert den Wert das Datenelementes als Zeichenfolge, wobei der Text bis zum ersten Vorkommen des Begrenzers abgeschnitten wird. Falls der Begrenzer nicht vorkommt, wird der ganze Text als Ergebnis geliefert.

Diese Methode wird u.A. bei der Umsetzung des STRING-Anweisung verwendet, und steht auch als Erweiterungsmethode für Zeichenfolgen zur Verfügung.

ToLower

public string ToLower();

Gibt den Inhalt als eine in Kleinbuchstaben konvertierte Zeichenfolge zurück.

Diese Funktion entspricht die .NET String.ToLower() Funktion, und wird für die Umsetzung der LOWER-CASE Funktion verwendet.

ToUpper

public string ToUpper();

Gibt den Inhalt als eine in Großbuchstaben konvertierte Zeichenfolge zurück.

Diese Funktion entspricht die .NET String.ToUpper() Funktion, und wird für die Umsetzung der UPPER-CASE Funktion verwendet.

Eigenschaften

Operatoren

implicit

static implicit operator string(StringElement obj);

Liefert den Inhalt des übergebenen StringElement.

static implicit operator Alphabetic<TFormat>(String value);
static implicit operator Alphabetic<TFormat>(StringElement value);

Kreiert ein Alphabetic<TFormat> Instanz von einem beliebige Zeichenfolge, bzw. StringElement. Der übergebene Zeichenfolge darf nur Buchstaben und Leerzeichen enthalten, ansonsten wird ein ArgumentException aufgeworfen.

static implicit operator Alphanumeric<TFormat>(String value);
static implicit operator Alphanumeric<TFormat>(DataElement value);

Kreiert ein Alphanumeric<TFormat> Instanz von einem beliebige Zeichenfolge, bzw. DataElement.

(Un)Equal

static bool operator ==(StringElement left, StringElement right);
static bool operator ==(StringElement left, String right);
static bool operator ==(String left, StringElement right);
static bool operator !=(StringElement left, StringElement right);
static bool operator !=(StringElement left, String right);
static bool operator !=(String left, StringElement right);

Vergleicht den Inhalt 2 StringElemente bzw. eines StringElement mit eine beliebige Zeichenfolge. Wenn als Zeichenfolge null übergeben wird, wird der Inhalt von StringElement mit String.Empty verglichen, da ein StringElement kein null enthalten kann.