Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

addcslashes

String-Funktionen

    Befehl:
string addcslashes ( string $str , string $charlist )


    Parameter-Liste:
NameBeschreibung
strDie zu escapende Zeichenkette.
charlisteEine Liste der zu escapenden Zeichen. Wenn charlist Zeichen wie \n, \r etc. enthält, werden diese im C-Stil konvertiert, während andere nicht-alphanumerische Zeichen mit einem ASCII-Wert kleiner als 32 oder höher als 126 in ihre oktale Repräsentation umgewandelt werden.
Wenn Sie eine Zeichensequenz im charlist-Parameter notieren, informieren Sie sich darüber, welche Zeichen sich zwischen dem ersten und dem letzten Zeichen befinden!
<?php
echo addcslashes('foo[ ]''A..z');
// Ausgabe:  \f\o\o\[ \]
// Alle gross- und kleingeschriebenen Buchstaben werden maskiert
// ... aber ebenfalls die Zeichen [\]^_`
?>
Beachten Sie zudem, dass sofern das erste Zeichen einer Sequenz einen höheren ASCII-Wert hat als das zweite, keine Sequenz erstellt wird. Nur das erste und das letzte Zeichen sowie Punkte werden dann escaped. Verwenden Sie die Funktion ord(), um den ASCII-Wert eines Zeichens zu ermitteln.
<?php
echo addcslashes("zoo['.']"'z..A');
// Ausgabe:  \zoo['\.']
?>
Seien Sie besonders vorsichtig, wenn Sie Zeichen wie 0, a, b, f, n, r, t oder v escapen möchten. Sie werden zu \0, \a, \b, \f, \n, \r, \t oder \v gewandelt. In PHP sind \0 (NULL), \r (Wagenrücklauf), \n (Neue Zeile), \f (Seitenvorschub), \v (vertikaler Tabulator) und \t (Tabulator) vordefinierte Escape-Sequenzen, während in C alle der genannten Zeichen vordefinierte Escape-Sequenzen sind.

    Rückgabewerte:
Gibt die maskierte Zeichenkette zurück.

    Beschreibung:
Gibt eine Zeichenkette zurück, in der allen Zeichen, die in charlist aufgeführt sind, ein "\" vorangestellt ist.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Entfernt Quotes aus mit addcslashes behandelten Strings
 
Entfernt aus einem gequoteten String alle Quotes
 
Stellt bestimmten Zeichen eines Strings ein "\" voran
 
Wandelt Sonderzeichen in HTML-Codes um
 
Quoten von Meta-Zeichen
 

addcslashes() - Beispiel:


Eingabe:
<?PHP
$string = '#Sicher+ist*sicher!';
$string_new = addcslashes($string , '#+*!');
echo $string . '<br>' . $string_new;
?>


Ausgabe:
#Sicher+ist*sicher!
\#Sicher\+ist\*sicher\!

Beschreibung:
Mit addcslashes() kann man eigene vordefinierte Sonderzeichen (charlist) mit einem Backslash "\" sch�tzen lassen. Der String (string) wird danach modifiziert zur�ckgegeben.

Beschreibung:
Version Beschreibung
5.2.5 Die Escape-Sequenzen \v and \f wurden hinzugefügt.
String-Funktionen