Skip to content

Commit 29d1429

Browse files
kocsismatekocsismate
committed
Document each global ext/dom constant on its own row
Related to php/php-src#21484
1 parent f7f8617 commit 29d1429

File tree

1 file changed

+177
-18
lines changed

1 file changed

+177
-18
lines changed

‎reference/dom/constants.xml‎

Lines changed: 177 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -251,7 +251,7 @@
251251
</row>
252252
</thead>
253253
<tbody>
254-
<row xml:id="constant.dom-html-no-default-ns">
254+
<row xml:id="constant.-dom-html-no-default-ns">
255255
<entry>
256256
<constant>Dom\HTML_NO_DEFAULT_NS</constant>
257257
(<type>int</type>)
@@ -287,7 +287,7 @@
287287
</row>
288288
</thead>
289289
<tbody>
290-
<row xml:id="constant.dom-php-err">
290+
<row xml:id="constant.-dom-php-err">
291291
<entry>
292292
<constant>DOM_PHP_ERR</constant>
293293
(<type>int</type>)
@@ -300,9 +300,19 @@
300300
out-of-memory situations.
301301
</entry>
302302
</row>
303+
<row xml:id="constant.-dom-index-size-err">
304+
<entry>
305+
<constant>DOM_INDEX_SIZE_ERR</constant>
306+
(<type>int</type>)
307+
</entry>
308+
<entry>1</entry>
309+
<entry>
310+
If index or size is negative, or greater than the allowed value.
311+
</entry>
312+
</row>
303313
<row xml:id="constant.dom-index-size-err">
304314
<entry>
305-
<constant>DOM_INDEX_SIZE_ERR</constant> / <constant>Dom\INDEX_SIZE_ERR</constant>
315+
<constant>Dom\INDEX_SIZE_ERR</constant>
306316
(<type>int</type>)
307317
</entry>
308318
<entry>1</entry>
@@ -312,7 +322,18 @@
312322
</row>
313323
<row xml:id="constant.domstring-size-err">
314324
<entry>
315-
<constant>DOMSTRING_SIZE_ERR</constant> / <constant>Dom\STRING_SIZE_ERR</constant>
325+
<constant>DOMSTRING_SIZE_ERR</constant>
326+
(<type>int</type>)
327+
</entry>
328+
<entry>2</entry>
329+
<entry>
330+
If the specified range of text does not fit into a
331+
<type>string</type>.
332+
</entry>
333+
</row>
334+
<row xml:id="constant.-dom-string-size-err">
335+
<entry>
336+
<constant>Dom\STRING_SIZE_ERR</constant>
316337
(<type>int</type>)
317338
</entry>
318339
<entry>2</entry>
@@ -321,113 +342,228 @@
321342
<type>string</type>.
322343
</entry>
323344
</row>
345+
<row xml:id="constant.-dom-hierarchy-request-err">
346+
<entry>
347+
<constant>DOM_HIERARCHY_REQUEST_ERR</constant>
348+
(<type>int</type>)
349+
</entry>
350+
<entry>3</entry>
351+
<entry>If any node is inserted somewhere it doesn't belong</entry>
352+
</row>
324353
<row xml:id="constant.dom-hierarchy-request-err">
325354
<entry>
326-
<constant>DOM_HIERARCHY_REQUEST_ERR</constant> / <constant>Dom\HIERARCHY_REQUEST_ERR</constant>
355+
<constant>Dom\HIERARCHY_REQUEST_ERR</constant>
327356
(<type>int</type>)
328357
</entry>
329358
<entry>3</entry>
330359
<entry>If any node is inserted somewhere it doesn't belong</entry>
331360
</row>
361+
<row xml:id="constant.-dom-wrong-document-err">
362+
<entry>
363+
<constant>DOM_WRONG_DOCUMENT_ERR</constant>
364+
(<type>int</type>)
365+
</entry>
366+
<entry>4</entry>
367+
<entry>
368+
If a node is used in a different document than the one that created it.
369+
</entry>
370+
</row>
332371
<row xml:id="constant.dom-wrong-document-err">
333372
<entry>
334-
<constant>DOM_WRONG_DOCUMENT_ERR</constant> / <constant>Dom\WRONG_DOCUMENT_ERR</constant>
373+
<constant>Dom\WRONG_DOCUMENT_ERR</constant>
335374
(<type>int</type>)
336375
</entry>
337376
<entry>4</entry>
338377
<entry>
339378
If a node is used in a different document than the one that created it.
340379
</entry>
341380
</row>
381+
<row xml:id="constant.-dom-invalid-character-err">
382+
<entry>
383+
<constant>DOM_INVALID_CHARACTER_ERR</constant>
384+
(<type>int</type>)
385+
</entry>
386+
<entry>5</entry>
387+
<entry>
388+
If an invalid or illegal character is specified, such as in a name.
389+
</entry>
390+
</row>
342391
<row xml:id="constant.dom-invalid-character-err">
343392
<entry>
344-
<constant>DOM_INVALID_CHARACTER_ERR</constant> / <constant>Dom\INVALID_CHARACTER_ERR</constant>
393+
<constant>Dom\INVALID_CHARACTER_ERR</constant>
345394
(<type>int</type>)
346395
</entry>
347396
<entry>5</entry>
348397
<entry>
349398
If an invalid or illegal character is specified, such as in a name.
350399
</entry>
351400
</row>
401+
<row xml:id="constant.-dom-no-data-allowed-err">
402+
<entry>
403+
<constant>DOM_NO_DATA_ALLOWED_ERR</constant>
404+
(<type>int</type>)
405+
</entry>
406+
<entry>6</entry>
407+
<entry>
408+
If data is specified for a node which does not support data.
409+
</entry>
410+
</row>
352411
<row xml:id="constant.dom-no-data-allowed-err">
353412
<entry>
354-
<constant>DOM_NO_DATA_ALLOWED_ERR</constant> / <constant>Dom\NO_DATA_ALLOWED_ERR</constant>
413+
<constant>Dom\NO_DATA_ALLOWED_ERR</constant>
355414
(<type>int</type>)
356415
</entry>
357416
<entry>6</entry>
358417
<entry>
359418
If data is specified for a node which does not support data.
360419
</entry>
361420
</row>
421+
<row xml:id="constant.-dom-no-modification-allowed-err">
422+
<entry>
423+
<constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant>
424+
(<type>int</type>)
425+
</entry>
426+
<entry>7</entry>
427+
<entry>
428+
If an attempt is made to modify an object where modifications are not allowed.
429+
</entry>
430+
</row>
362431
<row xml:id="constant.dom-no-modification-allowed-err">
363432
<entry>
364-
<constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant> / <constant>Dom\NO_MODIFICATION_ALLOWED_ERR</constant>
433+
<constant>Dom\NO_MODIFICATION_ALLOWED_ERR</constant>
365434
(<type>int</type>)
366435
</entry>
367436
<entry>7</entry>
368437
<entry>
369438
If an attempt is made to modify an object where modifications are not allowed.
370439
</entry>
371440
</row>
441+
<row xml:id="constant.-dom-not-found-err">
442+
<entry>
443+
<constant>DOM_NOT_FOUND_ERR</constant>
444+
(<type>int</type>)
445+
</entry>
446+
<entry>8</entry>
447+
<entry>
448+
If an attempt is made to reference a node in a context where it does not exist.
449+
</entry>
450+
</row>
372451
<row xml:id="constant.dom-not-found-err">
373452
<entry>
374-
<constant>DOM_NOT_FOUND_ERR</constant> / <constant>Dom\NOT_FOUND_ERR</constant>
453+
<constant>Dom\NOT_FOUND_ERR</constant>
375454
(<type>int</type>)
376455
</entry>
377456
<entry>8</entry>
378457
<entry>
379458
If an attempt is made to reference a node in a context where it does not exist.
380459
</entry>
381460
</row>
461+
<row xml:id="constant.-dom-not-supported-err">
462+
<entry>
463+
<constant>DOM_NOT_SUPPORTED_ERR</constant>
464+
(<type>int</type>)
465+
</entry>
466+
<entry>9</entry>
467+
<entry>
468+
If the implementation does not support the requested type of object or operation.
469+
</entry>
470+
</row>
382471
<row xml:id="constant.dom-not-supported-err">
383472
<entry>
384-
<constant>DOM_NOT_SUPPORTED_ERR</constant> / <constant>Dom\NOT_SUPPORTED_ERR</constant>
473+
<constant>Dom\NOT_SUPPORTED_ERR</constant>
385474
(<type>int</type>)
386475
</entry>
387476
<entry>9</entry>
388477
<entry>
389478
If the implementation does not support the requested type of object or operation.
390479
</entry>
391480
</row>
481+
<row xml:id="constant.-dom-inuse-attribute-err">
482+
<entry>
483+
<constant>DOM_INUSE_ATTRIBUTE_ERR</constant>
484+
(<type>int</type>)
485+
</entry>
486+
<entry>10</entry>
487+
<entry>
488+
If an attempt is made to add an attribute that is already in use elsewhere.
489+
</entry>
490+
</row>
392491
<row xml:id="constant.dom-inuse-attribute-err">
393492
<entry>
394-
<constant>DOM_INUSE_ATTRIBUTE_ERR</constant> / <constant>Dom\INUSE_ATTRIBUTE_ERR</constant>
493+
<constant>Dom\INUSE_ATTRIBUTE_ERR</constant>
395494
(<type>int</type>)
396495
</entry>
397496
<entry>10</entry>
398497
<entry>
399498
If an attempt is made to add an attribute that is already in use elsewhere.
400499
</entry>
401500
</row>
501+
<row xml:id="constant.-dom-invalid-state-err">
502+
<entry>
503+
<constant>DOM_INVALID_STATE_ERR</constant>
504+
(<type>int</type>)
505+
</entry>
506+
<entry>11</entry>
507+
<entry>
508+
If an attempt is made to use an object that is not, or is no longer, usable.
509+
</entry>
510+
</row>
402511
<row xml:id="constant.dom-invalid-state-err">
403512
<entry>
404-
<constant>DOM_INVALID_STATE_ERR</constant> / <constant>Dom\INVALID_STATE_ERR</constant>
513+
<constant>Dom\INVALID_STATE_ERR</constant>
405514
(<type>int</type>)
406515
</entry>
407516
<entry>11</entry>
408517
<entry>
409518
If an attempt is made to use an object that is not, or is no longer, usable.
410519
</entry>
411520
</row>
521+
<row xml:id="constant.-dom-syntax-err">
522+
<entry>
523+
<constant>DOM_SYNTAX_ERR</constant>
524+
(<type>int</type>)
525+
</entry>
526+
<entry>12</entry>
527+
<entry>If an invalid or illegal string is specified.</entry>
528+
</row>
412529
<row xml:id="constant.dom-syntax-err">
413530
<entry>
414-
<constant>DOM_SYNTAX_ERR</constant> / <constant>Dom\SYNTAX_ERR</constant>
531+
<constant>Dom\SYNTAX_ERR</constant>
415532
(<type>int</type>)
416533
</entry>
417534
<entry>12</entry>
418535
<entry>If an invalid or illegal string is specified.</entry>
419536
</row>
537+
<row xml:id="constant.-dom-invalid-modification-err">
538+
<entry>
539+
<constant>DOM_INVALID_MODIFICATION_ERR</constant>
540+
(<type>int</type>)
541+
</entry>
542+
<entry>13</entry>
543+
<entry>If an attempt is made to modify the type of the underlying object.</entry>
544+
</row>
420545
<row xml:id="constant.dom-invalid-modification-err">
421546
<entry>
422-
<constant>DOM_INVALID_MODIFICATION_ERR</constant> / <constant>Dom\INVALID_MODIFICATION_ERR</constant>
547+
<constant>Dom\INVALID_MODIFICATION_ERR</constant>
423548
(<type>int</type>)
424549
</entry>
425550
<entry>13</entry>
426551
<entry>If an attempt is made to modify the type of the underlying object.</entry>
427552
</row>
553+
<row xml:id="constant.-dom-namespace-err">
554+
<entry>
555+
<constant>DOM_NAMESPACE_ERR</constant>
556+
(<type>int</type>)
557+
</entry>
558+
<entry>14</entry>
559+
<entry>
560+
If an attempt is made to create or change an object in a way which is
561+
incorrect with regard to namespaces.
562+
</entry>
563+
</row>
428564
<row xml:id="constant.dom-namespace-err">
429565
<entry>
430-
<constant>DOM_NAMESPACE_ERR</constant> / <constant>Dom\NAMESPACE_ERR</constant>
566+
<constant>Dom\NAMESPACE_ERR</constant>
431567
(<type>int</type>)
432568
</entry>
433569
<entry>14</entry>
@@ -436,19 +572,42 @@
436572
incorrect with regard to namespaces.
437573
</entry>
438574
</row>
575+
<row xml:id="constant.-dom-invalid-access-err">
576+
<entry>
577+
<constant>DOM_INVALID_ACCESS_ERR</constant>
578+
(<type>int</type>)
579+
</entry>
580+
<entry>15</entry>
581+
<entry>
582+
If a parameter or an operation is not supported by the underlying object.
583+
</entry>
584+
</row>
439585
<row xml:id="constant.dom-invalid-access-err">
440586
<entry>
441-
<constant>DOM_INVALID_ACCESS_ERR</constant> / <constant>Dom\INVALID_ACCESS_ERR</constant>
587+
<constant>Dom\INVALID_ACCESS_ERR</constant>
442588
(<type>int</type>)
443589
</entry>
444590
<entry>15</entry>
445591
<entry>
446592
If a parameter or an operation is not supported by the underlying object.
447593
</entry>
448594
</row>
595+
<row xml:id="constant.-dom-validation-err">
596+
<entry>
597+
<constant>DOM_VALIDATION_ERR</constant>
598+
(<type>int</type>)
599+
</entry>
600+
<entry>16</entry>
601+
<entry>
602+
If a call to a method such as insertBefore or removeChild would make the Node
603+
invalid with respect to "partial validity", this exception would be raised and
604+
the operation would not be done.
605+
</entry>
606+
</row>
607+
449608
<row xml:id="constant.dom-validation-err">
450609
<entry>
451-
<constant>DOM_VALIDATION_ERR</constant> / <constant>Dom\VALIDATION_ERR</constant>
610+
<constant>Dom\VALIDATION_ERR</constant>
452611
(<type>int</type>)
453612
</entry>
454613
<entry>16</entry>

0 commit comments

Comments
 (0)