Methods summary
public
|
#
__construct( string|object $value = null )
Neue Zeichenkette anlegen und die Erweiterung festlegen. Beim
ersten Erstellen eines Strings wird die interne Kodierung der
Multbyte Erweiterung auf UTF-8 umgestellt.
Neue Zeichenkette anlegen und die Erweiterung festlegen. Beim
ersten Erstellen eines Strings wird die interne Kodierung der
Multbyte Erweiterung auf UTF-8 umgestellt.
Wird als Parameter ein Objekt übergeben, so muss
die Klasse eine __toString Methode besitzen.
Parameters
- $value
- Initialisierung der Zeichenkette
Throw
\Alvine\Types\TypeException Fehlerhafter Parameter
|
public
void
|
#
__set( string $name, string $value )
Wert setzen
Wird beim Setzen einer Eigenschaft aufgerufen. Wird auf
die Eigenschaft string zugegriffen, so wird diese im Stringobjekt
verarbeitet, ansonsten im Alvine-Objekt als Eigenschaft. Bei
Zugriff auf die Eigenschaft string wird zudem das encoding geprüft.
Parameters
- $name
- Name der Eigenschaft
- $value
- Wert der Eigenschaft
Returns
void
See
Overrides
|
public
mixed
|
#
__get( string $name )
Wert abfragen
Je nach Name wird entweder der String-Wert der Klasse,
oder der Wert einer beliebigen Eigenschaft zurückgegeben.
Parameters
- $name
- Name der Eigenschaft
Returns
mixed Wert der Eigenschaft
Throws
See
Overrides
|
public
|
#
setEncoding( string $encoding )
Encoding setzen
Für jeden String kann eine eigene Codierung für die Ausgabe
angegeben werden. Diese wird sowohl von __toString als auch
bei einem direkten Zugriff verwendet $string->string.
Parameters
|
public
string
|
#
__toString( )
Gespeicherten Text als Zeichenkette zurückgeben, wenn nichts
definiert wurde ist der Text UTF-8
Gespeicherten Text als Zeichenkette zurückgeben, wenn nichts
definiert wurde ist der Text UTF-8
Returns
string Zeichenkette des Objekts
Overrides
|
public
integer
|
#
bytes( )
Anzahl der Bytes
Diese Funktion gibt anders als length() die Anzahl der verwendeten Bytes zurück
Returns
integer Anzahl der benötigten Bytes die zur Speicherung des UTF-8 Strings notwendig sind.
See
\Alvine\Types\String->length()
|
public
integer
|
#
length( )
Länge
Bei der Längenberechnung werden Zeichen die Größer als 127 sind, von der PHP-Funktion strlen
als 2 Zeichen zurückgemeldet. Diese Funktion berechnet die echten Zeichenlänge und nicht die
Anzahl der Bytes.
Returns
integer Länge des UTF-8 Strings
See
\Alvine\Types\String->bytes()
|
public
Alvine\Types\StringType
|
#
toLowerCase( )
Diese Funktion wandelt den String in kleine Zeichen um A wird zu a und Ä wird zu ä
Diese Funktion gibt eine Referenz auf sich zurück. Damit kann eine Verkettung erstellt werden.
Diese Funktion wandelt den String in kleine Zeichen um A wird zu a und Ä wird zu ä
Diese Funktion gibt eine Referenz auf sich zurück. Damit kann eine Verkettung erstellt werden.
Returns
|
public
Alvine\Types\StringType
|
#
toUpperCase( )
In Großbuchstaben umwandeln
In Großbuchstaben umwandeln
Diese Funktion wandelt den String in große Zeichen um a wird zu A und ä wird zu Ä
Diese Funktion gibt eine Referenz auf sich zurück. Damit kann eine Verkettung erstellt werden.
Returns
|
public
Alvine\Types\StringType
|
#
trim( )
Zuschneiden
Diese Funktion löscht alle Leerzeichen am Anfang und Ende der
Zeichenkette.
Returns
|
public
boolean
|
#
isEmpty( )
Prüfen ob Leer
Diese Funktion prüft ob der String leer ist und gibt in diesem Fall
true zurück. Wichtig: Anders als die PHP Funktion empty wird bei 0
nicht true zurückgegeben.
Returns
boolean Wenn der String leer ist wird true zurückgegeben.
|
public
Alvine\Types\StringList
|
#
getLines( Alvine\Types\StringType $delimiter,… )
Zeilen
Splittet einen String am Zeilenende und gibt die
einzelnen Zeilen als StringList zurück. Die Funktion prüft
sowohl auf LF, CRLF und CR als auch auf die UTF-8-Trennzeichen.
Parameters
- $delimiter,…
- Trennzeichen
Returns
See
Link
|
public
Alvine\Types\StringList
|
#
explode( Alvine\Types\StringType $delimiter )
Explode
Splittet eine Zeichenkette anhand eines Trennzeichen auf und
gibt eine Stringliste zurück. Die StringList kann per foreach
durchlaufen werden.
Parameters
Returns
See
|
public
string
|
#
getHtmlEntities( )
Wandelt Sonderzeichen in HTML-Entities um und gibt diese zurück
Wandelt Sonderzeichen in HTML-Entities um und gibt diese zurück
Returns
string Zeichenkette mit HTML-Entities
|
public
Alvine\Types\StringType
|
#
append( mixed $string )
Anhängen
Hängt einen String an das Ende des Strings an.
Es kann entweder ein PHP-Typ oder eine Stringklasse
übergeben werden.
Parameters
- $string
- Anzuhängender String
Returns
|
public
int|mixed
|
#
indexOf( string|Alvine\Types\StringType $string, string $offset = null )
Index
Sucht das erste Auftreten von $string im
String und gibt die Position zurück. Ist
$string nicht enthalten so wird false zurück
gegeben.
Parameters
- $string
- Suche nach dieser Zeichenkette
- $offset
- Suche bieginnt ab $offset
Returns
int|mixed Position an der das Zeichen auftritt, oder false
|
public
int|mixed
|
#
lastIndexOf( string|Alvine\Types\StringType $string, string $offset = null )
Index
Sucht das erste Auftreten von $string von
hinten im String und gibt die Position zurück. Ist
$string nicht enthalten so wird false zurück
gegeben.
Parameters
- $string
- Suche nach dieser Zeichenkette
- $offset
- Suche bieginnt ab $offset
Returns
int|mixed Position an der das Zeichen auftritt, oder false
|
public
Alvine\Types\StringType
|
#
getSubstring( int $start, int $length = null )
Substring
Liefert ein neues String-Objekt mit dem definierten
Teilstring zurück. Ist der erste Wert eine negative Zahl,
so wird der Startwert von rechts gezählt. Ist die Länge eine
negative Zahl, so werden $length Zeichen von rechts abgezogen.
$string = new String('1234567890');
echo $string->getSubstring(3,4);
echo $string->getSubstring(3,-2);
echo $string->getSubstring(-4,2);
echo $string->getSubstring(-6,-2);
echo $string->getSubstring(-2);
echo $string->getSubstring(7);
Parameters
- $start
- Start
- $length
- Länge
Returns
|
public
Alvine\Types\StringType
|
#
replace( string|Alvine\Types\StringType $pattern, string|Alvine\Types\StringType $replacement )
Ersetzen
Ersetzen einer Zeichenkette im String-Objekt. Intern wird die Funktion
mb_ereg_replace verwendet. Es müssen / können keine Delimiter angegeben
werden. Das Pattern muß also statt /.+/ nur .+ sein.
$string = 'new String('Iñtërnâtiônàlizætiøn');
// Die ganze Zeichenfolge ersetzen.
$string->replace('Iñtërnâtiônàlizætiøn', 'Test');
echo $string; // Test
Parameters
- $pattern
- Suche nach dieser Zeichenkette (ohne Delimiter)
- $replacement
- Ersetzen mit dieser Zeichenkette
Returns
Link
|
public
boolean
|
#
contains( string|Alvine\Types\StringType $string )
Prüfen auf Inhalt
Prüft ob die übergebene Zeichenkette im String enthalten ist.
Die Funktion gibt true oder false zurück.
Parameters
Returns
boolean Ergebnis
|
public
boolean
|
#
match( string|Alvine\Types\StringType $pattern )
Prüft ob der reguläre Ausdruck im String enthalten ist.
Prüft ob der reguläre Ausdruck im String enthalten ist.
Parameters
- $pattern
- Regulärer Ausdruck
Returns
boolean Ergebnis
|
public
boolean
|
#
compareTo( string|Alvine\Types\StringType $string )
Überprüfung ob der Vergleichswert identisch
zu diesem Objekt ist. Es wird der Inhalt von
$this->string geprüft.
Überprüfung ob der Vergleichswert identisch
zu diesem Objekt ist. Es wird der Inhalt von
$this->string geprüft.
Parameters
Returns
boolean Ergebnis
|
public static
string
|
#
encode( string $string, string $encoding,… )
Wandelt eine Zeichenkette in das gewünschte Zielencoding um und
gibt diese Zeichenkette zurück. Diese Funktion benötigt bei einem
von UTF-8 abweichenden encoding die Erweiterung mb_convert_encoding
Wandelt eine Zeichenkette in das gewünschte Zielencoding um und
gibt diese Zeichenkette zurück. Diese Funktion benötigt bei einem
von UTF-8 abweichenden encoding die Erweiterung mb_convert_encoding
Parameters
- $string
- String
- $encoding,…
- Encoding
Returns
string
|