function.bbcode-create.html
12.5 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
<!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>Erstellt eine BBCode Ressource</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.bbcode-add-smiley.html">bbcode_add_smiley</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.bbcode-destroy.html">bbcode_destroy</a></div>
<div class="up"><a href="ref.bbcode.html">BBCode Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.bbcode-create" class="refentry">
<div class="refnamediv">
<h1 class="refname">bbcode_create</h1>
<p class="verinfo">(PECL bbcode >= 0.9.0)</p><p class="refpurpose"><span class="refname">bbcode_create</span> — <span class="dc-title">Erstellt eine BBCode Ressource</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.bbcode-create-description">
<h3 class="title">Beschreibung</h3>
<div class="methodsynopsis dc-description">
<span class="type">resource</span> <span class="methodname"><strong>bbcode_create</strong></span>
([ <span class="methodparam"><span class="type">array</span> <code class="parameter">$bbcode_initial_tags</code></span>
] )</div>
<p class="para rdfs-comment">
Diese Funktion gibt eine neue BBCode Ressource zurück, die benötigt wird, um BBCode Strings zu parsen.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.bbcode-create-parameters">
<h3 class="title">Parameter-Liste</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">bbcode_initial_tags</code></dt>
<dd>
<p class="para">
Ein assoziatives Array, das die die Tag-Namen und Parameter enthält,
die benötigt werden, um den BBCode richtig parsen zu können.
Die folgenden Schlüssel/Wert Paare werden unterstützt:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">flags</var></var> optional - ein Flag,
das auf den BBCODE_FLAGS_* Konstanten basiert.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">type</var></var> benötigt - ein Flag,
das den Typ eines Tag angibt. Benutzt die BBCODE_TYPE_* Konstanten.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">open_tag</var></var> benötigt - der HTML
Code für den öffnenden Tag.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">close_tag</var></var> benötigt - der HTML
Code für den schliessenden Tag.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">default_arg</var></var> optional -
benutzen Sie diesen Wert als Standardargument, wenn keines angegeben wird
und tag_type OPTARG enspricht.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">content_handling</var></var> optional -
Gibt ein Callback, der benutzt wird um den Inhalt zu verändern.
Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt.
Der Typ des Callbacks ist string name<em>(string $content, string $argument)</em>
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">param_handling</var></var> optional -
Gibt den Callback, der für die Veränderung des Arguments gebraucht wird, zurück.
Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt.
Typ des Callbacks ist string name<em>(string $content, string $argument)</em>
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">childs</var></var> optional - Eine Liste von
erlaubten untergeordneten Tags.
Die Liste ist durch Kommas abgetrennt. Wenn die Liste mit ! beginnt,
gilt sie als die Liste mit den verbotenen untergeordneten Tags.
</span>
</li>
<li class="listitem">
<span class="simpara">
<var class="varname"><var class="varname">parent</var></var> optional -
Eine Liste von erlaubten übergeordneten Tags. Die Liste ist durch Kommas
abgetrennt.
</span>
</li>
</ul>
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.bbcode-create-returnvalues">
<h3 class="title">Rückgabewerte</h3>
<p class="para">
Gibt eine BBCode_Container Ressource zurück
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.bbcode-create-examples">
<h3 class="title">Beispiele</h3>
<p class="para">
<div class="example" id="example-4737">
<p><strong>Beispiel #1 <span class="function"><strong>bbcode_create()</strong></span> Beispiel</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$arrayBBCode</span><span style="color: #007700">=array(<br /> </span><span style="color: #DD0000">''</span><span style="color: #007700">=> array(</span><span style="color: #DD0000">'type'</span><span style="color: #007700">=></span><span style="color: #0000BB">BBCODE_TYPE_ROOT</span><span style="color: #007700">, </span><span style="color: #DD0000">'childs'</span><span style="color: #007700">=></span><span style="color: #DD0000">'!i'</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">'i'</span><span style="color: #007700">=> array(</span><span style="color: #DD0000">'type'</span><span style="color: #007700">=></span><span style="color: #0000BB">BBCODE_TYPE_NOARG</span><span style="color: #007700">, </span><span style="color: #DD0000">'open_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'<i>'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'close_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'</i>'</span><span style="color: #007700">, </span><span style="color: #DD0000">'childs'</span><span style="color: #007700">=></span><span style="color: #DD0000">'b'</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">'url'</span><span style="color: #007700">=> array(</span><span style="color: #DD0000">'type'</span><span style="color: #007700">=></span><span style="color: #0000BB">BBCODE_TYPE_OPTARG</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'open_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'<a href="{PARAM}">'</span><span style="color: #007700">, </span><span style="color: #DD0000">'close_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'</a>'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'default_arg'</span><span style="color: #007700">=></span><span style="color: #DD0000">'{CONTENT}'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'childs'</span><span style="color: #007700">=></span><span style="color: #DD0000">'b,i'</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">'img'</span><span style="color: #007700">=> array(</span><span style="color: #DD0000">'type'</span><span style="color: #007700">=></span><span style="color: #0000BB">BBCODE_TYPE_NOARG</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'open_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'<img src="'</span><span style="color: #007700">, </span><span style="color: #DD0000">'close_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'" />'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'childs'</span><span style="color: #007700">=></span><span style="color: #DD0000">''</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">'b'</span><span style="color: #007700">=> array(</span><span style="color: #DD0000">'type'</span><span style="color: #007700">=></span><span style="color: #0000BB">BBCODE_TYPE_NOARG</span><span style="color: #007700">, </span><span style="color: #DD0000">'open_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'<b>'</span><span style="color: #007700">,<br /> </span><span style="color: #DD0000">'close_tag'</span><span style="color: #007700">=></span><span style="color: #DD0000">'</b>'</span><span style="color: #007700">),<br />);<br /></span><span style="color: #0000BB">$text</span><span style="color: #007700">=<<<EOF<br /></span><span style="color: #DD0000">[b]Dicker Text[/b]<br />[i]Kursiver Text[/i]<br />[url]http://www.php.net/[/url]<br />[url=http://pecl.php.net/][b]Content Text[/b][/url]<br />[img]http://static.php.net/www.php.net/images/php.gif[/img]<br />[url=http://www.php.net/]<br />[img]http://static.php.net/www.php.net/images/php.gif[/img]<br />[/url]<br /></span><span style="color: #007700">EOF;<br /></span><span style="color: #0000BB">$BBHandler</span><span style="color: #007700">=</span><span style="color: #0000BB">bbcode_create</span><span style="color: #007700">(</span><span style="color: #0000BB">$arrayBBCode</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">bbcode_parse</span><span style="color: #007700">(</span><span style="color: #0000BB">$BBHandler</span><span style="color: #007700">,</span><span style="color: #0000BB">$text</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
<b>Dicker Text</b>
[i]Kursiver Text[/i]
<a href="http://www.php.net/">http://www.php.net/</a>
<a href="http://pecl.php.net/"><b>Content Text</b></a>
<img src="http://static.php.net/www.php.net/images/php.gif" />
<a href="http://www.php.net/">
[img]http://static.php.net/www.php.net/images/php.gif[/img]
</a>
</pre></div>
</div>
</div>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.bbcode-add-smiley.html">bbcode_add_smiley</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.bbcode-destroy.html">bbcode_destroy</a></div>
<div class="up"><a href="ref.bbcode.html">BBCode Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>