1
0
mirror of https://github.com/php/doc-de.git synced 2026-04-29 18:03:13 +02:00
Files
archived-doc-de/reference/strings/functions/addcslashes.xml
T
Carola 'Sammy' Kummert b1cab7c83c addcslashes.xml: updated to en version 1.7
sha1.xml:         initial translation
sha1-file.xml:    initial translation
str-ireplace.xml: initial translation
str-shuffle.xml:  initial translation


git-svn-id: https://svn.php.net/repository/phpdoc/de/trunk@185173 c90b9560-bf6c-de11-be94-00142212c4b1
2005-04-26 12:00:23 +00:00

107 lines
3.6 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- EN-Revision: 1.7 Maintainer: sammywg Status: working -->
<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 -->
<refentry id="function.addcslashes">
<refnamediv>
<refname>addcslashes</refname>
<refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran (wie in C)</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>string</type><methodname>addcslashes</methodname>
<methodparam><type>string</type><parameter>str</parameter></methodparam>
<methodparam><type>string</type><parameter>charlist</parameter></methodparam>
</methodsynopsis>
<para>
Gibt eine Zeichenkette zurück, in der allen Zeichen, die in
<parameter>charlist</parameter> aufgeführt sind, ein "\" vorangestellt ist.
<literal>\n</literal>, <literal>\r</literal> etc. werden im C-Stil
escaped, Zeichen mit einem ASCII-Wert kleiner als 32 oder höher als
126 werden in ihren Oktalwert umgewandelt.
</para>
<para>
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) und \t
(Tabulator) vordefinierte Escape-Sequenzen, während in C alle der
genannten Zeichen vordefinierte Escape-Sequenzen sind.
</para>
<para>
<parameter>charlist</parameter>-Angaben wie "\0..\37" (oktal) bewirken
ein Escapen aller Zeichen mit einem ASCII-Code zwischen 0 und 31 (dezimal).
<example>
<title><function>addcslashes</function> Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$escaped = addcslashes($nicht_escaped, "\0..\37!@\177..\377");
?>
]]>
</programlisting>
</example>
</para>
<para>
Wenn Sie eine Zeichensequenz im charlist-Parameter notieren,
informieren Sie sich darüber, welche Zeichen sich zwischen dem
ersten und dem letzten Zeichen befinden!
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
echo addcslashes('foo[ ]', 'A..z');
// Ausgabe: \f\o\o\[ \]
// Alle groß- und kleingeschriebenen Buchstaben werden escaped
// ... aber ebenfalls die Zeichen [\]^_` sowie die Tabulatoren, Zeilenwechsel
// Wagenvorlauf-Zeichen etc.
?>
]]>
</programlisting>
</informalexample>
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
<function>ord</function>, um den ASCII-Wert eines Zeichens zu ermitteln.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
echo addcslashes("zoo['.']", 'z..A');
// Ausgabe: \zoo['\.']
?>
]]>
</programlisting>
</informalexample>
</para>
<para>
Siehe auch <function>stripcslashes</function>,
<function>stripslashes</function>,
<function>htmlspecialchars</function> und
<function>quotemeta</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->