projects / awesomized / ext-ion / blob
? search:


1d8eb99f87abe2768b5cb65bc48f17f30a1af5b3
[awesomized/ext-ion] / docs / v0.0 / ion.html
1 <!doctype html>
2 <html>
3 <head>
4 <meta charset="utf-8">
5 <title>
6 ion -
7 mdref
8 </title>
9 <meta name="viewport" content="width=1200, initial-scale=0.5">
10 <base href="/v0.0/">
11 <meta http-equiv="Content-Location" content="/v0.0/ion">
12 <link rel="stylesheet" href="index.css">
13
14 <link href="https://fonts.googleapis.com/css?family=Inconsolata&amp;subset=latin-ext" rel="stylesheet">
15 <script src="//ajax.googleapis.com/ajax/libs/jquery/2.1.4/jquery.min.js"></script>
16 <link rel="shortcut icon" href="/v0.0/favicon.ico">
17 </head>
18 <body>
19 <div class="page">
20
21 <div class="sidebar">
22
23 <div class="edit">
24 <a href="./ion">Edit</a>
25 </div>
26
27
28 <ul>
29 <li>&lsh; <a href="./">Home</a>
30
31 <ul>
32 <li>
33
34 &circlearrowright; <strong><a href="./ion">ion</a></strong>
35
36
37 <ul>
38
39 <li>
40 &rdsh; <a href="./ion/: Contributing">★ Contributing</a>
41
42 </li>
43
44 <li>
45 &rdsh; <a href="./ion/: Security">★ Security</a>
46
47 </li>
48
49 <li>
50 &rdsh; <a href="./ion/Catalog">Catalog</a>
51
52 </li>
53
54 <li>
55 &rdsh; <a href="./ion/Decimal">Decimal</a>
56
57 <ul>
58
59 <li>&rdsh; <a href="./ion/Decimal/Context">Context</a>
60 <ul>
61
62 <li>&rdsh; <a href="./ion/Decimal/Context/Dec128">Dec128</a>
63 </li>
64
65 <li>&rdsh; <a href="./ion/Decimal/Context/Dec32">Dec32</a>
66 </li>
67
68 <li>&rdsh; <a href="./ion/Decimal/Context/Dec64">Dec64</a>
69 </li>
70
71 <li>&rdsh; <a href="./ion/Decimal/Context/DecMax">DecMax</a>
72 </li>
73
74 <li>&rdsh; <a href="./ion/Decimal/Context/Rounding">Rounding</a>
75 </li>
76
77 </ul>
78
79 </li>
80
81 </ul>
82
83 </li>
84
85 <li>
86 &rdsh; <a href="./ion/Exception">Exception</a>
87
88 </li>
89
90 <li>
91 &rdsh; <a href="./ion/LOB">LOB</a>
92
93 </li>
94
95 <li>
96 &rdsh; <a href="./ion/Reader">Reader</a>
97
98 <ul>
99
100 <li>&rdsh; <a href="./ion/Reader/Buffer">Buffer</a>
101 <ul>
102
103 <li>&rdsh; <a href="./ion/Reader/Buffer/Reader">Reader</a>
104 </li>
105
106 </ul>
107
108 </li>
109
110 <li>&rdsh; <a href="./ion/Reader/Options">Options</a>
111 </li>
112
113 <li>&rdsh; <a href="./ion/Reader/Reader">Reader</a>
114 </li>
115
116 <li>&rdsh; <a href="./ion/Reader/Stream">Stream</a>
117 <ul>
118
119 <li>&rdsh; <a href="./ion/Reader/Stream/Reader">Reader</a>
120 </li>
121
122 </ul>
123
124 </li>
125
126 </ul>
127
128 </li>
129
130 <li>
131 &rdsh; <a href="./ion/Serializer">Serializer</a>
132
133 <ul>
134
135 <li>&rdsh; <a href="./ion/Serializer/PHP">PHP</a>
136 </li>
137
138 </ul>
139
140 </li>
141
142 <li>
143 &rdsh; <a href="./ion/Symbol">Symbol</a>
144
145 <ul>
146
147 <li>&rdsh; <a href="./ion/Symbol/Enum">Enum</a>
148 </li>
149
150 <li>&rdsh; <a href="./ion/Symbol/ImportLocation">ImportLocation</a>
151 </li>
152
153 <li>&rdsh; <a href="./ion/Symbol/PHP">PHP</a>
154 </li>
155
156 <li>&rdsh; <a href="./ion/Symbol/System">System</a>
157 </li>
158
159 <li>&rdsh; <a href="./ion/Symbol/Table">Table</a>
160 <ul>
161
162 <li>&rdsh; <a href="./ion/Symbol/Table/Local">Local</a>
163 </li>
164
165 <li>&rdsh; <a href="./ion/Symbol/Table/Shared">Shared</a>
166 </li>
167
168 </ul>
169
170 </li>
171
172 </ul>
173
174 </li>
175
176 <li>
177 &rdsh; <a href="./ion/Timestamp">Timestamp</a>
178
179 <ul>
180
181 <li>&rdsh; <a href="./ion/Timestamp/Format">Format</a>
182 </li>
183
184 <li>&rdsh; <a href="./ion/Timestamp/Precision">Precision</a>
185 </li>
186
187 </ul>
188
189 </li>
190
191 <li>
192 &rdsh; <a href="./ion/Type">Type</a>
193
194 </li>
195
196 <li>
197 &rdsh; <a href="./ion/Unserializer">Unserializer</a>
198
199 <ul>
200
201 <li>&rdsh; <a href="./ion/Unserializer/PHP">PHP</a>
202 </li>
203
204 </ul>
205
206 </li>
207
208 <li>
209 &rdsh; <a href="./ion/Writer">Writer</a>
210
211 <ul>
212
213 <li>&rdsh; <a href="./ion/Writer/Buffer">Buffer</a>
214 <ul>
215
216 <li>&rdsh; <a href="./ion/Writer/Buffer/Writer">Writer</a>
217 </li>
218
219 </ul>
220
221 </li>
222
223 <li>&rdsh; <a href="./ion/Writer/Options">Options</a>
224 </li>
225
226 <li>&rdsh; <a href="./ion/Writer/Stream">Stream</a>
227 <ul>
228
229 <li>&rdsh; <a href="./ion/Writer/Stream/Writer">Writer</a>
230 </li>
231
232 </ul>
233
234 </li>
235
236 <li>&rdsh; <a href="./ion/Writer/Writer">Writer</a>
237 </li>
238
239 </ul>
240
241 </li>
242
243 <li>
244 &rdsh; <a href="./ion/serialize">serialize</a>
245
246 </li>
247
248 <li>
249 &rdsh; <a href="./ion/unserialize">unserialize</a>
250
251 </li>
252
253 </ul>
254
255
256 </li>
257 </ul>
258
259 </li>
260 </ul>
261 </div>
262 <meta charset="utf-8"><h1>
263 <a class="permalink" href="ion#">#</a>pecl/ion</h1><h2 id="About:">About:<a class="permalink" href="ion#About:">#</a>
264 </h2><p>PHP extension wrapping <a href="https://github.com/amzn/ion-c">amzn/ion-c</a>.
265 See the <a href="https://amzn.github.io/ion-docs/">Amazon ION specification</a>.</p><h2 id="License:">License:<a class="permalink" href="ion#License:">#</a>
266 </h2><p><a href="https://github.com/awesomized/ext-ion/blob/master/LICENSE">BSD-2-Clause</a>;
267 see <a href="https://spdx.org/licenses/BSD-2-Clause.html">spdx.org</a>.</p><h2 id="Installation:">Installation:<a class="permalink" href="ion#Installation:">#</a>
268 </h2><p><a href="https://pecl.php.net">PECL</a> and <a href="https://pharext.org">PHARext</a> is WIP.</p><h3 id="Dependencies:">Dependencies:<a class="permalink" href="ion#Dependencies:">#</a>
269 </h3><h4 id="Required:">Required:<a class="permalink" href="ion#Required:">#</a>
270 </h4><ul>
271 <li>PHP-8.1
272 <ul>
273 <li>ext/date (standard)</li>
274 <li>ext/spl (standard)</li>
275 </ul>
276 </li>
277 </ul><h4 id="Optional:">Optional:<a class="permalink" href="ion#Optional:">#</a>
278 </h4><ul>
279 <li>
280 <a href="https://github.com/amzn/ion-c">amzn/ion-c</a> (bundled as git submodule)</li>
281 </ul><h3 id="Trinity:">Trinity:<a class="permalink" href="ion#Trinity:">#</a>
282 </h3><pre><code><span style="color: inherit" class="html">
283 phpize<br>./configure<br>make # -j$(nproc)<br>sudo make install # INSTALL=install<br></span>
284 </code></pre><h3 id="Try.with.Docker:">Try with Docker:<a class="permalink" href="ion#Try.with.Docker:">#</a>
285 </h3><pre><code><span style="color: inherit" class="html">
286 docker build -t php-ion<br>docker run --rm php-ion -r 'echo ion\serialize(ion\Symbol\PHP::asTable());'<br></span>
287 </code></pre><h2 id="Editor.Stub:">Editor Stub:<a class="permalink" href="ion#Editor.Stub:">#</a>
288 </h2><p>See <a href="https://github.com/awesomized/ext-ion/blob/master/ion.stub.php">ion.stub.php</a>.</p><h2 id="Known.Issues:">Known Issues:<a class="permalink" href="ion#Known.Issues:">#</a>
289 </h2><p>Due to <em>private</em> internal state of ion-c's readers and writers,
290 instances of the following PHP classes cannot be cloned:</p><ul>
291 <li><a href="ion/Reader/Reader">ion\Reader\Reader</a></li>
292 <li><a href="ion/Writer/Writer">ion\Writer\Writer</a></li>
293 <li><a href="ion/Serializer/PHP">ion\Serializer\PHP</a></li>
294 <li><a href="ion/Unserializer/PHP">ion\Unserializer\PHP</a></li>
295 </ul><h2 id="Editor.Stub:">Editor Stub:<a class="permalink" href="ion#Editor.Stub:">#</a>
296 </h2><p>This extension provides a stub file four your editor's auto-completion.</p><div>
297 <p><strong>Download the Stub file:</strong></p>
298 <ul style="list-style-type: '»'">
299 <li>
300 <a href="ion.stub.php">ion.stub.php</a><br>
301 <small>
302 Last modified:
303 2022-01-28 09:29:47 UTC </small>
304 </li>
305 </ul>
306 </div><h2 id="Functions:">Functions:<a class="permalink" href="ion#Functions:">#</a>
307 </h2><ul>
308
309 <li>
310 <h3 id="serialize">
311 <a href="ion/serialize">serialize</a><a class="permalink" href="ion#serialize">#</a>
312 </h3>
313 <p>Serialize a PHP value as ION data.</p>
314
315 <p><code><a href="https://php.net/manual/en/language.types.string">string</a></code> <a href="ion/serialize">ion\serialize</a>(<code><a href="https://php.net/manual/en/language.types.declarations#language.types.declarations.mixed">mixed</a></code> <span class="var">$data</span>, [?<a href="ion/Serializer">ion\Serializer</a> <span class="var">$serializer</span> = <code><a href="https://php.net/manual/en/language.types.null">NULL</a></code>])</p>
316 </li>
317
318 <li>
319 <h3 id="unserialize">
320 <a href="ion/unserialize">unserialize</a><a class="permalink" href="ion#unserialize">#</a>
321 </h3>
322 <p>Unserialize ION data (stream) as PHP value(s).</p>
323
324 <p><code><a href="https://php.net/manual/en/language.types.declarations#language.types.declarations.mixed">mixed</a></code> <a href="ion/unserialize">ion\unserialize</a>(<code><a href="https://php.net/manual/en/language.types.string">string</a></code>|<code><a href="https://php.net/manual/en/language.types.resource">resource</a></code> <span class="var">$data</span>, [?<a href="ion/Unserializer">ion\Unserializer</a> <span class="var">$unserializer</span> = <code><a href="https://php.net/manual/en/language.types.null">NULL</a></code>])</p>
325 </li>
326
327 </ul><h2 id="Namespaces.Interfaces.and.Classes:">Namespaces, Interfaces and Classes:<a class="permalink" href="ion#Namespaces.Interfaces.and.Classes:">#</a>
328 </h2><ul>
329
330 <li>
331 <h3 id="Catalog">
332 <a href="ion/Catalog">Catalog</a><a class="permalink" href="ion#Catalog">#</a>
333 </h3>
334 <p>The Catalog holds a collection of <a href="ion/Symbol/Table">ion\Symbol\Table</a> instances queried from <a href="ion/Reader">ion\Reader</a> and <a href="ion/Writer">ion\Writer</a> instances.</p>
335
336 <p><em>class</em> <a href="ion/Catalog">ion\Catalog</a> <em>implements</em> <code><a href="https://php.net/manual/en/class.countable">Countable</a></code></p>
337 </li>
338
339 <li>
340 <h3 id="Decimal">
341 <a href="ion/Decimal">Decimal</a><a class="permalink" href="ion#Decimal">#</a>
342 </h3>
343 <p>An arbitrary precision fixed point decimal.</p>
344
345 <p><em>class</em> <a href="ion/Decimal">ion\Decimal</a> <em>implements</em> <code><a href="https://php.net/manual/en/class.stringable">Stringable</a></code></p>
346 </li>
347
348 <li>
349 <h3 id="Exception">
350 <a href="ion/Exception">Exception</a><a class="permalink" href="ion#Exception">#</a>
351 </h3>
352 <p>Base exception for the ION extension.</p>
353
354 <p><em>class</em> <a href="ion/Exception">ion\Exception</a> <em>extends</em> <code><a href="https://php.net/manual/en/class.exception">Exception</a></code> <em>implements</em> <code><a href="https://php.net/manual/en/class.throwable">Throwable</a></code></p>
355 </li>
356
357 <li>
358 <h3 id="LOB">
359 <a href="ion/LOB">LOB</a><a class="permalink" href="ion#LOB">#</a>
360 </h3>
361 <p>A large object.</p>
362
363 <p><em>class</em> <a href="ion/LOB">ion\LOB</a></p>
364 </li>
365
366 <li>
367 <h3 id="Reader">
368 <a href="ion/Reader">Reader</a><a class="permalink" href="ion#Reader">#</a>
369 </h3>
370 <p>ION reader API.</p>
371
372 <p><em>interface</em> <a href="ion/Reader">ion\Reader</a> <em>implements</em> <code><a href="https://php.net/manual/en/class.recursiveiterator">RecursiveIterator</a></code></p>
373 </li>
374
375 <li>
376 <h3 id="Serializer">
377 <a href="ion/Serializer">Serializer</a><a class="permalink" href="ion#Serializer">#</a>
378 </h3>
379 <p>Serializer <em>interface</em>, used to customize <a href="ion/serialize">ion\serialize</a>()'s behavior.</p>
380
381 <p><em>interface</em> <a href="ion/Serializer">ion\Serializer</a></p>
382 </li>
383
384 <li>
385 <h3 id="Symbol">
386 <a href="ion/Symbol">Symbol</a><a class="permalink" href="ion#Symbol">#</a>
387 </h3>
388
389 <p><em>class</em> <a href="ion/Symbol">ion\Symbol</a> <em>implements</em> <code><a href="https://php.net/manual/en/class.stringable">Stringable</a></code></p>
390 </li>
391
392 <li>
393 <h3 id="Timestamp">
394 <a href="ion/Timestamp">Timestamp</a><a class="permalink" href="ion#Timestamp">#</a>
395 </h3>
396 <p>An ION Timestamp.</p>
397
398 <p><em>class</em> <a href="ion/Timestamp">ion\Timestamp</a> <em>extends</em> <code><a href="https://php.net/manual/en/class.datetime">DateTime</a></code> <em>implements</em> <code><a href="https://php.net/manual/en/class.datetimeinterface">DateTimeInterface</a></code>, <code><a href="https://php.net/manual/en/class.stringable">Stringable</a></code></p>
399 </li>
400
401 <li>
402 <h3 id="Type">
403 <a href="ion/Type">Type</a><a class="permalink" href="ion#Type">#</a>
404 </h3>
405 <p>ION data type.</p>
406
407 <p><code><a href="https://php.net/manual/en/language.types.enumerations">enum</a></code> <a href="ion/Type">ion\Type</a> <em>implements</em> <code><a href="https://php.net/manual/en/class.backedenum">BackedEnum</a></code></p>
408 </li>
409
410 <li>
411 <h3 id="Unserializer">
412 <a href="ion/Unserializer">Unserializer</a><a class="permalink" href="ion#Unserializer">#</a>
413 </h3>
414 <p>Unserializer <em>interface</em>, used to customize <a href="ion/unserialize">ion\unserialize</a>()'s behavior.</p>
415
416 <p><em>interface</em> <a href="ion/Unserializer">ion\Unserializer</a></p>
417 </li>
418
419 <li>
420 <h3 id="Writer">
421 <a href="ion/Writer">Writer</a><a class="permalink" href="ion#Writer">#</a>
422 </h3>
423 <p>ION writer API.</p>
424
425 <p><em>interface</em> <a href="ion/Writer">ion\Writer</a></p>
426 </li>
427
428 </ul>
429 <div id="disqus_thread"><button id="disqus_activator">Show <span> </span> Comment(s)</button></div>
430 <script>
431 var disqus_shortname = 'mdref';
432 var disqus_identifier = 'ion';
433 </script>
434
435 <footer>
436
437 <ul>
438 <li><a href="https://github.com/m6w6/mdref">mdref-v3.0
439 </a></li>
440 <li><a href="LICENSE">&copy; 2013-2022 All rights reserved.</a></li>
441 <li>
442 </li>
443 </ul>
444
445 </footer>
446
447 <script src="index.js"></script>
448
449 </div>
450 </body>
451 </html>
PHP extension for Amazon ION