function.addcslashes.html
8.37 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Stellt bestimmten Zeichen eines Strings ein "\" voran (wie in C)</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ref.strings.html">String-Funktionen</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.addslashes.html">addslashes</a></div>
<div class="up"><a href="ref.strings.html">String-Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.addcslashes" class="refentry">
<div class="refnamediv">
<h1 class="refname">addcslashes</h1>
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">addcslashes</span> — <span class="dc-title">Stellt bestimmten Zeichen eines Strings ein "\" voran (wie in C)</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.addcslashes-description">
<h3 class="title">Beschreibung</h3>
<div class="methodsynopsis dc-description">
<span class="type">string</span> <span class="methodname"><strong>addcslashes</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$str</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$charlist</code></span>
)</div>
<p class="para rdfs-comment">
Gibt eine Zeichenkette zurück, in der allen Zeichen, die in
<code class="parameter">charlist</code> aufgeführt sind, ein "\" vorangestellt ist.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.addcslashes-parameters">
<h3 class="title">Parameter-Liste</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">str</code></dt>
<dd>
<p class="para">
Die zu escapende Zeichenkette.
</p>
</dd>
<dt>
<code class="parameter">charlist</code></dt>
<dd>
<p class="para">
Eine Liste der zu escapenden Zeichen. Wenn <code class="parameter">charlist</code>
Zeichen wie <em>\n</em>, <em>\r</em> 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.
</p>
<p class="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!
<div class="informalexample">
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #DD0000">'foo[ ]'</span><span style="color: #007700">, </span><span style="color: #DD0000">'A..z'</span><span style="color: #007700">);<br /></span><span style="color: #FF8000">// Ausgabe: \f\o\o\[ \]<br />// Alle groß- und kleingeschriebenen Buchstaben werden maskiert<br />// ... aber ebenfalls die Zeichen [\]^_`<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
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
<span class="function"><a href="function.ord.html" class="function">ord()</a></span>, um den ASCII-Wert eines Zeichens zu ermitteln.
<div class="informalexample">
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #DD0000">"zoo['.']"</span><span style="color: #007700">, </span><span style="color: #DD0000">'z..A'</span><span style="color: #007700">);<br /></span><span style="color: #FF8000">// Ausgabe: \zoo['\.']<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
<p class="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), \f
(Seitenvorschub), \v (vertikaler Tabulator) und \t (Tabulator)
vordefinierte Escape-Sequenzen, während in C alle der
genannten Zeichen vordefinierte Escape-Sequenzen sind.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.addcslashes-returnvalues">
<h3 class="title">Rückgabewerte</h3>
<p class="para">
Gibt die maskierte Zeichenkette zurück.
</p>
</div>
<div class="refsect1 changelog" id="refsect1-function.addcslashes-changelog">
<h3 class="title">Changelog</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>Version</th>
<th>Beschreibung</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>5.2.5</td>
<td>
Die Escape-Sequenzen \v and \f wurden hinzugefügt.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.addcslashes-examples">
<h3 class="title">Beispiele</h3>
<p class="para">
<code class="parameter">charlist</code>-Angaben wie "\0..\37" (oktal) bewirken
ein Escapen aller Zeichen mit einem ASCII-Code zwischen 0 und 31 (dezimal).
<div class="example" id="example-4776">
<p><strong>Beispiel #1 <span class="function"><strong>addcslashes()</strong></span>-Beispiel</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$escaped </span><span style="color: #007700">= </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #0000BB">$nicht_escaped</span><span style="color: #007700">, </span><span style="color: #DD0000">"\0..\37!@\177..\377"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.addcslashes-seealso">
<h3 class="title">Siehe auch</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="function.stripcslashes.html" class="function" rel="rdfs-seeAlso">stripcslashes()</a> - Entfernt Quotes aus mit addcslashes behandelten Strings</span></li>
<li class="member"><span class="function"><a href="function.stripslashes.html" class="function" rel="rdfs-seeAlso">stripslashes()</a> - Entfernt aus einem gequoteten String alle Quotes</span></li>
<li class="member"><span class="function"><a href="function.addslashes.html" class="function" rel="rdfs-seeAlso">addslashes()</a> - Stellt bestimmten Zeichen eines Strings ein "\" voran</span></li>
<li class="member"><span class="function"><a href="function.htmlspecialchars.html" class="function" rel="rdfs-seeAlso">htmlspecialchars()</a> - Wandelt Sonderzeichen in HTML-Codes um</span></li>
<li class="member"><span class="function"><a href="function.quotemeta.html" class="function" rel="rdfs-seeAlso">quotemeta()</a> - Quoten von Meta-Zeichen</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ref.strings.html">String-Funktionen</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.addslashes.html">addslashes</a></div>
<div class="up"><a href="ref.strings.html">String-Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>