--- /srv/rebuilderd/tmp/rebuilderdklLkzu/inputs/virtuoso-vad-demo_7.2.12+dfsg-2_all.deb +++ /srv/rebuilderd/tmp/rebuilderdklLkzu/out/virtuoso-vad-demo_7.2.12+dfsg-2_all.deb ├── file list │ @@ -1,3 +1,3 @@ │ -rw-r--r-- 0 0 0 4 2025-04-04 17:25:23.000000 debian-binary │ -rw-r--r-- 0 0 0 892 2025-04-04 17:25:23.000000 control.tar.xz │ --rw-r--r-- 0 0 0 11054400 2025-04-04 17:25:23.000000 data.tar.xz │ +-rw-r--r-- 0 0 0 11066760 2025-04-04 17:25:23.000000 data.tar.xz ├── control.tar.xz │ ├── control.tar │ │ ├── ./md5sums │ │ │ ├── ./md5sums │ │ │ │┄ Files differ ├── data.tar.xz │ ├── data.tar │ │ ├── ./usr/share/virtuoso-opensource-7/vad/demo_dav.vad │ │ │ @@ -395,436 +395,436 @@ │ │ │ 000018a0: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ 000018b0: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ 000018c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . . . . . │ │ │ -00002300: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . │ │ │ -00002880: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00002b50: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00002e20: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -000030f0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . │ │ │ +00001c40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ +00001f10: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +000021e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . < │ │ │ +000024b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000024c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000024d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000024e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000024f0: 6f63 7372 632f 446f 6342 6f6f 6b2f 656e ocsrc/DocBook/en │ │ │ +00002500: 742f 6973 6f2d 6379 7232 2e65 6e74 2220 t/iso-cyr2.ent" │ │ │ +00002510: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +00002520: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +00002530: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00002540: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00002550: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00002560: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00002820: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +000028d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00002980: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . . . │ │ │ +000031b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00003260: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00003310: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00005000: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00005170: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00005230: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -000052e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00005390: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00005440: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00005710: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ -00005880: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . . . . . . │ │ │ -000061b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00006320: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ -000065f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -000066b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -000068d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00006bb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00006ea0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -00006f50: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ -00007020: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . │ │ │ -00007630: 2020 3c66 696c 6520 6f76 6572 7772 6974 . < │ │ │ -000076f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00007700: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00007710: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00007720: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00007730: 6f63 7372 632f 6675 6e63 7265 662f 7865 ocsrc/funcref/xe │ │ │ -00007740: 6e63 5f78 3530 395f 6765 6e65 7261 7465 nc_x509_generate │ │ │ -00007750: 2e78 6d6c 2220 6461 765f 6f77 6e65 723d .xml" dav_owner= │ │ │ -00007760: 2264 6176 2220 6461 765f 6772 703d 2261 "dav" dav_grp="a │ │ │ -00007770: 646d 696e 6973 7472 6174 6f72 7322 2064 dministrators" d │ │ │ -00007780: 6176 5f70 6572 6d3d 2231 3130 3130 3031 av_perm="1101001 │ │ │ -00007790: 3030 4e4e 2220 6d61 6b65 7061 7468 3d22 00NN" makepath=" │ │ │ -000077a0: 7965 7322 2f3e 0a20 203c 6669 6c65 206f yes"/>. │ │ │ -00007860: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00007920: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00007cc0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . < │ │ │ -000081e0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -000081f0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00008200: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00008210: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00008220: 6f63 7372 632f 6675 6e63 7265 662f 7865 ocsrc/funcref/xe │ │ │ -00008230: 6e63 5f6b 6579 5f52 5341 5f72 6561 642e nc_key_RSA_read. │ │ │ -00008240: 786d 6c22 2064 6176 5f6f 776e 6572 3d22 xml" dav_owner=" │ │ │ -00008250: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ -00008260: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ -00008270: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ -00008280: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ -00008290: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ -00008350: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00008410: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00008700: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -00008870: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . < │ │ │ -00008d80: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00008d90: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00008da0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00008db0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00008dc0: 6f63 7372 632f 6675 6e63 7265 662f 7765 ocsrc/funcref/we │ │ │ -00008dd0: 656b 2e78 6d6c 2220 6461 765f 6f77 6e65 ek.xml" dav_owne │ │ │ -00008de0: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ -00008df0: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ -00008e00: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ -00008e10: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ -00008e20: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . │ │ │ -00008f90: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -000091c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00009550: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . │ │ │ -00009bc0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00009c80: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00009d30: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ -00009de0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00009df0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00009e00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00009e10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00009e20: 6f63 7372 632f 6675 6e63 7265 662f 7661 ocsrc/funcref/va │ │ │ -00009e30: 722e 786d 6c22 2064 6176 5f6f 776e 6572 r.xml" dav_owner │ │ │ -00009e40: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ -00009e50: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ -00009e60: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ -00009e70: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ -00009e80: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . < │ │ │ -00009f40: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00009f50: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00009f60: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00009f70: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00009f80: 6f63 7372 632f 6675 6e63 7265 662f 7661 ocsrc/funcref/va │ │ │ -00009f90: 645f 7361 6665 5f65 7865 632e 786d 6c22 d_safe_exec.xml" │ │ │ -00009fa0: 2064 6176 5f6f 776e 6572 3d22 6461 7622 dav_owner="dav" │ │ │ -00009fb0: 2064 6176 5f67 7270 3d22 6164 6d69 6e69 dav_grp="admini │ │ │ -00009fc0: 7374 7261 746f 7273 2220 6461 765f 7065 strators" dav_pe │ │ │ -00009fd0: 726d 3d22 3131 3031 3030 3130 304e 4e22 rm="110100100NN" │ │ │ -00009fe0: 206d 616b 6570 6174 683d 2279 6573 222f makepath="yes"/ │ │ │ -00009ff0: 3e0a 2020 3c66 696c 6520 6f76 6572 7772 >. . . . │ │ │ -0000a210: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . . . │ │ │ +00004ea0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +00005170: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +00005390: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +000054f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +000057d0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +00005890: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ +00005940: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00005950: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00005960: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00005970: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00005980: 6f63 7372 632f 6675 6e63 7265 662f 6578 ocsrc/funcref/ex │ │ │ +00005990: 6563 5f73 636f 7265 2e78 6d6c 2220 6461 ec_score.xml" da │ │ │ +000059a0: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ +000059b0: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ +000059c0: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ +000059d0: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ +000059e0: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ +000059f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00005aa0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00005b60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00005c10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . │ │ │ +00005fa0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +00006290: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ +00006620: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ +00006790: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000067a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000067b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000067c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000067d0: 6f63 7372 632f 6675 6e63 7265 662f 6461 ocsrc/funcref/da │ │ │ +000067e0: 765f 6170 695f 6c6f 636b 2e78 6d6c 2220 v_api_lock.xml" │ │ │ +000067f0: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +00006800: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +00006810: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00006820: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00006830: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00006840: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00006b20: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00006c90: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00006d40: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . < │ │ │ +000070d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000070e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000070f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00007100: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00007110: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ +00007120: 6c5f 6e61 6d65 7370 6163 655f 7363 6f70 l_namespace_scop │ │ │ +00007130: 652e 786d 6c22 2064 6176 5f6f 776e 6572 e.xml" dav_owner │ │ │ +00007140: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00007150: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00007160: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00007170: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00007180: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . < │ │ │ +000072f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00007300: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00007310: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00007320: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00007330: 6f63 7372 632f 6675 6e63 7265 662f 7661 ocsrc/funcref/va │ │ │ +00007340: 645f 6368 6563 6b5f 756e 696e 7374 616c d_check_uninstal │ │ │ +00007350: 6c61 6269 6c69 7479 2e78 6d6c 2220 6461 lability.xml" da │ │ │ +00007360: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ +00007370: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ +00007380: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ +00007390: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ +000073a0: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ +000073b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +000075f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . │ │ │ +00007970: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . │ │ │ +00007e80: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ +00007f30: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00007f40: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00007f50: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00007f60: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00007f70: 6f63 7372 632f 6675 6e63 7265 662f 6e6e ocsrc/funcref/nn │ │ │ +00007f80: 7470 5f61 7574 685f 6765 742e 786d 6c22 tp_auth_get.xml" │ │ │ +00007f90: 2064 6176 5f6f 776e 6572 3d22 6461 7622 dav_owner="dav" │ │ │ +00007fa0: 2064 6176 5f67 7270 3d22 6164 6d69 6e69 dav_grp="admini │ │ │ +00007fb0: 7374 7261 746f 7273 2220 6461 765f 7065 strators" dav_pe │ │ │ +00007fc0: 726d 3d22 3131 3031 3030 3130 304e 4e22 rm="110100100NN" │ │ │ +00007fd0: 206d 616b 6570 6174 683d 2279 6573 222f makepath="yes"/ │ │ │ +00007fe0: 3e0a 2020 3c66 696c 6520 6f76 6572 7772 >. . . . . < │ │ │ +000082b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000082c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000082d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000082e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000082f0: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ +00008300: 6c5f 6c6f 6164 5f73 6368 656d 615f 6465 l_load_schema_de │ │ │ +00008310: 636c 2e78 6d6c 2220 6461 765f 6f77 6e65 cl.xml" dav_owne │ │ │ +00008320: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ +00008330: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ +00008340: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ +00008350: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ +00008360: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . < │ │ │ +00008420: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00008430: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00008440: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00008450: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00008460: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ +00008470: 5f65 6172 7468 5f72 6164 6975 732e 786d _earth_radius.xm │ │ │ +00008480: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ +00008490: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ +000084a0: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ +000084b0: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ +000084c0: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ +000084d0: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . │ │ │ +00008590: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00008700: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . < │ │ │ +000089d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000089e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000089f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00008a00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00008a10: 6f63 7372 632f 6675 6e63 7265 662f 4752 ocsrc/funcref/GR │ │ │ +00008a20: 4f55 505f 434f 4e43 4154 2e78 6d6c 2220 OUP_CONCAT.xml" │ │ │ +00008a30: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +00008a40: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +00008a50: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00008a60: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00008a70: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00008a80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00008d80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00009060: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00009120: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00009290: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . < │ │ │ +00009570: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00009580: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00009590: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000095a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000095b0: 6f63 7372 632f 6675 6e63 7265 662f 677a ocsrc/funcref/gz │ │ │ +000095c0: 5f66 696c 655f 6f70 656e 2e78 6d6c 2220 _file_open.xml" │ │ │ +000095d0: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +000095e0: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +000095f0: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00009600: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00009610: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00009620: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . . . . │ │ │ +00009ea0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . . . . │ │ │ +0000a650: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ +0000a700: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0000a7b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +0000a920: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ 0000aa90: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . │ │ │ -0000af90: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . . . < │ │ │ -0000b6a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000b6b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000b6c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000b6d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000b6e0: 6f63 7372 632f 6675 6e63 7265 662f 7564 ocsrc/funcref/ud │ │ │ -0000b6f0: 745f 7365 742e 786d 6c22 2064 6176 5f6f t_set.xml" dav_o │ │ │ -0000b700: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ -0000b710: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ -0000b720: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ -0000b730: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ -0000b740: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . │ │ │ -0000b8c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -0000b970: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ -0000bae0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . │ │ │ -0000c240: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ -0000c3b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ -0000c5e0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . < │ │ │ -0000c8d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000c8e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000c8f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000c900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000c910: 6f63 7372 632f 6675 6e63 7265 662f 7563 ocsrc/funcref/uc │ │ │ -0000c920: 6173 652e 786d 6c22 2064 6176 5f6f 776e ase.xml" dav_own │ │ │ -0000c930: 6572 3d22 6461 7622 2064 6176 5f67 7270 er="dav" dav_grp │ │ │ -0000c940: 3d22 6164 6d69 6e69 7374 7261 746f 7273 ="administrators │ │ │ -0000c950: 2220 6461 765f 7065 726d 3d22 3131 3031 " dav_perm="1101 │ │ │ -0000c960: 3030 3130 304e 4e22 206d 616b 6570 6174 00100NN" makepat │ │ │ -0000c970: 683d 2279 6573 222f 3e0a 2020 3c66 696c h="yes"/>. . < │ │ │ -0000ca30: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000ca40: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000ca50: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000ca60: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000ca70: 6f63 7372 632f 6675 6e63 7265 662f 7478 ocsrc/funcref/tx │ │ │ -0000ca80: 6e5f 6572 726f 722e 786d 6c22 2064 6176 n_error.xml" dav │ │ │ -0000ca90: 5f6f 776e 6572 3d22 6461 7622 2064 6176 _owner="dav" dav │ │ │ -0000caa0: 5f67 7270 3d22 6164 6d69 6e69 7374 7261 _grp="administra │ │ │ -0000cab0: 746f 7273 2220 6461 765f 7065 726d 3d22 tors" dav_perm=" │ │ │ -0000cac0: 3131 3031 3030 3130 304e 4e22 206d 616b 110100100NN" mak │ │ │ -0000cad0: 6570 6174 683d 2279 6573 222f 3e0a 2020 epath="yes"/>. │ │ │ -0000cae0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ -0000cda0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ -0000d1d0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -0000d280: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ -0000d600: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . < │ │ │ -0000d830: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000d840: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000d850: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000d860: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000d870: 6f63 7372 632f 6675 6e63 7265 662f 7379 ocsrc/funcref/sy │ │ │ -0000d880: 7375 7463 6461 7465 7469 6d65 2e78 6d6c sutcdatetime.xml │ │ │ -0000d890: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -0000d8a0: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -0000d8b0: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -0000d8c0: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -0000d8d0: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -0000d8e0: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. │ │ │ -0000d990: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . . │ │ │ -0000dfe0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ -0000e1f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000e200: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000e210: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000e220: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000e230: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ -0000e240: 7269 6e67 6461 7465 2e78 6d6c 2220 6461 ringdate.xml" da │ │ │ -0000e250: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ -0000e260: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ -0000e270: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ -0000e280: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ -0000e290: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ -0000e2a0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -0000e410: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ -0000e590: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000e5a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000e5b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000e5c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000e5d0: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ -0000e5e0: 7269 6e67 5f6f 7574 7075 742e 786d 6c22 ring_output.xml" │ │ │ -0000e5f0: 2064 6176 5f6f 776e 6572 3d22 6461 7622 dav_owner="dav" │ │ │ -0000e600: 2064 6176 5f67 7270 3d22 6164 6d69 6e69 dav_grp="admini │ │ │ -0000e610: 7374 7261 746f 7273 2220 6461 765f 7065 strators" dav_pe │ │ │ -0000e620: 726d 3d22 3131 3031 3030 3130 304e 4e22 rm="110100100NN" │ │ │ -0000e630: 206d 616b 6570 6174 683d 2279 6573 222f makepath="yes"/ │ │ │ -0000e640: 3e0a 2020 3c66 696c 6520 6f76 6572 7772 >. . . . . . . . . . . │ │ │ -0000ed30: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -0000f000: 0a20 203c 6669 6c65 206f 7665 7277 7269 . │ │ │ -0000f0b0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -0000f220: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -0000f390: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . < │ │ │ -0000f670: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0000f680: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0000f690: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0000f6a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0000f6b0: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ -0000f6c0: 5f64 6973 7461 6e63 652e 786d 6c22 2064 _distance.xml" d │ │ │ -0000f6d0: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ -0000f6e0: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ -0000f6f0: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ -0000f700: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ -0000f710: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ -0000f720: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0000f930: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . │ │ │ -0000fcd0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ -0000ff00: 3c66 696c 6520 6f76 6572 7772 6974 653d . . < │ │ │ -00010070: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00010080: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00010090: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -000100a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -000100b0: 6f63 7372 632f 6675 6e63 7265 662f 7371 ocsrc/funcref/sq │ │ │ -000100c0: 6c5f 6765 745f 7072 6976 6174 655f 7072 l_get_private_pr │ │ │ -000100d0: 6f66 696c 655f 7374 7269 6e67 2e78 6d6c ofile_string.xml │ │ │ -000100e0: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -000100f0: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -00010100: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -00010110: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -00010120: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -00010130: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . . │ │ │ -000102b0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ -00010590: 203c 6669 6c65 206f 7665 7277 7269 7465 . . < │ │ │ -00010700: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00010710: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00010720: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00010730: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00010740: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ -00010750: 7269 6e74 665f 696e 7665 7273 652e 786d rintf_inverse.xm │ │ │ -00010760: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ -00010770: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ -00010780: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ -00010790: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ -000107a0: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ -000107b0: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . < │ │ │ -00010920: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00010930: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00010940: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00010950: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00010960: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ -00010970: 6c69 745f 6465 636f 6465 2e78 6d6c 2220 lit_decode.xml" │ │ │ -00010980: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -00010990: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -000109a0: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -000109b0: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -000109c0: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -000109d0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ -00010b50: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00010b60: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00010b70: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00010b80: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00010b90: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ -00010ba0: 6172 716c 5f72 6578 6563 5f77 6974 685f arql_rexec_with_ │ │ │ -00010bb0: 6d65 7461 2e78 6d6c 2220 6461 765f 6f77 meta.xml" dav_ow │ │ │ -00010bc0: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ -00010bd0: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ -00010be0: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ -00010bf0: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ -00010c00: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . . │ │ │ -00010e40: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ -000111d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ -00011280: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -00011550: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -000116c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -000118e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ -00011b00: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00011b10: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00011b20: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00011b30: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00011b40: 6f63 7372 632f 6675 6e63 7265 662f 736d ocsrc/funcref/sm │ │ │ -00011b50: 696d 655f 7369 676e 2e78 6d6c 2220 6461 ime_sign.xml" da │ │ │ -00011b60: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ -00011b70: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ -00011b80: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ -00011b90: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ -00011ba0: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ -00011bb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -00011e90: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ -000122c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ -00012430: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00012440: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00012450: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00012460: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00012470: 6f63 7372 632f 6675 6e63 7265 662f 7365 ocsrc/funcref/se │ │ │ -00012480: 735f 7265 6164 5f6c 696e 652e 786d 6c22 s_read_line.xml" │ │ │ -00012490: 2064 6176 5f6f 776e 6572 3d22 6461 7622 dav_owner="dav" │ │ │ -000124a0: 2064 6176 5f67 7270 3d22 6164 6d69 6e69 dav_grp="admini │ │ │ -000124b0: 7374 7261 746f 7273 2220 6461 765f 7065 strators" dav_pe │ │ │ -000124c0: 726d 3d22 3131 3031 3030 3130 304e 4e22 rm="110100100NN" │ │ │ -000124d0: 206d 616b 6570 6174 683d 2279 6573 222f makepath="yes"/ │ │ │ -000124e0: 3e0a 2020 3c66 696c 6520 6f76 6572 7772 >. . . . │ │ │ -00012700: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00012870: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . < │ │ │ -00012a90: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00012aa0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00012ab0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00012ac0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00012ad0: 6f63 7372 632f 6675 6e63 7265 662f 7365 ocsrc/funcref/se │ │ │ -00012ae0: 7175 656e 6365 5f6e 6578 742e 786d 6c22 quence_next.xml" │ │ │ -00012af0: 2064 6176 5f6f 776e 6572 3d22 6461 7622 dav_owner="dav" │ │ │ -00012b00: 2064 6176 5f67 7270 3d22 6164 6d69 6e69 dav_grp="admini │ │ │ -00012b10: 7374 7261 746f 7273 2220 6461 765f 7065 strators" dav_pe │ │ │ -00012b20: 726d 3d22 3131 3031 3030 3130 304e 4e22 rm="110100100NN" │ │ │ -00012b30: 206d 616b 6570 6174 683d 2279 6573 222f makepath="yes"/ │ │ │ -00012b40: 3e0a 2020 3c66 696c 6520 6f76 6572 7772 >. . . . │ │ │ -00012d60: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ -00013180: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -00013650: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -000137c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ -000139e0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -000139f0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00013a00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00013a10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00013a20: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ -00013a30: 706c 5f73 796e 632e 786d 6c22 2064 6176 pl_sync.xml" dav │ │ │ -00013a40: 5f6f 776e 6572 3d22 6461 7622 2064 6176 _owner="dav" dav │ │ │ -00013a50: 5f67 7270 3d22 6164 6d69 6e69 7374 7261 _grp="administra │ │ │ -00013a60: 746f 7273 2220 6461 765f 7065 726d 3d22 tors" dav_perm=" │ │ │ -00013a70: 3131 3031 3030 3130 304e 4e22 206d 616b 110100100NN" mak │ │ │ -00013a80: 6570 6174 683d 2279 6573 222f 3e0a 2020 epath="yes"/>. │ │ │ -00013a90: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . │ │ │ -00013f80: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ -00014030: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ -000143c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -000145e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ -00014950: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ -00014a00: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00014a10: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00014a20: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00014a30: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00014a40: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ -00014a50: 6772 5f69 6e74 6572 6365 7074 2e78 6d6c gr_intercept.xml │ │ │ -00014a60: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -00014a70: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -00014a80: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -00014a90: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -00014aa0: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -00014ab0: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . . . . . . . . │ │ │ -00015060: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00015280: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00015600: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ -00015a60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00015d40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ -00015eb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . < │ │ │ -00016190: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -000161a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -000161b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -000161c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -000161d0: 6f63 7372 632f 6675 6e63 7265 662f 7264 ocsrc/funcref/rd │ │ │ -000161e0: 665f 7175 6164 5f75 7269 2e78 6d6c 2220 f_quad_uri.xml" │ │ │ -000161f0: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -00016200: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -00016210: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -00016220: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -00016230: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -00016240: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ -000165d0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ -00016740: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00016750: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00016760: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00016770: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00016780: 6f63 7372 632f 6675 6e63 7265 662f 7264 ocsrc/funcref/rd │ │ │ -00016790: 665f 6c61 6e67 6d61 7463 6865 732e 786d f_langmatches.xm │ │ │ -000167a0: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ -000167b0: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ -000167c0: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ -000167d0: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ -000167e0: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ -000167f0: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . . . │ │ │ -00016af0: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ -00016bb0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00016bc0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00016bd0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00016be0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00016bf0: 6f63 7372 632f 6675 6e63 7265 662f 7264 ocsrc/funcref/rd │ │ │ -00016c00: 665f 6772 6170 685f 6469 6666 2e78 6d6c f_graph_diff.xml │ │ │ -00016c10: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -00016c20: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -00016c30: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -00016c40: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -00016c50: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -00016c60: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . . . . < │ │ │ -00016f50: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00016f60: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00016f70: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00016f80: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00016f90: 6f63 7372 632f 6675 6e63 7265 662f 7264 ocsrc/funcref/rd │ │ │ -00016fa0: 665f 6465 6661 756c 745f 7573 6572 5f70 f_default_user_p │ │ │ -00016fb0: 6572 6d73 5f64 656c 2e78 6d6c 2220 6461 erms_del.xml" da │ │ │ -00016fc0: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ -00016fd0: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ -00016fe0: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ -00016ff0: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ -00017000: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ -00017010: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00017300: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -000173c0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . │ │ │ -000178a0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00017c20: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . │ │ │ -00018050: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00018100: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -000181b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ +0000ac00: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000ac10: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000ac20: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000ac30: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000ac40: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ +0000ac50: 7470 5f63 6c69 656e 742e 786d 6c22 2064 tp_client.xml" d │ │ │ +0000ac60: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +0000ac70: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +0000ac80: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +0000ac90: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +0000aca0: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +0000acb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0000aed0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000aee0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000aef0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000af00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000af10: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ +0000af20: 706c 5f73 6368 6564 5f69 6e69 742e 786d pl_sched_init.xm │ │ │ +0000af30: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ +0000af40: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ +0000af50: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ +0000af60: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ +0000af70: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ +0000af80: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . . < │ │ │ +0000b1b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000b1c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000b1d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000b1e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000b1f0: 6f63 7372 632f 6675 6e63 7265 662f 636f ocsrc/funcref/co │ │ │ +0000b200: 6d70 6c65 7465 5f74 6162 6c65 5f6e 616d mplete_table_nam │ │ │ +0000b210: 652e 786d 6c22 2064 6176 5f6f 776e 6572 e.xml" dav_owner │ │ │ +0000b220: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0000b230: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0000b240: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0000b250: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0000b260: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +0000b600: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0000b6b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ +0000b760: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . < │ │ │ +0000b8d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000b8e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000b8f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000b900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000b910: 6f63 7372 632f 6675 6e63 7265 662f 6e6f ocsrc/funcref/no │ │ │ +0000b920: 772e 786d 6c22 2064 6176 5f6f 776e 6572 w.xml" dav_owner │ │ │ +0000b930: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0000b940: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0000b950: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0000b960: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0000b970: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . . │ │ │ +0000bd00: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +0000bdb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ +0000bfd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000bfe0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000bff0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000c000: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000c010: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ +0000c020: 6772 5f73 7879 2e78 6d6c 2220 6461 765f gr_sxy.xml" dav_ │ │ │ +0000c030: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ +0000c040: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ +0000c050: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ +0000c060: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ +0000c070: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ +0000c080: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000c090: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000c0a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000c0b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000c0c0: 6f63 7372 632f 6675 6e63 7265 662f 7874 ocsrc/funcref/xt │ │ │ +0000c0d0: 655f 6e6f 6465 626c 645f 6669 6e61 6c2e e_nodebld_final. │ │ │ +0000c0e0: 786d 6c22 2064 6176 5f6f 776e 6572 3d22 xml" dav_owner=" │ │ │ +0000c0f0: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0000c100: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0000c110: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0000c120: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0000c130: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . . . │ │ │ +0000c350: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0000c4c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0000c570: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +0000c6e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +0000c790: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ +0000c840: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000c850: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000c860: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000c870: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000c880: 6f63 7372 632f 6675 6e63 7265 662f 6578 ocsrc/funcref/ex │ │ │ +0000c890: 6563 5f72 6573 756c 742e 786d 6c22 2064 ec_result.xml" d │ │ │ +0000c8a0: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +0000c8b0: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +0000c8c0: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +0000c8d0: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +0000c8e0: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +0000c8f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +0000ca60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0000cb10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ +0000cdf0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0000cf50: 3c66 696c 6520 6f76 6572 7772 6974 653d │ │ │ +0000d000: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0000d0b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ +0000d2d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000d2e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000d2f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000d300: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000d310: 6f63 7372 632f 6675 6e63 7265 662f 6c64 ocsrc/funcref/ld │ │ │ +0000d320: 5f64 6972 5f61 6c6c 2e78 6d6c 2220 6461 _dir_all.xml" da │ │ │ +0000d330: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ +0000d340: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ +0000d350: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ +0000d360: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ +0000d370: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ +0000d380: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +0000d710: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0000d7c0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +0000d870: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0000d9e0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . < │ │ │ +0000da90: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000daa0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000dab0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000dac0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000dad0: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ +0000dae0: 6172 7473 5f77 6974 682e 786d 6c22 2064 arts_with.xml" d │ │ │ +0000daf0: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +0000db00: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +0000db10: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +0000db20: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +0000db30: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +0000db40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +0000dd80: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +0000dfa0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +0000e100: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0000e320: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000e330: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000e340: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000e350: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000e360: 6f63 7372 632f 6675 6e63 7265 662f 7365 ocsrc/funcref/se │ │ │ +0000e370: 735f 636f 6e6e 6563 742e 786d 6c22 2064 s_connect.xml" d │ │ │ +0000e380: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +0000e390: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +0000e3a0: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +0000e3b0: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +0000e3c0: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +0000e3d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . │ │ │ +0000e810: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +0000eae0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +0000eba0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0000ed20: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ +0000edd0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . │ │ │ +0000f370: 2020 3c66 696c 6520 6f76 6572 7772 6974 . < │ │ │ +0000f430: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0000f440: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0000f450: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0000f460: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0000f470: 6f63 7372 632f 6675 6e63 7265 662f 584d ocsrc/funcref/XM │ │ │ +0000f480: 4c41 7070 656e 6443 6869 6c64 7265 6e2e LAppendChildren. │ │ │ +0000f490: 786d 6c22 2064 6176 5f6f 776e 6572 3d22 xml" dav_owner=" │ │ │ +0000f4a0: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0000f4b0: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0000f4c0: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0000f4d0: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0000f4e0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . . . . . . │ │ │ +0000f9c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +0000fbe0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0000fe00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . │ │ │ +00010180: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00010230: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00010390: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ +00010440: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00010650: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00010880: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00010930: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . < │ │ │ +00010ec0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00010ed0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00010ee0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00010ef0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00010f00: 6f63 7372 632f 6675 6e63 7265 662f 6c64 ocsrc/funcref/ld │ │ │ +00010f10: 5f64 6972 2e78 6d6c 2220 6461 765f 6f77 _dir.xml" dav_ow │ │ │ +00010f20: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ +00010f30: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ +00010f40: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ +00010f50: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ +00010f60: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . │ │ │ +000110d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . . < │ │ │ +000118a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000118b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000118c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000118d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000118e0: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ +000118f0: 7375 6c74 5f6e 616d 6573 2e78 6d6c 2220 sult_names.xml" │ │ │ +00011900: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +00011910: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +00011920: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00011930: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00011940: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00011950: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . │ │ │ +00011e60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ +00012290: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . . . . │ │ │ +00012a50: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00012b10: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00012c80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +00012d30: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ +00012de0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00012df0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00012e00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00012e10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00012e20: 6f63 7372 632f 6675 6e63 7265 662f 6461 ocsrc/funcref/da │ │ │ +00012e30: 765f 6578 702e 786d 6c22 2064 6176 5f6f v_exp.xml" dav_o │ │ │ +00012e40: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +00012e50: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +00012e60: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +00012e70: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +00012e80: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. │ │ │ +00012f40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00013220: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +000132d0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000134f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00013500: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00013510: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00013520: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00013530: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ +00013540: 6172 716c 5f73 656c 6563 745f 6b6e 6f77 arql_select_know │ │ │ +00013550: 6e5f 6772 6170 6873 2e78 6d6c 2220 6461 n_graphs.xml" da │ │ │ +00013560: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ +00013570: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ +00013580: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ +00013590: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ +000135a0: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ +000135b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00013660: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +000137d0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00013a00: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ +00013e40: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00013ef0: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ +00013fa0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . │ │ │ +00014540: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +00014990: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00014bb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +00014d20: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +00014e90: 3c66 696c 6520 6f76 6572 7772 6974 653d │ │ │ +00014f40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +000150b0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00015170: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00015390: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000153a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000153b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000153c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000153d0: 6f63 7372 632f 6675 6e63 7265 662f 6269 ocsrc/funcref/bi │ │ │ +000153e0: 745f 786f 722e 786d 6c22 2064 6176 5f6f t_xor.xml" dav_o │ │ │ +000153f0: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +00015400: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +00015410: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +00015420: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +00015430: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . . . │ │ │ +00015710: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . . . │ │ │ +00015e20: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00015ed0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00016040: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +000163e0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00016540: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +000166b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00016760: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00016980: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00016d00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . │ │ │ +00017140: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . < │ │ │ +000174d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000174e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000174f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00017500: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00017510: 6f63 7372 632f 6675 6e63 7265 662f 636f ocsrc/funcref/co │ │ │ +00017520: 6e63 6174 656e 6174 652e 786d 6c22 2064 ncatenate.xml" d │ │ │ +00017530: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +00017540: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +00017550: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +00017560: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +00017570: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +00017580: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ +00017be0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00017d50: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00017f70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00018190: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000181a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000181b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000181c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000181d0: 6f63 7372 632f 6675 6e63 7265 662f 626c ocsrc/funcref/bl │ │ │ +000181e0: 6f67 6765 722e 6765 7454 656d 706c 6174 ogger.getTemplat │ │ │ +000181f0: 652e 786d 6c22 2064 6176 5f6f 776e 6572 e.xml" dav_owner │ │ │ +00018200: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00018210: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00018220: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00018230: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00018240: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . │ │ │ -000183d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -00018480: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . │ │ │ -00018a20: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . < │ │ │ -00018ae0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00018af0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00018b00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00018b10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00018b20: 6f63 7372 632f 6675 6e63 7265 662f 6d74 ocsrc/funcref/mt │ │ │ -00018b30: 2e70 7562 6c69 7368 506f 7374 2e78 6d6c .publishPost.xml │ │ │ -00018b40: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -00018b50: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -00018b60: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -00018b70: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -00018b80: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -00018b90: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . │ │ │ -00018c50: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ -00018d10: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00018d20: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00018d30: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00018d40: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00018d50: 6f63 7372 632f 6675 6e63 7265 662f 6d74 ocsrc/funcref/mt │ │ │ -00018d60: 2e67 6574 506f 7374 4361 7465 676f 7269 .getPostCategori │ │ │ -00018d70: 6573 2e78 6d6c 2220 6461 765f 6f77 6e65 es.xml" dav_owne │ │ │ -00018d80: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ -00018d90: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ -00018da0: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ -00018db0: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ -00018dc0: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . . . . < │ │ │ -00019140: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00019150: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00019160: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00019170: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00019180: 6f63 7372 632f 6675 6e63 7265 662f 6d69 ocsrc/funcref/mi │ │ │ -00019190: 6e75 7465 2e78 6d6c 2220 6461 765f 6f77 nute.xml" dav_ow │ │ │ -000191a0: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ -000191b0: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ -000191c0: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ -000191d0: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ -000191e0: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . < │ │ │ -00019350: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00019360: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00019370: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00019380: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00019390: 6f63 7372 632f 6675 6e63 7265 662f 6d69 ocsrc/funcref/mi │ │ │ -000193a0: 6d65 5f62 6f64 792e 786d 6c22 2064 6176 me_body.xml" dav │ │ │ -000193b0: 5f6f 776e 6572 3d22 6461 7622 2064 6176 _owner="dav" dav │ │ │ -000193c0: 5f67 7270 3d22 6164 6d69 6e69 7374 7261 _grp="administra │ │ │ -000193d0: 746f 7273 2220 6461 765f 7065 726d 3d22 tors" dav_perm=" │ │ │ -000193e0: 3131 3031 3030 3130 304e 4e22 206d 616b 110100100NN" mak │ │ │ -000193f0: 6570 6174 683d 2279 6573 222f 3e0a 2020 epath="yes"/>. │ │ │ -00019400: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ -000196f0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -000197a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -00019850: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ -00019900: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -00019a60: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ -00019b10: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00019bc0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ -00019dd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00019de0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00019df0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00019e00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00019e10: 6f63 7372 632f 6675 6e63 7265 662f 6c6f ocsrc/funcref/lo │ │ │ -00019e20: 6731 302e 786d 6c22 2064 6176 5f6f 776e g10.xml" dav_own │ │ │ -00019e30: 6572 3d22 6461 7622 2064 6176 5f67 7270 er="dav" dav_grp │ │ │ -00019e40: 3d22 6164 6d69 6e69 7374 7261 746f 7273 ="administrators │ │ │ -00019e50: 2220 6461 765f 7065 726d 3d22 3131 3031 " dav_perm="1101 │ │ │ -00019e60: 3030 3130 304e 4e22 206d 616b 6570 6174 00100NN" makepat │ │ │ -00019e70: 683d 2279 6573 222f 3e0a 2020 3c66 696c h="yes"/>. . . . . │ │ │ -0001a140: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -0001a1f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ -0001a2a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001a2b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001a2c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001a2d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001a2e0: 6f63 7372 632f 6675 6e63 7265 662f 6c65 ocsrc/funcref/le │ │ │ -0001a2f0: 6674 2e78 6d6c 2220 6461 765f 6f77 6e65 ft.xml" dav_owne │ │ │ -0001a300: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ -0001a310: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ -0001a320: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ -0001a330: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ -0001a340: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . │ │ │ -0001a4b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . . . . │ │ │ +000189b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ +00018a60: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00018d40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . < │ │ │ +00019180: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00019190: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000191a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000191b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000191c0: 6f63 7372 632f 6675 6e63 7265 662f 736f ocsrc/funcref/so │ │ │ +000191d0: 6170 5f63 7572 7265 6e74 5f75 726c 2e78 ap_current_url.x │ │ │ +000191e0: 6d6c 2220 6461 765f 6f77 6e65 723d 2264 ml" dav_owner="d │ │ │ +000191f0: 6176 2220 6461 765f 6772 703d 2261 646d av" dav_grp="adm │ │ │ +00019200: 696e 6973 7472 6174 6f72 7322 2064 6176 inistrators" dav │ │ │ +00019210: 5f70 6572 6d3d 2231 3130 3130 3031 3030 _perm="110100100 │ │ │ +00019220: 4e4e 2220 6d61 6b65 7061 7468 3d22 7965 NN" makepath="ye │ │ │ +00019230: 7322 2f3e 0a20 203c 6669 6c65 206f 7665 s"/>. . . . . . . . . . │ │ │ +000198a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00019ad0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00019ae0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00019af0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00019b00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00019b10: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ +00019b20: 6c69 745f 6465 636f 6465 2e78 6d6c 2220 lit_decode.xml" │ │ │ +00019b30: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +00019b40: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +00019b50: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +00019b60: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +00019b70: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +00019b80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00019e60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +00019fc0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +0001a1e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . < │ │ │ +0001a610: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001a620: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001a630: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001a640: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001a650: 6f63 7372 632f 6675 6e63 7265 662f 7865 ocsrc/funcref/xe │ │ │ +0001a660: 6e63 5f70 656d 5f65 7870 6f72 742e 786d nc_pem_export.xm │ │ │ 0001a670: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ 0001a680: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ 0001a690: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ 0001a6a0: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ 0001a6b0: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ 0001a6c0: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . │ │ │ -0001a820: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ -0001aaf0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0001a770: 0a20 203c 6669 6c65 206f 7665 7277 7269 . │ │ │ +0001a820: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +0001ab00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ 0001ac60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ -0001add0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -0001af40: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ -0001aff0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001b000: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001b010: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001b020: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001b030: 6f63 7372 632f 6675 6e63 7265 662f 6973 ocsrc/funcref/is │ │ │ -0001b040: 7374 7269 6e67 2e78 6d6c 2220 6461 765f string.xml" dav_ │ │ │ -0001b050: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ -0001b060: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ -0001b070: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ -0001b080: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ -0001b090: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ -0001b0a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001b0b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001b0c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001b0d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001b0e0: 6f63 7372 632f 6675 6e63 7265 662f 6973 ocsrc/funcref/is │ │ │ -0001b0f0: 7265 662e 786d 6c22 2064 6176 5f6f 776e ref.xml" dav_own │ │ │ -0001b100: 6572 3d22 6461 7622 2064 6176 5f67 7270 er="dav" dav_grp │ │ │ -0001b110: 3d22 6164 6d69 6e69 7374 7261 746f 7273 ="administrators │ │ │ -0001b120: 2220 6461 765f 7065 726d 3d22 3131 3031 " dav_perm="1101 │ │ │ -0001b130: 3030 3130 304e 4e22 206d 616b 6570 6174 00100NN" makepat │ │ │ -0001b140: 683d 2279 6573 222f 3e0a 2020 3c66 696c h="yes"/>. . . . . . . . . . │ │ │ -0001b780: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -0001b830: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -0001b8e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ -0001bb00: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -0001bd20: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -0001c150: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -0001c200: 3c66 696c 6520 6f76 6572 7772 6974 653d │ │ │ -0001c2b0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . │ │ │ -0001c870: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . < │ │ │ -0001cb50: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001cb60: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001cb70: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001cb80: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001cb90: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ -0001cba0: 7470 5f70 6174 682e 786d 6c22 2064 6176 tp_path.xml" dav │ │ │ -0001cbb0: 5f6f 776e 6572 3d22 6461 7622 2064 6176 _owner="dav" dav │ │ │ -0001cbc0: 5f67 7270 3d22 6164 6d69 6e69 7374 7261 _grp="administra │ │ │ -0001cbd0: 746f 7273 2220 6461 765f 7065 726d 3d22 tors" dav_perm=" │ │ │ -0001cbe0: 3131 3031 3030 3130 304e 4e22 206d 616b 110100100NN" mak │ │ │ -0001cbf0: 6570 6174 683d 2279 6573 222f 3e0a 2020 epath="yes"/>. │ │ │ -0001cc00: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -0001ccb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0001ced0: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ -0001cf80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ -0001d260: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0001d690: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -0001d800: 3c66 696c 6520 6f76 6572 7772 6974 653d │ │ │ -0001d8b0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . │ │ │ -0001dd90: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . < │ │ │ -0001df00: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001df10: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001df20: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001df30: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001df40: 6f63 7372 632f 6675 6e63 7265 662f 677a ocsrc/funcref/gz │ │ │ -0001df50: 5f66 696c 655f 6f70 656e 2e78 6d6c 2220 _file_open.xml" │ │ │ -0001df60: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -0001df70: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -0001df80: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -0001df90: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -0001dfa0: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -0001dfb0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -0001e280: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -0001e3f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ -0001e610: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ -0001e980: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . . < │ │ │ -0001efe0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001eff0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001f000: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001f010: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001f020: 6f63 7372 632f 6675 6e63 7265 662f 6669 ocsrc/funcref/fi │ │ │ -0001f030: 6c65 5f6d 6b70 6174 682e 786d 6c22 2064 le_mkpath.xml" d │ │ │ -0001f040: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ -0001f050: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ -0001f060: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ -0001f070: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ -0001f080: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ -0001f090: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . │ │ │ -0001f570: 3c66 696c 6520 6f76 6572 7772 6974 653d │ │ │ -0001f620: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ -0001f990: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ -0001fa40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -0001fc60: 3c66 696c 6520 6f76 6572 7772 6974 653d . . < │ │ │ -0001fdd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0001fde0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0001fdf0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0001fe00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -0001fe10: 6f63 7372 632f 6675 6e63 7265 662f 6569 ocsrc/funcref/ei │ │ │ -0001fe20: 7468 6572 2e78 6d6c 2220 6461 765f 6f77 ther.xml" dav_ow │ │ │ -0001fe30: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ -0001fe40: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ -0001fe50: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ -0001fe60: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ -0001fe70: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . │ │ │ -0001ff30: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -0001ffe0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00020090: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ -000204e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00020590: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -00020910: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -00020a80: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00020b30: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . . . . . │ │ │ +0001b510: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . │ │ │ +0001ba00: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . < │ │ │ +0001bce0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001bcf0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001bd00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001bd10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001bd20: 6f63 7372 632f 6675 6e63 7265 662f 5245 ocsrc/funcref/RE │ │ │ +0001bd30: 504c 5f55 5044 4154 455f 534e 4150 5348 PL_UPDATE_SNAPSH │ │ │ +0001bd40: 4f54 2e78 6d6c 2220 6461 765f 6f77 6e65 OT.xml" dav_owne │ │ │ +0001bd50: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ +0001bd60: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ +0001bd70: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ +0001bd80: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ +0001bd90: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . . . . │ │ │ +0001c1c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +0001c270: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ +0001c490: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001c4a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001c4b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001c4c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001c4d0: 6f63 7372 632f 6675 6e63 7265 662f 7374 ocsrc/funcref/st │ │ │ +0001c4e0: 7269 6e67 5f6f 7574 7075 745f 666c 7573 ring_output_flus │ │ │ +0001c4f0: 682e 786d 6c22 2064 6176 5f6f 776e 6572 h.xml" dav_owner │ │ │ +0001c500: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0001c510: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0001c520: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0001c530: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0001c540: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +0001c600: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +0001c990: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . │ │ │ +0001ce80: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +0001d0a0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +0001d200: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +0001d380: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ +0001d9d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +0001dbf0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +0001dcb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . │ │ │ +0001e0f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ +0001e740: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0001e7f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ +0001e8a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001e8b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001e8c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001e8d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001e8e0: 6f63 7372 632f 6675 6e63 7265 662f 6269 ocsrc/funcref/bi │ │ │ +0001e8f0: 665f 6c6f 6e67 5f61 7267 2e78 6d6c 2220 f_long_arg.xml" │ │ │ +0001e900: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ +0001e910: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ +0001e920: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ +0001e930: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ +0001e940: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ +0001e950: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +0001ec30: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . . . │ │ │ +0001f350: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . │ │ │ +0001f790: 3c66 696c 6520 6f76 6572 7772 6974 653d . . < │ │ │ +0001f900: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001f910: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001f920: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001f930: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001f940: 6f63 7372 632f 6675 6e63 7265 662f 706f ocsrc/funcref/po │ │ │ +0001f950: 7369 7469 6f6e 2e78 6d6c 2220 6461 765f sition.xml" dav_ │ │ │ +0001f960: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ +0001f970: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ +0001f980: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ +0001f990: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ +0001f9a0: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ +0001f9b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001f9c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001f9d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001f9e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001f9f0: 6f63 7372 632f 6675 6e63 7265 662f 6d64 ocsrc/funcref/md │ │ │ +0001fa00: 355f 7570 6461 7465 2e78 6d6c 2220 6461 5_update.xml" da │ │ │ +0001fa10: 765f 6f77 6e65 723d 2264 6176 2220 6461 v_owner="dav" da │ │ │ +0001fa20: 765f 6772 703d 2261 646d 696e 6973 7472 v_grp="administr │ │ │ +0001fa30: 6174 6f72 7322 2064 6176 5f70 6572 6d3d ators" dav_perm= │ │ │ +0001fa40: 2231 3130 3130 3031 3030 4e4e 2220 6d61 "110100100NN" ma │ │ │ +0001fa50: 6b65 7061 7468 3d22 7965 7322 2f3e 0a20 kepath="yes"/>. │ │ │ +0001fa60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . < │ │ │ +0001fd30: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001fd40: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001fd50: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001fd60: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001fd70: 6f63 7372 632f 6675 6e63 7265 662f 6d65 ocsrc/funcref/me │ │ │ +0001fd80: 7461 5765 626c 6f67 2e65 6469 7450 6f73 taWeblog.editPos │ │ │ +0001fd90: 742e 786d 6c22 2064 6176 5f6f 776e 6572 t.xml" dav_owner │ │ │ +0001fda0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0001fdb0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0001fdc0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0001fdd0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0001fde0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . < │ │ │ +0001fea0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0001feb0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0001fec0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0001fed0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +0001fee0: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ +0001fef0: 7470 5f6d 6170 5f74 6162 6c65 2e78 6d6c tp_map_table.xml │ │ │ +0001ff00: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ +0001ff10: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ +0001ff20: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ +0001ff30: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ +0001ff40: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ +0001ff50: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . . . │ │ │ +00020210: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . < │ │ │ +000202c0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000202d0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000202e0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000202f0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00020300: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ +00020310: 7470 5f72 6571 7565 7374 5f68 6561 6465 tp_request_heade │ │ │ +00020320: 722e 786d 6c22 2064 6176 5f6f 776e 6572 r.xml" dav_owner │ │ │ +00020330: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00020340: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00020350: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00020360: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00020370: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . │ │ │ +00020430: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +000204e0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00020590: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ +00020a80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ -00020e10: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00020ec0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -00020f70: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00021020: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ -00021660: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ -00021880: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00021890: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -000218a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -000218b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -000218c0: 6f63 7372 632f 6675 6e63 7265 662f 6461 ocsrc/funcref/da │ │ │ -000218d0: 7465 7374 7269 6e67 5f67 6d74 2e78 6d6c testring_gmt.xml │ │ │ -000218e0: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ -000218f0: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ -00021900: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ -00021910: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ -00021920: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ -00021930: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . . . . . . . . . . . . │ │ │ -000221a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ -00022250: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . . . . │ │ │ -00022ab0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ -00022c20: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . │ │ │ -00023110: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00023270: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -00023760: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -000238d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ -00023f40: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ -00024000: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00024010: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00024020: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00024030: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00024040: 6f63 7372 632f 6675 6e63 7265 662f 626c ocsrc/funcref/bl │ │ │ -00024050: 6f67 6765 722e 6765 7450 6f73 742e 786d ogger.getPost.xm │ │ │ -00024060: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ -00024070: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ -00024080: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ -00024090: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ -000240a0: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ -000240b0: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . . . . . . . . . │ │ │ -00024880: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00024940: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00024ab0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -00024d80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -000251c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ -000253e0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -000255f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -000258b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00025b90: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ -00025cf0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ -00025e60: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00020e10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . │ │ │ +00021310: 2020 3c66 696c 6520 6f76 6572 7772 6974 │ │ │ +000213c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00021530: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00021690: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . │ │ │ +00021c40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . . . . │ │ │ +000222a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . . < │ │ │ +000226d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000226e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000226f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00022700: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00022710: 6f63 7372 632f 6675 6e63 7265 662f 7370 ocsrc/funcref/sp │ │ │ +00022720: 6172 716c 5f65 7661 6c5f 746f 5f61 7272 arql_eval_to_arr │ │ │ +00022730: 6179 2e78 6d6c 2220 6461 765f 6f77 6e65 ay.xml" dav_owne │ │ │ +00022740: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ +00022750: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ +00022760: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ +00022770: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ +00022780: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . . . . . < │ │ │ +00022bd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00022be0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00022bf0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00022c00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00022c10: 6f63 7372 632f 6675 6e63 7265 662f 7661 ocsrc/funcref/va │ │ │ +00022c20: 6375 756d 2e78 6d6c 2220 6461 765f 6f77 cuum.xml" dav_ow │ │ │ +00022c30: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ +00022c40: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ +00022c50: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ +00022c60: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ +00022c70: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . │ │ │ +00022df0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00022ea0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00022f50: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . │ │ │ +00023500: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00023740: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ +00023800: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . < │ │ │ +000238b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000238c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000238d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000238e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000238f0: 6f63 7372 632f 6675 6e63 7265 662f 6375 ocsrc/funcref/cu │ │ │ +00023900: 7264 6174 652e 786d 6c22 2064 6176 5f6f rdate.xml" dav_o │ │ │ +00023910: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +00023920: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +00023930: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +00023940: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +00023950: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . . │ │ │ +00023c30: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +00023cf0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00023da0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00023fc0: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ +00024070: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00024080: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00024090: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000240a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000240b0: 6f63 7372 632f 6675 6e63 7265 662f 5354 ocsrc/funcref/ST │ │ │ +000240c0: 5f45 7874 6572 696f 7252 696e 672e 786d _ExteriorRing.xm │ │ │ +000240d0: 6c22 2064 6176 5f6f 776e 6572 3d22 6461 l" dav_owner="da │ │ │ +000240e0: 7622 2064 6176 5f67 7270 3d22 6164 6d69 v" dav_grp="admi │ │ │ +000240f0: 6e69 7374 7261 746f 7273 2220 6461 765f nistrators" dav_ │ │ │ +00024100: 7065 726d 3d22 3131 3031 3030 3130 304e perm="110100100N │ │ │ +00024110: 4e22 206d 616b 6570 6174 683d 2279 6573 N" makepath="yes │ │ │ +00024120: 222f 3e0a 2020 3c66 696c 6520 6f76 6572 "/>. . . . │ │ │ +00024400: 0a20 203c 6669 6c65 206f 7665 7277 7269 . │ │ │ +000244b0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +000246e0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . < │ │ │ +00024a80: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00024a90: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00024aa0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00024ab0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00024ac0: 6f63 7372 632f 6675 6e63 7265 662f 6e6d ocsrc/funcref/nm │ │ │ +00024ad0: 5f6d 6178 2e78 6d6c 2220 6461 765f 6f77 _max.xml" dav_ow │ │ │ +00024ae0: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ +00024af0: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ +00024b00: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ +00024b10: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ +00024b20: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . │ │ │ +00024c90: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . │ │ │ +00025250: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +000253c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00025530: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ +000258d0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00025ba0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00025e70: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ +00025f20: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -00026390: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . < │ │ │ -00026680: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00026690: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -000266a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -000266b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -000266c0: 6f63 7372 632f 6675 6e63 7265 662f 584d ocsrc/funcref/XM │ │ │ -000266d0: 4c54 7970 652e 6765 744e 616d 6573 7061 LType.getNamespa │ │ │ -000266e0: 6365 2e78 6d6c 2220 6461 765f 6f77 6e65 ce.xml" dav_owne │ │ │ -000266f0: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ -00026700: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ -00026710: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ -00026720: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ -00026730: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . . . < │ │ │ -00026a20: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00026a30: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00026a40: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00026a50: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00026a60: 6f63 7372 632f 6675 6e63 7265 662f 584d ocsrc/funcref/XM │ │ │ -00026a70: 4c54 7970 652e 6372 6561 7465 5363 6865 LType.createSche │ │ │ -00026a80: 6d61 4261 7365 6458 4d4c 2e78 6d6c 2220 maBasedXML.xml" │ │ │ -00026a90: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -00026aa0: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -00026ab0: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -00026ac0: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -00026ad0: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -00026ae0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -00026c60: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ -00026d10: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -00026e80: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00026f30: 203c 6669 6c65 206f 7665 7277 7269 7465 │ │ │ -00026fe0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . │ │ │ -00027420: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ -00027710: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ -00027a80: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ -00027b30: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00027b40: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00027b50: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00027b60: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00027b70: 6f63 7372 632f 6675 6e63 7265 662f 5354 ocsrc/funcref/ST │ │ │ -00027b80: 5f59 4d61 782e 786d 6c22 2064 6176 5f6f _YMax.xml" dav_o │ │ │ -00027b90: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ -00027ba0: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ -00027bb0: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ -00027bc0: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ -00027bd0: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . . │ │ │ -00027df0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . . . . < │ │ │ -000284f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00028500: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00028510: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00028520: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -00028530: 6f63 7372 632f 6675 6e63 7265 662f 5354 ocsrc/funcref/ST │ │ │ -00028540: 5f47 656f 6d65 7472 794e 2e78 6d6c 2220 _GeometryN.xml" │ │ │ -00028550: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -00028560: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -00028570: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -00028580: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -00028590: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -000285a0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . . . . . . . . . │ │ │ -00028fc0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ -000291d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . < │ │ │ -00029290: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -000292a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -000292b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -000292c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ -000292d0: 6f63 7372 632f 6675 6e63 7265 662f 4752 ocsrc/funcref/GR │ │ │ -000292e0: 4f55 505f 434f 4e43 4154 2e78 6d6c 2220 OUP_CONCAT.xml" │ │ │ -000292f0: 6461 765f 6f77 6e65 723d 2264 6176 2220 dav_owner="dav" │ │ │ -00029300: 6461 765f 6772 703d 2261 646d 696e 6973 dav_grp="adminis │ │ │ -00029310: 7472 6174 6f72 7322 2064 6176 5f70 6572 trators" dav_per │ │ │ -00029320: 6d3d 2231 3130 3130 3031 3030 4e4e 2220 m="110100100NN" │ │ │ -00029330: 6d61 6b65 7061 7468 3d22 7965 7322 2f3e makepath="yes"/> │ │ │ -00029340: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ +00026140: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +000261f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . < │ │ │ +00026570: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00026580: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00026590: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000265a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000265b0: 6f63 7372 632f 6675 6e63 7265 662f 5645 ocsrc/funcref/VE │ │ │ +000265c0: 4354 4f52 5f4f 465f 4e4f 4e4e 554c 4c53 CTOR_OF_NONNULLS │ │ │ +000265d0: 5f4f 525f 4e55 4c4c 5f41 4747 2e78 6d6c _OR_NULL_AGG.xml │ │ │ +000265e0: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ +000265f0: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ +00026600: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ +00026610: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ +00026620: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ +00026630: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. . │ │ │ +00026790: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00026900: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +000269b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +00026c90: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00026e00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00026eb0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00027010: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00027180: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +00027460: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +00027670: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +00027720: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . . │ │ │ +00027ce0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . < │ │ │ +00028060: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00028070: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00028080: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00028090: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000280a0: 6f63 7372 632f 6675 6e63 7265 662f 7265 ocsrc/funcref/re │ │ │ +000280b0: 706c 6163 652e 786d 6c22 2064 6176 5f6f place.xml" dav_o │ │ │ +000280c0: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +000280d0: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +000280e0: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +000280f0: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +00028100: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . < │ │ │ +000281c0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000281d0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000281e0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000281f0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00028200: 6f63 7372 632f 6675 6e63 7265 662f 6674 ocsrc/funcref/ft │ │ │ +00028210: 705f 6c73 2e78 6d6c 2220 6461 765f 6f77 p_ls.xml" dav_ow │ │ │ +00028220: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ +00028230: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ +00028240: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ +00028250: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ +00028260: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . . . │ │ │ +00028550: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +000286d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +00028780: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . < │ │ │ +000288e0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000288f0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00028900: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00028910: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00028920: 6f63 7372 632f 6675 6e63 7265 662f 7564 ocsrc/funcref/ud │ │ │ +00028930: 6469 5f67 6574 5f72 6567 6973 7465 7265 di_get_registere │ │ │ +00028940: 6449 6e66 6f2e 786d 6c22 2064 6176 5f6f dInfo.xml" dav_o │ │ │ +00028950: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +00028960: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +00028970: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +00028980: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +00028990: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . . . │ │ │ +00028c70: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00028d20: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ +00028dd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00028de0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00028df0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00028e00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +00028e10: 6f63 7372 632f 6675 6e63 7265 662f 5354 ocsrc/funcref/ST │ │ │ +00028e20: 5f4d 2e78 6d6c 2220 6461 765f 6f77 6e65 _M.xml" dav_owne │ │ │ +00028e30: 723d 2264 6176 2220 6461 765f 6772 703d r="dav" dav_grp= │ │ │ +00028e40: 2261 646d 696e 6973 7472 6174 6f72 7322 "administrators" │ │ │ +00028e50: 2064 6176 5f70 6572 6d3d 2231 3130 3130 dav_perm="11010 │ │ │ +00028e60: 3031 3030 4e4e 2220 6d61 6b65 7061 7468 0100NN" makepath │ │ │ +00028e70: 3d22 7965 7322 2f3e 0a20 203c 6669 6c65 ="yes"/>. . . │ │ │ +00028fe0: 203c 6669 6c65 206f 7665 7277 7269 7465 . < │ │ │ +00029090: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000290a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000290b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000290c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f64 rget_uri="demo/d │ │ │ +000290d0: 6f63 7372 632f 6675 6e63 7265 662f 6c68 ocsrc/funcref/lh │ │ │ +000290e0: 5f67 6574 5f68 616e 646c 6572 2e78 6d6c _get_handler.xml │ │ │ +000290f0: 2220 6461 765f 6f77 6e65 723d 2264 6176 " dav_owner="dav │ │ │ +00029100: 2220 6461 765f 6772 703d 2261 646d 696e " dav_grp="admin │ │ │ +00029110: 6973 7472 6174 6f72 7322 2064 6176 5f70 istrators" dav_p │ │ │ +00029120: 6572 6d3d 2231 3130 3130 3031 3030 4e4e erm="110100100NN │ │ │ +00029130: 2220 6d61 6b65 7061 7468 3d22 7965 7322 " makepath="yes" │ │ │ +00029140: 2f3e 0a20 203c 6669 6c65 206f 7665 7277 />. │ │ │ +00029200: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . │ │ │ +000292b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +00029410: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . │ │ │ 0002e8e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ 0002ea30: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ 00030d60: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ -00030e10: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ -00031010: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . . . < │ │ │ +00030e10: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00030e20: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00030e30: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00030e40: 7267 6574 5f75 7269 3d22 6465 6d6f 2f69 rget_uri="demo/i │ │ │ +00030e50: 6d61 6765 732f 7472 6565 2f66 6c61 672d mages/tree/flag- │ │ │ +00030e60: 6765 726d 616e 792e 6769 6622 2064 6176 germany.gif" dav │ │ │ +00030e70: 5f6f 776e 6572 3d22 6461 7622 2064 6176 _owner="dav" dav │ │ │ +00030e80: 5f67 7270 3d22 6164 6d69 6e69 7374 7261 _grp="administra │ │ │ +00030e90: 746f 7273 2220 6461 765f 7065 726d 3d22 tors" dav_perm=" │ │ │ +00030ea0: 3131 3031 3030 3130 304e 4e22 206d 616b 110100100NN" mak │ │ │ +00030eb0: 6570 6174 683d 2279 6573 222f 3e0a 2020 epath="yes"/>. │ │ │ +00030ec0: 3c66 696c 6520 6f76 6572 7772 6974 653d . │ │ │ +00030f70: 3c66 696c 6520 6f76 6572 7772 6974 653d . < │ │ │ +00031020: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00031030: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00031040: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00031050: 7267 6574 5f75 7269 3d22 6465 6d6f 2f69 rget_uri="demo/i │ │ │ +00031060: 6d61 6765 732f 7472 6565 2f66 6c61 672d mages/tree/flag- │ │ │ +00031070: 6a61 7061 6e2e 6769 6622 2064 6176 5f6f japan.gif" dav_o │ │ │ +00031080: 776e 6572 3d22 6461 7622 2064 6176 5f67 wner="dav" dav_g │ │ │ +00031090: 7270 3d22 6164 6d69 6e69 7374 7261 746f rp="administrato │ │ │ +000310a0: 7273 2220 6461 765f 7065 726d 3d22 3131 rs" dav_perm="11 │ │ │ +000310b0: 3031 3030 3130 304e 4e22 206d 616b 6570 0100100NN" makep │ │ │ +000310c0: 6174 683d 2279 6573 222f 3e0a 2020 3c66 ath="yes"/>. . . . . . . │ │ │ +000314e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +000316e0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . │ │ │ 00034860: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ 00034a90: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00034e30: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00035060: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00035400: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00035630: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000359d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00035c00: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00035fa0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000361d0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00036570: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000367a0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00036b40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00036d70: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00037110: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00037340: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000376e0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00037910: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00037cb0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00037ee0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +00034c00: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +00034fa0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000351d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000351e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000351f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00035200: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00035210: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00035220: 732f 666c 6167 732f 6e63 2d66 6c61 672e s/flags/nc-flag. │ │ │ +00035230: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00035240: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00035250: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00035260: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00035270: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00035280: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +00035340: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00035570: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000357a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000357b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000357c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000357d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +000357e0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +000357f0: 732f 666c 6167 732f 6e7a 2d6c 6766 6c61 s/flags/nz-lgfla │ │ │ +00035800: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00035810: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00035820: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00035830: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00035840: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00035850: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00035910: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00035b40: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00035d70: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00035d80: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00035d90: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00035da0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00035db0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00035dc0: 732f 666c 6167 732f 7370 2d6c 6766 6c61 s/flags/sp-lgfla │ │ │ +00035dd0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00035de0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00035df0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00035e00: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00035e10: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00035e20: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +00036110: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00036340: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00036350: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00036360: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00036370: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00036380: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00036390: 732f 666c 6167 732f 6972 2d6c 6766 6c61 s/flags/ir-lgfla │ │ │ +000363a0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +000363b0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +000363c0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +000363d0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +000363e0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +000363f0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +000366e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +00036a80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00036cb0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00037050: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . < │ │ │ +000374b0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000374c0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000374d0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000374e0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +000374f0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00037500: 732f 666c 6167 732f 6672 2d6c 6766 6c61 s/flags/fr-lgfla │ │ │ +00037510: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00037520: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00037530: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00037540: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00037550: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00037560: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +00037850: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +00037a80: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00037cb0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +00038050: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -00038280: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ -000384b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . │ │ │ +000384b0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ -00038850: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +000386e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . . │ │ │ 00038a80: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ -00038e20: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00039050: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000393f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00039620: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000399c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00039bf0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00039f90: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003a1c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003a560: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003a790: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003ab30: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003ad60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003b100: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003b330: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003b6d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003b900: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003bca0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003bed0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003c270: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003c4a0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003c840: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003ca70: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003ce10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003d040: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003d3e0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003d610: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003d9b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003dbe0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003df80: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003e1b0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003e550: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003e780: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003eb20: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003ed50: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003f0f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003f320: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003f6c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003f8f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0003fc90: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0003fec0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00040260: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00040490: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00040830: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00040a60: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00040e00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00041030: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000413d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00041600: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000419a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00041bd0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00041f70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000421a0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00042540: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00042770: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00042b10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00042d40: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000430e0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00043310: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000436b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000438e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00043c80: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00043eb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00044250: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00044480: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00044820: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00044a50: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00044df0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00045020: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000453c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000455f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00045990: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00045bc0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00045f60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00046190: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00046530: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00046760: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00046b00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00046d30: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000470d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00047300: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000476a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000478d0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00047c70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +00038e20: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +000391c0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +000393f0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +00039560: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00039790: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000397a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000397b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000397c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +000397d0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +000397e0: 732f 666c 6167 732f 6272 2d66 6c61 672e s/flags/br-flag. │ │ │ +000397f0: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00039800: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00039810: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00039820: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00039830: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00039840: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ +00039900: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +00039ca0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . │ │ │ +0003a040: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003a270: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0003a4a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003a4b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003a4c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003a4d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003a4e0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003a4f0: 732f 666c 6167 732f 6970 2d6c 6766 6c61 s/flags/ip-lgfla │ │ │ +0003a500: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003a510: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003a520: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003a530: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003a540: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003a550: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +0003a610: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003a840: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0003a9b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0003abe0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003abf0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003ac00: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003ac10: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003ac20: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003ac30: 732f 666c 6167 732f 6e65 2d66 6c61 672e s/flags/ne-flag. │ │ │ +0003ac40: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0003ac50: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0003ac60: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0003ac70: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0003ac80: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0003ac90: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ +0003ad50: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +0003af80: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . < │ │ │ +0003b320: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003b330: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003b340: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003b350: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003b360: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003b370: 732f 666c 6167 732f 6761 2d6c 6766 6c61 s/flags/ga-lgfla │ │ │ +0003b380: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003b390: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003b3a0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003b3b0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003b3c0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003b3d0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +0003b6c0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0003b8f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003b900: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003b910: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003b920: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003b930: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003b940: 732f 666c 6167 732f 676b 2d66 6c61 672e s/flags/gk-flag. │ │ │ +0003b950: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0003b960: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0003b970: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0003b980: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0003b990: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0003b9a0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +0003ba60: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003bc90: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . < │ │ │ +0003c030: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003c040: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003c050: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003c060: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003c070: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003c080: 732f 666c 6167 732f 6d68 2d6c 6766 6c61 s/flags/mh-lgfla │ │ │ +0003c090: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003c0a0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003c0b0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003c0c0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003c0d0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003c0e0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . │ │ │ +0003c260: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +0003c600: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +0003c9a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0003cbd0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003cbe0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003cbf0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003cc00: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003cc10: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003cc20: 732f 666c 6167 732f 636d 2d6c 6766 6c61 s/flags/cm-lgfla │ │ │ +0003cc30: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003cc40: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003cc50: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003cc60: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003cc70: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003cc80: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . │ │ │ +0003ce00: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +0003d1a0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003d3d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +0003d600: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +0003d830: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0003da60: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003da70: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003da80: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003da90: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003daa0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003dab0: 732f 666c 6167 732f 6d70 2d66 6c61 672e s/flags/mp-flag. │ │ │ +0003dac0: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0003dad0: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0003dae0: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0003daf0: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0003db00: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0003db10: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +0003dbd0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003de00: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0003df70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0003e1a0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003e1b0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003e1c0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003e1d0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003e1e0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003e1f0: 732f 666c 6167 732f 626b 2d6c 6766 6c61 s/flags/bk-lgfla │ │ │ +0003e200: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003e210: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003e220: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003e230: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003e240: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003e250: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . │ │ │ +0003e3d0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ +0003e770: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +0003eb10: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +0003ed40: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +0003eeb0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0003f0e0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ +0003f250: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0003f480: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0003f490: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0003f4a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0003f4b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0003f4c0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0003f4d0: 732f 666c 6167 732f 6165 2d6c 6766 6c61 s/flags/ae-lgfla │ │ │ +0003f4e0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0003f4f0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0003f500: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0003f510: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0003f520: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0003f530: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +0003f5f0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +0003fa50: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +0003fdf0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +00040020: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00040030: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00040040: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00040050: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00040060: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00040070: 732f 666c 6167 732f 6573 2d6c 6766 6c61 s/flags/es-lgfla │ │ │ +00040080: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00040090: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +000400a0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +000400b0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +000400c0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +000400d0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00040190: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . < │ │ │ +000405f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00040600: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00040610: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00040620: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00040630: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00040640: 732f 666c 6167 732f 6d71 2d6c 6766 6c61 s/flags/mq-lgfla │ │ │ +00040650: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00040660: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00040670: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00040680: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00040690: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +000406a0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . │ │ │ +00040820: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00040bc0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00040df0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00041190: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +000413c0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000415f0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00041600: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00041610: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00041620: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00041630: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00041640: 732f 666c 6167 732f 7478 2d6c 6766 6c61 s/flags/tx-lgfla │ │ │ +00041650: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00041660: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00041670: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00041680: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00041690: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +000416a0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +00041990: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +00041bc0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ +00041f60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . . │ │ │ +00042300: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00042530: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +000428d0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00042b00: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +00042d30: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00042f60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00043190: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000431a0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000431b0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +000431c0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +000431d0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +000431e0: 732f 666c 6167 732f 7475 2d6c 6766 6c61 s/flags/tu-lgfla │ │ │ +000431f0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00043200: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00043210: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00043220: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00043230: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00043240: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00043300: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00043530: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00043760: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00043770: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00043780: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00043790: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +000437a0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +000437b0: 732f 666c 6167 732f 6461 2d6c 6766 6c61 s/flags/da-lgfla │ │ │ +000437c0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +000437d0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +000437e0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +000437f0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00043800: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00043810: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +000438d0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00043b00: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00043ea0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +000440d0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +00044300: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00044310: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00044320: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00044330: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00044340: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00044350: 732f 666c 6167 732f 6e63 2d6c 6766 6c61 s/flags/nc-lgfla │ │ │ +00044360: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00044370: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00044380: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00044390: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +000443a0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +000443b0: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00044470: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +000446a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +000448d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000448e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000448f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00044900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00044910: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00044920: 732f 666c 6167 732f 6673 2d6c 6766 6c61 s/flags/fs-lgfla │ │ │ +00044930: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00044940: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00044950: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00044960: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00044970: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00044980: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00044a40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . . < │ │ │ +00044ea0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00044eb0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00044ec0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00044ed0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00044ee0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00044ef0: 732f 666c 6167 732f 616d 2d66 6c61 672e s/flags/am-flag. │ │ │ +00044f00: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00044f10: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00044f20: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00044f30: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00044f40: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00044f50: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +00045010: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00045240: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00045470: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +000456a0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . . │ │ │ +00045a40: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00045bb0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . < │ │ │ +00045ea0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00045eb0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00045ec0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00045ed0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00045ee0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00045ef0: 732f 666c 6167 732f 766d 2d6c 6766 6c61 s/flags/vm-lgfla │ │ │ +00045f00: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +00045f10: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +00045f20: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +00045f30: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +00045f40: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +00045f50: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. │ │ │ +00046010: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . < │ │ │ +00046300: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00046310: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00046320: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00046330: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00046340: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00046350: 732f 666c 6167 732f 6173 2d66 6c61 672e s/flags/as-flag. │ │ │ +00046360: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00046370: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00046380: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00046390: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +000463a0: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +000463b0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +00046470: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +000466a0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000468d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000468e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000468f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00046900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00046910: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00046920: 732f 666c 6167 732f 6861 2d66 6c61 672e s/flags/ha-flag. │ │ │ +00046930: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00046940: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00046950: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00046960: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00046970: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00046980: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +00046a40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00046c70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +00046ea0: 203c 6669 6c65 206f 7665 7277 7269 7465 . │ │ │ +00047010: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00047240: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00047470: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +000476a0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +000478d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000478e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000478f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00047900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00047910: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00047920: 732f 666c 6167 732f 6b72 2d66 6c61 672e s/flags/kr-flag. │ │ │ +00047930: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00047940: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00047950: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00047960: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00047970: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00047980: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ +00047a40: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . │ │ │ +00047c70: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ 00047ea0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . . │ │ │ +000480d0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -00048240: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . . < │ │ │ +00048300: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00048310: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00048320: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00048330: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00048340: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00048350: 732f 666c 6167 732f 626e 2d66 6c61 672e s/flags/bn-flag. │ │ │ +00048360: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00048370: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00048380: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00048390: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +000483a0: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +000483b0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ 00048470: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +000486a0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -00048810: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00048a40: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00048de0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00049010: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -000493b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -000495e0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00049980: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -00049bb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -00049f50: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0004a180: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0004a520: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0004a750: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0004aaf0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0004ad20: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0004b0c0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0004b2f0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . < │ │ │ +000488d0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +000488e0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +000488f0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00048900: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00048910: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00048920: 732f 666c 6167 732f 7567 2d66 6c61 672e s/flags/ug-flag. │ │ │ +00048930: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00048940: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00048950: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00048960: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00048970: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00048980: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +00048a40: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +00048c70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . │ │ │ +00048ea0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +000490d0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +00049300: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +000496a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +000498d0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +00049c70: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +00049ea0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +00049eb0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +00049ec0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +00049ed0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +00049ee0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +00049ef0: 732f 666c 6167 732f 6374 2d66 6c61 672e s/flags/ct-flag. │ │ │ +00049f00: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +00049f10: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +00049f20: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +00049f30: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +00049f40: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +00049f50: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +0004a010: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ +0004a240: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0004a470: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0004a480: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0004a490: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0004a4a0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0004a4b0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0004a4c0: 732f 666c 6167 732f 6a6e 2d6c 6766 6c61 s/flags/jn-lgfla │ │ │ +0004a4d0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0004a4e0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0004a4f0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0004a500: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0004a510: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0004a520: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +0004a810: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . < │ │ │ +0004aa40: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0004aa50: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0004aa60: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0004aa70: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0004aa80: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0004aa90: 732f 666c 6167 732f 6268 2d66 6c61 672e s/flags/bh-flag. │ │ │ +0004aaa0: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0004aab0: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0004aac0: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0004aad0: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0004aae0: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0004aaf0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ +0004abb0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ +0004af50: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0004b180: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0004b190: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0004b1a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0004b1b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0004b1c0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0004b1d0: 732f 666c 6167 732f 6770 2d66 6c61 672e s/flags/gp-flag. │ │ │ +0004b1e0: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0004b1f0: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0004b200: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0004b210: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0004b220: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0004b230: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. │ │ │ +0004b2f0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . . . │ │ │ -0004b690: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ -0004b8c0: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . . │ │ │ -0004bc60: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . │ │ │ +0004b520: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0004b750: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0004b760: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0004b770: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0004b780: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0004b790: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0004b7a0: 732f 666c 6167 732f 7769 2d6c 6766 6c61 s/flags/wi-lgfla │ │ │ +0004b7b0: 672e 6769 6622 2064 6176 5f6f 776e 6572 g.gif" dav_owner │ │ │ +0004b7c0: 3d22 6461 7622 2064 6176 5f67 7270 3d22 ="dav" dav_grp=" │ │ │ +0004b7d0: 6164 6d69 6e69 7374 7261 746f 7273 2220 administrators" │ │ │ +0004b7e0: 6461 765f 7065 726d 3d22 3131 3031 3030 dav_perm="110100 │ │ │ +0004b7f0: 3130 304e 4e22 206d 616b 6570 6174 683d 100NN" makepath= │ │ │ +0004b800: 2279 6573 222f 3e0a 2020 3c66 696c 6520 "yes"/>. . . . . │ │ │ +0004baf0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . < │ │ │ +0004bd20: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ +0004bd30: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ +0004bd40: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ +0004bd50: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ +0004bd60: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ +0004bd70: 732f 666c 6167 732f 6379 2d66 6c61 672e s/flags/cy-flag. │ │ │ +0004bd80: 6769 6622 2064 6176 5f6f 776e 6572 3d22 gif" dav_owner=" │ │ │ +0004bd90: 6461 7622 2064 6176 5f67 7270 3d22 6164 dav" dav_grp="ad │ │ │ +0004bda0: 6d69 6e69 7374 7261 746f 7273 2220 6461 ministrators" da │ │ │ +0004bdb0: 765f 7065 726d 3d22 3131 3031 3030 3130 v_perm="11010010 │ │ │ +0004bdc0: 304e 4e22 206d 616b 6570 6174 683d 2279 0NN" makepath="y │ │ │ +0004bdd0: 6573 222f 3e0a 2020 3c66 696c 6520 6f76 es"/>. . │ │ │ 0004be90: 203c 6669 6c65 206f 7665 7277 7269 7465 . . . . │ │ │ +0004c0c0: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ 0004c230: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . < │ │ │ -0004c3c0: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0004c3d0: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0004c3e0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0004c3f0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ -0004c400: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ -0004c410: 732f 6172 742f 5365 6c66 506f 7274 7261 s/art/SelfPortra │ │ │ -0004c420: 6974 3136 3430 2e6a 7067 2220 6461 765f it1640.jpg" dav_ │ │ │ -0004c430: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ -0004c440: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ -0004c450: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ -0004c460: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ -0004c470: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ -0004c480: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0004c490: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0004c4a0: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0004c4b0: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ -0004c4c0: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ -0004c4d0: 732f 6172 742f 5365 6c66 506f 7274 7261 s/art/SelfPortra │ │ │ -0004c4e0: 6974 3136 3238 2e6a 7067 2220 6461 765f it1628.jpg" dav_ │ │ │ -0004c4f0: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ -0004c500: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ -0004c510: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ -0004c520: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ -0004c530: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ -0004c540: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0004c550: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0004c560: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0004c570: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ -0004c580: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ -0004c590: 732f 6172 742f 4c61 4d61 7263 6865 4e6f s/art/LaMarcheNo │ │ │ -0004c5a0: 6374 7572 6e65 2e6a 7067 2220 6461 765f cturne.jpg" dav_ │ │ │ -0004c5b0: 6f77 6e65 723d 2264 6176 2220 6461 765f owner="dav" dav_ │ │ │ -0004c5c0: 6772 703d 2261 646d 696e 6973 7472 6174 grp="administrat │ │ │ -0004c5d0: 6f72 7322 2064 6176 5f70 6572 6d3d 2231 ors" dav_perm="1 │ │ │ -0004c5e0: 3130 3130 3031 3030 4e4e 2220 6d61 6b65 10100100NN" make │ │ │ -0004c5f0: 7061 7468 3d22 7965 7322 2f3e 0a20 203c path="yes"/>. < │ │ │ -0004c600: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -0004c610: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -0004c620: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -0004c630: 7267 6574 5f75 7269 3d22 6465 6d6f 2f73 rget_uri="demo/s │ │ │ -0004c640: 616d 706c 655f 6461 7461 2f69 6d61 6765 ample_data/image │ │ │ -0004c650: 732f 6172 742f 4a6f 6861 6e6e 6573 456c s/art/JohannesEl │ │ │ -0004c660: 6973 6f6e 2e6a 7067 2220 6461 765f 6f77 ison.jpg" dav_ow │ │ │ +0004c280: 6167 6573 2f61 7274 2f4c 614d 6172 6368 ages/art/LaMarch │ │ │ +0004c290: 654e 6f63 7475 726e 652e 6a70 6722 2064 eNocturne.jpg" d │ │ │ +0004c2a0: 6176 5f6f 776e 6572 3d22 6461 7622 2064 av_owner="dav" d │ │ │ +0004c2b0: 6176 5f67 7270 3d22 6164 6d69 6e69 7374 av_grp="administ │ │ │ +0004c2c0: 7261 746f 7273 2220 6461 765f 7065 726d rators" dav_perm │ │ │ +0004c2d0: 3d22 3131 3031 3030 3130 304e 4e22 206d ="110100100NN" m │ │ │ +0004c2e0: 616b 6570 6174 683d 2279 6573 222f 3e0a akepath="yes"/>. │ │ │ +0004c2f0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0004c3b0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . │ │ │ +0004c470: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . . │ │ │ -00050af0: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ -00050c60: 3c66 696c 6520 6f76 6572 7772 6974 653d . . │ │ │ -00050e80: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . . │ │ │ -000510a0: 2020 3c66 696c 6520 6f76 6572 7772 6974 . < │ │ │ -00051160: 6669 6c65 206f 7665 7277 7269 7465 3d22 file overwrite=" │ │ │ -00051170: 7965 7322 2074 7970 653d 2264 6176 2220 yes" type="dav" │ │ │ -00051180: 736f 7572 6365 3d22 6461 7461 2220 7461 source="data" ta │ │ │ -00051190: 7267 6574 5f75 7269 3d22 6465 6d6f 2f69 rget_uri="demo/i │ │ │ -000511a0: 6e74 6572 6f70 332f 7773 646c 2f72 342f nterop3/wsdl/r4/ │ │ │ -000511b0: 7369 6d70 6c65 2d64 6f63 2d6c 6974 6572 simple-doc-liter │ │ │ -000511c0: 616c 2d33 2e78 7364 2220 6461 765f 6f77 al-3.xsd" dav_ow │ │ │ -000511d0: 6e65 723d 2264 6176 2220 6461 765f 6772 ner="dav" dav_gr │ │ │ -000511e0: 703d 2261 646d 696e 6973 7472 6174 6f72 p="administrator │ │ │ -000511f0: 7322 2064 6176 5f70 6572 6d3d 2231 3130 s" dav_perm="110 │ │ │ -00051200: 3130 3031 3030 4e4e 2220 6d61 6b65 7061 100100NN" makepa │ │ │ -00051210: 7468 3d22 7965 7322 2f3e 0a20 203c 6669 th="yes"/>. . . . . . . . . . . . │ │ │ +00050f40: 3c66 696c 6520 6f76 6572 7772 6974 653d . . . │ │ │ +00051220: 0a20 203c 6669 6c65 206f 7665 7277 7269 . . . │ │ │ +00051390: 2020 3c66 696c 6520 6f76 6572 7772 6974 . . . .foo..ba │ │ │ -000544a0: 723c 2f74 6974 6c65 3e0a 0a3c 7061 7261 r...foo...< │ │ │ -000544c0: 696e 666f 726d 616c 7461 626c 653e 0a3c informaltable>.< │ │ │ -000544d0: 7467 726f 7570 2063 6f6c 733d 2231 223e tgroup cols="1"> │ │ │ -000544e0: 0a3c 7462 6f64 793e 0a3c 726f 773e 0a3c ...< │ │ │ -000544f0: 656e 7472 793e 666f 6f3c 2f65 6e74 7279 entry>foo.bar< │ │ │ -00054520: 2f72 6f77 3e0a 3c2f 7462 6f64 793e 0a3c /row>..< │ │ │ -00054530: 2f74 6772 6f75 703e 0a3c 2f69 6e66 6f72 /tgroup>...bar</ti │ │ │ -00054560: 746c 653e 0a3c 7467 726f 7570 2063 6f6c tle>.<tgroup col │ │ │ -00054570: 733d 2231 223e 0a3c 7462 6f64 793e 0a3c s="1">.<tbody>.< │ │ │ -00054580: 726f 773e 3c65 6e74 7279 3e62 6172 3c2f row><entry>bar</ │ │ │ -00054590: 656e 7472 793e 3c2f 726f 773e 0a3c 2f74 entry></row>.</t │ │ │ -000545a0: 626f 6479 3e0a 3c2f 7467 726f 7570 3e0a body>.</tgroup>. │ │ │ -000545b0: 3c2f 7461 626c 653e 0a0a 3c2f 6368 6170 </table>..</chap │ │ │ -000545c0: 7465 723e 0a0a 3c67 6c6f 7373 6172 793e ter>..<glossary> │ │ │ -000545d0: 0a3c 676c 6f73 7365 6e74 7279 3e3c 676c .<glossentry><gl │ │ │ -000545e0: 6f73 7374 6572 6d3e 666f 6f3c 2f67 6c6f ossterm>foo</glo │ │ │ -000545f0: 7373 7465 726d 3e0a 3c69 6e64 6578 7465 ssterm>.<indexte │ │ │ -00054600: 726d 3e3c 7072 696d 6172 793e 666f 6f3c rm><primary>foo< │ │ │ -00054610: 2f70 7269 6d61 7279 3e3c 2f69 6e64 6578 /primary></index │ │ │ -00054620: 7465 726d 3e0a 3c67 6c6f 7373 6465 663e term>.<glossdef> │ │ │ -00054630: 0a3c 7061 7261 3e0a 536f 6d65 2061 7070 .<para>.Some app │ │ │ -00054640: 726f 7072 6961 7465 2064 6566 696e 6974 ropriate definit │ │ │ -00054650: 696f 6e20 676f 6573 2068 6572 652e 0a3c ion goes here..< │ │ │ -00054660: 2f70 6172 613e 0a3c 2f67 6c6f 7373 6465 /para>.</glossde │ │ │ -00054670: 663e 0a3c 2f67 6c6f 7373 656e 7472 793e f>.</glossentry> │ │ │ -00054680: 0a3c 2f67 6c6f 7373 6172 793e 0a0a 3c2f .</glossary>..</ │ │ │ -00054690: 626f 6f6b 3e0a b600 0000 1f64 656d 6f2f book>......demo/ │ │ │ -000546a0: 646f 6373 7263 2f44 6f63 426f 6f6b 2f74 docsrc/DocBook/t │ │ │ -000546b0: 626c 7863 6867 2e78 6d6c df00 0005 463c blxchg.xml....F< │ │ │ -000546c0: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ -000546d0: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -000546e0: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -000546f0: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -00054700: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -00054710: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -00054720: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ -00054730: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -00054740: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -00054750: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ -00054760: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ -00054770: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ -00054780: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ -00054790: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ -000547a0: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ -000547b0: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -000547c0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -000547d0: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -000547e0: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ -000547f0: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ -00054800: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ -00054810: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ -00054820: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ -00054830: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ -00054840: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ -00054850: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ -00054860: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ -00054870: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ -00054880: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ -00054890: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ -000548a0: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ -000548b0: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ -000548c0: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ -000548d0: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -000548e0: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -000548f0: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -00054900: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ -00054910: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -00054920: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ -00054930: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ -00054940: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ -00054950: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -00054960: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -00054970: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -00054980: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ -00054990: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ -000549a0: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ -000549b0: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ -000549c0: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ -000549d0: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ -000549e0: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ -000549f0: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ -00054a00: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ -00054a10: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ -00054a20: 3c3f 786d 6c20 7665 7273 696f 6e3d 2731 <?xml version='1 │ │ │ -00054a30: 2e30 273f 3e0a 3c21 444f 4354 5950 4520 .0'?>.<!DOCTYPE │ │ │ -00054a40: 6172 7469 636c 6520 5359 5354 454d 2022 article SYSTEM " │ │ │ -00054a50: 6462 7462 6c78 6368 672e 6474 6422 3e0a dbtblxchg.dtd">. │ │ │ -00054a60: 3c61 7274 6963 6c65 3e3c 7469 746c 653e <article><title> │ │ │ -00054a70: 5461 626c 6520 5465 7374 3c2f 7469 746c Table Test</titl │ │ │ -00054a80: 653e 0a0a 3c21 2d2d 2054 6869 7320 7461 e>..<!-- This ta │ │ │ -00054a90: 626c 6520 6973 2076 616c 6964 2069 6e20 ble is valid in │ │ │ -00054aa0: 626f 7468 206d 6f64 656c 733b 2074 6869 both models; thi │ │ │ -00054ab0: 7320 6973 206a 7573 7420 746f 2065 7865 s is just to exe │ │ │ -00054ac0: 7263 6973 6520 7468 6520 4454 442e 202d rcise the DTD. - │ │ │ -00054ad0: 2d3e 0a0a 3c69 6e66 6f72 6d61 6c74 6162 ->..<informaltab │ │ │ -00054ae0: 6c65 2069 643d 2266 6f6f 2220 726f 6c65 le id="foo" role │ │ │ -00054af0: 3d22 7465 7374 223e 0a3c 7467 726f 7570 ="test">.<tgroup │ │ │ -00054b00: 2063 6f6c 733d 2231 223e 0a3c 7462 6f64 cols="1">.<tbod │ │ │ -00054b10: 793e 0a3c 726f 773e 0a3c 656e 7472 793e y>.<row>.<entry> │ │ │ -00054b20: 666f 6f3c 2f65 6e74 7279 3e3c 2f72 6f77 foo</entry></row │ │ │ -00054b30: 3e0a 3c72 6f77 3e3c 656e 7472 793e 6261 >.<row><entry>ba │ │ │ -00054b40: 723c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a r</entry></row>. │ │ │ -00054b50: 3c2f 7462 6f64 793e 0a3c 2f74 6772 6f75 </tbody>.</tgrou │ │ │ -00054b60: 703e 0a3c 2f69 6e66 6f72 6d61 6c74 6162 p>.</informaltab │ │ │ -00054b70: 6c65 3e0a 0a3c 7461 626c 6520 6964 3d22 le>..<table id=" │ │ │ -00054b80: 6261 7222 2072 6f6c 653d 2274 6573 7422 bar" role="test" │ │ │ -00054b90: 3e3c 7469 746c 653e 6261 723c 2f74 6974 ><title>bar</tit │ │ │ -00054ba0: 6c65 3e0a 3c74 6772 6f75 7020 636f 6c73 le>.<tgroup cols │ │ │ -00054bb0: 3d22 3122 3e0a 3c74 626f 6479 3e0a 3c72 ="1">.<tbody>.<r │ │ │ -00054bc0: 6f77 3e3c 656e 7472 793e 6261 723c 2f65 ow><entry>bar</e │ │ │ -00054bd0: 6e74 7279 3e3c 2f72 6f77 3e0a 3c2f 7462 ntry></row>.</tb │ │ │ -00054be0: 6f64 793e 0a3c 2f74 6772 6f75 703e 0a3c ody>.</tgroup>.< │ │ │ -00054bf0: 2f74 6162 6c65 3e0a 0a3c 2f61 7274 6963 /table>..</artic │ │ │ -00054c00: 6c65 3e0a 0ab6 0000 001f 6465 6d6f 2f64 le>.......demo/d │ │ │ -00054c10: 6f63 7372 632f 446f 6342 6f6f 6b2f 7462 ocsrc/DocBook/tb │ │ │ -00054c20: 6c63 616c 732e 786d 6cdf 0000 0546 3c21 lcals.xml....F<! │ │ │ -00054c30: 2d2d 0a20 2d20 200a 202d 2020 5468 6973 --. - . - This │ │ │ -00054c40: 2066 696c 6520 6973 2070 6172 7420 6f66 file is part of │ │ │ -00054c50: 2074 6865 204f 7065 6e4c 696e 6b20 536f the OpenLink So │ │ │ -00054c60: 6674 7761 7265 2056 6972 7475 6f73 6f20 ftware Virtuoso │ │ │ -00054c70: 4f70 656e 2d53 6f75 7263 6520 2856 4f53 Open-Source (VOS │ │ │ -00054c80: 290a 202d 2020 7072 6f6a 6563 742e 0a20 ). - project.. │ │ │ -00054c90: 2d20 200a 202d 2020 436f 7079 7269 6768 - . - Copyrigh │ │ │ -00054ca0: 7420 2843 2920 3139 3938 2d32 3032 3420 t (C) 1998-2024 │ │ │ -00054cb0: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ -00054cc0: 650a 202d 2020 0a20 2d20 2054 6869 7320 e. - . - This │ │ │ -00054cd0: 7072 6f6a 6563 7420 6973 2066 7265 6520 project is free │ │ │ -00054ce0: 736f 6674 7761 7265 3b20 796f 7520 6361 software; you ca │ │ │ -00054cf0: 6e20 7265 6469 7374 7269 6275 7465 2069 n redistribute i │ │ │ -00054d00: 7420 616e 642f 6f72 206d 6f64 6966 7920 t and/or modify │ │ │ -00054d10: 6974 0a20 2d20 2075 6e64 6572 2074 6865 it. - under the │ │ │ -00054d20: 2074 6572 6d73 206f 6620 7468 6520 474e terms of the GN │ │ │ -00054d30: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ -00054d40: 204c 6963 656e 7365 2061 7320 7075 626c License as publ │ │ │ -00054d50: 6973 6865 6420 6279 2074 6865 0a20 2d20 ished by the. - │ │ │ -00054d60: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ -00054d70: 6f75 6e64 6174 696f 6e3b 206f 6e6c 7920 oundation; only │ │ │ -00054d80: 7665 7273 696f 6e20 3220 6f66 2074 6865 version 2 of the │ │ │ -00054d90: 204c 6963 656e 7365 2c20 6461 7465 6420 License, dated │ │ │ -00054da0: 4a75 6e65 2031 3939 312e 0a20 2d20 200a June 1991.. - . │ │ │ -00054db0: 202d 2020 5468 6973 2070 726f 6772 616d - This program │ │ │ -00054dc0: 2069 7320 6469 7374 7269 6275 7465 6420 is distributed │ │ │ -00054dd0: 696e 2074 6865 2068 6f70 6520 7468 6174 in the hope that │ │ │ -00054de0: 2069 7420 7769 6c6c 2062 6520 7573 6566 it will be usef │ │ │ -00054df0: 756c 2c20 6275 740a 202d 2020 5749 5448 ul, but. - WITH │ │ │ -00054e00: 4f55 5420 414e 5920 5741 5252 414e 5459 OUT ANY WARRANTY │ │ │ -00054e10: 3b20 7769 7468 6f75 7420 6576 656e 2074 ; without even t │ │ │ -00054e20: 6865 2069 6d70 6c69 6564 2077 6172 7261 he implied warra │ │ │ -00054e30: 6e74 7920 6f66 0a20 2d20 204d 4552 4348 nty of. - MERCH │ │ │ -00054e40: 414e 5441 4249 4c49 5459 206f 7220 4649 ANTABILITY or FI │ │ │ -00054e50: 544e 4553 5320 464f 5220 4120 5041 5254 TNESS FOR A PART │ │ │ -00054e60: 4943 554c 4152 2050 5552 504f 5345 2e20 ICULAR PURPOSE. │ │ │ -00054e70: 5365 6520 7468 6520 474e 550a 202d 2020 See the GNU. - │ │ │ -00054e80: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ -00054e90: 6963 656e 7365 2066 6f72 206d 6f72 6520 icense for more │ │ │ -00054ea0: 6465 7461 696c 732e 0a20 2d20 200a 202d details.. - . - │ │ │ -00054eb0: 2020 596f 7520 7368 6f75 6c64 2068 6176 You should hav │ │ │ -00054ec0: 6520 7265 6365 6976 6564 2061 2063 6f70 e received a cop │ │ │ -00054ed0: 7920 6f66 2074 6865 2047 4e55 2047 656e y of the GNU Gen │ │ │ -00054ee0: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ -00054ef0: 6e73 6520 616c 6f6e 670a 202d 2020 7769 nse along. - wi │ │ │ -00054f00: 7468 2074 6869 7320 7072 6f67 7261 6d3b th this program; │ │ │ -00054f10: 2069 6620 6e6f 742c 2077 7269 7465 2074 if not, write t │ │ │ -00054f20: 6f20 7468 6520 4672 6565 2053 6f66 7477 o the Free Softw │ │ │ -00054f30: 6172 6520 466f 756e 6461 7469 6f6e 2c20 are Foundation, │ │ │ -00054f40: 496e 632e 2c0a 202d 2020 3531 2046 7261 Inc.,. - 51 Fra │ │ │ -00054f50: 6e6b 6c69 6e20 5374 2c20 4669 6674 6820 nklin St, Fifth │ │ │ -00054f60: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d Floor, Boston, M │ │ │ -00054f70: 4120 3032 3131 302d 3133 3031 2055 5341 A 02110-1301 USA │ │ │ -00054f80: 0a20 2d20 200a 202d 2020 0a2d 2d3e 0a3c . - . - .-->.< │ │ │ -00054f90: 3f78 6d6c 2076 6572 7369 6f6e 3d27 312e ?xml version='1. │ │ │ -00054fa0: 3027 3f3e 0a3c 2144 4f43 5459 5045 2061 0'?>.<!DOCTYPE a │ │ │ -00054fb0: 7274 6963 6c65 2053 5953 5445 4d20 2264 rticle SYSTEM "d │ │ │ -00054fc0: 6274 626c 6361 6c73 2e64 7464 223e 0a3c btblcals.dtd">.< │ │ │ -00054fd0: 6172 7469 636c 653e 3c74 6974 6c65 3e54 article><title>T │ │ │ -00054fe0: 6162 6c65 2054 6573 743c 2f74 6974 6c65 able Test... │ │ │ -00055480: 0a3c 212d 2d20 5468 6520 6d6f 7469 7661 ......... │ │ │ -00056c00: 3c21 454e 5449 5459 2025 2079 6573 6f72 ... │ │ │ -00056ca0: 3c21 2d2d 2064 6566 6175 6c74 2066 6f72 ....< │ │ │ -00057450: 2145 4c45 4d45 4e54 2025 7462 6c2e 7461 !ELEMENT %tbl.ta │ │ │ -00057460: 626c 652e 6e61 6d65 3b20 2825 7462 6c2e ble.name; (%tbl. │ │ │ -00057470: 7461 626c 652e 6d64 6c3b 293e 0a0a 3c21 table.mdl;)>... │ │ │ -000575a0: 0a3c 212d 2d0a 2020 2020 2044 6566 6175 ............... │ │ │ -00057ba0: 0a0a 3c21 4154 544c 4953 5420 7468 6561 .... │ │ │ -00057ca0: 0a0a 3c21 454c 454d 454e 5420 7462 6f64 ......< │ │ │ -00057d30: 212d 2d0a 2020 2020 2044 6566 6175 6c74 !--. Default │ │ │ -00057d40: 2064 6563 6c61 7261 7469 6f6e 7320 7072 declarations pr │ │ │ -00057d50: 6576 696f 7573 6c79 2064 6566 696e 6564 eviously defined │ │ │ -00057d60: 2069 6e20 7468 6973 2065 6e74 6974 7920 in this entity │ │ │ -00057d70: 616e 640a 2020 2020 2072 6566 6572 656e and. referen │ │ │ -00057d80: 6365 6420 6265 6c6f 7720 696e 636c 7564 ced below includ │ │ │ -00057d90: 653a 0a20 2020 2020 454e 5449 5459 2025 e:. ENTITY % │ │ │ -00057da0: 2074 626c 2e72 6f77 2e6d 646c 2020 2020 tbl.row.mdl │ │ │ -00057db0: 2020 2022 656e 7472 792b 220a 2020 2020 "entry+". │ │ │ -00057dc0: 2045 4e54 4954 5920 2520 7462 6c2e 726f ENTITY % tbl.ro │ │ │ -00057dd0: 772e 6174 7420 2020 2020 2020 2222 0a2d w.att "".- │ │ │ -00057de0: 2d3e 0a0a 3c21 454c 454d 454e 5420 726f ->.................de │ │ │ -000582d0: 6d6f 2f64 6f63 7372 632f 446f 6342 6f6f mo/docsrc/DocBoo │ │ │ -000582e0: 6b2f 7265 6164 6d65 2e74 7874 df00 0001 k/readme.txt.... │ │ │ -000582f0: 6652 4541 444d 4520 666f 7220 446f 6342 fREADME for DocB │ │ │ -00058300: 6f6f 6b20 584d 4c20 5634 2e30 0a0a 5468 ook XML V4.0..Th │ │ │ -00058310: 6973 2069 7320 446f 6342 6f6f 6b20 584d is is DocBook XM │ │ │ -00058320: 4c20 5634 2e30 2c20 7265 6c65 6173 6564 L V4.0, released │ │ │ -00058330: 2031 3820 4d61 7920 3230 3030 2e0a 0a53 18 May 2000...S │ │ │ -00058340: 6565 2034 3063 6867 2e74 7874 2066 6f72 ee 40chg.txt for │ │ │ -00058350: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ -00058360: 7574 2077 6861 7420 6861 7320 6368 616e ut what has chan │ │ │ -00058370: 6765 6420 7369 6e63 6520 446f 6342 6f6f ged since DocBoo │ │ │ -00058380: 6b20 332e 312e 0a0a 466f 7220 6d6f 7265 k 3.1...For more │ │ │ -00058390: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ -000583a0: 7574 2044 6f63 426f 6f6b 2c20 706c 6561 ut DocBook, plea │ │ │ -000583b0: 7365 2073 6565 0a0a 2020 6874 7470 3a2f se see.. http:/ │ │ │ -000583c0: 2f77 7777 2e6f 6173 6973 2d6f 7065 6e2e /www.oasis-open. │ │ │ -000583d0: 6f72 672f 646f 6362 6f6f 6b2f 0a0a 506c org/docbook/..Pl │ │ │ -000583e0: 6561 7365 2073 656e 6420 616c 6c20 7175 ease send all qu │ │ │ -000583f0: 6573 7469 6f6e 732c 2063 6f6d 6d65 6e74 estions, comment │ │ │ -00058400: 732c 2063 6f6e 6365 726e 732c 2061 6e64 s, concerns, and │ │ │ -00058410: 2062 7567 2072 6570 6f72 7473 2074 6f20 bug reports to │ │ │ -00058420: 7468 650a 446f 6342 6f6f 6b20 6d61 696c the.DocBook mail │ │ │ -00058430: 696e 6720 6c69 7374 3a20 646f 6362 6f6f ing list: docboo │ │ │ -00058440: 6b40 6c69 7374 732e 6f61 7369 732d 6f70 k@lists.oasis-op │ │ │ -00058450: 656e 2e6f 7267 0ab6 0000 0020 6465 6d6f en.org..... demo │ │ │ -00058460: 2f64 6f63 7372 632f 446f 6342 6f6f 6b2f /docsrc/DocBook/ │ │ │ -00058470: 646f 6362 6f6f 6b78 2e64 7464 df00 0011 docbookx.dtd.... │ │ │ -00058480: e73c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -000584d0: 0a3c 212d 2d20 446f 6342 6f6f 6b20 584d . │ │ │ -00058520: 0a3c 212d 2d20 4669 6c65 2064 6f63 626f . │ │ │ -00058570: 0a0a 3c21 2d2d 2043 6f70 7972 6967 6874 ........ │ │ │ -00058e50: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -00058ea0: 3c21 2d2d 204e 6f74 6174 696f 6e20 6465 . │ │ │ -00058ef0: 0a3c 2145 4e54 4954 5920 2520 6462 6e6f ...%dbnotn;.] │ │ │ -00058f90: 5d3e 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e ]>........%dbce │ │ │ -00059110: 6e74 3b0a 5d5d 3e0a 0a3c 212d 2d20 2e2e nt;.]]>..........%rd │ │ │ -00059360: 626d 6f64 733b 0a3c 212d 2d65 6e64 206f bmods;.]]>.. │ │ │ -00059390: 3c21 2d2d 2044 6f63 756d 656e 7420 6869 ....%dbhie │ │ │ -00059460: 723b 0a5d 5d3e 0a0a 3c21 2d2d 202e 2e2e r;.]]>......< │ │ │ -00059530: 215b 2025 6462 6765 6e65 6e74 2e6d 6f64 ![ %dbgenent.mod │ │ │ -00059540: 756c 653b 205b 0a3c 2145 4e54 4954 5920 ule; [..%dbgenen │ │ │ -000595c0: 743b 0a5d 5d3e 0a0a 3c21 2d2d 2045 6e64 t;.]]>........!dem │ │ │ -00059670: 6f2f 646f 6373 7263 2f44 6f63 426f 6f6b o/docsrc/DocBook │ │ │ -00059680: 2f64 6274 626c 7863 6867 2e64 7464 df00 /dbtblxchg.dtd.. │ │ │ -00059690: 0000 5d3c 2145 4e54 4954 5920 2520 6361 ..]...%docbook;.. │ │ │ -000596f0: b600 0000 2164 656d 6f2f 646f 6373 7263 ....!demo/docsrc │ │ │ -00059700: 2f44 6f63 426f 6f6b 2f64 6274 626c 6361 /DocBook/dbtblca │ │ │ -00059710: 6c73 2e64 7464 df00 0000 5e3c 2145 4e54 ls.dtd....^...%d │ │ │ -00059770: 6f63 626f 6f6b 3b0a 0ab6 0000 001f 6465 ocbook;.......de │ │ │ -00059780: 6d6f 2f64 6f63 7372 632f 446f 6342 6f6f mo/docsrc/DocBoo │ │ │ -00059790: 6b2f 6462 706f 6f6c 782e 6d6f 64df 0003 k/dbpoolx.mod... │ │ │ -000597a0: 21a8 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e !...............< │ │ │ -0005a3a0: 2145 4e54 4954 5920 2520 6462 706f 6f6c !ENTITY % dbpool │ │ │ -0005a3b0: 2e72 6564 6563 6c2e 6d6f 6475 6c65 2022 .redecl.module " │ │ │ -0005a3c0: 4947 4e4f 5245 223e 0a0a 3c21 2d2d 202e IGNORE">.............. │ │ │ -0005a600: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ....... │ │ │ -0005a750: 0a3c 2145 4e54 4954 5920 2520 6d65 7468 ........................ │ │ │ -0005aed0: 0a3c 2145 4e54 4954 5920 2520 6c69 6e6b .... │ │ │ -0005afb0: 0a3c 2145 4e54 4954 5920 2520 6562 6e66 . │ │ │ -0005afd0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 ......... │ │ │ -0005b320: 3c21 454e 5449 5459 2025 2064 6f63 696e ..< │ │ │ -0005b3c0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -0005b3d0: 6f74 6865 722e 6368 6172 2e63 6c61 7373 other.char.class │ │ │ -0005b3e0: 2022 223e 0a3c 2145 4e54 4954 5920 2520 "">..........< │ │ │ -0005b5d0: 215b 2564 6270 6f6f 6c2e 7265 6465 636c ![%dbpool.redecl │ │ │ -0005b5e0: 2e6d 6f64 756c 653b 5b0a 3c21 2d2d 2044 .module;[...%rdbpool;. │ │ │ -0005b670: 5d5d 3e0a 0a3c 212d 2d20 4f62 6a65 6374 ]]>...............< │ │ │ -0005bda0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -0005bdb0: 7265 7664 6573 6372 6970 7469 6f6e 2e6d revdescription.m │ │ │ -0005bdc0: 6978 2022 223e 0a3c 2145 4e54 4954 5920 ix "">. │ │ │ -0005beb0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 ..... │ │ │ -0005bf60: 3c21 454e 5449 5459 2025 206c 6f63 616c │ │ │ -0005bf80: 0a3c 2145 4e54 4954 5920 2520 6578 616d ... │ │ │ -0005c030: 3c21 454e 5449 5459 2025 206c 6f63 616c ... │ │ │ -0005c130: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ..< │ │ │ -0005c150: 2145 4e54 4954 5920 2520 7061 7261 2e6d !ENTITY % para.m │ │ │ -0005c160: 6978 0a09 0922 256c 6973 742e 636c 6173 ix..."%list.clas │ │ │ -0005c170: 733b 2020 2020 2020 2020 2020 207c 2561 s; |%a │ │ │ -0005c180: 646d 6f6e 2e63 6c61 7373 3b0a 0909 7c25 dmon.class;...|% │ │ │ -0005c190: 6c69 6e65 7370 6563 6966 6963 2e63 6c61 linespecific.cla │ │ │ -0005c1a0: 7373 3b0a 0909 0909 097c 2569 6e66 6f72 ss;......|%infor │ │ │ -0005c1b0: 6d61 6c2e 636c 6173 733b 0a09 097c 2566 mal.class;...|%f │ │ │ -0005c1c0: 6f72 6d61 6c2e 636c 6173 733b 0a09 0925 ormal.class;...% │ │ │ -0005c1d0: 6c6f 6361 6c2e 7061 7261 2e6d 6978 3b22 local.para.mix;" │ │ │ -0005c1e0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6c6f >.....< │ │ │ -0005c2f0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -0005c300: 6669 6775 7265 2e6d 6978 2022 223e 0a3c figure.mix "">.< │ │ │ -0005c310: 2145 4e54 4954 5920 2520 6669 6775 7265 !ENTITY % figure │ │ │ -0005c320: 2e6d 6978 0a09 0922 256c 696e 6573 7065 .mix..."%linespe │ │ │ -0005c330: 6369 6669 632e 636c 6173 733b 097c 2573 cific.class;.|%s │ │ │ -0005c340: 796e 6f70 2e63 6c61 7373 3b0a 0909 0909 ynop.class;..... │ │ │ -0005c350: 097c 2569 6e66 6f72 6d61 6c2e 636c 6173 .|%informal.clas │ │ │ -0005c360: 733b 0a09 097c 256e 6478 7465 726d 2e63 s;...|%ndxterm.c │ │ │ -0005c370: 6c61 7373 3b20 2020 2020 2020 207c 6265 lass; |be │ │ │ -0005c380: 6769 6e70 6167 650a 0909 256c 6f63 616c ginpage...%local │ │ │ -0005c390: 2e66 6967 7572 652e 6d69 783b 223e 0a0a .figure.mix;">.. │ │ │ -0005c3a0: 3c21 454e 5449 5459 2025 206c 6f63 616c . │ │ │ -0005c450: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 .... │ │ │ -0005c540: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ............. │ │ │ -0005ca80: 0a3c 212d 2d20 5468 6520 446f 6342 6f6f ......... │ │ │ -0005ccc0: 3c21 454e 5449 5459 2025 2074 6974 6c65 .......... │ │ │ -0005d0a0: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ..... │ │ │ -0005d1d0: 3c21 454e 5449 5459 2025 2064 6f63 696e ................ │ │ │ -0005d550: 0a3c 2145 4e54 4954 5920 2520 6172 6368 ..................... │ │ │ -0005d770: 3c21 2d2d 2053 6563 7572 6974 793a 2053 ... │ │ │ -0005d7e0: 0a3c 212d 2d20 5573 6572 4c65 7665 6c3a .... │ │ │ -0005d870: 0a0a 3c21 2d2d 2056 656e 646f 723a 2043 ......< │ │ │ -0005d8f0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -0005d900: 6566 6665 6374 6976 6974 792e 6174 7472 effectivity.attr │ │ │ -0005d910: 6962 2022 223e 0a3c 2145 4e54 4954 5920 ib "">..................... │ │ │ -0005dbe0: 3c21 2d2d 2052 656d 6170 3a20 5072 6576 ..... │ │ │ -0005dca0: 0a0a 3c21 454e 5449 5459 2025 2072 6f6c ........ │ │ │ -0005ddb0: 0a0a 3c21 2d2d 2052 6576 6973 696f 6e46 ..... │ │ │ -0005de70: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ............< │ │ │ -0005e050: 212d 2d20 5365 6d69 2d63 6f6d 6d6f 6e20 !-- Semi-common │ │ │ -0005e060: 6174 7472 6962 7574 6573 2061 6e64 206f attributes and o │ │ │ -0005e070: 7468 6572 2061 7474 7269 6275 7465 2065 ther attribute e │ │ │ -0005e080: 6e74 6974 6965 7320 2e2e 2e2e 2e2e 2e2e ntities ........ │ │ │ -0005e090: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a0a .......... -->.. │ │ │ -0005e0a0: 3c21 454e 5449 5459 2025 206c 6f63 616c ........................ │ │ │ -0005e710: 0a3c 212d 2d20 466f 726d 6174 3a20 7768 . │ │ │ -0005e760: 0a0a 3c21 454e 5449 5459 2025 206c 696e ..... │ │ │ -0005e7f0: 3c21 2d2d 204c 696e 6b65 6e64 3a20 6c69 .. │ │ │ -0005e860: 0a0a 0a3c 212d 2d20 4c69 6e6b 656e 643a ........................< │ │ │ -0005eaa0: 2145 4e54 4954 5920 2520 7061 6765 6e75 !ENTITY % pagenu │ │ │ -0005eab0: 6d2e 6174 7472 6962 0a09 2270 6167 656e m.attrib.."pagen │ │ │ -0005eac0: 756d 0943 4441 5441 0909 2349 4d50 4c49 um.CDATA..#IMPLI │ │ │ -0005ead0: 4544 223e 0a0a 3c21 454e 5449 5459 2025 ED">.................. │ │ │ -0005ed90: 0a0a 3c21 454e 5449 5459 2025 2074 6974 ....< │ │ │ -0005edf0: 212d 2d65 6e64 206f 6620 7469 746c 652e !--end of title. │ │ │ -0005ee00: 656c 656d 656e 742d 2d3e 5d5d 3e0a 0a3c element-->]]>..< │ │ │ -0005ee10: 2145 4e54 4954 5920 2520 7469 746c 652e !ENTITY % title. │ │ │ -0005ee20: 6174 746c 6973 7420 2249 4e43 4c55 4445 attlist "INCLUDE │ │ │ -0005ee30: 223e 0a3c 215b 2574 6974 6c65 2e61 7474 ">..]]>.]]>........]]>....]]>.]]>....< │ │ │ -0005f170: 2145 4e54 4954 5920 2520 7375 6274 6974 !ENTITY % subtit │ │ │ -0005f180: 6c65 2e72 6f6c 652e 6174 7472 6962 2022 le.role.attrib " │ │ │ -0005f190: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ -0005f1a0: 0a3c 2145 4e54 4954 5920 2520 7375 6274 ...]]>.. │ │ │ -0005f250: 0a3c 215b 2573 7562 7469 746c 652e 6174 .. │ │ │ -0005f2e0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2073 ]]>...... │ │ │ -0005f480: 3c21 454e 5449 5459 2025 206c 6f63 616c .........< │ │ │ -0005f8e0: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ -0005f8f0: 656e 7472 792e 726f 6c65 2e61 7474 7269 entry.role.attri │ │ │ -0005f900: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ -0005f910: 223e 0a0a 3c21 454e 5449 5459 2025 2062 ">....]]>.. │ │ │ -0005f9c0: 3c21 454e 5449 5459 2025 2062 6962 6c69 ..]]>.]]>. │ │ │ -0005fab0: 0a3c 2145 4e54 4954 5920 2520 6269 626c ..... │ │ │ -0005fb50: 3c21 454e 5449 5459 2025 2062 6962 6c69 ..]]>. │ │ │ -0005fc00: 0a3c 2145 4e54 4954 5920 2520 6269 626c ...]]>.]]> │ │ │ -0005fcf0: 0a0a 3c21 454e 5449 5459 2025 2061 7274 ..... │ │ │ -0005fd90: 0a3c 2145 4e54 4954 5920 2520 6172 7469 ...< │ │ │ -0005fe60: 212d 2d65 6e64 206f 6620 6172 7469 636c !--end of articl │ │ │ -0005fe70: 6569 6e66 6f2e 656c 656d 656e 742d 2d3e einfo.element--> │ │ │ -0005fe80: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...< │ │ │ -0005feb0: 215b 2561 7274 6963 6c65 696e 666f 2e61 ![%articleinfo.a │ │ │ -0005fec0: 7474 6c69 7374 3b5b 0a3c 2141 5454 4c49 ttlist;[..]]> │ │ │ -0005ff50: 0a3c 212d 2d65 6e64 206f 6620 6172 7469 .]]>. │ │ │ -000600a0: 0a3c 212d 2d20 5265 6c61 7469 6f6e 3a20 ......]]>... │ │ │ -00060210: 3c21 5b25 6269 626c 696f 6d73 6574 2e6d .....]]>.. │ │ │ -00060330: 3c21 2d2d 2052 656c 6174 696f 6e3a 2052 .....]]>.]]>..< │ │ │ -00060480: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ -00060490: 6d69 7363 2e6d 6f64 756c 6520 2249 4e43 misc.module "INC │ │ │ -000604a0: 4c55 4445 223e 0a3c 215b 2562 6962 6c69 LUDE">......]]>....]]>. │ │ │ -00060670: 3c21 2d2d 656e 6420 6f66 2062 6962 6c69 ] │ │ │ -00060690: 5d3e 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e ]>.......... │ │ │ -00060820: 3c21 454e 5449 5459 2025 2073 7562 6a65 ..]]>.......]]>.]]>.. │ │ │ -000609f0: 3c21 454e 5449 5459 2025 2073 7562 6a65 ....< │ │ │ -00060a80: 2145 4e54 4954 5920 2520 7375 626a 6563 !ENTITY % subjec │ │ │ -00060a90: 742e 656c 656d 656e 7420 2249 4e43 4c55 t.element "INCLU │ │ │ -00060aa0: 4445 223e 0a3c 215b 2573 7562 6a65 6374 DE">..]]>..< │ │ │ -00060b00: 212d 2d20 5765 6967 6874 3a20 5261 6e6b !-- Weight: Rank │ │ │ -00060b10: 696e 6720 6f66 2074 6869 7320 6772 6f75 ing of this grou │ │ │ -00060b20: 7020 6f66 2053 7562 6a65 6374 5465 726d p of SubjectTerm │ │ │ -00060b30: 7320 7265 6c61 7469 7665 200a 0909 746f s relative ...to │ │ │ -00060b40: 206f 7468 6572 732c 2030 2069 7320 6c6f others, 0 is lo │ │ │ -00060b50: 772c 206e 6f20 6869 6768 6573 7420 7661 w, no highest va │ │ │ -00060b60: 6c75 6520 7370 6563 6966 6965 6420 2d2d lue specified -- │ │ │ -00060b70: 3e0a 0a0a 3c21 454e 5449 5459 2025 2073 >.... │ │ │ -00060c20: 0a3c 212d 2d65 6e64 206f 6620 7375 626a .]] │ │ │ -00060c40: 3e0a 3c21 2d2d 656e 6420 6f66 2073 7562 >.]] │ │ │ -00060c60: 3e0a 0a3c 2145 4e54 4954 5920 2520 7375 >.... │ │ │ -00060d00: 0a0a 3c21 454e 5449 5459 2025 2073 7562 ....]]>....]]>.]]>.]]>... │ │ │ -00060f20: 0a3c 215b 256b 6579 776f 7264 7365 742e .. │ │ │ -00060f60: 3c21 454e 5449 5459 2025 206b 6579 776f ....]]>....]] │ │ │ -000610e0: 3e0a 3c21 2d2d 656e 6420 6f66 206b 6579 >.]]>.. │ │ │ -00061210: 3c21 454e 5449 5459 2025 206b 6579 776f .. │ │ │ -000612c0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206b ]]>. │ │ │ -000612e0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206b ]]>.]]>.. │ │ │ -00061310: 3c21 454e 5449 5459 2025 2069 7465 726d . │ │ │ -00061370: 0a3c 2145 4e54 4954 5920 2520 6974 6572 ..... │ │ │ -00061420: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.< │ │ │ -000614e0: 212d 2d65 6e64 206f 6620 6974 6572 6d73 !--end of iterms │ │ │ -000614f0: 6574 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a et.module-->]]>. │ │ │ -00061500: 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -00061550: 0a3c 212d 2d20 436f 6d70 6f75 6e64 2028 . │ │ │ -000615a0: 0a0a 3c21 2d2d 204d 6573 7361 6765 2073 ....< │ │ │ -000615d0: 2145 4e54 4954 5920 2520 6d73 6773 6574 !ENTITY % msgset │ │ │ -000615e0: 2e63 6f6e 7465 6e74 2e6d 6f64 756c 6520 .content.module │ │ │ -000615f0: 2249 4e43 4c55 4445 223e 0a3c 215b 256d "INCLUDE">... │ │ │ -000616a0: 0a0a 3c21 454e 5449 5459 2025 206d 7367 ....]]>....]]>.]]>......< │ │ │ -000618b0: 2145 4e54 4954 5920 2520 6d73 6765 6e74 !ENTITY % msgent │ │ │ -000618c0: 7279 2e65 6c65 6d65 6e74 2022 494e 434c ry.element "INCL │ │ │ -000618d0: 5544 4522 3e0a 3c21 5b25 6d73 6765 6e74 UDE">..]]>. │ │ │ -00061940: 0a3c 2145 4e54 4954 5920 2520 6d73 6765 ...]]>.]]>........]]>... │ │ │ -00061c70: 0a3c 212d 2d65 6e64 206f 6620 7369 6d70 .]]>.]]>. │ │ │ -00061cc0: 0a3c 2145 4e54 4954 5920 2520 6d73 672e ..... │ │ │ -00061d40: 3c21 454e 5449 5459 2025 206d 7367 2e65 ..] │ │ │ -00061e60: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6d73 ]>.]]>.. │ │ │ -00061e80: 3c21 454e 5449 5459 2025 206d 7367 6d61 ....< │ │ │ -00061f10: 2145 4e54 4954 5920 2520 6d73 676d 6169 !ENTITY % msgmai │ │ │ -00061f20: 6e2e 656c 656d 656e 7420 2249 4e43 4c55 n.element "INCLU │ │ │ -00061f30: 4445 223e 0a3c 215b 256d 7367 6d61 696e DE">.. │ │ │ -00061f70: 3c21 2d2d 656e 6420 6f66 206d 7367 6d61 ]]> │ │ │ -00061f90: 0a0a 3c21 454e 5449 5459 2025 206d 7367 ....]]>. │ │ │ -00062170: 0a3c 2145 4e54 4954 5920 2520 6d73 6773 ...< │ │ │ -00062200: 212d 2d65 6e64 206f 6620 6d73 6773 7562 !--end of msgsub │ │ │ -00062210: 2e61 7474 6c69 7374 2d2d 3e5d 5d3e 0a3c .attlist-->]]>.< │ │ │ -00062220: 212d 2d65 6e64 206f 6620 6d73 6773 7562 !--end of msgsub │ │ │ -00062230: 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c .module-->]]>..< │ │ │ -00062240: 2145 4e54 4954 5920 2520 6d73 6772 656c !ENTITY % msgrel │ │ │ -00062250: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ -00062260: 223e 0a3c 215b 256d 7367 7265 6c2e 6d6f ">.....< │ │ │ -000622f0: 215b 256d 7367 7265 6c2e 656c 656d 656e ![%msgrel.elemen │ │ │ -00062300: 743b 5b0a 3c21 454c 454d 454e 5420 6d73 t;[..]]>....]]>... │ │ │ -00062450: 3c21 454e 5449 5459 2025 206d 7367 696e ....< │ │ │ -000624e0: 2145 4e54 4954 5920 2520 6d73 6769 6e66 !ENTITY % msginf │ │ │ -000624f0: 6f2e 656c 656d 656e 7420 2249 4e43 4c55 o.element "INCLU │ │ │ -00062500: 4445 223e 0a3c 215b 256d 7367 696e 666f DE">..< │ │ │ -00062550: 212d 2d65 6e64 206f 6620 6d73 6769 6e66 !--end of msginf │ │ │ -00062560: 6f2e 656c 656d 656e 742d 2d3e 5d5d 3e0a o.element-->]]>. │ │ │ -00062570: 0a3c 2145 4e54 4954 5920 2520 6d73 6769 ...]]>. │ │ │ -00062820: 3c21 2d2d 656e 6420 6f66 206d 7367 6c65 ]]> │ │ │ -00062840: 0a0a 3c21 454e 5449 5459 2025 206d 7367 .... │ │ │ -000628a0: 3c21 454e 5449 5459 2025 206d 7367 6f72 . │ │ │ -000628d0: 0a3c 2145 4e54 4954 5920 2520 6d73 676f ...]]>... │ │ │ -00062980: 3c21 5b25 6d73 676f 7269 672e 6174 746c .]]>.]]>..< │ │ │ -00062a30: 2145 4e54 4954 5920 2520 6d73 6761 7564 !ENTITY % msgaud │ │ │ -00062a40: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ -00062a50: 223e 0a3c 215b 256d 7367 6175 642e 6d6f ">.....< │ │ │ -00062ae0: 215b 256d 7367 6175 642e 656c 656d 656e ![%msgaud.elemen │ │ │ -00062af0: 743b 5b0a 3c21 454c 454d 454e 5420 6d73 t;[..]]>...< │ │ │ -00062b60: 215b 256d 7367 6175 642e 6174 746c 6973 ![%msgaud.attlis │ │ │ -00062b70: 743b 5b0a 3c21 4154 544c 4953 5420 6d73 t;[..]]>.]]>...< │ │ │ -00062c30: 215b 256d 7367 6578 706c 616e 2e6d 6f64 ![%msgexplan.mod │ │ │ -00062c40: 756c 653b 5b0a 3c21 454e 5449 5459 2025 ule;[....< │ │ │ -00062ca0: 2145 4e54 4954 5920 2520 6d73 6765 7870 !ENTITY % msgexp │ │ │ -00062cb0: 6c61 6e2e 656c 656d 656e 7420 2249 4e43 lan.element "INC │ │ │ -00062cc0: 4c55 4445 223e 0a3c 215b 256d 7367 6578 LUDE">. │ │ │ -00062d10: 0a3c 212d 2d65 6e64 206f 6620 6d73 6765 . │ │ │ -00062d30: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>..< │ │ │ -00062e40: 212d 2d20 5161 6e64 4153 6574 202e 2e2e !-- QandASet ... │ │ │ -00062e50: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00062e60: 2e2e 2e2e 2e20 2d2d 3e0a 3c21 454e 5449 ..... -->........] │ │ │ -00063020: 5d3e 0a0a 3c21 454e 5449 5459 2025 2071 ]>....]]>.]]>.... │ │ │ -00063190: 3c21 454e 5449 5459 2025 2071 616e 6461 │ │ │ -000631c0: 0a0a 3c21 454e 5449 5459 2025 2071 616e ....]]>....]]>.]]>...... │ │ │ -00063430: 0a3c 215b 2025 7161 6e64 6165 6e74 7279 ..]]>.. │ │ │ -000634d0: 0a3c 215b 2025 7161 6e64 6165 6e74 7279 ..]]>.< │ │ │ -00063570: 212d 2d65 6e64 206f 6620 7161 6e64 6165 !--end of qandae │ │ │ -00063580: 6e74 7279 2e6d 6f64 756c 652d 2d3e 5d5d ntry.module-->]] │ │ │ -00063590: 3e0a 0a3c 2145 4e54 4954 5920 2520 7175 >.......< │ │ │ -00063650: 215b 2025 7175 6573 7469 6f6e 2e65 6c65 ![ %question.ele │ │ │ -00063660: 6d65 6e74 3b20 5b0a 3c21 454c 454d 454e ment; [..]]>....]]>.]]>........]]>....]]>.]]>.. │ │ │ -000639b0: 0a3c 215b 2025 6c61 6265 6c2e 6d6f 6475 ...... │ │ │ -00063a90: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.... │ │ │ -00063b20: 3c21 2d2d 656e 6420 6f66 206c 6162 656c ]]>.< │ │ │ -00063b40: 212d 2d65 6e64 206f 6620 6c61 6265 6c2e !--end of label. │ │ │ -00063b50: 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a3c 212d module-->]]>.]]>..]]>..< │ │ │ -00063d50: 2145 4e54 4954 5920 2520 7072 6f63 6564 !ENTITY % proced │ │ │ -00063d60: 7572 652e 6174 746c 6973 7420 2249 4e43 ure.attlist "INC │ │ │ -00063d70: 4c55 4445 223e 0a3c 215b 2570 726f 6365 LUDE">..]]>.< │ │ │ -00063e10: 212d 2d65 6e64 206f 6620 7072 6f63 6564 !--end of proced │ │ │ -00063e20: 7572 652e 6d6f 6475 6c65 2d2d 3e5d 5d3e ure.module-->]]> │ │ │ -00063e30: 0a0a 3c21 454e 5449 5459 2025 2073 7465 ........ │ │ │ -00063f60: 3c21 2d2d 656e 6420 6f66 2073 7465 702e ]]>..< │ │ │ -00063f80: 212d 2d20 5065 7266 6f72 6d61 6e63 653a !-- Performance: │ │ │ -00063f90: 2057 6865 7468 6572 2074 6865 2053 7465 Whether the Ste │ │ │ -00063fa0: 7020 6d75 7374 2062 6520 7065 7266 6f72 p must be perfor │ │ │ -00063fb0: 6d65 6420 2d2d 3e0a 3c21 2d2d 206e 6f74 med -->.. │ │ │ -00063fd0: 0a0a 3c21 454e 5449 5459 2025 2073 7465 ....] │ │ │ -000640c0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2073 ]>....... │ │ │ -000641b0: 0a3c 212d 2d65 6e64 206f 6620 7375 6273 .] │ │ │ -000641d0: 5d3e 0a0a 3c21 2d2d 2050 6572 666f 726d ]>...]]> │ │ │ -00064320: 0a3c 212d 2d65 6e64 206f 6620 7375 6273 .]] │ │ │ -00064340: 3e0a 3c21 2d2d 656e 6420 6f66 2070 726f >.]]>...... │ │ │ -00064450: 0a3c 2145 4e54 4954 5920 2520 7369 6465 .... │ │ │ -000644b0: 3c21 5b20 2573 6964 6562 6172 696e 666f .]]>....]]>.]]>..< │ │ │ -00064670: 2145 4e54 4954 5920 2520 7369 6465 6261 !ENTITY % sideba │ │ │ -00064680: 722e 6d6f 6475 6c65 2022 494e 434c 5544 r.module "INCLUD │ │ │ -00064690: 4522 3e0a 3c21 5b25 7369 6465 6261 722e E">......]]>....]]>.]]>.] │ │ │ -000648d0: 5d3e 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e ]>..........< │ │ │ -00064a30: 215b 2561 6273 7472 6163 742e 656c 656d ![%abstract.elem │ │ │ -00064a40: 656e 743b 5b0a 3c21 454c 454d 454e 5420 ent;[..]]> │ │ │ -00064b50: 0a3c 212d 2d65 6e64 206f 6620 6162 7374 .]] │ │ │ -00064b70: 3e0a 0a3c 2145 4e54 4954 5920 2520 6175 >.... │ │ │ -00064c10: 0a0a 3c21 454e 5449 5459 2025 2061 7574 ....]]>....]]>.]]>... │ │ │ -00064e60: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 ....... │ │ │ -00064f40: 3c21 2d2d 656e 6420 6f66 2062 6c6f 636b │ │ │ -00064f60: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>..< │ │ │ -00065050: 2145 4e54 4954 5920 2520 6174 7472 6962 !ENTITY % attrib │ │ │ -00065060: 7574 696f 6e2e 6d6f 6475 6c65 2022 494e ution.module "IN │ │ │ -00065070: 434c 5544 4522 3e0a 3c21 5b25 6174 7472 CLUDE">......]]> │ │ │ -00065180: 0a0a 3c21 454e 5449 5459 2025 2061 7474 ....]]>.]] │ │ │ -00065270: 3e0a 0a3c 2145 4e54 4954 5920 2520 6272 >........]]>..< │ │ │ -000653a0: 212d 2d20 5265 6e64 6572 6173 3a20 496e !-- Renderas: In │ │ │ -000653b0: 6469 6361 7465 7320 7468 6520 666f 726d dicates the form │ │ │ -000653c0: 6174 2069 6e20 7768 6963 6820 7468 6520 at in which the │ │ │ -000653d0: 4272 6964 6765 4865 6164 0a09 0973 686f BridgeHead...sho │ │ │ -000653e0: 756c 6420 6170 7065 6172 202d 2d3e 0a0a uld appear -->.. │ │ │ -000653f0: 0a3c 2145 4e54 4954 5920 2520 6272 6964 ...]]>.]]>..< │ │ │ -00065530: 2145 4e54 4954 5920 2520 7265 6d61 726b !ENTITY % remark │ │ │ -00065540: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ -00065550: 223e 0a3c 215b 2572 656d 6172 6b2e 6d6f ">.....< │ │ │ -000655e0: 215b 2572 656d 6172 6b2e 656c 656d 656e ![%remark.elemen │ │ │ -000655f0: 743b 5b0a 3c21 454c 454d 454e 5420 7265 t;[..]]>...< │ │ │ -00065660: 215b 2572 656d 6172 6b2e 6174 746c 6973 ![%remark.attlis │ │ │ -00065670: 743b 5b0a 3c21 4154 544c 4953 5420 7265 t;[..]]>.]]>........]]>.. │ │ │ -00065830: 3c21 454e 5449 5459 2025 2065 7069 6772 ..]]>..]]>.. │ │ │ -00065930: 3c21 454e 5449 5459 2025 2066 6f6f 746e . │ │ │ -00065990: 0a3c 2145 4e54 4954 5920 2520 666f 6f74 .....]]>....]]>.]]>.. │ │ │ -00065b60: 0a3c 215b 2568 6967 686c 6967 6874 732e .. │ │ │ -00065ba0: 3c21 454e 5449 5459 2025 2068 6967 686c ....]]>.]]>. │ │ │ -00065d50: 0a3c 2145 4e54 4954 5920 2520 666f 726d .......]]>....]]> │ │ │ -00065f50: 0a3c 212d 2d65 6e64 206f 6620 666f 726d . │ │ │ -00065f70: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>... │ │ │ -000660a0: 3c21 5b25 7061 7261 2e61 7474 6c69 7374 │ │ │ -00066100: 0a3c 212d 2d65 6e64 206f 6620 7061 7261 .]]>.< │ │ │ -00066120: 212d 2d65 6e64 206f 6620 7061 7261 2e6d !--end of para.m │ │ │ -00066130: 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c 2145 odule-->]]>........]]>.. │ │ │ -00066250: 3c21 454e 5449 5459 2025 2073 696d 7061 .. │ │ │ -00066300: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2073 ]]>. │ │ │ -00066320: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.........]]>... │ │ │ -00066510: 0a3c 215b 2569 6d70 6f72 7461 6e74 2e65 ..]]>.... │ │ │ -00066610: 3c21 2d2d 656e 6420 6f66 2069 6d70 6f72 ] │ │ │ -00066630: 5d3e 0a0a 0a3c 2145 4e54 4954 5920 2520 ]>.....]] │ │ │ -000666b0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6e6f >....]]>.....]] │ │ │ -000667d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7469 >....] │ │ │ -00066870: 5d3e 0a0a 0a3c 2145 4e54 4954 5920 2520 ]>.....]]>..< │ │ │ -00066900: 2145 4e54 4954 5920 2520 7761 726e 696e !ENTITY % warnin │ │ │ -00066910: 672e 6174 746c 6973 7420 2249 4e43 4c55 g.attlist "INCLU │ │ │ -00066920: 4445 223e 0a3c 215b 2577 6172 6e69 6e67 DE">..]]>.. │ │ │ -000669b0: 3c21 2d2d 656e 6420 6f66 2061 646d 6f6e ]]>..< │ │ │ -000669d0: 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e !-- ............ │ │ │ -000669e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -000669f0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00066a00: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00066a10: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a3c .......... -->.< │ │ │ -00066a20: 212d 2d20 4c69 7374 7320 2e2e 2e2e 2e2e !-- Lists ...... │ │ │ -00066a30: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00066a40: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00066a50: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ -00066a60: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a0a .......... -->.. │ │ │ -00066a70: 3c21 2d2d 2047 6c6f 7373 4c69 7374 202e ... │ │ │ -00066b00: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 .....]]>....]]>.]]>.........]]>.......]]>.]]>..........]]>....... │ │ │ -00067330: 3c21 5b25 676c 6f73 7364 6566 2e61 7474 .]]>.]]>.. │ │ │ -00067400: 3c21 454e 5449 5459 2025 2067 6c6f 7373 . │ │ │ -00067460: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 .....]]>..... │ │ │ -00067590: 3c21 454e 5449 5459 2025 2067 6c6f 7373 ..]]>........]] │ │ │ -000677c0: 3e0a 0a3c 212d 2d20 4f74 6865 7254 6572 >.......]]>.]]>.< │ │ │ -00067950: 212d 2d65 6e64 206f 6620 676c 6f73 7365 !--end of glosse │ │ │ -00067960: 6e74 7279 2e63 6f6e 7465 6e74 2e6d 6f64 ntry.content.mod │ │ │ -00067970: 756c 652d 2d3e 5d5d 3e0a 0a3c 212d 2d20 ule-->]]>..........]]>........]] │ │ │ -00067cd0: 3e0a 3c21 2d2d 656e 6420 6f66 2069 7465 >.]]>.. │ │ │ -00067d20: 0a3c 215b 256f 7264 6572 6564 6c69 7374 .... │ │ │ -00067dc0: 0a3c 215b 256f 7264 6572 6564 6c69 7374 ..< │ │ │ -00067e20: 212d 2d65 6e64 206f 6620 6f72 6465 7265 !--end of ordere │ │ │ -00067e30: 646c 6973 742e 656c 656d 656e 742d 2d3e dlist.element--> │ │ │ -00067e40: 5d5d 3e0a 0a3c 212d 2d20 4e75 6d65 7261 ]]>.........]]> │ │ │ -00068200: 0a3c 212d 2d65 6e64 206f 6620 6f72 6465 .]] │ │ │ -00068340: 3e0a 0a3c 212d 2d20 4f76 6572 7269 6465 >... │ │ │ -000683f0: 0a0a 3c21 454e 5449 5459 2025 206c 6973 ....]]>.]]>...... │ │ │ -00068610: 0a0a 3c21 454e 5449 5459 2025 2073 6567 ....]]> │ │ │ -00068710: 0a0a 3c21 454e 5449 5459 2025 2073 6567 ....]]>.]]>. │ │ │ -00068810: 0a3c 2145 4e54 4954 5920 2520 7365 6774 .......]]>....]]>.]]>........< │ │ │ -00068b10: 212d 2d65 6e64 206f 6620 7365 676c 6973 !--end of seglis │ │ │ -00068b20: 7469 7465 6d2e 656c 656d 656e 742d 2d3e titem.element--> │ │ │ -00068b30: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...< │ │ │ -00068b60: 215b 2573 6567 6c69 7374 6974 656d 2e61 ![%seglistitem.a │ │ │ -00068b70: 7474 6c69 7374 3b5b 0a3c 2141 5454 4c49 ttlist;[..]]> │ │ │ -00068c00: 0a3c 212d 2d65 6e64 206f 6620 7365 676c .]]>....]]> │ │ │ -00068dd0: 0a3c 212d 2d65 6e64 206f 6620 7365 676d .]]>.. │ │ │ -00068e00: 3c21 2d2d 2053 696d 706c 654c 6973 7420 ....... │ │ │ -00068f40: 0a3c 215b 2573 696d 706c 656c 6973 742e ..]]>..< │ │ │ -00068fa0: 212d 2d20 436f 6c75 6d6e 733a 2054 6865 !-- Columns: The │ │ │ -00068fb0: 206e 756d 6265 7220 6f66 2063 6f6c 756d number of colum │ │ │ -00068fc0: 6e73 2074 6865 2061 7272 6179 2073 686f ns the array sho │ │ │ -00068fd0: 756c 6420 636f 6e74 6169 6e20 2d2d 3e0a uld contain -->. │ │ │ -00068fe0: 3c21 2d2d 2054 7970 653a 2048 6f77 2074 .....]]>.]]>..< │ │ │ -00069240: 2145 4e54 4954 5920 2520 6d65 6d62 6572 !ENTITY % member │ │ │ -00069250: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ -00069260: 223e 0a3c 215b 256d 656d 6265 722e 6d6f ">.....< │ │ │ -000692f0: 215b 256d 656d 6265 722e 656c 656d 656e ![%member.elemen │ │ │ -00069300: 743b 5b0a 3c21 454c 454d 454e 5420 6d65 t;[..]]>...< │ │ │ -00069370: 215b 256d 656d 6265 722e 6174 746c 6973 ![%member.attlis │ │ │ -00069380: 743b 5b0a 3c21 4154 544c 4953 5420 6d65 t;[..]]>.]]>.]] │ │ │ -00069440: 3e0a 0a3c 212d 2d20 5661 7269 6162 6c65 >.... │ │ │ -00069470: 3c21 454e 5449 5459 2025 2076 6172 6961 .. │ │ │ -00069530: 0a3c 2145 4e54 4954 5920 2520 7661 7269 .....]]>..... │ │ │ -00069700: 0a3c 215b 2576 6172 6961 626c 656c 6973 ..< │ │ │ -000697a0: 212d 2d65 6e64 206f 6620 7661 7269 6162 !--end of variab │ │ │ -000697b0: 6c65 6c69 7374 2e61 7474 6c69 7374 2d2d lelist.attlist-- │ │ │ -000697c0: 3e5d 5d3e 0a3c 212d 2d65 6e64 206f 6620 >]]>.]]>........ │ │ │ -00069920: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ -00069950: 3c21 5b25 7661 726c 6973 7465 6e74 7279 │ │ │ -000699d0: 0a3c 212d 2d65 6e64 206f 6620 7661 726c .]]>.]]>...< │ │ │ -00069a40: 215b 2574 6572 6d2e 6d6f 6475 6c65 3b5b ![%term.module;[ │ │ │ -00069a50: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 .... │ │ │ -00069aa0: 3c21 454e 5449 5459 2025 2074 6572 6d2e ..]]>....]]>.]]>...]]> │ │ │ -00069df0: 0a0a 3c21 454e 5449 5459 2025 2063 616c ....]]>.]] │ │ │ -00069ee0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6361 >... │ │ │ -00069f40: 0a3c 2145 4e54 4954 5920 2520 6361 6c6c . │ │ │ -00069f70: 0a0a 3c21 454e 5449 5459 2025 2063 616c ....]]>.......]]>.< │ │ │ -0006a120: 212d 2d65 6e64 206f 6620 6361 6c6c 6f75 !--end of callou │ │ │ -0006a130: 742e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a3c t.module-->]]>.< │ │ │ -0006a140: 212d 2d65 6e64 206f 6620 6361 6c6c 6f75 !--end of callou │ │ │ -0006a150: 746c 6973 742e 636f 6e74 656e 742e 6d6f tlist.content.mo │ │ │ -0006a160: 6475 6c65 2d2d 3e5d 5d3e 0a0a 3c21 2d2d dule-->]]>..........#demo/d │ │ │ +00054080: 6f63 7372 632f 446f 6342 6f6f 6b2f 656e ocsrc/DocBook/en │ │ │ +00054090: 742f 6973 6f2d 6469 612e 656e 74df 0000 t/iso-dia.ent... │ │ │ +000540a0: 0341 3c21 2d2d 2069 736f 2d64 6961 2e65 .A.. │ │ │ +000540f0: 3c21 2d2d 2044 6572 6976 6564 2066 726f .. . . │ │ │ +000541f0: 3c21 2d2d 2043 4152 4f4e 202d 2d3e 0a3c .< │ │ │ +00054200: 2145 4e54 4954 5920 6365 6469 6c09 2226 !ENTITY cedil."& │ │ │ +00054210: 2378 3030 4238 3b22 3e20 3c21 2d2d 2043 #x00B8;"> . . . . │ │ │ +000542d0: 3c21 2d2d 2044 4f54 2041 424f 5645 202d . . . . │ │ │ +000543b0: 203c 212d 2d20 5449 4c44 4520 2d2d 3e0a . │ │ │ +000543c0: 3c21 454e 5449 5459 2075 6d6c 0922 2623 .. │ │ │ +00054460: 3c21 2d2d 2044 6572 6976 6564 2066 726f .. . . . . │ │ │ +000545c0: 3c21 454e 5449 5459 2067 6772 0922 2623 . . │ │ │ +00054650: 203c 212d 2d20 4752 4545 4b20 534d 414c . │ │ │ +000546b0: 3c21 454e 5449 5459 2065 6772 0922 2623 . . . . │ │ │ +00054860: 3c21 454e 5449 5459 2069 6772 0922 2623 . . < │ │ │ +000548f0: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ +00054900: 4c45 5454 4552 204b 4150 5041 202d 2d3e LETTER KAPPA --> │ │ │ +00054910: 0a3c 2145 4e54 4954 5920 4b67 7209 2226 . . . . < │ │ │ +000549e0: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ +000549f0: 4c45 5454 4552 204d 5520 2d2d 3e0a 3c21 LETTER MU -->. . │ │ │ +00054a50: 203c 212d 2d20 4752 4545 4b20 534d 414c . │ │ │ +00054a70: 3c21 454e 5449 5459 204e 6772 0922 2623 . . . . │ │ │ +00054bb0: 203c 212d 2d20 4752 4545 4b20 534d 414c . │ │ │ +00054bd0: 3c21 454e 5449 5459 2050 6772 0922 2623 . . . . │ │ │ +00054d10: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . . . . . . . . │ │ │ +00054f50: 3c21 454e 5449 5459 206f 6867 7209 2226 . .....$d │ │ │ +00054fd0: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ +00054fe0: 6f6b 2f65 6e74 2f69 736f 2d61 6d73 612e ok/ent/iso-amsa. │ │ │ +00054ff0: 656e 74df 0000 0e65 3c21 2d2d 2069 736f ent....e... │ │ │ +000550d0: 0a3c 2145 4e54 4954 5920 6375 6c61 7272 . . . . . . │ │ │ +000552e0: 0a3c 2145 4e54 4954 5920 6c61 7272 3209 . . . . . . < │ │ │ +00055440: 212d 2d20 4c45 4654 5741 5244 5320 4841 !-- LEFTWARDS HA │ │ │ +00055450: 5250 4f4f 4e20 5749 5448 2042 4152 4220 RPOON WITH BARB │ │ │ +00055460: 5550 5741 5244 5320 2d2d 3e0a 3c21 454e UPWARDS -->. . │ │ │ +00055490: 3c21 454e 5449 5459 2068 6172 7209 2226 . │ │ │ +000554e0: 3c21 2d2d 204c 4546 5457 4152 4453 2041 .< │ │ │ +00055510: 2145 4e54 4954 5920 726c 6172 7232 0922 !ENTITY rlarr2." │ │ │ +00055520: 2623 7832 3143 343b 223e 203c 212d 2d20 ⇄"> . . │ │ │ +000555b0: 3c21 2d2d 2052 4947 4854 5741 5244 5320 . │ │ │ +000556b0: 0a3c 2145 4e54 4954 5920 6d75 6d61 7009 . . . . . < │ │ │ +00055880: 212d 2d20 5249 4748 5457 4152 4453 2044 !-- RIGHTWARDS D │ │ │ +00055890: 4f55 424c 4520 4152 524f 5720 5749 5448 OUBLE ARROW WITH │ │ │ +000558a0: 2053 5452 4f4b 4520 2d2d 3e0a 3c21 454e STROKE -->. │ │ │ +000558e0: 0a3c 2145 4e54 4954 5920 6f6c 6172 7209 . . │ │ │ +00055940: 3c21 2d2d 2043 4c4f 434b 5749 5345 204f . │ │ │ +00055980: 3c21 2d2d 2052 4947 4854 5741 5244 5320 │ │ │ +000559a0: 0a3c 2145 4e54 4954 5920 5261 7272 0922 . . │ │ │ +000559e0: 3c21 454e 5449 5459 2072 6172 7232 0922 . . . . . . │ │ │ +00055b80: 203c 212d 2d20 5249 4748 5457 4152 4453 .< │ │ │ +00055bb0: 2145 4e54 4954 5920 7273 6809 2226 2378 !ENTITY rsh."&#x │ │ │ +00055bc0: 3231 4231 3b22 3e20 3c21 2d2d 2055 5057 21B1;"> . . . │ │ │ +00055cb0: 3c21 2d2d 2055 5057 4152 4453 2050 4149 .< │ │ │ +00055cd0: 2145 4e54 4954 5920 7641 7272 0922 2623 !ENTITY vArr."&# │ │ │ +00055ce0: 7832 3144 353b 223e 203c 212d 2d20 5550 x21D5;"> . │ │ │ +00055d20: 203c 212d 2d20 5550 2044 4f57 4e20 4152 . . │ │ │ +00055d80: 3c21 454e 5449 5459 2075 6861 7272 0922 . . . .... │ │ │ +00055e60: 0021 6465 6d6f 2f64 6f63 7372 632f 446f .!demo/docsrc/Do │ │ │ +00055e70: 6342 6f6f 6b2f 656e 742f 4368 616e 6765 cBook/ent/Change │ │ │ +00055e80: 4c6f 67df 0000 01e8 3139 3939 2d30 332d Log.....1999-03- │ │ │ +00055e90: 3331 2020 4e6f 726d 616e 2057 616c 7368 31 Norman Walsh │ │ │ +00055ea0: 2020 3c6e 6477 406e 7761 6c73 682e 636f ...* iso-num.e │ │ │ +00055ec0: 6e74 3a20 5265 6d6f 7665 6420 6465 636c nt: Removed decl │ │ │ +00055ed0: 6172 6174 696f 6e73 2066 6f72 206c 7420 arations for lt │ │ │ +00055ee0: 616e 6420 616d 702e 2020 5468 6579 2772 and amp. They'r │ │ │ +00055ef0: 6520 7072 6564 6566 696e 6564 2069 6e20 e predefined in │ │ │ +00055f00: 584d 4c20 616e 6420 7468 6520 6465 636c XML and the decl │ │ │ +00055f10: 732e 2077 6572 6520 6361 7573 696e 6720 s. were causing │ │ │ +00055f20: 4945 3520 746f 2063 686f 6b65 0a0a 3139 IE5 to choke..19 │ │ │ +00055f30: 3939 2d30 312d 3331 2020 4e6f 726d 616e 99-01-31 Norman │ │ │ +00055f40: 2057 616c 7368 2020 3c6e 6477 406e 7761 Walsh ...* iso │ │ │ +00055f60: 2d61 6d73 612e 656e 742c 2069 736f 2d61 -amsa.ent, iso-a │ │ │ +00055f70: 6d73 622e 656e 742c 2069 736f 2d61 6d73 msb.ent, iso-ams │ │ │ +00055f80: 632e 656e 742c 2069 736f 2d61 6d73 6e2e c.ent, iso-amsn. │ │ │ +00055f90: 656e 742c 2069 736f 2d61 6d73 6f2e 656e ent, iso-amso.en │ │ │ +00055fa0: 742c 2069 736f 2d61 6d73 722e 656e 742c t, iso-amsr.ent, │ │ │ +00055fb0: 2069 736f 2d62 6f78 2e65 6e74 2c20 6973 iso-box.ent, is │ │ │ +00055fc0: 6f2d 6379 7231 2e65 6e74 2c20 6973 6f2d o-cyr1.ent, iso- │ │ │ +00055fd0: 6379 7232 2e65 6e74 2c20 6973 6f2d 6469 cyr2.ent, iso-di │ │ │ +00055fe0: 612e 656e 742c 2069 736f 2d67 726b 312e a.ent, iso-grk1. │ │ │ +00055ff0: 656e 742c 2069 736f 2d67 726b 322e 656e ent, iso-grk2.en │ │ │ +00056000: 742c 2069 736f 2d67 726b 332e 656e 742c t, iso-grk3.ent, │ │ │ +00056010: 2069 736f 2d67 726b 342e 656e 742c 2069 iso-grk4.ent, i │ │ │ +00056020: 736f 2d6c 6174 312e 656e 742c 2069 736f so-lat1.ent, iso │ │ │ +00056030: 2d6c 6174 322e 656e 742c 2069 736f 2d6e -lat2.ent, iso-n │ │ │ +00056040: 756d 2e65 6e74 2c20 6973 6f2d 7075 622e um.ent, iso-pub. │ │ │ +00056050: 656e 742c 2069 736f 2d74 6563 682e 656e ent, iso-tech.en │ │ │ +00056060: 743a 200a 094e 6577 2066 696c 652e 0a0a t: ..New file... │ │ │ +00056070: b600 0000 2464 656d 6f2f 646f 6373 7263 ....$demo/docsrc │ │ │ +00056080: 2f44 6f63 426f 6f6b 2f65 6e74 2f69 736f /DocBook/ent/iso │ │ │ +00056090: 2d61 6d73 6e2e 656e 74df 0000 0b0c 3c21 -amsn.ent......... │ │ │ +00056190: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . │ │ │ +000561e0: 0a3c 2145 4e54 4954 5920 676e 7369 6d09 . . . . │ │ │ +00056270: 3c21 454e 5449 5459 206c 6e45 0922 2623 . │ │ │ +000562d0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ +00056300: 2145 4e54 4954 5920 6e61 7009 2226 2378 !ENTITY nap."&#x │ │ │ +00056310: 3232 3439 3b22 3e20 3c21 2d2d 204e 4f54 2249;"> . │ │ │ +00056350: 3c21 2d2d 204e 4549 5448 4552 2041 5050 . │ │ │ +000563a0: 203c 212d 2d20 4e4f 5420 4944 454e 5449 . . │ │ │ +00056400: 0a3c 2145 4e54 4954 5920 6e67 6573 0922 . . . │ │ │ +00056470: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . . . < │ │ │ +00056590: 212d 2d20 444f 4553 204e 4f54 2044 4956 !-- DOES NOT DIV │ │ │ +000565a0: 4944 4520 2d2d 3e0a 3c21 454e 5449 5459 IDE -->. . . . . .< │ │ │ +00056700: 2145 4e54 4954 5920 6e73 6365 0922 2623 !ENTITY nsce."&# │ │ │ +00056710: 7845 3431 333b 223e 203c 212d 2d20 202d xE413;"> . . │ │ │ +00056790: 0a3c 2145 4e54 4954 5920 6e73 7061 7209 . . │ │ │ +000567d0: 3c21 2d2d 204e 4f54 2041 2053 5542 5345 . . . . . . │ │ │ +00056930: 3c21 2d2d 204e 4547 4154 4544 2044 4f55 . . │ │ │ +000569a0: 3c21 454e 5449 5459 2070 726e 6170 0922 . < │ │ │ +000569e0: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. .< │ │ │ +00056a10: 2145 4e54 4954 5920 7363 6e61 7009 2226 !ENTITY scnap."& │ │ │ +00056a20: 2378 3232 4539 3b22 3e20 3c21 2d2d 2020 #x22E9;"> . . . . . . . . │ │ │ +00056ba0: 3c21 2d2d 2020 2d2d 3e0a b600 0000 2364 .....#d │ │ │ +00056bb0: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ +00056bc0: 6f6b 2f65 6e74 2f69 736f 2d62 6f78 2e65 ok/ent/iso-box.e │ │ │ +00056bd0: 6e74 df00 000c 933c 212d 2d20 6973 6f2d nt.........< │ │ │ +00056cb0: 2145 4e54 4954 5920 626f 7868 0922 2623 !ENTITY boxh."&# │ │ │ +00056cc0: 7832 3530 303b 223e 203c 212d 2d20 424f x2500;"> . │ │ │ +00056cf0: 3c21 454e 5449 5459 2062 6f78 7609 2226 .< │ │ │ +00056d30: 2145 4e54 4954 5920 626f 7875 7209 2226 !ENTITY boxur."& │ │ │ +00056d40: 2378 3235 3134 3b22 3e20 3c21 2d2d 2042 #x2514;"> . │ │ │ +00056dd0: 203c 212d 2d20 424f 5820 4452 4157 494e . │ │ │ +00056e40: 0a3c 2145 4e54 4954 5920 626f 7876 7209 . . . < │ │ │ +00056ef0: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ +00056f00: 204c 4947 4854 2056 4552 5449 4341 4c20 LIGHT VERTICAL │ │ │ +00056f10: 414e 4420 4c45 4654 202d 2d3e 0a3c 2145 AND LEFT -->. . . . . . . . < │ │ │ +00057170: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ +00057180: 2044 4f55 424c 4520 484f 5249 5a4f 4e54 DOUBLE HORIZONT │ │ │ +00057190: 414c 202d 2d3e 0a3c 2145 4e54 4954 5920 AL -->. │ │ │ +000571b0: 203c 212d 2d20 424f 5820 4452 4157 494e . . . . . . . . │ │ │ +00057450: 3c21 454e 5449 5459 2062 6f78 5648 0922 . . . │ │ │ +000575a0: 203c 212d 2d20 424f 5820 4452 4157 494e . . . │ │ │ +00057720: 203c 212d 2d20 424f 5820 4452 4157 494e . < │ │ │ +00057770: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ +00057780: 2044 4f55 424c 4520 5550 2041 4e44 2052 DOUBLE UP AND R │ │ │ +00057790: 4947 4854 202d 2d3e 0a3c 2145 4e54 4954 IGHT -->. . .....$d │ │ │ +00057870: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ +00057880: 6f6b 2f65 6e74 2f69 736f 2d61 6d73 722e ok/ent/iso-amsr. │ │ │ +00057890: 656e 74df 0000 0da5 3c21 2d2d 2069 736f ent........ │ │ │ +00057970: 0a3c 2145 4e54 4954 5920 6170 6509 2226 . . < │ │ │ +000579b0: 212d 2d20 4551 5549 5641 4c45 4e54 2054 !-- EQUIVALENT T │ │ │ +000579c0: 4f20 2d2d 3e0a 3c21 454e 5449 5459 2062 O -->. │ │ │ +000579e0: 203c 212d 2d20 414c 4c20 4551 5541 4c20 . . . │ │ │ +00057a80: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ +00057ab0: 2145 4e54 4954 5920 6275 6d70 6509 2226 !ENTITY bumpe."& │ │ │ +00057ac0: 2378 3232 3446 3b22 3e20 3c21 2d2d 2020 #x224F;"> . . . . . . . . │ │ │ +00057c20: 3c21 454e 5449 5459 2065 7364 6f74 0922 . │ │ │ +00057c60: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . │ │ │ +00057cb0: 3c21 454e 5449 5459 2065 7244 6f74 0922 . < │ │ │ +00057cf0: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . . . │ │ │ +00057de0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . . . . │ │ │ +00057ec0: 203c 212d 2d20 4d55 4348 2047 5245 4154 . . . .< │ │ │ +00057f60: 2145 4e54 4954 5920 6c45 6709 2226 2378 !ENTITY lEg."&#x │ │ │ +00057f70: 3232 4441 3b22 3e20 3c21 2d2d 2020 2d2d 22DA;"> . . │ │ │ +00057fe0: 3c21 2d2d 204c 4553 532d 5448 414e 204f . < │ │ │ +00058040: 212d 2d20 4c45 5353 2d54 4841 4e20 4f52 !-- LESS-THAN OR │ │ │ +00058050: 2045 5155 4956 414c 454e 5420 544f 202d EQUIVALENT TO - │ │ │ +00058060: 2d3e 0a3c 2145 4e54 4954 5920 4c74 0922 ->. . │ │ │ +000580d0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . < │ │ │ +00058120: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . │ │ │ +00058170: 3c21 454e 5449 5459 2070 7273 696d 0922 . │ │ │ +000581b0: 3c21 2d2d 2020 2d2d 3e0a 3c21 2d2d 2020 .. │ │ │ +00058200: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . │ │ │ +00058290: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . │ │ │ +000582c0: 0a3c 2145 4e54 4954 5920 736d 6964 0922 . . │ │ │ +00058300: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . . . │ │ │ +000583e0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ +00058430: 0a3c 2145 4e54 4954 5920 5375 7009 2226 . . . . . . . . . . .... │ │ │ +00058640: 0024 6465 6d6f 2f64 6f63 7372 632f 446f .$demo/docsrc/Do │ │ │ +00058650: 6342 6f6f 6b2f 656e 742f 6973 6f2d 616d cBook/ent/iso-am │ │ │ +00058660: 7363 2e65 6e74 df00 0002 cd3c 212d 2d20 sc.ent........ . . . . .. . │ │ │ +00058900: 3c21 454e 5449 5459 2064 6c63 6f72 6e09 .....$dem │ │ │ +00058940: 6f2f 646f 6373 7263 2f44 6f63 426f 6f6b o/docsrc/DocBook │ │ │ +00058950: 2f65 6e74 2f69 736f 2d61 6d73 622e 656e /ent/iso-amsb.en │ │ │ +00058960: 74df 0000 0973 3c21 2d2d 2069 736f 2d61 t....s....< │ │ │ +00058a40: 2145 4e54 4954 5920 616d 616c 6709 2226 !ENTITY amalg."& │ │ │ +00058a50: 2378 4532 3531 3b22 3e20 3c21 2d2d 2020 #xE251;"> . │ │ │ +00058a80: 3c21 2d2d 2050 4552 5350 4543 5449 5645 . │ │ │ +00058ab0: 203c 212d 2d20 4e41 4e44 202d 2d3e 0a3c .< │ │ │ +00058ac0: 2145 4e54 4954 5920 4361 7009 2226 2378 !ENTITY Cap."&#x │ │ │ +00058ad0: 3232 4432 3b22 3e20 3c21 2d2d 2044 4f55 22D2;"> . . < │ │ │ +00058b40: 212d 2d20 4355 524c 5920 4c4f 4749 4341 !-- CURLY LOGICA │ │ │ +00058b50: 4c20 4f52 202d 2d3e 0a3c 2145 4e54 4954 L OR -->. .< │ │ │ +00058b90: 2145 4e54 4954 5920 6469 616d 0922 2623 !ENTITY diam."&# │ │ │ +00058ba0: 7832 3243 343b 223e 203c 212d 2d20 4449 x22C4;"> . . . │ │ │ +00058c80: 203c 212d 2d20 4c45 4654 204e 4f52 4d41 . │ │ │ +00058cb0: 3c21 454e 5449 5459 206d 696e 7573 6209 . │ │ │ +00058d20: 3c21 454e 5449 5459 206f 6369 7209 2226 . . . │ │ │ +00058e10: 3c21 2d2d 2043 4952 434c 4544 2050 4c55 . │ │ │ +00058e40: 3c21 2d2d 2043 4952 434c 4544 2044 4956 . │ │ │ +00058e60: 3c21 454e 5449 5459 206f 7469 6d65 7309 . │ │ │ +00058ee0: 3c21 2d2d 2044 4f54 2050 4c55 5320 2d2d . │ │ │ +00058f30: 3c21 454e 5449 5459 2072 7469 6d65 7309 . . . │ │ │ +00059000: 3c21 2d2d 2053 4554 204d 494e 5553 202d │ │ │ +00059070: 0a3c 2145 4e54 4954 5920 7373 6574 6d6e . . . . . . . │ │ │ +00059190: 3c21 454e 5449 5459 2078 6369 7263 0922 │ │ │ +000591c0: 0a3c 2145 4e54 4954 5920 7864 7472 6909 . │ │ │ +00059240: 0a3c 2145 4e54 4954 5920 636f 7072 6f64 . . │ │ │ +00059290: 3c21 2d2d 204e 2d41 5259 2050 524f 4455 . │ │ │ +000592c0: 3c21 2d2d 204e 2d41 5259 2053 554d 4d41 .....$de │ │ │ +000592e0: 6d6f 2f64 6f63 7372 632f 446f 6342 6f6f mo/docsrc/DocBoo │ │ │ +000592f0: 6b2f 656e 742f 6973 6f2d 616d 736f 2e65 k/ent/iso-amso.e │ │ │ +00059300: 6e74 df00 0004 9e3c 212d 2d20 6973 6f2d nt......... │ │ │ +000593e0: 3c21 454e 5449 5459 2061 6e67 0922 2623 . . . . . . .< │ │ │ +00059530: 2145 4e54 4954 5920 656d 7074 7909 2226 !ENTITY empty."& │ │ │ +00059540: 2378 4532 4433 3b22 3e20 3c21 2d2d 2020 #xE2D3;"> . < │ │ │ +00059570: 212d 2d20 4749 4d45 4c20 5359 4d42 4f4c !-- GIMEL SYMBOL │ │ │ +00059580: 202d 2d3e 0a3c 2145 4e54 4954 5920 696d -->. │ │ │ +000595a0: 3c21 2d2d 2042 4c41 434b 2d4c 4554 5445 . │ │ │ +000595c0: 3c21 454e 5449 5459 2069 6e6f 646f 7409 . │ │ │ +00059630: 3c21 454e 5449 5459 206e 6578 6973 7409 . . . . │ │ │ +00059740: 0a3c 212d 2d20 2020 2020 7670 7269 6d65 ..< │ │ │ +00059770: 2145 4e54 4954 5920 7765 6965 7270 0922 !ENTITY weierp." │ │ │ +00059780: 2623 7832 3131 383b 223e 203c 212d 2d20 ℘"> .....$demo/d │ │ │ +000597b0: 6f63 7372 632f 446f 6342 6f6f 6b2f 656e ocsrc/DocBook/en │ │ │ +000597c0: 742f 6973 6f2d 7465 6368 2e65 6e74 df00 t/iso-tech.ent.. │ │ │ +000597d0: 000b 3a3c 212d 2d20 6973 6f2d 7465 6368 ..: │ │ │ +00059820: 0a0a 3c21 2d2d 2044 6572 6976 6564 2066 .... . .< │ │ │ +00059900: 2145 4e54 4954 5920 616e 6739 3009 2226 !ENTITY ang90."& │ │ │ +00059910: 2378 3232 3146 3b22 3e20 3c21 2d2d 2052 #x221F;"> .< │ │ │ +00059930: 2145 4e54 4954 5920 616e 6773 7068 0922 !ENTITY angsph." │ │ │ +00059940: 2623 7832 3232 323b 223e 203c 212d 2d20 ∢"> . . . │ │ │ +000599c0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ +00059a10: 0a3c 2145 4e54 4954 5920 636f 6e69 6e74 . . │ │ │ +00059a50: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . .< │ │ │ +00059a80: 2145 4e54 4954 5920 6578 6973 7409 2226 !ENTITY exist."& │ │ │ +00059a90: 2378 3232 3033 3b22 3e20 3c21 2d2d 2020 #x2203;"> . │ │ │ +00059ac0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . < │ │ │ +00059b60: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . │ │ │ +00059bb0: 0a3c 2145 4e54 4954 5920 6973 696e 0922 . . < │ │ │ +00059bf0: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . . . .< │ │ │ +00059cf0: 2145 4e54 4954 5920 6e69 0922 2623 7832 !ENTITY ni." │ │ │ +00059d00: 3230 443b 223e 203c 212d 2d20 202d 2d3e 20D;"> │ │ │ +00059d10: 0a3c 2145 4e54 4954 5920 6f72 0922 2623 . │ │ │ +00059d60: 0a3c 2145 4e54 4954 5920 7061 7274 0922 . . │ │ │ +00059da0: 203c 212d 2d20 5045 5220 4d49 4c4c 4520 . . . . . │ │ │ +00059e80: 0a3c 2145 4e54 4954 5920 7261 6e67 0922 . . < │ │ │ +00059ec0: 212d 2d20 5249 4748 5457 4152 4453 2041 !-- RIGHTWARDS A │ │ │ +00059ed0: 5252 4f57 202d 2d3e 0a3c 2145 4e54 4954 RROW -->. . . │ │ │ +00059f20: 3c21 454e 5449 5459 2073 7175 6172 6509 . < │ │ │ +00059f90: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . │ │ │ +00059fe0: 3c21 454e 5449 5459 2074 6865 7265 3409 . . │ │ │ +0005a040: 3c21 454e 5449 5459 2061 6e67 7374 0922 . . . . . . │ │ │ +0005a1e0: 3c21 454e 5449 5459 206e 6f74 696e 0922 . │ │ │ +0005a220: 3c21 2d2d 2053 4352 4950 5420 534d 414c . . . . .... │ │ │ +0005a310: 0024 6465 6d6f 2f64 6f63 7372 632f 446f .$demo/docsrc/Do │ │ │ +0005a320: 6342 6f6f 6b2f 656e 742f 6973 6f2d 6c61 cBook/ent/iso-la │ │ │ +0005a330: 7432 2e65 6e74 df00 0022 363c 212d 2d20 t2.ent..."6... . │ │ │ +0005a4a0: 3c21 454e 5449 5459 2061 6d61 6372 0922 . │ │ │ +0005a500: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . │ │ │ +0005a570: 0a3c 2145 4e54 4954 5920 416f 676f 6e09 . . . . │ │ │ +0005a660: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . │ │ │ +0005a6d0: 3c21 454e 5449 5459 2063 6369 7263 0922 . . . . . .< │ │ │ +0005a8b0: 2145 4e54 4954 5920 4473 7472 6f6b 0922 !ENTITY Dstrok." │ │ │ +0005a8c0: 2623 7830 3131 303b 223e 203c 212d 2d20 Đ"> . . . . .< │ │ │ +0005aaa0: 2145 4e54 4954 5920 656f 676f 6e09 2226 !ENTITY eogon."& │ │ │ +0005aab0: 2378 3031 3139 3b22 3e20 3c21 2d2d 204c #x0119;"> . < │ │ │ +0005ab00: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ +0005ab10: 4c20 4c45 5454 4552 2045 2057 4954 4820 L LETTER E WITH │ │ │ +0005ab20: 4f47 4f4e 454b 202d 2d3e 0a3c 2145 4e54 OGONEK -->. . │ │ │ +0005ab70: 3c21 454e 5449 5459 2067 6272 6576 6509 . │ │ │ +0005abd0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . │ │ │ +0005ac60: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . . │ │ │ +0005ad20: 3c21 454e 5449 5459 2047 646f 7409 2226 . . . . < │ │ │ +0005aef0: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ +0005af00: 4c20 4c45 5454 4552 2049 2057 4954 4820 L LETTER I WITH │ │ │ +0005af10: 4d41 4352 4f4e 202d 2d3e 0a3c 2145 4e54 MACRON -->. . │ │ │ +0005af60: 3c21 454e 5449 5459 2069 6a6c 6967 0922 . . . │ │ │ +0005b060: 0a3c 2145 4e54 4954 5920 496f 676f 6e09 . . . . < │ │ │ +0005b150: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ +0005b160: 4c45 5454 4552 204a 2057 4954 4820 4349 LETTER J WITH CI │ │ │ +0005b170: 5243 554d 464c 4558 202d 2d3e 0a3c 2145 RCUMFLEX -->. . .< │ │ │ +0005b210: 2145 4e54 4954 5920 4b63 6564 696c 0922 !ENTITY Kcedil." │ │ │ +0005b220: 2623 7830 3133 363b 223e 203c 212d 2d20 Ķ"> . . │ │ │ +0005b2b0: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . │ │ │ +0005b320: 3c21 454e 5449 5459 206c 6361 726f 6e09 . │ │ │ +0005b380: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . . . │ │ │ +0005b560: 3c21 454e 5449 5459 206e 6163 7574 6509 . │ │ │ +0005b5c0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . │ │ │ +0005b660: 3c21 454e 5449 5459 206e 6170 6f73 0922 . │ │ │ +0005b6b0: 3c21 454e 5449 5459 206e 6361 726f 6e09 . │ │ │ +0005b710: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . . │ │ │ +0005b880: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . │ │ │ +0005b9b0: 0a3c 2145 4e54 4954 5920 5261 6375 7465 . . . . │ │ │ +0005baa0: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . │ │ │ +0005bb30: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . │ │ │ +0005bba0: 3c21 454e 5449 5459 2073 6361 726f 6e09 . │ │ │ +0005bc00: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . │ │ │ +0005bd20: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . │ │ │ +0005bd50: 3c21 454e 5449 5459 2074 6361 726f 6e09 . │ │ │ +0005bdb0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . .< │ │ │ +0005bf40: 2145 4e54 4954 5920 5562 7265 7665 0922 !ENTITY Ubreve." │ │ │ +0005bf50: 2623 7830 3136 433b 223e 203c 212d 2d20 Ŭ"> . . │ │ │ +0005c020: 3c21 454e 5449 5459 2075 6d61 6372 0922 . │ │ │ +0005c080: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . │ │ │ +0005c0f0: 0a3c 2145 4e54 4954 5920 556f 676f 6e09 . . │ │ │ +0005c180: 0a3c 2145 4e54 4954 5920 5572 696e 6709 . . │ │ │ +0005c210: 0a3c 2145 4e54 4954 5920 5574 696c 6465 . . │ │ │ +0005c2a0: 0a3c 2145 4e54 4954 5920 5763 6972 6309 . . . │ │ │ +0005c350: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . │ │ │ +0005c380: 3c21 454e 5449 5459 2059 756d 6c09 2226 . . . │ │ │ +0005c470: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ +0005c4e0: 0a3c 2145 4e54 4954 5920 7a64 6f74 0922 . . │ │ │ +0005c570: 0ab6 0000 0023 6465 6d6f 2f64 6f63 7372 .....#demo/docsr │ │ │ +0005c580: 632f 446f 6342 6f6f 6b2f 656e 742f 6973 c/DocBook/ent/is │ │ │ +0005c590: 6f2d 7075 622e 656e 74df 0000 11ed 3c21 o-pub.ent......... │ │ │ +0005c690: 3c21 2d2d 2045 4d20 5350 4143 4520 2d2d . . . . . │ │ │ +0005c7c0: 203c 212d 2d20 5448 494e 2053 5041 4345 . │ │ │ +0005c7f0: 203c 212d 2d20 4841 4952 2053 5041 4345 . │ │ │ +0005c820: 3c21 2d2d 2045 4d20 4441 5348 202d 2d3e │ │ │ +0005c830: 0a3c 2145 4e54 4954 5920 6e64 6173 6809 . . . . │ │ │ +0005c8d0: 3c21 2d2d 2048 4f52 495a 4f4e 5441 4c20 . .< │ │ │ +0005c920: 2145 4e54 4954 5920 6672 6163 3133 0922 !ENTITY frac13." │ │ │ +0005c930: 2623 7832 3135 333b 223e 203c 212d 2d20 ⅓"> . . . . .< │ │ │ +0005ca60: 2145 4e54 4954 5920 6672 6163 3435 0922 !ENTITY frac45." │ │ │ +0005ca70: 2623 7832 3135 383b 223e 203c 212d 2d20 ⅘"> . │ │ │ +0005caa0: 3c21 454e 5449 5459 2066 7261 6331 3609 .< │ │ │ +0005cae0: 2145 4e54 4954 5920 6672 6163 3536 0922 !ENTITY frac56." │ │ │ +0005caf0: 2623 7832 3135 413b 223e 203c 212d 2d20 ⅚"> . │ │ │ +0005cb20: 3c21 454e 5449 5459 2069 6e63 6172 6509 . . │ │ │ +0005cbb0: 0a3c 2145 4e54 4954 5920 6c68 626c 6b09 . . │ │ │ +0005cc00: 203c 212d 2d20 4c49 4748 5420 5348 4144 . │ │ │ +0005cc30: 203c 212d 2d20 4d45 4449 554d 2053 4841 . . . . . < │ │ │ +0005cd60: 212d 2d20 5748 4954 4520 5550 2d50 4f49 !-- WHITE UP-POI │ │ │ +0005cd70: 4e54 494e 4720 5452 4941 4e47 4c45 202d NTING TRIANGLE - │ │ │ +0005cd80: 2d3e 0a3c 2145 4e54 4954 5920 6474 7269 ->. . . . │ │ │ +0005ce80: 0a3c 2145 4e54 4954 5920 6474 7269 6609 . . │ │ │ +0005cf60: 3c21 2d2d 2042 4c41 434b 2043 4c55 4220 . . │ │ │ +0005cfb0: 3c21 454e 5449 5459 2068 6561 7274 7309 . . . . . . . . . │ │ │ +0005d170: 3c21 454e 5449 5459 206d 616c 6509 2226 . . . . . . . . . │ │ │ +0005d390: 3c21 454e 5449 5459 2066 6669 6c69 6709 . . │ │ │ +0005d400: 0a3c 2145 4e54 4954 5920 6d6c 6472 0922 . . . . │ │ │ +0005d4a0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . │ │ │ +0005d520: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . . . . < │ │ │ +0005d660: 212d 2d20 5349 5820 504f 494e 5445 4420 !-- SIX POINTED │ │ │ +0005d670: 424c 4143 4b20 5354 4152 202d 2d3e 0a3c BLACK STAR -->.< │ │ │ +0005d680: 2145 4e54 4954 5920 7461 7267 6574 0922 !ENTITY target." │ │ │ +0005d690: 2623 7832 3331 363b 223e 203c 212d 2d20 ⌖"> . . . │ │ │ +0005d740: 3c21 2d2d 2054 4f50 204c 4546 5420 4352 . .....$ │ │ │ +0005d790: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ +0005d7a0: 6f6f 6b2f 656e 742f 6973 6f2d 6772 6b32 ook/ent/iso-grk2 │ │ │ +0005d7b0: 2e65 6e74 df00 0006 c63c 212d 2d20 6973 .ent....... │ │ │ +0005d890: 0a0a 3c21 454e 5449 5459 2061 6163 6772 .. . . < │ │ │ +0005d940: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ +0005d950: 4c45 5454 4552 2045 5053 494c 4f4e 2057 LETTER EPSILON W │ │ │ +0005d960: 4954 4820 544f 4e4f 5320 2d2d 3e0a 3c21 ITH TONOS -->. . │ │ │ +0005da00: 0a3c 2145 4e54 4954 5920 4545 6163 6772 . . . │ │ │ +0005dab0: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . . . . . . │ │ │ +0005dd60: 203c 212d 2d20 4752 4545 4b20 4341 5049 . . │ │ │ +0005de50: 3c21 2d2d 2047 5245 454b 2043 4150 4954 .. │ │ │ +0005de80: 0000 0023 6465 6d6f 2f64 6f63 7372 632f ...#demo/docsrc/ │ │ │ +0005de90: 446f 6342 6f6f 6b2f 656e 742f 6973 6f2d DocBook/ent/iso- │ │ │ +0005dea0: 6e75 6d2e 656e 74df 0000 0fe8 3c21 2d2d num.ent........ │ │ │ +0005dfc0: 3c21 454e 5449 5459 2066 7261 6331 3209 . .< │ │ │ +0005e040: 2145 4e54 4954 5920 6672 6163 3334 0922 !ENTITY frac34." │ │ │ +0005e050: 2623 7830 3042 453b 223e 203c 212d 2d20 ¾"> . .< │ │ │ +0005e0d0: 2145 4e54 4954 5920 6672 6163 3538 0922 !ENTITY frac58." │ │ │ +0005e0e0: 2623 7832 3135 443b 223e 203c 212d 2d20 ⅝"> . │ │ │ +0005e110: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . │ │ │ +0005e180: 0a3c 2145 4e54 4954 5920 7375 7033 0922 . . │ │ │ +0005e1d0: 3c21 2d2d 2050 4c55 5320 5349 474e 202d . │ │ │ +0005e230: 203c 212d 2d20 4c45 5353 2d54 4841 4e20 . . . . │ │ │ +0005e2e0: 3c21 454e 5449 5459 2074 696d 6573 0922 . . . . . │ │ │ +0005e3f0: 203c 212d 2d20 5945 4e20 5349 474e 202d │ │ │ +0005e430: 0a3c 2145 4e54 4954 5920 7065 7263 6e74 . . . │ │ │ +0005e490: 3c21 454e 5449 5459 2061 7374 0922 2623 . │ │ │ +0005e4e0: 3c21 2d2d 2043 4f4d 4d45 5243 4941 4c20 . │ │ │ +0005e510: 203c 212d 2d20 4c45 4654 2053 5155 4152 . │ │ │ +0005e560: 0a3c 2145 4e54 4954 5920 7273 7162 0922 . . .< │ │ │ +0005e5d0: 2145 4e54 4954 5920 686f 7262 6172 0922 !ENTITY horbar." │ │ │ +0005e5e0: 2623 7832 3031 353b 223e 203c 212d 2d20 ―"> . │ │ │ +0005e650: 3c21 2d2d 2052 4947 4854 2043 5552 4c59 . . . │ │ │ +0005e6e0: 3c21 2d2d 2044 4547 5245 4520 5349 474e . < │ │ │ +0005e710: 212d 2d20 4d41 5343 554c 494e 4520 4f52 !-- MASCULINE OR │ │ │ +0005e720: 4449 4e41 4c20 494e 4449 4341 544f 5220 DINAL INDICATOR │ │ │ +0005e730: 2d2d 3e0a 3c21 454e 5449 5459 206f 7264 -->. . . . │ │ │ +0005e890: 203c 212d 2d20 5550 5741 5244 5320 4152 . . . . . │ │ │ +0005e9c0: 3c21 2d2d 204e 4f54 2053 4947 4e20 2d2d . │ │ │ +0005ea10: 3c21 2d2d 2045 5843 4c41 4d41 5449 4f4e . . . . . │ │ │ +0005eb30: 0a3c 2145 4e54 4954 5920 636f 6d6d 6109 . . . .< │ │ │ +0005ebb0: 2145 4e54 4954 5920 7065 7269 6f64 0922 !ENTITY period." │ │ │ +0005ebc0: 2623 7830 3032 453b 223e 203c 212d 2d20 ."> . . .< │ │ │ +0005ec60: 2145 4e54 4954 5920 7175 6573 7409 2226 !ENTITY quest."& │ │ │ +0005ec70: 2378 3030 3346 3b22 3e20 3c21 2d2d 2051 #x003F;"> │ │ │ +0005ec90: 0a3c 2145 4e54 4954 5920 6971 7565 7374 . . . . .< │ │ │ +0005ed90: 2145 4e54 4954 5920 7273 7175 6f09 2226 !ENTITY rsquo."& │ │ │ +0005eda0: 2378 3230 3139 3b22 3e20 3c21 2d2d 2052 #x2019;"> .< │ │ │ +0005edd0: 2145 4e54 4954 5920 6c64 7175 6f09 2226 !ENTITY ldquo."& │ │ │ +0005ede0: 2378 3230 3143 3b22 3e20 3c21 2d2d 2020 #x201C;"> . < │ │ │ +0005ee10: 212d 2d20 5249 4748 5420 444f 5542 4c45 !-- RIGHT DOUBLE │ │ │ +0005ee20: 2051 554f 5441 5449 4f4e 204d 4152 4b20 QUOTATION MARK │ │ │ +0005ee30: 2d2d 3e0a 3c21 454e 5449 5459 206e 6273 -->. . < │ │ │ +0005ee80: 212d 2d20 534f 4654 2048 5950 4845 4e20 !-- SOFT HYPHEN │ │ │ +0005ee90: 2d2d 3e0a b600 0000 2464 656d 6f2f 646f -->.....$demo/do │ │ │ +0005eea0: 6373 7263 2f44 6f63 426f 6f6b 2f65 6e74 csrc/DocBook/ent │ │ │ +0005eeb0: 2f69 736f 2d67 726b 332e 656e 74df 0000 /iso-grk3.ent... │ │ │ +0005eec0: 0a02 3c21 2d2d 2069 736f 2d67 726b 332e ... │ │ │ +0005ef10: 0a3c 212d 2d20 4465 7269 7665 6420 6672 ... . │ │ │ +0005efc0: 3c21 454e 5449 5459 2062 6574 6109 2226 . . . │ │ │ +0005f0b0: 0a3c 2145 4e54 4954 5920 6465 6c74 6109 . . . │ │ │ +0005f150: 0a3c 2145 4e54 4954 5920 6570 7369 7609 . . │ │ │ +0005f190: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . < │ │ │ +0005f1f0: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ +0005f200: 4c45 5454 4552 2045 5441 202d 2d3e 0a3c LETTER ETA -->.< │ │ │ +0005f210: 2145 4e54 4954 5920 7468 6574 6173 0922 !ENTITY thetas." │ │ │ +0005f220: 2623 7830 3342 383b 223e 203c 212d 2d20 θ"> . │ │ │ +0005f250: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . │ │ │ +0005f290: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ +0005f2f0: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c . . . │ │ │ +0005f3e0: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c .< │ │ │ +0005f400: 2145 4e54 4954 5920 6e75 0922 2623 7830 !ENTITY nu."� │ │ │ +0005f410: 3342 443b 223e 203c 212d 2d20 4752 4545 3BD;"> . . . . .< │ │ │ +0005f510: 2145 4e54 4954 5920 5069 0922 2623 7830 !ENTITY Pi."� │ │ │ +0005f520: 3341 303b 223e 203c 212d 2d20 4752 4545 3A0;"> . │ │ │ +0005f560: 203c 212d 2d20 4752 4545 4b20 534d 414c │ │ │ +0005f580: 0a3c 2145 4e54 4954 5920 7268 6f76 0922 . . │ │ │ +0005f5d0: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c │ │ │ +0005f630: 0a3c 2145 4e54 4954 5920 7369 676d 6176 . . │ │ │ +0005f670: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c . │ │ │ +0005f690: 3c21 454e 5449 5459 2075 7073 6909 2226 . . . │ │ │ +0005f780: 203c 212d 2d20 4752 4545 4b20 5048 4920 . . . . . │ │ │ +0005f8a0: 3c21 2d2d 2047 5245 454b 2043 4150 4954 .....$demo/do │ │ │ +0005f8d0: 6373 7263 2f44 6f63 426f 6f6b 2f65 6e74 csrc/DocBook/ent │ │ │ +0005f8e0: 2f69 736f 2d67 726b 342e 656e 74df 0000 /iso-grk4.ent... │ │ │ +0005f8f0: 0a58 3c21 2d2d 2069 736f 2d67 726b 342e .X. │ │ │ +0005f940: 0a3c 212d 2d20 4465 7269 7665 6420 6672 ... .< │ │ │ +0005fa30: 2145 4e54 4954 5920 622e 6761 6d6d 6109 !ENTITY b.gamma. │ │ │ +0005fa40: 2226 2378 3033 4233 3b22 3e20 3c21 2d2d "γ"> . .< │ │ │ +0005fab0: 2145 4e54 4954 5920 622e 6761 6d6d 6164 !ENTITY b.gammad │ │ │ +0005fac0: 0922 2623 7830 3344 433b 223e 203c 212d ."Ϝ"> . . . │ │ │ +0005fb90: 0a3c 2145 4e54 4954 5920 622e 6570 7369 . . .< │ │ │ +0005fbe0: 2145 4e54 4954 5920 622e 7a65 7461 0922 !ENTITY b.zeta." │ │ │ +0005fbf0: 2623 7830 3342 363b 223e 203c 212d 2d20 ζ"> . . .< │ │ │ +0005fc80: 2145 4e54 4954 5920 622e 5468 6574 6109 !ENTITY b.Theta. │ │ │ +0005fc90: 2226 2378 3033 3938 3b22 3e20 3c21 2d2d "Θ"> . │ │ │ +0005fcc0: 3c21 454e 5449 5459 2062 2e74 6865 7461 . . . . . . │ │ │ +0005fe20: 3c21 454e 5449 5459 2062 2e6d 7509 2226 . . . │ │ │ +0005ff20: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c .< │ │ │ +0005ff40: 2145 4e54 4954 5920 622e 5069 0922 2623 !ENTITY b.Pi."&# │ │ │ +0005ff50: 7830 3341 303b 223e 203c 212d 2d20 4752 x03A0;"> . . . .< │ │ │ +00060020: 2145 4e54 4954 5920 622e 7369 676d 6109 !ENTITY b.sigma. │ │ │ +00060030: 2226 2378 3033 4333 3b22 3e20 3c21 2d2d "σ"> . .< │ │ │ +000600a0: 2145 4e54 4954 5920 622e 7369 676d 6176 !ENTITY b.sigmav │ │ │ +000600b0: 0922 2623 7830 3343 323b 223e 203c 212d ."ς"> . . . < │ │ │ +000601c0: 212d 2d20 4752 4545 4b20 4341 5049 5441 !-- GREEK CAPITA │ │ │ +000601d0: 4c20 4c45 5454 4552 2050 4849 202d 2d3e L LETTER PHI --> │ │ │ +000601e0: 0a3c 2145 4e54 4954 5920 622e 7068 6976 . . . . . .....$d │ │ │ +00060350: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ +00060360: 6f6b 2f65 6e74 2f69 736f 2d63 7972 322e ok/ent/iso-cyr2. │ │ │ +00060370: 656e 74df 0000 0775 3c21 2d2d 2069 736f ent....u... │ │ │ +00060450: 0a3c 2145 4e54 4954 5920 646a 6379 0922 . . . . . . │ │ │ +00060590: 3c21 454e 5449 5459 204a 756b 6379 0922 . . │ │ │ +00060630: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . │ │ │ +00060670: 3c21 2d2d 2043 5952 494c 4c49 4320 534d . . . . . │ │ │ +000607d0: 203c 212d 2d20 4359 5249 4c4c 4943 2043 . < │ │ │ +00060810: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ +00060820: 4c4c 204c 4554 5445 5220 4c4a 4520 2d2d LL LETTER LJE -- │ │ │ +00060830: 3e0a 3c21 454e 5449 5459 204c 4a63 7909 >. │ │ │ +00060870: 0a3c 2145 4e54 4954 5920 6e6a 6379 0922 . . . . . . . . .< │ │ │ +00060a70: 2145 4e54 4954 5920 647a 6379 0922 2623 !ENTITY dzcy."&# │ │ │ +00060a80: 7830 3435 463b 223e 203c 212d 2d20 4359 x045F;"> . .... │ │ │ +00060af0: 0024 6465 6d6f 2f64 6f63 7372 632f 446f .$demo/docsrc/Do │ │ │ +00060b00: 6342 6f6f 6b2f 656e 742f 6973 6f2d 6379 cBook/ent/iso-cy │ │ │ +00060b10: 7231 2e65 6e74 df00 0010 d63c 212d 2d20 r1.ent........ . . . . . . < │ │ │ +00060db0: 212d 2d20 4359 5249 4c4c 4943 2043 4150 !-- CYRILLIC CAP │ │ │ +00060dc0: 4954 414c 204c 4554 5445 5220 4748 4520 ITAL LETTER GHE │ │ │ +00060dd0: 2d2d 3e0a 3c21 454e 5449 5459 2064 6379 -->. .< │ │ │ +00060e10: 2145 4e54 4954 5920 4463 7909 2226 2378 !ENTITY Dcy."&#x │ │ │ +00060e20: 3034 3134 3b22 3e20 3c21 2d2d 2043 5952 0414;"> . . . │ │ │ +00060ee0: 3c21 2d2d 2043 5952 494c 4c49 4320 534d . │ │ │ +00060f40: 3c21 454e 5449 5459 207a 6863 7909 2226 . . . │ │ │ +00061010: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . . . . . . │ │ │ +00061180: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . .< │ │ │ +000611e0: 2145 4e54 4954 5920 4c63 7909 2226 2378 !ENTITY Lcy."&#x │ │ │ +000611f0: 3034 3142 3b22 3e20 3c21 2d2d 2043 5952 041B;"> . . │ │ │ +00061270: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . .< │ │ │ +000612d0: 2145 4e54 4954 5920 4e63 7909 2226 2378 !ENTITY Ncy."&#x │ │ │ +000612e0: 3034 3144 3b22 3e20 3c21 2d2d 2043 5952 041D;"> . . < │ │ │ +00061360: 212d 2d20 4359 5249 4c4c 4943 2043 4150 !-- CYRILLIC CAP │ │ │ +00061370: 4954 414c 204c 4554 5445 5220 4f20 2d2d ITAL LETTER O -- │ │ │ +00061380: 3e0a 3c21 454e 5449 5459 2070 6379 0922 >. . . . . . . . . . . │ │ │ +000615f0: 203c 212d 2d20 4359 5249 4c4c 4943 2053 . │ │ │ +00061650: 3c21 454e 5449 5459 206b 6863 7909 2226 . . . │ │ │ +00061720: 203c 212d 2d20 4359 5249 4c4c 4943 2043 . │ │ │ +00061760: 3c21 2d2d 2043 5952 494c 4c49 4320 534d .< │ │ │ +00061800: 2145 4e54 4954 5920 5348 6379 0922 2623 !ENTITY SHcy."&# │ │ │ +00061810: 7830 3432 383b 223e 203c 212d 2d20 4359 x0428;"> . .< │ │ │ +00061880: 2145 4e54 4954 5920 5348 4348 6379 0922 !ENTITY SHCHcy." │ │ │ +00061890: 2623 7830 3432 393b 223e 203c 212d 2d20 Щ"> . . . . .< │ │ │ +00061a10: 2145 4e54 4954 5920 534f 4654 6379 0922 !ENTITY SOFTcy." │ │ │ +00061a20: 2623 7830 3432 433b 223e 203c 212d 2d20 Ь"> . < │ │ │ +00061a70: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ +00061a80: 4c4c 204c 4554 5445 5220 4520 2d2d 3e0a LL LETTER E -->. │ │ │ +00061a90: 3c21 454e 5449 5459 2045 6379 0922 2623 . . . │ │ │ +00061b60: 3c21 2d2d 2043 5952 494c 4c49 4320 534d . │ │ │ +00061bc0: 3c21 454e 5449 5459 206e 756d 6572 6f09 │ │ │ +00061bf0: 0ab6 0000 0024 6465 6d6f 2f64 6f63 7372 .....$demo/docsr │ │ │ +00061c00: 632f 446f 6342 6f6f 6b2f 656e 742f 6973 c/DocBook/ent/is │ │ │ +00061c10: 6f2d 6c61 7431 2e65 6e74 df00 0011 c93c o-lat1.ent.....< │ │ │ +00061c20: 212d 2d20 6973 6f2d 6c61 7431 2e65 6e74 !-- iso-lat1.ent │ │ │ +00061c30: 2070 726f 6475 6365 6420 6279 204e 6f72 produced by Nor │ │ │ +00061c40: 6d61 6e20 5761 6c73 6820 666f 7220 7468 man Walsh for th │ │ │ +00061c50: 6520 584d 4c20 7665 7273 696f 6e20 6f66 e XML version of │ │ │ +00061c60: 2044 6f63 426f 6f6b 202d 2d3e 0a0a 3c21 DocBook -->.... . . < │ │ │ +00061da0: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ +00061db0: 4c45 5454 4552 2041 2057 4954 4820 4349 LETTER A WITH CI │ │ │ +00061dc0: 5243 554d 464c 4558 202d 2d3e 0a3c 2145 RCUMFLEX -->. . . . < │ │ │ +00061ec0: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ +00061ed0: 4c45 5454 4552 2041 2057 4954 4820 5249 LETTER A WITH RI │ │ │ +00061ee0: 4e47 2041 424f 5645 202d 2d3e 0a3c 2145 NG ABOVE -->. . . . . . < │ │ │ +00062070: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ +00062080: 4c45 5454 4552 2041 4520 2d2d 3e0a 3c21 LETTER AE -->. . │ │ │ +00062110: 0a3c 2145 4e54 4954 5920 4363 6564 696c . . . . . . │ │ │ +000623c0: 0a3c 2145 4e54 4954 5920 4575 6d6c 0922 . . .< │ │ │ +00062450: 2145 4e54 4954 5920 4961 6375 7465 0922 !ENTITY Iacute." │ │ │ +00062460: 2623 7830 3043 443b 223e 203c 212d 2d20 Í"> . │ │ │ +000624b0: 203c 212d 2d20 4c41 5449 4e20 534d 414c .< │ │ │ +000624e0: 2145 4e54 4954 5920 4963 6972 6309 2226 !ENTITY Icirc."& │ │ │ +000624f0: 2378 3030 4345 3b22 3e20 3c21 2d2d 204c #x00CE;"> . .< │ │ │ +00062570: 2145 4e54 4954 5920 4967 7261 7665 0922 !ENTITY Igrave." │ │ │ +00062580: 2623 7830 3043 433b 223e 203c 212d 2d20 Ì"> . │ │ │ +000625d0: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . . . . . . . . . . . < │ │ │ +000629f0: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ +00062a00: 4c20 4c45 5454 4552 204f 2057 4954 4820 L LETTER O WITH │ │ │ +00062a10: 4449 4145 5245 5349 5320 2d2d 3e0a 3c21 DIAERESIS -->. . . . . . │ │ │ +00062b80: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . . . < │ │ │ +00062ca0: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ +00062cb0: 4c45 5454 4552 2055 2057 4954 4820 4449 LETTER U WITH DI │ │ │ +00062cc0: 4145 5245 5349 5320 2d2d 3e0a 3c21 454e AERESIS -->. . │ │ │ +00062d30: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ +00062da0: 0a3c 2145 4e54 4954 5920 7975 6d6c 0922 . ......dem │ │ │ +00062df0: 6f2f 646f 6373 7263 2f44 6f63 426f 6f6b o/docsrc/DocBook │ │ │ +00062e00: 2f56 4552 5349 4f4e df00 0000 0633 2e31 /VERSION.....3.1 │ │ │ +00062e10: 2e37 0ab6 0000 001d 6465 6d6f 2f64 6f63 .7......demo/doc │ │ │ +00062e20: 7372 632f 446f 6342 6f6f 6b2f 4368 616e src/DocBook/Chan │ │ │ +00062e30: 6765 4c6f 67df 0000 21f8 3139 3939 2d31 geLog...!.1999-1 │ │ │ +00062e40: 312d 3130 2020 4e6f 726d 616e 2057 616c 1-10 Norman Wal │ │ │ +00062e50: 7368 2020 3c6e 6477 406e 7761 6c73 682e sh ...* COPYRIG │ │ │ +00062e70: 4854 2c20 5245 4144 4d45 2c20 6361 6c73 HT, README, cals │ │ │ +00062e80: 7462 6c78 2e64 7464 2c20 6462 6365 6e74 tblx.dtd, dbcent │ │ │ +00062e90: 782e 6d6f 642c 2064 6267 656e 656e 742e x.mod, dbgenent. │ │ │ +00062ea0: 656e 742c 2064 6268 6965 7278 2e6d 6f64 ent, dbhierx.mod │ │ │ +00062eb0: 2c20 6462 6e6f 746e 782e 6d6f 642c 2064 , dbnotnx.mod, d │ │ │ +00062ec0: 6270 6f6f 6c78 2e6d 6f64 2c20 646f 6362 bpoolx.mod, docb │ │ │ +00062ed0: 6f6f 6b78 2e64 7464 2c20 7465 7374 2e78 ookx.dtd, test.x │ │ │ +00062ee0: 6d6c 3a20 0a09 5570 6461 7465 6420 7665 ml: ..Updated ve │ │ │ +00062ef0: 7273 696f 6e20 6e75 6d62 6572 730a 0a09 rsion numbers... │ │ │ +00062f00: 2a20 5645 5253 494f 4e3a 2056 6572 7369 * VERSION: Versi │ │ │ +00062f10: 6f6e 2033 2e31 2e37 2072 656c 6561 7365 on 3.1.7 release │ │ │ +00062f20: 640a 0a09 2a20 6462 706f 6f6c 782e 6d6f d...* dbpoolx.mo │ │ │ +00062f30: 643a 2046 696e 616c 6c79 2077 726f 7465 d: Finally wrote │ │ │ +00062f40: 2061 2070 726f 6772 616d 2074 6f20 636f a program to co │ │ │ +00062f50: 6d70 6172 6520 7468 6520 5347 4d4c 2061 mpare the SGML a │ │ │ +00062f60: 6e64 2058 4d4c 2044 5444 732e 204f 6820 nd XML DTDs. Oh │ │ │ +00062f70: 6d79 210a 0941 6464 6564 2069 6e66 6f72 my!..Added infor │ │ │ +00062f80: 6d61 6c66 6967 7572 6520 746f 2061 206e malfigure to a n │ │ │ +00062f90: 756d 6265 7220 6f66 2063 6f6e 7465 7874 umber of context │ │ │ +00062fa0: 7320 7768 6572 6520 6974 2077 6173 206d s where it was m │ │ │ +00062fb0: 6973 7369 6e67 0a09 4368 616e 6765 6420 issing..Changed │ │ │ +00062fc0: 7468 6520 666f 726d 6174 2061 7474 7269 the format attri │ │ │ +00062fd0: 6275 7465 206f 6e20 6772 6170 6869 6373 bute on graphics │ │ │ +00062fe0: 2062 6163 6b20 696e 746f 2061 206e 6f74 back into a not │ │ │ +00062ff0: 6174 696f 6e20 6c69 7374 0a09 2020 2877 ation list.. (w │ │ │ +00063000: 6879 2068 6164 2049 206d 6164 6520 6974 hy had I made it │ │ │ +00063010: 2043 4441 5441 3f29 0a09 5477 6561 6b65 CDATA?)..Tweake │ │ │ +00063020: 6420 7468 6520 7061 7261 6d65 7465 7269 d the parameteri │ │ │ +00063030: 7a61 7469 6f6e 206f 6620 7461 626c 6520 zation of table │ │ │ +00063040: 6174 7472 6962 7574 6573 2c20 7468 6973 attributes, this │ │ │ +00063050: 2072 6573 746f 7265 7320 7468 6520 2772 restores the 'r │ │ │ +00063060: 6f6c 6527 0a09 2020 6174 7472 6962 7574 ole'.. attribut │ │ │ +00063070: 6520 746f 2027 656e 7472 7927 2c20 2772 e to 'entry', 'r │ │ │ +00063080: 6f77 272c 2061 6e64 2070 6572 6861 7073 ow', and perhaps │ │ │ +00063090: 2061 2066 6577 206f 7468 6572 2070 6c61 a few other pla │ │ │ +000630a0: 6365 7320 7768 6572 6520 6974 0a09 2020 ces where it.. │ │ │ +000630b0: 7761 7320 6d69 7373 696e 672e 0a09 4164 was missing...Ad │ │ │ +000630c0: 6465 6420 6a6f 7572 6e61 6c2c 2073 6572 ded journal, ser │ │ │ +000630d0: 6965 732c 2073 6574 2c20 616e 6420 6d61 ies, set, and ma │ │ │ +000630e0: 6e75 7363 7269 7074 2061 7320 7661 6c75 nuscript as valu │ │ │ +000630f0: 6573 2066 6f72 2074 6865 2070 7562 776f es for the pubwo │ │ │ +00063100: 726b 0a09 2020 6174 7472 6962 7574 6520 rk.. attribute │ │ │ +00063110: 6f6e 2063 6974 6574 6974 6c65 0a09 5265 on citetitle..Re │ │ │ +00063120: 6d6f 7665 6420 6578 7472 616e 656f 7573 moved extraneous │ │ │ +00063130: 2027 3f27 2066 726f 6d20 7468 6520 6465 '?' from the de │ │ │ +00063140: 636c 6172 6174 696f 6e20 666f 7220 696e claration for in │ │ │ +00063150: 6465 7874 6572 6d2e 2049 6e64 6578 7465 dexterm. Indexte │ │ │ +00063160: 726d 730a 0920 2061 7265 206e 6f74 2061 rms.. are not a │ │ │ +00063170: 6c6c 6f77 6564 2074 6f20 6265 2065 6d70 llowed to be emp │ │ │ +00063180: 7479 210a 0a31 3939 392d 3130 2d31 3920 ty!..1999-10-19 │ │ │ +00063190: 204e 6f72 6d61 6e20 5761 6c73 6820 203c Norman Walsh < │ │ │ +000631a0: 6e64 7740 6e77 616c 7368 2e63 6f6d 3e0a ndw@nwalsh.com>. │ │ │ +000631b0: 0a09 2a20 434f 5059 5249 4748 542c 2052 ..* COPYRIGHT, R │ │ │ +000631c0: 4541 444d 452c 2063 616c 7374 626c 782e EADME, calstblx. │ │ │ +000631d0: 6474 642c 2064 6263 656e 7478 2e6d 6f64 dtd, dbcentx.mod │ │ │ +000631e0: 2c20 6462 6765 6e65 6e74 2e65 6e74 2c20 , dbgenent.ent, │ │ │ +000631f0: 6462 6869 6572 782e 6d6f 642c 2064 626e dbhierx.mod, dbn │ │ │ +00063200: 6f74 6e78 2e6d 6f64 2c20 6462 706f 6f6c otnx.mod, dbpool │ │ │ +00063210: 782e 6d6f 642c 2064 6f63 626f 6f6b 782e x.mod, docbookx. │ │ │ +00063220: 6474 642c 2074 6573 742e 786d 6c3a 200a dtd, test.xml: . │ │ │ +00063230: 0955 7064 6174 6564 2076 6572 7369 6f6e .Updated version │ │ │ +00063240: 206e 756d 6265 7273 0a0a 092a 2056 4552 numbers...* VER │ │ │ +00063250: 5349 4f4e 3a20 5665 7273 696f 6e20 332e SION: Version 3. │ │ │ +00063260: 312e 3620 7265 6c65 6173 6564 0a0a 092a 1.6 released...* │ │ │ +00063270: 2064 6268 6965 7278 2e6d 6f64 2c20 6462 dbhierx.mod, db │ │ │ +00063280: 706f 6f6c 782e 6d6f 643a 2041 6464 6564 poolx.mod: Added │ │ │ +00063290: 206d 6973 7369 6e67 206d 6564 6961 6f62 missing mediaob │ │ │ +000632a0: 6a65 6374 2f69 6e6c 696e 656d 6564 6961 ject/inlinemedia │ │ │ +000632b0: 6f62 6a65 6374 2065 6c65 6d65 6e74 730a object elements. │ │ │ +000632c0: 0a09 2a20 736f 6578 7462 6c78 2e64 7464 ..* soextblx.dtd │ │ │ +000632d0: 3a20 4f66 6669 6369 616c 204f 4153 4953 : Official OASIS │ │ │ +000632e0: 2074 6162 6c65 206d 6f64 656c 3a20 5452 table model: TR │ │ │ +000632f0: 3939 3031 3a31 3939 390a 0a31 3939 392d 9901:1999..1999- │ │ │ +00063300: 3038 2d32 3620 204e 6f72 6d61 6e20 5761 08-26 Norman Wa │ │ │ +00063310: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* COPYRI │ │ │ +00063330: 4748 542c 2052 4541 444d 452c 2063 616c GHT, README, cal │ │ │ +00063340: 7374 626c 782e 6474 642c 2064 6263 656e stblx.dtd, dbcen │ │ │ +00063350: 7478 2e6d 6f64 2c20 6462 6765 6e65 6e74 tx.mod, dbgenent │ │ │ +00063360: 2e65 6e74 2c20 6462 6869 6572 782e 6d6f .ent, dbhierx.mo │ │ │ +00063370: 642c 2064 626e 6f74 6e78 2e6d 6f64 2c20 d, dbnotnx.mod, │ │ │ +00063380: 6462 706f 6f6c 782e 6d6f 642c 2064 6f63 dbpoolx.mod, doc │ │ │ +00063390: 626f 6f6b 782e 6474 642c 2073 6f65 7874 bookx.dtd, soext │ │ │ +000633a0: 626c 782e 6474 642c 2074 6573 742e 786d blx.dtd, test.xm │ │ │ +000633b0: 6c3a 200a 0955 7064 6174 6564 2076 6572 l: ..Updated ver │ │ │ +000633c0: 7369 6f6e 206e 756d 6265 720a 0a09 2a20 sion number...* │ │ │ +000633d0: 5645 5253 494f 4e3a 2056 6572 7369 6f6e VERSION: Version │ │ │ +000633e0: 2033 2e31 2e35 2072 656c 6561 7365 640a 3.1.5 released. │ │ │ +000633f0: 0a09 2a20 6462 706f 6f6c 782e 6d6f 643a ..* dbpoolx.mod: │ │ │ +00063400: 2046 6978 6564 2061 206e 756d 6265 7220 Fixed a number │ │ │ +00063410: 6f66 2065 7272 6f6e 656f 7573 2063 6f6d of erroneous com │ │ │ +00063420: 6d65 6e74 730a 0941 6464 6564 2063 6f6e ments..Added con │ │ │ +00063430: 7374 616e 7420 616e 6420 7661 726e 616d stant and varnam │ │ │ +00063440: 6520 746f 2074 6563 682e 6368 6172 2e63 e to tech.char.c │ │ │ +00063450: 6c61 7373 0a09 4368 616e 6765 6420 2256 lass..Changed "V │ │ │ +00063460: 6172 4e61 6d65 2220 746f 2022 7661 726e arName" to "varn │ │ │ +00063470: 616d 6522 0a09 4368 616e 6765 6420 2561 ame"..Changed %a │ │ │ +00063480: 7267 7061 6765 6e75 6d73 2074 6f20 2561 rgpagenums to %a │ │ │ +00063490: 7274 7061 6765 6e75 6d73 0a0a 3139 3939 rtpagenums..1999 │ │ │ +000634a0: 2d30 362d 3034 2020 4e6f 726d 616e 2057 -06-04 Norman W │ │ │ +000634b0: 616c 7368 2020 3c6e 6477 406e 7761 6c73 alsh ...* COPYR │ │ │ +000634d0: 4947 4854 2c20 5245 4144 4d45 2c20 6361 IGHT, README, ca │ │ │ +000634e0: 6c73 7462 6c78 2e64 7464 2c20 6462 6365 lstblx.dtd, dbce │ │ │ +000634f0: 6e74 782e 6d6f 642c 2064 6267 656e 656e ntx.mod, dbgenen │ │ │ +00063500: 742e 656e 742c 2064 6268 6965 7278 2e6d t.ent, dbhierx.m │ │ │ +00063510: 6f64 2c20 6462 6e6f 746e 782e 6d6f 642c od, dbnotnx.mod, │ │ │ +00063520: 2064 6270 6f6f 6c78 2e6d 6f64 2c20 646f dbpoolx.mod, do │ │ │ +00063530: 6362 6f6f 6b78 2e64 7464 2c20 736f 6578 cbookx.dtd, soex │ │ │ +00063540: 7462 6c78 2e64 7464 2c20 7465 7374 2e78 tblx.dtd, test.x │ │ │ +00063550: 6d6c 3a20 0a09 5570 6461 7465 6420 7665 ml: ..Updated ve │ │ │ +00063560: 7273 696f 6e20 6e75 6d62 6572 730a 0a09 rsion numbers... │ │ │ +00063570: 2a20 5645 5253 494f 4e3a 2056 6572 7369 * VERSION: Versi │ │ │ +00063580: 6f6e 2033 2e31 2e34 2072 656c 6561 7365 on 3.1.4 release │ │ │ +00063590: 640a 0a09 2a20 6462 6869 6572 782e 6d6f d...* dbhierx.mo │ │ │ +000635a0: 643a 204d 6164 6520 6172 7468 6561 6465 d: Made artheade │ │ │ +000635b0: 7220 6f70 7469 6f6e 616c 0a0a 092a 2064 r optional...* d │ │ │ +000635c0: 6270 6f6f 6c78 2e6d 6f64 3a20 4669 7820 bpoolx.mod: Fix │ │ │ +000635d0: 636f 6d6d 6f6e 2061 7474 7269 6275 7465 common attribute │ │ │ +000635e0: 2070 726f 626c 656d 206f 6e20 696e 666f problem on info │ │ │ +000635f0: 726d 616c 7461 626c 6520 6120 6469 6666 rmaltable a diff │ │ │ +00063600: 6572 656e 7420 7761 790a 0a09 2a20 6462 erent way...* db │ │ │ +00063610: 706f 6f6c 782e 6d6f 643a 2054 6865 2063 poolx.mod: The c │ │ │ +00063620: 6f6d 6d6f 6e2e 6174 7472 6962 2050 4520 ommon.attrib PE │ │ │ +00063630: 7761 7320 6d69 7373 696e 6720 6672 6f6d was missing from │ │ │ +00063640: 2069 6e66 6f72 6d61 6c74 6162 6c65 0a0a informaltable.. │ │ │ +00063650: 092a 2064 6270 6f6f 6c78 2e6d 6f64 3a20 .* dbpoolx.mod: │ │ │ +00063660: 5265 666f 726d 756c 6174 6564 2070 6172 Reformulated par │ │ │ +00063670: 616d 6574 6572 697a 6174 696f 6e20 6f66 ameterization of │ │ │ +00063680: 2074 6162 6c65 2061 7474 7269 6275 7465 table attribute │ │ │ +00063690: 7320 2861 6761 696e 2920 746f 2067 6574 s (again) to get │ │ │ +000636a0: 2069 7420 7269 6768 742e 0a0a 092a 2064 it right....* d │ │ │ +000636b0: 6274 626c 6361 6c73 2e64 7464 2c20 6462 btblcals.dtd, db │ │ │ +000636c0: 7462 6c78 6368 672e 6474 642c 2074 626c tblxchg.dtd, tbl │ │ │ +000636d0: 6361 6c73 2e78 6d6c 2c20 7462 6c78 6368 cals.xml, tblxch │ │ │ +000636e0: 672e 786d 6c3a 200a 094e 6577 2066 696c g.xml: ..New fil │ │ │ +000636f0: 652e 0a0a 3139 3939 2d30 332d 3331 2020 e...1999-03-31 │ │ │ +00063700: 4e6f 726d 616e 2057 616c 7368 2020 3c6e Norman Walsh .. │ │ │ +00063720: 092a 2043 4f50 5952 4947 4854 2c20 5245 .* COPYRIGHT, RE │ │ │ +00063730: 4144 4d45 2c20 6361 6c73 7462 6c78 2e64 ADME, calstblx.d │ │ │ +00063740: 7464 2c20 6462 6365 6e74 782e 6d6f 642c td, dbcentx.mod, │ │ │ +00063750: 2064 6267 656e 656e 742e 656e 742c 2064 dbgenent.ent, d │ │ │ +00063760: 6268 6965 7278 2e6d 6f64 2c20 6462 6e6f bhierx.mod, dbno │ │ │ +00063770: 746e 782e 6d6f 642c 2064 6270 6f6f 6c78 tnx.mod, dbpoolx │ │ │ +00063780: 2e6d 6f64 2c20 646f 6362 6f6f 6b78 2e64 .mod, docbookx.d │ │ │ +00063790: 7464 2c20 736f 6578 7462 6c78 2e64 7464 td, soextblx.dtd │ │ │ +000637a0: 2c20 7465 7374 2e78 6d6c 3a20 0a09 4368 , test.xml: ..Ch │ │ │ +000637b0: 616e 6765 6420 7665 7273 696f 6e20 6e75 anged version nu │ │ │ +000637c0: 6d62 6572 2074 6f20 332e 312e 330a 0a09 mber to 3.1.3... │ │ │ +000637d0: 2a20 5645 5253 494f 4e3a 2056 6572 7369 * VERSION: Versi │ │ │ +000637e0: 6f6e 2033 2e31 2e33 2072 656c 6561 7365 on 3.1.3 release │ │ │ +000637f0: 640a 0a09 2a20 6462 6869 6572 782e 6d6f d...* dbhierx.mo │ │ │ +00063800: 642c 2064 6270 6f6f 6c78 2e6d 6f64 2c20 d, dbpoolx.mod, │ │ │ +00063810: 646f 6362 6f6f 6b78 2e64 7464 3a20 4164 docbookx.dtd: Ad │ │ │ +00063820: 6465 6420 7061 7261 6d2e 2065 6e74 2e20 ded param. ent. │ │ │ +00063830: 6465 636c 732e 2074 6f20 6d61 6b65 2049 decls. to make I │ │ │ +00063840: 4535 2068 6170 7079 2e0a 0a31 3939 392d E5 happy...1999- │ │ │ +00063850: 3033 2d31 3920 204e 6f72 6d61 6e20 5761 03-19 Norman Wa │ │ │ +00063860: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* COPYRI │ │ │ +00063880: 4748 542c 2052 4541 444d 452c 2063 616c GHT, README, cal │ │ │ +00063890: 7374 626c 782e 6474 642c 2064 6263 656e stblx.dtd, dbcen │ │ │ +000638a0: 7478 2e6d 6f64 2c20 6462 6765 6e65 6e74 tx.mod, dbgenent │ │ │ +000638b0: 2e65 6e74 2c20 6462 6869 6572 782e 6d6f .ent, dbhierx.mo │ │ │ +000638c0: 642c 2064 626e 6f74 6e78 2e6d 6f64 2c20 d, dbnotnx.mod, │ │ │ +000638d0: 6462 706f 6f6c 782e 6d6f 642c 2064 6f63 dbpoolx.mod, doc │ │ │ +000638e0: 626f 6f6b 782e 6474 642c 2073 6f65 7874 bookx.dtd, soext │ │ │ +000638f0: 626c 782e 6474 642c 2074 6573 742e 786d blx.dtd, test.xm │ │ │ +00063900: 6c3a 200a 0955 7064 6174 6564 2076 6572 l: ..Updated ver │ │ │ +00063910: 7369 6f6e 206e 756d 6265 7220 746f 2033 sion number to 3 │ │ │ +00063920: 2e31 2e32 0a0a 092a 2056 4552 5349 4f4e .1.2...* VERSION │ │ │ +00063930: 3a20 5665 7273 696f 6e20 332e 312e 3220 : Version 3.1.2 │ │ │ +00063940: 7265 6c65 6173 6564 0a0a 092a 2064 6270 released...* dbp │ │ │ +00063950: 6f6f 6c78 2e6d 6f64 3a20 4368 616e 6765 oolx.mod: Change │ │ │ +00063960: 6420 6d79 206d 696e 642c 2043 414c 5320 d my mind, CALS │ │ │ +00063970: 6861 7320 746f 2062 6520 7468 6520 6465 has to be the de │ │ │ +00063980: 6661 756c 7420 7461 626c 6520 6d6f 6465 fault table mode │ │ │ +00063990: 6c0a 0a31 3939 392d 3033 2d31 3720 204e l..1999-03-17 N │ │ │ +000639a0: 6f72 6d61 6e20 5761 6c73 6820 203c 6e64 orman Walsh ... │ │ │ +000639c0: 2a20 5245 4144 4d45 3a20 5570 6461 7465 * README: Update │ │ │ +000639d0: 6420 6d61 6e69 6665 7374 0a0a 092a 2056 d manifest...* V │ │ │ +000639e0: 4552 5349 4f4e 3a20 5665 7273 696f 6e20 ERSION: Version │ │ │ +000639f0: 332e 312e 3120 7265 6c65 6173 6564 0a09 3.1.1 released.. │ │ │ +00063a00: 0a09 5468 6973 2072 656c 6561 7365 2069 ..This release i │ │ │ +00063a10: 6e74 726f 6475 6365 7320 7365 7665 7261 ntroduces severa │ │ │ +00063a20: 6c20 7369 676e 6966 6963 616e 7420 6368 l significant ch │ │ │ +00063a30: 616e 6765 733a 0a09 0a09 2d20 416e 2058 anges:....- An X │ │ │ +00063a40: 4d4c 2076 6572 7369 6f6e 206f 6620 7468 ML version of th │ │ │ +00063a50: 6520 4f41 5349 5320 4578 6368 616e 6765 e OASIS Exchange │ │ │ +00063a60: 2054 6162 6c65 204d 6f64 656c 0a09 2020 Table Model.. │ │ │ +00063a70: 6973 2075 7365 6420 696e 2066 6176 6f72 is used in favor │ │ │ +00063a80: 206f 6620 7468 6520 6675 6c6c 2043 414c of the full CAL │ │ │ +00063a90: 5320 6d6f 6465 6c2e 2054 6869 7320 6361 S model. This ca │ │ │ +00063aa0: 6e0a 0920 2062 6520 2274 6f67 676c 6564 n.. be "toggled │ │ │ +00063ab0: 2220 6261 636b 2077 6974 6820 6120 7369 " back with a si │ │ │ +00063ac0: 6e67 6c65 2070 6172 616d 6574 6572 2065 ngle parameter e │ │ │ +00063ad0: 6e74 6974 790a 0920 2063 6861 6e67 650a ntity.. change. │ │ │ +00063ae0: 090a 092d 2054 6865 2076 6572 7369 6f6e ...- The version │ │ │ +00063af0: 206e 756d 6265 7220 6861 7320 6368 616e number has chan │ │ │ +00063b00: 6765 6420 6472 616d 6174 6963 616c 6c79 ged dramatically │ │ │ +00063b10: 2074 6f20 6d61 6b65 0a09 2020 6974 2063 to make.. it c │ │ │ +00063b20: 6c65 6172 2074 6861 7420 6974 2074 7261 lear that it tra │ │ │ +00063b30: 636b 7320 332e 312e 2020 2856 6572 7369 cks 3.1. (Versi │ │ │ +00063b40: 6f6e 2031 2e33 206f 6620 7468 650a 0920 on 1.3 of the.. │ │ │ +00063b50: 2058 4d4c 2076 6572 7369 6f6e 206f 6620 XML version of │ │ │ +00063b60: 446f 6342 6f6f 6b20 332e 3120 7761 7320 DocBook 3.1 was │ │ │ +00063b70: 6a75 7374 2074 6f6f 2063 6f6e 6675 7369 just too confusi │ │ │ +00063b80: 6e67 2129 0a09 0a09 2d20 4920 6164 6465 ng!)....- I adde │ │ │ +00063b90: 6420 7061 7261 6d65 7465 7220 656e 7469 d parameter enti │ │ │ +00063ba0: 7469 6573 2074 6f20 696e 636c 7564 652f ties to include/ │ │ │ +00063bb0: 6578 636c 7564 6520 7468 650a 0920 2064 exclude the.. d │ │ │ +00063bc0: 6263 656e 7478 2e6d 6f64 2061 6e64 2064 bcentx.mod and d │ │ │ +00063bd0: 626e 6f74 6e78 2e6d 6f64 206d 6f64 756c bnotnx.mod modul │ │ │ +00063be0: 6573 2061 6c6c 2061 7420 6f6e 6365 0a09 es all at once.. │ │ │ +00063bf0: 0a09 2d20 4669 7865 6420 6120 6665 7720 ..- Fixed a few │ │ │ +00063c00: 736d 616c 6c20 636f 6e74 656e 7420 6d6f small content mo │ │ │ +00063c10: 6465 6c20 6275 6773 0a0a 092a 2064 6f63 del bugs...* doc │ │ │ +00063c20: 626f 6f6b 782e 6474 643a 2041 6464 6564 bookx.dtd: Added │ │ │ +00063c30: 206d 6172 6b65 6420 7365 6374 696f 6e73 marked sections │ │ │ +00063c40: 2061 726f 756e 6420 6462 6e6f 746e 2061 around dbnotn a │ │ │ +00063c50: 6e64 2064 6263 656e 7420 6d6f 6475 6c65 nd dbcent module │ │ │ +00063c60: 730a 0a31 3939 392d 3033 2d31 3620 204e s..1999-03-16 N │ │ │ +00063c70: 6f72 6d61 6e20 5761 6c73 6820 203c 6e64 orman Walsh ... │ │ │ +00063c90: 2a20 6462 706f 6f6c 782e 6d6f 643a 2049 * dbpoolx.mod: I │ │ │ +00063ca0: 6e20 7468 6520 584d 4c20 6578 6368 616e n the XML exchan │ │ │ +00063cb0: 6765 2074 6162 6c65 206d 6f64 656c 2063 ge table model c │ │ │ +00063cc0: 6173 652c 2074 6865 2061 7474 6c69 7374 ase, the attlist │ │ │ +00063cd0: 2066 6f72 2069 6e66 6f72 6d61 6c74 6162 for informaltab │ │ │ +00063ce0: 6c65 2077 6173 2077 726f 6e67 0a0a 3139 le was wrong..19 │ │ │ +00063cf0: 3939 2d30 332d 3131 2020 4e6f 726d 616e 99-03-11 Norman │ │ │ +00063d00: 2057 616c 7368 2020 3c6e 6477 406e 7761 Walsh ...* cal │ │ │ +00063d20: 7374 626c 782e 6474 643a 2052 656d 6f76 stblx.dtd: Remov │ │ │ +00063d30: 6564 2075 6e75 7365 6420 5045 730a 0a09 ed unused PEs... │ │ │ +00063d40: 2a20 6462 706f 6f6c 782e 6d6f 643a 2041 * dbpoolx.mod: A │ │ │ +00063d50: 6464 6564 2073 7769 7463 6820 666f 7220 dded switch for │ │ │ +00063d60: 6578 6368 616e 6765 206f 7220 4341 4c53 exchange or CALS │ │ │ +00063d70: 2074 6162 6c65 206d 6f64 656c 3b20 6d61 table model; ma │ │ │ +00063d80: 6465 2065 7863 6861 6e67 6520 7468 6520 de exchange the │ │ │ +00063d90: 6465 6661 756c 740a 0a09 2a20 736f 6578 default...* soex │ │ │ +00063da0: 7462 6c78 2e64 7464 3a20 4e65 7720 6669 tblx.dtd: New fi │ │ │ +00063db0: 6c65 2e0a 0a31 3939 392d 3033 2d30 3620 le...1999-03-06 │ │ │ +00063dc0: 204e 6f72 6d61 6e20 5761 6c73 6820 203c Norman Walsh < │ │ │ +00063dd0: 6e64 7740 6e77 616c 7368 2e63 6f6d 3e0a ndw@nwalsh.com>. │ │ │ +00063de0: 0a09 2a20 434f 5059 5249 4748 542c 2052 ..* COPYRIGHT, R │ │ │ +00063df0: 4541 444d 452c 2063 616c 7374 626c 782e EADME, calstblx. │ │ │ +00063e00: 6474 642c 2064 6267 656e 656e 742e 656e dtd, dbgenent.en │ │ │ +00063e10: 742c 2064 6f63 626f 6f6b 782e 6474 643a t, docbookx.dtd: │ │ │ +00063e20: 200a 0943 6861 6e67 6564 2076 6572 7369 ..Changed versi │ │ │ +00063e30: 6f6e 206e 756d 6265 7220 746f 2033 2e31 on number to 3.1 │ │ │ +00063e40: 2e31 0a0a 092a 2063 6861 6e67 6573 3a20 .1...* changes: │ │ │ +00063e50: 5265 706c 6163 6564 2062 7920 4368 616e Replaced by Chan │ │ │ +00063e60: 6765 4c6f 670a 0a09 2a20 6462 3378 6d6c geLog...* db3xml │ │ │ +00063e70: 2e64 7464 2c20 646f 6362 6f6f 6b78 2e64 .dtd, docbookx.d │ │ │ +00063e80: 7464 3a20 5265 6e61 6d65 6420 6462 3378 td: Renamed db3x │ │ │ +00063e90: 6d6c 2e64 7464 2074 6f20 646f 6362 6f6f ml.dtd to docboo │ │ │ +00063ea0: 6b78 2e64 7464 0a0a 092a 2064 6263 656e kx.dtd...* dbcen │ │ │ +00063eb0: 7478 2e6d 6f64 3a20 4669 7865 6420 6272 tx.mod: Fixed br │ │ │ +00063ec0: 6f6b 656e 2070 7562 6c69 6320 6964 656e oken public iden │ │ │ +00063ed0: 7469 6669 6572 732e 2043 6861 6e67 6564 tifiers. Changed │ │ │ +00063ee0: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ +00063ef0: 746f 2033 2e31 2e31 0a0a 092a 2064 6268 to 3.1.1...* dbh │ │ │ +00063f00: 6965 7278 2e6d 6f64 3a20 4669 7865 6420 ierx.mod: Fixed │ │ │ +00063f10: 6275 673a 2061 6464 6564 2073 6563 7469 bug: added secti │ │ │ +00063f20: 6f6e 2074 6f20 2562 6f6f 6b63 6f6d 706f on to %bookcompo │ │ │ +00063f30: 6e65 6e74 2e63 6f6e 7465 6e74 3b0a 0943 nent.content;..C │ │ │ +00063f40: 6861 6e67 6564 2076 6572 7369 6f6e 206e hanged version n │ │ │ +00063f50: 756d 6265 7220 746f 2033 2e31 2e31 2e0a umber to 3.1.1.. │ │ │ +00063f60: 0a09 2a20 6462 6e6f 746e 782e 6d6f 643a ..* dbnotnx.mod: │ │ │ +00063f70: 2043 6861 6e67 6564 2074 6865 2050 5542 Changed the PUB │ │ │ +00063f80: 4c49 4320 6964 656e 7469 6669 6572 7320 LIC identifiers │ │ │ +00063f90: 7468 6174 2077 6572 6520 6a75 7374 2061 that were just a │ │ │ +00063fa0: 2073 696e 676c 6520 776f 7264 2028 6c69 single word (li │ │ │ +00063fb0: 6b65 0a09 2244 4954 524f 4646 2229 2062 ke.."DITROFF") b │ │ │ +00063fc0: 6163 6b20 696e 746f 2053 5953 5445 4d20 ack into SYSTEM │ │ │ +00063fd0: 6964 656e 7469 6669 6572 732e 2020 4920 identifiers. I │ │ │ +00063fe0: 646f 6e27 7420 6b6e 6f77 2077 6879 2049 don't know why I │ │ │ +00063ff0: 206d 6164 650a 0974 6865 2050 5542 4c49 made..the PUBLI │ │ │ +00064000: 4320 696e 2074 6865 2066 6972 7374 2070 C in the first p │ │ │ +00064010: 6c61 6365 2e0a 0943 6861 6e67 6564 2076 lace...Changed v │ │ │ +00064020: 6572 7369 6f6e 206e 756d 6265 7220 746f ersion number to │ │ │ +00064030: 2033 2e31 2e31 0a0a 092a 2064 6270 6f6f 3.1.1...* dbpoo │ │ │ +00064040: 6c78 2e6d 6f64 3a20 4669 7865 6420 6275 lx.mod: Fixed bu │ │ │ +00064050: 673a 2061 6464 6564 2071 616e 6461 7365 g: added qandase │ │ │ +00064060: 7420 746f 2025 636f 6d70 6f75 6e64 2e63 t to %compound.c │ │ │ +00064070: 6c61 7373 3b0a 0946 6978 6564 2062 7567 lass;..Fixed bug │ │ │ +00064080: 3a20 6164 6465 6420 6369 7465 7469 746c : added citetitl │ │ │ +00064090: 6520 746f 2025 6269 626c 696f 636f 6d70 e to %bibliocomp │ │ │ +000640a0: 6f6e 656e 742e 6d69 783b 0a09 4368 616e onent.mix;..Chan │ │ │ +000640b0: 6765 6420 7665 7273 696f 6e20 746f 2033 ged version to 3 │ │ │ +000640c0: 2e31 2e31 0a0a 092a 2074 6573 742e 786d .1.1...* test.xm │ │ │ +000640d0: 6c3a 2043 6861 6e67 6564 2076 6572 7369 l: Changed versi │ │ │ +000640e0: 6f6e 206e 756d 6265 7220 746f 2033 2e31 on number to 3.1 │ │ │ +000640f0: 2e31 3b20 6368 616e 6765 6420 7379 7374 .1; changed syst │ │ │ +00064100: 656d 2069 6465 6e74 6966 6965 720a 0a31 em identifier..1 │ │ │ +00064110: 3939 392d 3031 2d33 3120 204e 6f72 6d61 999-01-31 Norma │ │ │ +00064120: 6e20 5761 6c73 6820 203c 6e64 7740 6e77 n Walsh ...* CO │ │ │ +00064140: 5059 5249 4748 542c 2052 4541 444d 452c PYRIGHT, README, │ │ │ +00064150: 2063 616c 7374 626c 782e 6474 642c 2064 calstblx.dtd, d │ │ │ +00064160: 6233 786d 6c2e 6474 642c 2064 6263 656e b3xml.dtd, dbcen │ │ │ +00064170: 7478 2e6d 6f64 2c20 6462 6765 6e65 6e74 tx.mod, dbgenent │ │ │ +00064180: 2e65 6e74 2c20 6462 6869 6572 782e 6d6f .ent, dbhierx.mo │ │ │ +00064190: 642c 2064 626e 6f74 6e78 2e6d 6f64 2c20 d, dbnotnx.mod, │ │ │ +000641a0: 6462 706f 6f6c 782e 6d6f 642c 2074 6573 dbpoolx.mod, tes │ │ │ +000641b0: 742e 786d 6c3a 200a 0943 6f6e 7665 7274 t.xml: ..Convert │ │ │ +000641c0: 6564 2076 6572 7369 6f6e 2074 6f20 312e ed version to 1. │ │ │ +000641d0: 330a 0a09 2a20 5645 5253 494f 4e3a 2056 3...* VERSION: V │ │ │ +000641e0: 6572 7369 6f6e 2031 2e33 2072 656c 6561 ersion 1.3 relea │ │ │ +000641f0: 7365 642e 0a09 4261 7365 6420 6f6e 2044 sed...Based on D │ │ │ +00064200: 6f63 426f 6f6b 2033 2e31 2e0a 0950 7562 ocBook 3.1...Pub │ │ │ +00064210: 6c69 6320 6964 656e 7469 6669 6572 7320 lic identifiers │ │ │ +00064220: 6e6f 7720 636f 6e74 6169 6e20 7468 6520 now contain the │ │ │ +00064230: 7374 7269 6e67 2022 446f 6342 6b20 584d string "DocBk XM │ │ │ +00064240: 4c22 2069 6e73 7465 6164 206f 660a 096a L" instead of..j │ │ │ +00064250: 7573 7420 2244 6f63 426b 3330 2058 4d4c ust "DocBk30 XML │ │ │ +00064260: 222e 0a0a 092a 2064 6233 786d 6c2e 6474 "....* db3xml.dt │ │ │ +00064270: 643a 2041 6464 6564 2064 626e 6f74 6e78 d: Added dbnotnx │ │ │ +00064280: 2e6d 6f64 3b20 6164 6465 6420 6e6f 7461 .mod; added nota │ │ │ +00064290: 7469 6f6e 7320 6261 636b 2069 6e74 6f20 tions back into │ │ │ +000642a0: 7468 6520 4454 442e 2020 4e6f 7461 7469 the DTD. Notati │ │ │ +000642b0: 6f6e 7320 646f 6e27 740a 0972 6571 7569 ons don't..requi │ │ │ +000642c0: 7265 2073 7973 7465 6d20 6964 656e 7469 re system identi │ │ │ +000642d0: 6669 6572 732c 2073 6f20 7468 6520 7075 fiers, so the pu │ │ │ +000642e0: 626c 6963 2049 4473 2077 696c 6c20 6265 blic IDs will be │ │ │ +000642f0: 206a 7573 7420 6669 6e65 2e0a 090a 094d just fine.....M │ │ │ +00064300: 6f76 6564 2049 534f 2063 6861 7261 6374 oved ISO charact │ │ │ +00064310: 6572 2065 6e74 6974 7920 6465 636c 6172 er entity declar │ │ │ +00064320: 6174 696f 6e73 2069 6e74 6f20 6462 6365 ations into dbce │ │ │ +00064330: 6e74 782e 6d6f 642e 2020 4164 6465 640a ntx.mod. Added. │ │ │ +00064340: 0955 6e69 636f 6465 2076 6572 7369 6f6e .Unicode version │ │ │ +00064350: 7320 6f66 2074 6865 2065 6e74 6974 7920 s of the entity │ │ │ +00064360: 7365 7473 2074 6f20 7468 6520 6469 7374 sets to the dist │ │ │ +00064370: 7269 6275 7469 6f6e 2e0a 0a09 2a20 6462 ribution....* db │ │ │ +00064380: 6365 6e74 782e 6d6f 642c 2064 626e 6f74 centx.mod, dbnot │ │ │ +00064390: 6e78 2e6d 6f64 3a20 4e65 7720 6669 6c65 nx.mod: New file │ │ │ +000643a0: 2e0a 0a09 2a20 6462 6869 6572 782e 6d6f ....* dbhierx.mo │ │ │ +000643b0: 643a 2043 6f6e 7665 7274 6564 2074 6f20 d: Converted to │ │ │ +000643c0: 446f 6342 6f6f 6b20 332e 313a 0a09 0a09 DocBook 3.1:.... │ │ │ +000643d0: 2d20 4164 6420 2766 6171 2720 6173 2061 - Add 'faq' as a │ │ │ +000643e0: 2063 6c61 7373 2076 616c 7565 2074 6f20 class value to │ │ │ +000643f0: 4172 7469 636c 650a 092d 2043 6c65 616e Article..- Clean │ │ │ +00064400: 6564 2075 702c 2061 6e64 2073 6967 6e69 ed up, and signi │ │ │ +00064410: 6669 6361 6e74 6c79 206c 6f6f 7365 6e65 ficantly loosene │ │ │ +00064420: 642c 2074 6865 2063 6f6e 7465 6e74 206d d, the content m │ │ │ +00064430: 6f64 656c 206f 6620 426f 6f6b 2e0a 092d odel of Book...- │ │ │ +00064440: 2041 6464 6564 2043 6f6c 6f70 686f 6e20 Added Colophon │ │ │ +00064450: 746f 2042 6f6f 6b2e 0a09 2d20 4164 6420 to Book...- Add │ │ │ +00064460: 4c69 6e6b 456e 6420 746f 204c 6f54 456e LinkEnd to LoTEn │ │ │ +00064470: 7472 792e 0a09 2d20 5365 7473 2061 7265 try...- Sets are │ │ │ +00064480: 206e 6f20 6c6f 6e67 6572 2072 6571 7569 no longer requi │ │ │ +00064490: 7265 6420 746f 2063 6f6e 7461 696e 2061 red to contain a │ │ │ +000644a0: 7420 6c65 6173 7420 7477 6f20 626f 6f6b t least two book │ │ │ +000644b0: 732e 0a09 2d20 4164 6465 6420 7265 6375 s...- Added recu │ │ │ +000644c0: 7273 6976 6520 4469 7669 7369 6f6e 732e rsive Divisions. │ │ │ +000644d0: 0a09 2d20 4164 6465 6420 5375 6274 6974 ..- Added Subtit │ │ │ +000644e0: 6c65 2074 6f20 6469 7669 7369 6f6e 7320 le to divisions │ │ │ +000644f0: 2853 6574 2c20 426f 6f6b 2c20 6574 632e (Set, Book, etc. │ │ │ +00064500: 292c 2063 6f6d 706f 6e65 6e74 732c 2061 ), components, a │ │ │ +00064510: 6e64 0a09 2020 7365 6374 696f 6e73 2e20 nd.. sections. │ │ │ +00064520: 2049 7420 6d61 7920 6f63 6375 7220 6f75 It may occur ou │ │ │ +00064530: 7473 6964 6520 6f66 202a 496e 666f 2065 tside of *Info e │ │ │ +00064540: 6c65 6d65 6e74 732e 0a09 2d20 4164 6465 lements...- Adde │ │ │ +00064550: 6420 5469 746c 652c 2054 6974 6c65 4162 d Title, TitleAb │ │ │ +00064560: 6272 6576 2c20 616e 6420 5375 6254 6974 brev, and SubTit │ │ │ +00064570: 6c65 206f 7574 7369 6465 2041 7274 4865 le outside ArtHe │ │ │ +00064580: 6164 6572 3b20 4172 7448 6561 6465 720a ader; ArtHeader. │ │ │ +00064590: 0920 2069 7320 6e6f 7720 6f70 7469 6f6e . is now option │ │ │ +000645a0: 616c 2e0a 092d 2050 6172 616d 6574 6572 al...- Parameter │ │ │ +000645b0: 697a 6564 2065 6c65 6d65 6e74 2061 6e64 ized element and │ │ │ +000645c0: 2061 7474 7269 6275 7465 2064 6563 6c61 attribute decla │ │ │ +000645d0: 7261 7469 6f6e 7320 7365 7061 7261 7465 rations separate │ │ │ +000645e0: 6c79 2e0a 0a09 2a20 6462 706f 6f6c 782e ly....* dbpoolx. │ │ │ +000645f0: 6d6f 643a 2043 6f6e 7665 7274 6564 2074 mod: Converted t │ │ │ +00064600: 6f20 446f 6342 6f6f 6b20 332e 313a 0a09 o DocBook 3.1:.. │ │ │ +00064610: 0a09 2d20 4164 6465 6420 6f70 7469 6f6e ..- Added option │ │ │ +00064620: 616c 2074 6974 6c65 2074 6f20 4d73 6753 al title to MsgS │ │ │ +00064630: 6574 0a09 2d20 4164 6465 6420 696e 6c69 et..- Added inli │ │ │ +00064640: 6e65 2043 6f6e 7374 616e 7420 666f 7220 ne Constant for │ │ │ +00064650: 6d61 726b 696e 6720 7570 2063 6f6e 7374 marking up const │ │ │ +00064660: 616e 7473 2061 6e64 206c 696d 6974 730a ants and limits. │ │ │ +00064670: 092d 2041 6464 6564 2069 6e6c 696e 6520 .- Added inline │ │ │ +00064680: 5661 724e 616d 6520 666f 7220 6d61 726b VarName for mark │ │ │ +00064690: 696e 6720 7570 2076 6172 6961 626c 6520 ing up variable │ │ │ +000646a0: 6e61 6d65 730a 092d 2041 6464 6564 2073 names..- Added s │ │ │ +000646b0: 6576 6572 616c 2065 6c65 6d65 6e74 7320 everal elements │ │ │ +000646c0: 746f 2074 6865 2063 6f6e 7465 6e74 206d to the content m │ │ │ +000646d0: 6f64 656c 206f 6620 4172 7448 6561 6465 odel of ArtHeade │ │ │ +000646e0: 7220 7468 6174 2077 6572 650a 0920 2061 r that were.. a │ │ │ +000646f0: 6363 6964 656e 7461 6c6c 7920 6c65 6674 ccidentally left │ │ │ +00064700: 206f 7574 2069 6e20 332e 303a 2047 7261 out in 3.0: Gra │ │ │ +00064710: 7068 6963 2c20 4c65 6761 6c4e 6f74 6963 phic, LegalNotic │ │ │ +00064720: 652c 204d 6f64 6553 7065 632c 0a09 2020 e, ModeSpec,.. │ │ │ +00064730: 5375 626a 6563 7453 6574 2c20 4b65 7977 SubjectSet, Keyw │ │ │ +00064740: 6f72 6453 6574 2c20 616e 6420 4954 6572 ordSet, and ITer │ │ │ +00064750: 6d53 6574 2e0a 092d 2041 6464 6564 2070 mSet...- Added p │ │ │ +00064760: 6167 6577 6964 6520 6174 7472 6962 7574 agewide attribut │ │ │ +00064770: 6520 746f 2046 6967 7572 652c 2061 6464 e to Figure, add │ │ │ +00064780: 6564 2049 6e66 6f72 6d61 6c46 6967 7572 ed InformalFigur │ │ │ +00064790: 650a 092d 2041 6464 6564 2070 6572 736f e..- Added perso │ │ │ +000647a0: 6e20 6e61 6d65 2065 6c65 6d65 6e74 7320 n name elements │ │ │ +000647b0: 746f 2041 6464 7265 7373 2e0a 092d 2041 to Address...- A │ │ │ +000647c0: 6464 6564 2043 6c61 7373 2061 7474 7269 dded Class attri │ │ │ +000647d0: 6275 7465 2074 6f20 4c69 7465 7261 6c4c bute to LiteralL │ │ │ +000647e0: 6179 6f75 7420 696e 6469 6361 7469 6e67 ayout indicating │ │ │ +000647f0: 204d 6f6e 6f73 7061 6365 6420 6f72 0a09 Monospaced or.. │ │ │ +00064800: 2020 4e6f 726d 616c 2066 6f6e 742e 0a09 Normal font... │ │ │ +00064810: 2d20 4164 6465 6420 554c 696e 6b20 746f - Added ULink to │ │ │ +00064820: 2064 6f63 696e 666f 2e63 6861 722e 6d69 docinfo.char.mi │ │ │ +00064830: 782e 0a09 2d20 4164 6465 6420 5265 7648 x...- Added RevH │ │ │ +00064840: 6973 746f 7279 2074 6f20 476c 6f73 7345 istory to GlossE │ │ │ +00064850: 6e74 7279 2e0a 092d 2041 6464 6564 2043 ntry...- Added C │ │ │ +00064860: 6d64 4c65 6e67 7468 2061 7474 7269 6275 mdLength attribu │ │ │ +00064870: 7465 2074 6f20 436d 6453 796e 6f70 7369 te to CmdSynopsi │ │ │ +00064880: 7320 746f 2069 6e64 6963 6174 6520 436f s to indicate Co │ │ │ +00064890: 6d6d 616e 6420 6c65 6e67 7468 0a09 2d20 mmand length..- │ │ │ +000648a0: 4164 6465 6420 5141 6e64 4153 6574 2c20 Added QAndASet, │ │ │ +000648b0: 4d65 6469 614f 626a 6563 742c 2061 6e64 MediaObject, and │ │ │ +000648c0: 2049 6e6c 696e 654d 6564 6961 4f62 6a65 InlineMediaObje │ │ │ +000648d0: 6374 2e0a 092d 2050 6172 616d 6574 6572 ct...- Parameter │ │ │ +000648e0: 697a 6564 2065 6c65 6d65 6e74 2061 6e64 ized element and │ │ │ +000648f0: 2061 7474 7269 6275 7465 2064 6563 6c61 attribute decla │ │ │ +00064900: 7261 7469 6f6e 7320 7365 7061 7261 7465 rations separate │ │ │ +00064910: 6c79 2e0a 0a31 3939 392d 3031 2d33 3020 ly...1999-01-30 │ │ │ +00064920: 204e 6f72 6d61 6e20 5761 6c73 6820 203c Norman Walsh < │ │ │ +00064930: 6e64 7740 6e77 616c 7368 2e63 6f6d 3e0a ndw@nwalsh.com>. │ │ │ +00064940: 0a09 2a20 434f 5059 5249 4748 543a 204d ..* COPYRIGHT: M │ │ │ +00064950: 6f76 6564 2069 6e73 7461 6c6c 2069 6e66 oved install inf │ │ │ +00064960: 6f20 746f 2052 4541 444d 452c 2075 7064 o to README, upd │ │ │ +00064970: 6174 6564 2079 6561 7220 2620 5552 4c0a ated year & URL. │ │ │ +00064980: 0a09 2a20 5245 4144 4d45 3a20 4368 616e ..* README: Chan │ │ │ +00064990: 6765 6420 7665 7273 696f 6e2c 2061 6464 ged version, add │ │ │ +000649a0: 6564 206d 616e 6966 6573 7420 616e 6420 ed manifest and │ │ │ +000649b0: 696e 7374 616c 6c61 7469 6f6e 2069 6e73 installation ins │ │ │ +000649c0: 7472 7563 7469 6f6e 732c 2075 7064 6174 tructions, updat │ │ │ +000649d0: 6564 2079 6561 720a 0a09 2a20 5645 5253 ed year...* VERS │ │ │ +000649e0: 494f 4e3a 2055 7064 6174 6564 2076 6572 ION: Updated ver │ │ │ +000649f0: 7369 6f6e 0a0a 092a 2063 616c 7374 626c sion...* calstbl │ │ │ +00064a00: 782e 6474 643a 2043 6861 6e67 6564 2076 x.dtd: Changed v │ │ │ +00064a10: 6572 7369 6f6e 206e 756d 6265 720a 0a09 ersion number... │ │ │ +00064a20: 2a20 6462 3378 6d6c 2e64 7464 2c20 6462 * db3xml.dtd, db │ │ │ +00064a30: 6765 6e65 6e74 2e65 6e74 2c20 6462 6869 genent.ent, dbhi │ │ │ +00064a40: 6572 782e 6d6f 642c 2064 6270 6f6f 6c78 erx.mod, dbpoolx │ │ │ +00064a50: 2e6d 6f64 3a20 4368 616e 6765 6420 7665 .mod: Changed ve │ │ │ +00064a60: 7273 696f 6e0a 0a09 2a20 7465 7374 2e78 rsion...* test.x │ │ │ +00064a70: 6d6c 3a20 4164 6465 6420 676c 6f73 7361 ml: Added glossa │ │ │ +00064a80: 7279 2074 6573 742c 2066 6978 6564 2069 ry test, fixed i │ │ │ +00064a90: 6e64 6578 7465 726d 2065 7861 6d70 6c65 ndexterm example │ │ │ +00064aa0: 0a0a 3139 3939 2d30 312d 3133 2020 4e6f ..1999-01-13 No │ │ │ +00064ab0: 726d 616e 2057 616c 7368 2020 3c6e 6477 rman Walsh ...* │ │ │ +00064ad0: 2064 6268 6965 7278 2e6d 6f64 3a20 4164 dbhierx.mod: Ad │ │ │ +00064ae0: 6465 6420 696e 6465 7874 6572 6d73 2074 ded indexterms t │ │ │ +00064af0: 6f20 5265 6645 6e74 7279 2061 6e64 2052 o RefEntry and R │ │ │ +00064b00: 6566 4d65 7461 0a0a 092a 2064 6270 6f6f efMeta...* dbpoo │ │ │ +00064b10: 6c78 2e6d 6f64 3a20 4164 6465 6420 696e lx.mod: Added in │ │ │ +00064b20: 6465 7874 6572 6d20 746f 2067 6c6f 7373 dexterm to gloss │ │ │ +00064b30: 656e 7472 7920 6265 7477 6565 6e20 676c entry between gl │ │ │ +00064b40: 6f73 7374 6572 6d20 616e 6420 676c 6f73 ossterm and glos │ │ │ +00064b50: 7364 6566 2e0a 0a31 3939 382d 3132 2d30 sdef...1998-12-0 │ │ │ +00064b60: 3920 204e 6f72 6d61 6e20 5761 6c73 6820 9 Norman Walsh │ │ │ +00064b70: 203c 6e64 7740 6e77 616c 7368 2e63 6f6d ...* COPYRIGHT, │ │ │ +00064b90: 2052 4541 444d 452c 2063 616c 7374 626c README, calstbl │ │ │ +00064ba0: 782e 6474 642c 2064 6233 786d 6c2e 6474 x.dtd, db3xml.dt │ │ │ +00064bb0: 642c 2064 6267 656e 656e 742e 656e 742c d, dbgenent.ent, │ │ │ +00064bc0: 2064 6268 6965 7278 2e6d 6f64 2c20 6462 dbhierx.mod, db │ │ │ +00064bd0: 706f 6f6c 782e 6d6f 642c 2074 6573 742e poolx.mod, test. │ │ │ +00064be0: 786d 6c3a 200a 0943 6861 6e67 6564 2065 xml: ..Changed e │ │ │ +00064bf0: 6d62 6564 6465 6420 7665 7273 696f 6e20 mbedded version │ │ │ +00064c00: 6e75 6d62 6572 2074 6f20 312e 310a 0a09 number to 1.1... │ │ │ +00064c10: 2a20 5645 5253 494f 4e3a 2056 6572 7369 * VERSION: Versi │ │ │ +00064c20: 6f6e 2031 2e31 2072 656c 6561 7365 642e on 1.1 released. │ │ │ +00064c30: 0a0a 092a 2056 4552 5349 4f4e 3a20 4e65 ...* VERSION: Ne │ │ │ +00064c40: 7720 6669 6c65 2e0a 0a09 2a20 6361 6c73 w file....* cals │ │ │ +00064c50: 7462 6c78 2e64 7464 3a20 5269 7070 6564 tblx.dtd: Ripped │ │ │ +00064c60: 206f 7574 2061 2077 686f 6c65 2062 756e out a whole bun │ │ │ +00064c70: 6368 206f 6620 636f 6d6d 656e 7473 2e20 ch of comments. │ │ │ +00064c80: 2049 6e20 584d 4c2c 2070 6172 616d 6574 In XML, paramet │ │ │ +00064c90: 6572 0a09 656e 7469 7469 6573 2061 7265 er..entities are │ │ │ +00064ca0: 2065 7870 616e 6465 6420 696e 2063 6f6d expanded in com │ │ │ +00064cb0: 6d65 6e74 7320 616e 6420 7468 6174 206d ments and that m │ │ │ +00064cc0: 6164 6520 736f 6d65 206f 6620 7468 650a ade some of the. │ │ │ +00064cd0: 0963 6f6d 6d65 6e74 7320 626f 6775 732e .comments bogus. │ │ │ +00064ce0: 0a0a 092a 2064 6268 6965 7278 2e6d 6f64 ...* dbhierx.mod │ │ │ +00064cf0: 3a20 4164 6465 6420 696e 6465 7874 6572 : Added indexter │ │ │ +00064d00: 6d73 2074 6f20 7265 6669 6e6c 696e 652e ms to refinline. │ │ │ +00064d10: 6368 6172 2e6d 6978 2e0a 0a09 2a20 6462 char.mix....* db │ │ │ +00064d20: 706f 6f6c 782e 6d6f 643a 2041 6464 6564 poolx.mod: Added │ │ │ +00064d30: 2069 6e64 6578 7465 726d 2061 6e64 2062 indexterm and b │ │ │ +00064d40: 6567 696e 7061 6765 2074 6f20 6578 616d eginpage to exam │ │ │ +00064d50: 706c 652e 6d69 782c 2068 6967 686c 6967 ple.mix, highlig │ │ │ +00064d60: 6874 732e 6d69 782c 0a09 6164 6d6f 6e2e hts.mix,..admon. │ │ │ +00064d70: 6d69 782c 2066 6967 7572 652e 6d69 782c mix, figure.mix, │ │ │ +00064d80: 2067 6c6f 7373 6465 662e 6d69 782c 206c glossdef.mix, l │ │ │ +00064d90: 6567 616c 6e6f 7469 6365 2e6d 6978 2e0a egalnotice.mix.. │ │ │ +00064da0: 090a 0941 6c6c 6f77 2069 6e64 6578 7465 ...Allow indexte │ │ │ +00064db0: 726d 7320 6265 7477 6565 6e20 7469 746c rms between titl │ │ │ +00064dc0: 6520 616e 6420 7061 7261 2069 6e20 666f e and para in fo │ │ │ +00064dd0: 726d 616c 7061 7261 2e0a 090a 0941 6464 rmalpara.....Add │ │ │ +00064de0: 6564 2069 6e64 6578 7465 726d 7320 746f ed indexterms to │ │ │ +00064df0: 2074 626c 2e74 6162 6c65 2e6d 646c 2c20 tbl.table.mdl, │ │ │ +00064e00: 6265 7477 6565 6e20 7469 746c 6520 616e between title an │ │ │ +00064e10: 6420 7468 6520 7265 7374 206f 660a 0974 d the rest of..t │ │ │ +00064e20: 6865 2063 6f6e 7465 6e74 206f 6620 7461 he content of ta │ │ │ +00064e30: 626c 652e 0a09 0a09 5265 6d6f 7665 6420 ble.....Removed │ │ │ +00064e40: 6120 6665 7720 6578 7472 616e 656f 7573 a few extraneous │ │ │ +00064e50: 2070 6172 616d 6574 6572 2065 6e74 6974 parameter entit │ │ │ +00064e60: 6965 7320 2865 7863 6c75 7369 6f6e 7320 ies (exclusions │ │ │ +00064e70: 696e 0a09 7461 626c 6573 2c20 6d6f 7374 in..tables, most │ │ │ +00064e80: 6c79 292e 0a0a 092a 2074 6573 742e 786d ly)....* test.xm │ │ │ +00064e90: 6c3a 2043 6861 6e67 6520 7379 7374 656d l: Change system │ │ │ +00064ea0: 6964 3b20 6164 6465 6420 7465 7374 2069 id; added test i │ │ │ +00064eb0: 6e64 6578 7465 726d 730a 0a31 3939 382d ndexterms..1998- │ │ │ +00064ec0: 3039 2d31 3620 204e 6f72 6d61 6e20 5761 09-16 Norman Wa │ │ │ +00064ed0: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* db3xml │ │ │ +00064ef0: 2e64 7464 3a20 4368 616e 6765 6420 6465 .dtd: Changed de │ │ │ +00064f00: 636c 6172 6174 696f 6e20 6f66 206c 696e claration of lin │ │ │ +00064f10: 6573 7065 6369 6669 633b 2066 6f72 6d65 especific; forme │ │ │ +00064f20: 7220 6465 636c 6172 6174 696f 6e0a 0977 r declaration..w │ │ │ +00064f30: 6173 206e 6f74 2061 2076 616c 6964 2055 as not a valid U │ │ │ +00064f40: 5249 0a0a 092a 2064 6270 6f6f 6c78 2e6d RI...* dbpoolx.m │ │ │ +00064f50: 6f64 3a20 5265 6d6f 7665 6420 6475 706c od: Removed dupl │ │ │ +00064f60: 6963 6174 6520 6465 636c 6172 6174 696f icate declaratio │ │ │ +00064f70: 6e20 6f66 206c 6f63 616c 2e6b 6579 776f n of local.keywo │ │ │ +00064f80: 7264 7365 742e 6174 7472 6962 0a0a 3139 rdset.attrib..19 │ │ │ +00064f90: 3938 2d30 392d 3130 2020 4e6f 726d 616e 98-09-10 Norman │ │ │ +00064fa0: 2057 616c 7368 2020 3c6e 6477 406e 7761 Walsh ...* COP │ │ │ +00064fc0: 5952 4947 4854 2c20 5245 4144 4d45 2c20 YRIGHT, README, │ │ │ +00064fd0: 6361 6c73 7462 6c78 2e64 7464 2c20 6368 calstblx.dtd, ch │ │ │ +00064fe0: 616e 6765 732c 2064 6233 786d 6c2e 6474 anges, db3xml.dt │ │ │ +00064ff0: 642c 2064 6267 656e 656e 742e 656e 742c d, dbgenent.ent, │ │ │ +00065000: 2064 6268 6965 7278 2e6d 6f64 2c20 6462 dbhierx.mod, db │ │ │ +00065010: 706f 6f6c 782e 6d6f 642c 2074 6573 742e poolx.mod, test. │ │ │ +00065020: 786d 6c3a 200a 094e 6577 2066 696c 652e xml: ..New file. │ │ │ +00065030: 0a0a b600 0000 1f64 656d 6f2f 646f 6373 .......demo/docs │ │ │ +00065040: 7263 2f44 6f63 426f 6f6b 2f64 626e 6f74 rc/DocBook/dbnot │ │ │ +00065050: 6e78 2e6d 6f64 df00 0010 a23c 212d 2d20 nx.mod.............< │ │ │ +00065630: 212d 2d20 5468 6973 206d 6f64 756c 6520 !-- This module │ │ │ +00065640: 636f 6e74 6169 6e73 2074 6865 2065 6e74 contains the ent │ │ │ +00065650: 6974 7920 6465 636c 6172 6174 696f 6e73 ity declarations │ │ │ +00065660: 2066 6f72 2074 6865 2073 7461 6e64 6172 for the standar │ │ │ +00065670: 6420 4953 4f0a 2020 2020 2065 6e74 6974 d ISO. entit │ │ │ +00065680: 7920 7365 7473 2075 7365 6420 6279 2044 y sets used by D │ │ │ +00065690: 6f63 426f 6f6b 2e0a 0a20 2020 2020 496e ocBook... In │ │ │ +000656a0: 2044 5444 2064 7269 7665 7220 6669 6c65 DTD driver file │ │ │ +000656b0: 7320 7265 6665 7272 696e 6720 746f 2074 s referring to t │ │ │ +000656c0: 6869 7320 6d6f 6475 6c65 2c20 706c 6561 his module, plea │ │ │ +000656d0: 7365 2075 7365 2061 6e20 656e 7469 7479 se use an entity │ │ │ +000656e0: 0a20 2020 2020 6465 636c 6172 6174 696f . declaratio │ │ │ +000656f0: 6e20 7468 6174 2075 7365 7320 7468 6520 n that uses the │ │ │ +00065700: 7075 626c 6963 2069 6465 6e74 6966 6965 public identifie │ │ │ +00065710: 7220 7368 6f77 6e20 6265 6c6f 773a 0a0a r shown below:.. │ │ │ +00065720: 2020 2020 203c 2145 4e54 4954 5920 2520 . │ │ │ +00065790: 2564 626e 6f74 6e3b 0a0a 2020 2020 2053 %dbnotn;.. S │ │ │ +000657a0: 6565 2074 6865 2064 6f63 756d 656e 7461 ee the documenta │ │ │ +000657b0: 7469 6f6e 2066 6f72 2064 6574 6169 6c65 tion for detaile │ │ │ +000657c0: 6420 696e 666f 726d 6174 696f 6e20 6f6e d information on │ │ │ +000657d0: 2074 6865 2070 6172 616d 6574 6572 0a20 the parameter. │ │ │ +000657e0: 2020 2020 656e 7469 7479 2061 6e64 206d entity and m │ │ │ +000657f0: 6f64 756c 6520 7363 6865 6d65 2075 7365 odule scheme use │ │ │ +00065800: 6420 696e 2044 6f63 426f 6f6b 2c20 6375 d in DocBook, cu │ │ │ +00065810: 7374 6f6d 697a 696e 6720 446f 6342 6f6f stomizing DocBoo │ │ │ +00065820: 6b20 616e 640a 2020 2020 2070 6c61 6e6e k and. plann │ │ │ +00065830: 696e 6720 666f 7220 696e 7465 7263 6861 ing for intercha │ │ │ +00065840: 6e67 652c 2061 6e64 2063 6861 6e67 6573 nge, and changes │ │ │ +00065850: 206d 6164 6520 7369 6e63 6520 7468 6520 made since the │ │ │ +00065860: 6c61 7374 2072 656c 6561 7365 0a20 2020 last release. │ │ │ +00065870: 2020 6f66 2044 6f63 426f 6f6b 2e0a 2d2d of DocBook..-- │ │ │ +00065880: 3e0a 0a3c 2145 4e54 4954 5920 2520 6c6f >................. │ │ │ +00065ca0: 3c21 4e4f 5441 5449 4f4e 2047 4946 3839 ........ │ │ │ +00065ef0: 0a3c 214e 4f54 4154 494f 4e20 5442 4c09 ..< │ │ │ +00065f10: 214e 4f54 4154 494f 4e20 5445 5809 0950 !NOTATION TEX..P │ │ │ +00065f20: 5542 4c49 4320 0a22 2b2f 2f49 5342 4e20 UBLIC ."+//ISBN │ │ │ +00065f30: 302d 3230 312d 3133 3434 382d 393a 3a4b 0-201-13448-9::K │ │ │ +00065f40: 6e75 7468 2f2f 4e4f 5441 5449 4f4e 2054 nuth//NOTATION T │ │ │ +00065f50: 6865 2054 6558 626f 6f6b 2f2f 454e 223e he TeXbook//EN"> │ │ │ +00065f60: 0a3c 214e 4f54 4154 494f 4e20 5449 4646 . │ │ │ +00065f80: 0a3c 214e 4f54 4154 494f 4e20 574d 4609 .. ........ │ │ │ +00066100: 0020 6465 6d6f 2f64 6f63 7372 632f 446f . demo/docsrc/Do │ │ │ +00066110: 6342 6f6f 6b2f 736f 6578 7462 6c78 2e64 cBook/soextblx.d │ │ │ +00066120: 7464 df00 0031 2b3c 212d 2d20 584d 4c20 td...1+... │ │ │ +00066300: 2020 2020 2020 2025 6361 6c73 7462 6c78 %calstblx │ │ │ +00066310: 3b0a 0a20 2020 2020 4966 2076 6172 696f ;.. If vario │ │ │ +00066320: 7573 2070 6172 616d 6574 6572 2065 6e74 us parameter ent │ │ │ +00066330: 6974 6965 7320 7573 6564 2077 6974 6869 ities used withi │ │ │ +00066340: 6e20 7468 6973 2073 6574 206f 6620 6465 n this set of de │ │ │ +00066350: 636c 6172 6174 696f 6e73 0a20 2020 2020 clarations. │ │ │ +00066360: 6172 6520 746f 2062 6520 6769 7665 6e20 are to be given │ │ │ +00066370: 6e6f 6e2d 6465 6661 756c 7420 7661 6c75 non-default valu │ │ │ +00066380: 6573 2c20 7468 6520 6170 7072 6f70 7269 es, the appropri │ │ │ +00066390: 6174 6520 6465 636c 6172 6174 696f 6e73 ate declarations │ │ │ +000663a0: 0a20 2020 2020 7368 6f75 6c64 2062 6520 . should be │ │ │ +000663b0: 6769 7665 6e20 6265 666f 7265 2063 616c given before cal │ │ │ +000663c0: 6c69 6e67 2069 6e20 7468 6973 2070 6163 ling in this pac │ │ │ +000663d0: 6b61 6765 2028 692e 652e 2c20 6265 666f kage (i.e., befo │ │ │ +000663e0: 7265 2074 6865 0a20 2020 2020 2225 6361 re the. "%ca │ │ │ +000663f0: 6c73 7462 6c78 3b22 2072 6566 6572 656e lstblx;" referen │ │ │ +00066400: 6365 292e 0a2d 2d3e 0a0a 3c21 2d2d 2054 ce)..-->......< │ │ │ +00066e10: 212d 2d20 496e 206f 7264 6572 2074 6f20 !-- In order to │ │ │ +00066e20: 7573 6520 7468 6520 4578 6368 616e 6765 use the Exchange │ │ │ +00066e30: 2074 6162 6c65 206d 6f64 656c 2c20 7661 table model, va │ │ │ +00066e40: 7269 6f75 7320 7061 7261 6d65 7465 7220 rious parameter │ │ │ +00066e50: 656e 7469 7479 0a20 2020 2020 6465 636c entity. decl │ │ │ +00066e60: 6172 6174 696f 6e73 2061 7265 2072 6571 arations are req │ │ │ +00066e70: 7569 7265 642e 2020 4120 6272 6965 6620 uired. A brief │ │ │ +00066e80: 6465 7363 7269 7074 696f 6e20 6973 2061 description is a │ │ │ +00066e90: 7320 666f 6c6c 6f77 733a 0a0a 2020 2020 s follows:.. │ │ │ +00066ea0: 2045 4e54 4954 5920 4e41 4d45 2020 2020 ENTITY NAME │ │ │ +00066eb0: 2020 5748 4552 4520 5553 4544 2020 2020 WHERE USED │ │ │ +00066ec0: 2020 2020 2020 2020 2020 5748 4154 2049 WHAT I │ │ │ +00066ed0: 5420 4953 0a0a 2020 2020 2025 7965 736f T IS.. %yeso │ │ │ +00066ee0: 726e 6f20 2020 2020 2020 2020 496e 2041 rno In A │ │ │ +00066ef0: 5454 4c49 5354 206f 663a 2020 2020 2020 TTLIST of: │ │ │ +00066f00: 2020 2020 416e 2061 7474 7269 6275 7465 An attribute │ │ │ +00066f10: 2064 6563 6c61 7265 6420 7661 6c75 650a declared value. │ │ │ +00066f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00066f30: 2020 2020 2020 616c 6d6f 7374 2061 6c6c almost all │ │ │ +00066f40: 2065 6c65 6d65 6e74 7320 2020 2020 666f elements fo │ │ │ +00066f50: 7220 6120 2262 6f6f 6c65 616e 2220 6174 r a "boolean" at │ │ │ +00066f60: 7472 6962 7574 650a 0a20 2020 2020 2570 tribute.. %p │ │ │ +00066f70: 6172 6163 6f6e 2020 2020 2020 2020 2049 aracon I │ │ │ +00066f80: 6e20 636f 6e74 656e 7420 6d6f 6465 6c20 n content model │ │ │ +00066f90: 6f66 3a20 2020 2054 6865 2022 7465 7874 of: The "text │ │ │ +00066fa0: 2220 286c 6f67 6963 616c 2063 6f6e 7465 " (logical conte │ │ │ +00066fb0: 6e74 290a 2020 2020 2020 2020 2020 2020 nt). │ │ │ +00066fc0: 2020 2020 2020 2020 2020 3c65 6e74 7279 │ │ │ +00066fe0: 2020 6f66 2074 6865 206d 6f64 656c 2067 of the model g │ │ │ +00066ff0: 726f 7570 2066 6f72 203c 656e 7472 793e roup for │ │ │ +00067000: 0a0a 2020 2020 2025 7469 746c 6573 2020 .. %titles │ │ │ +00067010: 2020 2020 2020 2020 496e 2063 6f6e 7465 In conte │ │ │ +00067020: 6e74 206d 6f64 656c 206f 663a 2020 2020 nt model of: │ │ │ +00067030: 5468 6520 2274 6974 6c65 2220 7061 7274 The "title" part │ │ │ +00067040: 206f 6620 7468 6520 6d6f 6465 6c0a 2020 of the model. │ │ │ +00067050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067060: 2020 2020 7461 626c 6520 656c 656d 656e table elemen │ │ │ +00067070: 7420 2020 2020 2020 2020 2020 6772 6f75 t grou │ │ │ +00067080: 7020 666f 7220 7468 6520 7461 626c 6520 p for the table │ │ │ +00067090: 656c 656d 656e 740a 0a20 2020 2020 2574 element.. %t │ │ │ +000670a0: 626c 2e74 6162 6c65 2e6e 616d 6520 2049 bl.table.name I │ │ │ +000670b0: 6e20 6465 636c 6172 6174 696f 6e20 6f66 n declaration of │ │ │ +000670c0: 3a20 2020 2020 2054 6865 206e 616d 6520 : The name │ │ │ +000670d0: 6f66 2074 6865 2022 7461 626c 6522 0a20 of the "table". │ │ │ +000670e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000670f0: 2020 2020 2074 6162 6c65 2065 6c65 6d65 table eleme │ │ │ +00067100: 6e74 2020 2020 2020 2020 2020 2065 6c65 nt ele │ │ │ +00067110: 6d65 6e74 0a0a 2020 2020 2025 7462 6c2e ment.. %tbl. │ │ │ +00067120: 7461 626c 652d 7469 746c 6573 2e6d 646c table-titles.mdl │ │ │ +00067130: 2049 6e20 636f 6e74 656e 7420 6d6f 6465 In content mode │ │ │ +00067140: 6c20 6f66 3a20 5468 6520 6d6f 6465 6c20 l of: The model │ │ │ +00067150: 6772 6f75 7020 666f 7220 7468 6520 7469 group for the ti │ │ │ +00067160: 746c 650a 2020 2020 2020 2020 2020 2020 tle. │ │ │ +00067170: 2020 2020 2020 2020 2020 7461 626c 6520 table │ │ │ +00067180: 656c 656d 656e 7473 2020 2020 2020 2020 elements │ │ │ +00067190: 2020 7061 7274 206f 6620 7468 6520 636f part of the co │ │ │ +000671a0: 6e74 656e 7420 6d6f 6465 6c20 666f 720a ntent model for. │ │ │ +000671b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000671c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000671d0: 2020 2020 2020 2020 2020 2020 2020 7461 ta │ │ │ +000671e0: 626c 6520 656c 656d 656e 740a 0a20 2020 ble element.. │ │ │ +000671f0: 2020 2574 626c 2e74 6162 6c65 2e6d 646c %tbl.table.mdl │ │ │ +00067200: 2020 2049 6e20 636f 6e74 656e 7420 6d6f In content mo │ │ │ +00067210: 6465 6c20 6f66 3a20 2020 2054 6865 206d del of: The m │ │ │ +00067220: 6f64 656c 2067 726f 7570 2066 6f72 2074 odel group for t │ │ │ +00067230: 6865 2063 6f6e 7465 6e74 0a20 2020 2020 he content. │ │ │ +00067240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067250: 2074 6162 6c65 2065 6c65 6d65 6e74 7320 table elements │ │ │ +00067260: 2020 2020 2020 2020 206d 6f64 656c 2066 model f │ │ │ +00067270: 6f72 2074 6162 6c65 2065 6c65 6d65 6e74 or table element │ │ │ +00067280: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ +00067290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000672a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000672b0: 6f66 7465 6e20 2861 6e64 2062 7920 6465 often (and by de │ │ │ +000672c0: 6661 756c 7429 2064 6566 696e 6564 0a20 fault) defined. │ │ │ +000672d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000672e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000672f0: 2020 2020 2020 2020 2020 2020 2069 6e20 in │ │ │ +00067300: 7465 726d 7320 6f66 2025 7462 6c2e 7461 terms of %tbl.ta │ │ │ +00067310: 626c 652d 7469 746c 6573 2e6d 646c 0a20 ble-titles.mdl. │ │ │ +00067320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067340: 2020 2020 2020 2020 2020 2020 2061 6e64 and │ │ │ +00067350: 2074 6772 6f75 700a 0a20 2020 2020 2574 tgroup.. %t │ │ │ +00067360: 626c 2e74 6162 6c65 2e61 7474 2020 2049 bl.table.att I │ │ │ +00067370: 6e20 4154 544c 4953 5420 6f66 3a20 2020 n ATTLIST of: │ │ │ +00067380: 2020 2020 2020 2041 6464 6974 696f 6e61 Additiona │ │ │ +00067390: 6c20 6174 7472 6962 7574 6573 206f 6e20 l attributes on │ │ │ +000673a0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ +000673b0: 2020 2020 2020 2020 2020 7461 626c 6520 table │ │ │ +000673c0: 656c 656d 656e 7420 2020 2020 2020 2020 element │ │ │ +000673d0: 2020 7461 626c 6520 656c 656d 656e 740a table element. │ │ │ +000673e0: 0a20 2020 2020 2562 6f64 7961 7474 2020 . %bodyatt │ │ │ +000673f0: 2020 2020 2020 2049 6e20 4154 544c 4953 In ATTLIS │ │ │ +00067400: 5420 6f66 3a20 2020 2020 2020 2020 2041 T of: A │ │ │ +00067410: 6464 6974 696f 6e61 6c20 6174 7472 6962 dditional attrib │ │ │ +00067420: 7574 6573 206f 6e20 7468 650a 2020 2020 utes on the. │ │ │ +00067430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067440: 2020 7461 626c 6520 656c 656d 656e 7420 table element │ │ │ +00067450: 2020 2020 2020 2020 2020 7461 626c 6520 table │ │ │ +00067460: 656c 656d 656e 7420 2866 6f72 2062 6163 element (for bac │ │ │ +00067470: 6b77 6172 640a 2020 2020 2020 2020 2020 kward. │ │ │ +00067480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000674a0: 2020 2020 636f 6d70 6174 6962 696c 6974 compatibilit │ │ │ +000674b0: 7920 7769 7468 2074 6865 2053 474d 4c0a y with the SGML. │ │ │ +000674c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000674d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000674e0: 2020 2020 2020 2020 2020 2020 2020 6d6f mo │ │ │ +000674f0: 6465 6c29 0a0a 2020 2020 2025 7462 6c2e del).. %tbl. │ │ │ +00067500: 7467 726f 7570 2e6d 646c 2020 496e 2063 tgroup.mdl In c │ │ │ +00067510: 6f6e 7465 6e74 206d 6f64 656c 206f 663a ontent model of: │ │ │ +00067520: 2020 2020 5468 6520 6d6f 6465 6c20 6772 The model gr │ │ │ +00067530: 6f75 7020 666f 7220 7468 6520 636f 6e74 oup for the cont │ │ │ +00067540: 656e 740a 2020 2020 2020 2020 2020 2020 ent. │ │ │ +00067550: 2020 2020 2020 2020 2020 3c74 6772 6f75 │ │ │ +00067570: 2020 6d6f 6465 6c20 666f 7220 3c74 6772 model for .. %tbl. │ │ │ +00067590: 7467 726f 7570 2e61 7474 2020 496e 2041 tgroup.att In A │ │ │ +000675a0: 5454 4c49 5354 206f 663a 2020 2020 2020 TTLIST of: │ │ │ +000675b0: 2020 2020 4164 6469 7469 6f6e 616c 2061 Additional a │ │ │ +000675c0: 7474 7269 6275 7465 7320 6f6e 2074 6865 ttributes on the │ │ │ +000675d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ +000675e0: 2020 2020 2020 203c 7467 726f 7570 3e20 │ │ │ +000675f0: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ +00067600: 7467 726f 7570 3e20 656c 656d 656e 740a tgroup> element. │ │ │ +00067610: 0a20 2020 2020 2574 626c 2e74 6865 6164 . %tbl.thead │ │ │ +00067620: 2e61 7474 2020 2049 6e20 4154 544c 4953 .att In ATTLIS │ │ │ +00067630: 5420 6f66 3a20 2020 2020 2020 2020 2041 T of: A │ │ │ +00067640: 6464 6974 696f 6e61 6c20 6174 7472 6962 dditional attrib │ │ │ +00067650: 7574 6573 206f 6e20 7468 650a 2020 2020 utes on the. │ │ │ +00067660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067670: 2020 3c74 6865 6164 3e20 2020 2020 2020 │ │ │ +00067680: 2020 2020 2020 2020 2020 3c74 6865 6164 element.. │ │ │ +000676a0: 2574 626c 2e74 626f 6479 2e61 7474 2020 %tbl.tbody.att │ │ │ +000676b0: 2049 6e20 4154 544c 4953 5420 6f66 3a20 In ATTLIST of: │ │ │ +000676c0: 2020 2020 2020 2020 2041 6464 6974 696f Additio │ │ │ +000676d0: 6e61 6c20 6174 7472 6962 7574 6573 206f nal attributes o │ │ │ +000676e0: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ +000676f0: 2020 2020 2020 2020 2020 2020 3c74 626f │ │ │ +00067710: 2020 2020 3c74 626f 6479 3e20 656c 656d elem │ │ │ +00067720: 656e 740a 0a20 2020 2020 2574 626c 2e63 ent.. %tbl.c │ │ │ +00067730: 6f6c 7370 6563 2e61 7474 2049 6e20 4154 olspec.att In AT │ │ │ +00067740: 544c 4953 5420 6f66 3a20 2020 2020 2020 TLIST of: │ │ │ +00067750: 2020 2041 6464 6974 696f 6e61 6c20 6174 Additional at │ │ │ +00067760: 7472 6962 7574 6573 206f 6e20 7468 650a tributes on the. │ │ │ +00067770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067780: 2020 2020 2020 3c63 6f6c 7370 6563 3e20 │ │ │ +00067790: 2020 2020 2020 2020 2020 2020 2020 3c63 element. │ │ │ +000677b0: 0a20 2020 2020 2574 626c 2e72 6f77 2e6d . %tbl.row.m │ │ │ +000677c0: 646c 2020 2020 2049 6e20 636f 6e74 656e dl In conten │ │ │ +000677d0: 7420 6d6f 6465 6c20 6f66 3a20 2020 2054 t model of: T │ │ │ +000677e0: 6865 206d 6f64 656c 2067 726f 7570 2066 he model group f │ │ │ +000677f0: 6f72 2074 6865 2063 6f6e 7465 6e74 0a20 or the content. │ │ │ +00067800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00067810: 2020 2020 203c 726f 773e 2020 2020 2020 │ │ │ +00067820: 2020 2020 2020 2020 2020 2020 206d 6f64 mod │ │ │ +00067830: 656c 2066 6f72 203c 726f 773e 0a0a 2020 el for .. │ │ │ +00067840: 2020 2025 7462 6c2e 726f 772e 6174 7420 %tbl.row.att │ │ │ +00067850: 2020 2020 496e 2041 5454 4c49 5354 206f In ATTLIST o │ │ │ +00067860: 663a 2020 2020 2020 2020 2020 4164 6469 f: Addi │ │ │ +00067870: 7469 6f6e 616c 2061 7474 7269 6275 7465 tional attribute │ │ │ +00067880: 7320 6f6e 2074 6865 0a20 2020 2020 2020 s on the. │ │ │ +00067890: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ +000678a0: 726f 773e 2020 2020 2020 2020 2020 2020 row> │ │ │ +000678b0: 2020 2020 2020 203c 726f 773e 2065 6c65 ele │ │ │ +000678c0: 6d65 6e74 0a0a 2020 2020 2025 7462 6c2e ment.. %tbl. │ │ │ +000678d0: 656e 7472 792e 6d64 6c20 2020 496e 2063 entry.mdl In c │ │ │ +000678e0: 6f6e 7465 6e74 206d 6f64 656c 206f 663a ontent model of: │ │ │ +000678f0: 2020 2020 5468 6520 6d6f 6465 6c20 6772 The model gr │ │ │ +00067900: 6f75 7020 666f 7220 7468 6520 636f 6e74 oup for the cont │ │ │ +00067910: 656e 740a 2020 2020 2020 2020 2020 2020 ent. │ │ │ +00067920: 2020 2020 2020 2020 2020 3c65 6e74 7279 │ │ │ +00067940: 2020 6d6f 6465 6c20 666f 7220 3c65 6e74 model for .. %tbl.e │ │ │ +00067960: 6e74 7279 2e61 7474 2020 2049 6e20 4154 ntry.att In AT │ │ │ +00067970: 544c 4953 5420 6f66 3a20 2020 2020 2020 TLIST of: │ │ │ +00067980: 2020 2041 6464 6974 696f 6e61 6c20 6174 Additional at │ │ │ +00067990: 7472 6962 7574 6573 206f 6e20 7468 650a tributes on the. │ │ │ +000679a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +000679b0: 2020 2020 2020 3c65 6e74 7279 3e20 2020 │ │ │ +000679c0: 2020 2020 2020 2020 2020 2020 2020 3c65 element.. │ │ │ +000679e0: 2020 2020 5468 6973 2073 6574 206f 6620 This set of │ │ │ +000679f0: 6465 636c 6172 6174 696f 6e73 2077 696c declarations wil │ │ │ +00067a00: 6c20 7573 6520 7468 6520 6465 6661 756c l use the defaul │ │ │ +00067a10: 7420 6465 6669 6e69 7469 6f6e 7320 7368 t definitions sh │ │ │ +00067a20: 6f77 6e20 6265 6c6f 770a 2020 2020 2066 own below. f │ │ │ +00067a30: 6f72 2061 6e79 206f 6620 7468 6573 6520 or any of these │ │ │ +00067a40: 7061 7261 6d65 7465 7220 656e 7469 7469 parameter entiti │ │ │ +00067a50: 6573 2074 6861 7420 6172 6520 6e6f 7420 es that are not │ │ │ +00067a60: 6465 636c 6172 6564 2062 6566 6f72 6520 declared before │ │ │ +00067a70: 7468 6973 0a20 2020 2020 7365 7420 6f66 this. set of │ │ │ +00067a80: 2064 6563 6c61 7261 7469 6f6e 7320 6973 declarations is │ │ │ +00067a90: 2072 6566 6572 656e 6365 642e 0a2d 2d3e referenced..--> │ │ │ +00067aa0: 0a0a 3c21 2d2d 2054 6865 7365 2064 6566 .... ... ...........< │ │ │ +00068140: 2145 4e54 4954 5920 2520 7462 6c2e 7462 !ENTITY % tbl.tb │ │ │ +00068150: 6f64 792e 6174 7420 2020 2020 2020 2022 ody.att " │ │ │ +00068160: 223e 0a3c 2145 4e54 4954 5920 2520 7462 ">.. │ │ │ +000681b0: 0a3c 2145 4e54 4954 5920 2520 7462 6c2e ................... │ │ │ +00068b10: 0a0a 3c21 454c 454d 454e 5420 7468 6561 ......< │ │ │ +00068ba0: 212d 2d0a 2020 2020 2044 6566 6175 6c74 !--. Default │ │ │ +00068bb0: 2064 6563 6c61 7261 7469 6f6e 7320 7072 declarations pr │ │ │ +00068bc0: 6576 696f 7573 6c79 2064 6566 696e 6564 eviously defined │ │ │ +00068bd0: 2069 6e20 7468 6973 2065 6e74 6974 7920 in this entity │ │ │ +00068be0: 616e 640a 2020 2020 2072 6566 6572 656e and. referen │ │ │ +00068bf0: 6365 6420 6265 6c6f 7720 696e 636c 7564 ced below includ │ │ │ +00068c00: 653a 0a20 2020 2020 454e 5449 5459 2025 e:. ENTITY % │ │ │ +00068c10: 2074 626c 2e74 626f 6479 2e61 7474 2020 tbl.tbody.att │ │ │ +00068c20: 2020 2022 220a 2d2d 3e0a 0a3c 2145 4c45 "".-->.......................demo/docs │ │ │ +00069260: 7263 2f44 6f63 426f 6f6b 2f52 4541 444d rc/DocBook/READM │ │ │ +00069270: 45df 0000 0973 5245 4144 4d45 2066 6f72 E....sREADME for │ │ │ +00069280: 2074 6865 2044 6f63 426b 2058 4d4c 2056 the DocBk XML V │ │ │ +00069290: 332e 312e 3720 4454 440a 0a54 6869 7320 3.1.7 DTD..This │ │ │ +000692a0: 6973 2061 6e20 584d 4c20 7665 7273 696f is an XML versio │ │ │ +000692b0: 6e20 6f66 2074 6865 2044 6f63 426f 6f6b n of the DocBook │ │ │ +000692c0: 2056 332e 3120 4454 440a 0a4d 616e 6966 V3.1 DTD..Manif │ │ │ +000692d0: 6573 740a 2d2d 2d2d 2d2d 2d2d 0a0a 5245 est.--------..RE │ │ │ +000692e0: 4144 4d45 2020 2020 2020 2020 2d20 5468 ADME - Th │ │ │ +000692f0: 6973 2072 6561 646d 6520 6669 6c65 0a56 is readme file.V │ │ │ +00069300: 4552 5349 4f4e 2020 2020 2020 202d 2054 ERSION - T │ │ │ +00069310: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ +00069320: 720a 434f 5059 5249 4748 5420 2020 2020 r.COPYRIGHT │ │ │ +00069330: 2d20 436f 7079 7269 6768 7420 7374 6174 - Copyright stat │ │ │ +00069340: 656d 656e 740a 4368 616e 6765 4c6f 6720 ement.ChangeLog │ │ │ +00069350: 2020 2020 2d20 5375 6d6d 6172 7920 6f66 - Summary of │ │ │ +00069360: 2063 6861 6e67 6573 2066 726f 6d20 7072 changes from pr │ │ │ +00069370: 6576 696f 7573 2076 6572 7369 6f6e 730a evious versions. │ │ │ +00069380: 6361 6c73 7462 6c78 2e64 7464 2020 2d20 calstblx.dtd - │ │ │ +00069390: 416e 2058 4d4c 2076 6572 7369 6f6e 206f An XML version o │ │ │ +000693a0: 6620 7468 6520 4341 4c53 2054 6162 6c65 f the CALS Table │ │ │ +000693b0: 204d 6f64 656c 2044 5444 0a64 6263 656e Model DTD.dbcen │ │ │ +000693c0: 7478 2e6d 6f64 2020 202d 2043 6861 7261 tx.mod - Chara │ │ │ +000693d0: 6374 6572 2065 6e74 6974 6965 730a 6462 cter entities.db │ │ │ +000693e0: 6765 6e65 6e74 2e65 6e74 2020 2d20 4765 genent.ent - Ge │ │ │ +000693f0: 6e65 7261 6c20 656e 7469 7469 6573 0a64 neral entities.d │ │ │ +00069400: 6268 6965 7278 2e6d 6f64 2020 202d 2054 bhierx.mod - T │ │ │ +00069410: 6865 2058 4d4c 2076 6572 7369 6f6e 206f he XML version o │ │ │ +00069420: 6620 7468 6520 6869 6572 6172 6368 7920 f the hierarchy │ │ │ +00069430: 6d6f 6475 6c65 0a64 626e 6f74 6e78 2e6d module.dbnotnx.m │ │ │ +00069440: 6f64 2020 202d 204e 6f74 6174 696f 6e73 od - Notations │ │ │ +00069450: 0a64 6270 6f6f 6c78 2e6d 6f64 2020 202d .dbpoolx.mod - │ │ │ +00069460: 2054 6865 2058 4d4c 2076 6572 7369 6f6e The XML version │ │ │ +00069470: 206f 6620 7468 6520 696e 666f 726d 6174 of the informat │ │ │ +00069480: 696f 6e20 706f 6f6c 206d 6f64 756c 650a ion pool module. │ │ │ +00069490: 646f 6362 6f6f 6b78 2e64 7464 2020 2d20 docbookx.dtd - │ │ │ +000694a0: 5468 6520 584d 4c20 7665 7273 696f 6e20 The XML version │ │ │ +000694b0: 6f66 2074 6865 2044 6f63 426f 6f6b 2033 of the DocBook 3 │ │ │ +000694c0: 2e31 2044 5444 0a73 6f65 7874 626c 782e .1 DTD.soextblx. │ │ │ +000694d0: 6474 6420 202d 2041 6e20 584d 4c20 7665 dtd - An XML ve │ │ │ +000694e0: 7273 696f 6e20 6f66 2074 6865 204f 4153 rsion of the OAS │ │ │ +000694f0: 4953 2045 7863 6861 6e67 6520 5461 626c IS Exchange Tabl │ │ │ +00069500: 6520 6d6f 6465 6c0a 7465 7374 2e78 6d6c e model.test.xml │ │ │ +00069510: 2020 2020 2020 2d20 4120 7465 7374 2064 - A test d │ │ │ +00069520: 6f63 756d 656e 740a 656e 742f 2020 2020 ocument.ent/ │ │ │ +00069530: 2020 2020 2020 2d20 584d 4c20 7665 7273 - XML vers │ │ │ +00069540: 696f 6e73 206f 6620 7468 6520 4953 4f20 ions of the ISO │ │ │ +00069550: 656e 7469 7479 2073 6574 730a 0a49 6e73 entity sets..Ins │ │ │ +00069560: 7461 6c6c 6174 696f 6e0a 2d2d 2d2d 2d2d tallation.------ │ │ │ +00069570: 2d2d 2d2d 2d2d 0a0a 506c 6163 6520 7468 ------..Place th │ │ │ +00069580: 6520 6669 6c65 7320 696e 2074 6869 7320 e files in this │ │ │ +00069590: 6469 7374 7269 6275 7469 6f6e 2073 6f6d distribution som │ │ │ +000695a0: 6577 6865 7265 206f 6e20 796f 7572 206d ewhere on your m │ │ │ +000695b0: 6163 6869 6e65 2e20 2041 646a 7573 740a achine. Adjust. │ │ │ +000695c0: 796f 7572 2063 6174 616c 6f67 2873 2920 your catalog(s) │ │ │ +000695d0: 6966 2061 7070 726f 7072 6961 7465 2028 if appropriate ( │ │ │ +000695e0: 584d 4c20 746f 6f6c 7320 6672 6571 7565 XML tools freque │ │ │ +000695f0: 6e74 6c79 2064 6f20 6e6f 7420 7375 7070 ntly do not supp │ │ │ +00069600: 6f72 7420 0a63 6174 616c 6f67 732c 2073 ort .catalogs, s │ │ │ +00069610: 6f20 7468 6973 206d 6179 2062 6520 6972 o this may be ir │ │ │ +00069620: 7265 6c65 7661 6e74 2066 6f72 2079 6f75 relevant for you │ │ │ +00069630: 292e 0a0a 506c 6561 7365 2075 7365 2074 )...Please use t │ │ │ +00069640: 6865 2066 6f6c 6c6f 7769 6e67 2066 6f72 he following for │ │ │ +00069650: 6d61 6c20 7075 626c 6963 2069 6465 6e74 mal public ident │ │ │ +00069660: 6966 6965 7220 746f 2069 6465 6e74 6966 ifier to identif │ │ │ +00069670: 7920 7468 6973 2044 5444 3a0a 0a22 2d2f y this DTD:.."-/ │ │ │ +00069680: 2f4e 6f72 6d61 6e20 5761 6c73 682f 2f44 /Norman Walsh//D │ │ │ +00069690: 5444 2044 6f63 426b 2058 4d4c 2056 332e TD DocBk XML V3. │ │ │ +000696a0: 312e 372f 2f45 4e22 0a0a 466f 7220 6578 1.7//EN"..For ex │ │ │ +000696b0: 616d 706c 652c 2069 6620 796f 7572 2064 ample, if your d │ │ │ +000696c0: 6f63 756d 656e 7427 7320 746f 702d 6c65 ocument's top-le │ │ │ +000696d0: 7665 6c20 656c 656d 656e 7420 6973 203c vel element is < │ │ │ +000696e0: 626f 6f6b 3e2c 2061 6e64 0a79 6f75 2061 book>, and.you a │ │ │ +000696f0: 7265 2075 7369 6e67 2044 6f63 426b 2058 re using DocBk X │ │ │ +00069700: 4d4c 2064 6972 6563 746c 792c 2075 7365 ML directly, use │ │ │ +00069710: 2074 6865 2046 5049 2069 6e20 7468 6520 the FPI in the │ │ │ +00069720: 444f 4354 5950 450a 6465 636c 6172 6174 DOCTYPE.declarat │ │ │ +00069730: 696f 6e3a 0a0a 3c21 444f 4354 5950 4520 ion:....Or, i │ │ │ +000697c0: 6620 796f 7520 6861 7665 2061 2068 6967 f you have a hig │ │ │ +000697d0: 6865 722d 6c65 7665 6c20 6472 6976 6572 her-level driver │ │ │ +000697e0: 2066 696c 6520 7468 6174 2063 7573 746f file that custo │ │ │ +000697f0: 6d69 7a65 7320 446f 6342 6b20 584d 4c2c mizes DocBk XML, │ │ │ +00069800: 0a75 7365 2074 6865 2046 5049 2069 6e20 .use the FPI in │ │ │ +00069810: 7468 6520 7061 7261 6d65 7465 7220 656e the parameter en │ │ │ +00069820: 7469 7479 2064 6563 6c61 7261 7469 6f6e tity declaration │ │ │ +00069830: 3a0a 0a3c 2145 4e54 4954 5920 2520 446f :...%DocBkXML;. │ │ │ +000698c0: 0a0a 436f 7079 7269 6768 740a 2d2d 2d2d ..Copyright.---- │ │ │ +000698d0: 2d2d 2d2d 2d0a 0a43 6f70 7972 6967 6874 -----..Copyright │ │ │ +000698e0: 2028 4329 2031 3939 382c 2031 3939 3920 (C) 1998, 1999 │ │ │ +000698f0: 4e6f 726d 616e 2057 616c 7368 0a0a 5365 Norman Walsh..Se │ │ │ +00069900: 6520 434f 5059 5249 4748 5420 666f 7220 e COPYRIGHT for │ │ │ +00069910: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ +00069920: 0a0a 5761 7272 616e 7479 0a2d 2d2d 2d2d ..Warranty.----- │ │ │ +00069930: 2d2d 2d0a 0a54 4845 2053 4f46 5457 4152 ---..THE SOFTWAR │ │ │ +00069940: 4520 4953 2050 524f 5649 4445 4420 2241 E IS PROVIDED "A │ │ │ +00069950: 5320 4953 222c 2057 4954 484f 5554 2057 S IS", WITHOUT W │ │ │ +00069960: 4152 5241 4e54 5920 4f46 2041 4e59 204b ARRANTY OF ANY K │ │ │ +00069970: 494e 442c 0a45 5850 5245 5353 204f 5220 IND,.EXPRESS OR │ │ │ +00069980: 494d 504c 4945 442c 2049 4e43 4c55 4449 IMPLIED, INCLUDI │ │ │ +00069990: 4e47 2042 5554 204e 4f54 204c 494d 4954 NG BUT NOT LIMIT │ │ │ +000699a0: 4544 2054 4f20 5448 4520 5741 5252 414e ED TO THE WARRAN │ │ │ +000699b0: 5449 4553 0a4f 4620 4d45 5243 4841 4e54 TIES.OF MERCHANT │ │ │ +000699c0: 4142 494c 4954 592c 2046 4954 4e45 5353 ABILITY, FITNESS │ │ │ +000699d0: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ +000699e0: 5220 5055 5250 4f53 4520 414e 440a 4e4f R PURPOSE AND.NO │ │ │ +000699f0: 4e49 4e46 5249 4e47 454d 454e 542e 2020 NINFRINGEMENT. │ │ │ +00069a00: 494e 204e 4f20 4556 454e 5420 5348 414c IN NO EVENT SHAL │ │ │ +00069a10: 4c20 4e4f 524d 414e 2057 414c 5348 204f L NORMAN WALSH O │ │ │ +00069a20: 5220 414e 5920 4f54 4845 520a 434f 4e54 R ANY OTHER.CONT │ │ │ +00069a30: 5249 4255 544f 5220 4245 204c 4941 424c RIBUTOR BE LIABL │ │ │ +00069a40: 4520 464f 5220 414e 5920 434c 4149 4d2c E FOR ANY CLAIM, │ │ │ +00069a50: 2044 414d 4147 4553 204f 5220 4f54 4845 DAMAGES OR OTHE │ │ │ +00069a60: 5220 4c49 4142 494c 4954 592c 0a57 4845 R LIABILITY,.WHE │ │ │ +00069a70: 5448 4552 2049 4e20 414e 2041 4354 494f THER IN AN ACTIO │ │ │ +00069a80: 4e20 4f46 2043 4f4e 5452 4143 542c 2054 N OF CONTRACT, T │ │ │ +00069a90: 4f52 5420 4f52 204f 5448 4552 5749 5345 ORT OR OTHERWISE │ │ │ +00069aa0: 2c20 4152 4953 494e 470a 4652 4f4d 2c20 , ARISING.FROM, │ │ │ +00069ab0: 4f55 5420 4f46 204f 5220 494e 2043 4f4e OUT OF OR IN CON │ │ │ +00069ac0: 4e45 4354 494f 4e20 5749 5448 2054 4845 NECTION WITH THE │ │ │ +00069ad0: 2053 4f46 5457 4152 4520 4f52 2054 4845 SOFTWARE OR THE │ │ │ +00069ae0: 2055 5345 204f 520a 4f54 4845 5220 4445 USE OR.OTHER DE │ │ │ +00069af0: 414c 494e 4753 2049 4e20 5448 4520 534f ALINGS IN THE SO │ │ │ +00069b00: 4654 5741 5245 2e0a 0a43 6f6e 7461 6374 FTWARE...Contact │ │ │ +00069b10: 696e 6720 7468 6520 4175 7468 6f72 0a2d ing the Author.- │ │ │ +00069b20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ +00069b30: 2d2d 2d2d 0a0a 5468 6973 2044 5444 2069 ----..This DTD i │ │ │ +00069b40: 7320 6d61 696e 7461 696e 6564 2062 7920 s maintained by │ │ │ +00069b50: 4e6f 726d 616e 2057 616c 7368 2c20 3c6e Norman Walsh, .. │ │ │ +00069b70: 0a54 6865 2062 6573 7420 7761 7920 746f .The best way to │ │ │ +00069b80: 2072 6561 6368 206e 6f72 6d20 6973 2062 reach norm is b │ │ │ +00069b90: 7920 656d 6169 6c2e 2020 596f 7520 7769 y email. You wi │ │ │ +00069ba0: 6c6c 2066 696e 6420 6164 6469 7469 6f6e ll find addition │ │ │ +00069bb0: 616c 0a63 6f6e 7461 6374 2069 6e66 6f72 al.contact infor │ │ │ +00069bc0: 6d61 7469 6f6e 2061 7420 6874 7470 3a2f mation at http:/ │ │ │ +00069bd0: 2f6e 7761 6c73 682e 636f 6d2f 646f 6362 /nwalsh.com/docb │ │ │ +00069be0: 6f6f 6b2f 786d 6c2f 0ab6 0000 0020 6465 ook/xml/..... de │ │ │ +00069bf0: 6d6f 2f64 6f63 7372 632f 446f 6342 6f6f mo/docsrc/DocBoo │ │ │ +00069c00: 6b2f 6361 6c73 7462 6c78 2e64 7464 df00 k/calstblx.dtd.. │ │ │ +00069c10: 0020 673c 212d 2d20 2e2e 2e2e 2e2e 2e2e . g.....< │ │ │ -0006a260: 215b 2565 7861 6d70 6c65 2e6d 6f64 756c ![%example.modul │ │ │ -0006a270: 653b 5b0a 3c21 454e 5449 5459 2025 206c e;[.....< │ │ │ -0006a2f0: 215b 2565 7861 6d70 6c65 2e65 6c65 6d65 ![%example.eleme │ │ │ -0006a300: 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 2065 nt;[..]]>....] │ │ │ -0006a440: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6578 ]>.] │ │ │ -0006a460: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>.. │ │ │ -0006a490: 0a3c 215b 2569 6e66 6f72 6d61 6c65 7861 .... │ │ │ -0006a540: 0a3c 215b 2569 6e66 6f72 6d61 6c65 7861 ..]]>....]]>. │ │ │ -0006a6d0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>. │ │ │ -0006a930: 3c21 2d2d 2043 616c 6c6f 7574 4c69 7374 .]]>.........]]>....... │ │ │ -0006b030: 0a3c 212d 2d65 6e64 206f 6620 6172 6561 .] │ │ │ -0006b050: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6172 ]>. │ │ │ -0006b070: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]] │ │ │ -0006b160: 3e0a 0a3c 212d 2d20 6275 6720 6e75 6d62 >......... │ │ │ -0006b280: 3c21 5b25 6172 6561 2e61 7474 6c69 7374 .]] │ │ │ -0006b3c0: 3e0a 3c21 2d2d 656e 6420 6f66 2061 7265 >.]]>.. │ │ │ -0006b3e0: 3c21 454e 5449 5459 2025 2061 7265 6173 ....< │ │ │ -0006b470: 2145 4e54 4954 5920 2520 6172 6561 7365 !ENTITY % arease │ │ │ -0006b480: 742e 656c 656d 656e 7420 2249 4e43 4c55 t.element "INCLU │ │ │ -0006b490: 4445 223e 0a3c 215b 2561 7265 6173 6574 DE">..]]>....... │ │ │ -0006b5b0: 3c21 5b25 6172 6561 7365 742e 6174 746c .]]>.]]>. │ │ │ -0006b730: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.. │ │ │ -0006b760: 0a3c 215b 2570 726f 6772 616d 6c69 7374 .... │ │ │ -0006b7e0: 3c21 454e 5449 5459 2025 2070 726f 6772 ..]]>....]]>. │ │ │ -0006b9c0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ -0006b9f0: 3c21 5b25 6c69 7465 7261 6c6c 6179 6f75 .....]]>.... │ │ │ -0006bc40: 5d5d 3e0a 3c21 2d2d 204c 696e 6541 6e6e ]]>.]]>... │ │ │ -0006bcd0: 3c21 5b25 7363 7265 656e 636f 2e6d 6f64 ..... │ │ │ -0006bdb0: 3c21 2d2d 656e 6420 6f66 2073 6372 6565 ]] │ │ │ -0006bdd0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7363 >....]]>...]]>.. │ │ │ -0006bf20: 0a3c 215b 2573 6372 6565 6e2e 6d6f 6475 ......]]>.... │ │ │ -0006c110: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....... │ │ │ -0006c200: 3c21 454e 5449 5459 2025 2073 6372 6565 ..]]>.]]>. │ │ │ -0006c3d0: 0a3c 2145 4e54 4954 5920 2520 7363 7265 .......]]>....]] │ │ │ -0006c5c0: 3e0a 3c21 2d2d 656e 6420 6f66 2073 6372 >.]]>. │ │ │ -0006c610: 0a3c 212d 2d20 4669 6775 7265 7320 6574 .........]]>.......] │ │ │ -0006c930: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6669 ]>.]] │ │ │ -0006c950: 3e0a 0a3c 2145 4e54 4954 5920 2520 696e >...< │ │ │ -0006c980: 215b 2025 696e 666f 726d 616c 6669 6775 ![ %informalfigu │ │ │ -0006c990: 7265 2e6d 6f64 756c 653b 205b 0a3c 2145 re.module; [.... │ │ │ -0006ca00: 3c21 454e 5449 5459 2025 2069 6e66 6f72 .. │ │ │ -0006cab0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.....]]>.]]>........]]>.. │ │ │ -0006cdf0: 3c21 454e 5449 5459 2025 2067 7261 7068 ..]]>. │ │ │ -0006ceb0: 3c21 2d2d 2041 7265 6153 7065 6320 2864 ..]]>......... │ │ │ -0006d0b0: 0a3c 212d 2d65 6e64 206f 6620 6772 6170 .]] │ │ │ -0006d0d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6772 >....]]>.]]>.......< │ │ │ -0006d290: 215b 2569 6e6c 696e 6567 7261 7068 6963 ![%inlinegraphic │ │ │ -0006d2a0: 2e65 6c65 6d65 6e74 3b5b 0a3c 2145 4c45 .element;[..]]> │ │ │ -0006d2f0: 0a0a 3c21 454e 5449 5459 2025 2069 6e6c ....]]>. │ │ │ -0006d400: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.........]] │ │ │ -0006d5f0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6d65 >....]]> │ │ │ -0006d6c0: 0a3c 212d 2d65 6e64 206f 6620 6d65 6469 .]]>....]]>.< │ │ │ -0006d990: 212d 2d65 6e64 206f 6620 696e 6c69 6e65 !--end of inline │ │ │ -0006d9a0: 6d65 6469 616f 626a 6563 742e 6d6f 6475 mediaobject.modu │ │ │ -0006d9b0: 6c65 2d2d 3e5d 5d3e 0a0a 3c21 454e 5449 le-->]]>....... │ │ │ -0006dad0: 0a3c 212d 2d65 6e64 206f 6620 7669 6465 .]]>....... │ │ │ -0006dd00: 0a3c 212d 2d65 6e64 206f 6620 6175 6469 .]]>....... │ │ │ -0006df30: 0a3c 212d 2d65 6e64 206f 6620 696d 6167 .]]>....... │ │ │ -0006e110: 3c21 5b20 2574 6578 746f 626a 6563 742e .]]> │ │ │ -0006e190: 0a0a 3c21 454e 5449 5459 2025 2074 6578 ....]]>.]]>........]]>... │ │ │ -0006e4b0: 0a3c 212d 2d65 6e64 206f 6620 6f62 6a65 .]]>.. │ │ │ -0006e550: 0a3c 212d 2d46 696c 6552 6566 3a20 4669 .. │ │ │ -0006e5d0: 3c21 2d2d 466f 726d 6174 3a20 4e6f 7461 .]]>........ │ │ │ -0006e9a0: 3c21 4154 544c 4953 5420 7669 6465 6f64 .]]>... │ │ │ -0006eb20: 3c21 5b20 2561 7564 696f 6461 7461 2e6d .< │ │ │ -0006eb60: 2145 4e54 4954 5920 2520 6175 6469 6f64 !ENTITY % audiod │ │ │ -0006eb70: 6174 612e 726f 6c65 2e61 7474 7269 6220 ata.role.attrib │ │ │ -0006eb80: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ -0006eb90: 0a0a 3c21 454e 5449 5459 2025 2061 7564 ....< │ │ │ -0006ebf0: 212d 2d65 6e64 206f 6620 6175 6469 6f64 !--end of audiod │ │ │ -0006ec00: 6174 612e 656c 656d 656e 742d 2d3e 5d5d ata.element-->]] │ │ │ -0006ec10: 3e0a 0a3c 2145 4e54 4954 5920 2520 6175 >....]]>.]]>.......< │ │ │ -0006edd0: 215b 2025 696d 6167 6564 6174 612e 656c ![ %imagedata.el │ │ │ -0006ede0: 656d 656e 743b 205b 0a3c 2145 4c45 4d45 ement; [..]]>... │ │ │ -0006ee50: 3c21 5b20 2569 6d61 6765 6461 7461 2e61 .< │ │ │ -0006eea0: 212d 2d44 6570 7468 3a20 5361 6d65 2061 !--Depth: Same a │ │ │ -0006eeb0: 7320 4341 4c53 2072 6570 726f 6465 7020 s CALS reprodep │ │ │ -0006eec0: 2864 6573 6972 6564 2064 6570 7468 292d (desired depth)- │ │ │ -0006eed0: 2d3e 0a3c 212d 2d41 6c69 676e 3a20 5361 ->.. │ │ │ -0006ef30: 3c21 2d2d 5363 616c 653a 2043 6f6e 666c ..]]>. │ │ │ -0006f0c0: 3c21 2d2d 656e 6420 6f66 2069 6d61 6765 ]] │ │ │ -0006f0e0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6361 >........]]>.. │ │ │ -0006f220: 0a3c 215b 2025 6361 7074 696f 6e2e 6174 .. │ │ │ -0006f290: 3c21 2d2d 656e 6420 6f66 2063 6170 7469 ]]> │ │ │ -0006f2b0: 0a3c 212d 2d65 6e64 206f 6620 6361 7074 .]]> │ │ │ -0006f2d0: 0a0a 3c21 454e 5449 5459 2025 206d 6564 ........]]>....]]>. │ │ │ -0006f520: 3c21 2d2d 656e 6420 6f66 206d 6564 6961 ]]>. │ │ │ -0006f6a0: 0a3c 2145 4e54 4954 5920 2520 696d 6167 ...]]>.]]> │ │ │ -0006f7a0: 0a3c 212d 2d65 6e64 206f 6620 6d65 6469 .]]>.... │ │ │ -0006f840: 0a3c 212d 2d20 7065 7268 6170 7320 6164 . │ │ │ -0006f880: 0a3c 2145 4e54 4954 5920 2520 6571 7561 .. │ │ │ -0006f8c0: 3c21 454e 5449 5459 2025 2069 6e6c 696e ......< │ │ │ -0006f9a0: 2145 4e54 4954 5920 2520 6571 7561 7469 !ENTITY % equati │ │ │ -0006f9b0: 6f6e 2e65 6c65 6d65 6e74 2022 494e 434c on.element "INCL │ │ │ -0006f9c0: 5544 4522 3e0a 3c21 5b25 6571 7561 7469 UDE">..]]>. │ │ │ -0006fa60: 0a3c 2145 4e54 4954 5920 2520 6571 7561 ...]]>.]]>..< │ │ │ -0006fb50: 2145 4e54 4954 5920 2520 696e 666f 726d !ENTITY % inform │ │ │ -0006fb60: 616c 6571 7561 7469 6f6e 2e6d 6f64 756c alequation.modul │ │ │ -0006fb70: 6520 2249 4e43 4c55 4445 223e 0a3c 215b e "INCLUDE">.. │ │ │ -0006fc00: 0a0a 3c21 454e 5449 5459 2025 2069 6e66 .. │ │ │ -0006fc30: 0a3c 215b 2569 6e66 6f72 6d61 6c65 7175 ..]]>....]]>.]]>. │ │ │ -0006fdc0: 0a3c 2145 4e54 4954 5920 2520 696e 6c69 .......] │ │ │ -0006ff10: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>.. │ │ │ -0006ff40: 0a3c 215b 2569 6e6c 696e 6565 7175 6174 ..]] │ │ │ -0006fff0: 3e0a 3c21 2d2d 656e 6420 6f66 2069 6e6c >.]]>........] │ │ │ -00070100: 5d3e 0a0a 3c21 454e 5449 5459 2025 2061 ]>....]]> │ │ │ -000701a0: 0a3c 212d 2d65 6e64 206f 6620 616c 742e .]]>........< │ │ │ -000702b0: 2145 4e54 4954 5920 2520 6361 6c73 2e74 !ENTITY % cals.t │ │ │ -000702c0: 6162 6c65 2e6d 6f64 756c 6520 2249 4e43 able.module "INC │ │ │ -000702d0: 4c55 4445 223e 0a3c 215b 2563 616c 732e LUDE">..]]>............ │ │ │ -000704f0: 0a3c 212d 2d20 436f 6e74 656e 7420 6d6f ......]]>............< │ │ │ -00070890: 2145 4e54 4954 5920 2520 7462 6c2e 7462 !ENTITY % tbl.tb │ │ │ -000708a0: 6f64 792e 6174 7420 2020 2020 2020 2022 ody.att " │ │ │ -000708b0: 2563 6f6d 6d6f 6e2e 6174 7472 6962 3b22 %common.attrib;" │ │ │ -000708c0: 3e0a 3c21 454e 5449 5459 2025 2074 626c >........]]>..... │ │ │ -00070be0: 3c21 454e 5449 5459 2025 206c 6f63 616c ....] │ │ │ -00070cb0: 5d3e 0a0a 3c21 2d2d 2046 7261 6d65 2c20 ]>... │ │ │ -00070d20: 3c21 2d2d 2069 6e63 6c75 6465 7320 5461 ...... │ │ │ -00070dd0: 3c21 5b25 696e 666f 726d 616c 7461 626c .]]> │ │ │ -00070f10: 0a3c 212d 2d65 6e64 206f 6620 696e 666f .]]>............ │ │ │ -000710c0: 3c21 5b25 7379 6e6f 7073 6973 2e65 6c65 .]]>..< │ │ │ -00071150: 2145 4e54 4954 5920 2520 7379 6e6f 7073 !ENTITY % synops │ │ │ -00071160: 6973 2e61 7474 6c69 7374 2022 494e 434c is.attlist "INCL │ │ │ -00071170: 5544 4522 3e0a 3c21 5b25 7379 6e6f 7073 UDE">.. │ │ │ -00071210: 3c21 2d2d 656e 6420 6f66 2073 796e 6f70 ]] │ │ │ -00071230: 3e0a 0a3c 212d 2d20 4c69 6e65 416e 6e6f >..] │ │ │ -00071290: 5d3e 0a0a 3c21 2d2d 2043 6d64 5379 6e6f ]>... │ │ │ -000712c0: 0a3c 2145 4e54 4954 5920 2520 636d 6473 .... │ │ │ -000713b0: 0a0a 3c21 454e 5449 5459 2025 2063 6d64 ....] │ │ │ -00071460: 5d3e 0a0a 3c21 2d2d 2053 6570 6368 6172 ]>...... │ │ │ -00071510: 3c21 5b25 636d 6473 796e 6f70 7369 732e . │ │ │ -000715d0: 3c21 2d2d 656e 6420 6f66 2063 6d64 7379 ]]>........] │ │ │ -00071750: 5d3e 0a0a 3c21 2d2d 2043 686f 6963 653a ]>... │ │ │ -00071880: 0a0a 0a3c 2145 4e54 4954 5920 2520 6172 .....] │ │ │ -00071970: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6172 ]>.]]>.. │ │ │ -00071990: 3c21 454e 5449 5459 2025 2067 726f 7570 ...... │ │ │ -00071ac0: 5d5d 3e0a 0a3c 212d 2d20 4368 6f69 6365 ]]>...< │ │ │ -00071c00: 212d 2d20 5265 703a 2077 6865 7468 6572 !-- Rep: whether │ │ │ -00071c10: 2047 726f 7570 2069 7320 7265 7065 6174 Group is repeat │ │ │ -00071c20: 6162 6c65 3a20 4e6f 7265 7065 6174 2028 able: Norepeat ( │ │ │ -00071c30: 652e 672e 2067 726f 7570 200a 0909 7769 e.g. group ...wi │ │ │ -00071c40: 7468 6f75 7420 656c 6c69 7073 6973 3b20 thout ellipsis; │ │ │ -00071c50: 7468 6520 6465 6661 756c 7429 2c20 6f72 the default), or │ │ │ -00071c60: 2052 6570 6561 7420 2865 2e67 2e20 6772 Repeat (e.g. gr │ │ │ -00071c70: 6f75 702e 2e2e 2920 2d2d 3e0a 0a0a 3c21 oup...) -->.....]]> │ │ │ -00071d80: 0a3c 212d 2d65 6e64 206f 6620 6772 6f75 .]]>.. │ │ │ -00071da0: 3c21 454e 5449 5459 2025 2073 6272 2e6d │ │ │ -00071dc0: 0a3c 215b 2573 6272 2e6d 6f64 756c 653b ....... │ │ │ -00071e80: 3c21 2d2d 656e 6420 6f66 2073 6272 2e65 ]]>... │ │ │ -00071ec0: 3c21 5b25 7362 722e 6174 746c 6973 743b .]]>.]]>.......]]>.]]>........ │ │ │ -00072340: 3c21 2d2d 656e 6420 6f66 2073 796e 6f70 ]]>....< │ │ │ -00072420: 212d 2d65 6e64 206f 6620 7379 6e6f 7066 !--end of synopf │ │ │ -00072430: 7261 676d 656e 742e 6174 746c 6973 742d ragment.attlist- │ │ │ -00072440: 2d3e 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 ->]]>.]]>..... │ │ │ -00072540: 5d5d 3e0a 0a3c 212d 2d20 4675 6e63 5379 ]]>.. │ │ │ -00072570: 0a0a 3c21 454e 5449 5459 2025 2066 756e .... │ │ │ -000725f0: 3c21 5b25 6675 6e63 7379 6e6f 7073 6973 ..... │ │ │ -00072710: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ -00072740: 3c21 5b25 6675 6e63 7379 6e6f 7073 6973 .]]>.]]>..... │ │ │ -000728d0: 0a3c 2145 4e54 4954 5920 2520 6675 6e63 .. │ │ │ -00072900: 3c21 5b25 6675 6e63 7379 6e6f 7073 6973 .< │ │ │ -00072960: 212d 2d65 6e64 206f 6620 6675 6e63 7379 !--end of funcsy │ │ │ -00072970: 6e6f 7073 6973 696e 666f 2e65 6c65 6d65 nopsisinfo.eleme │ │ │ -00072980: 6e74 2d2d 3e5d 5d3e 0a0a 3c21 454e 5449 nt-->]]>....]]>.]]>....< │ │ │ -00072cc0: 212d 2d65 6e64 206f 6620 6675 6e63 7072 !--end of funcpr │ │ │ -00072cd0: 6f74 6f74 7970 652e 6174 746c 6973 742d ototype.attlist- │ │ │ -00072ce0: 2d3e 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 ->]]>.]]>........]]>.]]>... │ │ │ -00072f60: 0a3c 2145 4e54 4954 5920 2520 766f 6964 ...< │ │ │ -00072f90: 2145 4e54 4954 5920 2520 766f 6964 2e65 !ENTITY % void.e │ │ │ -00072fa0: 6c65 6d65 6e74 2022 494e 434c 5544 4522 lement "INCLUDE" │ │ │ -00072fb0: 3e0a 3c21 5b25 766f 6964 2e65 6c65 6d65 >..]]>....]]>.]]>...< │ │ │ -000730e0: 215b 2576 6172 6172 6773 2e6d 6f64 756c ![%varargs.modul │ │ │ -000730f0: 653b 5b0a 3c21 454e 5449 5459 2025 206c e;[.....< │ │ │ -00073170: 215b 2576 6172 6172 6773 2e65 6c65 6d65 ![%varargs.eleme │ │ │ -00073180: 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 2076 nt;[..]]>.. │ │ │ -000731c0: 3c21 454e 5449 5459 2025 2076 6172 6172 .. │ │ │ -00073270: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2076 ]]>. │ │ │ -00073290: 5d5d 3e0a 0a3c 212d 2d20 5072 6f63 6573 ]]>......... │ │ │ -00073440: 3c21 5b25 7061 7261 6d64 6566 2e65 6c65 .]]>... │ │ │ -000734f0: 3c21 5b25 7061 7261 6d64 6566 2e61 7474 │ │ │ -00073560: 0a3c 212d 2d65 6e64 206f 6620 7061 7261 .] │ │ │ -00073580: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7061 ]>. │ │ │ +0006a230: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0006a240: 2e2e 2e2e 2e2e 2e2e 2e20 2d2d 3e0a 0a3c ......... -->..< │ │ │ +0006a250: 212d 2d20 5468 6973 206d 6f64 756c 6520 !-- This module │ │ │ +0006a260: 636f 6e74 6169 6e73 2074 6865 2064 6566 contains the def │ │ │ +0006a270: 696e 6974 696f 6e73 2066 6f72 2074 6865 initions for the │ │ │ +0006a280: 2043 414c 5320 5461 626c 6520 4d6f 6465 CALS Table Mode │ │ │ +0006a290: 6c0a 2020 2020 2063 6f6e 7665 7274 6564 l. converted │ │ │ +0006a2a0: 2074 6f20 584d 4c2e 0a2d 2d3e 0a0a 3c21 to XML..-->....... │ │ │ +0006a3c0: 3c21 2d2d 206e 6f20 6966 207a 6572 6f28 .... │ │ │ +0006a450: 0a3c 212d 2d20 6465 6661 756c 7420 666f ..................< │ │ │ +0006a9d0: 212d 2d20 3d3d 3d3d 3d20 2045 6c65 6d65 !-- ===== Eleme │ │ │ +0006a9e0: 6e74 2061 6e64 2061 7474 7269 6275 7465 nt and attribute │ │ │ +0006a9f0: 2064 6563 6c61 7261 7469 6f6e 7320 666f declarations fo │ │ │ +0006aa00: 6c6c 6f77 2e20 3d3d 3d3d 3d20 202d 2d3e llow. ===== --> │ │ │ +0006aa10: 0a0a 3c21 454c 454d 454e 5420 7461 626c ............. │ │ │ +0006aff0: 0a3c 2145 4c45 4d45 4e54 2073 7061 6e73 ...... │ │ │ +0006b290: 3c21 4154 544c 4953 5420 7468 6561 640a .........< │ │ │ +0006b410: 2145 4c45 4d45 4e54 2072 6f77 2028 2574 !ELEMENT row (%t │ │ │ +0006b420: 626c 2e72 6f77 2e6d 646c 3b29 3e0a 0a3c bl.row.mdl;)>..< │ │ │ +0006b430: 2141 5454 4c49 5354 2072 6f77 0a20 2020 !ATTLIST row. │ │ │ +0006b440: 2020 2020 2072 6f77 7365 7020 2020 2020 rowsep │ │ │ +0006b450: 2020 2020 2025 7965 736f 726e 6f3b 2020 %yesorno; │ │ │ +0006b460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +0006b470: 2020 2020 2020 2020 2020 2020 2023 494d #IM │ │ │ +0006b480: 504c 4945 440a 2020 2020 2020 2020 7661 PLIED. va │ │ │ +0006b490: 6c69 676e 2020 2020 2020 2020 2020 2874 lign (t │ │ │ +0006b4a0: 6f70 7c6d 6964 646c 657c 626f 7474 6f6d op|middle|bottom │ │ │ +0006b4b0: 2920 2020 2020 2020 2020 2020 2020 2020 ) │ │ │ +0006b4c0: 2020 2020 2020 2349 4d50 4c49 4544 0a20 #IMPLIED. │ │ │ +0006b4d0: 2020 2020 2020 2025 7365 6375 723b 0a3e %secur;.> │ │ │ +0006b4e0: 0a0a 3c21 454c 454d 454e 5420 656e 7472 ................!d │ │ │ +0006bc80: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ +0006bc90: 6f6b 2f64 6274 626c 7863 6867 2e64 7464 ok/dbtblxchg.dtd │ │ │ +0006bca0: df00 0000 5d3c 2145 4e54 4954 5920 2520 ....]...%docbook; │ │ │ +0006bd00: 0a0a b600 0000 1f64 656d 6f2f 646f 6373 .......demo/docs │ │ │ +0006bd10: 7263 2f44 6f63 426f 6f6b 2f64 6270 6f6f rc/DocBook/dbpoo │ │ │ +0006bd20: 6c78 2e6d 6f64 df00 0321 a83c 212d 2d20 lx.mod...!...... │ │ │ +0006c2b0: 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +0006c300: 0a0a 3c21 2d2d 2054 6869 7320 6d6f 6475 ... │ │ │ +0006c7c0: 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +0006c810: 0a3c 212d 2d20 4765 6e65 7261 6c2d 7075 . │ │ │ +0006c860: 0a0a 3c21 454e 5449 5459 2025 2079 6573 ........... │ │ │ +0006ca30: 3c21 454e 5449 5459 2025 206c 6f63 616c . │ │ │ +0006ca90: 0a0a 3c21 2d2d 204f 626a 6563 742d 6c65 .......< │ │ │ +0006d110: 2145 4e54 4954 5920 2520 636f 6d70 6f75 !ENTITY % compou │ │ │ +0006d120: 6e64 2e63 6c61 7373 0a09 0922 6d73 6773 nd.class..."msgs │ │ │ +0006d130: 6574 7c70 726f 6365 6475 7265 7c73 6964 et|procedure|sid │ │ │ +0006d140: 6562 6172 7c71 616e 6461 7365 740a 2020 ebar|qandaset. │ │ │ +0006d150: 2020 2020 2020 2020 2020 2020 2020 2025 % │ │ │ +0006d160: 6562 6e66 2e62 6c6f 636b 2e68 6f6f 6b3b ebnf.block.hook; │ │ │ +0006d170: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ +0006d180: 2020 256c 6f63 616c 2e63 6f6d 706f 756e %local.compoun │ │ │ +0006d190: 642e 636c 6173 733b 223e 0a0a 3c21 454e d.class;">........< │ │ │ +0006d290: 212d 2d20 4368 6172 6163 7465 722d 6c65 !-- Character-le │ │ │ +0006d2a0: 7665 6c20 636c 6173 7365 7320 2e2e 2e2e vel classes .... │ │ │ +0006d2b0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0006d2c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0006d2d0: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a0a .......... -->.. │ │ │ +0006d2e0: 3c21 454e 5449 5459 2025 206c 6f63 616c ...< │ │ │ +0006d350: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +0006d360: 6765 6e2e 6368 6172 2e63 6c61 7373 2022 gen.char.class " │ │ │ +0006d370: 223e 0a3c 2145 4e54 4954 5920 2520 6765 ">........... │ │ │ +0006d580: 3c21 454e 5449 5459 2025 2074 6563 682e .. │ │ │ +0006d840: 0a3c 2145 4e54 4954 5920 2520 6261 7365 .. │ │ │ +0006d880: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ........ │ │ │ +0006d9f0: 3c21 454e 5449 5459 2025 2069 6e6c 696e │ │ │ +0006da60: 0a0a 3c21 2d2d 2052 6564 6563 6c61 7261 ......%rd │ │ │ +0006dbd0: 6270 6f6f 6c3b 0a3c 212d 2d65 6e64 206f bpool;.]]>....< │ │ │ +0006dc50: 212d 2d0a 2020 2020 2020 2020 2020 2020 !--. │ │ │ +0006dc60: 2020 2020 2020 2020 2020 6c69 7374 2061 list a │ │ │ +0006dc70: 646d 6e20 6c69 6e65 2073 796e 7020 7061 dmn line synp pa │ │ │ +0006dc80: 7261 2069 6e66 6d20 666f 726d 2063 6d70 ra infm form cmp │ │ │ +0006dc90: 6420 6765 6e20 2064 6573 630a 436f 6d70 d gen desc.Comp │ │ │ +0006dca0: 6f6e 656e 7420 6d69 7874 7572 6520 2020 onent mixture │ │ │ +0006dcb0: 2020 2020 5820 2020 2058 2020 2020 5820 X X X │ │ │ +0006dcc0: 2020 2058 2020 2020 5820 2020 2058 2020 X X X │ │ │ +0006dcd0: 2020 5820 2020 2058 2020 2020 5820 2020 X X X │ │ │ +0006dce0: 2058 0a53 6964 6562 6172 206d 6978 7475 X.Sidebar mixtu │ │ │ +0006dcf0: 7265 2020 2020 2020 2020 2058 2020 2020 re X │ │ │ +0006dd00: 5820 2020 2058 2020 2020 5820 2020 2058 X X X X │ │ │ +0006dd10: 2020 2020 5820 2020 2058 2020 2020 6120 X X a │ │ │ +0006dd20: 2020 2058 0a46 6f6f 746e 6f74 6520 6d69 X.Footnote mi │ │ │ +0006dd30: 7874 7572 6520 2020 2020 2020 2058 2020 xture X │ │ │ +0006dd40: 2020 2020 2020 2058 2020 2020 5820 2020 X X │ │ │ +0006dd50: 2058 2020 2020 580a 4578 616d 706c 6520 X X.Example │ │ │ +0006dd60: 6d69 7874 7572 6520 2020 2020 2020 2020 mixture │ │ │ +0006dd70: 5820 2020 2020 2020 2020 5820 2020 2058 X X X │ │ │ +0006dd80: 2020 2020 5820 2020 2058 0a48 6967 686c X X.Highl │ │ │ +0006dd90: 6967 6874 7320 6d69 7874 7572 6520 2020 ights mixture │ │ │ +0006dda0: 2020 2058 2020 2020 5820 2020 2020 2020 X X │ │ │ +0006ddb0: 2020 2020 2020 2058 0a50 6172 6167 7261 X.Paragra │ │ │ +0006ddc0: 7068 206d 6978 7475 7265 2020 2020 2020 ph mixture │ │ │ +0006ddd0: 2058 2020 2020 2020 2020 2058 2020 2020 X X │ │ │ +0006dde0: 5820 2020 2020 2020 2020 580a 4164 6d6f X X.Admo │ │ │ +0006ddf0: 6e69 7469 6f6e 206d 6978 7475 7265 2020 nition mixture │ │ │ +0006de00: 2020 2020 5820 2020 2020 2020 2020 5820 X X │ │ │ +0006de10: 2020 2058 2020 2020 5820 2020 2058 2020 X X X │ │ │ +0006de20: 2020 5820 2020 2062 2020 2020 630a 4669 X b c.Fi │ │ │ +0006de30: 6775 7265 206d 6978 7475 7265 2020 2020 gure mixture │ │ │ +0006de40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +0006de50: 5820 2020 2058 2020 2020 2020 2020 2058 X X X │ │ │ +0006de60: 0a54 6162 6c65 2065 6e74 7279 206d 6978 .Table entry mix │ │ │ +0006de70: 7475 7265 2020 2020 2058 2020 2020 5820 ture X X │ │ │ +0006de80: 2020 2058 2020 2020 2020 2020 2058 2020 X X │ │ │ +0006de90: 2020 640a 476c 6f73 7361 7279 2064 6566 d.Glossary def │ │ │ +0006dea0: 206d 6978 7475 7265 2020 2020 5820 2020 mixture X │ │ │ +0006deb0: 2020 2020 2020 5820 2020 2058 2020 2020 X X │ │ │ +0006dec0: 5820 2020 2058 2020 2020 2020 2020 2065 X X e │ │ │ +0006ded0: 0a4c 6567 616c 206e 6f74 6963 6520 6d69 .Legal notice mi │ │ │ +0006dee0: 7874 7572 6520 2020 2058 2020 2020 5820 xture X X │ │ │ +0006def0: 2020 2058 2020 2020 2020 2020 2058 2020 X X │ │ │ +0006df00: 2020 660a 0a61 2e20 4a75 7374 2050 726f f..a. Just Pro │ │ │ +0006df10: 6365 6475 7265 3b20 6e6f 7420 5369 6465 cedure; not Side │ │ │ +0006df20: 6261 7220 6974 7365 6c66 206f 7220 4d73 bar itself or Ms │ │ │ +0006df30: 6753 6574 2e0a 622e 204e 6f20 4d73 6753 gSet..b. No MsgS │ │ │ +0006df40: 6574 2e0a 632e 204e 6f20 4869 6768 6c69 et..c. No Highli │ │ │ +0006df50: 6768 7473 2e0a 642e 204a 7573 7420 4772 ghts..d. Just Gr │ │ │ +0006df60: 6170 6869 633b 206e 6f20 6f74 6865 7220 aphic; no other │ │ │ +0006df70: 696e 666f 726d 616c 206f 626a 6563 7473 informal objects │ │ │ +0006df80: 2e0a 652e 204e 6f20 416e 6368 6f72 2c20 ..e. No Anchor, │ │ │ +0006df90: 4272 6964 6765 4865 6164 2c20 6f72 2048 BridgeHead, or H │ │ │ +0006dfa0: 6967 686c 6967 6874 732e 0a66 2e20 4a75 ighlights..f. Ju │ │ │ +0006dfb0: 7374 2042 6c6f 636b 5175 6f74 653b 206e st BlockQuote; n │ │ │ +0006dfc0: 6f20 6f74 6865 7220 696e 666f 726d 616c o other informal │ │ │ +0006dfd0: 206f 626a 6563 7473 2e0a 2d2d 3e0a 0a3c objects..-->..< │ │ │ +0006dfe0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +0006dff0: 636f 6d70 6f6e 656e 742e 6d69 7820 2222 component.mix "" │ │ │ +0006e000: 3e0a 3c21 454e 5449 5459 2025 2063 6f6d >....< │ │ │ +0006e130: 2145 4e54 4954 5920 2520 7369 6465 6261 !ENTITY % sideba │ │ │ +0006e140: 722e 6d69 780a 0909 2225 6c69 7374 2e63 r.mix..."%list.c │ │ │ +0006e150: 6c61 7373 3b09 097c 2561 646d 6f6e 2e63 lass;..|%admon.c │ │ │ +0006e160: 6c61 7373 3b0a 0909 7c25 6c69 6e65 7370 lass;...|%linesp │ │ │ +0006e170: 6563 6966 6963 2e63 6c61 7373 3b09 7c25 ecific.class;.|% │ │ │ +0006e180: 7379 6e6f 702e 636c 6173 733b 0a09 097c synop.class;...| │ │ │ +0006e190: 2570 6172 612e 636c 6173 733b 0909 7c25 %para.class;..|% │ │ │ +0006e1a0: 696e 666f 726d 616c 2e63 6c61 7373 3b0a informal.class;. │ │ │ +0006e1b0: 0909 7c25 666f 726d 616c 2e63 6c61 7373 ..|%formal.class │ │ │ +0006e1c0: 3b09 097c 7072 6f63 6564 7572 650a 0909 ;..|procedure... │ │ │ +0006e1d0: 7c25 6765 6e6f 626a 2e63 6c61 7373 3b0a |%genobj.class;. │ │ │ +0006e1e0: 0909 7c25 6e64 7874 6572 6d2e 636c 6173 ..|%ndxterm.clas │ │ │ +0006e1f0: 733b 2020 2020 2020 2020 7c62 6567 696e s; |begin │ │ │ +0006e200: 7061 6765 0a09 0925 6c6f 6361 6c2e 7369 page...%local.si │ │ │ +0006e210: 6465 6261 722e 6d69 783b 223e 0a0a 3c21 debar.mix;">... │ │ │ +0006e240: 3c21 454e 5449 5459 2025 2071 616e 6461 ... │ │ │ +0006e350: 3c21 454e 5449 5459 2025 2072 6576 6465 ............................< │ │ │ +0006eaf0: 2145 4e54 4954 5920 2520 6c65 6761 6c6e !ENTITY % legaln │ │ │ +0006eb00: 6f74 6963 652e 6d69 780a 0909 2225 6c69 otice.mix..."%li │ │ │ +0006eb10: 7374 2e63 6c61 7373 3b09 097c 2561 646d st.class;..|%adm │ │ │ +0006eb20: 6f6e 2e63 6c61 7373 3b0a 0909 7c25 6c69 on.class;...|%li │ │ │ +0006eb30: 6e65 7370 6563 6966 6963 2e63 6c61 7373 nespecific.class │ │ │ +0006eb40: 3b0a 0909 7c25 7061 7261 2e63 6c61 7373 ;...|%para.class │ │ │ +0006eb50: 3b09 097c 626c 6f63 6b71 756f 7465 0a09 ;..|blockquote.. │ │ │ +0006eb60: 097c 256e 6478 7465 726d 2e63 6c61 7373 .|%ndxterm.class │ │ │ +0006eb70: 3b20 2020 2020 2020 207c 6265 6769 6e70 ; |beginp │ │ │ +0006eb80: 6167 650a 0909 256c 6f63 616c 2e6c 6567 age...%local.leg │ │ │ +0006eb90: 616c 6e6f 7469 6365 2e6d 6978 3b22 3e0a alnotice.mix;">. │ │ │ +0006eba0: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 .... │ │ │ +0006ec50: 3c21 454e 5449 5459 2025 206c 6f63 616c ...... │ │ │ +0006f0a0: 0a3c 2145 4e54 4954 5920 2520 666f 726d . │ │ │ +0006f0c0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 .......... │ │ │ +0006f460: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ..................... │ │ │ +0006fb80: 0a0a 3c21 2d2d 2043 6f6e 666f 726d 616e ....< │ │ │ +0006fbc0: 2145 4e54 4954 5920 2520 636f 6e66 6f72 !ENTITY % confor │ │ │ +0006fbd0: 6d61 6e63 652e 6174 7472 6962 0a09 2263 mance.attrib.."c │ │ │ +0006fbe0: 6f6e 666f 726d 616e 6365 094e 4d54 4f4b onformance.NMTOK │ │ │ +0006fbf0: 454e 5309 2349 4d50 4c49 4544 223e 0a0a ENS.#IMPLIED">.. │ │ │ +0006fc00: 0a3c 212d 2d20 4f53 3a20 4f70 6572 6174 ........ │ │ │ +0006fcc0: 3c21 454e 5449 5459 2025 2072 6576 6973 ... │ │ │ +0006fd30: 0a3c 2145 4e54 4954 5920 2520 7365 6375 .....< │ │ │ +0006fdc0: 2145 4e54 4954 5920 2520 7573 6572 6c65 !ENTITY % userle │ │ │ +0006fdd0: 7665 6c2e 6174 7472 6962 0a09 2275 7365 vel.attrib.."use │ │ │ +0006fde0: 726c 6576 656c 0943 4441 5441 0909 2349 rlevel.CDATA..#I │ │ │ +0006fdf0: 4d50 4c49 4544 223e 0a0a 0a3c 212d 2d20 MPLIED">... │ │ │ +0006fe40: 0a0a 3c21 454e 5449 5459 2025 2076 656e ..... │ │ │ +0006fea0: 3c21 454e 5449 5459 2025 2065 6666 6563 ..... │ │ │ +0006ffd0: 3c21 2d2d 2049 643a 2055 6e69 7175 6520 .. │ │ │ +00070030: 0a0a 0a3c 212d 2d20 4964 3a20 556e 6971 .............. │ │ │ +000701b0: 0a3c 2145 4e54 4954 5920 2520 7265 6d61 ...........< │ │ │ +00070300: 2145 4e54 4954 5920 2520 7872 6566 6c61 !ENTITY % xrefla │ │ │ +00070310: 6265 6c2e 6174 7472 6962 0a09 2278 7265 bel.attrib.."xre │ │ │ +00070320: 666c 6162 656c 0943 4441 5441 0909 2349 flabel.CDATA..#I │ │ │ +00070330: 4d50 4c49 4544 223e 0a0a 0a3c 212d 2d20 MPLIED">......................< │ │ │ +00070650: 212d 2d20 456e 7469 7479 5265 663a 204e !-- EntityRef: N │ │ │ +00070660: 616d 6520 6f66 2061 6e20 6578 7465 726e ame of an extern │ │ │ +00070670: 616c 2065 6e74 6974 7920 636f 6e74 6169 al entity contai │ │ │ +00070680: 6e69 6e67 2074 6865 2063 6f6e 7465 6e74 ning the content │ │ │ +00070690: 0a09 6f66 2074 6865 2067 7261 7068 6963 ..of the graphic │ │ │ +000706a0: 202d 2d3e 0a3c 212d 2d20 4669 6c65 5265 -->... │ │ │ +000707d0: 0a3c 212d 2d20 4465 7074 683a 2053 616d .......................... │ │ │ +00070eb0: 0a0a 3c21 454e 5449 5459 2025 206c 696e ........... │ │ │ +00070fa0: 3c21 454e 5449 5459 2025 206d 6f72 6569 .. │ │ │ +00070fe0: 0a3c 212d 2d20 5061 6765 6e75 6d3a 206e .....< │ │ │ +00071060: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +00071070: 7374 6174 7573 2e61 7474 7269 6220 2222 status.attrib "" │ │ │ +00071080: 3e0a 0a3c 212d 2d20 5374 6174 7573 3a20 >.........< │ │ │ +000711c0: 2145 4e54 4954 5920 2520 7769 6474 682e !ENTITY % width. │ │ │ +000711d0: 6174 7472 6962 0a09 2277 6964 7468 0909 attrib.."width.. │ │ │ +000711e0: 4344 4154 4109 0923 494d 504c 4945 4422 CDATA..#IMPLIED" │ │ │ +000711f0: 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e >..]]>....] │ │ │ +00071450: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7469 ]>.]]> │ │ │ +00071470: 0a0a 3c21 454e 5449 5459 2025 2074 6974 ..... │ │ │ +00071510: 0a3c 2145 4e54 4954 5920 2520 7469 746c ... │ │ │ +00071580: 3c21 2d2d 656e 6420 6f66 2074 6974 6c65 ]] │ │ │ +00071670: 3e0a 3c21 2d2d 656e 6420 6f66 2074 6974 >.]] │ │ │ +000717b0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7375 >....]]>.]]>..< │ │ │ +00071890: 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e !-- ............ │ │ │ +000718a0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000718b0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000718c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000718d0: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a3c .......... -->.< │ │ │ +000718e0: 212d 2d20 4269 626c 696f 6772 6170 6869 !-- Bibliographi │ │ │ +000718f0: 6320 656e 7469 7469 6573 2061 6e64 2065 c entities and e │ │ │ +00071900: 6c65 6d65 6e74 7320 2e2e 2e2e 2e2e 2e2e lements ........ │ │ │ +00071910: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +00071920: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a0a .......... -->.. │ │ │ +00071930: 3c21 2d2d 2054 6865 2062 6962 6c69 6f67 ...< │ │ │ +00071a30: 212d 2d46 5554 5552 4520 5553 4520 2856 !--FUTURE USE (V │ │ │ +00071a40: 342e 3029 3a0a 2e2e 2e2e 2e2e 2e2e 2e2e 4.0):........... │ │ │ +00071a50: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 0a41 7574 .............Aut │ │ │ +00071a60: 686f 7242 6c75 7262 2061 6e64 2041 6666 horBlurb and Aff │ │ │ +00071a70: 696c 6961 7469 6f6e 2077 696c 6c20 6265 iliation will be │ │ │ +00071a80: 2072 656d 6f76 6564 2066 726f 6d20 2570 removed from %p │ │ │ +00071a90: 6572 736f 6e2e 6964 656e 742e 6d69 783b erson.ident.mix; │ │ │ +00071aa0: 2061 6e64 2061 206e 6577 0a77 7261 7070 and a new.wrapp │ │ │ +00071ab0: 6572 2065 6c65 6d65 6e74 2063 7265 6174 er element creat │ │ │ +00071ac0: 6564 2074 6f20 616c 6c6f 7720 6173 736f ed to allow asso │ │ │ +00071ad0: 6369 6174 696f 6e20 6f66 2074 686f 7365 ciation of those │ │ │ +00071ae0: 2074 776f 2065 6c65 6d65 6e74 7320 7769 two elements wi │ │ │ +00071af0: 7468 0a41 7574 686f 7220 6e61 6d65 2069 th.Author name i │ │ │ +00071b00: 6e66 6f72 6d61 7469 6f6e 2e0a 2e2e 2e2e nformation...... │ │ │ +00071b10: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +00071b20: 2e2e 0a2d 2d3e 0a3c 2145 4e54 4954 5920 ...-->............]]>.... │ │ │ +00071ff0: 3c21 2d2d 656e 6420 6f66 2062 6962 6c69 ]]>........]]>... │ │ │ +00072230: 0a3c 212d 2d65 6e64 206f 6620 6269 626c .]]>........]]>....]]>.]]>..< │ │ │ +00072500: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ +00072510: 7365 742e 6d6f 6475 6c65 2022 494e 434c set.module "INCL │ │ │ +00072520: 5544 4522 3e0a 3c21 5b25 6269 626c 696f UDE">......]]>.. │ │ │ +00072670: 0a0a 0a3c 2145 4e54 4954 5920 2520 6269 .....]]>.]]>. │ │ │ +00072770: 0a3c 2145 4e54 4954 5920 2520 6269 626c .......]]>.. │ │ │ +00072900: 0a0a 0a3c 2145 4e54 4954 5920 2520 6269 ..... │ │ │ +000729c0: 3c21 2d2d 656e 6420 6f66 2062 6962 6c69 │ │ │ +000729e0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2062 ]]>.]]>... │ │ │ +00072a30: 3c21 5b25 6269 626c 696f 6d69 7363 2e6d .< │ │ │ +00072a70: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ +00072a80: 6d69 7363 2e72 6f6c 652e 6174 7472 6962 misc.role.attrib │ │ │ +00072a90: 2022 2572 6f6c 652e 6174 7472 6962 3b22 "%role.attrib;" │ │ │ +00072aa0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6269 >....]] │ │ │ +00072b30: 3e0a 0a3c 2145 4e54 4954 5920 2520 6269 >....]]>.]]>............]]>. │ │ │ +00072e30: 0a3c 212d 2d20 5363 6865 6d65 3a20 436f . │ │ │ +00072e70: 0a0a 0a3c 2145 4e54 4954 5920 2520 7375 .... │ │ │ +00072f30: 0a3c 212d 2d65 6e64 206f 6620 7375 626a .]]>........]]>.......]]>.]]>........ │ │ │ +000732f0: 3c21 2d2d 656e 6420 6f66 2073 7562 6a65 ]] │ │ │ +000733e0: 3e0a 3c21 2d2d 656e 6420 6f66 2073 7562 >.]]> │ │ │ +00073430: 0a0a 3c21 454e 5449 5459 2025 206b 6579 ......... │ │ │ +00073580: 3c21 2d2d 656e 6420 6f66 206b 6579 776f │ │ │ 000735a0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ -00073640: 3c21 454e 5449 5459 2025 2066 756e 6370 ..]]>.. │ │ │ -000736d0: 3c21 454e 5449 5459 2025 2066 756e 6370 ..]]>......]]>....]]>.]] │ │ │ -00073c50: 3e0a 0a3c 2145 4e54 4954 5920 2520 636c >... │ │ │ -00073cd0: 0a3c 2145 4e54 4954 5920 2520 636c 6173 .....< │ │ │ -00073da0: 212d 2d65 6e64 206f 6620 636c 6173 7373 !--end of classs │ │ │ -00073db0: 796e 6f70 7369 7369 6e66 6f2e 656c 656d ynopsisinfo.elem │ │ │ -00073dc0: 656e 742d 2d3e 5d5d 3e0a 0a3c 2145 4e54 ent-->]]>....]]>.. │ │ │ -00073f00: 3c21 454e 5449 5459 2025 206f 6f63 6c61 ....< │ │ │ -00073f90: 2145 4e54 4954 5920 2520 6f6f 636c 6173 !ENTITY % ooclas │ │ │ -00073fa0: 732e 656c 656d 656e 7420 2249 4e43 4c55 s.element "INCLU │ │ │ -00073fb0: 4445 223e 0a3c 215b 256f 6f63 6c61 7373 DE">..]]>.]]>........] │ │ │ -00074220: 5d3e 0a0a 3c21 454e 5449 5459 2025 206f ]>....]]>.]]> │ │ │ -00074310: 0a0a 3c21 454e 5449 5459 2025 206f 6f65 ..... │ │ │ -000743b0: 0a3c 2145 4e54 4954 5920 2520 6f6f 6578 ...]]>... │ │ │ -000744f0: 0a3c 212d 2d65 6e64 206f 6620 6f6f 6578 .]]>.. │ │ │ -00074560: 0a3c 215b 256d 6f64 6966 6965 722e 6d6f ......]]>.... │ │ │ -000746f0: 3c21 2d2d 656e 6420 6f66 206d 6f64 6966 ]] │ │ │ -00074710: 3e0a 3c21 2d2d 656e 6420 6f66 206d 6f64 >.] │ │ │ -00074730: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>...< │ │ │ -00074760: 215b 2569 6e74 6572 6661 6365 6e61 6d65 ![%interfacename │ │ │ -00074770: 2e6d 6f64 756c 653b 5b0a 3c21 454e 5449 .module;[......]]>....]]> │ │ │ -00074950: 0a3c 212d 2d65 6e64 206f 6620 696e 7465 .]]>......< │ │ │ -00074a20: 2145 4e54 4954 5920 2520 6578 6365 7074 !ENTITY % except │ │ │ -00074a30: 696f 6e6e 616d 652e 656c 656d 656e 7420 ionname.element │ │ │ -00074a40: 2249 4e43 4c55 4445 223e 0a3c 215b 2565 "INCLUDE">..]]>.. │ │ │ -00074ac0: 3c21 454e 5449 5459 2025 2065 7863 6570 ..]]>.]]>.......< │ │ │ -00074c90: 215b 2566 6965 6c64 7379 6e6f 7073 6973 ![%fieldsynopsis │ │ │ -00074ca0: 2e65 6c65 6d65 6e74 3b5b 0a3c 2145 4c45 .element;[..]]>....]]>.]]> │ │ │ -00074e10: 0a0a 3c21 454e 5449 5459 2025 2069 6e69 ..... │ │ │ -00074eb0: 0a3c 2145 4e54 4954 5920 2520 696e 6974 ...]]>....] │ │ │ -00075010: 5d3e 0a3c 212d 2d65 6e64 206f 6620 696e ]>.]]>........]] │ │ │ -00075230: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >....< │ │ │ -00075300: 212d 2d65 6e64 206f 6620 636f 6e73 7472 !--end of constr │ │ │ -00075310: 7563 746f 7273 796e 6f70 7369 732e 6174 uctorsynopsis.at │ │ │ -00075320: 746c 6973 742d 2d3e 5d5d 3e0a 3c21 2d2d tlist-->]]>.]]>........]]>.... │ │ │ -00075610: 3c21 2d2d 656e 6420 6f66 2064 6573 7472 ]]>.]]>....... │ │ │ -00075740: 3c21 5b25 6d65 7468 6f64 7379 6e6f 7073 .< │ │ │ -00075850: 212d 2d65 6e64 206f 6620 6d65 7468 6f64 !--end of method │ │ │ -00075860: 7379 6e6f 7073 6973 2e65 6c65 6d65 6e74 synopsis.element │ │ │ -00075870: 2d2d 3e5d 5d3e 0a0a 3c21 454e 5449 5459 -->]]>....] │ │ │ -00075950: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6d65 ]>.]]>.......< │ │ │ -00075a40: 215b 256d 6574 686f 646e 616d 652e 656c ![%methodname.el │ │ │ -00075a50: 656d 656e 743b 5b0a 3c21 454c 454d 454e ement;[..]]>....]]>.]]> │ │ │ -00075b90: 0a0a 3c21 454e 5449 5459 2025 206d 6574 ..... │ │ │ -00075c30: 0a3c 2145 4e54 4954 5920 2520 6d65 7468 ...]]>....< │ │ │ -00075e30: 212d 2d65 6e64 206f 6620 6d65 7468 6f64 !--end of method │ │ │ -00075e40: 7061 7261 6d2e 6174 746c 6973 742d 2d3e param.attlist--> │ │ │ -00075e50: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206d ]]>.]]>........... │ │ │ -00076100: 0a3c 215b 2561 636b 6e6f 2e6d 6f64 756c ......] │ │ │ -000761e0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2061 ]>....]]>.]]>....... │ │ │ -00076380: 3c21 454e 5449 5459 2025 2061 6464 7265 . │ │ │ -000763b0: 0a3c 2145 4e54 4954 5920 2520 6164 6472 ...] │ │ │ -00076550: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6164 ]>.] │ │ │ -00076570: 5d3e 0a0a 2020 3c21 454e 5449 5459 2025 ]>.. . . . ...]]>. ...]]>. ]]>.. < │ │ │ -00076760: 2145 4e54 4954 5920 2520 706f 622e 6d6f !ENTITY % pob.mo │ │ │ -00076770: 6475 6c65 2022 494e 434c 5544 4522 3e0a dule "INCLUDE">. │ │ │ -00076780: 2020 3c21 5b25 706f 622e 6d6f 6475 6c65 . . ...< │ │ │ -00076840: 212d 2d65 6e64 206f 6620 706f 622e 656c !--end of pob.el │ │ │ -00076850: 656d 656e 742d 2d3e 5d5d 3e0a 2020 0a3c ement-->]]>. .< │ │ │ -00076860: 2145 4e54 4954 5920 2520 706f 622e 6174 !ENTITY % pob.at │ │ │ -00076870: 746c 6973 7420 2249 4e43 4c55 4445 223e tlist "INCLUDE"> │ │ │ -00076880: 0a3c 215b 2570 6f62 2e61 7474 6c69 7374 ..]]>. ]]>.. . │ │ │ -00076980: 0a20 203c 2145 4e54 4954 5920 2520 706f . . ...< │ │ │ -00076a20: 212d 2d65 6e64 206f 6620 706f 7374 636f !--end of postco │ │ │ -00076a30: 6465 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e de.element-->]]> │ │ │ -00076a40: 0a20 200a 3c21 454e 5449 5459 2025 2070 . ...]]>. │ │ │ -00076b00: 3c21 2d2d 656e 6420 6f66 2070 6f73 7463 ]]> │ │ │ -00076b20: 0a0a 2020 3c21 454e 5449 5459 2025 2063 .. . . < │ │ │ -00076b80: 2145 4e54 4954 5920 2520 6369 7479 2e72 !ENTITY % city.r │ │ │ -00076b90: 6f6c 652e 6174 7472 6962 2022 2572 6f6c ole.attrib "%rol │ │ │ -00076ba0: 652e 6174 7472 6962 3b22 3e0a 2020 0a3c e.attrib;">. .< │ │ │ -00076bb0: 2145 4e54 4954 5920 2520 6369 7479 2e65 !ENTITY % city.e │ │ │ -00076bc0: 6c65 6d65 6e74 2022 494e 434c 5544 4522 lement "INCLUDE" │ │ │ -00076bd0: 3e0a 3c21 5b25 6369 7479 2e65 6c65 6d65 >..]]>. ..< │ │ │ -00076c50: 215b 2563 6974 792e 6174 746c 6973 743b ![%city.attlist; │ │ │ -00076c60: 5b0a 3c21 4154 544c 4953 5420 6369 7479 [.. │ │ │ -00076cb0: 3c21 2d2d 656e 6420 6f66 2063 6974 792e ]]>. │ │ │ -00076cd0: 3c21 2d2d 656e 6420 6f66 2063 6974 792e ]]>.. │ │ │ -00076cf0: 3c21 454e 5449 5459 2025 2073 7461 7465 . . . .< │ │ │ -00076d80: 2145 4e54 4954 5920 2520 7374 6174 652e !ENTITY % state. │ │ │ -00076d90: 656c 656d 656e 7420 2249 4e43 4c55 4445 element "INCLUDE │ │ │ -00076da0: 223e 0a3c 215b 2573 7461 7465 2e65 6c65 ">..]]>. . │ │ │ -00076e00: 3c21 454e 5449 5459 2025 2073 7461 7465 ..]]>. ]]>.. . │ │ │ -00076ef0: 2020 3c21 5b25 636f 756e 7472 792e 6d6f . < │ │ │ -00076f30: 2145 4e54 4954 5920 2520 636f 756e 7472 !ENTITY % countr │ │ │ -00076f40: 792e 726f 6c65 2e61 7474 7269 6220 2225 y.role.attrib "% │ │ │ -00076f50: 726f 6c65 2e61 7474 7269 623b 223e 0a20 role.attrib;">. │ │ │ -00076f60: 200a 3c21 454e 5449 5459 2025 2063 6f75 ...]]>. . │ │ │ -00077010: 0a3c 215b 2563 6f75 6e74 7279 2e61 7474 ..]]>. │ │ │ -000770a0: 203c 212d 2d65 6e64 206f 6620 636f 756e ]]> │ │ │ -000770c0: 0a0a 2020 3c21 454e 5449 5459 2025 2070 .. . . │ │ │ -00077120: 2020 3c21 454e 5449 5459 2025 2070 686f . │ │ │ -00077150: 2020 0a3c 2145 4e54 4954 5920 2520 7068 ...]]> │ │ │ -000771d0: 0a20 200a 3c21 454e 5449 5459 2025 2070 . ...]]>. ]]>.. < │ │ │ -000772a0: 2145 4e54 4954 5920 2520 6661 782e 6d6f !ENTITY % fax.mo │ │ │ -000772b0: 6475 6c65 2022 494e 434c 5544 4522 3e0a dule "INCLUDE">. │ │ │ -000772c0: 2020 3c21 5b25 6661 782e 6d6f 6475 6c65 . . ...< │ │ │ -00077380: 212d 2d65 6e64 206f 6620 6661 782e 656c !--end of fax.el │ │ │ -00077390: 656d 656e 742d 2d3e 5d5d 3e0a 2020 0a3c ement-->]]>. .< │ │ │ -000773a0: 2145 4e54 4954 5920 2520 6661 782e 6174 !ENTITY % fax.at │ │ │ -000773b0: 746c 6973 7420 2249 4e43 4c55 4445 223e tlist "INCLUDE"> │ │ │ -000773c0: 0a3c 215b 2566 6178 2e61 7474 6c69 7374 ..]]>. ]]>.. ]] │ │ │ -000775c0: 3e0a 2020 0a3c 2145 4e54 4954 5920 2520 >. ...]]>.]]> │ │ │ -000776d0: 0a0a 3c21 2d2d 2041 6666 696c 6961 7469 ....< │ │ │ -00077700: 2145 4e54 4954 5920 2520 6166 6669 6c69 !ENTITY % affili │ │ │ -00077710: 6174 696f 6e2e 636f 6e74 656e 742e 6d6f ation.content.mo │ │ │ -00077720: 6475 6c65 2022 494e 434c 5544 4522 3e0a dule "INCLUDE">. │ │ │ -00077730: 3c21 5b25 6166 6669 6c69 6174 696f 6e2e .... │ │ │ -000777f0: 3c21 454e 5449 5459 2025 2061 6666 696c ..]]>.... │ │ │ -00077950: 3c21 2d2d 656e 6420 6f66 2061 6666 696c ]]>.. . . . .< │ │ │ -00077a40: 2145 4e54 4954 5920 2520 7368 6f72 7461 !ENTITY % shorta │ │ │ -00077a50: 6666 696c 2e65 6c65 6d65 6e74 2022 494e ffil.element "IN │ │ │ -00077a60: 434c 5544 4522 3e0a 3c21 5b25 7368 6f72 CLUDE">..]]> │ │ │ -00077ad0: 0a20 200a 3c21 454e 5449 5459 2025 2073 . ...]]>. ]]>.. │ │ │ -00077bc0: 2020 3c21 454e 5449 5459 2025 206a 6f62 . . . ...]]>. . │ │ │ -00077d10: 0a3c 215b 256a 6f62 7469 746c 652e 6174 .. │ │ │ -00077da0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]]>.. .. │ │ │ -00077e00: 203c 2145 4e54 4954 5920 2520 6f72 6764 . . │ │ │ -00077e60: 2020 3c21 454e 5449 5459 2025 206f 7267 │ │ │ -00077e90: 0a20 200a 3c21 454e 5449 5459 2025 206f . ...]]>. ]]>.. .< │ │ │ -00078020: 212d 2d65 6e64 206f 6620 6166 6669 6c69 !--end of affili │ │ │ -00078030: 6174 696f 6e2e 636f 6e74 656e 742e 6d6f ation.content.mo │ │ │ -00078040: 6475 6c65 2d2d 3e5d 5d3e 0a0a 3c21 2d2d dule-->]]>..........]]>..< │ │ │ -000781b0: 2145 4e54 4954 5920 2520 6172 7470 6167 !ENTITY % artpag │ │ │ -000781c0: 656e 756d 732e 6174 746c 6973 7420 2249 enums.attlist "I │ │ │ -000781d0: 4e43 4c55 4445 223e 0a3c 215b 2561 7274 NCLUDE">..]]>.]]>.. │ │ │ -000782a0: 3c21 2d2d 2041 7574 686f 7220 2e2e 2e2e .. │ │ │ -000782f0: 0a3c 215b 2561 7574 686f 722e 6d6f 6475 ..< │ │ │ -00078400: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -00078410: 6175 7468 6f72 2e61 7474 7269 6220 2222 author.attrib "" │ │ │ -00078420: 3e0a 3c21 454e 5449 5459 2025 2061 7574 >. │ │ │ -00078450: 0a0a 3c21 454e 5449 5459 2025 2061 7574 .....]] │ │ │ -00078880: 3e0a 3c21 2d2d 656e 6420 6f66 2061 7574 >.. │ │ │ -00078910: 0a0a 2020 3c21 454e 5449 5459 2025 2063 .. . │ │ │ -00078940: 2020 3c21 5b25 636f 6c6c 6162 2e63 6f6e . . │ │ │ -000789c0: 203c 2145 4e54 4954 5920 2520 636f 6c6c . │ │ │ -000789f0: 2020 0a3c 2145 4e54 4954 5920 2520 636f ...]]>. ...]]>. ]]>.. │ │ │ -00078b50: 203c 2145 4e54 4954 5920 2520 636f 6c6c . . │ │ │ -00078bf0: 0a20 2020 200a 3c21 454e 5449 5459 2025 . ..< │ │ │ -00078c20: 215b 2563 6f6c 6c61 626e 616d 652e 656c ![%collabname.el │ │ │ -00078c30: 656d 656e 743b 5b0a 3c21 454c 454d 454e ement;[..]]>. ...< │ │ │ -00078d30: 212d 2d65 6e64 206f 6620 636f 6c6c 6162 !--end of collab │ │ │ -00078d40: 6e61 6d65 2e61 7474 6c69 7374 2d2d 3e5d name.attlist-->] │ │ │ -00078d50: 5d3e 0a20 2020 203c 212d 2d65 6e64 206f ]>. ]]>.. < │ │ │ -00078d80: 212d 2d20 4166 6669 6c69 6174 696f 6e20 !-- Affiliation │ │ │ -00078d90: 2864 6566 696e 6564 2065 6c73 6577 6865 (defined elsewhe │ │ │ -00078da0: 7265 2069 6e20 7468 6973 2073 6563 7469 re in this secti │ │ │ -00078db0: 6f6e 292d 2d3e 0a20 203c 212d 2d65 6e64 on)-->. ]]>. │ │ │ -00078de0: 0a20 203c 212d 2d20 436f 7270 4175 7468 . . ..]]> │ │ │ -00078e80: 0a0a 3c21 2d2d 2041 7574 686f 7249 6e69 ....< │ │ │ -00078eb0: 2145 4e54 4954 5920 2520 6175 7468 6f72 !ENTITY % author │ │ │ -00078ec0: 696e 6974 6961 6c73 2e6d 6f64 756c 6520 initials.module │ │ │ -00078ed0: 2249 4e43 4c55 4445 223e 0a3c 215b 2561 "INCLUDE">......]]>....]]>.]] │ │ │ -00079100: 3e0a 0a3c 212d 2d20 436f 6e66 4772 6f75 >.... │ │ │ -00079130: 3c21 454e 5449 5459 2025 2063 6f6e 6667 .< │ │ │ -00079160: 215b 2563 6f6e 6667 726f 7570 2e63 6f6e ![%confgroup.con │ │ │ -00079170: 7465 6e74 2e6d 6f64 756c 653b 5b0a 3c21 tent.module;[.......< │ │ │ -000792a0: 212d 2d65 6e64 206f 6620 636f 6e66 6772 !--end of confgr │ │ │ -000792b0: 6f75 702e 656c 656d 656e 742d 2d3e 5d5d oup.element-->]] │ │ │ -000792c0: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >.... │ │ │ -00079360: 3c21 2d2d 656e 6420 6f66 2063 6f6e 6667 ] │ │ │ -00079380: 5d3e 0a3c 212d 2d65 6e64 206f 6620 636f ]>.]]>. ]]>.. < │ │ │ -000795c0: 2145 4e54 4954 5920 2520 636f 6e66 7469 !ENTITY % confti │ │ │ -000795d0: 746c 652e 6d6f 6475 6c65 2022 494e 434c tle.module "INCL │ │ │ -000795e0: 5544 4522 3e0a 2020 3c21 5b25 636f 6e66 UDE">. . . ...]]>. .< │ │ │ -000796f0: 2145 4e54 4954 5920 2520 636f 6e66 7469 !ENTITY % confti │ │ │ -00079700: 746c 652e 6174 746c 6973 7420 2249 4e43 tle.attlist "INC │ │ │ -00079710: 4c55 4445 223e 0a3c 215b 2563 6f6e 6674 LUDE">..]]>. │ │ │ -000797b0: 203c 212d 2d65 6e64 206f 6620 636f 6e66 ] │ │ │ -000797d0: 5d3e 0a0a 2020 3c21 454e 5449 5459 2025 ]>.. . . . ...] │ │ │ -000798f0: 5d3e 0a20 200a 3c21 454e 5449 5459 2025 ]>. ...]]>. ]]>.. < │ │ │ -000799d0: 212d 2d20 4164 6472 6573 7320 2864 6566 !-- Address (def │ │ │ -000799e0: 696e 6564 2065 6c73 6577 6865 7265 2069 ined elsewhere i │ │ │ -000799f0: 6e20 7468 6973 2073 6563 7469 6f6e 292d n this section)- │ │ │ -00079a00: 2d3e 0a0a 2020 3c21 454e 5449 5459 2025 ->.. . │ │ │ -00079a30: 203c 215b 2563 6f6e 6673 706f 6e73 6f72 . . ...] │ │ │ -00079b40: 5d3e 0a20 200a 3c21 454e 5449 5459 2025 ]>. .. │ │ │ -00079b70: 3c21 5b25 636f 6e66 7370 6f6e 736f 722e .]] │ │ │ -00079c10: 3e0a 2020 3c21 2d2d 656e 6420 6f66 2063 >. ]]>.]] │ │ │ -00079c60: 3e0a 0a3c 212d 2d20 436f 6e74 7261 6374 >.... │ │ │ -00079c90: 3c21 454e 5449 5459 2025 2063 6f6e 7472 ....< │ │ │ -00079d30: 2145 4e54 4954 5920 2520 636f 6e74 7261 !ENTITY % contra │ │ │ -00079d40: 6374 6e75 6d2e 656c 656d 656e 7420 2249 ctnum.element "I │ │ │ -00079d50: 4e43 4c55 4445 223e 0a3c 215b 2563 6f6e NCLUDE">.. │ │ │ -00079da0: 3c21 2d2d 656e 6420 6f66 2063 6f6e 7472 ]]>.]]>..< │ │ │ +00073690: 2145 4e54 4954 5920 2520 6b65 7977 6f72 !ENTITY % keywor │ │ │ +000736a0: 642e 6d6f 6475 6c65 2022 494e 434c 5544 d.module "INCLUD │ │ │ +000736b0: 4522 3e0a 3c21 5b25 6b65 7977 6f72 642e E">......]]>...< │ │ │ +000737c0: 215b 256b 6579 776f 7264 2e61 7474 6c69 ![%keyword.attli │ │ │ +000737d0: 7374 3b5b 0a3c 2141 5454 4c49 5354 206b st;[..]]>.]]>.]]>...< │ │ │ +000738c0: 215b 2569 7465 726d 7365 742e 6d6f 6475 ![%itermset.modu │ │ │ +000738d0: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[......]]>....]]>.]]>............. │ │ │ +00073c50: 3c21 5b25 6d73 6773 6574 2e65 6c65 6d65 . │ │ │ +00073da0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.......< │ │ │ +00073e60: 215b 256d 7367 656e 7472 792e 656c 656d ![%msgentry.elem │ │ │ +00073e70: 656e 743b 5b0a 3c21 454c 454d 454e 5420 ent;[..]]>.. │ │ │ +00073ef0: 0a3c 215b 256d 7367 656e 7472 792e 6174 .. │ │ │ +00073f80: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206d ]]>.]] │ │ │ +00074220: 3e0a 3c21 2d2d 656e 6420 6f66 2073 696d >.]]>........]]>.. │ │ │ +00074350: 3c21 454e 5449 5459 2025 206d 7367 2e61 ..< │ │ │ +000743d0: 212d 2d65 6e64 206f 6620 6d73 672e 6174 !--end of msg.at │ │ │ +000743e0: 746c 6973 742d 2d3e 5d5d 3e0a 3c21 2d2d tlist-->]]>.]]>........]]>.. │ │ │ +00074540: 0a3c 215b 256d 7367 6d61 696e 2e61 7474 ..]]>.< │ │ │ +000745d0: 212d 2d65 6e64 206f 6620 6d73 676d 6169 !--end of msgmai │ │ │ +000745e0: 6e2e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a n.module-->]]>.. │ │ │ +000745f0: 3c21 454e 5449 5459 2025 206d 7367 7375 ..... │ │ │ +000746a0: 3c21 5b25 6d73 6773 7562 2e65 6c65 6d65 .]]>...< │ │ │ +00074720: 215b 256d 7367 7375 622e 6174 746c 6973 ![%msgsub.attlis │ │ │ +00074730: 743b 5b0a 3c21 4154 544c 4953 5420 6d73 t;[..]]>.]]>....... │ │ │ +000748b0: 0a3c 212d 2d65 6e64 206f 6620 6d73 6772 .]]> │ │ │ +000748d0: 0a0a 3c21 454e 5449 5459 2025 206d 7367 .... │ │ │ +00074960: 3c21 2d2d 656e 6420 6f66 206d 7367 7265 ]]>. │ │ │ +00074980: 3c21 2d2d 656e 6420 6f66 206d 7367 7265 ]]>.. │ │ │ +000749a0: 3c21 2d2d 204d 7367 5465 7874 2028 6465 ........]]>... │ │ │ +00074b20: 3c21 5b25 6d73 6769 6e66 6f2e 6174 746c .]]>.]]>..< │ │ │ +00074bd0: 2145 4e54 4954 5920 2520 6d73 676c 6576 !ENTITY % msglev │ │ │ +00074be0: 656c 2e6d 6f64 756c 6520 2249 4e43 4c55 el.module "INCLU │ │ │ +00074bf0: 4445 223e 0a3c 215b 256d 7367 6c65 7665 DE">.. │ │ │ +00074c30: 3c21 454e 5449 5459 2025 206d 7367 6c65 │ │ │ +00074c60: 0a0a 3c21 454e 5449 5459 2025 206d 7367 ....]]>..< │ │ │ +00074cf0: 2145 4e54 4954 5920 2520 6d73 676c 6576 !ENTITY % msglev │ │ │ +00074d00: 656c 2e61 7474 6c69 7374 2022 494e 434c el.attlist "INCL │ │ │ +00074d10: 5544 4522 3e0a 3c21 5b25 6d73 676c 6576 UDE">..]]>.]]>... │ │ │ +00074df0: 3c21 5b25 6d73 676f 7269 672e 6d6f 6475 .... │ │ │ +00074e80: 3c21 5b25 6d73 676f 7269 672e 656c 656d │ │ │ +00074ec0: 0a3c 212d 2d65 6e64 206f 6620 6d73 676f .]] │ │ │ +00074ee0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6d73 >....]]>.]]>........]] │ │ │ +000750c0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6d73 >... │ │ │ +00075150: 0a3c 212d 2d65 6e64 206f 6620 6d73 6761 .]]> │ │ │ +00075170: 0a3c 212d 2d65 6e64 206f 6620 6d73 6761 .]]>. │ │ │ +00075190: 0a3c 2145 4e54 4954 5920 2520 6d73 6765 ...... │ │ │ +00075250: 3c21 5b25 6d73 6765 7870 6c61 6e2e 656c .]]>....]]>.]]>. │ │ │ +000753a0: 3c21 2d2d 656e 6420 6f66 206d 7367 7365 ]]>..]]>....]] │ │ │ +000758d0: 3e0a 3c21 2d2d 656e 6420 6f66 2071 616e >.] │ │ │ +000758f0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2071 ]>..... │ │ │ +00075990: 0a3c 2145 4e54 4954 5920 2520 7161 6e64 ...]]>. │ │ │ +00075a30: 0a3c 2145 4e54 4954 5920 2520 7161 6e64 ...]]>.]]>....< │ │ │ +00075b80: 2145 4e54 4954 5920 2520 7175 6573 7469 !ENTITY % questi │ │ │ +00075b90: 6f6e 2e72 6f6c 652e 6174 7472 6962 2022 on.role.attrib " │ │ │ +00075ba0: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ +00075bb0: 0a3c 2145 4e54 4954 5920 2520 7175 6573 .. │ │ │ +00075c20: 0a3c 212d 2d65 6e64 206f 6620 7175 6573 .] │ │ │ +00075c40: 5d3e 0a0a 3c21 454e 5449 5459 2025 2071 ]>....]]>. │ │ │ +00075d00: 3c21 2d2d 656e 6420 6f66 2071 7565 7374 ]]> │ │ │ +00075d20: 0a0a 3c21 454e 5449 5459 2025 2061 6e73 ....< │ │ │ +00075d80: 2145 4e54 4954 5920 2520 616e 7377 6572 !ENTITY % answer │ │ │ +00075d90: 2e72 6f6c 652e 6174 7472 6962 2022 2572 .role.attrib "%r │ │ │ +00075da0: 6f6c 652e 6174 7472 6962 3b22 3e0a 0a3c ole.attrib;">..< │ │ │ +00075db0: 2145 4e54 4954 5920 2520 616e 7377 6572 !ENTITY % answer │ │ │ +00075dc0: 2e65 6c65 6d65 6e74 2022 494e 434c 5544 .element "INCLUD │ │ │ +00075dd0: 4522 3e0a 3c21 5b20 2561 6e73 7765 722e E">..]]>.]]>....]]>.]]>..< │ │ │ +00076110: 212d 2d20 5072 6f63 6564 7572 6520 2e2e !-- Procedure .. │ │ │ +00076120: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +00076130: 2e2e 2e2e 2e2e 202d 2d3e 0a0a 3c21 454e ...... -->... │ │ │ +000761b0: 0a3c 215b 2570 726f 6365 6475 7265 2e6d ... │ │ │ +00076220: 0a3c 2145 4e54 4954 5920 2520 7072 6f63 ...]]>... │ │ │ +00076300: 3c21 5b25 7072 6f63 6564 7572 652e 6174 .]]>.]]>.... │ │ │ +00076410: 3c21 454e 5449 5459 2025 2073 7465 702e .. │ │ │ +00076460: 0a3c 215b 2573 7465 702e 656c 656d 656e ..]]>.. │ │ │ +00076540: 0a3c 212d 2d20 6e6f 7420 2352 4551 5549 ..... │ │ │ +00076610: 0a3c 212d 2d65 6e64 206f 6620 7374 6570 .]]>.< │ │ │ +00076630: 212d 2d65 6e64 206f 6620 7374 6570 2e6d !--end of step.m │ │ │ +00076640: 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c 2145 odule-->]]>...... │ │ │ +000766e0: 3c21 454e 5449 5459 2025 2073 7562 7374 ..]]>........]]>.]]>. │ │ │ +00076b00: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...< │ │ │ +00076b30: 215b 2025 7369 6465 6261 7269 6e66 6f2e ![ %sidebarinfo. │ │ │ +00076b40: 6174 746c 6973 743b 205b 0a3c 2141 5454 attlist; [..] │ │ │ +00076bd0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7369 ]>.]]>........< │ │ │ +00076d40: 212d 2d65 6e64 206f 6620 7369 6465 6261 !--end of sideba │ │ │ +00076d50: 722e 656c 656d 656e 742d 2d3e 5d5d 3e0a r.element-->]]>. │ │ │ +00076d60: 0a3c 2145 4e54 4954 5920 2520 7369 6465 ...]]>.......< │ │ │ +00076f60: 2145 4e54 4954 5920 2520 6162 7374 7261 !ENTITY % abstra │ │ │ +00076f70: 6374 2e72 6f6c 652e 6174 7472 6962 2022 ct.role.attrib " │ │ │ +00076f80: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ +00076f90: 0a3c 2145 4e54 4954 5920 2520 6162 7374 ...]]>.. │ │ │ +00077020: 3c21 454e 5449 5459 2025 2061 6273 7472 ..]]>.]]>........ │ │ │ +00077210: 3c21 2d2d 656e 6420 6f66 2061 7574 686f ]] │ │ │ +00077300: 3e0a 3c21 2d2d 656e 6420 6f66 2061 7574 >.......< │ │ │ +00077470: 215b 2562 6c6f 636b 7175 6f74 652e 656c ![%blockquote.el │ │ │ +00077480: 656d 656e 743b 5b0a 3c21 454c 454d 454e ement;[..]]>.... │ │ │ +00077590: 3c21 2d2d 656e 6420 6f66 2062 6c6f 636b │ │ │ +000775b0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2062 ]]>.]]>.. │ │ │ +00077600: 0a3c 215b 2561 7474 7269 6275 7469 6f6e .... │ │ │ +000776a0: 0a3c 215b 2561 7474 7269 6275 7469 6f6e ..]]>....]]>.]]>....... │ │ │ +000778c0: 3c21 5b25 6272 6964 6765 6865 6164 2e65 .]]>....... │ │ │ +00077a70: 3c21 2d2d 656e 6420 6f66 2062 7269 6467 │ │ │ +00077a90: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2062 ]]>.]]>........]] │ │ │ +00077bc0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >... │ │ │ +00077c50: 0a3c 212d 2d65 6e64 206f 6620 7265 6d61 .]]> │ │ │ +00077c70: 0a3c 212d 2d65 6e64 206f 6620 7265 6d61 .]]>. │ │ │ +00077c90: 0a3c 2145 4e54 4954 5920 2520 6570 6967 .......]]>... │ │ │ +00077de0: 3c21 5b25 6570 6967 7261 7068 2e61 7474 │ │ │ +00077e50: 0a3c 212d 2d65 6e64 206f 6620 6570 6967 .] │ │ │ +00077e70: 5d3e 0a3c 212d 2d20 4174 7472 6962 7574 ]>..]]>...< │ │ │ +00077ee0: 215b 2566 6f6f 746e 6f74 652e 6d6f 6475 ![%footnote.modu │ │ │ +00077ef0: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[...... │ │ │ +00077fd0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>. │ │ │ +000780a0: 3c21 2d2d 656e 6420 6f66 2066 6f6f 746e ]]> │ │ │ +000780c0: 0a0a 3c21 454e 5449 5459 2025 2068 6967 ........]]>.. │ │ │ +000781f0: 3c21 454e 5449 5459 2025 2068 6967 686c ..]]>... │ │ │ +00078340: 0a3c 2145 4e54 4954 5920 2520 666f 726d .....< │ │ │ +000783f0: 212d 2d65 6e64 206f 6620 666f 726d 616c !--end of formal │ │ │ +00078400: 7061 7261 2e65 6c65 6d65 6e74 2d2d 3e5d para.element-->] │ │ │ +00078410: 5d3e 0a0a 3c21 454e 5449 5459 2025 2066 ]>....]]>.]]>... │ │ │ +00078520: 3c21 5b25 7061 7261 2e6d 6f64 756c 653b .. │ │ │ +00078580: 0a3c 2145 4e54 4954 5920 2520 7061 7261 ...]]>.]]>...< │ │ │ +00078800: 215b 2573 696d 7061 7261 2e61 7474 6c69 ![%simpara.attli │ │ │ +00078810: 7374 3b5b 0a3c 2141 5454 4c49 5354 2073 st;[..]]>.]]>.. │ │ │ +000788d0: 0a3c 215b 2561 646d 6f6e 2e6d 6f64 756c .......]]>.. │ │ │ +000789c0: 3c21 454e 5449 5459 2025 2063 6175 7469 ..< │ │ │ +00078a50: 212d 2d65 6e64 206f 6620 6361 7574 696f !--end of cautio │ │ │ +00078a60: 6e2e 6174 746c 6973 742d 2d3e 5d5d 3e0a n.attlist-->]]>. │ │ │ +00078a70: 0a0a 3c21 454e 5449 5459 2025 2069 6d70 .... │ │ │ +00078ae0: 3c21 2d2d 656e 6420 6f66 2069 6d70 6f72 ] │ │ │ +00078b00: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>....]]>... │ │ │ +00078be0: 0a3c 215b 256e 6f74 652e 656c 656d 656e ..]]>...< │ │ │ +00078c60: 215b 256e 6f74 652e 6174 746c 6973 743b ![%note.attlist; │ │ │ +00078c70: 5b0a 3c21 4154 544c 4953 5420 6e6f 7465 [..]]>. │ │ │ +00078ce0: 0a0a 3c21 454e 5449 5459 2025 2074 6970 ....]]>....< │ │ │ +00078de0: 212d 2d65 6e64 206f 6620 7469 702e 6174 !--end of tip.at │ │ │ +00078df0: 746c 6973 742d 2d3e 5d5d 3e0a 0a0a 3c21 tlist-->]]>.....]]>....]]>..]]>............. │ │ │ +00079120: 3c21 2d2d 656e 6420 6f66 2067 6c6f 7373 ] │ │ │ +00079140: 5d3e 0a0a 3c21 454e 5449 5459 2025 2067 ]>... │ │ │ +000791e0: 0a3c 212d 2d65 6e64 206f 6620 676c 6f73 . │ │ │ +00079200: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2067 ]]>.]]>. │ │ │ +00079410: 0a3c 212d 2d20 536f 7274 4173 3a20 5374 .. │ │ │ +00079480: 0a0a 3c21 454e 5449 5459 2025 2067 6c6f ....]] │ │ │ +00079560: 3e0a 3c21 2d2d 656e 6420 6f66 2067 6c6f >...... │ │ │ +00079740: 3c21 454e 5449 5459 2025 2067 6c6f 7373 ..]]>... │ │ │ +00079850: 3c21 2d2d 2053 7562 6a65 6374 3a20 4c69 . │ │ │ +00079890: 0a0a 3c21 454e 5449 5459 2025 2067 6c6f ....]]>.]]>...< │ │ │ +000799b0: 215b 2567 6c6f 7373 7365 652e 6d6f 6475 ![%glosssee.modu │ │ │ +000799c0: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[..... │ │ │ +00079a80: 0a3c 212d 2d65 6e64 206f 6620 676c 6f73 .] │ │ │ +00079aa0: 5d3e 0a0a 3c21 2d2d 204f 7468 6572 5465 ]>...... │ │ │ +00079b40: 3c21 5b25 676c 6f73 7373 6565 2e61 7474 .]]>.< │ │ │ +00079bf0: 212d 2d65 6e64 206f 6620 676c 6f73 7373 !--end of glosss │ │ │ +00079c00: 6565 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a ee.module-->]]>. │ │ │ +00079c10: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 ......< │ │ │ +00079ce0: 215b 2567 6c6f 7373 7365 6561 6c73 6f2e ![%glossseealso. │ │ │ +00079cf0: 656c 656d 656e 743b 5b0a 3c21 454c 454d element;[..]]>..]] │ │ │ -00079e90: 3e0a 3c21 2d2d 656e 6420 6f66 2063 6f6e >.]]>....]]>.]]>..]] │ │ │ -0007a2e0: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >.... │ │ │ -0007a380: 3c21 2d2d 656e 6420 6f66 2063 6f70 7972 ] │ │ │ -0007a3a0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 636f ]>.]]>. . │ │ │ -0007a4d0: 3c21 454e 5449 5459 2025 2079 6561 722e ..]] │ │ │ -0007a570: 3e0a 2020 3c21 2d2d 656e 6420 6f66 2079 >. ]]> │ │ │ -0007a590: 0a0a 2020 3c21 454e 5449 5459 2025 2068 .. . . . ...]]>. . │ │ │ -0007a6d0: 0a3c 215b 2568 6f6c 6465 722e 6174 746c ..]]>. ]]>.]]>. │ │ │ -0007a900: 0a3c 2145 4e54 4954 5920 2520 636f 7270 ...]]>.]]>....... │ │ │ -0007aaa0: 0a3c 215b 2563 6f72 706e 616d 652e 656c .. │ │ │ -0007ab00: 5d5d 3e0a 3c21 454e 5449 5459 2025 2063 ]]>.....]]>. │ │ │ -0007abf0: 3c21 2d2d 656e 6420 6f66 2063 6f72 706e ]]> │ │ │ -0007ac10: 0a0a 3c21 2d2d 2044 6174 6520 2e2e 2e2e ....< │ │ │ -0007ac40: 2145 4e54 4954 5920 2520 6461 7465 2e6d !ENTITY % date.m │ │ │ -0007ac50: 6f64 756c 6520 2249 4e43 4c55 4445 223e odule "INCLUDE"> │ │ │ -0007ac60: 0a3c 215b 2564 6174 652e 6d6f 6475 6c65 .. │ │ │ -0007acc0: 0a0a 3c21 454e 5449 5459 2025 2064 6174 ....]]>... │ │ │ -0007ad60: 3c21 5b25 6461 7465 2e61 7474 6c69 7374 │ │ │ -0007adc0: 0a3c 212d 2d65 6e64 206f 6620 6461 7465 .]]>.< │ │ │ -0007ade0: 212d 2d65 6e64 206f 6620 6461 7465 2e6d !--end of date.m │ │ │ -0007adf0: 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c 212d odule-->]]>.....< │ │ │ -0007ae50: 215b 2565 6469 7469 6f6e 2e6d 6f64 756c ![%edition.modul │ │ │ -0007ae60: 653b 5b0a 3c21 454e 5449 5459 2025 206c e;[.....< │ │ │ -0007aee0: 215b 2565 6469 7469 6f6e 2e65 6c65 6d65 ![%edition.eleme │ │ │ -0007aef0: 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 2065 nt;[..]]>.. │ │ │ -0007af40: 3c21 454e 5449 5459 2025 2065 6469 7469 .. │ │ │ -0007aff0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2065 ]]>. │ │ │ -0007b010: 5d5d 3e0a 0a3c 212d 2d20 4564 6974 6f72 ]]>.. │ │ │ -0007b040: 0a0a 3c21 454e 5449 5459 2025 2065 6469 .........]]>.. │ │ │ -0007b270: 0a3c 215b 2565 6469 746f 722e 6174 746c ..]]>. .]]>......< │ │ │ -0007b3e0: 2145 4e54 4954 5920 2520 6973 626e 2e72 !ENTITY % isbn.r │ │ │ -0007b3f0: 6f6c 652e 6174 7472 6962 2022 2572 6f6c ole.attrib "%rol │ │ │ -0007b400: 652e 6174 7472 6962 3b22 3e0a 0a3c 2145 e.attrib;">... │ │ │ -0007b430: 3c21 5b25 6973 626e 2e65 6c65 6d65 6e74 .]]>....]]>.]]>..........]] │ │ │ -0007b670: 3e0a 0a3c 2145 4e54 4954 5920 2520 6973 >....]] │ │ │ -0007b730: 3e0a 0a3c 212d 2d20 496e 7650 6172 744e >.... │ │ │ -0007b760: 3c21 454e 5449 5459 2025 2069 6e76 7061 .. │ │ │ -0007b7d0: 3c21 454e 5449 5459 2025 2069 6e76 7061 ....]]>....]]>. │ │ │ -0007b9a0: 5d5d 3e0a 0a3c 212d 2d20 4973 7375 654e ]]>.. │ │ │ -0007b9d0: 0a0a 3c21 454e 5449 5459 2025 2069 7373 ........]]>.. │ │ │ -0007baf0: 3c21 454e 5449 5459 2025 2069 7373 7565 ..]]>.]]>..........]]>....< │ │ │ -0007bde0: 212d 2d65 6e64 206f 6620 6c65 6761 6c6e !--end of legaln │ │ │ -0007bdf0: 6f74 6963 652e 6174 746c 6973 742d 2d3e otice.attlist--> │ │ │ -0007be00: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206c ]]>.]]>......... │ │ │ -0007bf10: 3c21 5b25 6d6f 6465 7370 6563 2e65 6c65 │ │ │ -0007bf50: 0a3c 212d 2d65 6e64 206f 6620 6d6f 6465 .] │ │ │ -0007bf70: 5d3e 0a0a 3c21 2d2d 2041 7070 6c69 6361 ]>.......]]>.< │ │ │ -0007c0f0: 212d 2d65 6e64 206f 6620 6d6f 6465 7370 !--end of modesp │ │ │ -0007c100: 6563 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a ec.module-->]]>. │ │ │ -0007c110: 0a3c 212d 2d20 4f72 674e 616d 6520 2e2e .........] │ │ │ -0007c250: 5d3e 0a0a 3c21 454e 5449 5459 2025 206f ]>....]]>.]]>.....< │ │ │ -0007c380: 215b 256f 7468 6572 6372 6564 6974 2e6d ![%othercredit.m │ │ │ -0007c390: 6f64 756c 653b 5b0a 3c21 2d2d 4655 5455 odule;[...< │ │ │ -0007c4c0: 2145 4e54 4954 5920 2520 6f74 6865 7263 !ENTITY % otherc │ │ │ -0007c4d0: 7265 6469 742e 726f 6c65 2e61 7474 7269 redit.role.attri │ │ │ -0007c4e0: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ -0007c4f0: 223e 0a0a 3c21 454e 5449 5459 2025 206f ">....]]>....]]>. .]]>. │ │ │ -0007c6c0: 0a3c 212d 2d20 5061 6765 4e75 6d73 202e .....< │ │ │ -0007c750: 2145 4e54 4954 5920 2520 7061 6765 6e75 !ENTITY % pagenu │ │ │ -0007c760: 6d73 2e72 6f6c 652e 6174 7472 6962 2022 ms.role.attrib " │ │ │ -0007c770: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ -0007c780: 0a3c 2145 4e54 4954 5920 2520 7061 6765 ...]]>....]]>.......< │ │ │ -0007c990: 215b 2570 6572 736f 6e2e 6964 656e 742e ![%person.ident. │ │ │ -0007c9a0: 6d6f 6475 6c65 3b5b 0a3c 212d 2d46 5554 module;[.]]> │ │ │ -0007cbc0: 0a20 200a 3c21 454e 5449 5459 2025 2063 . ...]]>. ]]>.. . . . ...]]>. ...]]>. < │ │ │ -0007ce90: 212d 2d65 6e64 206f 6620 6669 7273 746e !--end of firstn │ │ │ -0007cea0: 616d 652e 6d6f 6475 6c65 2d2d 3e5d 5d3e ame.module-->]]> │ │ │ -0007ceb0: 0a0a 2020 3c21 454e 5449 5459 2025 2068 .. . . . │ │ │ -0007cf50: 2020 0a3c 2145 4e54 4954 5920 2520 686f ...]]> │ │ │ -0007cfe0: 0a20 200a 3c21 454e 5449 5459 2025 2068 . .. │ │ │ -0007d080: 0a3c 212d 2d65 6e64 206f 6620 686f 6e6f . │ │ │ -0007d0a0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]]>.. . │ │ │ -0007d0f0: 2020 3c21 5b25 6c69 6e65 6167 652e 6d6f . < │ │ │ -0007d130: 2145 4e54 4954 5920 2520 6c69 6e65 6167 !ENTITY % lineag │ │ │ -0007d140: 652e 726f 6c65 2e61 7474 7269 6220 2225 e.role.attrib "% │ │ │ -0007d150: 726f 6c65 2e61 7474 7269 623b 223e 0a20 role.attrib;">. │ │ │ -0007d160: 200a 3c21 454e 5449 5459 2025 206c 696e ...]]>. . │ │ │ -0007d210: 0a3c 215b 256c 696e 6561 6765 2e61 7474 ..]]>. │ │ │ -0007d2a0: 203c 212d 2d65 6e64 206f 6620 6c69 6e65 ]]> │ │ │ -0007d2c0: 0a0a 2020 3c21 454e 5449 5459 2025 206f .. . . . │ │ │ -0007d360: 2020 0a3c 2145 4e54 4954 5920 2520 6f74 ...]]> │ │ │ -0007d3f0: 0a20 200a 3c21 454e 5449 5459 2025 206f . .. │ │ │ -0007d490: 0a3c 212d 2d65 6e64 206f 6620 6f74 6865 . │ │ │ -0007d4b0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]]>.. . │ │ │ -0007d500: 2020 3c21 5b25 7375 726e 616d 652e 6d6f . < │ │ │ -0007d540: 2145 4e54 4954 5920 2520 7375 726e 616d !ENTITY % surnam │ │ │ -0007d550: 652e 726f 6c65 2e61 7474 7269 6220 2225 e.role.attrib "% │ │ │ -0007d560: 726f 6c65 2e61 7474 7269 623b 223e 0a20 role.attrib;">. │ │ │ -0007d570: 200a 3c21 454e 5449 5459 2025 2073 7572 ...]]>. . │ │ │ -0007d620: 0a3c 215b 2573 7572 6e61 6d65 2e61 7474 ..]]>. │ │ │ -0007d6b0: 203c 212d 2d65 6e64 206f 6620 7375 726e ]]> │ │ │ -0007d6d0: 0a3c 212d 2d65 6e64 206f 6620 7065 7273 .]]>....]]>. │ │ │ -0007d930: 3c21 2d2d 656e 6420 6f66 2070 7269 6e74 .....]]>.]] │ │ │ -0007dc30: 3e0a 0a3c 212d 2d20 5072 6f64 7563 744e >.... │ │ │ -0007dc60: 3c21 454e 5449 5459 2025 2070 726f 6475 .. │ │ │ -0007dcd0: 3c21 454e 5449 5459 2025 2070 726f 6475 ....]]>....]]>. │ │ │ -0007dea0: 5d5d 3e0a 0a3c 212d 2d20 5075 6244 6174 ]]>.. │ │ │ -0007ded0: 0a0a 3c21 454e 5449 5459 2025 2070 7562 .... │ │ │ -0007df30: 3c21 454e 5449 5459 2025 2070 7562 6461 . │ │ │ -0007df60: 0a3c 2145 4e54 4954 5920 2520 7075 6264 ...]]>....]]>.]]>......< │ │ │ -0007e160: 215b 2570 7562 6c69 7368 6572 2e6d 6f64 ![%publisher.mod │ │ │ -0007e170: 756c 653b 5b0a 3c21 454e 5449 5459 2025 ule;[....< │ │ │ -0007e1d0: 2145 4e54 4954 5920 2520 7075 626c 6973 !ENTITY % publis │ │ │ -0007e1e0: 6865 722e 656c 656d 656e 7420 2249 4e43 her.element "INC │ │ │ -0007e1f0: 4c55 4445 223e 0a3c 215b 2570 7562 6c69 LUDE">..]]> │ │ │ -0007e260: 0a0a 3c21 454e 5449 5459 2025 2070 7562 ....< │ │ │ -0007e300: 212d 2d65 6e64 206f 6620 7075 626c 6973 !--end of publis │ │ │ -0007e310: 6865 722e 6174 746c 6973 742d 2d3e 5d5d her.attlist-->]] │ │ │ -0007e320: 3e0a 3c21 2d2d 656e 6420 6f66 2070 7562 >. │ │ │ -0007e340: 5d5d 3e0a 0a20 203c 2145 4e54 4954 5920 ]]>.. . . . ... │ │ │ -0007e490: 5d5d 3e0a 2020 0a3c 2145 4e54 4954 5920 ]]>. ...]]>. │ │ │ -0007e570: 203c 212d 2d65 6e64 206f 6620 7075 626c ]]>.. .]]>....... │ │ │ -0007e6c0: 0a3c 2145 4e54 4954 5920 2520 7075 6273 ...< │ │ │ -0007e730: 212d 2d65 6e64 206f 6620 7075 6273 6e75 !--end of pubsnu │ │ │ -0007e740: 6d62 6572 2e65 6c65 6d65 6e74 2d2d 3e5d mber.element-->] │ │ │ -0007e750: 5d3e 0a0a 3c21 454e 5449 5459 2025 2070 ]>....]]>.]]>..........]]>. │ │ │ -0007e9a0: 0a3c 2145 4e54 4954 5920 2520 7265 6c65 ...]]>.]]> │ │ │ -0007ea90: 0a0a 3c21 2d2d 2052 6576 4869 7374 6f72 ....< │ │ │ -0007eac0: 2145 4e54 4954 5920 2520 7265 7668 6973 !ENTITY % revhis │ │ │ -0007ead0: 746f 7279 2e63 6f6e 7465 6e74 2e6d 6f64 tory.content.mod │ │ │ -0007eae0: 756c 6520 2249 4e43 4c55 4445 223e 0a3c ule "INCLUDE">.< │ │ │ -0007eaf0: 215b 2572 6576 6869 7374 6f72 792e 636f ![%revhistory.co │ │ │ -0007eb00: 6e74 656e 742e 6d6f 6475 6c65 3b5b 0a3c ntent.module;[.< │ │ │ -0007eb10: 2145 4e54 4954 5920 2520 7265 7668 6973 !ENTITY % revhis │ │ │ -0007eb20: 746f 7279 2e6d 6f64 756c 6520 2249 4e43 tory.module "INC │ │ │ -0007eb30: 4c55 4445 223e 0a3c 215b 2572 6576 6869 LUDE">......]] │ │ │ -0007ec30: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >....]]>.]]>...... │ │ │ -0007edb0: 3c21 454e 5449 5459 2025 2072 6576 6973 ..]]>.. │ │ │ -0007eea0: 0a3c 215b 2572 6576 6973 696f 6e2e 6174 .. │ │ │ -0007ef30: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2072 ]]>.]]>....]]>.]]>..< │ │ │ -0007f160: 212d 2d20 4461 7465 2028 6465 6669 6e65 !-- Date (define │ │ │ -0007f170: 6420 656c 7365 7768 6572 6520 696e 2074 d elsewhere in t │ │ │ -0007f180: 6869 7320 7365 6374 696f 6e29 2d2d 3e0a his section)-->. │ │ │ -0007f190: 3c21 2d2d 2041 7574 686f 7249 6e69 7469 .... │ │ │ -0007f230: 3c21 454e 5449 5459 2025 2072 6576 7265 ....]]> │ │ │ -0007f2f0: 0a0a 3c21 454e 5449 5459 2025 2072 6576 ....< │ │ │ -0007f390: 212d 2d65 6e64 206f 6620 7265 7672 656d !--end of revrem │ │ │ -0007f3a0: 6172 6b2e 6174 746c 6973 742d 2d3e 5d5d ark.attlist-->]] │ │ │ -0007f3b0: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6576 >. │ │ │ -0007f3d0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.. │ │ │ -0007f400: 0a3c 215b 2025 7265 7664 6573 6372 6970 .. │ │ │ -0007f480: 0a0a 3c21 454e 5449 5459 2025 2072 6576 ...< │ │ │ -0007f4b0: 215b 2025 7265 7664 6573 6372 6970 7469 ![ %revdescripti │ │ │ -0007f4c0: 6f6e 2e65 6c65 6d65 6e74 3b20 5b0a 3c21 on.element; [..]]>....]]>.]] │ │ │ -0007f630: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6576 >.]]>...... │ │ │ -0007f730: 0a0a 3c21 454e 5449 5459 2025 2073 6572 ....]]>. │ │ │ -0007f7d0: 0a3c 2145 4e54 4954 5920 2520 7365 7269 ...]]>.]]>.. │ │ │ -0007f8d0: 3c21 2d2d 2056 6f6c 756d 654e 756d 202e ... │ │ │ -0007f960: 0a3c 2145 4e54 4954 5920 2520 766f 6c75 .....< │ │ │ -0007fa00: 212d 2d65 6e64 206f 6620 766f 6c75 6d65 !--end of volume │ │ │ -0007fa10: 6e75 6d2e 656c 656d 656e 742d 2d3e 5d5d num.element-->]] │ │ │ -0007fa20: 3e0a 0a3c 2145 4e54 4954 5920 2520 766f >.... │ │ │ -0007fac0: 3c21 2d2d 656e 6420 6f66 2076 6f6c 756d ] │ │ │ -0007fae0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 766f ]>.]]>....... │ │ │ -0007fc70: 0a3c 215b 2561 6363 656c 2e6d 6f64 756c ......]]>.]]>.. │ │ │ -0007fe40: 0a3c 215b 2561 6374 696f 6e2e 6d6f 6475 ......]]>....< │ │ │ -0007ffd0: 212d 2d65 6e64 206f 6620 6163 7469 6f6e !--end of action │ │ │ -0007ffe0: 2e61 7474 6c69 7374 2d2d 3e5d 5d3e 0a3c .attlist-->]]>.< │ │ │ -0007fff0: 212d 2d65 6e64 206f 6620 6163 7469 6f6e !--end of action │ │ │ -00080000: 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c .module-->]]>..< │ │ │ -00080010: 2145 4e54 4954 5920 2520 6170 706c 6963 !ENTITY % applic │ │ │ -00080020: 6174 696f 6e2e 6d6f 6475 6c65 2022 494e ation.module "IN │ │ │ -00080030: 434c 5544 4522 3e0a 3c21 5b25 6170 706c CLUDE">......]]> │ │ │ -00080140: 0a0a 3c21 454e 5449 5459 2025 2061 7070 ....]]>.]] │ │ │ -00080270: 3e0a 0a3c 2145 4e54 4954 5920 2520 636c >........]]>....]]>.]]>..... │ │ │ -00080590: 0a0a 3c21 454e 5449 5459 2025 2063 6f2e .... │ │ │ -000805f0: 5d5d 3e0a 0a3c 212d 2d20 6275 6720 6e75 ]]>..... │ │ │ -00080650: 0a3c 2145 4e54 4954 5920 2520 636f 2e61 ...]] │ │ │ -00080710: 3e0a 3c21 2d2d 656e 6420 6f66 2063 6f2e >.]]>........< │ │ │ -00080820: 212d 2d65 6e64 206f 6620 636f 6d6d 616e !--end of comman │ │ │ -00080830: 642e 656c 656d 656e 742d 2d3e 5d5d 3e0a d.element-->]]>. │ │ │ -00080840: 0a3c 2145 4e54 4954 5920 2520 636f 6d6d ...]]>.]]>........ │ │ │ -00080a70: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....< │ │ │ -00080b40: 212d 2d65 6e64 206f 6620 636f 6d70 7574 !--end of comput │ │ │ -00080b50: 6572 6f75 7470 7574 2e61 7474 6c69 7374 eroutput.attlist │ │ │ -00080b60: 2d2d 3e5d 5d3e 0a3c 212d 2d65 6e64 206f -->]]>.]]>..< │ │ │ -00080b90: 2145 4e54 4954 5920 2520 6461 7461 6261 !ENTITY % databa │ │ │ -00080ba0: 7365 2e6d 6f64 756c 6520 2249 4e43 4c55 se.module "INCLU │ │ │ -00080bb0: 4445 223e 0a3c 215b 2564 6174 6162 6173 DE">.. │ │ │ -00080bf0: 3c21 454e 5449 5459 2025 2064 6174 6162 │ │ │ -00080c20: 0a0a 3c21 454e 5449 5459 2025 2064 6174 ....]]>..< │ │ │ -00080cb0: 212d 2d20 436c 6173 733a 2054 7970 6520 !-- Class: Type │ │ │ -00080cc0: 6f66 2064 6174 6162 6173 6520 7468 6520 of database the │ │ │ -00080cd0: 656c 656d 656e 7420 6e61 6d65 733b 206e element names; n │ │ │ -00080ce0: 6f20 6465 6661 756c 7420 2d2d 3e0a 0a0a o default -->... │ │ │ -00080cf0: 3c21 454e 5449 5459 2025 2064 6174 6162 ..]]>.]]>.. │ │ │ -00080e30: 3c21 454e 5449 5459 2025 2065 6d61 696c ......]]>.]]>... │ │ │ -00081020: 3c21 5b25 656e 7661 722e 6d6f 6475 6c65 ..... │ │ │ -00081100: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>.... │ │ │ -00081230: 0a3c 2145 4e54 4954 5920 2520 6572 726f .... │ │ │ -000812d0: 0a3c 212d 2d65 6e64 206f 6620 6572 726f . │ │ │ -000812f0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>.... │ │ │ -00081450: 3c21 454e 5449 5459 2025 2065 7272 6f72 .... │ │ │ -000814f0: 3c21 2d2d 656e 6420 6f66 2065 7272 6f72 ] │ │ │ -00081510: 5d3e 0a0a 3c21 454e 5449 5459 2025 2065 ]>... │ │ │ -000815b0: 0a3c 212d 2d65 6e64 206f 6620 6572 726f . │ │ │ -000815d0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2065 ]]>.]]>..< │ │ │ -00081720: 2145 4e54 4954 5920 2520 6572 726f 7274 !ENTITY % errort │ │ │ -00081730: 7970 652e 6174 746c 6973 7420 2249 4e43 ype.attlist "INC │ │ │ -00081740: 4c55 4445 223e 0a3c 215b 2565 7272 6f72 LUDE">..]]>.< │ │ │ -000817e0: 212d 2d65 6e64 206f 6620 6572 726f 7274 !--end of errort │ │ │ -000817f0: 7970 652e 6d6f 6475 6c65 2d2d 3e5d 5d3e ype.module-->]]> │ │ │ -00081800: 0a0a 3c21 454e 5449 5459 2025 2066 696c ........< │ │ │ -00081900: 212d 2d65 6e64 206f 6620 6669 6c65 6e61 !--end of filena │ │ │ -00081910: 6d65 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e me.element-->]]> │ │ │ -00081920: 0a0a 3c21 2d2d 2043 6c61 7373 3a20 5479 .. │ │ │ -00081960: 0a3c 212d 2d20 5061 7468 3a20 5365 6172 ..... │ │ │ -00081b30: 0a3c 212d 2d65 6e64 206f 6620 6669 6c65 .] │ │ │ -00081b50: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6669 ]>. │ │ │ -00081b70: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.......< │ │ │ -00081c30: 215b 2566 756e 6374 696f 6e2e 656c 656d ![%function.elem │ │ │ -00081c40: 656e 743b 5b0a 3c21 454c 454d 454e 5420 ent;[..]]>.. │ │ │ -00081c90: 3c21 454e 5449 5459 2025 2066 756e 6374 ..]]>.]]>.. │ │ │ -00081d80: 3c21 454e 5449 5459 2025 2067 7569 6275 .....< │ │ │ -00081e40: 215b 2567 7569 6275 7474 6f6e 2e65 6c65 ![%guibutton.ele │ │ │ -00081e50: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..]]>....< │ │ │ -00081f60: 212d 2d65 6e64 206f 6620 6775 6962 7574 !--end of guibut │ │ │ -00081f70: 746f 6e2e 6174 746c 6973 742d 2d3e 5d5d ton.attlist-->]] │ │ │ -00081f80: 3e0a 3c21 2d2d 656e 6420 6f66 2067 7569 >. │ │ │ -00081fa0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....... │ │ │ -000820a0: 0a3c 212d 2d65 6e64 206f 6620 6775 6969 .]] │ │ │ -000820c0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6775 >....]]>.]]>......< │ │ │ -00082240: 2145 4e54 4954 5920 2520 6775 696c 6162 !ENTITY % guilab │ │ │ -00082250: 656c 2e65 6c65 6d65 6e74 2022 494e 434c el.element "INCL │ │ │ -00082260: 5544 4522 3e0a 3c21 5b25 6775 696c 6162 UDE">..< │ │ │ -000822b0: 212d 2d65 6e64 206f 6620 6775 696c 6162 !--end of guilab │ │ │ -000822c0: 656c 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e el.element-->]]> │ │ │ -000822d0: 0a0a 3c21 454e 5449 5459 2025 2067 7569 ....]]>. │ │ │ -000823a0: 3c21 2d2d 656e 6420 6f66 2067 7569 6c61 ]]> │ │ │ -000823c0: 0a0a 3c21 454e 5449 5459 2025 2067 7569 .... │ │ │ -00082420: 3c21 454e 5449 5459 2025 2067 7569 6d65 . │ │ │ -00082450: 0a3c 2145 4e54 4954 5920 2520 6775 696d ...]]>.. │ │ │ -000824e0: 3c21 454e 5449 5459 2025 2067 7569 6d65 ..]]>.]]>....... │ │ │ -000826e0: 0a3c 212d 2d65 6e64 206f 6620 6775 696d .]]>.]]>....... │ │ │ -000828d0: 3c21 5b25 6775 6973 7562 6d65 6e75 2e65 .]]> │ │ │ -00082940: 0a0a 3c21 454e 5449 5459 2025 2067 7569 ....]]>.]]>.. │ │ │ -00082a40: 3c21 454e 5449 5459 2025 2068 6172 6477 . │ │ │ -00082aa0: 0a3c 2145 4e54 4954 5920 2520 6861 7264 .....]]>.. │ │ │ -00082b60: 3c21 454e 5449 5459 2025 2068 6172 6477 ..]]>.]]>.. │ │ │ -00082c50: 3c21 454e 5449 5459 2025 2069 6e74 6572 .....< │ │ │ -00082d10: 215b 2569 6e74 6572 6661 6365 2e65 6c65 ![%interface.ele │ │ │ -00082d20: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..]]>......< │ │ │ -00082de0: 215b 2569 6e74 6572 6661 6365 2e61 7474 ![%interface.att │ │ │ -00082df0: 6c69 7374 3b5b 0a3c 2141 5454 4c49 5354 list;[..]]>.]]>........]]>.... │ │ │ -00083060: 3c21 2d2d 656e 6420 6f66 206b 6579 6361 ]]>. │ │ │ -00083080: 3c21 2d2d 656e 6420 6f66 206b 6579 6361 ]]>.. │ │ │ -000830a0: 3c21 454e 5449 5459 2025 206b 6579 636f ....< │ │ │ -00083130: 2145 4e54 4954 5920 2520 6b65 7963 6f64 !ENTITY % keycod │ │ │ -00083140: 652e 656c 656d 656e 7420 2249 4e43 4c55 e.element "INCLU │ │ │ -00083150: 4445 223e 0a3c 215b 256b 6579 636f 6465 DE">..]]>....]]>.]]>...... │ │ │ -00083320: 3c21 454e 5449 5459 2025 206b 6579 636f ..]]>....]]>. │ │ │ -000834a0: 3c21 2d2d 656e 6420 6f66 206b 6579 636f ]]> │ │ │ -000834c0: 0a0a 3c21 454e 5449 5459 2025 206b 6579 ........]] │ │ │ -000835d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6b65 >....]] │ │ │ -00083680: 3e0a 3c21 2d2d 656e 6420 6f66 206b 6579 >.]]> │ │ │ -000836a0: 0a0a 3c21 454e 5449 5459 2025 206c 696e ........]]>....]]>.]] │ │ │ -000838f0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6c69 >... │ │ │ -00083950: 0a3c 2145 4e54 4954 5920 2520 6c69 7465 . │ │ │ -00083980: 0a0a 3c21 454e 5449 5459 2025 206c 6974 ....]]>.]]>..< │ │ │ -00083af0: 2145 4e54 4954 5920 2520 636f 6e73 7461 !ENTITY % consta │ │ │ -00083b00: 6e74 2e6d 6f64 756c 6520 2249 4e43 4c55 nt.module "INCLU │ │ │ -00083b10: 4445 223e 0a3c 215b 2025 636f 6e73 7461 DE">...... │ │ │ -00083bf0: 3c21 2d2d 656e 6420 6f66 2063 6f6e 7374 ]] │ │ │ -00083c10: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >....]]>.]]>... │ │ │ -00083d30: 3c21 5b20 2576 6172 6e61 6d65 2e6d 6f64 .....]]>.]]>........]]>....]]>.]]>....... │ │ │ -000841a0: 3c21 5b25 6d65 6469 616c 6162 656c 2e65 .]]>.......< │ │ │ -00084330: 212d 2d65 6e64 206f 6620 6d65 6469 616c !--end of medial │ │ │ -00084340: 6162 656c 2e61 7474 6c69 7374 2d2d 3e5d abel.attlist-->] │ │ │ -00084350: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6d65 ]>.]]>. │ │ │ -00084610: 3c21 2d2d 656e 6420 6f66 206d 656e 7563 ] │ │ │ -00084630: 5d3e 0a0a 3c21 454e 5449 5459 2025 2073 ]>..... │ │ │ -000846b0: 3c21 454e 5449 5459 2025 2073 686f 7274 │ │ │ -000846e0: 0a0a 3c21 454e 5449 5459 2025 2073 686f ....]]>..< │ │ │ -00084780: 2145 4e54 4954 5920 2520 7368 6f72 7463 !ENTITY % shortc │ │ │ -00084790: 7574 2e61 7474 6c69 7374 2022 494e 434c ut.attlist "INCL │ │ │ -000847a0: 5544 4522 3e0a 3c21 5b25 7368 6f72 7463 UDE">.. │ │ │ -00084840: 3c21 2d2d 656e 6420 6f66 2073 686f 7274 ]] │ │ │ -00084860: 3e0a 3c21 2d2d 656e 6420 6f66 2073 686f >.] │ │ │ -00084880: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6d65 ]>.]]>..< │ │ │ -000848b0: 2145 4e54 4954 5920 2520 6d6f 7573 6562 !ENTITY % mouseb │ │ │ -000848c0: 7574 746f 6e2e 6d6f 6475 6c65 2022 494e utton.module "IN │ │ │ -000848d0: 434c 5544 4522 3e0a 3c21 5b25 6d6f 7573 CLUDE">..... │ │ │ -000849c0: 0a3c 212d 2d65 6e64 206f 6620 6d6f 7573 .]]>.]]>.. │ │ │ -00084b10: 0a3c 215b 256d 7367 7465 7874 2e6d 6f64 .... │ │ │ -00084ba0: 0a3c 215b 256d 7367 7465 7874 2e65 6c65 ..< │ │ │ -00084be0: 212d 2d65 6e64 206f 6620 6d73 6774 6578 !--end of msgtex │ │ │ -00084bf0: 742e 656c 656d 656e 742d 2d3e 5d5d 3e0a t.element-->]]>. │ │ │ -00084c00: 0a3c 2145 4e54 4954 5920 2520 6d73 6774 ... │ │ │ -00084e90: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206f ]]>.] │ │ │ -00084eb0: 5d3e 0a0a 3c21 454e 5449 5459 2025 206f ]>........]]>..< │ │ │ -00084fd0: 2145 4e54 4954 5920 2520 6f70 7469 6f6e !ENTITY % option │ │ │ -00084fe0: 616c 2e61 7474 6c69 7374 2022 494e 434c al.attlist "INCL │ │ │ -00084ff0: 5544 4522 3e0a 3c21 5b25 6f70 7469 6f6e UDE">..]]>.]]>....< │ │ │ -00085110: 2145 4e54 4954 5920 2520 7061 7261 6d65 !ENTITY % parame │ │ │ -00085120: 7465 722e 726f 6c65 2e61 7474 7269 6220 ter.role.attrib │ │ │ -00085130: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ -00085140: 0a0a 3c21 454e 5449 5459 2025 2070 6172 ....< │ │ │ -000851b0: 212d 2d65 6e64 206f 6620 7061 7261 6d65 !--end of parame │ │ │ -000851c0: 7465 722e 656c 656d 656e 742d 2d3e 5d5d ter.element-->]] │ │ │ -000851d0: 3e0a 0a3c 212d 2d20 436c 6173 733a 2054 >......< │ │ │ -00085230: 215b 2570 6172 616d 6574 6572 2e61 7474 ![%parameter.att │ │ │ -00085240: 6c69 7374 3b5b 0a3c 2141 5454 4c49 5354 list;[..< │ │ │ -000852f0: 212d 2d65 6e64 206f 6620 7061 7261 6d65 !--end of parame │ │ │ -00085300: 7465 722e 6174 746c 6973 742d 2d3e 5d5d ter.attlist-->]] │ │ │ -00085310: 3e0a 3c21 2d2d 656e 6420 6f66 2070 6172 >. │ │ │ -00085330: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.... │ │ │ -00085390: 3c21 454e 5449 5459 2025 2070 726f 6d70 .. │ │ │ -000853c0: 3c21 454e 5449 5459 2025 2070 726f 6d70 .. │ │ │ -00085440: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>..... │ │ │ -00085960: 0a3c 215b 2572 6570 6c61 6365 6162 6c65 ..]]>.]]>........< │ │ │ -00085b80: 212d 2d65 6e64 206f 6620 7265 7475 726e !--end of return │ │ │ -00085b90: 7661 6c75 652e 656c 656d 656e 742d 2d3e value.element--> │ │ │ -00085ba0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...< │ │ │ -00085bd0: 215b 2572 6574 7572 6e76 616c 7565 2e61 ![%returnvalue.a │ │ │ -00085be0: 7474 6c69 7374 3b5b 0a3c 2141 5454 4c49 ttlist;[..]]> │ │ │ -00085c70: 0a3c 212d 2d65 6e64 206f 6620 7265 7475 .]]>.......]]>.]]>.. │ │ │ -00085fe0: 0a3c 215b 2573 7472 7563 7466 6965 6c64 .... │ │ │ -00086080: 0a3c 215b 2573 7472 7563 7466 6965 6c64 ..]]>.. │ │ │ -000860f0: 3c21 454e 5449 5459 2025 2073 7472 7563 ..]]>.]]>. │ │ │ -000861e0: 0a3c 2145 4e54 4954 5920 2520 7374 7275 .......]]>. │ │ │ -00086310: 0a3c 2145 4e54 4954 5920 2520 7374 7275 ...]]>.]]>...< │ │ │ -00086420: 215b 2573 796d 626f 6c2e 6d6f 6475 6c65 ![%symbol.module │ │ │ -00086430: 3b5b 0a3c 2145 4e54 4954 5920 2520 6c6f ;[......]]>...... │ │ │ -000865e0: 0a3c 212d 2d65 6e64 206f 6620 7379 6d62 .]]> │ │ │ -00086600: 0a3c 212d 2d65 6e64 206f 6620 7379 6d62 .]]>. │ │ │ -00086620: 0a3c 2145 4e54 4954 5920 2520 7379 7374 .......]]>......]]>..... │ │ │ -000869c0: 0a0a 3c21 454e 5449 5459 2025 2074 6f6b ....]] │ │ │ -00086a40: 3e0a 0a3c 2145 4e54 4954 5920 2520 746f >....]]>.]]>....< │ │ │ -00086b60: 2145 4e54 4954 5920 2520 7479 7065 2e72 !ENTITY % type.r │ │ │ -00086b70: 6f6c 652e 6174 7472 6962 2022 2572 6f6c ole.attrib "%rol │ │ │ -00086b80: 652e 6174 7472 6962 3b22 3e0a 0a3c 2145 e.attrib;">... │ │ │ -00086bb0: 3c21 5b25 7479 7065 2e65 6c65 6d65 6e74 .]]>....]]>.]]>.. │ │ │ -00086cf0: 0a3c 215b 2575 7365 7269 6e70 7574 2e6d ... │ │ │ -00086d60: 0a3c 2145 4e54 4954 5920 2520 7573 6572 ...]]>....]]> │ │ │ -00086ec0: 0a3c 212d 2d65 6e64 206f 6620 7573 6572 .] │ │ │ -00086ee0: 5d3e 0a0a 3c21 2d2d 2047 656e 6572 616c ]>...... │ │ │ -00086f90: 3c21 454e 5449 5459 2025 2061 6262 7265 .. │ │ │ -00086fc0: 3c21 454e 5449 5459 2025 2061 6262 7265 ..< │ │ │ -00087020: 212d 2d65 6e64 206f 6620 6162 6272 6576 !--end of abbrev │ │ │ -00087030: 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e 0a0a .element-->]]>.. │ │ │ -00087040: 3c21 454e 5449 5459 2025 2061 6262 7265 ..]]>.]]>........< │ │ │ -00087200: 212d 2d65 6e64 206f 6620 6163 726f 6e79 !--end of acrony │ │ │ -00087210: 6d2e 656c 656d 656e 742d 2d3e 5d5d 3e0a m.element-->]]>. │ │ │ -00087220: 0a3c 2145 4e54 4954 5920 2520 6163 726f ...]]>. │ │ │ -00087410: 0a3c 2145 4e54 4954 5920 2520 6369 7461 ...]]>.]]>...... │ │ │ -00087590: 3c21 454e 5449 5459 2025 2063 6974 6572 ..]]>. │ │ │ -00087630: 0a3c 2145 4e54 4954 5920 2520 6369 7465 ...] │ │ │ -00087700: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6369 ]>.]]>...... │ │ │ -000877d0: 3c21 454e 5449 5459 2025 2072 6566 656e ..]]>.... │ │ │ -00087940: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2072 ]]>.]]>....< │ │ │ -000879d0: 2145 4e54 4954 5920 2520 6e61 6d76 6f6c !ENTITY % namvol │ │ │ -000879e0: 6e75 6d2e 726f 6c65 2e61 7474 7269 6220 num.role.attrib │ │ │ -000879f0: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ -00087a00: 0a0a 3c21 454e 5449 5459 2025 206d 616e ....]]>....]]>.]]>. │ │ │ -00087b70: 0a3c 2145 4e54 4954 5920 2520 6369 7465 ...... │ │ │ -00087c30: 3c21 5b25 6369 7465 7469 746c 652e 656c . │ │ │ -00087c70: 3c21 2d2d 656e 6420 6f66 2063 6974 6574 ] │ │ │ -00087c90: 5d3e 0a0a 3c21 2d2d 2050 7562 776f 726b ]>... │ │ │ -00087cd0: 0a0a 3c21 454e 5449 5459 2025 2063 6974 ....]]>.]]>. │ │ │ -00087e40: 0a3c 2145 4e54 4954 5920 2520 656d 7068 .......]]>....]]>...< │ │ │ -00088060: 215b 2566 6972 7374 7465 726d 2e6d 6f64 ![%firstterm.mod │ │ │ -00088070: 756c 653b 5b0a 3c21 454e 5449 5459 2025 ule;[....< │ │ │ -000880d0: 2145 4e54 4954 5920 2520 6669 7273 7474 !ENTITY % firstt │ │ │ -000880e0: 6572 6d2e 656c 656d 656e 7420 2249 4e43 erm.element "INC │ │ │ -000880f0: 4c55 4445 223e 0a3c 215b 2566 6972 7374 LUDE">..]]>..... │ │ │ -000881b0: 0a3c 215b 2566 6972 7374 7465 726d 2e61 ..]]>.]]>...... │ │ │ -00088350: 0a3c 215b 2566 6f72 6569 676e 7068 7261 ..]]>. │ │ │ -000883c0: 0a3c 2145 4e54 4954 5920 2520 666f 7265 ...]]>.]]>.. │ │ │ -000884c0: 3c21 454e 5449 5459 2025 2067 6c6f 7373 .....< │ │ │ -00088580: 215b 2567 6c6f 7373 7465 726d 2e65 6c65 ![%glossterm.ele │ │ │ -00088590: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..< │ │ │ -000885c0: 212d 2d65 6e64 206f 6620 676c 6f73 7374 !--end of glosst │ │ │ -000885d0: 6572 6d2e 656c 656d 656e 742d 2d3e 5d5d erm.element-->]] │ │ │ -000885e0: 3e0a 0a3c 212d 2d20 746f 2047 6c6f 7373 >.... │ │ │ -00088660: 0a0a 3c21 454e 5449 5459 2025 2067 6c6f ....]]>.< │ │ │ -00088750: 212d 2d65 6e64 206f 6620 676c 6f73 7374 !--end of glosst │ │ │ -00088760: 6572 6d2e 6d6f 6475 6c65 2d2d 3e5d 5d3e erm.module-->]]> │ │ │ -00088770: 0a0a 3c21 454e 5449 5459 2025 2070 6872 ........]]>....]]>.]]>.... │ │ │ -000889d0: 0a0a 3c21 454e 5449 5459 2025 2071 756f ....]]>.... │ │ │ -00088b10: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....... │ │ │ -00088bd0: 3c21 5b25 7375 6273 6372 6970 742e 656c .]]>. │ │ │ -00088cd0: 0a3c 2145 4e54 4954 5920 2520 7375 6273 ...]]>.. │ │ │ -00088d90: 3c21 454e 5449 5459 2025 2073 7570 6572 ..]]> │ │ │ -00088ec0: 0a0a 3c21 454e 5449 5459 2025 2073 7570 ....]]>.]]>.. │ │ │ -00088fd0: 0a3c 215b 2574 7261 6465 6d61 726b 2e6d ... │ │ │ -00089040: 0a3c 2145 4e54 4954 5920 2520 7472 6164 .. │ │ │ -00089140: 0a3c 212d 2d65 6e64 206f 6620 7472 6164 . │ │ │ -00089160: 5d5d 3e0a 0a3c 212d 2d20 436c 6173 733a ]]>.......]]> │ │ │ -000892b0: 0a3c 212d 2d65 6e64 206f 6620 7472 6164 .] │ │ │ -000892d0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2077 ]>......< │ │ │ -00089370: 2145 4e54 4954 5920 2520 776f 7264 6173 !ENTITY % wordas │ │ │ -00089380: 776f 7264 2e65 6c65 6d65 6e74 2022 494e word.element "IN │ │ │ -00089390: 434c 5544 4522 3e0a 3c21 5b25 776f 7264 CLUDE">..]]>..< │ │ │ -00089400: 2145 4e54 4954 5920 2520 776f 7264 6173 !ENTITY % wordas │ │ │ -00089410: 776f 7264 2e61 7474 6c69 7374 2022 494e word.attlist "IN │ │ │ -00089420: 434c 5544 4522 3e0a 3c21 5b25 776f 7264 CLUDE">. │ │ │ -000894a0: 0a3c 212d 2d65 6e64 206f 6620 776f 7264 .]]>...........]]>. │ │ │ -000896c0: 0a3c 212d 2d20 456e 6474 6572 6d3a 2049 .. │ │ │ -00089770: 3c21 2d2d 2054 7970 653a 2046 7265 656c .... │ │ │ -000897c0: 3c21 5b25 6c69 6e6b 2e61 7474 6c69 7374 .]]>. │ │ │ -000898a0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....... │ │ │ -00089950: 3c21 5b25 6f6c 696e 6b2e 656c 656d 656e .]]>..........] │ │ │ -00089be0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6f6c ]>.]]> │ │ │ -00089c00: 0a0a 3c21 454e 5449 5459 2025 2075 6c69 ........ │ │ │ -00089d00: 5d5d 3e0a 0a3c 212d 2d20 5552 4c3a 2075 ]]>.... │ │ │ -00089d70: 0a0a 3c21 454e 5449 5459 2025 2075 6c69 ....]]>.]]>........]]>..< │ │ │ -00089f90: 212d 2d20 746f 2066 6f6f 746e 6f74 6520 !-- to footnote │ │ │ -00089fa0: 636f 6e74 656e 7420 7375 7070 6c69 6564 content supplied │ │ │ -00089fb0: 2065 6c73 6577 6865 7265 202d 2d3e 0a0a elsewhere -->.. │ │ │ -00089fc0: 0a3c 2145 4e54 4954 5920 2520 666f 6f74 ...] │ │ │ -0008a0b0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 666f ]>.]]>..............]]>............ │ │ │ -0008a4e0: 0a3c 2145 4e54 4954 5920 2520 616e 6368 ... │ │ │ -0008a5f0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.] │ │ │ -0008a610: 5d3e 0a0a 3c21 454e 5449 5459 2025 2062 ]>........]]>......< │ │ │ -0008a790: 215b 2562 6567 696e 7061 6765 2e61 7474 ![%beginpage.att │ │ │ -0008a7a0: 6c69 7374 3b5b 0a3c 2141 5454 4c49 5354 list;[..]]>.]]>.......... │ │ │ -0008a9c0: 3c21 5b25 696e 6465 7874 6572 6d2e 656c .]]>.. │ │ │ -0008aa70: 3c21 2d2d 2053 636f 7065 3a20 496e 6469 .........]]>.. │ │ │ -0008af50: 0a3c 215b 2570 7269 6d73 6563 7465 722e .. │ │ │ -0008af90: 3c21 454e 5449 5459 2025 2070 7269 6d73 .....]]>.... │ │ │ -0008b0e0: 3c21 5b25 7072 696d 6172 792e 6174 746c .]]>... │ │ │ -0008b190: 3c21 454e 5449 5459 2025 2073 6563 6f6e ..]]>.....]]>.... │ │ │ -0008b390: 3c21 5b25 7465 7274 6961 7279 2e65 6c65 . │ │ │ -0008b3f0: 5d5d 3e0a 3c21 2d2d 2053 6f72 7441 733a ]]>.. │ │ │ -0008b460: 0a3c 2145 4e54 4954 5920 2520 7465 7274 ...]]>..]]>........]]>.. │ │ │ -0008b670: 3c21 454e 5449 5459 2025 2073 6565 2e61 ..]]>.. │ │ │ -0008b740: 0a3c 215b 2573 6565 616c 736f 2e65 6c65 .. │ │ │ -0008b780: 3c21 2d2d 656e 6420 6f66 2073 6565 616c ]]> │ │ │ -0008b7a0: 0a0a 3c21 454e 5449 5459 2025 2073 6565 ....]]>.]]>.< │ │ │ -0008b880: 212d 2d65 6e64 206f 6620 696e 6465 7874 !--end of indext │ │ │ -0008b890: 6572 6d2e 636f 6e74 656e 742e 6d6f 6475 erm.content.modu │ │ │ -0008b8a0: 6c65 2d2d 3e5d 5d3e 0a0a 3c21 2d2d 2045 le-->]]>.........d │ │ │ -0008b950: 656d 6f2f 646f 6373 7263 2f44 6f63 426f emo/docsrc/DocBo │ │ │ -0008b960: 6f6b 2f64 626e 6f74 6e78 2e6d 6f64 df00 ok/dbnotnx.mod.. │ │ │ -0008b970: 0010 a23c 212d 2d20 2e2e 2e2e 2e2e 2e2e ..........< │ │ │ -0008c1c0: 2145 4e54 4954 5920 2520 6e6f 7461 7469 !ENTITY % notati │ │ │ -0008c1d0: 6f6e 2e63 6c61 7373 0a09 0922 424d 507c on.class..."BMP| │ │ │ -0008c1e0: 2043 474d 2d43 4841 5220 7c20 4347 4d2d CGM-CHAR | CGM- │ │ │ -0008c1f0: 4249 4e41 5259 207c 2043 474d 2d43 4c45 BINARY | CGM-CLE │ │ │ -0008c200: 4152 207c 2044 4954 524f 4646 207c 2044 AR | DITROFF | D │ │ │ -0008c210: 5649 0a09 097c 2045 5053 207c 2045 514e VI...| EPS | EQN │ │ │ -0008c220: 207c 2046 4158 207c 2047 4946 207c 2047 | FAX | GIF | G │ │ │ -0008c230: 4946 3837 6120 7c20 4749 4638 3961 200a IF87a | GIF89a . │ │ │ -0008c240: 0909 7c20 4a50 4720 7c20 4a50 4547 207c ..| JPG | JPEG | │ │ │ -0008c250: 2049 4745 5320 7c20 5043 580a 0909 7c20 IGES | PCX...| │ │ │ -0008c260: 5049 4320 7c20 504e 4720 7c20 5053 207c PIC | PNG | PS | │ │ │ -0008c270: 2053 474d 4c20 7c20 5442 4c20 7c20 5445 SGML | TBL | TE │ │ │ -0008c280: 5820 7c20 5449 4646 207c 2057 4d46 207c X | TIFF | WMF | │ │ │ -0008c290: 2057 5047 0a09 097c 206c 696e 6573 7065 WPG...| linespe │ │ │ -0008c2a0: 6369 6669 630a 0909 256c 6f63 616c 2e6e cific...%local.n │ │ │ -0008c2b0: 6f74 6174 696f 6e2e 636c 6173 733b 223e otation.class;"> │ │ │ -0008c2c0: 0a0a 3c21 4e4f 5441 5449 4f4e 2042 4d50 .......< │ │ │ -0008c430: 214e 4f54 4154 494f 4e20 4456 4909 0953 !NOTATION DVI..S │ │ │ -0008c440: 5953 5445 4d20 2244 5649 223e 0a3c 214e YSTEM "DVI">.. │ │ │ -0008c4d0: 0a3c 214e 4f54 4154 494f 4e20 4641 5809 .. │ │ │ -0008c550: 0a3c 214e 4f54 4154 494f 4e20 4749 4638 ...... │ │ │ -0008c6d0: 0a3c 214e 4f54 4154 494f 4e20 5043 5809 .. │ │ │ -0008c750: 0a3c 214e 4f54 4154 494f 4e20 504e 4720 .. │ │ │ -0008c790: 3c21 4e4f 5441 5449 4f4e 2050 5309 0953 ...... ..........demo/d │ │ │ -0008ca20: 6f63 7372 632f 446f 6342 6f6f 6b2f 6462 ocsrc/DocBook/db │ │ │ -0008ca30: 6869 6572 782e 6d6f 64df 0000 e898 3c21 hierx.mod.........< │ │ │ -0008cb30: 212d 2d20 436f 7079 7269 6768 7420 3139 !-- Copyright 19 │ │ │ -0008cb40: 3932 2d32 3030 3020 4861 4c20 436f 6d70 92-2000 HaL Comp │ │ │ -0008cb50: 7574 6572 2053 7973 7465 6d73 2c20 496e uter Systems, In │ │ │ -0008cb60: 632e 2c0a 2020 2020 204f 2752 6569 6c6c c.,. O'Reill │ │ │ -0008cb70: 7920 2620 4173 736f 6369 6174 6573 2c20 y & Associates, │ │ │ -0008cb80: 496e 632e 2c20 4172 626f 7254 6578 742c Inc., ArborText, │ │ │ -0008cb90: 2049 6e63 2e2c 2046 756a 6974 7375 2053 Inc., Fujitsu S │ │ │ -0008cba0: 6f66 7477 6172 650a 2020 2020 2043 6f72 oftware. Cor │ │ │ -0008cbb0: 706f 7261 7469 6f6e 2c20 4e6f 726d 616e poration, Norman │ │ │ -0008cbc0: 2057 616c 7368 2c20 616e 6420 7468 6520 Walsh, and the │ │ │ -0008cbd0: 4f72 6761 6e69 7a61 7469 6f6e 2066 6f72 Organization for │ │ │ -0008cbe0: 2074 6865 2041 6476 616e 6365 6d65 6e74 the Advancement │ │ │ -0008cbf0: 0a20 2020 2020 6f66 2053 7472 7563 7475 . of Structu │ │ │ -0008cc00: 7265 6420 496e 666f 726d 6174 696f 6e20 red Information │ │ │ -0008cc10: 5374 616e 6461 7264 7320 284f 4153 4953 Standards (OASIS │ │ │ -0008cc20: 292e 0a0a 2020 2020 2024 4964 240a 0a20 )... $Id$.. │ │ │ -0008cc30: 2020 2020 5065 726d 6973 7369 6f6e 2074 Permission t │ │ │ -0008cc40: 6f20 7573 652c 2063 6f70 792c 206d 6f64 o use, copy, mod │ │ │ -0008cc50: 6966 7920 616e 6420 6469 7374 7269 6275 ify and distribu │ │ │ -0008cc60: 7465 2074 6865 2044 6f63 426f 6f6b 2058 te the DocBook X │ │ │ -0008cc70: 4d4c 2044 5444 0a20 2020 2020 616e 6420 ML DTD. and │ │ │ -0008cc80: 6974 7320 6163 636f 6d70 616e 7969 6e67 its accompanying │ │ │ -0008cc90: 2064 6f63 756d 656e 7461 7469 6f6e 2066 documentation f │ │ │ -0008cca0: 6f72 2061 6e79 2070 7572 706f 7365 2061 or any purpose a │ │ │ -0008ccb0: 6e64 2077 6974 686f 7574 2066 6565 0a20 nd without fee. │ │ │ -0008ccc0: 2020 2020 6973 2068 6572 6562 7920 6772 is hereby gr │ │ │ -0008ccd0: 616e 7465 6420 696e 2070 6572 7065 7475 anted in perpetu │ │ │ -0008cce0: 6974 792c 2070 726f 7669 6465 6420 7468 ity, provided th │ │ │ -0008ccf0: 6174 2074 6865 2061 626f 7665 2063 6f70 at the above cop │ │ │ -0008cd00: 7972 6967 6874 0a20 2020 2020 6e6f 7469 yright. noti │ │ │ -0008cd10: 6365 2061 6e64 2074 6869 7320 7061 7261 ce and this para │ │ │ -0008cd20: 6772 6170 6820 6170 7065 6172 2069 6e20 graph appear in │ │ │ -0008cd30: 616c 6c20 636f 7069 6573 2e20 2054 6865 all copies. The │ │ │ -0008cd40: 2063 6f70 7972 6967 6874 0a20 2020 2020 copyright. │ │ │ -0008cd50: 686f 6c64 6572 7320 6d61 6b65 206e 6f20 holders make no │ │ │ -0008cd60: 7265 7072 6573 656e 7461 7469 6f6e 2061 representation a │ │ │ -0008cd70: 626f 7574 2074 6865 2073 7569 7461 6269 bout the suitabi │ │ │ -0008cd80: 6c69 7479 206f 6620 7468 6520 4454 4420 lity of the DTD │ │ │ -0008cd90: 666f 720a 2020 2020 2061 6e79 2070 7572 for. any pur │ │ │ -0008cda0: 706f 7365 2e20 2049 7420 6973 2070 726f pose. It is pro │ │ │ -0008cdb0: 7669 6465 6420 2261 7320 6973 2220 7769 vided "as is" wi │ │ │ -0008cdc0: 7468 6f75 7420 6578 7072 6573 7365 6420 thout expressed │ │ │ -0008cdd0: 6f72 2069 6d70 6c69 6564 0a20 2020 2020 or implied. │ │ │ -0008cde0: 7761 7272 616e 7479 2e0a 0a20 2020 2020 warranty... │ │ │ -0008cdf0: 4966 2079 6f75 206d 6f64 6966 7920 7468 If you modify th │ │ │ -0008ce00: 6520 446f 6342 6f6f 6b20 584d 4c20 4454 e DocBook XML DT │ │ │ -0008ce10: 4420 696e 2061 6e79 2077 6179 2c20 6578 D in any way, ex │ │ │ -0008ce20: 6365 7074 2066 6f72 2064 6563 6c61 7269 cept for declari │ │ │ -0008ce30: 6e67 2061 6e64 0a20 2020 2020 7265 6665 ng and. refe │ │ │ -0008ce40: 7265 6e63 696e 6720 6164 6469 7469 6f6e rencing addition │ │ │ -0008ce50: 616c 2073 6574 7320 6f66 2067 656e 6572 al sets of gener │ │ │ -0008ce60: 616c 2065 6e74 6974 6965 7320 616e 6420 al entities and │ │ │ -0008ce70: 6465 636c 6172 696e 670a 2020 2020 2061 declaring. a │ │ │ -0008ce80: 6464 6974 696f 6e61 6c20 6e6f 7461 7469 dditional notati │ │ │ -0008ce90: 6f6e 732c 206c 6162 656c 2079 6f75 7220 ons, label your │ │ │ -0008cea0: 4454 4420 6173 2061 2076 6172 6961 6e74 DTD as a variant │ │ │ -0008ceb0: 206f 6620 446f 6342 6f6f 6b2e 2020 5365 of DocBook. Se │ │ │ -0008cec0: 650a 2020 2020 2074 6865 206d 6169 6e74 e. the maint │ │ │ -0008ced0: 656e 616e 6365 2064 6f63 756d 656e 7461 enance documenta │ │ │ -0008cee0: 7469 6f6e 2066 6f72 206d 6f72 6520 696e tion for more in │ │ │ -0008cef0: 666f 726d 6174 696f 6e2e 0a0a 2020 2020 formation... │ │ │ -0008cf00: 2050 6c65 6173 6520 6469 7265 6374 2061 Please direct a │ │ │ -0008cf10: 6c6c 2071 7565 7374 696f 6e73 2c20 6275 ll questions, bu │ │ │ -0008cf20: 6720 7265 706f 7274 732c 206f 7220 7375 g reports, or su │ │ │ -0008cf30: 6767 6573 7469 6f6e 7320 666f 720a 2020 ggestions for. │ │ │ -0008cf40: 2020 2063 6861 6e67 6573 2074 6f20 7468 changes to th │ │ │ -0008cf50: 6520 646f 6362 6f6f 6b40 6c69 7374 732e e docbook@lists. │ │ │ -0008cf60: 6f61 7369 732d 6f70 656e 2e6f 7267 206d oasis-open.org m │ │ │ -0008cf70: 6169 6c69 6e67 206c 6973 742e 2046 6f72 ailing list. For │ │ │ -0008cf80: 206d 6f72 650a 2020 2020 2069 6e66 6f72 more. infor │ │ │ -0008cf90: 6d61 7469 6f6e 2c20 7365 6520 6874 7470 mation, see http │ │ │ -0008cfa0: 3a2f 2f77 7777 2e6f 6173 6973 2d6f 7065 ://www.oasis-ope │ │ │ -0008cfb0: 6e2e 6f72 672f 646f 6362 6f6f 6b2f 2e0a n.org/docbook/.. │ │ │ -0008cfc0: 2d2d 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e -->...... │ │ │ -0008d3f0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -0008d440: 3c21 2d2d 2045 6e74 6974 6965 7320 666f . │ │ │ -0008d490: 0a3c 2145 4e54 4954 5920 2520 6462 6869 .................< │ │ │ -0008d6c0: 2145 4e54 4954 5920 2520 6368 6170 7465 !ENTITY % chapte │ │ │ -0008d6d0: 722e 636c 6173 7309 2263 6861 7074 6572 r.class."chapter │ │ │ -0008d6e0: 2025 6c6f 6361 6c2e 6368 6170 7465 722e %local.chapter. │ │ │ -0008d6f0: 636c 6173 733b 223e 0a0a 3c21 454e 5449 class;">........... │ │ │ -0008d830: 3c21 2d2d 2052 6564 6563 6c61 7261 7469 . │ │ │ -0008d880: 0a3c 212d 2d20 466f 7220 7265 6465 636c .....%rdbh │ │ │ -0008d9a0: 6965 723b 0a3c 212d 2d65 6e64 206f 6620 ier;.]]>.........< │ │ │ -0008db20: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ -0008db30: 6469 7663 6f6d 706f 6e65 6e74 2e6d 6978 divcomponent.mix │ │ │ -0008db40: 2022 223e 0a3c 2145 4e54 4954 5920 2520 "">.........................< │ │ │ -0008e2c0: 215b 2564 6268 6965 722e 7265 6465 636c ![%dbhier.redecl │ │ │ -0008e2d0: 322e 6d6f 6475 6c65 3b5b 0a3c 212d 2d20 2.module;[..< │ │ │ -0008e320: 2145 4e54 4954 5920 2520 7264 6268 6965 !ENTITY % rdbhie │ │ │ -0008e330: 7232 2022 223e 0a25 7264 6268 6965 7232 r2 "">.%rdbhier2 │ │ │ -0008e340: 3b0a 3c21 2d2d 656e 6420 6f66 2064 6268 ;.]]>................... │ │ │ -0008e690: 3c21 5b25 7365 742e 636f 6e74 656e 742e ......]]>.. │ │ │ -0008e7d0: 3c21 2d2d 2046 5049 3a20 5347 4d4c 2066 .... │ │ │ -0008e820: 3c21 5b25 7365 742e 6174 746c 6973 743b .] │ │ │ -0008e8c0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7365 ]>.]]>.. │ │ │ -0008e8e0: 3c21 454e 5449 5459 2025 2073 6574 696e ....< │ │ │ -0008e970: 2145 4e54 4954 5920 2520 7365 7469 6e66 !ENTITY % setinf │ │ │ -0008e980: 6f2e 656c 656d 656e 7420 2249 4e43 4c55 o.element "INCLU │ │ │ -0008e990: 4445 223e 0a3c 215b 2573 6574 696e 666f DE">..]]>..... │ │ │ -0008ead0: 3c21 454e 5449 5459 2025 2073 6574 696e ..< │ │ │ -0008eb80: 212d 2d65 6e64 206f 6620 7365 7469 6e66 !--end of setinf │ │ │ -0008eb90: 6f2e 6174 746c 6973 742d 2d3e 5d5d 3e0a o.attlist-->]]>. │ │ │ -0008eba0: 3c21 2d2d 656e 6420 6f66 2073 6574 696e ]]>. │ │ │ -0008ebc0: 3c21 2d2d 656e 6420 6f66 2073 6574 2e63 │ │ │ -0008ebe0: 5d5d 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e ]]>...] │ │ │ +00079eb0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 676c ]>.]]>.] │ │ │ +00079f00: 5d3e 0a0a 3c21 2d2d 2049 7465 6d69 7a65 ]>... │ │ │ +00079f30: 0a3c 2145 4e54 4954 5920 2520 6974 656d ......< │ │ │ +0007a000: 215b 2569 7465 6d69 7a65 646c 6973 742e ![%itemizedlist. │ │ │ +0007a010: 656c 656d 656e 743b 5b0a 3c21 454c 454d element;[..< │ │ │ +0007a060: 212d 2d65 6e64 206f 6620 6974 656d 697a !--end of itemiz │ │ │ +0007a070: 6564 6c69 7374 2e65 6c65 6d65 6e74 2d2d edlist.element-- │ │ │ +0007a080: 3e5d 5d3e 0a0a 3c21 2d2d 2053 7061 6369 >]]>...... │ │ │ +0007a150: 3c21 454e 5449 5459 2025 2069 7465 6d69 ..]]>.]]>. │ │ │ +0007a280: 0a3c 2145 4e54 4954 5920 2520 6f72 6465 ..... │ │ │ +0007a320: 3c21 454e 5449 5459 2025 206f 7264 6572 ..]]>....]]>.]]>..< │ │ │ +0007a7b0: 2145 4e54 4954 5920 2520 6c69 7374 6974 !ENTITY % listit │ │ │ +0007a7c0: 656d 2e6d 6f64 756c 6520 2249 4e43 4c55 em.module "INCLU │ │ │ +0007a7d0: 4445 223e 0a3c 215b 256c 6973 7469 7465 DE">.. │ │ │ +0007a810: 3c21 454e 5449 5459 2025 206c 6973 7469 │ │ │ +0007a840: 0a0a 3c21 454e 5449 5459 2025 206c 6973 ....]]>.......]]>. │ │ │ +0007aa50: 3c21 2d2d 656e 6420 6f66 206c 6973 7469 ]]> │ │ │ +0007aa70: 0a0a 3c21 2d2d 2053 6567 6d65 6e74 6564 ... │ │ │ +0007aad0: 0a3c 215b 2573 6567 6d65 6e74 6564 6c69 ..< │ │ │ +0007ab20: 215b 2573 6567 6d65 6e74 6564 6c69 7374 ![%segmentedlist │ │ │ +0007ab30: 2e6d 6f64 756c 653b 5b0a 3c21 454e 5449 .module;[......]]>....] │ │ │ +0007ad70: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7365 ]>.]]>... │ │ │ +0007adc0: 3c21 5b25 7365 6774 6974 6c65 2e6d 6f64 .....]]>. │ │ │ +0007af70: 3c21 2d2d 656e 6420 6f66 2073 6567 7469 ]]> │ │ │ +0007af90: 0a0a 3c21 454e 5449 5459 2025 2073 6567 ..... │ │ │ +0007b030: 0a3c 2145 4e54 4954 5920 2520 7365 676c ...]]>....]]>.]]>..< │ │ │ +0007b1b0: 2145 4e54 4954 5920 2520 7365 672e 6d6f !ENTITY % seg.mo │ │ │ +0007b1c0: 6475 6c65 2022 494e 434c 5544 4522 3e0a dule "INCLUDE">. │ │ │ +0007b1d0: 3c21 5b25 7365 672e 6d6f 6475 6c65 3b5b │ │ │ +0007b200: 0a3c 2145 4e54 4954 5920 2520 7365 672e .... │ │ │ +0007b250: 3c21 5b25 7365 672e 656c 656d 656e 743b .]]> │ │ │ +0007b2a0: 0a0a 3c21 454e 5449 5459 2025 2073 6567 ... │ │ │ +0007b320: 0a3c 212d 2d65 6e64 206f 6620 7365 672e .]]>.]]>.]]>........ │ │ │ +0007b4a0: 0a3c 2145 4e54 4954 5920 2520 7369 6d70 ...]]>... │ │ │ +0007b7a0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2073 ]]>.]]>........]] │ │ │ +0007b8d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6d65 >... │ │ │ +0007b960: 0a3c 212d 2d65 6e64 206f 6620 6d65 6d62 .]]> │ │ │ +0007b980: 0a3c 212d 2d65 6e64 206f 6620 6d65 6d62 .]]>. │ │ │ +0007b9a0: 3c21 2d2d 656e 6420 6f66 2073 696d 706c ]]>......... │ │ │ +0007baf0: 3c21 454e 5449 5459 2025 2076 6172 6961 ..< │ │ │ +0007bb80: 212d 2d65 6e64 206f 6620 7661 7269 6162 !--end of variab │ │ │ +0007bb90: 6c65 6c69 7374 2e65 6c65 6d65 6e74 2d2d lelist.element-- │ │ │ +0007bba0: 3e5d 5d3e 0a0a 3c21 2d2d 2054 6572 6d4c >]]>.....< │ │ │ +0007bc60: 2145 4e54 4954 5920 2520 7661 7269 6162 !ENTITY % variab │ │ │ +0007bc70: 6c65 6c69 7374 2e61 7474 6c69 7374 2022 lelist.attlist " │ │ │ +0007bc80: 494e 434c 5544 4522 3e0a 3c21 5b25 7661 INCLUDE">..]]>.] │ │ │ +0007bd70: 5d3e 0a0a 3c21 454e 5449 5459 2025 2076 ]>... │ │ │ +0007bde0: 0a3c 2145 4e54 4954 5920 2520 7661 726c .....]]>....]]>. │ │ │ +0007bf80: 3c21 2d2d 656e 6420 6f66 2076 6172 6c69 ]]>. │ │ │ +0007c0a0: 0a3c 2145 4e54 4954 5920 2520 7465 726d ...] │ │ │ +0007c140: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7465 ]>.]]>. │ │ │ +0007c160: 0a3c 212d 2d20 4c69 7374 4974 656d 2028 .]]>.. │ │ │ +0007c1b0: 3c21 2d2d 2043 616c 6c6f 7574 4c69 7374 .........]]>....]]>.]]>.. │ │ │ +0007c490: 0a3c 215b 2563 616c 6c6f 7574 2e6d 6f64 .... │ │ │ +0007c520: 0a3c 215b 2563 616c 6c6f 7574 2e65 6c65 ..< │ │ │ +0007c560: 212d 2d65 6e64 206f 6620 6361 6c6c 6f75 !--end of callou │ │ │ +0007c570: 742e 656c 656d 656e 742d 2d3e 5d5d 3e0a t.element-->]]>. │ │ │ +0007c580: 0a3c 212d 2d20 4172 6561 5265 6673 3a20 ......]]>.]]>. │ │ │ +0007c6f0: 5d5d 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e ]]>.....]]>.]]>........]]>.. │ │ │ +0007cb40: 3c21 454e 5449 5459 2025 2069 6e66 6f72 ..]]>..... │ │ │ +0007cd10: 0a3c 2145 4e54 4954 5920 2520 7072 6f67 .. │ │ │ +0007cd40: 3c21 5b25 7072 6f67 7261 6d6c 6973 7469 .]]>..< │ │ │ +0007cdd0: 2145 4e54 4954 5920 2520 7072 6f67 7261 !ENTITY % progra │ │ │ +0007cde0: 6d6c 6973 7469 6e67 636f 2e61 7474 6c69 mlistingco.attli │ │ │ +0007cdf0: 7374 2022 494e 434c 5544 4522 3e0a 3c21 st "INCLUDE">..< │ │ │ +0007ce90: 212d 2d65 6e64 206f 6620 7072 6f67 7261 !--end of progra │ │ │ +0007cea0: 6d6c 6973 7469 6e67 636f 2e61 7474 6c69 mlistingco.attli │ │ │ +0007ceb0: 7374 2d2d 3e5d 5d3e 0a3c 212d 2d20 4361 st-->]]>..]]>..< │ │ │ +0007cf10: 2145 4e54 4954 5920 2520 6172 6561 7370 !ENTITY % areasp │ │ │ +0007cf20: 6563 2e63 6f6e 7465 6e74 2e6d 6f64 756c ec.content.modul │ │ │ +0007cf30: 6520 2249 4e43 4c55 4445 223e 0a3c 215b e "INCLUDE">. │ │ │ +0007cf80: 0a3c 215b 2561 7265 6173 7065 632e 6d6f ...... │ │ │ +0007d070: 5d5d 3e0a 0a3c 212d 2d20 556e 6974 733a ]]>........]]>.]]>... │ │ │ +0007d620: 3c21 5b25 6172 6561 2e6d 6f64 756c 653b .. │ │ │ +0007d680: 0a3c 2145 4e54 4954 5920 2520 6172 6561 ...]]>.........]]>.]]>........< │ │ │ +0007da50: 212d 2d65 6e64 206f 6620 6172 6561 7365 !--end of arease │ │ │ +0007da60: 742e 656c 656d 656e 742d 2d3e 5d5d 3e0a t.element-->]]>. │ │ │ +0007da70: 0a3c 212d 2d20 6275 6720 6e75 6d62 6572 .. │ │ │ +0007db10: 0a0a 0a3c 2145 4e54 4954 5920 2520 6172 ..... │ │ │ +0007dc70: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>. │ │ │ +0007dc90: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.]]>... │ │ │ +0007dd30: 0a3c 2145 4e54 4954 5920 2520 7072 6f67 .....]]>..< │ │ │ +0007de20: 2145 4e54 4954 5920 2520 7072 6f67 7261 !ENTITY % progra │ │ │ +0007de30: 6d6c 6973 7469 6e67 2e61 7474 6c69 7374 mlisting.attlist │ │ │ +0007de40: 2022 494e 434c 5544 4522 3e0a 3c21 5b25 "INCLUDE">..]]>.]]>...... │ │ │ +0007e020: 0a3c 215b 256c 6974 6572 616c 6c61 796f ..< │ │ │ +0007e080: 212d 2d65 6e64 206f 6620 6c69 7465 7261 !--end of litera │ │ │ +0007e090: 6c6c 6179 6f75 742e 656c 656d 656e 742d llayout.element- │ │ │ +0007e0a0: 2d3e 5d5d 3e0a 0a3c 2145 4e54 4954 5920 ->]]>....]]>..]] │ │ │ +0007e230: 3e0a 0a3c 2145 4e54 4954 5920 2520 7363 >........]]>......]]>.]]>.........]]>.. │ │ │ +0007e870: 3c21 454e 5449 5459 2025 2073 6372 6565 ..]]>... │ │ │ +0007e9c0: 0a3c 2145 4e54 4954 5920 2520 7363 7265 ..... │ │ │ +0007ea60: 3c21 2d2d 656e 6420 6f66 2073 6372 6565 │ │ │ +0007ea80: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>.]]>...... │ │ │ +0007ec50: 0a0a 3c21 454e 5449 5459 2025 2066 6967 .........]]>.]]>... │ │ │ +0007ef50: 0a3c 2145 4e54 4954 5920 2520 696e 666f .....]]>.....]]>.< │ │ │ +0007f220: 212d 2d65 6e64 206f 6620 696e 666f 726d !--end of inform │ │ │ +0007f230: 616c 6669 6775 7265 2e6d 6f64 756c 652d alfigure.module- │ │ │ +0007f240: 2d3e 5d5d 3e0a 0a3c 2145 4e54 4954 5920 ->]]>........]]>.. │ │ │ +0007f3a0: 0a3c 215b 2567 7261 7068 6963 636f 2e61 ..]]>..........]]>.... │ │ │ +0007f720: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2067 ]]>. │ │ │ +0007f740: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ +0007f770: 3c21 5b25 696e 6c69 6e65 6772 6170 6869 .....]]>.... │ │ │ +0007f940: 3c21 2d2d 656e 6420 6f66 2069 6e6c 696e ]]>.]]>...< │ │ │ +0007f9c0: 215b 2025 6d65 6469 616f 626a 6563 742e ![ %mediaobject. │ │ │ +0007f9d0: 636f 6e74 656e 742e 6d6f 6475 6c65 3b20 content.module; │ │ │ +0007f9e0: 5b0a 0a3c 2145 4e54 4954 5920 2520 6d65 [....< │ │ │ +0007fa50: 2145 4e54 4954 5920 2520 6d65 6469 616f !ENTITY % mediao │ │ │ +0007fa60: 626a 6563 742e 726f 6c65 2e61 7474 7269 bject.role.attri │ │ │ +0007fa70: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +0007fa80: 223e 0a0a 3c21 454e 5449 5459 2025 206d ">....]]>....]]>.]]>..< │ │ │ +0007fc70: 2145 4e54 4954 5920 2520 696e 6c69 6e65 !ENTITY % inline │ │ │ +0007fc80: 6d65 6469 616f 626a 6563 742e 6d6f 6475 mediaobject.modu │ │ │ +0007fc90: 6c65 2022 494e 434c 5544 4522 3e0a 3c21 le "INCLUDE">......]]>.]] │ │ │ +0007ff40: 3e0a 0a3c 2145 4e54 4954 5920 2520 7669 >....< │ │ │ +0007ffb0: 2145 4e54 4954 5920 2520 7669 6465 6f6f !ENTITY % videoo │ │ │ +0007ffc0: 626a 6563 742e 726f 6c65 2e61 7474 7269 bject.role.attri │ │ │ +0007ffd0: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +0007ffe0: 223e 0a0a 3c21 454e 5449 5459 2025 2076 ">....]]>.. │ │ │ +00080080: 3c21 454e 5449 5459 2025 2076 6964 656f ..]]>.]] │ │ │ +00080170: 3e0a 0a3c 2145 4e54 4954 5920 2520 6175 >....< │ │ │ +000801e0: 2145 4e54 4954 5920 2520 6175 6469 6f6f !ENTITY % audioo │ │ │ +000801f0: 626a 6563 742e 726f 6c65 2e61 7474 7269 bject.role.attri │ │ │ +00080200: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +00080210: 223e 0a0a 3c21 454e 5449 5459 2025 2061 ">....]]>.. │ │ │ +000802b0: 3c21 454e 5449 5459 2025 2061 7564 696f ..]]>.]] │ │ │ +000803a0: 3e0a 0a3c 2145 4e54 4954 5920 2520 696d >....< │ │ │ +00080410: 2145 4e54 4954 5920 2520 696d 6167 656f !ENTITY % imageo │ │ │ +00080420: 626a 6563 742e 726f 6c65 2e61 7474 7269 bject.role.attri │ │ │ +00080430: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +00080440: 223e 0a0a 3c21 454e 5449 5459 2025 2069 ">....]]>.. │ │ │ +000804e0: 3c21 454e 5449 5459 2025 2069 6d61 6765 ..]]>.]] │ │ │ +000805d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7465 >...... │ │ │ +00080670: 3c21 454e 5449 5459 2025 2074 6578 746f ..]]>....< │ │ │ +000807c0: 212d 2d65 6e64 206f 6620 7465 7874 6f62 !--end of textob │ │ │ +000807d0: 6a65 6374 2e61 7474 6c69 7374 2d2d 3e5d ject.attlist-->] │ │ │ +000807e0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7465 ]>.]]>.]]> │ │ │ +00080a80: 0a0a 3c21 2d2d 456e 7469 7479 5265 663a ..... │ │ │ +00080b90: 3c21 2d2d 5372 6343 7265 6469 743a 2049 .............< │ │ │ +00080ed0: 212d 2d53 6361 6c65 3a20 436f 6e66 6c61 !--Scale: Confla │ │ │ +00080ee0: 7469 6f6e 206f 6620 4341 4c53 2068 7363 tion of CALS hsc │ │ │ +00080ef0: 616c 6520 616e 6420 7673 6361 6c65 2d2d ale and vscale-- │ │ │ +00080f00: 3e0a 3c21 2d2d 5363 616c 6566 6974 3a20 >...]]>.< │ │ │ +00081060: 212d 2d65 6e64 206f 6620 7669 6465 6f64 !--end of videod │ │ │ +00081070: 6174 612e 6d6f 6475 6c65 2d2d 3e5d 5d3e ata.module-->]]> │ │ │ +00081080: 0a0a 3c21 454e 5449 5459 2025 2061 7564 ........]]>... │ │ │ +00081250: 0a3c 212d 2d65 6e64 206f 6620 6175 6469 . │ │ │ +00081270: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.]]>. │ │ │ +000813b0: 0a3c 2145 4e54 4954 5920 2520 696d 6167 ......]]>.]]>.. │ │ │ +00081690: 0a3c 215b 2025 6361 7074 696f 6e2e 6d6f ......] │ │ │ +00081780: 5d3e 0a0a 3c21 454e 5449 5459 2025 2063 ]>....]]>.]]>....... │ │ │ +00081930: 3c21 5b20 256d 6564 6961 6f62 6a65 6374 .]]>..< │ │ │ +000819d0: 2145 4e54 4954 5920 2520 6d65 6469 616f !ENTITY % mediao │ │ │ +000819e0: 626a 6563 7463 6f2e 6174 746c 6973 7420 bjectco.attlist │ │ │ +000819f0: 2249 4e43 4c55 4445 223e 0a3c 215b 2025 "INCLUDE">..]]>.]]>.. │ │ │ +00081ad0: 3c21 454e 5449 5459 2025 2069 6d61 6765 ......]]>.... │ │ │ +00081d00: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2069 ]]>.]]>...........< │ │ │ +00081f50: 215b 2565 7175 6174 696f 6e2e 656c 656d ![%equation.elem │ │ │ +00081f60: 656e 743b 5b0a 3c21 454c 454d 454e 5420 ent;[..]]>.. │ │ │ +00082010: 0a3c 215b 2565 7175 6174 696f 6e2e 6174 ..]]>... │ │ │ +00082150: 0a3c 2145 4e54 4954 5920 2520 696e 666f .....]]>. │ │ │ +00082320: 3c21 2d2d 656e 6420 6f66 2069 6e66 6f72 ]]>........]]>....]]>.]] │ │ │ +000825a0: 3e0a 0a3c 2145 4e54 4954 5920 2520 616c >.... │ │ │ +00082620: 0a0a 3c21 454e 5449 5459 2025 2061 6c74 ....< │ │ │ +00082670: 212d 2d65 6e64 206f 6620 616c 742e 656c !--end of alt.el │ │ │ +00082680: 656d 656e 742d 2d3e 5d5d 3e0a 0a3c 2145 ement-->]]>...< │ │ │ +000826b0: 215b 2561 6c74 2e61 7474 6c69 7374 3b5b ![%alt.attlist;[ │ │ │ +000826c0: 0a3c 2141 5454 4c49 5354 2061 6c74 200a ..]]>. │ │ │ +000827f0: 0a3c 212d 2d20 6973 206e 6f77 2074 6865 .... │ │ │ +00082860: 3c21 5b25 6361 6c73 2e74 6162 6c65 2e6d .]]>......... │ │ │ +00082a40: 0a0a 3c21 454e 5449 5459 2025 2063 6f6d ........ │ │ │ +00082ba0: 0a0a 3c21 2d2d 2052 6566 6572 656e 6365 ....]] │ │ │ +00082c40: 3e0a 0a3c 215b 2565 7863 6861 6e67 652e >........ │ │ │ +00082db0: 0a0a 3c21 454e 5449 5459 2025 2074 626c ...... │ │ │ +00082eb0: 0a3c 2145 4e54 4954 5920 2520 7462 6c2e .... │ │ │ +00082f80: 0a0a 3c21 2d2d 2041 6c6c 6f77 2065 6974 ......]]>..%tablemo │ │ │ +00083090: 6465 6c3b 0a0a 3c21 2d2d 656e 6420 6f66 del;.. │ │ │ +000830b0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ +000830e0: 3c21 5b25 696e 666f 726d 616c 7461 626c ..... │ │ │ +000831c0: 3c21 5b25 696e 666f 726d 616c 7461 626c .]]>....< │ │ │ +000832f0: 212d 2d20 696e 636c 7564 6573 204c 6162 !-- includes Lab │ │ │ +00083300: 656c 202d 2d3e 0a3c 212d 2d20 696e 636c el -->......]]>.]]>. │ │ │ +000834c0: 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +00083510: 0a3c 212d 2d20 5379 6e6f 7073 6573 202e . │ │ │ +00083560: 0a0a 3c21 2d2d 2053 796e 6f70 7369 7320 ....< │ │ │ +00083590: 2145 4e54 4954 5920 2520 7379 6e6f 7073 !ENTITY % synops │ │ │ +000835a0: 6973 2e6d 6f64 756c 6520 2249 4e43 4c55 is.module "INCLU │ │ │ +000835b0: 4445 223e 0a3c 215b 2573 796e 6f70 7369 DE">.. │ │ │ +000835f0: 3c21 454e 5449 5459 2025 2073 796e 6f70 │ │ │ +00083620: 0a0a 3c21 454e 5449 5459 2025 2073 796e ....]]>...< │ │ │ +00083700: 215b 2573 796e 6f70 7369 732e 6174 746c ![%synopsis.attl │ │ │ +00083710: 6973 743b 5b0a 3c21 4154 544c 4953 5420 ist;[..]]>...]]>...........]]>.....< │ │ │ +00083a70: 2145 4e54 4954 5920 2520 636d 6473 796e !ENTITY % cmdsyn │ │ │ +00083a80: 6f70 7369 732e 6174 746c 6973 7420 2249 opsis.attlist "I │ │ │ +00083a90: 4e43 4c55 4445 223e 0a3c 215b 2563 6d64 NCLUDE">..]]>.]] │ │ │ +00083ba0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6172 >.... │ │ │ +00083c20: 0a0a 3c21 454e 5449 5459 2025 2061 7267 ....< │ │ │ +00083cc0: 212d 2d65 6e64 206f 6620 6172 672e 656c !--end of arg.el │ │ │ +00083cd0: 656d 656e 742d 2d3e 5d5d 3e0a 0a3c 212d ement-->]]>........< │ │ │ +00083ee0: 212d 2d65 6e64 206f 6620 6172 672e 6174 !--end of arg.at │ │ │ +00083ef0: 746c 6973 742d 2d3e 5d5d 3e0a 3c21 2d2d tlist-->]]>.]]>..... │ │ │ +00083fa0: 0a3c 2145 4e54 4954 5920 2520 6772 6f75 ...]]>........]]>.]]>....] │ │ │ +000844c0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7362 ]>.]]>.. │ │ │ +000844e0: 3c21 454e 5449 5459 2025 2073 796e 6f70 ......]]> │ │ │ +00084630: 0a0a 3c21 2d2d 2074 6f20 5379 6e6f 7046 .......]]>.. │ │ │ +000847b0: 3c21 454e 5449 5459 2025 2073 796e 6f70 .. │ │ │ +00084820: 3c21 454e 5449 5459 2025 2073 796e 6f70 ....]]>. │ │ │ +000848f0: 0a3c 2145 4e54 4954 5920 2520 7379 6e6f ...]]>.< │ │ │ +000849d0: 212d 2d65 6e64 206f 6620 7379 6e6f 7066 !--end of synopf │ │ │ +000849e0: 7261 676d 656e 742e 6d6f 6475 6c65 2d2d ragment.module-- │ │ │ +000849f0: 3e5d 5d3e 0a0a 3c21 2d2d 2043 6f6d 6d61 >]]>.... │ │ │ +00084aa0: 0a3c 212d 2d65 6e64 206f 6620 636d 6473 .]]>...........]]>....]]> │ │ │ +00084d80: 0a3c 212d 2d65 6e64 206f 6620 6675 6e63 .]] │ │ │ +00084f10: 3e0a 0a3c 2145 4e54 4954 5920 2520 6675 >....]]>..< │ │ │ +00085040: 2145 4e54 4954 5920 2520 6675 6e63 7072 !ENTITY % funcpr │ │ │ +00085050: 6f74 6f74 7970 652e 6d6f 6475 6c65 2022 ototype.module " │ │ │ +00085060: 494e 434c 5544 4522 3e0a 3c21 5b25 6675 INCLUDE">..< │ │ │ +000850b0: 2145 4e54 4954 5920 2520 6675 6e63 7072 !ENTITY % funcpr │ │ │ +000850c0: 6f74 6f74 7970 652e 726f 6c65 2e61 7474 ototype.role.att │ │ │ +000850d0: 7269 6220 2225 726f 6c65 2e61 7474 7269 rib "%role.attri │ │ │ +000850e0: 623b 223e 0a0a 3c21 454e 5449 5459 2025 b;">....< │ │ │ +00085170: 212d 2d65 6e64 206f 6620 6675 6e63 7072 !--end of funcpr │ │ │ +00085180: 6f74 6f74 7970 652e 656c 656d 656e 742d ototype.element- │ │ │ +00085190: 2d3e 5d5d 3e0a 0a3c 2145 4e54 4954 5920 ->]]>....]]>.< │ │ │ +00085270: 212d 2d65 6e64 206f 6620 6675 6e63 7072 !--end of funcpr │ │ │ +00085280: 6f74 6f74 7970 652e 6d6f 6475 6c65 2d2d ototype.module-- │ │ │ +00085290: 3e5d 5d3e 0a0a 3c21 454e 5449 5459 2025 >]]>........]]>.. │ │ │ +000853c0: 3c21 454e 5449 5459 2025 2066 756e 6364 .. │ │ │ +00085470: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2066 ]]>. │ │ │ +00085490: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]] │ │ │ +00085580: 3e0a 0a3c 2145 4e54 4954 5920 2520 766f >....]] │ │ │ +00085640: 3e0a 0a3c 2145 4e54 4954 5920 2520 7661 >... │ │ │ +000856a0: 0a3c 2145 4e54 4954 5920 2520 7661 7261 . │ │ │ +000856d0: 0a0a 3c21 454e 5449 5459 2025 2076 6172 ....]]>...< │ │ │ +00085770: 215b 2576 6172 6172 6773 2e61 7474 6c69 ![%varargs.attli │ │ │ +00085780: 7374 3b5b 0a3c 2141 5454 4c49 5354 2076 st;[..]]>.]]>....< │ │ │ +00085910: 2145 4e54 4954 5920 2520 7061 7261 6d64 !ENTITY % paramd │ │ │ +00085920: 6566 2e6d 6f64 756c 6520 2249 4e43 4c55 ef.module "INCLU │ │ │ +00085930: 4445 223e 0a3c 215b 2570 6172 616d 6465 DE">.. │ │ │ +00085970: 3c21 454e 5449 5459 2025 2070 6172 616d │ │ │ +000859a0: 0a0a 3c21 454e 5449 5459 2025 2070 6172 ....< │ │ │ +00085a30: 212d 2d65 6e64 206f 6620 7061 7261 6d64 !--end of paramd │ │ │ +00085a40: 6566 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e ef.element-->]]> │ │ │ +00085a50: 0a0a 3c21 454e 5449 5459 2025 2070 6172 ....]]>.]]>........]]>....]]>.< │ │ │ +00085d20: 212d 2d65 6e64 206f 6620 6675 6e63 7061 !--end of funcpa │ │ │ +00085d30: 7261 6d73 2e6d 6f64 756c 652d 2d3e 5d5d rams.module-->]] │ │ │ +00085d40: 3e0a 0a3c 212d 2d20 4c69 6e65 416e 6e6f >.... │ │ │ +00085e30: 0a3c 212d 2d65 6e64 206f 6620 6675 6e63 .]]>..< │ │ │ +00085e60: 212d 2d20 436c 6173 7353 796e 6f70 7369 !-- ClassSynopsi │ │ │ +00085e70: 7320 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e s .............. │ │ │ +00085e80: 2e2e 2e2e 2e2e 2e20 2d2d 3e0a 0a3c 2145 ....... -->... │ │ │ +00085ec0: 3c21 5b25 636c 6173 7373 796e 6f70 7369 .< │ │ │ +00085f10: 215b 2563 6c61 7373 7379 6e6f 7073 6973 ![%classsynopsis │ │ │ +00085f20: 2e6d 6f64 756c 653b 5b0a 3c21 454e 5449 .module;[......]]>....]]>.]]>........] │ │ │ +00086350: 5d3e 0a0a 3c21 454e 5449 5459 2025 2063 ]>....]]>.]]>........]]>.. │ │ │ +000865a0: 3c21 454e 5449 5459 2025 206f 6f63 6c61 .. │ │ │ +00086630: 3c21 2d2d 656e 6420 6f66 206f 6f63 6c61 ]]> │ │ │ +00086650: 0a3c 212d 2d65 6e64 206f 6620 6f6f 636c .]]> │ │ │ +00086670: 0a0a 3c21 454e 5449 5459 2025 206f 6f69 ..... │ │ │ +00086710: 0a3c 2145 4e54 4954 5920 2520 6f6f 696e ...]]>... │ │ │ +00086850: 0a3c 212d 2d65 6e64 206f 6620 6f6f 696e .]]>........ │ │ │ +000869b0: 3c21 2d2d 656e 6420 6f66 206f 6f65 7863 ]]>.< │ │ │ +00086aa0: 212d 2d65 6e64 206f 6620 6f6f 6578 6365 !--end of ooexce │ │ │ +00086ab0: 7074 696f 6e2e 6d6f 6475 6c65 2d2d 3e5d ption.module-->] │ │ │ +00086ac0: 5d3e 0a0a 3c21 454e 5449 5459 2025 206d ]>....... │ │ │ +00086bc0: 0a3c 212d 2d65 6e64 206f 6620 6d6f 6469 .] │ │ │ +00086be0: 5d3e 0a0a 3c21 454e 5449 5459 2025 206d ]>....]]>.]]>....... │ │ │ +00086d90: 3c21 5b25 696e 7465 7266 6163 656e 616d . │ │ │ +00086e00: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.. │ │ │ +00086e30: 0a3c 215b 2569 6e74 6572 6661 6365 6e61 ..]]>.]]>. │ │ │ +00086f00: 0a3c 2145 4e54 4954 5920 2520 6578 6365 .. │ │ │ +00086f70: 0a3c 2145 4e54 4954 5920 2520 6578 6365 .... │ │ │ +00087020: 0a3c 212d 2d65 6e64 206f 6620 6578 6365 .]]>....]]>. │ │ │ +00087140: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ +00087170: 3c21 5b25 6669 656c 6473 796e 6f70 7369 .....]]>..< │ │ │ +000872a0: 2145 4e54 4954 5920 2520 6669 656c 6473 !ENTITY % fields │ │ │ +000872b0: 796e 6f70 7369 732e 6174 746c 6973 7420 ynopsis.attlist │ │ │ +000872c0: 2249 4e43 4c55 4445 223e 0a3c 215b 2566 "INCLUDE">.. │ │ │ +00087370: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2066 ]]>.]]>........]] │ │ │ +000874d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 696e >....]]>.]]>. │ │ │ +000875c0: 0a3c 2145 4e54 4954 5920 2520 636f 6e73 ..... │ │ │ +00087680: 3c21 454e 5449 5459 2025 2063 6f6e 7374 ..]]>....]]> │ │ │ +000878e0: 0a0a 3c21 454e 5449 5459 2025 2064 6573 ... │ │ │ +00087960: 0a3c 2145 4e54 4954 5920 2520 6465 7374 .....]]> │ │ │ +00087ad0: 0a0a 3c21 454e 5449 5459 2025 2064 6573 ....]]>. │ │ │ +00087bf0: 0a3c 2145 4e54 4954 5920 2520 6d65 7468 .......]]>. │ │ │ +00087e00: 0a3c 2145 4e54 4954 5920 2520 6d65 7468 ...]]>.] │ │ │ +00087f00: 5d3e 0a0a 3c21 454e 5449 5459 2025 206d ]>......< │ │ │ +00087fa0: 2145 4e54 4954 5920 2520 6d65 7468 6f64 !ENTITY % method │ │ │ +00087fb0: 6e61 6d65 2e65 6c65 6d65 6e74 2022 494e name.element "IN │ │ │ +00087fc0: 434c 5544 4522 3e0a 3c21 5b25 6d65 7468 CLUDE">..< │ │ │ +00088010: 212d 2d65 6e64 206f 6620 6d65 7468 6f64 !--end of method │ │ │ +00088020: 6e61 6d65 2e65 6c65 6d65 6e74 2d2d 3e5d name.element-->] │ │ │ +00088030: 5d3e 0a0a 3c21 454e 5449 5459 2025 206d ]>....]]>.]]>........< │ │ │ +000882a0: 212d 2d65 6e64 206f 6620 6d65 7468 6f64 !--end of method │ │ │ +000882b0: 7061 7261 6d2e 656c 656d 656e 742d 2d3e param.element--> │ │ │ +000882c0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...< │ │ │ +000882f0: 215b 256d 6574 686f 6470 6172 616d 2e61 ![%methodparam.a │ │ │ +00088300: 7474 6c69 7374 3b5b 0a3c 2141 5454 4c49 ttlist;[..]]>.]]> │ │ │ +00088400: 0a3c 212d 2d65 6e64 206f 6620 636c 6173 .]]>.. │ │ │ +00088430: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +00088480: 3c21 2d2d 2044 6f63 756d 656e 7420 696e . │ │ │ +000884d0: 0a3c 212d 2d20 5468 6520 646f 6375 6d65 . │ │ │ +000885c0: 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e ....< │ │ │ +000885f0: 2145 4e54 4954 5920 2520 646f 6369 6e66 !ENTITY % docinf │ │ │ +00088600: 6f2e 636f 6e74 656e 742e 6d6f 6475 6c65 o.content.module │ │ │ +00088610: 2022 494e 434c 5544 4522 3e0a 3c21 5b25 "INCLUDE">.....< │ │ │ +000886c0: 2145 4e54 4954 5920 2520 6163 6b6e 6f2e !ENTITY % ackno. │ │ │ +000886d0: 726f 6c65 2e61 7474 7269 6220 2225 726f role.attrib "%ro │ │ │ +000886e0: 6c65 2e61 7474 7269 623b 223e 0a0a 3c21 le.attrib;">....]]>.. │ │ │ +00088790: 0a3c 215b 2561 636b 6e6f 2e61 7474 6c69 ..] │ │ │ +00088830: 5d3e 0a0a 3c21 2d2d 2041 6464 7265 7373 ]>... │ │ │ +00088860: 0a3c 2145 4e54 4954 5920 2520 6164 6472 ... │ │ │ +000888d0: 3c21 5b25 6164 6472 6573 732e 6d6f 6475 .... │ │ │ +00088960: 3c21 5b25 6164 6472 6573 732e 656c 656d .]]>.. │ │ │ +00088a10: 3c21 454e 5449 5459 2025 2061 6464 7265 ..]]>.]]>.. < │ │ │ +00088b00: 2145 4e54 4954 5920 2520 7374 7265 6574 !ENTITY % street │ │ │ +00088b10: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ +00088b20: 223e 0a20 203c 215b 2573 7472 6565 742e ">. . < │ │ │ +00088b60: 2145 4e54 4954 5920 2520 7374 7265 6574 !ENTITY % street │ │ │ +00088b70: 2e72 6f6c 652e 6174 7472 6962 2022 2572 .role.attrib "%r │ │ │ +00088b80: 6f6c 652e 6174 7472 6962 3b22 3e0a 2020 ole.attrib;">. │ │ │ +00088b90: 0a3c 2145 4e54 4954 5920 2520 7374 7265 ...] │ │ │ +00088c10: 5d3e 0a20 200a 3c21 454e 5449 5459 2025 ]>. ... │ │ │ +00088cc0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. │ │ │ +00088e80: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]] │ │ │ +00088ea0: 3e0a 0a20 203c 2145 4e54 4954 5920 2520 >.. . . . . │ │ │ +00088f40: 3c21 454e 5449 5459 2025 2070 6f73 7463 ..]]>. ...]]>. ]]>.. . │ │ │ +000890d0: 203c 215b 2563 6974 792e 6d6f 6475 6c65 . . ...]] │ │ │ +000891b0: 3e0a 2020 0a3c 2145 4e54 4954 5920 2520 >. ...]]>. ]]> │ │ │ +00089430: 0a20 203c 212d 2d65 6e64 206f 6620 7374 . ]]> │ │ │ +00089450: 0a0a 2020 3c21 454e 5449 5459 2025 2063 .. . . . . │ │ │ +00089510: 0a3c 215b 2563 6f75 6e74 7279 2e65 6c65 .. │ │ │ +00089550: 3c21 2d2d 656e 6420 6f66 2063 6f75 6e74 ]]> │ │ │ +00089570: 0a20 200a 3c21 454e 5449 5459 2025 2063 . ...]]>. ]]>.. . │ │ │ +00089670: 2020 3c21 5b25 7068 6f6e 652e 6d6f 6475 . . .. │ │ │ +00089700: 3c21 5b25 7068 6f6e 652e 656c 656d 656e .]]>. . │ │ │ +00089780: 0a3c 215b 2570 686f 6e65 2e61 7474 6c69 .. │ │ │ +000899c0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]] │ │ │ +000899e0: 3e0a 0a20 203c 212d 2d20 456d 6169 6c20 >.. .. . . . ...]]>. ...]]>. │ │ │ +00089c10: 3c21 2d2d 656e 6420 6f66 206f 7468 6572 ]] │ │ │ +00089c30: 3e0a 3c21 2d2d 656e 6420 6f66 2061 6464 >.]]>...........]]> │ │ │ +00089e30: 0a0a 3c21 454e 5449 5459 2025 2061 6666 ....]]>.]] │ │ │ +00089f20: 3e0a 0a20 203c 2145 4e54 4954 5920 2520 >.. . < │ │ │ +00089f50: 215b 2573 686f 7274 6166 6669 6c2e 6d6f ![%shortaffil.mo │ │ │ +00089f60: 6475 6c65 3b5b 0a20 203c 2145 4e54 4954 dule;[. . │ │ │ +00089f90: 2020 3c21 454e 5449 5459 2025 2073 686f . . │ │ │ +00089ff0: 0a3c 215b 2573 686f 7274 6166 6669 6c2e ..]]>. ...< │ │ │ +0008a100: 212d 2d65 6e64 206f 6620 7368 6f72 7461 !--end of shorta │ │ │ +0008a110: 6666 696c 2e61 7474 6c69 7374 2d2d 3e5d ffil.attlist-->] │ │ │ +0008a120: 5d3e 0a20 203c 212d 2d65 6e64 206f 6620 ]>. ]]>.. │ │ │ +0008a170: 0a20 203c 215b 256a 6f62 7469 746c 652e . . │ │ │ +0008a1b0: 2020 3c21 454e 5449 5459 2025 206a 6f62 . ...]]>. │ │ │ +0008a270: 2020 0a3c 2145 4e54 4954 5920 2520 6a6f ...]]>. < │ │ │ +0008a330: 212d 2d65 6e64 206f 6620 6a6f 6274 6974 !--end of jobtit │ │ │ +0008a340: 6c65 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a le.module-->]]>. │ │ │ +0008a350: 0a20 203c 212d 2d20 4f72 674e 616d 6520 . .. . │ │ │ +0008a3b0: 3c21 5b25 6f72 6764 6976 2e6d 6f64 756c . . ...< │ │ │ +0008a480: 212d 2d65 6e64 206f 6620 6f72 6764 6976 !--end of orgdiv │ │ │ +0008a490: 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e 0a20 .element-->]]>. │ │ │ +0008a4a0: 200a 3c21 454e 5449 5459 2025 206f 7267 ... │ │ │ +0008a530: 3c21 2d2d 656e 6420 6f66 206f 7267 6469 ]]>. │ │ │ +0008a550: 2020 3c21 2d2d 656e 6420 6f66 206f 7267 ]]> │ │ │ +0008a570: 0a0a 2020 3c21 2d2d 2041 6464 7265 7373 .. . │ │ │ +0008a5d0: 5d5d 3e0a 0a3c 212d 2d20 4172 7450 6167 ]]>.. │ │ │ +0008a600: 0a0a 3c21 454e 5449 5459 2025 2061 7274 ..... │ │ │ +0008a6a0: 0a3c 2145 4e54 4954 5920 2520 6172 7470 ...]]>....< │ │ │ +0008a7e0: 212d 2d65 6e64 206f 6620 6172 7470 6167 !--end of artpag │ │ │ +0008a7f0: 656e 756d 732e 6174 746c 6973 742d 2d3e enums.attlist--> │ │ │ +0008a800: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.]]>.......... │ │ │ +0008aa00: 3c21 5b25 6175 7468 6f72 2e65 6c65 6d65 .< │ │ │ +0008aa40: 212d 2d65 6e64 206f 6620 6175 7468 6f72 !--end of author │ │ │ +0008aa50: 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e 0a0a .element-->]]>.. │ │ │ +0008aa60: 3c21 454e 5449 5459 2025 2061 7574 686f ..]]>..< │ │ │ +0008ab50: 212d 2d65 6e64 206f 6620 6175 7468 6f72 !--end of author │ │ │ +0008ab60: 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c .module-->]]>..< │ │ │ +0008ab70: 212d 2d20 4175 7468 6f72 4772 6f75 7020 !-- AuthorGroup │ │ │ +0008ab80: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0008ab90: 2e2e 2e2e 2e2e 202d 2d3e 0a0a 3c21 454e ...... -->.........]]>..< │ │ │ +0008ad40: 2145 4e54 4954 5920 2520 6175 7468 6f72 !ENTITY % author │ │ │ +0008ad50: 6772 6f75 702e 6174 746c 6973 7420 2249 group.attlist "I │ │ │ +0008ad60: 4e43 4c55 4445 223e 0a3c 215b 2561 7574 NCLUDE">..]]>.]]>.. │ │ │ +0008ae30: 2020 3c21 2d2d 2041 7574 686f 7220 2864 . .. . . < │ │ │ +0008af10: 215b 2563 6f6c 6c61 622e 6d6f 6475 6c65 ![%collab.module │ │ │ +0008af20: 3b5b 0a20 203c 2145 4e54 4954 5920 2520 ;[. . . . │ │ │ +0008afa0: 0a3c 215b 2563 6f6c 6c61 622e 656c 656d ..] │ │ │ +0008b000: 5d3e 0a20 200a 3c21 454e 5449 5459 2025 ]>. ... │ │ │ +0008b0b0: 5d5d 3e0a 2020 3c21 2d2d 656e 6420 6f66 ]]>. ]]> │ │ │ +0008b210: 0a20 2020 200a 3c21 454e 5449 5459 2025 . ..< │ │ │ +0008b240: 215b 2563 6f6c 6c61 626e 616d 652e 6174 ![%collabname.at │ │ │ +0008b250: 746c 6973 743b 5b0a 3c21 4154 544c 4953 tlist;[..]]>. │ │ │ +0008b2e0: 3c21 2d2d 656e 6420 6f66 2063 6f6c 6c61 ] │ │ │ +0008b300: 5d3e 0a0a 2020 2020 3c21 2d2d 2041 6666 ]>.. . │ │ │ +0008b340: 2020 3c21 2d2d 656e 6420 6f66 2063 6f6c ]]>.. ..]]>......... │ │ │ +0008b510: 3c21 5b25 6175 7468 6f72 696e 6974 6961 .]]>.... │ │ │ +0008b660: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.]]>...........]]>....]]>.]]>.. │ │ │ +0008b930: 203c 2145 4e54 4954 5920 2520 636f 6e66 . . . . │ │ │ +0008b9d0: 3c21 454e 5449 5459 2025 2063 6f6e 6664 ..]]>. │ │ │ +0008ba60: 0a3c 2145 4e54 4954 5920 2520 636f 6e66 ...]]> │ │ │ +0008bb20: 0a20 203c 212d 2d65 6e64 206f 6620 636f . ]]>. ]]>.. < │ │ │ +0008bd60: 2145 4e54 4954 5920 2520 636f 6e66 6e75 !ENTITY % confnu │ │ │ +0008bd70: 6d2e 6d6f 6475 6c65 2022 494e 434c 5544 m.module "INCLUD │ │ │ +0008bd80: 4522 3e0a 2020 3c21 5b25 636f 6e66 6e75 E">. │ │ │ +0008bdc0: 0a20 203c 2145 4e54 4954 5920 2520 636f . . ...]]>. .< │ │ │ +0008be80: 2145 4e54 4954 5920 2520 636f 6e66 6e75 !ENTITY % confnu │ │ │ +0008be90: 6d2e 6174 746c 6973 7420 2249 4e43 4c55 m.attlist "INCLU │ │ │ +0008bea0: 4445 223e 0a3c 215b 2563 6f6e 666e 756d DE">..] │ │ │ +0008bf30: 5d3e 0a20 203c 212d 2d65 6e64 206f 6620 ]>. .. < │ │ │ +0008bf90: 2145 4e54 4954 5920 2520 636f 6e66 7370 !ENTITY % confsp │ │ │ +0008bfa0: 6f6e 736f 722e 6d6f 6475 6c65 2022 494e onsor.module "IN │ │ │ +0008bfb0: 434c 5544 4522 3e0a 2020 3c21 5b25 636f CLUDE">. . < │ │ │ +0008c000: 2145 4e54 4954 5920 2520 636f 6e66 7370 !ENTITY % confsp │ │ │ +0008c010: 6f6e 736f 722e 726f 6c65 2e61 7474 7269 onsor.role.attri │ │ │ +0008c020: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +0008c030: 223e 0a20 200a 3c21 454e 5449 5459 2025 ">. .. │ │ │ +0008c060: 3c21 5b25 636f 6e66 7370 6f6e 736f 722e .]]>. .< │ │ │ +0008c0d0: 2145 4e54 4954 5920 2520 636f 6e66 7370 !ENTITY % confsp │ │ │ +0008c0e0: 6f6e 736f 722e 6174 746c 6973 7420 2249 onsor.attlist "I │ │ │ +0008c0f0: 4e43 4c55 4445 223e 0a3c 215b 2563 6f6e NCLUDE">..]]>. ]]> │ │ │ +0008c1c0: 0a3c 212d 2d65 6e64 206f 6620 636f 6e66 .]]>..........]]>..< │ │ │ +0008c350: 2145 4e54 4954 5920 2520 636f 6e74 7261 !ENTITY % contra │ │ │ +0008c360: 6374 6e75 6d2e 6174 746c 6973 7420 2249 ctnum.attlist "I │ │ │ +0008c370: 4e43 4c55 4445 223e 0a3c 215b 2563 6f6e NCLUDE">..]]>.]]>.. │ │ │ +0008c440: 3c21 2d2d 2043 6f6e 7472 6163 7453 706f ........]] │ │ │ +0008c5c0: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >.. │ │ │ +0008c5f0: 0a3c 215b 2563 6f6e 7472 6163 7473 706f ..]]>.]]>.. │ │ │ +0008c6d0: 3c21 2d2d 2043 6f70 7972 6967 6874 202e .....< │ │ │ +0008c7b0: 2145 4e54 4954 5920 2520 636f 7079 7269 !ENTITY % copyri │ │ │ +0008c7c0: 6768 742e 726f 6c65 2e61 7474 7269 6220 ght.role.attrib │ │ │ +0008c7d0: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ +0008c7e0: 0a0a 3c21 454e 5449 5459 2025 2063 6f70 ....]]>....]]>.]]>.. │ │ │ +0008c950: 203c 2145 4e54 4954 5920 2520 7965 6172 . . . ..< │ │ │ +0008ca00: 215b 2579 6561 722e 656c 656d 656e 743b ![%year.element; │ │ │ +0008ca10: 5b0a 3c21 454c 454d 454e 5420 7965 6172 [..]]>. ]]>.. │ │ │ +0008cb40: 0a20 203c 215b 2568 6f6c 6465 722e 6d6f . . . . │ │ │ +0008cbb0: 3c21 454e 5449 5459 2025 2068 6f6c 6465 ..]] │ │ │ +0008cc30: 3e0a 2020 0a3c 2145 4e54 4954 5920 2520 >. ...] │ │ │ +0008cce0: 5d3e 0a20 203c 212d 2d65 6e64 206f 6620 ]>. │ │ │ +0008cd00: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2063 ]]>.]]>..< │ │ │ +0008cd30: 212d 2d20 436f 7270 4175 7468 6f72 202e !-- CorpAuthor . │ │ │ +0008cd40: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0008cd50: 2e2e 2e2e 2e2e 202d 2d3e 0a0a 3c21 454e ...... -->....... │ │ │ +0008ce20: 3c21 5b25 636f 7270 6175 7468 6f72 2e65 .]]>....]]>. │ │ │ +0008cf50: 3c21 2d2d 656e 6420 6f66 2063 6f72 7061 ] │ │ │ +0008cf70: 5d3e 0a0a 3c21 2d2d 2043 6f72 704e 616d ]>... │ │ │ +0008cfa0: 0a3c 2145 4e54 4954 5920 2520 636f 7270 ......]]>...< │ │ │ +0008d0c0: 2145 4e54 4954 5920 2520 636f 7270 6e61 !ENTITY % corpna │ │ │ +0008d0d0: 6d65 2e61 7474 6c69 7374 2022 494e 434c me.attlist "INCL │ │ │ +0008d0e0: 5544 4522 3e0a 3c21 5b25 636f 7270 6e61 UDE">..]]>.]]>..........]]>.]]>...< │ │ │ +0008d4f0: 215b 2565 6469 7469 6f6e 2e61 7474 6c69 ![%edition.attli │ │ │ +0008d500: 7374 3b5b 0a3c 2141 5454 4c49 5354 2065 st;[..]]>.]]>.....< │ │ │ +0008d5f0: 215b 2565 6469 746f 722e 6d6f 6475 6c65 ![%editor.module │ │ │ +0008d600: 3b5b 0a3c 212d 2d46 5554 5552 4520 5553 ;[... │ │ │ +0008d720: 3c21 454e 5449 5459 2025 2065 6469 746f .. │ │ │ +0008d750: 3c21 454e 5449 5459 2025 2065 6469 746f .. │ │ │ +0008d7d0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....] │ │ │ +0008d880: 5d3e 0a20 203c 212d 2d28 7365 6520 2250 ]>. .]]>. │ │ │ +0008da10: 0a3c 2145 4e54 4954 5920 2520 6973 626e ...] │ │ │ +0008dab0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6973 ]>.]]>. │ │ │ +0008dad0: 0a3c 212d 2d20 4953 534e 202e 2e2e 2e2e .... │ │ │ +0008db20: 3c21 5b25 6973 736e 2e6d 6f64 756c 653b .. │ │ │ +0008db80: 0a3c 2145 4e54 4954 5920 2520 6973 736e ...]]>...< │ │ │ +0008dc20: 215b 2569 7373 6e2e 6174 746c 6973 743b ![%issn.attlist; │ │ │ +0008dc30: 5b0a 3c21 4154 544c 4953 5420 6973 736e [.. │ │ │ +0008dc80: 3c21 2d2d 656e 6420 6f66 2069 7373 6e2e ]]>.]]>........ │ │ │ +0008dd90: 3c21 454e 5449 5459 2025 2069 6e76 7061 ..]]>..< │ │ │ +0008de30: 2145 4e54 4954 5920 2520 696e 7670 6172 !ENTITY % invpar │ │ │ +0008de40: 746e 756d 6265 722e 6174 746c 6973 7420 tnumber.attlist │ │ │ +0008de50: 2249 4e43 4c55 4445 223e 0a3c 215b 2569 "INCLUDE">.. │ │ │ +0008dee0: 3c21 2d2d 656e 6420 6f66 2069 6e76 7061 ]]>.]]>.... │ │ │ +0008df80: 0a3c 215b 2569 7373 7565 6e75 6d2e 6d6f ......]]>... │ │ │ +0008e0a0: 3c21 5b25 6973 7375 656e 756d 2e61 7474 │ │ │ +0008e110: 0a3c 212d 2d65 6e64 206f 6620 6973 7375 .] │ │ │ +0008e130: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6973 ]>. │ │ │ +0008e150: 5d5d 3e0a 0a3c 212d 2d20 4c65 6761 6c4e ]]>.. │ │ │ +0008e180: 0a0a 3c21 454e 5449 5459 2025 206c 6567 ..... │ │ │ +0008e220: 0a3c 2145 4e54 4954 5920 2520 6c65 6761 ...]]>. │ │ │ +0008e2c0: 0a3c 2145 4e54 4954 5920 2520 6c65 6761 ...]]>.]]> │ │ │ +0008e3b0: 0a0a 3c21 2d2d 204d 6f64 6553 7065 6320 ....< │ │ │ +0008e3e0: 2145 4e54 4954 5920 2520 6d6f 6465 7370 !ENTITY % modesp │ │ │ +0008e3f0: 6563 2e6d 6f64 756c 6520 2249 4e43 4c55 ec.module "INCLU │ │ │ +0008e400: 4445 223e 0a3c 215b 256d 6f64 6573 7065 DE">.. │ │ │ +0008e440: 3c21 454e 5449 5459 2025 206d 6f64 6573 │ │ │ +0008e470: 0a0a 3c21 454e 5449 5459 2025 206d 6f64 ....]]>.......]]>.]]>..........]]>.... │ │ │ +0008e870: 3c21 2d2d 656e 6420 6f66 206f 7267 6e61 ]]> │ │ │ +0008e890: 0a3c 212d 2d65 6e64 206f 6620 6f72 676e .]]> │ │ │ +0008e8b0: 0a0a 3c21 2d2d 204f 7468 6572 4372 6564 ....< │ │ │ +0008e8e0: 2145 4e54 4954 5920 2520 6f74 6865 7263 !ENTITY % otherc │ │ │ +0008e8f0: 7265 6469 742e 6d6f 6475 6c65 2022 494e redit.module "IN │ │ │ +0008e900: 434c 5544 4522 3e0a 3c21 5b25 6f74 6865 CLUDE">.. │ │ │ +0008ea20: 3c21 454e 5449 5459 2025 206c 6f63 616c ..... │ │ │ +0008eaf0: 3c21 2d2d 656e 6420 6f66 206f 7468 6572 ]] │ │ │ +0008ebe0: 3e0a 2020 3c21 2d2d 2873 6565 2022 5065 >. .]]>..... │ │ │ -0008ecb0: 3c21 5b25 626f 6f6b 2e63 6f6e 7465 6e74 .... │ │ │ -0008ee20: 0a0a 3c21 454e 5449 5459 2025 2062 6f6f ... │ │ │ -0008ef40: 0a3c 212d 2d65 6e64 206f 6620 626f 6f6b .]]>.. │ │ │ -0008ef60: 3c21 2d2d 2046 5049 3a20 5347 4d4c 2066 ... │ │ │ -0008efb0: 0a3c 215b 2562 6f6f 6b2e 6174 746c 6973 ..]]>.]]>........... │ │ │ +0008ed30: 0a3c 215b 2570 6167 656e 756d 732e 656c .. │ │ │ +0008ed90: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.< │ │ │ +0008ee50: 212d 2d65 6e64 206f 6620 7061 6765 6e75 !--end of pagenu │ │ │ +0008ee60: 6d73 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a ms.module-->]]>. │ │ │ +0008ee70: 0a3c 212d 2d20 5065 7273 6f6e 616c 2069 ....... . . │ │ │ +0008f090: 203c 2145 4e54 4954 5920 2520 636f 6e74 │ │ │ +0008f0c0: 0a20 200a 3c21 454e 5449 5459 2025 2063 . ...]]>. ... │ │ │ +0008f1e0: 3c21 2d2d 656e 6420 6f66 2063 6f6e 7472 ]]> │ │ │ +0008f200: 0a20 203c 212d 2d65 6e64 206f 6620 636f . ] │ │ │ +0008f220: 5d3e 0a0a 2020 3c21 454e 5449 5459 2025 ]>.. . < │ │ │ +0008f250: 215b 2566 6972 7374 6e61 6d65 2e6d 6f64 ![%firstname.mod │ │ │ +0008f260: 756c 653b 5b0a 2020 3c21 454e 5449 5459 ule;[. . │ │ │ +0008f290: 3c21 454e 5449 5459 2025 2066 6972 7374 . ...]]>.]]>.]] │ │ │ -0008f3e0: 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e >..]]>.... │ │ │ -0008f680: 3c21 2d2d 656e 6420 6f66 2064 6564 6963 │ │ │ -0008f6a0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2064 ]]>.]]>........ │ │ │ -0008f7e0: 3c21 2d2d 656e 6420 6f66 2063 6f6c 6f70 ]] │ │ │ -0008f800: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >....]]>. │ │ │ -0008f8d0: 3c21 2d2d 656e 6420 6f66 2063 6f6c 6f70 ]]> │ │ │ -0008f8f0: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 .........] │ │ │ -0008fa60: 5d3e 0a0a 3c21 454e 5449 5459 2025 2074 ]>....] │ │ │ -0008fb10: 5d3e 0a3c 212d 2d65 6e64 206f 6620 746f ]>.]]>.. │ │ │ -0008fb30: 3c21 454e 5449 5459 2025 2074 6f63 6672 . │ │ │ -0008fb90: 0a3c 2145 4e54 4954 5920 2520 746f 6366 .....]]>.......]]>.]]>....< │ │ │ -0008fdf0: 2145 4e54 4954 5920 2520 746f 6365 6e74 !ENTITY % tocent │ │ │ -0008fe00: 7279 2e72 6f6c 652e 6174 7472 6962 2022 ry.role.attrib " │ │ │ -0008fe10: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ -0008fe20: 0a3c 2145 4e54 4954 5920 2520 746f 6365 ...]]>..... │ │ │ -0008ff00: 0a3c 215b 2574 6f63 656e 7472 792e 6174 ..]]>.]]>... │ │ │ -00090000: 3c21 5b25 746f 6370 6172 742e 6d6f 6475 .... │ │ │ -00090090: 3c21 5b25 746f 6370 6172 742e 656c 656d .< │ │ │ -000900d0: 212d 2d65 6e64 206f 6620 746f 6370 6172 !--end of tocpar │ │ │ -000900e0: 742e 656c 656d 656e 742d 2d3e 5d5d 3e0a t.element-->]]>. │ │ │ -000900f0: 0a3c 2145 4e54 4954 5920 2520 746f 6370 ...]]>....] │ │ │ -000903a0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 746f ]>.] │ │ │ -000903c0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2074 ]>........]]>....]]>.]]>..< │ │ │ -000905d0: 2145 4e54 4954 5920 2520 746f 636c 6576 !ENTITY % toclev │ │ │ -000905e0: 656c 322e 6d6f 6475 6c65 2022 494e 434c el2.module "INCL │ │ │ -000905f0: 5544 4522 3e0a 3c21 5b25 746f 636c 6576 UDE">......]]>.]]>.. │ │ │ -00090800: 0a3c 215b 2574 6f63 6c65 7665 6c33 2e6d ... │ │ │ -00090870: 0a3c 2145 4e54 4954 5920 2520 746f 636c ...]]> │ │ │ -00090900: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 ....< │ │ │ -000909a0: 212d 2d65 6e64 206f 6620 746f 636c 6576 !--end of toclev │ │ │ -000909b0: 656c 332e 6174 746c 6973 742d 2d3e 5d5d el3.attlist-->]] │ │ │ -000909c0: 3e0a 3c21 2d2d 656e 6420 6f66 2074 6f63 >. │ │ │ -000909e0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>....]]>.]]>.. │ │ │ -00090bf0: 3c21 454e 5449 5459 2025 2074 6f63 6c65 .....< │ │ │ -00090cb0: 215b 2574 6f63 6c65 7665 6c35 2e65 6c65 ![%toclevel5.ele │ │ │ -00090cc0: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..]]>....]]>.]]>..< │ │ │ -00090df0: 2145 4e54 4954 5920 2520 746f 6362 6163 !ENTITY % tocbac │ │ │ -00090e00: 6b2e 6d6f 6475 6c65 2022 494e 434c 5544 k.module "INCLUD │ │ │ -00090e10: 4522 3e0a 3c21 5b25 746f 6362 6163 6b2e E">...... │ │ │ -00090ee0: 3c21 2d2d 656e 6420 6f66 2074 6f63 6261 ]]> │ │ │ -00090f00: 0a0a 3c21 2d2d 2074 6f20 656c 656d 656e .. │ │ │ -00090f30: 0a0a 0a3c 2145 4e54 4954 5920 2520 746f .....]]>.]]>.]]> │ │ │ -00091060: 0a0a 3c21 454e 5449 5459 2025 206c 6f74 .........]]> │ │ │ -000911b0: 0a0a 3c21 454e 5449 5459 2025 206c 6f74 ....]]>.< │ │ │ -00091260: 212d 2d65 6e64 206f 6620 6c6f 742e 6d6f !--end of lot.mo │ │ │ -00091270: 6475 6c65 2d2d 3e5d 5d3e 0a0a 3c21 454e dule-->]]>......< │ │ │ -00091310: 2145 4e54 4954 5920 2520 6c6f 7465 6e74 !ENTITY % lotent │ │ │ -00091320: 7279 2e65 6c65 6d65 6e74 2022 494e 434c ry.element "INCL │ │ │ -00091330: 5544 4522 3e0a 3c21 5b25 6c6f 7465 6e74 UDE">....< │ │ │ -00091430: 2145 4e54 4954 5920 2520 6c6f 7465 6e74 !ENTITY % lotent │ │ │ -00091440: 7279 2e61 7474 6c69 7374 2022 494e 434c ry.attlist "INCL │ │ │ -00091450: 5544 4522 3e0a 3c21 5b25 6c6f 7465 6e74 UDE">..]]>.]]>.]]>. │ │ │ -00091570: 0a3c 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -000915c0: 0a3c 212d 2d20 4170 7065 6e64 6978 2c20 . │ │ │ -00091610: 0a0a 3c21 454e 5449 5459 2025 2061 7070 ........]]>.. │ │ │ -00091820: 0a3c 215b 2561 7070 656e 6469 782e 6174 ..]]>.]]>........ │ │ │ -00091ab0: 3c21 2d2d 656e 6420 6f66 2063 6861 7074 ]]> │ │ │ -00091ad0: 0a0a 3c21 454e 5449 5459 2025 2063 6861 ....]]>.]]>..... │ │ │ -00091c70: 3c21 454e 5449 5459 2025 206c 6f63 616c │ │ │ -00091c90: 0a3c 2145 4e54 4954 5920 2520 7061 7274 ...< │ │ │ -00091cc0: 2145 4e54 4954 5920 2520 7061 7274 2e65 !ENTITY % part.e │ │ │ -00091cd0: 6c65 6d65 6e74 2022 494e 434c 5544 4522 lement "INCLUDE" │ │ │ -00091ce0: 3e0a 3c21 5b25 7061 7274 2e65 6c65 6d65 >.. │ │ │ -00091d70: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>. │ │ │ -00091e80: 0a3c 2145 4e54 4954 5920 2520 7072 6566 ...< │ │ │ -00091ee0: 2145 4e54 4954 5920 2520 7072 6566 6163 !ENTITY % prefac │ │ │ -00091ef0: 652e 726f 6c65 2e61 7474 7269 6220 2225 e.role.attrib "% │ │ │ -00091f00: 726f 6c65 2e61 7474 7269 623b 223e 0a0a role.attrib;">.. │ │ │ -00091f10: 3c21 454e 5449 5459 2025 2070 7265 6661 ..]]>... │ │ │ -00092080: 3c21 5b25 7072 6566 6163 652e 6174 746c .< │ │ │ -00092100: 212d 2d65 6e64 206f 6620 7072 6566 6163 !--end of prefac │ │ │ -00092110: 652e 6174 746c 6973 742d 2d3e 5d5d 3e0a e.attlist-->]]>. │ │ │ -00092120: 3c21 2d2d 656e 6420 6f66 2070 7265 6661 ]]>. │ │ │ -00092140: 0a3c 2145 4e54 4954 5920 2520 7265 6665 ...... │ │ │ -00092200: 3c21 5b25 7265 6665 7265 6e63 652e 656c .]]>....]]> │ │ │ -000923b0: 0a3c 212d 2d45 4c45 4d45 4e54 2050 6172 ..]]>... │ │ │ -00092460: 0a3c 2145 4e54 4954 5920 2520 7061 7274 .....]]>. │ │ │ -00092540: 0a3c 2145 4e54 4954 5920 2520 7061 7274 ... │ │ │ -000925f0: 3c21 2d2d 656e 6420 6f66 2070 6172 7469 ] │ │ │ -00092610: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7061 ]>.... │ │ │ -00092700: 0a3c 215b 2025 6170 7065 6e64 6978 696e ......]]>....]]>.] │ │ │ -00092980: 5d3e 0a0a 3c21 454e 5449 5459 2025 2062 ]>....< │ │ │ -00092a00: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ -00092a10: 6772 6170 6879 696e 666f 2e72 6f6c 652e graphyinfo.role. │ │ │ -00092a20: 6174 7472 6962 2022 2572 6f6c 652e 6174 attrib "%role.at │ │ │ -00092a30: 7472 6962 3b22 3e0a 0a3c 2145 4e54 4954 trib;">....] │ │ │ -00092c40: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6269 ]>.]]>........]]>... │ │ │ -00092ec0: 0a3c 212d 2d65 6e64 206f 6620 6368 6170 .]]>...... │ │ │ -00092fb0: 3c21 454e 5449 5459 2025 2067 6c6f 7373 ..]]>....]] │ │ │ -00093190: 3e0a 3c21 2d2d 656e 6420 6f66 2067 6c6f >.]]>...< │ │ │ -000931e0: 215b 2025 696e 6465 7869 6e66 6f2e 6d6f ![ %indexinfo.mo │ │ │ -000931f0: 6475 6c65 3b20 5b0a 3c21 454e 5449 5459 dule; [... │ │ │ -00093250: 0a3c 2145 4e54 4954 5920 2520 696e 6465 ...< │ │ │ -00093330: 212d 2d65 6e64 206f 6620 696e 6465 7869 !--end of indexi │ │ │ -00093340: 6e66 6f2e 656c 656d 656e 742d 2d3e 5d5d nfo.element-->]] │ │ │ -00093350: 3e0a 0a3c 2145 4e54 4954 5920 2520 696e >....]]>........]]>....]]>.< │ │ │ -000936c0: 212d 2d65 6e64 206f 6620 7365 7469 6e64 !--end of setind │ │ │ -000936d0: 6578 696e 666f 2e6d 6f64 756c 652d 2d3e exinfo.module--> │ │ │ -000936e0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ -000937a0: 0a3c 215b 2025 7061 7274 696e 666f 2e65 ..]]>...< │ │ │ -000938a0: 215b 2025 7061 7274 696e 666f 2e61 7474 ![ %partinfo.att │ │ │ -000938b0: 6c69 7374 3b20 5b0a 3c21 4154 544c 4953 list; [.. │ │ │ -00093930: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2070 ]]>.]]>. │ │ │ -00093b00: 0a3c 2145 4e54 4954 5920 2520 7072 6566 ...]]>.< │ │ │ -00093bd0: 212d 2d65 6e64 206f 6620 7072 6566 6163 !--end of prefac │ │ │ -00093be0: 6569 6e66 6f2e 6d6f 6475 6c65 2d2d 3e5d einfo.module-->] │ │ │ -00093bf0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>........ │ │ │ -00093d80: 3c21 2d2d 656e 6420 6f66 2072 6566 656e ]]>.]]>. │ │ │ -00093ea0: 0a3c 2145 4e54 4954 5920 2520 7265 6673 ... │ │ │ -00093f10: 3c21 454e 5449 5459 2025 2072 6566 7365 .. │ │ │ -00093f70: 0a3c 215b 2025 7265 6673 6563 7431 696e ..] │ │ │ -00094050: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>...< │ │ │ -00094080: 215b 2025 7265 6673 6563 7431 696e 666f ![ %refsect1info │ │ │ -00094090: 2e61 7474 6c69 7374 3b20 5b0a 3c21 4154 .attlist; [..]]>.]]>........]]>. │ │ │ -00094300: 0a3c 2145 4e54 4954 5920 2520 7265 6673 ...< │ │ │ -000943b0: 212d 2d65 6e64 206f 6620 7265 6673 6563 !--end of refsec │ │ │ -000943c0: 7432 696e 666f 2e61 7474 6c69 7374 2d2d t2info.attlist-- │ │ │ -000943d0: 3e5d 5d3e 0a3c 212d 2d65 6e64 206f 6620 >]]>.]]>...... │ │ │ -000944a0: 3c21 454e 5449 5459 2025 2072 6566 7365 ..]]>....]] │ │ │ -00094680: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6566 >.]]>........]]>....] │ │ │ -00094980: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7265 ]>.]]>..< │ │ │ -000949b0: 2145 4e54 4954 5920 2520 7265 6665 7265 !ENTITY % refere │ │ │ -000949c0: 6e63 6569 6e66 6f2e 6d6f 6475 6c65 2022 nceinfo.module " │ │ │ -000949d0: 494e 434c 5544 4522 3e0a 3c21 5b20 2572 INCLUDE">. │ │ │ -00094a20: 0a3c 2145 4e54 4954 5920 2520 7265 6665 .....]]>.... │ │ │ -00094c40: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2072 ]]>.]]>.. │ │ │ -00094c90: 0a3c 2145 4e54 4954 5920 2520 7365 6374 .....]]>.. │ │ │ -00094db0: 3c21 454e 5449 5459 2025 2073 6563 7431 ..]]>. │ │ │ -00094e70: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ......]]>....]]>.......]]> │ │ │ -000953c0: 0a0a 3c21 454e 5449 5459 2025 2073 6563 ....< │ │ │ -00095460: 212d 2d65 6e64 206f 6620 7365 6374 3469 !--end of sect4i │ │ │ -00095470: 6e66 6f2e 6174 746c 6973 742d 2d3e 5d5d nfo.attlist-->]] │ │ │ -00095480: 3e0a 0a3c 2145 4e54 4954 5920 2520 6c6f >.......]]>... │ │ │ -000955f0: 3c21 5b25 7365 6374 3569 6e66 6f2e 6174 .]]>............]]>.. │ │ │ -00095930: 3c21 454e 5449 5459 2025 2073 6563 7469 ..]]>.]]>........]]>. │ │ │ -00095bc0: 0a3c 2145 4e54 4954 5920 2520 7365 6374 ...]]>.< │ │ │ -00095c90: 212d 2d65 6e64 206f 6620 7365 6374 696f !--end of sectio │ │ │ -00095ca0: 6e69 6e66 6f2e 6d6f 6475 6c65 2d2d 3e5d ninfo.module-->] │ │ │ -00095cb0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7365 ]>.]]>...... │ │ │ -00095da0: 3c21 5b25 7365 6374 312e 6d6f 6475 6c65 .....< │ │ │ -00095f10: 212d 2d65 6e64 206f 6620 7365 6374 312e !--end of sect1. │ │ │ -00095f20: 656c 656d 656e 742d 2d3e 5d5d 3e0a 0a3c element-->]]>..< │ │ │ -00095f30: 212d 2d20 5265 6e64 6572 6173 3a20 496e !-- Renderas: In │ │ │ -00095f40: 6469 6361 7465 7320 7468 6520 666f 726d dicates the form │ │ │ -00095f50: 6174 2069 6e20 7768 6963 6820 7468 6520 at in which the │ │ │ -00095f60: 6865 6164 696e 6720 7368 6f75 6c64 0a09 heading should.. │ │ │ -00095f70: 0961 7070 6561 7220 2d2d 3e0a 0a0a 3c21 .appear -->.....]]>.]]>...... │ │ │ -00096390: 0a3c 212d 2d65 6e64 206f 6620 7365 6374 .]]>. │ │ │ -000963b0: 3c21 2d2d 656e 6420 6f66 2073 6563 7432 ]]>..< │ │ │ -000963d0: 2145 4e54 4954 5920 2520 7365 6374 332e !ENTITY % sect3. │ │ │ -000963e0: 6d6f 6475 6c65 2022 494e 434c 5544 4522 module "INCLUDE" │ │ │ -000963f0: 3e0a 3c21 5b25 7365 6374 332e 6d6f 6475 >..... │ │ │ -00096560: 0a3c 212d 2d65 6e64 206f 6620 7365 6374 .]]>. │ │ │ -00096580: 0a3c 212d 2d20 5265 6e64 6572 6173 3a20 .... │ │ │ -000965d0: 3c21 454e 5449 5459 2025 2073 6563 7433 ..]]>.]]>.... │ │ │ -00096750: 3c21 454e 5449 5459 2025 2073 6563 7434 ..< │ │ │ -00096780: 2145 4e54 4954 5920 2520 7365 6374 342e !ENTITY % sect4. │ │ │ -00096790: 656c 656d 656e 7420 2249 4e43 4c55 4445 element "INCLUDE │ │ │ -000967a0: 223e 0a3c 215b 2573 6563 7434 2e65 6c65 ">..]]>.......]] │ │ │ -00096a00: 3e0a 3c21 2d2d 656e 6420 6f66 2073 6563 >.]]>. │ │ │ -00096a20: 0a3c 2145 4e54 4954 5920 2520 7365 6374 .......]]>..... │ │ │ -00096c30: 0a3c 215b 2573 6563 7435 2e61 7474 6c69 .. │ │ │ -00096d30: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ -00096dd0: 3c21 454e 5449 5459 2025 2073 696d 706c ..]]>....< │ │ │ -00096f20: 212d 2d65 6e64 206f 6620 7369 6d70 6c65 !--end of simple │ │ │ -00096f30: 7365 6374 2e61 7474 6c69 7374 2d2d 3e5d sect.attlist-->] │ │ │ -00096f40: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7369 ]>.........< │ │ │ -00097100: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ -00097110: 6772 6170 6879 2e65 6c65 6d65 6e74 2022 graphy.element " │ │ │ -00097120: 494e 434c 5544 4522 3e0a 3c21 5b25 6269 INCLUDE">..]]> │ │ │ -00097240: 0a0a 3c21 454e 5449 5459 2025 2062 6962 .... │ │ │ -00097300: 3c21 2d2d 656e 6420 6f66 2062 6962 6c69 ]]>.... │ │ │ -000973b0: 3c21 454e 5449 5459 2025 2062 6962 6c69 ....]]>... │ │ │ -000974d0: 3c21 5b25 6269 626c 696f 6469 762e 6174 .]]>.]]>.]]>.......... │ │ │ -00097770: 0a3c 215b 2567 6c6f 7373 6172 792e 656c ..]]>....]]>.]]>...< │ │ │ -00097980: 215b 2567 6c6f 7373 6469 762e 6d6f 6475 ![%glossdiv.modu │ │ │ -00097990: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[......]]>....]]>.]]>.] │ │ │ -00097bb0: 5d3e 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e ]>...... │ │ │ -00097c80: 3c21 5b25 696e 6465 782e 636f 6e74 656e . │ │ │ -00097cc0: 3c21 5b25 696e 6465 7865 732e 6d6f 6475 .....] │ │ │ -00097e20: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>... │ │ │ -00097eb0: 0a3c 212d 2d65 6e64 206f 6620 696e 6465 .]]>. │ │ │ -00097ed0: 0a3c 2145 4e54 4954 5920 2520 7365 7469 ...]]>..< │ │ │ -00097fd0: 2145 4e54 4954 5920 2520 7365 7469 6e64 !ENTITY % setind │ │ │ -00097fe0: 6578 2e61 7474 6c69 7374 2022 494e 434c ex.attlist "INCL │ │ │ -00097ff0: 5544 4522 3e0a 3c21 5b25 7365 7469 6e64 UDE">..]]>.]]>..........< │ │ │ -00098240: 212d 2d65 6e64 206f 6620 696e 6465 7864 !--end of indexd │ │ │ -00098250: 6976 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e iv.element-->]]> │ │ │ -00098260: 0a0a 3c21 454e 5449 5459 2025 2069 6e64 ....]]>.]]>...... │ │ │ -000983e0: 3c21 454e 5449 5459 2025 2069 6e64 6578 ....]]> │ │ │ -000984e0: 0a0a 3c21 454e 5449 5459 2025 2069 6e64 ....]]>.]]>......< │ │ │ -00098670: 2145 4e54 4954 5920 2520 7072 696d 6172 !ENTITY % primar │ │ │ -00098680: 7969 652e 656c 656d 656e 7420 2249 4e43 yie.element "INC │ │ │ -00098690: 4c55 4445 223e 0a3c 215b 2570 7269 6d61 LUDE">..]]>......]]>....] │ │ │ -000988a0: 5d3e 0a0a 3c21 2d2d 2074 6f20 496e 6465 ]>......]]>....]]>......]]>. │ │ │ -00098b60: 0a3c 212d 2d65 6e64 206f 6620 7072 696d .]]>... │ │ │ -00098cb0: 0a0a 3c21 454e 5449 5459 2025 2073 6565 ....]]>.]]>....< │ │ │ -00098df0: 2145 4e54 4954 5920 2520 7365 6561 6c73 !ENTITY % seeals │ │ │ -00098e00: 6f69 652e 726f 6c65 2e61 7474 7269 6220 oie.role.attrib │ │ │ -00098e10: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ -00098e20: 0a0a 3c21 454e 5449 5459 2025 2073 6565 ....]]>. │ │ │ -00098eb0: 0a3c 212d 2d20 746f 2072 656c 6174 6564 .]]>.]]>.]]>.. │ │ │ -00098ff0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -00099040: 3c21 2d2d 2052 6566 456e 7472 7920 2e2e . │ │ │ -00099090: 0a3c 2145 4e54 4954 5920 2520 7265 6665 ..< │ │ │ -000990c0: 215b 2572 6566 656e 7472 792e 636f 6e74 ![%refentry.cont │ │ │ -000990d0: 656e 742e 6d6f 6475 6c65 3b5b 0a3c 2145 ent.module;[..... │ │ │ -00099170: 3c21 454e 5449 5459 2025 2072 6566 656e ..]]>.. │ │ │ -00099280: 3c21 454e 5449 5459 2025 2072 6566 656e ..]]>.]]>........]]>.]]>........]]>. │ │ │ -000996f0: 0a3c 212d 2d20 436c 6173 733a 2046 7265 ......]]>. │ │ │ -00099810: 3c21 2d2d 656e 6420 6f66 2072 6566 6d69 │ │ │ -00099830: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ -000998d0: 3c21 454e 5449 5459 2025 2072 6566 6e61 ..]]>.... │ │ │ -00099a40: 3c21 2d2d 656e 6420 6f66 2072 6566 6e61 │ │ │ -00099a60: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2072 ]]>.]]>....... │ │ │ -00099b30: 3c21 454e 5449 5459 2025 2072 6566 6465 ..]]>..< │ │ │ -00099bd0: 2145 4e54 4954 5920 2520 7265 6664 6573 !ENTITY % refdes │ │ │ -00099be0: 6372 6970 746f 722e 6174 746c 6973 7420 criptor.attlist │ │ │ -00099bf0: 2249 4e43 4c55 4445 223e 0a3c 215b 2572 "INCLUDE">.. │ │ │ -00099c80: 3c21 2d2d 656e 6420 6f66 2072 6566 6465 ]]>.]]>........] │ │ │ -00099de0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>....]]>.]]>.. │ │ │ -00099ee0: 0a3c 215b 2572 6566 7075 7270 6f73 652e .. │ │ │ -00099f20: 3c21 454e 5449 5459 2025 2072 6566 7075 ....]]>....]]>.< │ │ │ -0009a0b0: 212d 2d65 6e64 206f 6620 7265 6670 7572 !--end of refpur │ │ │ -0009a0c0: 706f 7365 2e6d 6f64 756c 652d 2d3e 5d5d pose.module-->]] │ │ │ -0009a0d0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >........< │ │ │ -0009a1d0: 212d 2d65 6e64 206f 6620 7265 6663 6c61 !--end of refcla │ │ │ -0009a1e0: 7373 2e65 6c65 6d65 6e74 2d2d 3e5d 5d3e ss.element-->]]> │ │ │ -0009a1f0: 0a0a 3c21 454e 5449 5459 2025 2072 6566 ....]]>.]]>... │ │ │ -0009a340: 0a3c 2145 4e54 4954 5920 2520 7265 6673 .....]]>....]]>.] │ │ │ -0009a570: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>........]]>....]]>.]]>...< │ │ │ -0009a7f0: 215b 2572 6566 7365 6374 322e 6d6f 6475 ![%refsect2.modu │ │ │ -0009a800: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[......]]>..< │ │ │ -0009a930: 2145 4e54 4954 5920 2520 7265 6673 6563 !ENTITY % refsec │ │ │ -0009a940: 7432 2e61 7474 6c69 7374 2022 494e 434c t2.attlist "INCL │ │ │ -0009a950: 5544 4522 3e0a 3c21 5b25 7265 6673 6563 UDE">..]]>.]]>...... │ │ │ -0009aab0: 3c21 454e 5449 5459 2025 2072 6566 7365 ..]]>... │ │ │ -0009ab90: 3c21 5b25 7265 6673 6563 7433 2e61 7474 .]]>.. │ │ │ -0009ac80: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -0009acd0: 3c21 2d2d 2041 7274 6963 6c65 202e 2e2e . │ │ │ -0009ad20: 0a3c 2145 4e54 4954 5920 2520 6172 7469 .... │ │ │ -0009aea0: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ......]]>......... demo/ │ │ │ -0009b2e0: 646f 6373 7263 2f44 6f63 426f 6f6b 2f64 docsrc/DocBook/d │ │ │ -0009b2f0: 6267 656e 656e 742e 656e 74df 0000 063b bgenent.ent....; │ │ │ -0009b300: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -0009b350: 3c21 2d2d 2044 6f63 426f 6f6b 2058 4d4c . │ │ │ -0009b3a0: 0a3c 212d 2d20 436f 7079 7269 6768 7420 ... │ │ │ -0009b5a0: 3c21 2d2d 2046 696c 6520 6462 6765 6e65 . │ │ │ -0009b5f0: 0a3c 212d 2d20 596f 7520 6361 6e20 6564 .......... │ │ │ -0009b940: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ -0009b950: 6f6f 6b2f 6462 6365 6e74 782e 6d6f 64df ook/dbcentx.mod. │ │ │ -0009b960: 0000 1842 3c21 2d2d 202e 2e2e 2e2e 2e2e ...B.............< │ │ │ -0009c210: 215b 2549 534f 616d 7361 2e6d 6f64 756c ![%ISOamsa.modul │ │ │ -0009c220: 653b 5b0a 3c21 454e 5449 5459 2025 2049 e;[..%ISOams │ │ │ -0009c2a0: 613b 0a3c 212d 2d65 6e64 206f 6620 4953 a;.] │ │ │ -0009c2c0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2049 ]>....%ISOamsb;.]]>..< │ │ │ -0009c3a0: 2145 4e54 4954 5920 2520 4953 4f61 6d73 !ENTITY % ISOams │ │ │ -0009c3b0: 632e 6d6f 6475 6c65 2022 494e 434c 5544 c.module "INCLUD │ │ │ -0009c3c0: 4522 3e0a 3c21 5b25 4953 4f61 6d73 632e E">..%ISOams │ │ │ -0009c450: 633b 0a3c 212d 2d65 6e64 206f 6620 4953 c;.] │ │ │ -0009c470: 5d3e 0a0a 3c21 454e 5449 5459 2025 2049 ]>....%ISOamsn;.< │ │ │ -0009c530: 212d 2d65 6e64 206f 6620 4953 4f61 6d73 !--end of ISOams │ │ │ -0009c540: 6e2e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a n.module-->]]>.. │ │ │ -0009c550: 3c21 454e 5449 5459 2025 2049 534f 616d ..%ISOamso │ │ │ -0009c600: 3b0a 3c21 2d2d 656e 6420 6f66 2049 534f ;.]] │ │ │ -0009c620: 3e0a 0a3c 2145 4e54 4954 5920 2520 4953 >....%ISO │ │ │ -0009c6d0: 616d 7372 3b0a 3c21 2d2d 656e 6420 6f66 amsr;.]]>.. │ │ │ -0009c7e0: 0a3c 215b 2549 534f 6379 7231 2e6d 6f64 ..%ISOcyr1 │ │ │ -0009c860: 3b0a 3c21 2d2d 656e 6420 6f66 2049 534f ;.]] │ │ │ -0009c880: 3e0a 0a3c 2145 4e54 4954 5920 2520 4953 >....%ISOcyr2;.]]>....%ISOdia;. │ │ │ -0009c9f0: 3c21 2d2d 656e 6420 6f66 2049 534f 6469 ]]>.. │ │ │ -0009ca10: 3c21 454e 5449 5459 2025 2049 534f 6772 ..%ISOgrk │ │ │ -0009cab0: 313b 0a3c 212d 2d65 6e64 206f 6620 4953 1;.] │ │ │ -0009cad0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2049 ]>.... │ │ │ -0009cb70: 2549 534f 6772 6b32 3b0a 3c21 2d2d 656e %ISOgrk2;.]]>... │ │ │ -0009cbc0: 3c21 5b25 4953 4f67 726b 332e 6d6f 6475 .%ISOgrk3;.]]>..< │ │ │ -0009cc60: 2145 4e54 4954 5920 2520 4953 4f67 726b !ENTITY % ISOgrk │ │ │ -0009cc70: 342e 6d6f 6475 6c65 2022 494e 434c 5544 4.module "INCLUD │ │ │ -0009cc80: 4522 3e0a 3c21 5b25 4953 4f67 726b 342e E">..%ISOgrk4;.]]>..< │ │ │ -0009cd30: 2145 4e54 4954 5920 2520 4953 4f6c 6174 !ENTITY % ISOlat │ │ │ -0009cd40: 312e 6d6f 6475 6c65 2022 494e 434c 5544 1.module "INCLUD │ │ │ -0009cd50: 4522 3e0a 3c21 5b25 4953 4f6c 6174 312e E">..%ISOlat1 │ │ │ -0009cdd0: 3b0a 3c21 2d2d 656e 6420 6f66 2049 534f ;.]] │ │ │ -0009cdf0: 3e0a 0a3c 2145 4e54 4954 5920 2520 4953 >....%ISO │ │ │ -0009ce90: 6c61 7432 3b0a 3c21 2d2d 656e 6420 6f66 lat2;.]] │ │ │ -0009cf80: 3e0a 0a3c 2145 4e54 4954 5920 2520 4953 >....%ISOpub;.]]>....%ISOt │ │ │ -0009d0e0: 6563 683b 0a3c 212d 2d65 6e64 206f 6620 ech;....... demo/ │ │ │ -0009d1b0: 646f 6373 7263 2f44 6f63 426f 6f6b 2f63 docsrc/DocBook/c │ │ │ -0009d1c0: 616c 7374 626c 782e 6474 64df 0000 2067 alstblx.dtd... g │ │ │ -0009d1d0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ -0009d220: 3c21 2d2d 2044 6f63 426f 6f6b 2058 4d4c . │ │ │ -0009d270: 3c21 2d2d 2046 696c 6520 6361 6c73 7462 . │ │ │ -0009d2c0: 0a3c 212d 2d20 436f 7079 7269 6768 7420 ......... │ │ │ -0009d950: 3c21 454e 5449 5459 2025 2062 6f64 7961 ...... │ │ │ -0009d9f0: 3c21 454e 5449 5459 2025 2074 6974 6c65 .....................< │ │ │ -0009dfd0: 2145 4c45 4d45 4e54 2074 6162 6c65 2028 !ELEMENT table ( │ │ │ -0009dfe0: 2574 626c 2e74 6162 6c65 2e6d 646c 3b29 %tbl.table.mdl;) │ │ │ -0009dff0: 3e0a 0a3c 2141 5454 4c49 5354 2074 6162 >.... │ │ │ -0009e140: 0a0a 3c21 4154 544c 4953 5420 7467 726f ..... │ │ │ -0009e350: 0a3c 2141 5454 4c49 5354 2063 6f6c 7370 ............... │ │ │ -0009e960: 3c21 4154 544c 4953 5420 7462 6f64 790a ......< │ │ │ -0009eaa0: 2145 4c45 4d45 4e54 2065 6e74 7279 7462 !ELEMENT entrytb │ │ │ -0009eab0: 6c20 2825 7462 6c2e 656e 7472 7974 626c l (%tbl.entrytbl │ │ │ -0009eac0: 2e6d 646c 3b29 3e0a 0a3c 2141 5454 4c49 .mdl;)>...............demo │ │ │ -0009f240: 2f64 6f63 7372 632f 446f 6342 6f6f 6b2f /docsrc/DocBook/ │ │ │ -0009f250: 5645 5253 494f 4edf 0000 0006 332e 312e VERSION.....3.1. │ │ │ -0009f260: 370a b600 0000 1a64 656d 6f2f 646f 6373 7......demo/docs │ │ │ -0009f270: 7263 2f44 6f63 426f 6f6b 2f52 4541 444d rc/DocBook/READM │ │ │ -0009f280: 45df 0000 0973 5245 4144 4d45 2066 6f72 E....sREADME for │ │ │ -0009f290: 2074 6865 2044 6f63 426b 2058 4d4c 2056 the DocBk XML V │ │ │ -0009f2a0: 332e 312e 3720 4454 440a 0a54 6869 7320 3.1.7 DTD..This │ │ │ -0009f2b0: 6973 2061 6e20 584d 4c20 7665 7273 696f is an XML versio │ │ │ -0009f2c0: 6e20 6f66 2074 6865 2044 6f63 426f 6f6b n of the DocBook │ │ │ -0009f2d0: 2056 332e 3120 4454 440a 0a4d 616e 6966 V3.1 DTD..Manif │ │ │ -0009f2e0: 6573 740a 2d2d 2d2d 2d2d 2d2d 0a0a 5245 est.--------..RE │ │ │ -0009f2f0: 4144 4d45 2020 2020 2020 2020 2d20 5468 ADME - Th │ │ │ -0009f300: 6973 2072 6561 646d 6520 6669 6c65 0a56 is readme file.V │ │ │ -0009f310: 4552 5349 4f4e 2020 2020 2020 202d 2054 ERSION - T │ │ │ -0009f320: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ -0009f330: 720a 434f 5059 5249 4748 5420 2020 2020 r.COPYRIGHT │ │ │ -0009f340: 2d20 436f 7079 7269 6768 7420 7374 6174 - Copyright stat │ │ │ -0009f350: 656d 656e 740a 4368 616e 6765 4c6f 6720 ement.ChangeLog │ │ │ -0009f360: 2020 2020 2d20 5375 6d6d 6172 7920 6f66 - Summary of │ │ │ -0009f370: 2063 6861 6e67 6573 2066 726f 6d20 7072 changes from pr │ │ │ -0009f380: 6576 696f 7573 2076 6572 7369 6f6e 730a evious versions. │ │ │ -0009f390: 6361 6c73 7462 6c78 2e64 7464 2020 2d20 calstblx.dtd - │ │ │ -0009f3a0: 416e 2058 4d4c 2076 6572 7369 6f6e 206f An XML version o │ │ │ -0009f3b0: 6620 7468 6520 4341 4c53 2054 6162 6c65 f the CALS Table │ │ │ -0009f3c0: 204d 6f64 656c 2044 5444 0a64 6263 656e Model DTD.dbcen │ │ │ -0009f3d0: 7478 2e6d 6f64 2020 202d 2043 6861 7261 tx.mod - Chara │ │ │ -0009f3e0: 6374 6572 2065 6e74 6974 6965 730a 6462 cter entities.db │ │ │ -0009f3f0: 6765 6e65 6e74 2e65 6e74 2020 2d20 4765 genent.ent - Ge │ │ │ -0009f400: 6e65 7261 6c20 656e 7469 7469 6573 0a64 neral entities.d │ │ │ -0009f410: 6268 6965 7278 2e6d 6f64 2020 202d 2054 bhierx.mod - T │ │ │ -0009f420: 6865 2058 4d4c 2076 6572 7369 6f6e 206f he XML version o │ │ │ -0009f430: 6620 7468 6520 6869 6572 6172 6368 7920 f the hierarchy │ │ │ -0009f440: 6d6f 6475 6c65 0a64 626e 6f74 6e78 2e6d module.dbnotnx.m │ │ │ -0009f450: 6f64 2020 202d 204e 6f74 6174 696f 6e73 od - Notations │ │ │ -0009f460: 0a64 6270 6f6f 6c78 2e6d 6f64 2020 202d .dbpoolx.mod - │ │ │ -0009f470: 2054 6865 2058 4d4c 2076 6572 7369 6f6e The XML version │ │ │ -0009f480: 206f 6620 7468 6520 696e 666f 726d 6174 of the informat │ │ │ -0009f490: 696f 6e20 706f 6f6c 206d 6f64 756c 650a ion pool module. │ │ │ -0009f4a0: 646f 6362 6f6f 6b78 2e64 7464 2020 2d20 docbookx.dtd - │ │ │ -0009f4b0: 5468 6520 584d 4c20 7665 7273 696f 6e20 The XML version │ │ │ -0009f4c0: 6f66 2074 6865 2044 6f63 426f 6f6b 2033 of the DocBook 3 │ │ │ -0009f4d0: 2e31 2044 5444 0a73 6f65 7874 626c 782e .1 DTD.soextblx. │ │ │ -0009f4e0: 6474 6420 202d 2041 6e20 584d 4c20 7665 dtd - An XML ve │ │ │ -0009f4f0: 7273 696f 6e20 6f66 2074 6865 204f 4153 rsion of the OAS │ │ │ -0009f500: 4953 2045 7863 6861 6e67 6520 5461 626c IS Exchange Tabl │ │ │ -0009f510: 6520 6d6f 6465 6c0a 7465 7374 2e78 6d6c e model.test.xml │ │ │ -0009f520: 2020 2020 2020 2d20 4120 7465 7374 2064 - A test d │ │ │ -0009f530: 6f63 756d 656e 740a 656e 742f 2020 2020 ocument.ent/ │ │ │ -0009f540: 2020 2020 2020 2d20 584d 4c20 7665 7273 - XML vers │ │ │ -0009f550: 696f 6e73 206f 6620 7468 6520 4953 4f20 ions of the ISO │ │ │ -0009f560: 656e 7469 7479 2073 6574 730a 0a49 6e73 entity sets..Ins │ │ │ -0009f570: 7461 6c6c 6174 696f 6e0a 2d2d 2d2d 2d2d tallation.------ │ │ │ -0009f580: 2d2d 2d2d 2d2d 0a0a 506c 6163 6520 7468 ------..Place th │ │ │ -0009f590: 6520 6669 6c65 7320 696e 2074 6869 7320 e files in this │ │ │ -0009f5a0: 6469 7374 7269 6275 7469 6f6e 2073 6f6d distribution som │ │ │ -0009f5b0: 6577 6865 7265 206f 6e20 796f 7572 206d ewhere on your m │ │ │ -0009f5c0: 6163 6869 6e65 2e20 2041 646a 7573 740a achine. Adjust. │ │ │ -0009f5d0: 796f 7572 2063 6174 616c 6f67 2873 2920 your catalog(s) │ │ │ -0009f5e0: 6966 2061 7070 726f 7072 6961 7465 2028 if appropriate ( │ │ │ -0009f5f0: 584d 4c20 746f 6f6c 7320 6672 6571 7565 XML tools freque │ │ │ -0009f600: 6e74 6c79 2064 6f20 6e6f 7420 7375 7070 ntly do not supp │ │ │ -0009f610: 6f72 7420 0a63 6174 616c 6f67 732c 2073 ort .catalogs, s │ │ │ -0009f620: 6f20 7468 6973 206d 6179 2062 6520 6972 o this may be ir │ │ │ -0009f630: 7265 6c65 7661 6e74 2066 6f72 2079 6f75 relevant for you │ │ │ -0009f640: 292e 0a0a 506c 6561 7365 2075 7365 2074 )...Please use t │ │ │ -0009f650: 6865 2066 6f6c 6c6f 7769 6e67 2066 6f72 he following for │ │ │ -0009f660: 6d61 6c20 7075 626c 6963 2069 6465 6e74 mal public ident │ │ │ -0009f670: 6966 6965 7220 746f 2069 6465 6e74 6966 ifier to identif │ │ │ -0009f680: 7920 7468 6973 2044 5444 3a0a 0a22 2d2f y this DTD:.."-/ │ │ │ -0009f690: 2f4e 6f72 6d61 6e20 5761 6c73 682f 2f44 /Norman Walsh//D │ │ │ -0009f6a0: 5444 2044 6f63 426b 2058 4d4c 2056 332e TD DocBk XML V3. │ │ │ -0009f6b0: 312e 372f 2f45 4e22 0a0a 466f 7220 6578 1.7//EN"..For ex │ │ │ -0009f6c0: 616d 706c 652c 2069 6620 796f 7572 2064 ample, if your d │ │ │ -0009f6d0: 6f63 756d 656e 7427 7320 746f 702d 6c65 ocument's top-le │ │ │ -0009f6e0: 7665 6c20 656c 656d 656e 7420 6973 203c vel element is < │ │ │ -0009f6f0: 626f 6f6b 3e2c 2061 6e64 0a79 6f75 2061 book>, and.you a │ │ │ -0009f700: 7265 2075 7369 6e67 2044 6f63 426b 2058 re using DocBk X │ │ │ -0009f710: 4d4c 2064 6972 6563 746c 792c 2075 7365 ML directly, use │ │ │ -0009f720: 2074 6865 2046 5049 2069 6e20 7468 6520 the FPI in the │ │ │ -0009f730: 444f 4354 5950 450a 6465 636c 6172 6174 DOCTYPE.declarat │ │ │ -0009f740: 696f 6e3a 0a0a 3c21 444f 4354 5950 4520 ion:....Or, i │ │ │ -0009f7d0: 6620 796f 7520 6861 7665 2061 2068 6967 f you have a hig │ │ │ -0009f7e0: 6865 722d 6c65 7665 6c20 6472 6976 6572 her-level driver │ │ │ -0009f7f0: 2066 696c 6520 7468 6174 2063 7573 746f file that custo │ │ │ -0009f800: 6d69 7a65 7320 446f 6342 6b20 584d 4c2c mizes DocBk XML, │ │ │ -0009f810: 0a75 7365 2074 6865 2046 5049 2069 6e20 .use the FPI in │ │ │ -0009f820: 7468 6520 7061 7261 6d65 7465 7220 656e the parameter en │ │ │ -0009f830: 7469 7479 2064 6563 6c61 7261 7469 6f6e tity declaration │ │ │ -0009f840: 3a0a 0a3c 2145 4e54 4954 5920 2520 446f :...%DocBkXML;. │ │ │ -0009f8d0: 0a0a 436f 7079 7269 6768 740a 2d2d 2d2d ..Copyright.---- │ │ │ -0009f8e0: 2d2d 2d2d 2d0a 0a43 6f70 7972 6967 6874 -----..Copyright │ │ │ -0009f8f0: 2028 4329 2031 3939 382c 2031 3939 3920 (C) 1998, 1999 │ │ │ -0009f900: 4e6f 726d 616e 2057 616c 7368 0a0a 5365 Norman Walsh..Se │ │ │ -0009f910: 6520 434f 5059 5249 4748 5420 666f 7220 e COPYRIGHT for │ │ │ -0009f920: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ -0009f930: 0a0a 5761 7272 616e 7479 0a2d 2d2d 2d2d ..Warranty.----- │ │ │ -0009f940: 2d2d 2d0a 0a54 4845 2053 4f46 5457 4152 ---..THE SOFTWAR │ │ │ -0009f950: 4520 4953 2050 524f 5649 4445 4420 2241 E IS PROVIDED "A │ │ │ -0009f960: 5320 4953 222c 2057 4954 484f 5554 2057 S IS", WITHOUT W │ │ │ -0009f970: 4152 5241 4e54 5920 4f46 2041 4e59 204b ARRANTY OF ANY K │ │ │ -0009f980: 494e 442c 0a45 5850 5245 5353 204f 5220 IND,.EXPRESS OR │ │ │ -0009f990: 494d 504c 4945 442c 2049 4e43 4c55 4449 IMPLIED, INCLUDI │ │ │ -0009f9a0: 4e47 2042 5554 204e 4f54 204c 494d 4954 NG BUT NOT LIMIT │ │ │ -0009f9b0: 4544 2054 4f20 5448 4520 5741 5252 414e ED TO THE WARRAN │ │ │ -0009f9c0: 5449 4553 0a4f 4620 4d45 5243 4841 4e54 TIES.OF MERCHANT │ │ │ -0009f9d0: 4142 494c 4954 592c 2046 4954 4e45 5353 ABILITY, FITNESS │ │ │ -0009f9e0: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ -0009f9f0: 5220 5055 5250 4f53 4520 414e 440a 4e4f R PURPOSE AND.NO │ │ │ -0009fa00: 4e49 4e46 5249 4e47 454d 454e 542e 2020 NINFRINGEMENT. │ │ │ -0009fa10: 494e 204e 4f20 4556 454e 5420 5348 414c IN NO EVENT SHAL │ │ │ -0009fa20: 4c20 4e4f 524d 414e 2057 414c 5348 204f L NORMAN WALSH O │ │ │ -0009fa30: 5220 414e 5920 4f54 4845 520a 434f 4e54 R ANY OTHER.CONT │ │ │ -0009fa40: 5249 4255 544f 5220 4245 204c 4941 424c RIBUTOR BE LIABL │ │ │ -0009fa50: 4520 464f 5220 414e 5920 434c 4149 4d2c E FOR ANY CLAIM, │ │ │ -0009fa60: 2044 414d 4147 4553 204f 5220 4f54 4845 DAMAGES OR OTHE │ │ │ -0009fa70: 5220 4c49 4142 494c 4954 592c 0a57 4845 R LIABILITY,.WHE │ │ │ -0009fa80: 5448 4552 2049 4e20 414e 2041 4354 494f THER IN AN ACTIO │ │ │ -0009fa90: 4e20 4f46 2043 4f4e 5452 4143 542c 2054 N OF CONTRACT, T │ │ │ -0009faa0: 4f52 5420 4f52 204f 5448 4552 5749 5345 ORT OR OTHERWISE │ │ │ -0009fab0: 2c20 4152 4953 494e 470a 4652 4f4d 2c20 , ARISING.FROM, │ │ │ -0009fac0: 4f55 5420 4f46 204f 5220 494e 2043 4f4e OUT OF OR IN CON │ │ │ -0009fad0: 4e45 4354 494f 4e20 5749 5448 2054 4845 NECTION WITH THE │ │ │ -0009fae0: 2053 4f46 5457 4152 4520 4f52 2054 4845 SOFTWARE OR THE │ │ │ -0009faf0: 2055 5345 204f 520a 4f54 4845 5220 4445 USE OR.OTHER DE │ │ │ -0009fb00: 414c 494e 4753 2049 4e20 5448 4520 534f ALINGS IN THE SO │ │ │ -0009fb10: 4654 5741 5245 2e0a 0a43 6f6e 7461 6374 FTWARE...Contact │ │ │ -0009fb20: 696e 6720 7468 6520 4175 7468 6f72 0a2d ing the Author.- │ │ │ -0009fb30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ -0009fb40: 2d2d 2d2d 0a0a 5468 6973 2044 5444 2069 ----..This DTD i │ │ │ -0009fb50: 7320 6d61 696e 7461 696e 6564 2062 7920 s maintained by │ │ │ -0009fb60: 4e6f 726d 616e 2057 616c 7368 2c20 3c6e Norman Walsh, .. │ │ │ -0009fb80: 0a54 6865 2062 6573 7420 7761 7920 746f .The best way to │ │ │ -0009fb90: 2072 6561 6368 206e 6f72 6d20 6973 2062 reach norm is b │ │ │ -0009fba0: 7920 656d 6169 6c2e 2020 596f 7520 7769 y email. You wi │ │ │ -0009fbb0: 6c6c 2066 696e 6420 6164 6469 7469 6f6e ll find addition │ │ │ -0009fbc0: 616c 0a63 6f6e 7461 6374 2069 6e66 6f72 al.contact infor │ │ │ -0009fbd0: 6d61 7469 6f6e 2061 7420 6874 7470 3a2f mation at http:/ │ │ │ -0009fbe0: 2f6e 7761 6c73 682e 636f 6d2f 646f 6362 /nwalsh.com/docb │ │ │ -0009fbf0: 6f6f 6b2f 786d 6c2f 0ab6 0000 001d 6465 ook/xml/......de │ │ │ -0009fc00: 6d6f 2f64 6f63 7372 632f 446f 6342 6f6f mo/docsrc/DocBoo │ │ │ -0009fc10: 6b2f 4368 616e 6765 4c6f 67df 0000 21f8 k/ChangeLog...!. │ │ │ -0009fc20: 3139 3939 2d31 312d 3130 2020 4e6f 726d 1999-11-10 Norm │ │ │ -0009fc30: 616e 2057 616c 7368 2020 3c6e 6477 406e an Walsh ...* C │ │ │ -0009fc50: 4f50 5952 4947 4854 2c20 5245 4144 4d45 OPYRIGHT, README │ │ │ -0009fc60: 2c20 6361 6c73 7462 6c78 2e64 7464 2c20 , calstblx.dtd, │ │ │ -0009fc70: 6462 6365 6e74 782e 6d6f 642c 2064 6267 dbcentx.mod, dbg │ │ │ -0009fc80: 656e 656e 742e 656e 742c 2064 6268 6965 enent.ent, dbhie │ │ │ -0009fc90: 7278 2e6d 6f64 2c20 6462 6e6f 746e 782e rx.mod, dbnotnx. │ │ │ -0009fca0: 6d6f 642c 2064 6270 6f6f 6c78 2e6d 6f64 mod, dbpoolx.mod │ │ │ -0009fcb0: 2c20 646f 6362 6f6f 6b78 2e64 7464 2c20 , docbookx.dtd, │ │ │ -0009fcc0: 7465 7374 2e78 6d6c 3a20 0a09 5570 6461 test.xml: ..Upda │ │ │ -0009fcd0: 7465 6420 7665 7273 696f 6e20 6e75 6d62 ted version numb │ │ │ -0009fce0: 6572 730a 0a09 2a20 5645 5253 494f 4e3a ers...* VERSION: │ │ │ -0009fcf0: 2056 6572 7369 6f6e 2033 2e31 2e37 2072 Version 3.1.7 r │ │ │ -0009fd00: 656c 6561 7365 640a 0a09 2a20 6462 706f eleased...* dbpo │ │ │ -0009fd10: 6f6c 782e 6d6f 643a 2046 696e 616c 6c79 olx.mod: Finally │ │ │ -0009fd20: 2077 726f 7465 2061 2070 726f 6772 616d wrote a program │ │ │ -0009fd30: 2074 6f20 636f 6d70 6172 6520 7468 6520 to compare the │ │ │ -0009fd40: 5347 4d4c 2061 6e64 2058 4d4c 2044 5444 SGML and XML DTD │ │ │ -0009fd50: 732e 204f 6820 6d79 210a 0941 6464 6564 s. Oh my!..Added │ │ │ -0009fd60: 2069 6e66 6f72 6d61 6c66 6967 7572 6520 informalfigure │ │ │ -0009fd70: 746f 2061 206e 756d 6265 7220 6f66 2063 to a number of c │ │ │ -0009fd80: 6f6e 7465 7874 7320 7768 6572 6520 6974 ontexts where it │ │ │ -0009fd90: 2077 6173 206d 6973 7369 6e67 0a09 4368 was missing..Ch │ │ │ -0009fda0: 616e 6765 6420 7468 6520 666f 726d 6174 anged the format │ │ │ -0009fdb0: 2061 7474 7269 6275 7465 206f 6e20 6772 attribute on gr │ │ │ -0009fdc0: 6170 6869 6373 2062 6163 6b20 696e 746f aphics back into │ │ │ -0009fdd0: 2061 206e 6f74 6174 696f 6e20 6c69 7374 a notation list │ │ │ -0009fde0: 0a09 2020 2877 6879 2068 6164 2049 206d .. (why had I m │ │ │ -0009fdf0: 6164 6520 6974 2043 4441 5441 3f29 0a09 ade it CDATA?).. │ │ │ -0009fe00: 5477 6561 6b65 6420 7468 6520 7061 7261 Tweaked the para │ │ │ -0009fe10: 6d65 7465 7269 7a61 7469 6f6e 206f 6620 meterization of │ │ │ -0009fe20: 7461 626c 6520 6174 7472 6962 7574 6573 table attributes │ │ │ -0009fe30: 2c20 7468 6973 2072 6573 746f 7265 7320 , this restores │ │ │ -0009fe40: 7468 6520 2772 6f6c 6527 0a09 2020 6174 the 'role'.. at │ │ │ -0009fe50: 7472 6962 7574 6520 746f 2027 656e 7472 tribute to 'entr │ │ │ -0009fe60: 7927 2c20 2772 6f77 272c 2061 6e64 2070 y', 'row', and p │ │ │ -0009fe70: 6572 6861 7073 2061 2066 6577 206f 7468 erhaps a few oth │ │ │ -0009fe80: 6572 2070 6c61 6365 7320 7768 6572 6520 er places where │ │ │ -0009fe90: 6974 0a09 2020 7761 7320 6d69 7373 696e it.. was missin │ │ │ -0009fea0: 672e 0a09 4164 6465 6420 6a6f 7572 6e61 g...Added journa │ │ │ -0009feb0: 6c2c 2073 6572 6965 732c 2073 6574 2c20 l, series, set, │ │ │ -0009fec0: 616e 6420 6d61 6e75 7363 7269 7074 2061 and manuscript a │ │ │ -0009fed0: 7320 7661 6c75 6573 2066 6f72 2074 6865 s values for the │ │ │ -0009fee0: 2070 7562 776f 726b 0a09 2020 6174 7472 pubwork.. attr │ │ │ -0009fef0: 6962 7574 6520 6f6e 2063 6974 6574 6974 ibute on citetit │ │ │ -0009ff00: 6c65 0a09 5265 6d6f 7665 6420 6578 7472 le..Removed extr │ │ │ -0009ff10: 616e 656f 7573 2027 3f27 2066 726f 6d20 aneous '?' from │ │ │ -0009ff20: 7468 6520 6465 636c 6172 6174 696f 6e20 the declaration │ │ │ -0009ff30: 666f 7220 696e 6465 7874 6572 6d2e 2049 for indexterm. I │ │ │ -0009ff40: 6e64 6578 7465 726d 730a 0920 2061 7265 ndexterms.. are │ │ │ -0009ff50: 206e 6f74 2061 6c6c 6f77 6564 2074 6f20 not allowed to │ │ │ -0009ff60: 6265 2065 6d70 7479 210a 0a31 3939 392d be empty!..1999- │ │ │ -0009ff70: 3130 2d31 3920 204e 6f72 6d61 6e20 5761 10-19 Norman Wa │ │ │ -0009ff80: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* COPYRI │ │ │ -0009ffa0: 4748 542c 2052 4541 444d 452c 2063 616c GHT, README, cal │ │ │ -0009ffb0: 7374 626c 782e 6474 642c 2064 6263 656e stblx.dtd, dbcen │ │ │ -0009ffc0: 7478 2e6d 6f64 2c20 6462 6765 6e65 6e74 tx.mod, dbgenent │ │ │ -0009ffd0: 2e65 6e74 2c20 6462 6869 6572 782e 6d6f .ent, dbhierx.mo │ │ │ -0009ffe0: 642c 2064 626e 6f74 6e78 2e6d 6f64 2c20 d, dbnotnx.mod, │ │ │ -0009fff0: 6462 706f 6f6c 782e 6d6f 642c 2064 6f63 dbpoolx.mod, doc │ │ │ -000a0000: 626f 6f6b 782e 6474 642c 2074 6573 742e bookx.dtd, test. │ │ │ -000a0010: 786d 6c3a 200a 0955 7064 6174 6564 2076 xml: ..Updated v │ │ │ -000a0020: 6572 7369 6f6e 206e 756d 6265 7273 0a0a ersion numbers.. │ │ │ -000a0030: 092a 2056 4552 5349 4f4e 3a20 5665 7273 .* VERSION: Vers │ │ │ -000a0040: 696f 6e20 332e 312e 3620 7265 6c65 6173 ion 3.1.6 releas │ │ │ -000a0050: 6564 0a0a 092a 2064 6268 6965 7278 2e6d ed...* dbhierx.m │ │ │ -000a0060: 6f64 2c20 6462 706f 6f6c 782e 6d6f 643a od, dbpoolx.mod: │ │ │ -000a0070: 2041 6464 6564 206d 6973 7369 6e67 206d Added missing m │ │ │ -000a0080: 6564 6961 6f62 6a65 6374 2f69 6e6c 696e ediaobject/inlin │ │ │ -000a0090: 656d 6564 6961 6f62 6a65 6374 2065 6c65 emediaobject ele │ │ │ -000a00a0: 6d65 6e74 730a 0a09 2a20 736f 6578 7462 ments...* soextb │ │ │ -000a00b0: 6c78 2e64 7464 3a20 4f66 6669 6369 616c lx.dtd: Official │ │ │ -000a00c0: 204f 4153 4953 2074 6162 6c65 206d 6f64 OASIS table mod │ │ │ -000a00d0: 656c 3a20 5452 3939 3031 3a31 3939 390a el: TR9901:1999. │ │ │ -000a00e0: 0a31 3939 392d 3038 2d32 3620 204e 6f72 .1999-08-26 Nor │ │ │ -000a00f0: 6d61 6e20 5761 6c73 6820 203c 6e64 7740 man Walsh ...* │ │ │ -000a0110: 434f 5059 5249 4748 542c 2052 4541 444d COPYRIGHT, READM │ │ │ -000a0120: 452c 2063 616c 7374 626c 782e 6474 642c E, calstblx.dtd, │ │ │ -000a0130: 2064 6263 656e 7478 2e6d 6f64 2c20 6462 dbcentx.mod, db │ │ │ -000a0140: 6765 6e65 6e74 2e65 6e74 2c20 6462 6869 genent.ent, dbhi │ │ │ -000a0150: 6572 782e 6d6f 642c 2064 626e 6f74 6e78 erx.mod, dbnotnx │ │ │ -000a0160: 2e6d 6f64 2c20 6462 706f 6f6c 782e 6d6f .mod, dbpoolx.mo │ │ │ -000a0170: 642c 2064 6f63 626f 6f6b 782e 6474 642c d, docbookx.dtd, │ │ │ -000a0180: 2073 6f65 7874 626c 782e 6474 642c 2074 soextblx.dtd, t │ │ │ -000a0190: 6573 742e 786d 6c3a 200a 0955 7064 6174 est.xml: ..Updat │ │ │ -000a01a0: 6564 2076 6572 7369 6f6e 206e 756d 6265 ed version numbe │ │ │ -000a01b0: 720a 0a09 2a20 5645 5253 494f 4e3a 2056 r...* VERSION: V │ │ │ -000a01c0: 6572 7369 6f6e 2033 2e31 2e35 2072 656c ersion 3.1.5 rel │ │ │ -000a01d0: 6561 7365 640a 0a09 2a20 6462 706f 6f6c eased...* dbpool │ │ │ -000a01e0: 782e 6d6f 643a 2046 6978 6564 2061 206e x.mod: Fixed a n │ │ │ -000a01f0: 756d 6265 7220 6f66 2065 7272 6f6e 656f umber of erroneo │ │ │ -000a0200: 7573 2063 6f6d 6d65 6e74 730a 0941 6464 us comments..Add │ │ │ -000a0210: 6564 2063 6f6e 7374 616e 7420 616e 6420 ed constant and │ │ │ -000a0220: 7661 726e 616d 6520 746f 2074 6563 682e varname to tech. │ │ │ -000a0230: 6368 6172 2e63 6c61 7373 0a09 4368 616e char.class..Chan │ │ │ -000a0240: 6765 6420 2256 6172 4e61 6d65 2220 746f ged "VarName" to │ │ │ -000a0250: 2022 7661 726e 616d 6522 0a09 4368 616e "varname"..Chan │ │ │ -000a0260: 6765 6420 2561 7267 7061 6765 6e75 6d73 ged %argpagenums │ │ │ -000a0270: 2074 6f20 2561 7274 7061 6765 6e75 6d73 to %artpagenums │ │ │ -000a0280: 0a0a 3139 3939 2d30 362d 3034 2020 4e6f ..1999-06-04 No │ │ │ -000a0290: 726d 616e 2057 616c 7368 2020 3c6e 6477 rman Walsh ...* │ │ │ -000a02b0: 2043 4f50 5952 4947 4854 2c20 5245 4144 COPYRIGHT, READ │ │ │ -000a02c0: 4d45 2c20 6361 6c73 7462 6c78 2e64 7464 ME, calstblx.dtd │ │ │ -000a02d0: 2c20 6462 6365 6e74 782e 6d6f 642c 2064 , dbcentx.mod, d │ │ │ -000a02e0: 6267 656e 656e 742e 656e 742c 2064 6268 bgenent.ent, dbh │ │ │ -000a02f0: 6965 7278 2e6d 6f64 2c20 6462 6e6f 746e ierx.mod, dbnotn │ │ │ -000a0300: 782e 6d6f 642c 2064 6270 6f6f 6c78 2e6d x.mod, dbpoolx.m │ │ │ -000a0310: 6f64 2c20 646f 6362 6f6f 6b78 2e64 7464 od, docbookx.dtd │ │ │ -000a0320: 2c20 736f 6578 7462 6c78 2e64 7464 2c20 , soextblx.dtd, │ │ │ -000a0330: 7465 7374 2e78 6d6c 3a20 0a09 5570 6461 test.xml: ..Upda │ │ │ -000a0340: 7465 6420 7665 7273 696f 6e20 6e75 6d62 ted version numb │ │ │ -000a0350: 6572 730a 0a09 2a20 5645 5253 494f 4e3a ers...* VERSION: │ │ │ -000a0360: 2056 6572 7369 6f6e 2033 2e31 2e34 2072 Version 3.1.4 r │ │ │ -000a0370: 656c 6561 7365 640a 0a09 2a20 6462 6869 eleased...* dbhi │ │ │ -000a0380: 6572 782e 6d6f 643a 204d 6164 6520 6172 erx.mod: Made ar │ │ │ -000a0390: 7468 6561 6465 7220 6f70 7469 6f6e 616c theader optional │ │ │ -000a03a0: 0a0a 092a 2064 6270 6f6f 6c78 2e6d 6f64 ...* dbpoolx.mod │ │ │ -000a03b0: 3a20 4669 7820 636f 6d6d 6f6e 2061 7474 : Fix common att │ │ │ -000a03c0: 7269 6275 7465 2070 726f 626c 656d 206f ribute problem o │ │ │ -000a03d0: 6e20 696e 666f 726d 616c 7461 626c 6520 n informaltable │ │ │ -000a03e0: 6120 6469 6666 6572 656e 7420 7761 790a a different way. │ │ │ -000a03f0: 0a09 2a20 6462 706f 6f6c 782e 6d6f 643a ..* dbpoolx.mod: │ │ │ -000a0400: 2054 6865 2063 6f6d 6d6f 6e2e 6174 7472 The common.attr │ │ │ -000a0410: 6962 2050 4520 7761 7320 6d69 7373 696e ib PE was missin │ │ │ -000a0420: 6720 6672 6f6d 2069 6e66 6f72 6d61 6c74 g from informalt │ │ │ -000a0430: 6162 6c65 0a0a 092a 2064 6270 6f6f 6c78 able...* dbpoolx │ │ │ -000a0440: 2e6d 6f64 3a20 5265 666f 726d 756c 6174 .mod: Reformulat │ │ │ -000a0450: 6564 2070 6172 616d 6574 6572 697a 6174 ed parameterizat │ │ │ -000a0460: 696f 6e20 6f66 2074 6162 6c65 2061 7474 ion of table att │ │ │ -000a0470: 7269 6275 7465 7320 2861 6761 696e 2920 ributes (again) │ │ │ -000a0480: 746f 2067 6574 2069 7420 7269 6768 742e to get it right. │ │ │ -000a0490: 0a0a 092a 2064 6274 626c 6361 6c73 2e64 ...* dbtblcals.d │ │ │ -000a04a0: 7464 2c20 6462 7462 6c78 6368 672e 6474 td, dbtblxchg.dt │ │ │ -000a04b0: 642c 2074 626c 6361 6c73 2e78 6d6c 2c20 d, tblcals.xml, │ │ │ -000a04c0: 7462 6c78 6368 672e 786d 6c3a 200a 094e tblxchg.xml: ..N │ │ │ -000a04d0: 6577 2066 696c 652e 0a0a 3139 3939 2d30 ew file...1999-0 │ │ │ -000a04e0: 332d 3331 2020 4e6f 726d 616e 2057 616c 3-31 Norman Wal │ │ │ -000a04f0: 7368 2020 3c6e 6477 406e 7761 6c73 682e sh ...* COPYRIG │ │ │ -000a0510: 4854 2c20 5245 4144 4d45 2c20 6361 6c73 HT, README, cals │ │ │ -000a0520: 7462 6c78 2e64 7464 2c20 6462 6365 6e74 tblx.dtd, dbcent │ │ │ -000a0530: 782e 6d6f 642c 2064 6267 656e 656e 742e x.mod, dbgenent. │ │ │ -000a0540: 656e 742c 2064 6268 6965 7278 2e6d 6f64 ent, dbhierx.mod │ │ │ -000a0550: 2c20 6462 6e6f 746e 782e 6d6f 642c 2064 , dbnotnx.mod, d │ │ │ -000a0560: 6270 6f6f 6c78 2e6d 6f64 2c20 646f 6362 bpoolx.mod, docb │ │ │ -000a0570: 6f6f 6b78 2e64 7464 2c20 736f 6578 7462 ookx.dtd, soextb │ │ │ -000a0580: 6c78 2e64 7464 2c20 7465 7374 2e78 6d6c lx.dtd, test.xml │ │ │ -000a0590: 3a20 0a09 4368 616e 6765 6420 7665 7273 : ..Changed vers │ │ │ -000a05a0: 696f 6e20 6e75 6d62 6572 2074 6f20 332e ion number to 3. │ │ │ -000a05b0: 312e 330a 0a09 2a20 5645 5253 494f 4e3a 1.3...* VERSION: │ │ │ -000a05c0: 2056 6572 7369 6f6e 2033 2e31 2e33 2072 Version 3.1.3 r │ │ │ -000a05d0: 656c 6561 7365 640a 0a09 2a20 6462 6869 eleased...* dbhi │ │ │ -000a05e0: 6572 782e 6d6f 642c 2064 6270 6f6f 6c78 erx.mod, dbpoolx │ │ │ -000a05f0: 2e6d 6f64 2c20 646f 6362 6f6f 6b78 2e64 .mod, docbookx.d │ │ │ -000a0600: 7464 3a20 4164 6465 6420 7061 7261 6d2e td: Added param. │ │ │ -000a0610: 2065 6e74 2e20 6465 636c 732e 2074 6f20 ent. decls. to │ │ │ -000a0620: 6d61 6b65 2049 4535 2068 6170 7079 2e0a make IE5 happy.. │ │ │ -000a0630: 0a31 3939 392d 3033 2d31 3920 204e 6f72 .1999-03-19 Nor │ │ │ -000a0640: 6d61 6e20 5761 6c73 6820 203c 6e64 7740 man Walsh ...* │ │ │ -000a0660: 434f 5059 5249 4748 542c 2052 4541 444d COPYRIGHT, READM │ │ │ -000a0670: 452c 2063 616c 7374 626c 782e 6474 642c E, calstblx.dtd, │ │ │ -000a0680: 2064 6263 656e 7478 2e6d 6f64 2c20 6462 dbcentx.mod, db │ │ │ -000a0690: 6765 6e65 6e74 2e65 6e74 2c20 6462 6869 genent.ent, dbhi │ │ │ -000a06a0: 6572 782e 6d6f 642c 2064 626e 6f74 6e78 erx.mod, dbnotnx │ │ │ -000a06b0: 2e6d 6f64 2c20 6462 706f 6f6c 782e 6d6f .mod, dbpoolx.mo │ │ │ -000a06c0: 642c 2064 6f63 626f 6f6b 782e 6474 642c d, docbookx.dtd, │ │ │ -000a06d0: 2073 6f65 7874 626c 782e 6474 642c 2074 soextblx.dtd, t │ │ │ -000a06e0: 6573 742e 786d 6c3a 200a 0955 7064 6174 est.xml: ..Updat │ │ │ -000a06f0: 6564 2076 6572 7369 6f6e 206e 756d 6265 ed version numbe │ │ │ -000a0700: 7220 746f 2033 2e31 2e32 0a0a 092a 2056 r to 3.1.2...* V │ │ │ -000a0710: 4552 5349 4f4e 3a20 5665 7273 696f 6e20 ERSION: Version │ │ │ -000a0720: 332e 312e 3220 7265 6c65 6173 6564 0a0a 3.1.2 released.. │ │ │ -000a0730: 092a 2064 6270 6f6f 6c78 2e6d 6f64 3a20 .* dbpoolx.mod: │ │ │ -000a0740: 4368 616e 6765 6420 6d79 206d 696e 642c Changed my mind, │ │ │ -000a0750: 2043 414c 5320 6861 7320 746f 2062 6520 CALS has to be │ │ │ -000a0760: 7468 6520 6465 6661 756c 7420 7461 626c the default tabl │ │ │ -000a0770: 6520 6d6f 6465 6c0a 0a31 3939 392d 3033 e model..1999-03 │ │ │ -000a0780: 2d31 3720 204e 6f72 6d61 6e20 5761 6c73 -17 Norman Wals │ │ │ -000a0790: 6820 203c 6e64 7740 6e77 616c 7368 2e63 h ...* README: │ │ │ -000a07b0: 5570 6461 7465 6420 6d61 6e69 6665 7374 Updated manifest │ │ │ -000a07c0: 0a0a 092a 2056 4552 5349 4f4e 3a20 5665 ...* VERSION: Ve │ │ │ -000a07d0: 7273 696f 6e20 332e 312e 3120 7265 6c65 rsion 3.1.1 rele │ │ │ -000a07e0: 6173 6564 0a09 0a09 5468 6973 2072 656c ased....This rel │ │ │ -000a07f0: 6561 7365 2069 6e74 726f 6475 6365 7320 ease introduces │ │ │ -000a0800: 7365 7665 7261 6c20 7369 676e 6966 6963 several signific │ │ │ -000a0810: 616e 7420 6368 616e 6765 733a 0a09 0a09 ant changes:.... │ │ │ -000a0820: 2d20 416e 2058 4d4c 2076 6572 7369 6f6e - An XML version │ │ │ -000a0830: 206f 6620 7468 6520 4f41 5349 5320 4578 of the OASIS Ex │ │ │ -000a0840: 6368 616e 6765 2054 6162 6c65 204d 6f64 change Table Mod │ │ │ -000a0850: 656c 0a09 2020 6973 2075 7365 6420 696e el.. is used in │ │ │ -000a0860: 2066 6176 6f72 206f 6620 7468 6520 6675 favor of the fu │ │ │ -000a0870: 6c6c 2043 414c 5320 6d6f 6465 6c2e 2054 ll CALS model. T │ │ │ -000a0880: 6869 7320 6361 6e0a 0920 2062 6520 2274 his can.. be "t │ │ │ -000a0890: 6f67 676c 6564 2220 6261 636b 2077 6974 oggled" back wit │ │ │ -000a08a0: 6820 6120 7369 6e67 6c65 2070 6172 616d h a single param │ │ │ -000a08b0: 6574 6572 2065 6e74 6974 790a 0920 2063 eter entity.. c │ │ │ -000a08c0: 6861 6e67 650a 090a 092d 2054 6865 2076 hange....- The v │ │ │ -000a08d0: 6572 7369 6f6e 206e 756d 6265 7220 6861 ersion number ha │ │ │ -000a08e0: 7320 6368 616e 6765 6420 6472 616d 6174 s changed dramat │ │ │ -000a08f0: 6963 616c 6c79 2074 6f20 6d61 6b65 0a09 ically to make.. │ │ │ -000a0900: 2020 6974 2063 6c65 6172 2074 6861 7420 it clear that │ │ │ -000a0910: 6974 2074 7261 636b 7320 332e 312e 2020 it tracks 3.1. │ │ │ -000a0920: 2856 6572 7369 6f6e 2031 2e33 206f 6620 (Version 1.3 of │ │ │ -000a0930: 7468 650a 0920 2058 4d4c 2076 6572 7369 the.. XML versi │ │ │ -000a0940: 6f6e 206f 6620 446f 6342 6f6f 6b20 332e on of DocBook 3. │ │ │ -000a0950: 3120 7761 7320 6a75 7374 2074 6f6f 2063 1 was just too c │ │ │ -000a0960: 6f6e 6675 7369 6e67 2129 0a09 0a09 2d20 onfusing!)....- │ │ │ -000a0970: 4920 6164 6465 6420 7061 7261 6d65 7465 I added paramete │ │ │ -000a0980: 7220 656e 7469 7469 6573 2074 6f20 696e r entities to in │ │ │ -000a0990: 636c 7564 652f 6578 636c 7564 6520 7468 clude/exclude th │ │ │ -000a09a0: 650a 0920 2064 6263 656e 7478 2e6d 6f64 e.. dbcentx.mod │ │ │ -000a09b0: 2061 6e64 2064 626e 6f74 6e78 2e6d 6f64 and dbnotnx.mod │ │ │ -000a09c0: 206d 6f64 756c 6573 2061 6c6c 2061 7420 modules all at │ │ │ -000a09d0: 6f6e 6365 0a09 0a09 2d20 4669 7865 6420 once....- Fixed │ │ │ -000a09e0: 6120 6665 7720 736d 616c 6c20 636f 6e74 a few small cont │ │ │ -000a09f0: 656e 7420 6d6f 6465 6c20 6275 6773 0a0a ent model bugs.. │ │ │ -000a0a00: 092a 2064 6f63 626f 6f6b 782e 6474 643a .* docbookx.dtd: │ │ │ -000a0a10: 2041 6464 6564 206d 6172 6b65 6420 7365 Added marked se │ │ │ -000a0a20: 6374 696f 6e73 2061 726f 756e 6420 6462 ctions around db │ │ │ -000a0a30: 6e6f 746e 2061 6e64 2064 6263 656e 7420 notn and dbcent │ │ │ -000a0a40: 6d6f 6475 6c65 730a 0a31 3939 392d 3033 modules..1999-03 │ │ │ -000a0a50: 2d31 3620 204e 6f72 6d61 6e20 5761 6c73 -16 Norman Wals │ │ │ -000a0a60: 6820 203c 6e64 7740 6e77 616c 7368 2e63 h ...* dbpoolx. │ │ │ -000a0a80: 6d6f 643a 2049 6e20 7468 6520 584d 4c20 mod: In the XML │ │ │ -000a0a90: 6578 6368 616e 6765 2074 6162 6c65 206d exchange table m │ │ │ -000a0aa0: 6f64 656c 2063 6173 652c 2074 6865 2061 odel case, the a │ │ │ -000a0ab0: 7474 6c69 7374 2066 6f72 2069 6e66 6f72 ttlist for infor │ │ │ -000a0ac0: 6d61 6c74 6162 6c65 2077 6173 2077 726f maltable was wro │ │ │ -000a0ad0: 6e67 0a0a 3139 3939 2d30 332d 3131 2020 ng..1999-03-11 │ │ │ -000a0ae0: 4e6f 726d 616e 2057 616c 7368 2020 3c6e Norman Walsh .. │ │ │ -000a0b00: 092a 2063 616c 7374 626c 782e 6474 643a .* calstblx.dtd: │ │ │ -000a0b10: 2052 656d 6f76 6564 2075 6e75 7365 6420 Removed unused │ │ │ -000a0b20: 5045 730a 0a09 2a20 6462 706f 6f6c 782e PEs...* dbpoolx. │ │ │ -000a0b30: 6d6f 643a 2041 6464 6564 2073 7769 7463 mod: Added switc │ │ │ -000a0b40: 6820 666f 7220 6578 6368 616e 6765 206f h for exchange o │ │ │ -000a0b50: 7220 4341 4c53 2074 6162 6c65 206d 6f64 r CALS table mod │ │ │ -000a0b60: 656c 3b20 6d61 6465 2065 7863 6861 6e67 el; made exchang │ │ │ -000a0b70: 6520 7468 6520 6465 6661 756c 740a 0a09 e the default... │ │ │ -000a0b80: 2a20 736f 6578 7462 6c78 2e64 7464 3a20 * soextblx.dtd: │ │ │ -000a0b90: 4e65 7720 6669 6c65 2e0a 0a31 3939 392d New file...1999- │ │ │ -000a0ba0: 3033 2d30 3620 204e 6f72 6d61 6e20 5761 03-06 Norman Wa │ │ │ -000a0bb0: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* COPYRI │ │ │ -000a0bd0: 4748 542c 2052 4541 444d 452c 2063 616c GHT, README, cal │ │ │ -000a0be0: 7374 626c 782e 6474 642c 2064 6267 656e stblx.dtd, dbgen │ │ │ -000a0bf0: 656e 742e 656e 742c 2064 6f63 626f 6f6b ent.ent, docbook │ │ │ -000a0c00: 782e 6474 643a 200a 0943 6861 6e67 6564 x.dtd: ..Changed │ │ │ -000a0c10: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ -000a0c20: 746f 2033 2e31 2e31 0a0a 092a 2063 6861 to 3.1.1...* cha │ │ │ -000a0c30: 6e67 6573 3a20 5265 706c 6163 6564 2062 nges: Replaced b │ │ │ -000a0c40: 7920 4368 616e 6765 4c6f 670a 0a09 2a20 y ChangeLog...* │ │ │ -000a0c50: 6462 3378 6d6c 2e64 7464 2c20 646f 6362 db3xml.dtd, docb │ │ │ -000a0c60: 6f6f 6b78 2e64 7464 3a20 5265 6e61 6d65 ookx.dtd: Rename │ │ │ -000a0c70: 6420 6462 3378 6d6c 2e64 7464 2074 6f20 d db3xml.dtd to │ │ │ -000a0c80: 646f 6362 6f6f 6b78 2e64 7464 0a0a 092a docbookx.dtd...* │ │ │ -000a0c90: 2064 6263 656e 7478 2e6d 6f64 3a20 4669 dbcentx.mod: Fi │ │ │ -000a0ca0: 7865 6420 6272 6f6b 656e 2070 7562 6c69 xed broken publi │ │ │ -000a0cb0: 6320 6964 656e 7469 6669 6572 732e 2043 c identifiers. C │ │ │ -000a0cc0: 6861 6e67 6564 2076 6572 7369 6f6e 206e hanged version n │ │ │ -000a0cd0: 756d 6265 7220 746f 2033 2e31 2e31 0a0a umber to 3.1.1.. │ │ │ -000a0ce0: 092a 2064 6268 6965 7278 2e6d 6f64 3a20 .* dbhierx.mod: │ │ │ -000a0cf0: 4669 7865 6420 6275 673a 2061 6464 6564 Fixed bug: added │ │ │ -000a0d00: 2073 6563 7469 6f6e 2074 6f20 2562 6f6f section to %boo │ │ │ -000a0d10: 6b63 6f6d 706f 6e65 6e74 2e63 6f6e 7465 kcomponent.conte │ │ │ -000a0d20: 6e74 3b0a 0943 6861 6e67 6564 2076 6572 nt;..Changed ver │ │ │ -000a0d30: 7369 6f6e 206e 756d 6265 7220 746f 2033 sion number to 3 │ │ │ -000a0d40: 2e31 2e31 2e0a 0a09 2a20 6462 6e6f 746e .1.1....* dbnotn │ │ │ -000a0d50: 782e 6d6f 643a 2043 6861 6e67 6564 2074 x.mod: Changed t │ │ │ -000a0d60: 6865 2050 5542 4c49 4320 6964 656e 7469 he PUBLIC identi │ │ │ -000a0d70: 6669 6572 7320 7468 6174 2077 6572 6520 fiers that were │ │ │ -000a0d80: 6a75 7374 2061 2073 696e 676c 6520 776f just a single wo │ │ │ -000a0d90: 7264 2028 6c69 6b65 0a09 2244 4954 524f rd (like.."DITRO │ │ │ -000a0da0: 4646 2229 2062 6163 6b20 696e 746f 2053 FF") back into S │ │ │ -000a0db0: 5953 5445 4d20 6964 656e 7469 6669 6572 YSTEM identifier │ │ │ -000a0dc0: 732e 2020 4920 646f 6e27 7420 6b6e 6f77 s. I don't know │ │ │ -000a0dd0: 2077 6879 2049 206d 6164 650a 0974 6865 why I made..the │ │ │ -000a0de0: 2050 5542 4c49 4320 696e 2074 6865 2066 PUBLIC in the f │ │ │ -000a0df0: 6972 7374 2070 6c61 6365 2e0a 0943 6861 irst place...Cha │ │ │ -000a0e00: 6e67 6564 2076 6572 7369 6f6e 206e 756d nged version num │ │ │ -000a0e10: 6265 7220 746f 2033 2e31 2e31 0a0a 092a ber to 3.1.1...* │ │ │ -000a0e20: 2064 6270 6f6f 6c78 2e6d 6f64 3a20 4669 dbpoolx.mod: Fi │ │ │ -000a0e30: 7865 6420 6275 673a 2061 6464 6564 2071 xed bug: added q │ │ │ -000a0e40: 616e 6461 7365 7420 746f 2025 636f 6d70 andaset to %comp │ │ │ -000a0e50: 6f75 6e64 2e63 6c61 7373 3b0a 0946 6978 ound.class;..Fix │ │ │ -000a0e60: 6564 2062 7567 3a20 6164 6465 6420 6369 ed bug: added ci │ │ │ -000a0e70: 7465 7469 746c 6520 746f 2025 6269 626c tetitle to %bibl │ │ │ -000a0e80: 696f 636f 6d70 6f6e 656e 742e 6d69 783b iocomponent.mix; │ │ │ -000a0e90: 0a09 4368 616e 6765 6420 7665 7273 696f ..Changed versio │ │ │ -000a0ea0: 6e20 746f 2033 2e31 2e31 0a0a 092a 2074 n to 3.1.1...* t │ │ │ -000a0eb0: 6573 742e 786d 6c3a 2043 6861 6e67 6564 est.xml: Changed │ │ │ -000a0ec0: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ -000a0ed0: 746f 2033 2e31 2e31 3b20 6368 616e 6765 to 3.1.1; change │ │ │ -000a0ee0: 6420 7379 7374 656d 2069 6465 6e74 6966 d system identif │ │ │ -000a0ef0: 6965 720a 0a31 3939 392d 3031 2d33 3120 ier..1999-01-31 │ │ │ -000a0f00: 204e 6f72 6d61 6e20 5761 6c73 6820 203c Norman Walsh < │ │ │ -000a0f10: 6e64 7740 6e77 616c 7368 2e63 6f6d 3e0a ndw@nwalsh.com>. │ │ │ -000a0f20: 0a09 2a20 434f 5059 5249 4748 542c 2052 ..* COPYRIGHT, R │ │ │ -000a0f30: 4541 444d 452c 2063 616c 7374 626c 782e EADME, calstblx. │ │ │ -000a0f40: 6474 642c 2064 6233 786d 6c2e 6474 642c dtd, db3xml.dtd, │ │ │ -000a0f50: 2064 6263 656e 7478 2e6d 6f64 2c20 6462 dbcentx.mod, db │ │ │ -000a0f60: 6765 6e65 6e74 2e65 6e74 2c20 6462 6869 genent.ent, dbhi │ │ │ -000a0f70: 6572 782e 6d6f 642c 2064 626e 6f74 6e78 erx.mod, dbnotnx │ │ │ -000a0f80: 2e6d 6f64 2c20 6462 706f 6f6c 782e 6d6f .mod, dbpoolx.mo │ │ │ -000a0f90: 642c 2074 6573 742e 786d 6c3a 200a 0943 d, test.xml: ..C │ │ │ -000a0fa0: 6f6e 7665 7274 6564 2076 6572 7369 6f6e onverted version │ │ │ -000a0fb0: 2074 6f20 312e 330a 0a09 2a20 5645 5253 to 1.3...* VERS │ │ │ -000a0fc0: 494f 4e3a 2056 6572 7369 6f6e 2031 2e33 ION: Version 1.3 │ │ │ -000a0fd0: 2072 656c 6561 7365 642e 0a09 4261 7365 released...Base │ │ │ -000a0fe0: 6420 6f6e 2044 6f63 426f 6f6b 2033 2e31 d on DocBook 3.1 │ │ │ -000a0ff0: 2e0a 0950 7562 6c69 6320 6964 656e 7469 ...Public identi │ │ │ -000a1000: 6669 6572 7320 6e6f 7720 636f 6e74 6169 fiers now contai │ │ │ -000a1010: 6e20 7468 6520 7374 7269 6e67 2022 446f n the string "Do │ │ │ -000a1020: 6342 6b20 584d 4c22 2069 6e73 7465 6164 cBk XML" instead │ │ │ -000a1030: 206f 660a 096a 7573 7420 2244 6f63 426b of..just "DocBk │ │ │ -000a1040: 3330 2058 4d4c 222e 0a0a 092a 2064 6233 30 XML"....* db3 │ │ │ -000a1050: 786d 6c2e 6474 643a 2041 6464 6564 2064 xml.dtd: Added d │ │ │ -000a1060: 626e 6f74 6e78 2e6d 6f64 3b20 6164 6465 bnotnx.mod; adde │ │ │ -000a1070: 6420 6e6f 7461 7469 6f6e 7320 6261 636b d notations back │ │ │ -000a1080: 2069 6e74 6f20 7468 6520 4454 442e 2020 into the DTD. │ │ │ -000a1090: 4e6f 7461 7469 6f6e 7320 646f 6e27 740a Notations don't. │ │ │ -000a10a0: 0972 6571 7569 7265 2073 7973 7465 6d20 .require system │ │ │ -000a10b0: 6964 656e 7469 6669 6572 732c 2073 6f20 identifiers, so │ │ │ -000a10c0: 7468 6520 7075 626c 6963 2049 4473 2077 the public IDs w │ │ │ -000a10d0: 696c 6c20 6265 206a 7573 7420 6669 6e65 ill be just fine │ │ │ -000a10e0: 2e0a 090a 094d 6f76 6564 2049 534f 2063 .....Moved ISO c │ │ │ -000a10f0: 6861 7261 6374 6572 2065 6e74 6974 7920 haracter entity │ │ │ -000a1100: 6465 636c 6172 6174 696f 6e73 2069 6e74 declarations int │ │ │ -000a1110: 6f20 6462 6365 6e74 782e 6d6f 642e 2020 o dbcentx.mod. │ │ │ -000a1120: 4164 6465 640a 0955 6e69 636f 6465 2076 Added..Unicode v │ │ │ -000a1130: 6572 7369 6f6e 7320 6f66 2074 6865 2065 ersions of the e │ │ │ -000a1140: 6e74 6974 7920 7365 7473 2074 6f20 7468 ntity sets to th │ │ │ -000a1150: 6520 6469 7374 7269 6275 7469 6f6e 2e0a e distribution.. │ │ │ -000a1160: 0a09 2a20 6462 6365 6e74 782e 6d6f 642c ..* dbcentx.mod, │ │ │ -000a1170: 2064 626e 6f74 6e78 2e6d 6f64 3a20 4e65 dbnotnx.mod: Ne │ │ │ -000a1180: 7720 6669 6c65 2e0a 0a09 2a20 6462 6869 w file....* dbhi │ │ │ -000a1190: 6572 782e 6d6f 643a 2043 6f6e 7665 7274 erx.mod: Convert │ │ │ -000a11a0: 6564 2074 6f20 446f 6342 6f6f 6b20 332e ed to DocBook 3. │ │ │ -000a11b0: 313a 0a09 0a09 2d20 4164 6420 2766 6171 1:....- Add 'faq │ │ │ -000a11c0: 2720 6173 2061 2063 6c61 7373 2076 616c ' as a class val │ │ │ -000a11d0: 7565 2074 6f20 4172 7469 636c 650a 092d ue to Article..- │ │ │ -000a11e0: 2043 6c65 616e 6564 2075 702c 2061 6e64 Cleaned up, and │ │ │ -000a11f0: 2073 6967 6e69 6669 6361 6e74 6c79 206c significantly l │ │ │ -000a1200: 6f6f 7365 6e65 642c 2074 6865 2063 6f6e oosened, the con │ │ │ -000a1210: 7465 6e74 206d 6f64 656c 206f 6620 426f tent model of Bo │ │ │ -000a1220: 6f6b 2e0a 092d 2041 6464 6564 2043 6f6c ok...- Added Col │ │ │ -000a1230: 6f70 686f 6e20 746f 2042 6f6f 6b2e 0a09 ophon to Book... │ │ │ -000a1240: 2d20 4164 6420 4c69 6e6b 456e 6420 746f - Add LinkEnd to │ │ │ -000a1250: 204c 6f54 456e 7472 792e 0a09 2d20 5365 LoTEntry...- Se │ │ │ -000a1260: 7473 2061 7265 206e 6f20 6c6f 6e67 6572 ts are no longer │ │ │ -000a1270: 2072 6571 7569 7265 6420 746f 2063 6f6e required to con │ │ │ -000a1280: 7461 696e 2061 7420 6c65 6173 7420 7477 tain at least tw │ │ │ -000a1290: 6f20 626f 6f6b 732e 0a09 2d20 4164 6465 o books...- Adde │ │ │ -000a12a0: 6420 7265 6375 7273 6976 6520 4469 7669 d recursive Divi │ │ │ -000a12b0: 7369 6f6e 732e 0a09 2d20 4164 6465 6420 sions...- Added │ │ │ -000a12c0: 5375 6274 6974 6c65 2074 6f20 6469 7669 Subtitle to divi │ │ │ -000a12d0: 7369 6f6e 7320 2853 6574 2c20 426f 6f6b sions (Set, Book │ │ │ -000a12e0: 2c20 6574 632e 292c 2063 6f6d 706f 6e65 , etc.), compone │ │ │ -000a12f0: 6e74 732c 2061 6e64 0a09 2020 7365 6374 nts, and.. sect │ │ │ -000a1300: 696f 6e73 2e20 2049 7420 6d61 7920 6f63 ions. It may oc │ │ │ -000a1310: 6375 7220 6f75 7473 6964 6520 6f66 202a cur outside of * │ │ │ -000a1320: 496e 666f 2065 6c65 6d65 6e74 732e 0a09 Info elements... │ │ │ -000a1330: 2d20 4164 6465 6420 5469 746c 652c 2054 - Added Title, T │ │ │ -000a1340: 6974 6c65 4162 6272 6576 2c20 616e 6420 itleAbbrev, and │ │ │ -000a1350: 5375 6254 6974 6c65 206f 7574 7369 6465 SubTitle outside │ │ │ -000a1360: 2041 7274 4865 6164 6572 3b20 4172 7448 ArtHeader; ArtH │ │ │ -000a1370: 6561 6465 720a 0920 2069 7320 6e6f 7720 eader.. is now │ │ │ -000a1380: 6f70 7469 6f6e 616c 2e0a 092d 2050 6172 optional...- Par │ │ │ -000a1390: 616d 6574 6572 697a 6564 2065 6c65 6d65 ameterized eleme │ │ │ -000a13a0: 6e74 2061 6e64 2061 7474 7269 6275 7465 nt and attribute │ │ │ -000a13b0: 2064 6563 6c61 7261 7469 6f6e 7320 7365 declarations se │ │ │ -000a13c0: 7061 7261 7465 6c79 2e0a 0a09 2a20 6462 parately....* db │ │ │ -000a13d0: 706f 6f6c 782e 6d6f 643a 2043 6f6e 7665 poolx.mod: Conve │ │ │ -000a13e0: 7274 6564 2074 6f20 446f 6342 6f6f 6b20 rted to DocBook │ │ │ -000a13f0: 332e 313a 0a09 0a09 2d20 4164 6465 6420 3.1:....- Added │ │ │ -000a1400: 6f70 7469 6f6e 616c 2074 6974 6c65 2074 optional title t │ │ │ -000a1410: 6f20 4d73 6753 6574 0a09 2d20 4164 6465 o MsgSet..- Adde │ │ │ -000a1420: 6420 696e 6c69 6e65 2043 6f6e 7374 616e d inline Constan │ │ │ -000a1430: 7420 666f 7220 6d61 726b 696e 6720 7570 t for marking up │ │ │ -000a1440: 2063 6f6e 7374 616e 7473 2061 6e64 206c constants and l │ │ │ -000a1450: 696d 6974 730a 092d 2041 6464 6564 2069 imits..- Added i │ │ │ -000a1460: 6e6c 696e 6520 5661 724e 616d 6520 666f nline VarName fo │ │ │ -000a1470: 7220 6d61 726b 696e 6720 7570 2076 6172 r marking up var │ │ │ -000a1480: 6961 626c 6520 6e61 6d65 730a 092d 2041 iable names..- A │ │ │ -000a1490: 6464 6564 2073 6576 6572 616c 2065 6c65 dded several ele │ │ │ -000a14a0: 6d65 6e74 7320 746f 2074 6865 2063 6f6e ments to the con │ │ │ -000a14b0: 7465 6e74 206d 6f64 656c 206f 6620 4172 tent model of Ar │ │ │ -000a14c0: 7448 6561 6465 7220 7468 6174 2077 6572 tHeader that wer │ │ │ -000a14d0: 650a 0920 2061 6363 6964 656e 7461 6c6c e.. accidentall │ │ │ -000a14e0: 7920 6c65 6674 206f 7574 2069 6e20 332e y left out in 3. │ │ │ -000a14f0: 303a 2047 7261 7068 6963 2c20 4c65 6761 0: Graphic, Lega │ │ │ -000a1500: 6c4e 6f74 6963 652c 204d 6f64 6553 7065 lNotice, ModeSpe │ │ │ -000a1510: 632c 0a09 2020 5375 626a 6563 7453 6574 c,.. SubjectSet │ │ │ -000a1520: 2c20 4b65 7977 6f72 6453 6574 2c20 616e , KeywordSet, an │ │ │ -000a1530: 6420 4954 6572 6d53 6574 2e0a 092d 2041 d ITermSet...- A │ │ │ -000a1540: 6464 6564 2070 6167 6577 6964 6520 6174 dded pagewide at │ │ │ -000a1550: 7472 6962 7574 6520 746f 2046 6967 7572 tribute to Figur │ │ │ -000a1560: 652c 2061 6464 6564 2049 6e66 6f72 6d61 e, added Informa │ │ │ -000a1570: 6c46 6967 7572 650a 092d 2041 6464 6564 lFigure..- Added │ │ │ -000a1580: 2070 6572 736f 6e20 6e61 6d65 2065 6c65 person name ele │ │ │ -000a1590: 6d65 6e74 7320 746f 2041 6464 7265 7373 ments to Address │ │ │ -000a15a0: 2e0a 092d 2041 6464 6564 2043 6c61 7373 ...- Added Class │ │ │ -000a15b0: 2061 7474 7269 6275 7465 2074 6f20 4c69 attribute to Li │ │ │ -000a15c0: 7465 7261 6c4c 6179 6f75 7420 696e 6469 teralLayout indi │ │ │ -000a15d0: 6361 7469 6e67 204d 6f6e 6f73 7061 6365 cating Monospace │ │ │ -000a15e0: 6420 6f72 0a09 2020 4e6f 726d 616c 2066 d or.. Normal f │ │ │ -000a15f0: 6f6e 742e 0a09 2d20 4164 6465 6420 554c ont...- Added UL │ │ │ -000a1600: 696e 6b20 746f 2064 6f63 696e 666f 2e63 ink to docinfo.c │ │ │ -000a1610: 6861 722e 6d69 782e 0a09 2d20 4164 6465 har.mix...- Adde │ │ │ -000a1620: 6420 5265 7648 6973 746f 7279 2074 6f20 d RevHistory to │ │ │ -000a1630: 476c 6f73 7345 6e74 7279 2e0a 092d 2041 GlossEntry...- A │ │ │ -000a1640: 6464 6564 2043 6d64 4c65 6e67 7468 2061 dded CmdLength a │ │ │ -000a1650: 7474 7269 6275 7465 2074 6f20 436d 6453 ttribute to CmdS │ │ │ -000a1660: 796e 6f70 7369 7320 746f 2069 6e64 6963 ynopsis to indic │ │ │ -000a1670: 6174 6520 436f 6d6d 616e 6420 6c65 6e67 ate Command leng │ │ │ -000a1680: 7468 0a09 2d20 4164 6465 6420 5141 6e64 th..- Added QAnd │ │ │ -000a1690: 4153 6574 2c20 4d65 6469 614f 626a 6563 ASet, MediaObjec │ │ │ -000a16a0: 742c 2061 6e64 2049 6e6c 696e 654d 6564 t, and InlineMed │ │ │ -000a16b0: 6961 4f62 6a65 6374 2e0a 092d 2050 6172 iaObject...- Par │ │ │ -000a16c0: 616d 6574 6572 697a 6564 2065 6c65 6d65 ameterized eleme │ │ │ -000a16d0: 6e74 2061 6e64 2061 7474 7269 6275 7465 nt and attribute │ │ │ -000a16e0: 2064 6563 6c61 7261 7469 6f6e 7320 7365 declarations se │ │ │ -000a16f0: 7061 7261 7465 6c79 2e0a 0a31 3939 392d parately...1999- │ │ │ -000a1700: 3031 2d33 3020 204e 6f72 6d61 6e20 5761 01-30 Norman Wa │ │ │ -000a1710: 6c73 6820 203c 6e64 7740 6e77 616c 7368 lsh ...* COPYRI │ │ │ -000a1730: 4748 543a 204d 6f76 6564 2069 6e73 7461 GHT: Moved insta │ │ │ -000a1740: 6c6c 2069 6e66 6f20 746f 2052 4541 444d ll info to READM │ │ │ -000a1750: 452c 2075 7064 6174 6564 2079 6561 7220 E, updated year │ │ │ -000a1760: 2620 5552 4c0a 0a09 2a20 5245 4144 4d45 & URL...* README │ │ │ -000a1770: 3a20 4368 616e 6765 6420 7665 7273 696f : Changed versio │ │ │ -000a1780: 6e2c 2061 6464 6564 206d 616e 6966 6573 n, added manifes │ │ │ -000a1790: 7420 616e 6420 696e 7374 616c 6c61 7469 t and installati │ │ │ -000a17a0: 6f6e 2069 6e73 7472 7563 7469 6f6e 732c on instructions, │ │ │ -000a17b0: 2075 7064 6174 6564 2079 6561 720a 0a09 updated year... │ │ │ -000a17c0: 2a20 5645 5253 494f 4e3a 2055 7064 6174 * VERSION: Updat │ │ │ -000a17d0: 6564 2076 6572 7369 6f6e 0a0a 092a 2063 ed version...* c │ │ │ -000a17e0: 616c 7374 626c 782e 6474 643a 2043 6861 alstblx.dtd: Cha │ │ │ -000a17f0: 6e67 6564 2076 6572 7369 6f6e 206e 756d nged version num │ │ │ -000a1800: 6265 720a 0a09 2a20 6462 3378 6d6c 2e64 ber...* db3xml.d │ │ │ -000a1810: 7464 2c20 6462 6765 6e65 6e74 2e65 6e74 td, dbgenent.ent │ │ │ -000a1820: 2c20 6462 6869 6572 782e 6d6f 642c 2064 , dbhierx.mod, d │ │ │ -000a1830: 6270 6f6f 6c78 2e6d 6f64 3a20 4368 616e bpoolx.mod: Chan │ │ │ -000a1840: 6765 6420 7665 7273 696f 6e0a 0a09 2a20 ged version...* │ │ │ -000a1850: 7465 7374 2e78 6d6c 3a20 4164 6465 6420 test.xml: Added │ │ │ -000a1860: 676c 6f73 7361 7279 2074 6573 742c 2066 glossary test, f │ │ │ -000a1870: 6978 6564 2069 6e64 6578 7465 726d 2065 ixed indexterm e │ │ │ -000a1880: 7861 6d70 6c65 0a0a 3139 3939 2d30 312d xample..1999-01- │ │ │ -000a1890: 3133 2020 4e6f 726d 616e 2057 616c 7368 13 Norman Walsh │ │ │ -000a18a0: 2020 3c6e 6477 406e 7761 6c73 682e 636f ...* dbhierx.m │ │ │ -000a18c0: 6f64 3a20 4164 6465 6420 696e 6465 7874 od: Added indext │ │ │ -000a18d0: 6572 6d73 2074 6f20 5265 6645 6e74 7279 erms to RefEntry │ │ │ -000a18e0: 2061 6e64 2052 6566 4d65 7461 0a0a 092a and RefMeta...* │ │ │ -000a18f0: 2064 6270 6f6f 6c78 2e6d 6f64 3a20 4164 dbpoolx.mod: Ad │ │ │ -000a1900: 6465 6420 696e 6465 7874 6572 6d20 746f ded indexterm to │ │ │ -000a1910: 2067 6c6f 7373 656e 7472 7920 6265 7477 glossentry betw │ │ │ -000a1920: 6565 6e20 676c 6f73 7374 6572 6d20 616e een glossterm an │ │ │ -000a1930: 6420 676c 6f73 7364 6566 2e0a 0a31 3939 d glossdef...199 │ │ │ -000a1940: 382d 3132 2d30 3920 204e 6f72 6d61 6e20 8-12-09 Norman │ │ │ -000a1950: 5761 6c73 6820 203c 6e64 7740 6e77 616c Walsh ...* COPY │ │ │ -000a1970: 5249 4748 542c 2052 4541 444d 452c 2063 RIGHT, README, c │ │ │ -000a1980: 616c 7374 626c 782e 6474 642c 2064 6233 alstblx.dtd, db3 │ │ │ -000a1990: 786d 6c2e 6474 642c 2064 6267 656e 656e xml.dtd, dbgenen │ │ │ -000a19a0: 742e 656e 742c 2064 6268 6965 7278 2e6d t.ent, dbhierx.m │ │ │ -000a19b0: 6f64 2c20 6462 706f 6f6c 782e 6d6f 642c od, dbpoolx.mod, │ │ │ -000a19c0: 2074 6573 742e 786d 6c3a 200a 0943 6861 test.xml: ..Cha │ │ │ -000a19d0: 6e67 6564 2065 6d62 6564 6465 6420 7665 nged embedded ve │ │ │ -000a19e0: 7273 696f 6e20 6e75 6d62 6572 2074 6f20 rsion number to │ │ │ -000a19f0: 312e 310a 0a09 2a20 5645 5253 494f 4e3a 1.1...* VERSION: │ │ │ -000a1a00: 2056 6572 7369 6f6e 2031 2e31 2072 656c Version 1.1 rel │ │ │ -000a1a10: 6561 7365 642e 0a0a 092a 2056 4552 5349 eased....* VERSI │ │ │ -000a1a20: 4f4e 3a20 4e65 7720 6669 6c65 2e0a 0a09 ON: New file.... │ │ │ -000a1a30: 2a20 6361 6c73 7462 6c78 2e64 7464 3a20 * calstblx.dtd: │ │ │ -000a1a40: 5269 7070 6564 206f 7574 2061 2077 686f Ripped out a who │ │ │ -000a1a50: 6c65 2062 756e 6368 206f 6620 636f 6d6d le bunch of comm │ │ │ -000a1a60: 656e 7473 2e20 2049 6e20 584d 4c2c 2070 ents. In XML, p │ │ │ -000a1a70: 6172 616d 6574 6572 0a09 656e 7469 7469 arameter..entiti │ │ │ -000a1a80: 6573 2061 7265 2065 7870 616e 6465 6420 es are expanded │ │ │ -000a1a90: 696e 2063 6f6d 6d65 6e74 7320 616e 6420 in comments and │ │ │ -000a1aa0: 7468 6174 206d 6164 6520 736f 6d65 206f that made some o │ │ │ -000a1ab0: 6620 7468 650a 0963 6f6d 6d65 6e74 7320 f the..comments │ │ │ -000a1ac0: 626f 6775 732e 0a0a 092a 2064 6268 6965 bogus....* dbhie │ │ │ -000a1ad0: 7278 2e6d 6f64 3a20 4164 6465 6420 696e rx.mod: Added in │ │ │ -000a1ae0: 6465 7874 6572 6d73 2074 6f20 7265 6669 dexterms to refi │ │ │ -000a1af0: 6e6c 696e 652e 6368 6172 2e6d 6978 2e0a nline.char.mix.. │ │ │ -000a1b00: 0a09 2a20 6462 706f 6f6c 782e 6d6f 643a ..* dbpoolx.mod: │ │ │ -000a1b10: 2041 6464 6564 2069 6e64 6578 7465 726d Added indexterm │ │ │ -000a1b20: 2061 6e64 2062 6567 696e 7061 6765 2074 and beginpage t │ │ │ -000a1b30: 6f20 6578 616d 706c 652e 6d69 782c 2068 o example.mix, h │ │ │ -000a1b40: 6967 686c 6967 6874 732e 6d69 782c 0a09 ighlights.mix,.. │ │ │ -000a1b50: 6164 6d6f 6e2e 6d69 782c 2066 6967 7572 admon.mix, figur │ │ │ -000a1b60: 652e 6d69 782c 2067 6c6f 7373 6465 662e e.mix, glossdef. │ │ │ -000a1b70: 6d69 782c 206c 6567 616c 6e6f 7469 6365 mix, legalnotice │ │ │ -000a1b80: 2e6d 6978 2e0a 090a 0941 6c6c 6f77 2069 .mix.....Allow i │ │ │ -000a1b90: 6e64 6578 7465 726d 7320 6265 7477 6565 ndexterms betwee │ │ │ -000a1ba0: 6e20 7469 746c 6520 616e 6420 7061 7261 n title and para │ │ │ -000a1bb0: 2069 6e20 666f 726d 616c 7061 7261 2e0a in formalpara.. │ │ │ -000a1bc0: 090a 0941 6464 6564 2069 6e64 6578 7465 ...Added indexte │ │ │ -000a1bd0: 726d 7320 746f 2074 626c 2e74 6162 6c65 rms to tbl.table │ │ │ -000a1be0: 2e6d 646c 2c20 6265 7477 6565 6e20 7469 .mdl, between ti │ │ │ -000a1bf0: 746c 6520 616e 6420 7468 6520 7265 7374 tle and the rest │ │ │ -000a1c00: 206f 660a 0974 6865 2063 6f6e 7465 6e74 of..the content │ │ │ -000a1c10: 206f 6620 7461 626c 652e 0a09 0a09 5265 of table.....Re │ │ │ -000a1c20: 6d6f 7665 6420 6120 6665 7720 6578 7472 moved a few extr │ │ │ -000a1c30: 616e 656f 7573 2070 6172 616d 6574 6572 aneous parameter │ │ │ -000a1c40: 2065 6e74 6974 6965 7320 2865 7863 6c75 entities (exclu │ │ │ -000a1c50: 7369 6f6e 7320 696e 0a09 7461 626c 6573 sions in..tables │ │ │ -000a1c60: 2c20 6d6f 7374 6c79 292e 0a0a 092a 2074 , mostly)....* t │ │ │ -000a1c70: 6573 742e 786d 6c3a 2043 6861 6e67 6520 est.xml: Change │ │ │ -000a1c80: 7379 7374 656d 6964 3b20 6164 6465 6420 systemid; added │ │ │ -000a1c90: 7465 7374 2069 6e64 6578 7465 726d 730a test indexterms. │ │ │ -000a1ca0: 0a31 3939 382d 3039 2d31 3620 204e 6f72 .1998-09-16 Nor │ │ │ -000a1cb0: 6d61 6e20 5761 6c73 6820 203c 6e64 7740 man Walsh ...* │ │ │ -000a1cd0: 6462 3378 6d6c 2e64 7464 3a20 4368 616e db3xml.dtd: Chan │ │ │ -000a1ce0: 6765 6420 6465 636c 6172 6174 696f 6e20 ged declaration │ │ │ -000a1cf0: 6f66 206c 696e 6573 7065 6369 6669 633b of linespecific; │ │ │ -000a1d00: 2066 6f72 6d65 7220 6465 636c 6172 6174 former declarat │ │ │ -000a1d10: 696f 6e0a 0977 6173 206e 6f74 2061 2076 ion..was not a v │ │ │ -000a1d20: 616c 6964 2055 5249 0a0a 092a 2064 6270 alid URI...* dbp │ │ │ -000a1d30: 6f6f 6c78 2e6d 6f64 3a20 5265 6d6f 7665 oolx.mod: Remove │ │ │ -000a1d40: 6420 6475 706c 6963 6174 6520 6465 636c d duplicate decl │ │ │ -000a1d50: 6172 6174 696f 6e20 6f66 206c 6f63 616c aration of local │ │ │ -000a1d60: 2e6b 6579 776f 7264 7365 742e 6174 7472 .keywordset.attr │ │ │ -000a1d70: 6962 0a0a 3139 3938 2d30 392d 3130 2020 ib..1998-09-10 │ │ │ -000a1d80: 4e6f 726d 616e 2057 616c 7368 2020 3c6e Norman Walsh .. │ │ │ -000a1da0: 092a 2043 4f50 5952 4947 4854 2c20 5245 .* COPYRIGHT, RE │ │ │ -000a1db0: 4144 4d45 2c20 6361 6c73 7462 6c78 2e64 ADME, calstblx.d │ │ │ -000a1dc0: 7464 2c20 6368 616e 6765 732c 2064 6233 td, changes, db3 │ │ │ -000a1dd0: 786d 6c2e 6474 642c 2064 6267 656e 656e xml.dtd, dbgenen │ │ │ -000a1de0: 742e 656e 742c 2064 6268 6965 7278 2e6d t.ent, dbhierx.m │ │ │ -000a1df0: 6f64 2c20 6462 706f 6f6c 782e 6d6f 642c od, dbpoolx.mod, │ │ │ -000a1e00: 2074 6573 742e 786d 6c3a 200a 094e 6577 test.xml: ..New │ │ │ -000a1e10: 2066 696c 652e 0a0a b600 0000 1d64 656d file........dem │ │ │ -000a1e20: 6f2f 646f 6373 7263 2f44 6f63 426f 6f6b o/docsrc/DocBook │ │ │ -000a1e30: 2f43 4f50 5952 4947 4854 df00 0004 2c44 /COPYRIGHT....,D │ │ │ -000a1e40: 6f63 426b 2058 4d4c 2056 332e 312e 3720 ocBk XML V3.1.7 │ │ │ -000a1e50: 4454 440a 436f 7079 7269 6768 7420 2843 DTD.Copyright (C │ │ │ -000a1e60: 2920 3139 3938 2c20 3139 3939 204e 6f72 ) 1998, 1999 Nor │ │ │ -000a1e70: 6d61 6e20 5761 6c73 680a 6874 7470 3a2f man Walsh.http:/ │ │ │ -000a1e80: 2f6e 7761 6c73 682e 636f 6d2f 646f 6362 /nwalsh.com/docb │ │ │ -000a1e90: 6f6f 6b2f 786d 6c2f 0a0a 596f 7520 6d61 ook/xml/..You ma │ │ │ -000a1ea0: 7920 6469 7374 7269 6275 7465 2074 6869 y distribute thi │ │ │ -000a1eb0: 7320 4454 4420 756e 6465 7220 7468 6520 s DTD under the │ │ │ -000a1ec0: 7361 6d65 2074 6572 6d73 2061 7320 446f same terms as Do │ │ │ -000a1ed0: 6342 6f6f 6b2e 0a0a 506c 6561 7365 2064 cBook...Please d │ │ │ -000a1ee0: 6972 6563 7420 616c 6c20 7175 6573 7469 irect all questi │ │ │ -000a1ef0: 6f6e 7320 616e 6420 636f 6d6d 656e 7473 ons and comments │ │ │ -000a1f00: 2061 626f 7574 2074 6869 7320 4454 4420 about this DTD │ │ │ -000a1f10: 746f 0a4e 6f72 6d61 6e20 5761 6c73 682c to.Norman Walsh, │ │ │ -000a1f20: 203c 6e64 7740 6e77 616c 7368 2e63 6f6d ...This DTD is │ │ │ -000a1f40: 6261 7365 6420 6f6e 2074 6865 2044 6f63 based on the Doc │ │ │ -000a1f50: 426f 6f6b 2056 332e 3120 4454 4420 6672 Book V3.1 DTD fr │ │ │ -000a1f60: 6f6d 204f 4153 4953 3a0a 0a20 205b 446f om OASIS:.. [Do │ │ │ -000a1f70: 6342 6f6f 6b20 6973 5d20 436f 7079 7269 cBook is] Copyri │ │ │ -000a1f80: 6768 7420 3139 3932 2c20 3139 3933 2c20 ght 1992, 1993, │ │ │ -000a1f90: 3139 3934 2c20 3139 3935 2c20 3139 3936 1994, 1995, 1996 │ │ │ -000a1fa0: 2c20 3139 3938 2c0a 2020 3139 3939 2048 , 1998,. 1999 H │ │ │ -000a1fb0: 614c 2043 6f6d 7075 7465 7220 5379 7374 aL Computer Syst │ │ │ -000a1fc0: 656d 732c 2049 6e63 2e2c 204f 2752 6569 ems, Inc., O'Rei │ │ │ -000a1fd0: 6c6c 7920 2620 4173 736f 6369 6174 6573 lly & Associates │ │ │ -000a1fe0: 2c20 496e 632e 2c0a 2020 4172 626f 7254 , Inc.,. ArborT │ │ │ -000a1ff0: 6578 742c 2049 6e63 2e2c 2046 756a 6974 ext, Inc., Fujit │ │ │ -000a2000: 7375 2053 6f66 7477 6172 6520 436f 7270 su Software Corp │ │ │ -000a2010: 6f72 6174 696f 6e2c 2061 6e64 2074 6865 oration, and the │ │ │ -000a2020: 0a20 204f 7267 616e 697a 6174 696f 6e20 . Organization │ │ │ -000a2030: 666f 7220 7468 6520 4164 7661 6e63 656d for the Advancem │ │ │ -000a2040: 656e 7420 6f66 2053 7472 7563 7475 7265 ent of Structure │ │ │ -000a2050: 6420 496e 666f 726d 6174 696f 6e0a 2020 d Information. │ │ │ -000a2060: 5374 616e 6461 7264 7320 284f 4153 4953 Standards (OASIS │ │ │ -000a2070: 292e 0a0a 2020 5065 726d 6973 7369 6f6e )... Permission │ │ │ -000a2080: 2074 6f20 7573 652c 2063 6f70 792c 206d to use, copy, m │ │ │ -000a2090: 6f64 6966 7920 616e 6420 6469 7374 7269 odify and distri │ │ │ -000a20a0: 6275 7465 2074 6865 2044 6f63 426f 6f6b bute the DocBook │ │ │ -000a20b0: 0a20 2044 5444 2061 6e64 2069 7473 2061 . DTD and its a │ │ │ -000a20c0: 6363 6f6d 7061 6e79 696e 6720 646f 6375 ccompanying docu │ │ │ -000a20d0: 6d65 6e74 6174 696f 6e20 666f 7220 616e mentation for an │ │ │ -000a20e0: 7920 7075 7270 6f73 6520 616e 640a 2020 y purpose and. │ │ │ -000a20f0: 7769 7468 6f75 7420 6665 6520 6973 2068 without fee is h │ │ │ -000a2100: 6572 6562 7920 6772 616e 7465 6420 696e ereby granted in │ │ │ -000a2110: 2070 6572 7065 7475 6974 792c 2070 726f perpetuity, pro │ │ │ -000a2120: 7669 6465 6420 7468 6174 0a20 2074 6865 vided that. the │ │ │ -000a2130: 2061 626f 7665 2063 6f70 7972 6967 6874 above copyright │ │ │ -000a2140: 206e 6f74 6963 6520 616e 6420 7468 6973 notice and this │ │ │ -000a2150: 2070 6172 6167 7261 7068 2061 7070 6561 paragraph appea │ │ │ -000a2160: 7220 696e 2061 6c6c 0a20 2063 6f70 6965 r in all. copie │ │ │ -000a2170: 732e 2020 5468 6520 636f 7079 7269 6768 s. The copyrigh │ │ │ -000a2180: 7420 686f 6c64 6572 7320 6d61 6b65 206e t holders make n │ │ │ -000a2190: 6f20 7265 7072 6573 656e 7461 7469 6f6e o representation │ │ │ -000a21a0: 2061 626f 7574 0a20 2074 6865 2073 7569 about. the sui │ │ │ -000a21b0: 7461 6269 6c69 7479 206f 6620 7468 6520 tability of the │ │ │ -000a21c0: 4454 4420 666f 7220 616e 7920 7075 7270 DTD for any purp │ │ │ -000a21d0: 6f73 652e 2020 4974 2069 7320 7072 6f76 ose. It is prov │ │ │ -000a21e0: 6964 6564 0a20 2022 6173 2069 7322 2077 ided. "as is" w │ │ │ -000a21f0: 6974 686f 7574 2065 7870 7265 7373 6564 ithout expressed │ │ │ -000a2200: 206f 7220 696d 706c 6965 6420 7761 7272 or implied warr │ │ │ -000a2210: 616e 7479 2e0a 0a46 6f72 206d 6f72 6520 anty...For more │ │ │ -000a2220: 696e 666f 726d 6174 696f 6e20 6162 6f75 information abou │ │ │ -000a2230: 7420 7468 6520 446f 6342 6f6f 6b20 4454 t the DocBook DT │ │ │ -000a2240: 442c 2073 6565 200a 6874 7470 3a2f 2f77 D, see .http://w │ │ │ -000a2250: 7777 2e6f 6173 6973 2d6f 7065 6e2e 6f72 ww.oasis-open.or │ │ │ -000a2260: 672f 646f 6362 6f6f 6b2f 0ab6 0000 001d g/docbook/...... │ │ │ -000a2270: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ -000a2280: 6f6f 6b2f 3430 6368 672e 7478 74df 0000 ook/40chg.txt... │ │ │ -000a2290: 0929 3138 204d 6179 2032 3030 300a 0a43 .)18 May 2000..C │ │ │ -000a22a0: 6861 6e67 6573 2066 726f 6d20 446f 6342 hanges from DocB │ │ │ -000a22b0: 6f6f 6b20 5633 2e31 2074 6f20 446f 6342 ook V3.1 to DocB │ │ │ -000a22c0: 6f6f 6b20 584d 4c20 5634 2e30 3a0a 0a47 ook XML V4.0:..G │ │ │ -000a22d0: 6c6f 6261 6c3a 0a0a 2d20 4272 6f61 6420 lobal:..- Broad │ │ │ -000a22e0: 6368 616e 6765 7320 7265 7175 6972 6564 changes required │ │ │ -000a22f0: 2066 6f72 2058 4d4c 2063 6f6d 7061 7469 for XML compati │ │ │ -000a2300: 6269 6c69 7479 0a2d 2041 6464 6564 2061 bility.- Added a │ │ │ -000a2310: 202a 7072 6f76 6973 696f 6e61 6c2a 2073 *provisional* s │ │ │ -000a2320: 6574 206f 6620 6368 6172 6163 7465 7220 et of character │ │ │ -000a2330: 656e 7469 7469 6573 2062 6173 6564 206f entities based o │ │ │ -000a2340: 6e20 7468 6520 4953 4f0a 2020 656e 7469 n the ISO. enti │ │ │ -000a2350: 7479 2073 6574 732e 2054 6865 2044 6f63 ty sets. The Doc │ │ │ -000a2360: 426f 6f6b 2054 4320 6973 206e 6f74 2077 Book TC is not w │ │ │ -000a2370: 696c 6c69 6e67 2074 6f20 6163 6365 7074 illing to accept │ │ │ -000a2380: 2074 6865 206c 6f6e 672d 7465 726d 0a20 the long-term. │ │ │ -000a2390: 2072 6573 706f 6e73 6962 696c 6974 7920 responsibility │ │ │ -000a23a0: 666f 7220 6465 6669 6e69 6e67 2061 6e64 for defining and │ │ │ -000a23b0: 206d 6169 6e74 6169 6e69 6e67 2074 6865 maintaining the │ │ │ -000a23c0: 7365 2073 6574 732e 2054 6865 2054 430a se sets. The TC. │ │ │ -000a23d0: 2020 7769 6c6c 2061 736b 204f 4153 4953 will ask OASIS │ │ │ -000a23e0: 2074 6f20 666f 726d 2061 206e 6577 2054 to form a new T │ │ │ -000a23f0: 4320 666f 7220 7468 6973 2070 7572 706f C for this purpo │ │ │ -000a2400: 7365 2e0a 0a4d 6172 6b75 703a 0a0a 2d20 se...Markup:..- │ │ │ -000a2410: 5246 4520 2031 373a 2041 6464 6564 2061 RFE 17: Added a │ │ │ -000a2420: 2063 6f6d 6d6f 6e20 6174 7472 6962 7574 common attribut │ │ │ -000a2430: 6520 2743 6f6e 6469 7469 6f6e 2720 666f e 'Condition' fo │ │ │ -000a2440: 7220 6765 6e65 7269 6320 6566 6665 6374 r generic effect │ │ │ -000a2450: 6976 6974 790a 2d20 5246 4520 2033 383a ivity.- RFE 38: │ │ │ -000a2460: 2054 6865 206e 6176 2e63 6c61 7373 2065 The nav.class e │ │ │ -000a2470: 6c65 6d65 6e74 7320 2854 6f43 7c4c 6f54 lements (ToC|LoT │ │ │ -000a2480: 7c49 6e64 6578 7c47 6c6f 7373 6172 797c |Index|Glossary| │ │ │ -000a2490: 4269 626c 696f 6772 6170 6879 2920 6172 Bibliography) ar │ │ │ -000a24a0: 650a 2020 2020 2020 2020 2020 206e 6f77 e. now │ │ │ -000a24b0: 2061 6c6c 6f77 6564 2061 7420 7468 6520 allowed at the │ │ │ -000a24c0: 6265 6769 6e6e 696e 6720 616e 6420 656e beginning and en │ │ │ -000a24d0: 6420 6f66 2063 6f6d 706f 6e65 6e74 7320 d of components │ │ │ -000a24e0: 616e 6420 7365 6374 696f 6e73 0a2d 2052 and sections.- R │ │ │ -000a24f0: 4645 2020 3538 3a20 5468 6520 276f 7074 FE 58: The 'opt │ │ │ -000a2500: 6d75 6c74 2720 616e 6420 2772 6571 6d75 mult' and 'reqmu │ │ │ -000a2510: 6c74 2720 6174 7472 6962 7574 6520 7661 lt' attribute va │ │ │ -000a2520: 6c75 6573 2068 6176 6520 6265 656e 0a20 lues have been. │ │ │ -000a2530: 2020 2020 2020 2020 2020 7265 6d6f 7665 remove │ │ │ -000a2540: 6420 6672 6f6d 2047 726f 7570 0a2d 2052 d from Group.- R │ │ │ -000a2550: 4645 2020 3635 3a20 4164 6465 6420 7365 FE 65: Added se │ │ │ -000a2560: 7665 7261 6c20 636c 6173 7320 6174 7472 veral class attr │ │ │ -000a2570: 6962 7574 6520 7661 6c75 6573 2074 6f20 ibute values to │ │ │ -000a2580: 4669 6c65 6e61 6d65 2061 6e64 2053 7973 Filename and Sys │ │ │ -000a2590: 7465 6d49 7465 6d0a 2020 2020 2020 2020 temItem. │ │ │ -000a25a0: 2020 2061 7420 7468 6520 7265 7175 6573 at the reques │ │ │ -000a25b0: 7420 6f66 2074 6865 204c 696e 7578 2063 t of the Linux c │ │ │ -000a25c0: 6f6d 6d75 6e69 7479 0a2d 2052 4645 2020 ommunity.- RFE │ │ │ -000a25d0: 3733 3a20 5265 6d6f 7665 6420 426f 6f6b 73: Removed Book │ │ │ -000a25e0: 4269 626c 696f 2061 6e64 2053 6572 6965 Biblio and Serie │ │ │ -000a25f0: 7349 6e66 6f0a 2d20 5246 4520 2038 313a sInfo.- RFE 81: │ │ │ -000a2600: 2041 6464 6564 2053 6964 6562 6172 496e Added SidebarIn │ │ │ -000a2610: 666f 2074 6f20 5369 6465 6261 720a 2d20 fo to Sidebar.- │ │ │ -000a2620: 5246 4520 2038 373a 2041 6464 6564 2027 RFE 87: Added ' │ │ │ -000a2630: 786d 6c70 6927 2061 6e64 2027 656d 7074 xmlpi' and 'empt │ │ │ -000a2640: 7974 6167 2720 6173 2063 6c61 7373 2076 ytag' as class v │ │ │ -000a2650: 616c 7565 7320 6f66 2053 474d 4c54 6167 alues of SGMLTag │ │ │ -000a2660: 0a2d 2052 4645 2020 3932 3a20 4164 6465 .- RFE 92: Adde │ │ │ -000a2670: 6420 2743 4f27 2074 6f20 5379 6e6f 7073 d 'CO' to Synops │ │ │ -000a2680: 6973 2061 6e64 204c 6974 6572 616c 4c61 is and LiteralLa │ │ │ -000a2690: 796f 7574 0a2d 2052 4645 2020 3939 3a20 yout.- RFE 99: │ │ │ -000a26a0: 4164 6465 6420 5369 6d70 6c65 4d73 6745 Added SimpleMsgE │ │ │ -000a26b0: 6e74 7279 2061 7320 616e 2061 6c74 6572 ntry as an alter │ │ │ -000a26c0: 6e61 7469 7665 2074 6f20 4d73 6745 6e74 native to MsgEnt │ │ │ -000a26d0: 7279 2069 6e20 6f72 6465 720a 2020 2020 ry in order. │ │ │ -000a26e0: 2020 2020 2020 2074 6f20 7072 6f76 6964 to provid │ │ │ -000a26f0: 6520 6120 7369 6d70 6c65 7220 4d73 6753 e a simpler MsgS │ │ │ -000a2700: 6574 2063 6f6e 7374 7275 6374 0a2d 2052 et construct.- R │ │ │ -000a2710: 4645 2031 3033 3a20 4164 6465 6420 5265 FE 103: Added Re │ │ │ -000a2720: 7644 6573 6372 6970 7469 6f6e 2061 7320 vDescription as │ │ │ -000a2730: 616e 2061 6c74 6572 6e61 7469 7665 2074 an alternative t │ │ │ -000a2740: 6f20 5265 7652 656d 6172 6b20 696e 0a20 o RevRemark in. │ │ │ -000a2750: 2020 2020 2020 2020 2020 5265 7648 6973 RevHis │ │ │ -000a2760: 746f 7279 3b20 7468 6973 2061 6c6c 6f77 tory; this allow │ │ │ -000a2770: 7320 6c6f 6e67 6572 2064 6573 6372 6970 s longer descrip │ │ │ -000a2780: 7469 7665 2074 6578 7420 696e 2061 2072 tive text in a r │ │ │ -000a2790: 6576 6973 696f 6e0a 2d20 5246 4520 3130 evision.- RFE 10 │ │ │ -000a27a0: 343a 2041 6464 6564 2027 5370 6563 6966 4: Added 'Specif │ │ │ -000a27b0: 6963 6174 696f 6e27 2074 6f20 7468 6520 ication' to the │ │ │ -000a27c0: 6c69 7374 206f 6620 646f 6375 6d65 6e74 list of document │ │ │ -000a27d0: 2063 6c61 7373 6573 206f 6e20 4172 7469 classes on Arti │ │ │ -000a27e0: 636c 650a 2d20 5246 4520 3130 383a 2041 cle.- RFE 108: A │ │ │ -000a27f0: 6c6c 6f77 2061 646d 6f6e 6974 696f 6e73 llow admonitions │ │ │ -000a2800: 2069 6e20 416e 7377 6572 730a 2d20 5246 in Answers.- RF │ │ │ -000a2810: 4520 3131 303a 2041 6c6c 6f77 2061 2052 E 110: Allow a R │ │ │ -000a2820: 6576 4869 7374 6f72 7920 6f6e 2051 616e evHistory on Qan │ │ │ -000a2830: 6441 456e 7472 790a 2d20 5246 4520 3131 dAEntry.- RFE 11 │ │ │ -000a2840: 353a 2041 6c6c 6f77 206f 7074 696f 6e61 5: Allow optiona │ │ │ -000a2850: 6c20 5469 746c 6520 6f6e 204f 7264 6572 l Title on Order │ │ │ -000a2860: 6564 4c69 7374 2061 6e64 2049 7465 6d69 edList and Itemi │ │ │ -000a2870: 7a65 644c 6973 740a 2d20 5246 4520 3131 zedList.- RFE 11 │ │ │ -000a2880: 363a 2041 6464 6564 204c 696e 654e 756d 6: Added LineNum │ │ │ -000a2890: 6265 7269 6e67 2061 7474 7269 6275 7465 bering attribute │ │ │ -000a28a0: 2074 6f20 6c69 6e65 7370 6563 6966 6963 to linespecific │ │ │ -000a28b0: 2065 6e76 6972 6f6e 6d65 6e74 7320 666f environments fo │ │ │ -000a28c0: 720a 2020 2020 2020 2020 2020 2070 7265 r. pre │ │ │ -000a28d0: 7365 6e74 6174 696f 6e20 6f66 206c 696e sentation of lin │ │ │ -000a28e0: 6520 6e75 6d62 6572 730a 2d20 4164 6465 e numbers.- Adde │ │ │ -000a28f0: 6420 6120 636f 6d6d 6f6e 2061 7474 7269 d a common attri │ │ │ -000a2900: 6275 7465 2027 5365 6375 7269 7479 2720 bute 'Security' │ │ │ -000a2910: 666f 7220 6566 6665 6374 6976 6974 790a for effectivity. │ │ │ -000a2920: 2d20 4164 6465 6420 7379 6e6f 7073 6973 - Added synopsis │ │ │ -000a2930: 206d 6172 6b75 7020 666f 7220 6d6f 6465 markup for mode │ │ │ -000a2940: 726e 2070 726f 6772 616d 6d69 6e67 206c rn programming l │ │ │ -000a2950: 616e 6775 6167 6573 2028 652e 672c 206f anguages (e.g, o │ │ │ -000a2960: 626a 6563 740a 2020 6f72 6965 6e74 6564 bject. oriented │ │ │ -000a2970: 206c 616e 6775 6167 6573 206c 696b 6520 languages like │ │ │ -000a2980: 4a61 7661 2c20 432b 2b2c 2061 6e64 2049 Java, C++, and I │ │ │ -000a2990: 444c 290a 2d20 5265 6e61 6d65 6420 446f DL).- Renamed Do │ │ │ -000a29a0: 6349 6e66 6f20 746f 2050 7265 6661 6365 cInfo to Preface │ │ │ -000a29b0: 496e 666f 2c20 4368 6170 7465 7249 6e66 Info, ChapterInf │ │ │ -000a29c0: 6f2c 2041 7070 656e 6469 7849 6e66 6f2c o, AppendixInfo, │ │ │ -000a29d0: 2065 7463 2e0a 0a4f 7468 6572 3a0a 0a2d etc...Other:..- │ │ │ -000a29e0: 2052 4645 2020 3838 3a20 4164 6465 6420 RFE 88: Added │ │ │ -000a29f0: 5045 7320 746f 2069 6e63 6c75 6465 2f69 PEs to include/i │ │ │ -000a2a00: 676e 6f72 6520 6462 6e6f 746e 2e6d 6f64 gnore dbnotn.mod │ │ │ -000a2a10: 2061 6e64 2064 6263 656e 742e 6d6f 640a and dbcent.mod. │ │ │ -000a2a20: 2d20 5246 4520 3130 323a 2046 6978 6564 - RFE 102: Fixed │ │ │ -000a2a30: 2073 6f6d 6520 6f75 7473 7461 6e64 696e some outstandin │ │ │ -000a2a40: 6720 6e61 6d65 6361 7365 2070 726f 626c g namecase probl │ │ │ -000a2a50: 656d 730a 2d20 5246 4520 3130 353a 2041 ems.- RFE 105: A │ │ │ -000a2a60: 6464 6564 2050 4e47 206e 6f74 6174 696f dded PNG notatio │ │ │ -000a2a70: 6e0a 2d20 5246 4520 3130 363a 2052 656d n.- RFE 106: Rem │ │ │ -000a2a80: 6f76 6564 2073 6f6d 6520 6f64 6420 2a2e oved some odd *. │ │ │ -000a2a90: 636f 6e74 656e 7420 5045 7320 7468 6174 content PEs that │ │ │ -000a2aa0: 2069 6e74 6572 6665 7265 6420 7769 7468 interfered with │ │ │ -000a2ab0: 0a20 2020 2020 2020 2020 2020 6375 7374 . cust │ │ │ -000a2ac0: 6f6d 697a 6174 696f 6e20 6c61 7965 7273 omization layers │ │ │ -000a2ad0: 0a2d 2052 4645 2031 3039 3a20 4164 6465 .- RFE 109: Adde │ │ │ -000a2ae0: 6420 4650 4920 746f 2063 6f6e 7465 6e74 d FPI to content │ │ │ -000a2af0: 206f 6620 6462 6765 6e65 6e74 2e6d 6f64 of dbgenent.mod │ │ │ -000a2b00: 2028 666f 7220 636f 6e73 6973 7465 6e63 (for consistenc │ │ │ -000a2b10: 7929 0a2d 2052 4645 2031 3131 3a20 4164 y).- RFE 111: Ad │ │ │ -000a2b20: 6465 6420 7468 6520 4575 726f 2073 796d ded the Euro sym │ │ │ -000a2b30: 626f 6c0a 2d20 4669 7865 6420 6275 6720 bol.- Fixed bug │ │ │ -000a2b40: 696e 2063 616c 732d 7462 6c2e 6474 643b in cals-tbl.dtd; │ │ │ -000a2b50: 2061 206d 6f64 656c 2067 726f 7570 2077 a model group w │ │ │ -000a2b60: 6173 2075 7365 6420 666f 7220 7468 6520 as used for the │ │ │ -000a2b70: 656c 656d 656e 740a 2020 6465 636c 6172 element. declar │ │ │ -000a2b80: 6174 696f 6e2c 2062 7574 2074 6865 2061 ation, but the a │ │ │ -000a2b90: 7474 6c69 7374 2064 6563 6c61 7261 7469 ttlist declarati │ │ │ -000a2ba0: 6f6e 2075 7365 6420 2254 6162 6c65 2220 on used "Table" │ │ │ -000a2bb0: 6c69 7465 7261 6c6c 792e 0ab6 0000 0024 literally......$ │ │ │ -000a2bc0: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ -000a2bd0: 6f6f 6b2f 656e 742f 6973 6f2d 7465 6368 ook/ent/iso-tech │ │ │ -000a2be0: 2e65 6e74 df00 000b 3a3c 212d 2d20 6973 .ent....:.. │ │ │ -000a2cc0: 0a0a 3c21 454e 5449 5459 2061 6c65 7068 .. . . │ │ │ -000a2d30: 3c21 2d2d 2052 4947 4854 2041 4e47 4c45 . │ │ │ -000a2d60: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . . . │ │ │ -000a2de0: 3c21 454e 5449 5459 2063 6170 0922 2623 . . . │ │ │ -000a2e70: 3c21 454e 5449 5459 2065 7175 6976 0922 . │ │ │ -000a2eb0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ -000a2ee0: 3c21 454e 5449 5459 2066 6e6f 6609 2226 . .< │ │ │ -000a2f80: 2145 4e54 4954 5920 696e 6669 6e09 2226 !ENTITY infin."& │ │ │ -000a2f90: 2378 3232 3145 3b22 3e20 3c21 2d2d 2020 #x221E;"> . . │ │ │ -000a2fe0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000a3010: 2145 4e54 4954 5920 6c41 7272 0922 2623 !ENTITY lArr."&# │ │ │ -000a3020: 7832 3144 303b 223e 203c 212d 2d20 4c45 x21D0;"> . < │ │ │ -000a3080: 212d 2d20 4d49 4e55 5320 5349 474e 202d !-- MINUS SIGN - │ │ │ -000a3090: 2d3e 0a3c 2145 4e54 4954 5920 6d6e 706c ->. < │ │ │ -000a30b0: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . < │ │ │ -000a3140: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . │ │ │ -000a3190: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000a31d0: 2145 4e54 4954 5920 7065 7270 0922 2623 !ENTITY perp."&# │ │ │ -000a31e0: 7832 3241 353b 223e 203c 212d 2d20 202d x22A5;"> . . . │ │ │ -000a32b0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000a32f0: 2145 4e54 4954 5920 7369 6d09 2226 2378 !ENTITY sim."&#x │ │ │ -000a3300: 3232 3343 3b22 3e20 3c21 2d2d 2020 2d2d 223C;"> . . │ │ │ -000a3380: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000a33b0: 2145 4e54 4954 5920 7375 7009 2226 2378 !ENTITY sup."&#x │ │ │ -000a33c0: 3232 3833 3b22 3e20 3c21 2d2d 2020 2d2d 2283;"> . . . │ │ │ -000a3470: 203c 212d 2d20 414e 4753 5452 4f4d 2053 . . │ │ │ -000a34f0: 0a3c 2145 4e54 4954 5920 446f 7409 2226 . . │ │ │ -000a3530: 3c21 2d2d 2043 4f4d 4249 4e49 4e47 2046 . .< │ │ │ -000a35c0: 2145 4e54 4954 5920 6c6f 7761 7374 0922 !ENTITY lowast." │ │ │ -000a35d0: 2623 7832 3231 373b 223e 203c 212d 2d20 ∗"> . │ │ │ -000a3610: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . . . . │ │ │ -000a3710: 3c21 2d2d 2045 5354 494d 4154 4553 202d .... . . │ │ │ -000a3880: 3c21 454e 5449 5459 2065 6d73 7031 3309 . .< │ │ │ -000a38f0: 2145 4e54 4954 5920 6e75 6d73 7009 2226 !ENTITY numsp."& │ │ │ -000a3900: 2378 3230 3037 3b22 3e20 3c21 2d2d 2046 #x2007;"> . │ │ │ -000a3920: 3c21 454e 5449 5459 2070 756e 6373 7009 . . . .< │ │ │ -000a3a10: 2145 4e54 4954 5920 6461 7368 0922 2623 !ENTITY dash."&# │ │ │ -000a3a20: 7832 3031 303b 223e 203c 212d 2d20 4859 x2010;"> . . .< │ │ │ -000a3aa0: 2145 4e54 4954 5920 6e6c 6472 0922 2623 !ENTITY nldr."&# │ │ │ -000a3ab0: 7832 3032 353b 223e 203c 212d 2d20 5457 x2025;"> │ │ │ -000a3ad0: 0a3c 2145 4e54 4954 5920 6672 6163 3133 . . │ │ │ -000a3b10: 3c21 454e 5449 5459 2066 7261 6332 3309 . │ │ │ -000a3b50: 3c21 454e 5449 5459 2066 7261 6331 3509 .< │ │ │ -000a3b90: 2145 4e54 4954 5920 6672 6163 3235 0922 !ENTITY frac25." │ │ │ -000a3ba0: 2623 7832 3135 363b 223e 203c 212d 2d20 ⅖"> .< │ │ │ -000a3bd0: 2145 4e54 4954 5920 6672 6163 3335 0922 !ENTITY frac35." │ │ │ -000a3be0: 2623 7832 3135 373b 223e 203c 212d 2d20 ⅗"> │ │ │ -000a3c10: 0a3c 2145 4e54 4954 5920 6672 6163 3435 . . │ │ │ -000a3c90: 0a3c 2145 4e54 4954 5920 6672 6163 3536 . . .< │ │ │ -000a3d00: 2145 4e54 4954 5920 626c 6f63 6b09 2226 !ENTITY block."& │ │ │ -000a3d10: 2378 3235 3838 3b22 3e20 3c21 2d2d 2046 #x2588;"> . . . . . . < │ │ │ -000a3e80: 212d 2d20 5748 4954 4520 4349 5243 4c45 !-- WHITE CIRCLE │ │ │ -000a3e90: 202d 2d3e 0a3c 2145 4e54 4954 5920 7371 -->. . . │ │ │ -000a3f10: 203c 212d 2d20 5748 4954 4520 5550 2d50 . < │ │ │ -000a3f50: 212d 2d20 5748 4954 4520 444f 574e 2d50 !-- WHITE DOWN-P │ │ │ -000a3f60: 4f49 4e54 494e 4720 5452 4941 4e47 4c45 OINTING TRIANGLE │ │ │ -000a3f70: 202d 2d3e 0a3c 2145 4e54 4954 5920 7374 -->. < │ │ │ -000a3f90: 212d 2d20 5354 4152 204f 5045 5241 544f !-- STAR OPERATO │ │ │ -000a3fa0: 5220 2d2d 3e0a 3c21 454e 5449 5459 2062 R -->. │ │ │ -000a3fc0: 3c21 2d2d 2042 554c 4c45 5420 2d2d 3e0a . │ │ │ -000a3fd0: 3c21 454e 5449 5459 2073 7175 6609 2226 . < │ │ │ -000a4010: 212d 2d20 424c 4143 4b20 5550 2d50 4f49 !-- BLACK UP-POI │ │ │ -000a4020: 4e54 494e 4720 5452 4941 4e47 4c45 202d NTING TRIANGLE - │ │ │ -000a4030: 2d3e 0a3c 2145 4e54 4954 5920 6474 7269 ->. . < │ │ │ -000a4090: 212d 2d20 424c 4143 4b20 4c45 4654 2d50 !-- BLACK LEFT-P │ │ │ -000a40a0: 4f49 4e54 494e 4720 5452 4941 4e47 4c45 OINTING TRIANGLE │ │ │ -000a40b0: 202d 2d3e 0a3c 2145 4e54 4954 5920 7274 -->. │ │ │ -000a40d0: 3c21 2d2d 2042 4c41 434b 2052 4947 4854 . . . . .< │ │ │ -000a4200: 2145 4e54 4954 5920 6461 6767 6572 0922 !ENTITY dagger." │ │ │ -000a4210: 2623 7832 3032 303b 223e 203c 212d 2d20 †"> . . . . .< │ │ │ -000a42f0: 2145 4e54 4954 5920 666c 6174 0922 2623 !ENTITY flat."&# │ │ │ -000a4300: 7832 3636 443b 223e 203c 212d 2d20 4d55 x266D;"> .< │ │ │ -000a4350: 2145 4e54 4954 5920 6665 6d61 6c65 0922 !ENTITY female." │ │ │ -000a4360: 2623 7832 3634 303b 223e 203c 212d 2d20 ♀"> . │ │ │ -000a4390: 3c21 2d2d 2054 454c 4550 484f 4e45 2053 . . │ │ │ -000a43e0: 3c21 454e 5449 5459 2063 6f70 7973 7209 .< │ │ │ -000a4420: 2145 4e54 4954 5920 6361 7265 7409 2226 !ENTITY caret."& │ │ │ -000a4430: 2378 3230 3431 3b22 3e20 3c21 2d2d 2043 #x2041;"> . . . . │ │ │ -000a44f0: 3c21 454e 5449 5459 2066 696c 6967 0922 .. . . . │ │ │ -000a4610: 3c21 454e 5449 5459 2072 7371 756f 7209 . . .< │ │ │ -000a4690: 2145 4e54 4954 5920 6c6f 7a09 2226 2378 !ENTITY loz."&#x │ │ │ -000a46a0: 3235 4341 3b22 3e20 3c21 2d2d 204c 4f5a 25CA;"> . . . . . . . │ │ │ -000a4810: 203c 212d 2d20 5349 5820 504f 494e 5445 │ │ │ -000a4830: 0a3c 2145 4e54 4954 5920 7461 7267 6574 . . .< │ │ │ -000a48a0: 2145 4e54 4954 5920 6472 6372 6f70 0922 !ENTITY drcrop." │ │ │ -000a48b0: 2623 7832 3330 433b 223e 203c 212d 2d20 ⌌"> . . .... │ │ │ -000a4940: 0023 6465 6d6f 2f64 6f63 7372 632f 446f .#demo/docsrc/Do │ │ │ -000a4950: 6342 6f6f 6b2f 656e 742f 6973 6f2d 6e75 cBook/ent/iso-nu │ │ │ -000a4960: 6d2e 656e 74df 0000 0fe8 3c21 2d2d 2069 m.ent....... │ │ │ -000a4a40: 0a0a 3c21 454e 5449 5459 2068 616c 6609 .. . . . │ │ │ -000a4b40: 0a3c 2145 4e54 4954 5920 6672 6163 3138 . . . . . .< │ │ │ -000a4c40: 2145 4e54 4954 5920 7375 7033 0922 2623 !ENTITY sup3."&# │ │ │ -000a4c50: 7830 3042 333b 223e 203c 212d 2d20 5355 x00B3;"> . │ │ │ -000a4ca0: 0a3c 2145 4e54 4954 5920 706c 7573 6d6e . . < │ │ │ -000a4cf0: 212d 2d20 4c45 5353 2d54 4841 4e20 5349 !-- LESS-THAN SI │ │ │ -000a4d00: 474e 202d 2d3e 0a3c 2145 4e54 4954 5920 GN -->. . │ │ │ -000a4d50: 3c21 2d2d 2047 5245 4154 4552 2d54 4841 . . . . . . . < │ │ │ -000a4eb0: 212d 2d20 5945 4e20 5349 474e 202d 2d3e !-- YEN SIGN --> │ │ │ -000a4ec0: 0a3c 2145 4e54 4954 5920 6e75 6d09 2226 . .< │ │ │ -000a4ef0: 2145 4e54 4954 5920 7065 7263 6e74 0922 !ENTITY percnt." │ │ │ -000a4f00: 2623 7830 3032 353b 223e 203c 212d 2d20 %"> │ │ │ -000a4f20: 0a3c 2145 4e54 4954 5920 616d 7009 2226 . . . < │ │ │ -000a4fd0: 212d 2d20 4c45 4654 2053 5155 4152 4520 !-- LEFT SQUARE │ │ │ -000a4fe0: 4252 4143 4b45 5420 2d2d 3e0a 3c21 454e BRACKET -->. .< │ │ │ -000a5020: 2145 4e54 4954 5920 7273 7162 0922 2623 !ENTITY rsqb."&# │ │ │ -000a5030: 7830 3035 443b 223e 203c 212d 2d20 5249 x005D;"> . │ │ │ -000a5070: 203c 212d 2d20 4c45 4654 2043 5552 4c59 . │ │ │ -000a50c0: 0a3c 2145 4e54 4954 5920 7665 7262 6172 . . . . . . . . │ │ │ -000a5230: 3c21 454e 5449 5459 2073 6563 7409 2226 . │ │ │ -000a5260: 3c21 454e 5449 5459 2070 6172 6109 2226 . │ │ │ -000a5290: 3c21 454e 5449 5459 206d 6964 646f 7409 . │ │ │ -000a52c0: 3c21 454e 5449 5459 206c 6172 7209 2226 . . < │ │ │ -000a5350: 212d 2d20 5550 5741 5244 5320 4152 524f !-- UPWARDS ARRO │ │ │ -000a5360: 5720 2d2d 3e0a 3c21 454e 5449 5459 2064 W -->. │ │ │ -000a5380: 3c21 2d2d 2044 4f57 4e57 4152 4453 2041 . . │ │ │ -000a5400: 0a3c 2145 4e54 4954 5920 7472 6164 6509 . . │ │ │ -000a5450: 203c 212d 2d20 4252 4f4b 454e 2042 4152 . . │ │ │ -000a5490: 3c21 454e 5449 5459 2073 756e 6709 2226 . . . │ │ │ -000a5540: 3c21 2d2d 2051 554f 5441 5449 4f4e 204d . . │ │ │ -000a55a0: 3c21 2d2d 204c 4546 5420 5041 5245 4e54 . .< │ │ │ -000a55f0: 2145 4e54 4954 5920 636f 6d6d 6109 2226 !ENTITY comma."& │ │ │ -000a5600: 2378 3030 3243 3b22 3e20 3c21 2d2d 2043 #x002C;"> . . . . . │ │ │ -000a56e0: 203c 212d 2d20 434f 4c4f 4e20 2d2d 3e0a . │ │ │ -000a56f0: 3c21 454e 5449 5459 2073 656d 6909 2226 . .< │ │ │ -000a5750: 2145 4e54 4954 5920 6971 7565 7374 0922 !ENTITY iquest." │ │ │ -000a5760: 2623 7830 3042 463b 223e 203c 212d 2d20 ¿"> . . . . . . .....$demo/docs │ │ │ -000a5960: 7263 2f44 6f63 426f 6f6b 2f65 6e74 2f69 rc/DocBook/ent/i │ │ │ -000a5970: 736f 2d6c 6174 322e 656e 74df 0000 2236 so-lat2.ent..."6 │ │ │ -000a5980: 3c21 2d2d 2069 736f 2d6c 6174 322e 656e ..< │ │ │ -000a59d0: 212d 2d20 4465 7269 7665 6420 6672 6f6d !-- Derived from │ │ │ -000a59e0: 2074 6865 2063 6f72 7265 7370 6f6e 6469 the correspondi │ │ │ -000a59f0: 6e67 2049 534f 2038 3837 3920 7374 616e ng ISO 8879 stan │ │ │ -000a5a00: 6461 7264 2065 6e74 6974 7920 7365 740a dard entity set. │ │ │ -000a5a10: 2020 2020 2061 6e64 2074 6865 2055 6e69 and the Uni │ │ │ -000a5a20: 636f 6465 2063 6861 7261 6374 6572 206d code character m │ │ │ -000a5a30: 6170 7069 6e67 7320 7072 6f76 6964 6564 appings provided │ │ │ -000a5a40: 2062 7920 5365 6261 7374 6961 6e20 5261 by Sebastian Ra │ │ │ -000a5a50: 6874 7a20 2d2d 3e0a 0a3c 2145 4e54 4954 htz -->.. . . │ │ │ -000a5b00: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . │ │ │ -000a5b70: 0a3c 2145 4e54 4954 5920 616f 676f 6e09 . . │ │ │ -000a5bd0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . . │ │ │ -000a5d30: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . . . . . . │ │ │ -000a5f10: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . │ │ │ -000a5f80: 0a3c 2145 4e54 4954 5920 4563 6172 6f6e . . .< │ │ │ -000a6010: 2145 4e54 4954 5920 4564 6f74 0922 2623 !ENTITY Edot."&# │ │ │ -000a6020: 7830 3131 363b 223e 203c 212d 2d20 4c41 x0116;"> . . . < │ │ │ -000a6100: 212d 2d20 4c41 5449 4e20 534d 414c 4c20 !-- LATIN SMALL │ │ │ -000a6110: 4c45 5454 4552 2045 2057 4954 4820 4f47 LETTER E WITH OG │ │ │ -000a6120: 4f4e 454b 202d 2d3e 0a3c 2145 4e54 4954 ONEK -->. . │ │ │ -000a6170: 3c21 454e 5449 5459 2067 6163 7574 6509 . │ │ │ -000a61d0: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a6240: 0a3c 2145 4e54 4954 5920 4763 6564 696c . . . . < │ │ │ -000a6380: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ -000a6390: 4c20 4c45 5454 4552 2047 2057 4954 4820 L LETTER G WITH │ │ │ -000a63a0: 444f 5420 4142 4f56 4520 2d2d 3e0a 3c21 DOT ABOVE -->. . . . │ │ │ -000a64d0: 3c21 454e 5449 5459 2049 646f 7409 2226 . . │ │ │ -000a6560: 3c21 454e 5449 5459 2069 6d61 6372 0922 . │ │ │ -000a65c0: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c │ │ │ -000a65e0: 0a3c 2145 4e54 4954 5920 494a 6c69 6709 . .< │ │ │ -000a6620: 2145 4e54 4954 5920 696e 6f64 6f74 0922 !ENTITY inodot." │ │ │ -000a6630: 2623 7830 3133 313b 223e 203c 212d 2d20 ı"> │ │ │ -000a6660: 0a3c 2145 4e54 4954 5920 696f 676f 6e09 . . │ │ │ -000a66c0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . . . │ │ │ -000a6870: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . . . . │ │ │ -000a6980: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a69f0: 0a3c 2145 4e54 4954 5920 6c63 6564 696c . . │ │ │ -000a6a80: 0a3c 2145 4e54 4954 5920 6c6d 6964 6f74 . . . . . │ │ │ -000a6bc0: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a6c30: 0a3c 2145 4e54 4954 5920 656e 6709 2226 . . . │ │ │ -000a6cc0: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . │ │ │ -000a6d10: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a6d80: 0a3c 2145 4e54 4954 5920 6e63 6564 696c . . │ │ │ -000a6e10: 0a3c 2145 4e54 4954 5920 6f64 626c 6163 . . . . │ │ │ -000a6fb0: 0a3c 2145 4e54 4954 5920 7261 6375 7465 . . . . . │ │ │ -000a7110: 3c21 454e 5449 5459 2052 6365 6469 6c09 . . . │ │ │ -000a7200: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a7270: 0a3c 2145 4e54 4954 5920 7363 6564 696c . . │ │ │ -000a7300: 0a3c 2145 4e54 4954 5920 7363 6972 6309 . . . │ │ │ -000a73b0: 203c 212d 2d20 4c41 5449 4e20 534d 414c . │ │ │ -000a7420: 0a3c 2145 4e54 4954 5920 7463 6564 696c . . │ │ │ -000a74b0: 0a3c 2145 4e54 4954 5920 7473 7472 6f6b . . .< │ │ │ -000a7540: 2145 4e54 4954 5920 7562 7265 7665 0922 !ENTITY ubreve." │ │ │ -000a7550: 2623 7830 3136 443b 223e 203c 212d 2d20 ŭ"> . │ │ │ -000a75a0: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . . . │ │ │ -000a7680: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . │ │ │ -000a76f0: 0a3c 2145 4e54 4954 5920 756f 676f 6e09 . . │ │ │ -000a7750: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . . │ │ │ -000a77e0: 203c 212d 2d20 4c41 5449 4e20 4341 5049 │ │ │ -000a7810: 0a3c 2145 4e54 4954 5920 7574 696c 6465 . . . . │ │ │ -000a7900: 203c 212d 2d20 4c41 5449 4e20 4341 5049 │ │ │ -000a7930: 0a3c 2145 4e54 4954 5920 7963 6972 6309 . . . < │ │ │ -000a79e0: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ -000a79f0: 4c20 4c45 5454 4552 2059 2057 4954 4820 L LETTER Y WITH │ │ │ -000a7a00: 4449 4145 5245 5349 5320 2d2d 3e0a 3c21 DIAERESIS -->. . .< │ │ │ -000a7ae0: 2145 4e54 4954 5920 5a63 6172 6f6e 0922 !ENTITY Zcaron." │ │ │ -000a7af0: 2623 7830 3137 443b 223e 203c 212d 2d20 Ž"> . │ │ │ -000a7b40: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c . .....$demo/ │ │ │ -000a7bc0: 646f 6373 7263 2f44 6f63 426f 6f6b 2f65 docsrc/DocBook/e │ │ │ -000a7bd0: 6e74 2f69 736f 2d6c 6174 312e 656e 74df nt/iso-lat1.ent. │ │ │ -000a7be0: 0000 11c9 3c21 2d2d 2069 736f 2d6c 6174 ...... . . . . . . │ │ │ -000a7fd0: 3c21 454e 5449 5459 2041 756d 6c09 2226 . .< │ │ │ -000a8090: 2145 4e54 4954 5920 6363 6564 696c 0922 !ENTITY ccedil." │ │ │ -000a80a0: 2623 7830 3045 373b 223e 203c 212d 2d20 ç"> . .< │ │ │ -000a8120: 2145 4e54 4954 5920 6574 6809 2226 2378 !ENTITY eth."&#x │ │ │ -000a8130: 3030 4430 3b22 3e20 3c21 2d2d 204c 4154 00D0;"> . │ │ │ -000a8170: 203c 212d 2d20 4c41 5449 4e20 4341 5049 . .< │ │ │ -000a8220: 2145 4e54 4954 5920 6563 6972 6309 2226 !ENTITY ecirc."& │ │ │ -000a8230: 2378 3030 4541 3b22 3e20 3c21 2d2d 204c #x00EA;"> . . .< │ │ │ -000a8340: 2145 4e54 4954 5920 6575 6d6c 0922 2623 !ENTITY euml."&# │ │ │ -000a8350: 7830 3045 423b 223e 203c 212d 2d20 4c41 x00EB;"> . │ │ │ -000a83a0: 3c21 2d2d 204c 4154 494e 2043 4150 4954 .< │ │ │ -000a83d0: 2145 4e54 4954 5920 6961 6375 7465 0922 !ENTITY iacute." │ │ │ -000a83e0: 2623 7830 3045 443b 223e 203c 212d 2d20 í"> . │ │ │ -000a8430: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . . < │ │ │ -000a84c0: 212d 2d20 4c41 5449 4e20 4341 5049 5441 !-- LATIN CAPITA │ │ │ -000a84d0: 4c20 4c45 5454 4552 2049 2057 4954 4820 L LETTER I WITH │ │ │ -000a84e0: 4349 5243 554d 464c 4558 202d 2d3e 0a3c CIRCUMFLEX -->.< │ │ │ -000a84f0: 2145 4e54 4954 5920 6967 7261 7665 0922 !ENTITY igrave." │ │ │ -000a8500: 2623 7830 3045 433b 223e 203c 212d 2d20 ì"> . │ │ │ -000a8550: 3c21 2d2d 204c 4154 494e 2043 4150 4954 . . . │ │ │ -000a8650: 3c21 454e 5449 5459 204e 7469 6c64 6509 . . . . . .< │ │ │ -000a8880: 2145 4e54 4954 5920 4f73 6c61 7368 0922 !ENTITY Oslash." │ │ │ -000a8890: 2623 7830 3044 383b 223e 203c 212d 2d20 Ø"> . . . .< │ │ │ -000a8a60: 2145 4e54 4954 5920 5448 4f52 4e09 2226 !ENTITY THORN."& │ │ │ -000a8a70: 2378 3030 4445 3b22 3e20 3c21 2d2d 204c #x00DE;"> . . . . │ │ │ -000a8c90: 0a3c 2145 4e54 4954 5920 5575 6d6c 0922 . . .< │ │ │ -000a8d20: 2145 4e54 4954 5920 5961 6375 7465 0922 !ENTITY Yacute." │ │ │ -000a8d30: 2623 7830 3044 443b 223e 203c 212d 2d20 Ý"> . │ │ │ -000a8d80: 3c21 2d2d 204c 4154 494e 2053 4d41 4c4c .... │ │ │ -000a8db0: 0024 6465 6d6f 2f64 6f63 7372 632f 446f .$demo/docsrc/Do │ │ │ -000a8dc0: 6342 6f6f 6b2f 656e 742f 6973 6f2d 6772 cBook/ent/iso-gr │ │ │ -000a8dd0: 6b34 2e65 6e74 df00 000a 583c 212d 2d20 k4.ent....X... . . . . │ │ │ -000a8ff0: 203c 212d 2d20 4752 4545 4b20 534d 414c . │ │ │ -000a9070: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . │ │ │ -000a90a0: 0a3c 2145 4e54 4954 5920 622e 6570 7369 . . . │ │ │ -000a9120: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c . │ │ │ -000a9140: 3c21 454e 5449 5459 2062 2e74 6865 7461 . . │ │ │ -000a91d0: 0a3c 2145 4e54 4954 5920 622e 696f 7461 . . . . . . . . .< │ │ │ -000a93f0: 2145 4e54 4954 5920 622e 7069 0922 2623 !ENTITY b.pi."&# │ │ │ -000a9400: 7830 3343 303b 223e 203c 212d 2d20 4752 x03C0;"> . . . . . . │ │ │ -000a95b0: 3c21 454e 5449 5459 2062 2e74 6175 0922 . . │ │ │ -000a9650: 0a3c 2145 4e54 4954 5920 622e 7068 6973 . . . . │ │ │ -000a9700: 3c21 454e 5449 5459 2062 2e63 6869 0922 . . │ │ │ -000a9790: 203c 212d 2d20 4752 4545 4b20 4341 5049 .. │ │ │ -000a98b0: 3c21 2d2d 2044 6572 6976 6564 2066 726f .. .< │ │ │ -000a9960: 2145 4e54 4954 5920 6265 7461 0922 2623 !ENTITY beta."&# │ │ │ -000a9970: 7830 3342 323b 223e 203c 212d 2d20 4752 x03B2;"> . . . . │ │ │ -000a9a50: 3c21 454e 5449 5459 2064 656c 7461 0922 . . . │ │ │ -000a9af0: 3c21 454e 5449 5459 2065 7073 6976 0922 . │ │ │ -000a9b30: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . . < │ │ │ -000a9bf0: 212d 2d20 4752 4545 4b20 4341 5049 5441 !-- GREEK CAPITA │ │ │ -000a9c00: 4c20 4c45 5454 4552 2054 4845 5441 202d L LETTER THETA - │ │ │ -000a9c10: 2d3e 0a3c 2145 4e54 4954 5920 7468 6574 ->. < │ │ │ -000a9c30: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . < │ │ │ -000a9c90: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000a9ca0: 4c45 5454 4552 204b 4150 5041 202d 2d3e LETTER KAPPA --> │ │ │ -000a9cb0: 0a3c 2145 4e54 4954 5920 6b61 7070 6176 . . . . < │ │ │ -000a9d80: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000a9d90: 4c45 5454 4552 204d 5520 2d2d 3e0a 3c21 LETTER MU -->. . . . . . . │ │ │ -000a9f00: 3c21 2d2d 2047 5245 454b 2053 4d41 4c4c . │ │ │ -000a9f20: 3c21 454e 5449 5459 2072 686f 7609 2226 . < │ │ │ -000a9f70: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000a9f80: 4c45 5454 4552 2053 4947 4d41 202d 2d3e LETTER SIGMA --> │ │ │ -000a9f90: 0a3c 2145 4e54 4954 5920 5369 676d 6109 . . │ │ │ -000a9fd0: 3c21 454e 5449 5459 2073 6967 6d61 7609 . < │ │ │ -000aa010: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000aa020: 4c45 5454 4552 2054 4155 202d 2d3e 0a3c LETTER TAU -->.< │ │ │ -000aa030: 2145 4e54 4954 5920 7570 7369 0922 2623 !ENTITY upsi."&# │ │ │ -000aa040: 7830 3343 353b 223e 203c 212d 2d20 4752 x03C5;"> . │ │ │ -000aa090: 0a3c 2145 4e54 4954 5920 7068 6973 0922 . . . │ │ │ -000aa120: 3c21 2d2d 2047 5245 454b 2050 4849 2053 . . . . < │ │ │ -000aa240: 212d 2d20 4752 4545 4b20 4341 5049 5441 !-- GREEK CAPITA │ │ │ -000aa250: 4c20 4c45 5454 4552 204f 4d45 4741 202d L LETTER OMEGA - │ │ │ -000aa260: 2d3e 0ab6 0000 0024 6465 6d6f 2f64 6f63 ->.....$demo/doc │ │ │ -000aa270: 7372 632f 446f 6342 6f6f 6b2f 656e 742f src/DocBook/ent/ │ │ │ -000aa280: 6973 6f2d 6772 6b32 2e65 6e74 df00 0006 iso-grk2.ent.... │ │ │ -000aa290: c63c 212d 2d20 6973 6f2d 6772 6b32 2e65 ... │ │ │ -000aa2e0: 3c21 2d2d 2044 6572 6976 6564 2066 726f .. . . │ │ │ -000aa460: 203c 212d 2d20 4752 4545 4b20 4341 5049 . . . │ │ │ -000aa600: 0a3c 2145 4e54 4954 5920 4961 6367 7209 . . . │ │ │ -000aa6a0: 3c21 454e 5449 5459 206f 6163 6772 0922 . . │ │ │ -000aa750: 203c 212d 2d20 4752 4545 4b20 534d 414c . < │ │ │ -000aa7a0: 212d 2d20 4752 4545 4b20 4341 5049 5441 !-- GREEK CAPITA │ │ │ -000aa7b0: 4c20 4c45 5454 4552 2055 5053 494c 4f4e L LETTER UPSILON │ │ │ -000aa7c0: 2057 4954 4820 4449 414c 5954 494b 4120 WITH DIALYTIKA │ │ │ -000aa7d0: 2d2d 3e0a 3c21 454e 5449 5459 2075 6163 -->. < │ │ │ -000aa7f0: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000aa800: 4c45 5454 4552 2055 5053 494c 4f4e 2057 LETTER UPSILON W │ │ │ -000aa810: 4954 4820 544f 4e4f 5320 2d2d 3e0a 3c21 ITH TONOS -->. . . .....$demo │ │ │ -000aa960: 2f64 6f63 7372 632f 446f 6342 6f6f 6b2f /docsrc/DocBook/ │ │ │ -000aa970: 656e 742f 6973 6f2d 6772 6b31 2e65 6e74 ent/iso-grk1.ent │ │ │ -000aa980: df00 000b b93c 212d 2d20 6973 6f2d 6772 ....... │ │ │ -000aaa80: 0a3c 2145 4e54 4954 5920 4167 7209 2226 . . . │ │ │ -000aab10: 203c 212d 2d20 4752 4545 4b20 4341 5049 . .< │ │ │ -000aab70: 2145 4e54 4954 5920 4767 7209 2226 2378 !ENTITY Ggr."&#x │ │ │ -000aab80: 3033 3933 3b22 3e20 3c21 2d2d 2047 5245 0393;"> . . │ │ │ -000aac00: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . . │ │ │ -000aac60: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . < │ │ │ -000aaca0: 212d 2d20 4752 4545 4b20 534d 414c 4c20 !-- GREEK SMALL │ │ │ -000aacb0: 4c45 5454 4552 205a 4554 4120 2d2d 3e0a LETTER ZETA -->. │ │ │ -000aacc0: 3c21 454e 5449 5459 205a 6772 0922 2623 . . │ │ │ -000aad50: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . │ │ │ -000aadb0: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . . . . . . . . . . . < │ │ │ -000ab070: 212d 2d20 4752 4545 4b20 4341 5049 5441 !-- GREEK CAPITA │ │ │ -000ab080: 4c20 4c45 5454 4552 2058 4920 2d2d 3e0a L LETTER XI -->. │ │ │ -000ab090: 3c21 454e 5449 5459 206f 6772 0922 2623 . . . . . │ │ │ -000ab1d0: 3c21 2d2d 2047 5245 454b 2043 4150 4954 . . . . │ │ │ -000ab2e0: 3c21 2d2d 2047 5245 454b 2043 4150 4954 .< │ │ │ -000ab340: 2145 4e54 4954 5920 5567 7209 2226 2378 !ENTITY Ugr."&#x │ │ │ -000ab350: 3033 4135 3b22 3e20 3c21 2d2d 2020 2d2d 03A5;"> . . . . . . │ │ │ -000ab500: 3c21 454e 5449 5459 204f 4867 7209 2226 ... │ │ │ -000ab540: 0000 2364 656d 6f2f 646f 6373 7263 2f44 ..#demo/docsrc/D │ │ │ -000ab550: 6f63 426f 6f6b 2f65 6e74 2f69 736f 2d64 ocBook/ent/iso-d │ │ │ -000ab560: 6961 2e65 6e74 df00 0003 413c 212d 2d20 ia.ent....A... < │ │ │ -000ab690: 212d 2d20 4252 4556 4520 2d2d 3e0a 3c21 !-- BREVE -->. . . . │ │ │ -000ab740: 3c21 2d2d 2044 4f55 424c 4520 4143 5554 . . │ │ │ -000ab780: 3c21 454e 5449 5459 2064 6f74 0922 2623 . . . │ │ │ -000ab820: 203c 212d 2d20 4f47 4f4e 454b 202d 2d3e │ │ │ -000ab830: 0a3c 2145 4e54 4954 5920 7269 6e67 0922 . .< │ │ │ -000ab860: 2145 4e54 4954 5920 7469 6c64 6509 2226 !ENTITY tilde."& │ │ │ -000ab870: 2378 3030 3745 3b22 3e20 3c21 2d2d 2054 #x007E;"> . ..... │ │ │ -000ab8b0: 2464 656d 6f2f 646f 6373 7263 2f44 6f63 $demo/docsrc/Doc │ │ │ -000ab8c0: 426f 6f6b 2f65 6e74 2f69 736f 2d63 7972 Book/ent/iso-cyr │ │ │ -000ab8d0: 322e 656e 74df 0000 0775 3c21 2d2d 2069 2.ent....u... │ │ │ -000ab9f0: 3c21 454e 5449 5459 2044 4a63 7909 2226 .< │ │ │ -000aba30: 2145 4e54 4954 5920 676a 6379 0922 2623 !ENTITY gjcy."&# │ │ │ -000aba40: 7830 3435 333b 223e 203c 212d 2d20 4359 x0453;"> . . . . . . .< │ │ │ -000abc60: 2145 4e54 4954 5920 7969 6379 0922 2623 !ENTITY yicy."&# │ │ │ -000abc70: 7830 3435 373b 223e 203c 212d 2d20 4359 x0457;"> . . . . │ │ │ -000abd70: 203c 212d 2d20 4359 5249 4c4c 4943 2053 . . . │ │ │ -000abe10: 3c21 454e 5449 5459 204e 4a63 7909 2226 .< │ │ │ -000abe50: 2145 4e54 4954 5920 7473 6863 7909 2226 !ENTITY tshcy."& │ │ │ -000abe60: 2378 3034 3542 3b22 3e20 3c21 2d2d 2043 #x045B;"> . .< │ │ │ -000abed0: 2145 4e54 4954 5920 6b6a 6379 0922 2623 !ENTITY kjcy."&# │ │ │ -000abee0: 7830 3435 433b 223e 203c 212d 2d20 4359 x045C;"> . . . │ │ │ -000abfd0: 0a3c 2145 4e54 4954 5920 647a 6379 0922 . .< │ │ │ -000ac010: 2145 4e54 4954 5920 445a 6379 0922 2623 !ENTITY DZcy."&# │ │ │ -000ac020: 7830 3430 463b 223e 203c 212d 2d20 4359 x040F;"> .. │ │ │ -000ac050: 0000 0024 6465 6d6f 2f64 6f63 7372 632f ...$demo/docsrc/ │ │ │ -000ac060: 446f 6342 6f6f 6b2f 656e 742f 6973 6f2d DocBook/ent/iso- │ │ │ -000ac070: 6379 7231 2e65 6e74 df00 0010 d63c 212d cyr1.ent......... < │ │ │ -000ac170: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ -000ac180: 4c4c 204c 4554 5445 5220 4120 2d2d 3e0a LL LETTER A -->. │ │ │ -000ac190: 3c21 454e 5449 5459 2041 6379 0922 2623 . . │ │ │ -000ac220: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . .< │ │ │ -000ac280: 2145 4e54 4954 5920 5663 7909 2226 2378 !ENTITY Vcy."&#x │ │ │ -000ac290: 3034 3132 3b22 3e20 3c21 2d2d 2043 5952 0412;"> . . │ │ │ -000ac310: 203c 212d 2d20 4359 5249 4c4c 4943 2043 . < │ │ │ -000ac350: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ -000ac360: 4c4c 204c 4554 5445 5220 4445 202d 2d3e LL LETTER DE --> │ │ │ -000ac370: 0a3c 2145 4e54 4954 5920 4463 7909 2226 . . . . . . .< │ │ │ -000ac4e0: 2145 4e54 4954 5920 5a48 6379 0922 2623 !ENTITY ZHcy."&# │ │ │ -000ac4f0: 7830 3431 363b 223e 203c 212d 2d20 4359 x0416;"> . . . < │ │ │ -000ac5b0: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ -000ac5c0: 4c4c 204c 4554 5445 5220 4920 2d2d 3e0a LL LETTER I -->. │ │ │ -000ac5d0: 3c21 454e 5449 5459 2049 6379 0922 2623 . . . . . < │ │ │ -000ac720: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ -000ac730: 4c4c 204c 4554 5445 5220 454c 202d 2d3e LL LETTER EL --> │ │ │ -000ac740: 0a3c 2145 4e54 4954 5920 4c63 7909 2226 . . . . < │ │ │ -000ac810: 212d 2d20 4359 5249 4c4c 4943 2053 4d41 !-- CYRILLIC SMA │ │ │ -000ac820: 4c4c 204c 4554 5445 5220 454e 202d 2d3e LL LETTER EN --> │ │ │ -000ac830: 0a3c 2145 4e54 4954 5920 4e63 7909 2226 . . . │ │ │ -000ac8c0: 203c 212d 2d20 4359 5249 4c4c 4943 2043 . .< │ │ │ -000ac920: 2145 4e54 4954 5920 5063 7909 2226 2378 !ENTITY Pcy."&#x │ │ │ -000ac930: 3034 3146 3b22 3e20 3c21 2d2d 2043 5952 041F;"> . . │ │ │ -000ac9b0: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . .< │ │ │ -000aca10: 2145 4e54 4954 5920 5363 7909 2226 2378 !ENTITY Scy."&#x │ │ │ -000aca20: 3034 3231 3b22 3e20 3c21 2d2d 2043 5952 0421;"> . . │ │ │ -000acaa0: 3c21 2d2d 2043 5952 494c 4c49 4320 4341 . . . . . . . . . . < │ │ │ -000acd00: 212d 2d20 4359 5249 4c4c 4943 2043 4150 !-- CYRILLIC CAP │ │ │ -000acd10: 4954 414c 204c 4554 5445 5220 4348 4520 ITAL LETTER CHE │ │ │ -000acd20: 2d2d 3e0a 3c21 454e 5449 5459 2073 6863 -->. │ │ │ -000acd60: 0a3c 2145 4e54 4954 5920 5348 6379 0922 . . │ │ │ -000acda0: 3c21 454e 5449 5459 2073 6863 6863 7909 │ │ │ -000acde0: 0a3c 2145 4e54 4954 5920 5348 4348 6379 . . │ │ │ -000ace40: 3c21 2d2d 2043 5952 494c 4c49 4320 534d . . │ │ │ -000aceb0: 3c21 454e 5449 5459 2079 6379 0922 2623 . . │ │ │ -000acf70: 0a3c 2145 4e54 4954 5920 534f 4654 6379 . . │ │ │ -000acfd0: 203c 212d 2d20 4359 5249 4c4c 4943 2053 . . . . . .....#demo/doc │ │ │ -000ad160: 7372 632f 446f 6342 6f6f 6b2f 656e 742f src/DocBook/ent/ │ │ │ -000ad170: 6973 6f2d 626f 782e 656e 74df 0000 0c93 iso-box.ent..... │ │ │ -000ad180: 3c21 2d2d 2069 736f 2d62 6f78 2e65 6e74 .... . . . .< │ │ │ -000ad360: 2145 4e54 4954 5920 626f 7864 6c09 2226 !ENTITY boxdl."& │ │ │ -000ad370: 2378 3235 3130 3b22 3e20 3c21 2d2d 2042 #x2510;"> . < │ │ │ -000ad3c0: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ -000ad3d0: 204c 4947 4854 2044 4f57 4e20 414e 4420 LIGHT DOWN AND │ │ │ -000ad3e0: 5249 4748 5420 2d2d 3e0a 3c21 454e 5449 RIGHT -->. . < │ │ │ -000ad450: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ -000ad460: 204c 4947 4854 2055 5020 414e 4420 484f LIGHT UP AND HO │ │ │ -000ad470: 5249 5a4f 4e54 414c 202d 2d3e 0a3c 2145 RIZONTAL -->. . │ │ │ -000ad4e0: 203c 212d 2d20 424f 5820 4452 4157 494e │ │ │ -000ad510: 0a3c 2145 4e54 4954 5920 626f 7876 6809 . . │ │ │ -000ad560: 3c21 454e 5449 5459 2062 6f78 7652 0922 . < │ │ │ -000ad670: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ -000ad680: 2044 4f57 4e20 5349 4e47 4c45 2041 4e44 DOWN SINGLE AND │ │ │ -000ad690: 2048 4f52 495a 4f4e 5441 4c20 444f 5542 HORIZONTAL DOUB │ │ │ -000ad6a0: 4c45 202d 2d3e 0a3c 2145 4e54 4954 5920 LE -->. . . │ │ │ -000ad740: 3c21 454e 5449 5459 2062 6f78 5609 2226 . │ │ │ -000ad780: 3c21 454e 5449 5459 2062 6f78 5552 0922 . . . < │ │ │ -000ad880: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ -000ad890: 2044 4f57 4e20 5349 4e47 4c45 2041 4e44 DOWN SINGLE AND │ │ │ -000ad8a0: 2052 4947 4854 2044 4f55 424c 4520 2d2d RIGHT DOUBLE -- │ │ │ -000ad8b0: 3e0a 3c21 454e 5449 5459 2062 6f78 5652 >. . < │ │ │ -000ad920: 212d 2d20 424f 5820 4452 4157 494e 4753 !-- BOX DRAWINGS │ │ │ -000ad930: 2055 5020 444f 5542 4c45 2041 4e44 2048 UP DOUBLE AND H │ │ │ -000ad940: 4f52 495a 4f4e 5441 4c20 5349 4e47 4c45 ORIZONTAL SINGLE │ │ │ -000ad950: 202d 2d3e 0a3c 2145 4e54 4954 5920 626f -->. │ │ │ -000ad970: 3c21 2d2d 2042 4f58 2044 5241 5749 4e47 . │ │ │ -000ad9c0: 203c 212d 2d20 424f 5820 4452 4157 494e . . │ │ │ -000ada50: 3c21 454e 5449 5459 2062 6f78 5672 0922 . . │ │ │ -000adb00: 3c21 2d2d 2042 4f58 2044 5241 5749 4e47 .< │ │ │ -000adb30: 2145 4e54 4954 5920 626f 7848 6409 2226 !ENTITY boxHd."& │ │ │ -000adb40: 2378 3235 3636 3b22 3e20 3c21 2d2d 2042 #x2566;"> . . . .< │ │ │ -000adcb0: 2145 4e54 4954 5920 626f 7844 7209 2226 !ENTITY boxDr."& │ │ │ -000adcc0: 2378 3235 3533 3b22 3e20 3c21 2d2d 2042 #x2553;"> . . │ │ │ -000adda0: 203c 212d 2d20 424f 5820 4452 4157 494e . .. │ │ │ -000ade90: 3c21 2d2d 2044 6572 6976 6564 2066 726f .. . .< │ │ │ -000adf70: 2145 4e54 4954 5920 6263 6f6e 6709 2226 !ENTITY bcong."& │ │ │ -000adf80: 2378 3232 3443 3b22 3e20 3c21 2d2d 2041 #x224C;"> . │ │ │ -000adfa0: 3c21 454e 5449 5459 2062 6570 7369 0922 . │ │ │ -000adfe0: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000ae010: 2145 4e54 4954 5920 6273 696d 6509 2226 !ENTITY bsime."& │ │ │ -000ae020: 2378 3232 4344 3b22 3e20 3c21 2d2d 2020 #x22CD;"> . . . │ │ │ -000ae0a0: 0a3c 2145 4e54 4954 5920 636f 6c6f 6e65 . . . │ │ │ -000ae110: 0a3c 2145 4e54 4954 5920 6375 7072 6509 . . │ │ │ -000ae150: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . .< │ │ │ -000ae180: 2145 4e54 4954 5920 6563 6f6c 6f6e 0922 !ENTITY ecolon." │ │ │ -000ae190: 2623 7832 3235 353b 223e 203c 212d 2d20 ≕"> . < │ │ │ -000ae1c0: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . < │ │ │ -000ae250: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . │ │ │ -000ae2e0: 3c21 2d2d 2047 5245 4154 4552 2d54 4841 . . . │ │ │ -000ae370: 0a3c 2145 4e54 4954 5920 6745 6c09 2226 . . . < │ │ │ -000ae3d0: 212d 2d20 5645 5259 204d 5543 4820 4752 !-- VERY MUCH GR │ │ │ -000ae3e0: 4541 5445 522d 5448 414e 202d 2d3e 0a3c EATER-THAN -->.< │ │ │ -000ae3f0: 2145 4e54 4954 5920 676c 0922 2623 7832 !ENTITY gl." │ │ │ -000ae400: 3237 373b 223e 203c 212d 2d20 202d 2d3e 277;"> │ │ │ -000ae410: 0a3c 2145 4e54 4954 5920 6773 696d 0922 . . . . . │ │ │ -000ae520: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . │ │ │ -000ae570: 0a3c 2145 4e54 4954 5920 6c67 0922 2623 . . . . . │ │ │ -000ae660: 0a3c 2145 4e54 4954 5920 6d69 6409 2226 . . │ │ │ -000ae6a0: 3c21 2d2d 204d 4f44 454c 5320 2d2d 3e0a . │ │ │ -000ae6b0: 3c21 454e 5449 5459 2070 7209 2226 2378 . < │ │ │ -000ae710: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . │ │ │ -000ae790: 0a3c 2145 4e54 4954 5920 7363 0922 2623 . . . .< │ │ │ -000ae820: 2145 4e54 4954 5920 7363 7369 6d09 2226 !ENTITY scsim."& │ │ │ -000ae830: 2378 3232 3746 3b22 3e20 3c21 2d2d 2020 #x227F;"> . │ │ │ -000ae860: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . . . . . . │ │ │ -000ae9d0: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ -000aea20: 0a3c 2145 4e54 4954 5920 7468 6b61 7009 . . . . │ │ │ -000aea90: 3c21 454e 5449 5459 2074 7769 7874 0922 . │ │ │ -000aeae0: 0a3c 2145 4e54 4954 5920 5664 6173 6809 . . │ │ │ -000aeb20: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . │ │ │ -000aeb50: 0a3c 2145 4e54 4954 5920 766c 7472 6909 . . │ │ │ -000aeb90: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . . │ │ │ -000aebc0: 3c21 454e 5449 5459 2056 7664 6173 6809 .....$demo/ │ │ │ -000aebf0: 646f 6373 7263 2f44 6f63 426f 6f6b 2f65 docsrc/DocBook/e │ │ │ -000aec00: 6e74 2f69 736f 2d61 6d73 6f2e 656e 74df nt/iso-amso.ent. │ │ │ -000aec10: 0000 049e 3c21 2d2d 2069 736f 2d61 6d73 ...... . │ │ │ -000aed30: 203c 212d 2d20 4d45 4153 5552 4544 2041 . . . . . . │ │ │ -000aee60: 0a3c 2145 4e54 4954 5920 6769 6d65 6c09 . . .< │ │ │ -000aef10: 212d 2d20 2020 2020 6a6e 6f64 6f74 0955 !-- jnodot.U │ │ │ -000aef20: 6e6b 6e6f 776e 2075 6e69 636f 6465 2063 nknown unicode c │ │ │ -000aef30: 6861 7261 6374 6572 202d 2d3e 0a3c 2145 haracter -->. . < │ │ │ -000aef90: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . < │ │ │ -000af030: 212d 2d20 534d 414c 4c20 5245 5645 5253 !-- SMALL REVERS │ │ │ -000af040: 4520 534f 4c49 4455 5320 2d2d 3e0a 3c21 E SOLIDUS -->.. ..< │ │ │ -000af130: 212d 2d20 4465 7269 7665 6420 6672 6f6d !-- Derived from │ │ │ -000af140: 2074 6865 2063 6f72 7265 7370 6f6e 6469 the correspondi │ │ │ -000af150: 6e67 2049 534f 2038 3837 3920 7374 616e ng ISO 8879 stan │ │ │ -000af160: 6461 7264 2065 6e74 6974 7920 7365 740a dard entity set. │ │ │ -000af170: 2020 2020 2061 6e64 2074 6865 2055 6e69 and the Uni │ │ │ -000af180: 636f 6465 2063 6861 7261 6374 6572 206d code character m │ │ │ -000af190: 6170 7069 6e67 7320 7072 6f76 6964 6564 appings provided │ │ │ -000af1a0: 2062 7920 5365 6261 7374 6961 6e20 5261 by Sebastian Ra │ │ │ -000af1b0: 6874 7a20 2d2d 3e0a 0a3c 2145 4e54 4954 htz -->.. . . │ │ │ -000af200: 3c21 454e 5449 5459 2067 6e45 0922 2623 . . . . . │ │ │ -000af340: 0a3c 2145 4e54 4954 5920 6e61 7009 2226 . . . . . │ │ │ -000af420: 3c21 454e 5449 5459 206e 6765 0922 2623 . │ │ │ -000af480: 3c21 2d2d 204e 4f54 2047 5245 4154 4552 . . . │ │ │ -000af4e0: 3c21 454e 5449 5459 206e 6c65 7309 2226 . . < │ │ │ -000af550: 212d 2d20 4e4f 5420 4e4f 524d 414c 2053 !-- NOT NORMAL S │ │ │ -000af560: 5542 4752 4f55 5020 4f46 202d 2d3e 0a3c UBGROUP OF -->.< │ │ │ -000af570: 2145 4e54 4954 5920 6e6c 7472 6965 0922 !ENTITY nltrie." │ │ │ -000af580: 2623 7832 3245 433b 223e 203c 212d 2d20 ⋬"> . │ │ │ -000af5d0: 203c 212d 2d20 444f 4553 204e 4f54 2044 . . . │ │ │ -000af650: 3c21 454e 5449 5459 206e 7072 6509 2226 . < │ │ │ -000af690: 212d 2d20 444f 4553 204e 4f54 2043 4f4e !-- DOES NOT CON │ │ │ -000af6a0: 5441 494e 2041 5320 4e4f 524d 414c 2053 TAIN AS NORMAL S │ │ │ -000af6b0: 5542 4752 4f55 5020 2d2d 3e0a 3c21 454e UBGROUP -->. . │ │ │ -000af740: 0a3c 2145 4e54 4954 5920 6e73 6365 0922 . . < │ │ │ -000af780: 212d 2d20 202d 2d3e 0a3c 2145 4e54 4954 !-- -->. . . . . │ │ │ -000af850: 3c21 454e 5449 5459 206e 7375 6245 0922 . < │ │ │ -000af890: 212d 2d20 4e4f 5420 4120 5355 5045 5253 !-- NOT A SUPERS │ │ │ -000af8a0: 4554 204f 4620 2d2d 3e0a 3c21 454e 5449 ET OF -->. .< │ │ │ -000af8d0: 2145 4e54 4954 5920 6e73 7570 6509 2226 !ENTITY nsupe."& │ │ │ -000af8e0: 2378 3232 3839 3b22 3e20 3c21 2d2d 2020 #x2289;"> . │ │ │ -000af910: 3c21 2d2d 2044 4f45 5320 4e4f 5420 5052 . . . . │ │ │ -000afa20: 203c 212d 2d20 202d 2d3e 0a3c 2145 4e54 . │ │ │ -000afa50: 0a3c 2145 4e54 4954 5920 7363 6e61 7009 . . │ │ │ -000afa90: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ -000afac0: 3c21 454e 5449 5459 2073 7562 6e65 0922 . │ │ │ -000afb00: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . .< │ │ │ -000afb30: 2145 4e54 4954 5920 7375 706e 4509 2226 !ENTITY supnE."& │ │ │ -000afb40: 2378 3232 3842 3b22 3e20 3c21 2d2d 2020 #x228B;"> . │ │ │ -000afb70: 3c21 2d2d 2020 2d2d 3e0a 3c21 454e 5449 . . │ │ │ -000afba0: 3c21 454e 5449 5459 2076 7375 706e 6509 . ..... │ │ │ -000afbf0: 2464 656d 6f2f 646f 6373 7263 2f44 6f63 $demo/docsrc/Doc │ │ │ -000afc00: 426f 6f6b 2f65 6e74 2f69 736f 2d61 6d73 Book/ent/iso-ams │ │ │ -000afc10: 632e 656e 74df 0000 02cd 3c21 2d2d 2069 c.ent........ │ │ │ -000afd40: 203c 212d 2d20 5249 4748 5420 464c 4f4f . . . . .. .< │ │ │ -000afeb0: 2145 4e54 4954 5920 646c 636f 726e 0922 !ENTITY dlcorn." │ │ │ -000afec0: 2623 7832 3331 453b 223e 203c 212d 2d20 ⌞"> .....$demo │ │ │ -000afef0: 2f64 6f63 7372 632f 446f 6342 6f6f 6b2f /docsrc/DocBook/ │ │ │ -000aff00: 656e 742f 6973 6f2d 616d 7362 2e65 6e74 ent/iso-amsb.ent │ │ │ -000aff10: df00 0009 733c 212d 2d20 6973 6f2d 616d ....s.. . │ │ │ -000b0060: 3c21 2d2d 204e 414e 4420 2d2d 3e0a 3c21 . . . . . . . . │ │ │ -000b0230: 3c21 2d2d 204c 4546 5420 4e4f 524d 414c .< │ │ │ -000b0260: 2145 4e54 4954 5920 6d69 6e75 7362 0922 !ENTITY minusb." │ │ │ -000b0270: 2623 7832 3239 463b 223e 203c 212d 2d20 ⊟"> .< │ │ │ -000b02d0: 2145 4e54 4954 5920 6f63 6972 0922 2623 !ENTITY ocir."&# │ │ │ -000b02e0: 7832 3239 413b 223e 203c 212d 2d20 4349 x229A;"> . . │ │ │ -000b0370: 0a3c 2145 4e54 4954 5920 6f6d 696e 7573 . . < │ │ │ -000b03c0: 212d 2d20 4349 5243 4c45 4420 504c 5553 !-- CIRCLED PLUS │ │ │ -000b03d0: 202d 2d3e 0a3c 2145 4e54 4954 5920 6f73 -->. < │ │ │ -000b03f0: 212d 2d20 4349 5243 4c45 4420 4449 5649 !-- CIRCLED DIVI │ │ │ -000b0400: 5349 4f4e 2053 4c41 5348 202d 2d3e 0a3c SION SLASH -->.< │ │ │ -000b0410: 2145 4e54 4954 5920 6f74 696d 6573 0922 !ENTITY otimes." │ │ │ -000b0420: 2623 7832 3239 373b 223e 203c 212d 2d20 ⊗"> │ │ │ -000b04a0: 0a3c 2145 4e54 4954 5920 7274 6872 6565 . .< │ │ │ -000b04e0: 2145 4e54 4954 5920 7274 696d 6573 0922 !ENTITY rtimes." │ │ │ -000b04f0: 2623 7832 3243 413b 223e 203c 212d 2d20 ⋊"> . . . < │ │ │ -000b05b0: 212d 2d20 5345 5420 4d49 4e55 5320 2d2d !-- SET MINUS -- │ │ │ -000b05c0: 3e0a 3c21 454e 5449 5459 2073 7163 6170 >. │ │ │ -000b05f0: 0a3c 2145 4e54 4954 5920 7371 6375 7009 . . │ │ │ -000b0620: 3c21 454e 5449 5459 2073 7365 746d 6e09 . . . . . .< │ │ │ -000b0740: 2145 4e54 4954 5920 7863 6972 6309 2226 !ENTITY xcirc."& │ │ │ -000b0750: 2378 3235 4342 3b22 3e20 3c21 2d2d 2057 #x25CB;"> . │ │ │ -000b0770: 3c21 454e 5449 5459 2078 6474 7269 0922 │ │ │ -000b07b0: 0a3c 2145 4e54 4954 5920 7875 7472 6909 . . │ │ │ -000b07f0: 3c21 454e 5449 5459 2063 6f70 726f 6409 . < │ │ │ -000b0840: 212d 2d20 4e2d 4152 5920 5052 4f44 5543 !-- N-ARY PRODUC │ │ │ -000b0850: 5420 2d2d 3e0a 3c21 454e 5449 5459 2073 T -->. < │ │ │ -000b0870: 212d 2d20 4e2d 4152 5920 5355 4d4d 4154 !-- N-ARY SUMMAT │ │ │ -000b0880: 494f 4e20 2d2d 3e0a b600 0000 2464 656d ION -->.....$dem │ │ │ -000b0890: 6f2f 646f 6373 7263 2f44 6f63 426f 6f6b o/docsrc/DocBook │ │ │ -000b08a0: 2f65 6e74 2f69 736f 2d61 6d73 612e 656e /ent/iso-amsa.en │ │ │ -000b08b0: 74df 0000 0e65 3c21 2d2d 2069 736f 2d61 t....e....< │ │ │ -000b0990: 2145 4e54 4954 5920 6375 6c61 7272 0922 !ENTITY cularr." │ │ │ -000b09a0: 2623 7832 3142 363b 223e 203c 212d 2d20 ↶"> . . . │ │ │ -000b0a70: 3c21 2d2d 2044 4f57 4e57 4152 4453 2050 │ │ │ -000b0a90: 0a3c 2145 4e54 4954 5920 6468 6172 6c09 . . . │ │ │ -000b0b40: 203c 212d 2d20 4c45 4654 5741 5244 5320 │ │ │ -000b0b60: 0a3c 2145 4e54 4954 5920 4c61 7272 0922 . .< │ │ │ -000b0ba0: 2145 4e54 4954 5920 6c61 7272 3209 2226 !ENTITY larr2."& │ │ │ -000b0bb0: 2378 3231 4337 3b22 3e20 3c21 2d2d 204c #x21C7;"> . . . . . . . . │ │ │ -000b0ea0: 0a3c 2145 4e54 4954 5920 6c72 6861 7232 . . │ │ │ -000b0ef0: 3c21 454e 5449 5459 206c 7368 0922 2623 .< │ │ │ -000b0f70: 2145 4e54 4954 5920 6d75 6d61 7009 2226 !ENTITY mumap."& │ │ │ -000b0f80: 2378 3232 4238 3b22 3e20 3c21 2d2d 204d #x22B8;"> . │ │ │ -000b0fd0: 0a3c 2145 4e54 4954 5920 6e6c 4172 7209 . . . . │ │ │ -000b10a0: 3c21 454e 5449 5459 206e 6861 7272 0922 │ │ │ -000b10e0: 0a3c 2145 4e54 4954 5920 6e72 6172 7209 . . .< │ │ │ -000b11a0: 2145 4e54 4954 5920 6f6c 6172 7209 2226 !ENTITY olarr."& │ │ │ -000b11b0: 2378 3231 4241 3b22 3e20 3c21 2d2d 2041 #x21BA;"> .< │ │ │ -000b1260: 2145 4e54 4954 5920 5261 7272 0922 2623 !ENTITY Rarr."&# │ │ │ -000b1270: 7832 3141 303b 223e 203c 212d 2d20 5249 x21A0;"> . . . . . . . < │ │ │ -000b1440: 212d 2d20 5249 4748 5457 4152 4453 2048 !-- RIGHTWARDS H │ │ │ -000b1450: 4152 504f 4f4e 2057 4954 4820 4241 5242 ARPOON WITH BARB │ │ │ -000b1460: 2055 5057 4152 4453 202d 2d3e 0a3c 2145 UPWARDS -->. │ │ │ -000b14b0: 0a3c 2145 4e54 4954 5920 6472 6172 7209 . . │ │ │ -000b1500: 203c 212d 2d20 534f 5554 4820 5745 5354 . . . < │ │ │ -000b15e0: 212d 2d20 5550 2044 4f57 4e20 4152 524f !-- UP DOWN ARRO │ │ │ -000b15f0: 5720 2d2d 3e0a 3c21 454e 5449 5459 2075 W -->. │ │ │ -000b1610: 203c 212d 2d20 5550 5741 5244 5320 4841 . . . │ │ │ -000b16d0: 0a3c 2145 4e54 4954 5920 7868 6172 7209 . . │ │ │ -000b1710: 203c 212d 2d20 202d 2d3e 0ab6 0000 0021 .....! │ │ │ -000b1720: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ -000b1730: 6f6f 6b2f 656e 742f 4368 616e 6765 4c6f ook/ent/ChangeLo │ │ │ -000b1740: 67df 0000 01e8 3139 3939 2d30 332d 3331 g.....1999-03-31 │ │ │ -000b1750: 2020 4e6f 726d 616e 2057 616c 7368 2020 Norman Walsh │ │ │ -000b1760: 3c6e 6477 406e 7761 6c73 682e 636f 6d3e │ │ │ -000b1770: 0a0a 092a 2069 736f 2d6e 756d 2e65 6e74 ...* iso-num.ent │ │ │ -000b1780: 3a20 5265 6d6f 7665 6420 6465 636c 6172 : Removed declar │ │ │ -000b1790: 6174 696f 6e73 2066 6f72 206c 7420 616e ations for lt an │ │ │ -000b17a0: 6420 616d 702e 2020 5468 6579 2772 6520 d amp. They're │ │ │ -000b17b0: 7072 6564 6566 696e 6564 2069 6e20 584d predefined in XM │ │ │ -000b17c0: 4c20 616e 6420 7468 6520 6465 636c 732e L and the decls. │ │ │ -000b17d0: 2077 6572 6520 6361 7573 696e 6720 4945 were causing IE │ │ │ -000b17e0: 3520 746f 2063 686f 6b65 0a0a 3139 3939 5 to choke..1999 │ │ │ -000b17f0: 2d30 312d 3331 2020 4e6f 726d 616e 2057 -01-31 Norman W │ │ │ -000b1800: 616c 7368 2020 3c6e 6477 406e 7761 6c73 alsh ...* iso-a │ │ │ -000b1820: 6d73 612e 656e 742c 2069 736f 2d61 6d73 msa.ent, iso-ams │ │ │ -000b1830: 622e 656e 742c 2069 736f 2d61 6d73 632e b.ent, iso-amsc. │ │ │ -000b1840: 656e 742c 2069 736f 2d61 6d73 6e2e 656e ent, iso-amsn.en │ │ │ -000b1850: 742c 2069 736f 2d61 6d73 6f2e 656e 742c t, iso-amso.ent, │ │ │ -000b1860: 2069 736f 2d61 6d73 722e 656e 742c 2069 iso-amsr.ent, i │ │ │ -000b1870: 736f 2d62 6f78 2e65 6e74 2c20 6973 6f2d so-box.ent, iso- │ │ │ -000b1880: 6379 7231 2e65 6e74 2c20 6973 6f2d 6379 cyr1.ent, iso-cy │ │ │ -000b1890: 7232 2e65 6e74 2c20 6973 6f2d 6469 612e r2.ent, iso-dia. │ │ │ -000b18a0: 656e 742c 2069 736f 2d67 726b 312e 656e ent, iso-grk1.en │ │ │ -000b18b0: 742c 2069 736f 2d67 726b 322e 656e 742c t, iso-grk2.ent, │ │ │ -000b18c0: 2069 736f 2d67 726b 332e 656e 742c 2069 iso-grk3.ent, i │ │ │ -000b18d0: 736f 2d67 726b 342e 656e 742c 2069 736f so-grk4.ent, iso │ │ │ -000b18e0: 2d6c 6174 312e 656e 742c 2069 736f 2d6c -lat1.ent, iso-l │ │ │ -000b18f0: 6174 322e 656e 742c 2069 736f 2d6e 756d at2.ent, iso-num │ │ │ -000b1900: 2e65 6e74 2c20 6973 6f2d 7075 622e 656e .ent, iso-pub.en │ │ │ -000b1910: 742c 2069 736f 2d74 6563 682e 656e 743a t, iso-tech.ent: │ │ │ -000b1920: 200a 094e 6577 2066 696c 652e 0a0a b600 ..New file..... │ │ │ +0008f2f0: 2566 6972 7374 6e61 6d65 2e65 6c65 6d65 %firstname.eleme │ │ │ +0008f300: 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 2066 nt;[.. │ │ │ +0008f330: 3c21 2d2d 656e 6420 6f66 2066 6972 7374 ] │ │ │ +0008f350: 5d3e 0a20 200a 3c21 454e 5449 5459 2025 ]>. ...]]>.. . . . ...]]>. ...]]>. < │ │ │ +0008f630: 212d 2d65 6e64 206f 6620 686f 6e6f 7269 !--end of honori │ │ │ +0008f640: 6669 632e 6d6f 6475 6c65 2d2d 3e5d 5d3e fic.module-->]]> │ │ │ +0008f650: 0a0a 2020 3c21 454e 5449 5459 2025 206c .. . . . . │ │ │ +0008f710: 0a3c 215b 256c 696e 6561 6765 2e65 6c65 .. │ │ │ +0008f750: 3c21 2d2d 656e 6420 6f66 206c 696e 6561 ]]> │ │ │ +0008f770: 0a20 200a 3c21 454e 5449 5459 2025 206c . ...]]>. ]]>.. . . . ...]]>. ...]]>. < │ │ │ +0008fa40: 212d 2d65 6e64 206f 6620 6f74 6865 726e !--end of othern │ │ │ +0008fa50: 616d 652e 6d6f 6475 6c65 2d2d 3e5d 5d3e ame.module-->]]> │ │ │ +0008fa60: 0a0a 2020 3c21 454e 5449 5459 2025 2073 .. . . . . │ │ │ +0008fb20: 0a3c 215b 2573 7572 6e61 6d65 2e65 6c65 .. │ │ │ +0008fb60: 3c21 2d2d 656e 6420 6f66 2073 7572 6e61 ]]> │ │ │ +0008fb80: 0a20 200a 3c21 454e 5449 5459 2025 2073 . ...]]>. ]]>.]]>.. │ │ │ +0008fc80: 3c21 2d2d 2050 7269 6e74 4869 7374 6f72 ...... │ │ │ +0008fd50: 3c21 454e 5449 5459 2025 2070 7269 6e74 .. │ │ │ +0008fdc0: 3c21 2d2d 656e 6420 6f66 2070 7269 6e74 ]]>.]]>..< │ │ │ +0008fee0: 212d 2d20 5072 6f64 7563 744e 616d 6520 !-- ProductName │ │ │ +0008fef0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +0008ff00: 2e2e 2e2e 2e2e 202d 2d3e 0a0a 3c21 454e ...... -->........]]>..< │ │ │ +00090040: 212d 2d20 436c 6173 733a 204d 6f72 6520 !-- Class: More │ │ │ +00090050: 7072 6563 6973 656c 7920 6964 656e 7469 precisely identi │ │ │ +00090060: 6669 6573 2074 6865 2069 7465 6d20 7468 fies the item th │ │ │ +00090070: 6520 656c 656d 656e 7420 6e61 6d65 7320 e element names │ │ │ +00090080: 2d2d 3e0a 0a0a 3c21 454e 5449 5459 2025 -->.... │ │ │ +000900b0: 3c21 5b25 7072 6f64 7563 746e 616d 652e .]]>.]]>........ │ │ │ +00090290: 3c21 454e 5449 5459 2025 2070 726f 6475 ..]]>..< │ │ │ +00090330: 2145 4e54 4954 5920 2520 7072 6f64 7563 !ENTITY % produc │ │ │ +00090340: 746e 756d 6265 722e 6174 746c 6973 7420 tnumber.attlist │ │ │ +00090350: 2249 4e43 4c55 4445 223e 0a3c 215b 2570 "INCLUDE">.. │ │ │ +000903e0: 3c21 2d2d 656e 6420 6f66 2070 726f 6475 ]]>.]]>..... │ │ │ +00090480: 3c21 5b25 7075 6264 6174 652e 6d6f 6475 .... │ │ │ +00090510: 3c21 5b25 7075 6264 6174 652e 656c 656d .< │ │ │ +00090550: 212d 2d65 6e64 206f 6620 7075 6264 6174 !--end of pubdat │ │ │ +00090560: 652e 656c 656d 656e 742d 2d3e 5d5d 3e0a e.element-->]]>. │ │ │ +00090570: 0a3c 2145 4e54 4954 5920 2520 7075 6264 ...]]>....]]>.]]>.. │ │ │ +000908d0: 3c21 454e 5449 5459 2025 2070 7562 6c69 . . . .< │ │ │ +00090980: 2145 4e54 4954 5920 2520 7075 626c 6973 !ENTITY % publis │ │ │ +00090990: 6865 726e 616d 652e 656c 656d 656e 7420 hername.element │ │ │ +000909a0: 2249 4e43 4c55 4445 223e 0a3c 215b 2570 "INCLUDE">..]]>. . │ │ │ +00090a20: 3c21 454e 5449 5459 2025 2070 7562 6c69 . │ │ │ +00090ad0: 0a3c 212d 2d65 6e64 206f 6620 7075 626c .]]>. ]]>. │ │ │ +00090b20: 0a20 203c 212d 2d20 4164 6472 6573 7320 . .]]> │ │ │ +00090b80: 0a0a 3c21 2d2d 2050 7562 734e 756d 6265 ....< │ │ │ +00090bb0: 2145 4e54 4954 5920 2520 7075 6273 6e75 !ENTITY % pubsnu │ │ │ +00090bc0: 6d62 6572 2e6d 6f64 756c 6520 2249 4e43 mber.module "INC │ │ │ +00090bd0: 4c55 4445 223e 0a3c 215b 2570 7562 736e LUDE">......]]>....< │ │ │ +00090d80: 212d 2d65 6e64 206f 6620 7075 6273 6e75 !--end of pubsnu │ │ │ +00090d90: 6d62 6572 2e61 7474 6c69 7374 2d2d 3e5d mber.attlist-->] │ │ │ +00090da0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 7075 ]>.]]>... │ │ │ +00090fd0: 0a3c 212d 2d65 6e64 206f 6620 7265 6c65 .]]>...... │ │ │ +000910c0: 3c21 5b25 7265 7668 6973 746f 7279 2e6d .< │ │ │ +00091100: 2145 4e54 4954 5920 2520 7265 7668 6973 !ENTITY % revhis │ │ │ +00091110: 746f 7279 2e72 6f6c 652e 6174 7472 6962 tory.role.attrib │ │ │ +00091120: 2022 2572 6f6c 652e 6174 7472 6962 3b22 "%role.attrib;" │ │ │ +00091130: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >....]]>....]] │ │ │ +00091280: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6576 >.]] │ │ │ +00091400: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >....]]>.]]>..< │ │ │ +000914e0: 2145 4e54 4954 5920 2520 7265 766e 756d !ENTITY % revnum │ │ │ +000914f0: 6265 722e 6d6f 6475 6c65 2022 494e 434c ber.module "INCL │ │ │ +00091500: 5544 4522 3e0a 3c21 5b25 7265 766e 756d UDE">..... │ │ │ +000915e0: 0a3c 212d 2d65 6e64 206f 6620 7265 766e . │ │ │ +00091600: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>...........]]>....]]>.]]>........] │ │ │ +00091ab0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>.. │ │ │ +00091ae0: 0a3c 215b 2025 7265 7664 6573 6372 6970 .. │ │ │ +00091b90: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2072 ]]>.]]>.]]>....]] │ │ │ +00091e30: 3e0a 3c21 2d2d 656e 6420 6f66 2073 6572 >.]]>..........]]>....]]>.]]>..< │ │ │ +00092090: 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e !-- ............ │ │ │ +000920a0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000920b0: 2e2e 2e2e 2e2e 202d 2d3e 0a0a 3c21 2d2d ...... -->.. │ │ │ +000920e0: 5d5d 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e ]]>.........< │ │ │ +00092230: 2145 4e54 4954 5920 2520 6163 6365 6c2e !ENTITY % accel. │ │ │ +00092240: 726f 6c65 2e61 7474 7269 6220 2225 726f role.attrib "%ro │ │ │ +00092250: 6c65 2e61 7474 7269 623b 223e 0a0a 3c21 le.attrib;">....< │ │ │ +000922c0: 212d 2d65 6e64 206f 6620 6163 6365 6c2e !--end of accel. │ │ │ +000922d0: 656c 656d 656e 742d 2d3e 5d5d 3e0a 0a3c element-->]]>..< │ │ │ +000922e0: 2145 4e54 4954 5920 2520 6163 6365 6c2e !ENTITY % accel. │ │ │ +000922f0: 6174 746c 6973 7420 2249 4e43 4c55 4445 attlist "INCLUDE │ │ │ +00092300: 223e 0a3c 215b 2561 6363 656c 2e61 7474 ">..]]>.]]>.]]>.. │ │ │ +000925c0: 0a3c 215b 2561 7070 6c69 6361 7469 6f6e .... │ │ │ +00092660: 0a3c 215b 2561 7070 6c69 6361 7469 6f6e ..]]>....]]>.]]>.... │ │ │ +00092860: 3c21 454e 5449 5459 2025 2063 6c61 7373 .... │ │ │ +00092900: 3c21 2d2d 656e 6420 6f66 2063 6c61 7373 ] │ │ │ +00092920: 5d3e 0a0a 3c21 454e 5449 5459 2025 2063 ]>... │ │ │ +000929c0: 0a3c 212d 2d65 6e64 206f 6620 636c 6173 . │ │ │ +000929e0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2063 ]]>..< │ │ │ +00092af0: 2145 4e54 4954 5920 2520 636f 2e72 6f6c !ENTITY % co.rol │ │ │ +00092b00: 652e 6174 7472 6962 2022 2572 6f6c 652e e.attrib "%role. │ │ │ +00092b10: 6174 7472 6962 3b22 3e0a 0a3c 2145 4e54 attrib;">... │ │ │ +00092b60: 0a3c 212d 2d65 6e64 206f 6620 636f 2e65 .]]>........< │ │ │ +00092c80: 212d 2d65 6e64 206f 6620 636f 2e61 7474 !--end of co.att │ │ │ +00092c90: 6c69 7374 2d2d 3e5d 5d3e 0a3c 212d 2d65 list-->]]>.]]>... │ │ │ +00092df0: 3c21 5b25 636f 6d6d 616e 642e 6174 746c │ │ │ +00092e70: 0a3c 212d 2d65 6e64 206f 6620 636f 6d6d .]] │ │ │ +00092e90: 3e0a 3c21 2d2d 656e 6420 6f66 2063 6f6d >.]] │ │ │ +00092eb0: 3e0a 0a3c 2145 4e54 4954 5920 2520 636f >...< │ │ │ +00092ee0: 215b 2563 6f6d 7075 7465 726f 7574 7075 ![%computeroutpu │ │ │ +00092ef0: 742e 6d6f 6475 6c65 3b5b 0a3c 2145 4e54 t.module;[......]]>....]]>. │ │ │ +000930f0: 3c21 2d2d 656e 6420 6f66 2063 6f6d 7075 ]]>........]]>...... │ │ │ +000932a0: 3c21 5b25 6461 7461 6261 7365 2e61 7474 .]]>.]]>... │ │ │ +00093410: 0a3c 2145 4e54 4954 5920 2520 656d 6169 ... │ │ │ +00093440: 3c21 454e 5449 5459 2025 2065 6d61 696c ..< │ │ │ +000934a0: 212d 2d65 6e64 206f 6620 656d 6169 6c2e !--end of email. │ │ │ +000934b0: 656c 656d 656e 742d 2d3e 5d5d 3e0a 0a3c element-->]]>..< │ │ │ +000934c0: 2145 4e54 4954 5920 2520 656d 6169 6c2e !ENTITY % email. │ │ │ +000934d0: 6174 746c 6973 7420 2249 4e43 4c55 4445 attlist "INCLUDE │ │ │ +000934e0: 223e 0a3c 215b 2565 6d61 696c 2e61 7474 ">..]]>.]]>.... │ │ │ +00093750: 5d5d 3e0a 0a0a 3c21 454e 5449 5459 2025 ]]>.........]]>....< │ │ │ +00093930: 212d 2d65 6e64 206f 6620 6572 726f 7263 !--end of errorc │ │ │ +00093940: 6f64 652e 6174 746c 6973 742d 2d3e 5d5d ode.attlist-->]] │ │ │ +00093950: 3e0a 3c21 2d2d 656e 6420 6f66 2065 7272 >. │ │ │ +00093970: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>....]]>.]]>.. │ │ │ +00093b80: 3c21 454e 5449 5459 2025 2065 7272 6f72 .....< │ │ │ +00093c40: 215b 2565 7272 6f72 7479 7065 2e65 6c65 ![%errortype.ele │ │ │ +00093c50: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..]]>... │ │ │ +00093cd0: 3c21 5b25 6572 726f 7274 7970 652e 6174 .]]>.]]>.. │ │ │ +00093db0: 0a3c 215b 2566 696c 656e 616d 652e 6d6f ......]]>...... │ │ │ +00093f40: 3c21 454e 5449 5459 2025 2066 696c 656e ..]]>.]]>....< │ │ │ +00094160: 2145 4e54 4954 5920 2520 6675 6e63 7469 !ENTITY % functi │ │ │ +00094170: 6f6e 2e72 6f6c 652e 6174 7472 6962 2022 on.role.attrib " │ │ │ +00094180: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ +00094190: 0a3c 2145 4e54 4954 5920 2520 6675 6e63 ...]]>... │ │ │ +00094240: 3c21 5b25 6675 6e63 7469 6f6e 2e61 7474 .]]>.]]>... │ │ │ +00094330: 3c21 5b25 6775 6962 7574 746f 6e2e 6d6f ... │ │ │ +000943a0: 3c21 454e 5449 5459 2025 2067 7569 6275 ..]]>.]]>........]]>.... │ │ │ +00094710: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2067 ]]>. │ │ │ +00094730: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.......< │ │ │ +000947f0: 215b 2567 7569 6c61 6265 6c2e 656c 656d ![%guilabel.elem │ │ │ +00094800: 656e 743b 5b0a 3c21 454c 454d 454e 5420 ent;[..]]>....]]>.]]>... │ │ │ +00094970: 3c21 5b25 6775 696d 656e 752e 6d6f 6475 .... │ │ │ +00094a00: 3c21 5b25 6775 696d 656e 752e 656c 656d .]]>...< │ │ │ +00094a90: 215b 2567 7569 6d65 6e75 2e61 7474 6c69 ![%guimenu.attli │ │ │ +00094aa0: 7374 3b5b 0a3c 2141 5454 4c49 5354 2067 st;[.. │ │ │ +00094b10: 3c21 2d2d 656e 6420 6f66 2067 7569 6d65 ]]> │ │ │ +00094b30: 0a3c 212d 2d65 6e64 206f 6620 6775 696d .]]> │ │ │ +00094b50: 0a0a 3c21 454e 5449 5459 2025 2067 7569 ..... │ │ │ +00094bf0: 0a3c 2145 4e54 4954 5920 2520 6775 696d ...]]>.. │ │ │ +00094c90: 3c21 454e 5449 5459 2025 2067 7569 6d65 ..]]>. │ │ │ +00094d70: 3c21 2d2d 656e 6420 6f66 2067 7569 6d65 │ │ │ +00094d90: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ +00094e30: 3c21 454e 5449 5459 2025 2067 7569 7375 ..]]>... │ │ │ +00094f80: 0a3c 212d 2d65 6e64 206f 6620 6775 6973 .]]>...< │ │ │ +00094ff0: 215b 2568 6172 6477 6172 652e 6d6f 6475 ![%hardware.modu │ │ │ +00095000: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[......]]>... │ │ │ +00095110: 3c21 5b25 6861 7264 7761 7265 2e61 7474 .]]>.]]>... │ │ │ +00095200: 3c21 5b25 696e 7465 7266 6163 652e 6d6f ... │ │ │ +00095270: 3c21 454e 5449 5459 2025 2069 6e74 6572 ..... │ │ │ +00095340: 3c21 454e 5449 5459 2025 2069 6e74 6572 . │ │ │ +000953f0: 0a3c 212d 2d65 6e64 206f 6620 696e 7465 . │ │ │ +00095410: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2069 ]]>.]]>.]]>........< │ │ │ +00095720: 212d 2d65 6e64 206f 6620 6b65 7963 6f64 !--end of keycod │ │ │ +00095730: 652e 656c 656d 656e 742d 2d3e 5d5d 3e0a e.element-->]]>. │ │ │ +00095740: 0a3c 2145 4e54 4954 5920 2520 6b65 7963 ...]]>.]]>...< │ │ │ +00095a70: 215b 256b 6579 7379 6d2e 6d6f 6475 6c65 ![%keysym.module │ │ │ +00095a80: 3b5b 0a3c 2145 4e54 4954 5920 2520 6c6f ;[......]]>.. │ │ │ +00095b80: 0a3c 215b 256b 6579 7379 6d2e 6174 746c ..]]>.]]>........]]>.... │ │ │ +00095e50: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 206c ]]>.]]>.. │ │ │ +00095ea0: 0a3c 215b 256c 6974 6572 616c 2e6d 6f64 .... │ │ │ +00095f30: 0a3c 215b 256c 6974 6572 616c 2e65 6c65 ..]]>..< │ │ │ +00095f90: 2145 4e54 4954 5920 2520 6c69 7465 7261 !ENTITY % litera │ │ │ +00095fa0: 6c2e 6174 746c 6973 7420 2249 4e43 4c55 l.attlist "INCLU │ │ │ +00095fb0: 4445 223e 0a3c 215b 256c 6974 6572 616c DE">..]]>.]]>........]]>.... │ │ │ +00096250: 3c21 2d2d 656e 6420 6f66 2063 6f6e 7374 ]] │ │ │ +00096270: 3e0a 3c21 2d2d 656e 6420 6f66 2063 6f6e >.] │ │ │ +00096290: 5d3e 0a0a 3c21 454e 5449 5459 2025 2076 ]>........]]>.. │ │ │ +000963b0: 3c21 454e 5449 5459 2025 2076 6172 6e61 .. │ │ │ +00096660: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>...... │ │ │ +00096700: 3c21 454e 5449 5459 2025 206d 6564 6961 .. │ │ │ +00096770: 3c21 2d2d 656e 6420 6f66 206d 6564 6961 │ │ │ +00096790: 5d5d 3e0a 0a3c 212d 2d20 436c 6173 733a ]]>...... │ │ │ +00096800: 3c21 5b25 6d65 6469 616c 6162 656c 2e61 .]]>.]]>.. │ │ │ +00096900: 3c21 454e 5449 5459 2025 206d 656e 7563 . │ │ │ +00096930: 3c21 5b25 6d65 6e75 6368 6f69 6365 2e63 ......]]>..< │ │ │ +00096ac0: 2145 4e54 4954 5920 2520 6d65 6e75 6368 !ENTITY % menuch │ │ │ +00096ad0: 6f69 6365 2e61 7474 6c69 7374 2022 494e oice.attlist "IN │ │ │ +00096ae0: 434c 5544 4522 3e0a 3c21 5b25 6d65 6e75 CLUDE">..]]>.]]>.........]]>...< │ │ │ +00096d30: 215b 2573 686f 7274 6375 742e 6174 746c ![%shortcut.attl │ │ │ +00096d40: 6973 743b 5b0a 3c21 4154 544c 4953 5420 ist;[..]]>.]]>.]]>.. │ │ │ +00096e60: 0a3c 215b 256d 6f75 7365 6275 7474 6f6e .... │ │ │ +00096f00: 0a3c 215b 256d 6f75 7365 6275 7474 6f6e ..]]>.. │ │ │ +00096f70: 3c21 454e 5449 5459 2025 206d 6f75 7365 ..]]>. │ │ │ +00097050: 3c21 2d2d 656e 6420 6f66 206d 6f75 7365 │ │ │ +00097070: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>... │ │ │ +000971b0: 3c21 5b25 6d73 6774 6578 742e 6174 746c .]]>.]]>..< │ │ │ +00097260: 2145 4e54 4954 5920 2520 6f70 7469 6f6e !ENTITY % option │ │ │ +00097270: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ +00097280: 223e 0a3c 215b 256f 7074 696f 6e2e 6d6f ">.....< │ │ │ +00097310: 215b 256f 7074 696f 6e2e 656c 656d 656e ![%option.elemen │ │ │ +00097320: 743b 5b0a 3c21 454c 454d 454e 5420 6f70 t;[..]]>..< │ │ │ +00097370: 2145 4e54 4954 5920 2520 6f70 7469 6f6e !ENTITY % option │ │ │ +00097380: 2e61 7474 6c69 7374 2022 494e 434c 5544 .attlist "INCLUD │ │ │ +00097390: 4522 3e0a 3c21 5b25 6f70 7469 6f6e 2e61 E">..]]>.]]>...... │ │ │ +000974d0: 3c21 454e 5449 5459 2025 206f 7074 696f ..]]>...< │ │ │ +00097580: 215b 256f 7074 696f 6e61 6c2e 6174 746c ![%optional.attl │ │ │ +00097590: 6973 743b 5b0a 3c21 4154 544c 4953 5420 ist;[.. │ │ │ +000975f0: 3c21 2d2d 656e 6420 6f66 206f 7074 696f ]] │ │ │ +00097610: 3e0a 3c21 2d2d 656e 6420 6f66 206f 7074 >.] │ │ │ +00097630: 5d3e 0a0a 3c21 454e 5449 5459 2025 2070 ]>........]]>..... │ │ │ +00097790: 3c21 454e 5449 5459 2025 2070 6172 616d ..]]>.]]>........]]>.... │ │ │ +00097a70: 3c21 2d2d 656e 6420 6f66 2070 726f 6d70 ]]>. │ │ │ +00097a90: 3c21 2d2d 656e 6420 6f66 2070 726f 6d70 ]]>.. │ │ │ +00097ab0: 3c21 454e 5449 5459 2025 2070 726f 7065 . │ │ │ +00097b10: 0a3c 2145 4e54 4954 5920 2520 7072 6f70 .....]]>.. │ │ │ +00097bd0: 3c21 454e 5449 5459 2025 2070 726f 7065 ..]]>.]]>.. │ │ │ +00097cc0: 3c21 454e 5449 5459 2025 2072 6570 6c61 ....< │ │ │ +00097d60: 2145 4e54 4954 5920 2520 7265 706c 6163 !ENTITY % replac │ │ │ +00097d70: 6561 626c 652e 656c 656d 656e 7420 2249 eable.element "I │ │ │ +00097d80: 4e43 4c55 4445 223e 0a3c 215b 2572 6570 NCLUDE">..< │ │ │ +00097e50: 212d 2d65 6e64 206f 6620 7265 706c 6163 !--end of replac │ │ │ +00097e60: 6561 626c 652e 656c 656d 656e 742d 2d3e eable.element--> │ │ │ +00097e70: 5d5d 3e0a 0a3c 212d 2d20 436c 6173 733a ]]>..... │ │ │ +00097ec0: 3c21 454e 5449 5459 2025 2072 6570 6c61 ..]]> │ │ │ +00097fd0: 0a3c 212d 2d65 6e64 206f 6620 7265 706c .]]>....]]>.]]>..< │ │ │ +00098220: 2145 4e54 4954 5920 2520 7367 6d6c 7461 !ENTITY % sgmlta │ │ │ +00098230: 672e 6d6f 6475 6c65 2022 494e 434c 5544 g.module "INCLUD │ │ │ +00098240: 4522 3e0a 3c21 5b25 7367 6d6c 7461 672e E">...........< │ │ │ +00098500: 212d 2d65 6e64 206f 6620 7367 6d6c 7461 !--end of sgmlta │ │ │ +00098510: 672e 6174 746c 6973 742d 2d3e 5d5d 3e0a g.attlist-->]]>. │ │ │ +00098520: 3c21 2d2d 656e 6420 6f66 2073 676d 6c74 ]]>. │ │ │ +00098540: 0a3c 2145 4e54 4954 5920 2520 7374 7275 ..... │ │ │ +000985e0: 3c21 454e 5449 5459 2025 2073 7472 7563 ..]]>.... │ │ │ +00098720: 3c21 2d2d 656e 6420 6f66 2073 7472 7563 ]]>... │ │ │ +000987d0: 0a3c 2145 4e54 4954 5920 2520 7374 7275 .....]]>....]]>. │ │ │ +00098960: 3c21 2d2d 656e 6420 6f66 2073 7472 7563 ] │ │ │ +00098980: 5d3e 0a0a 3c21 454e 5449 5459 2025 2073 ]>....< │ │ │ +000989e0: 2145 4e54 4954 5920 2520 7379 6d62 6f6c !ENTITY % symbol │ │ │ +000989f0: 2e72 6f6c 652e 6174 7472 6962 2022 2572 .role.attrib "%r │ │ │ +00098a00: 6f6c 652e 6174 7472 6962 3b22 3e0a 0a3c ole.attrib;">..< │ │ │ +00098a10: 2145 4e54 4954 5920 2520 7379 6d62 6f6c !ENTITY % symbol │ │ │ +00098a20: 2e65 6c65 6d65 6e74 2022 494e 434c 5544 .element "INCLUD │ │ │ +00098a30: 4522 3e0a 3c21 5b25 7379 6d62 6f6c 2e65 E">..] │ │ │ +00098a90: 5d3e 0a0a 3c21 2d2d 2043 6c61 7373 3a20 ]>.... │ │ │ +00098ac0: 0a3c 2145 4e54 4954 5920 2520 7379 6d62 ...]]>.]]>... │ │ │ +00098c10: 0a3c 2145 4e54 4954 5920 2520 7379 7374 .....< │ │ │ +00098cc0: 212d 2d65 6e64 206f 6620 7379 7374 656d !--end of system │ │ │ +00098cd0: 6974 656d 2e65 6c65 6d65 6e74 2d2d 3e5d item.element-->] │ │ │ +00098ce0: 5d3e 0a0a 3c21 2d2d 2043 6c61 7373 3a20 ]>..... │ │ │ +00098d50: 3c21 5b25 7379 7374 656d 6974 656d 2e61 .]]>.< │ │ │ +00098ea0: 212d 2d65 6e64 206f 6620 7379 7374 656d !--end of system │ │ │ +00098eb0: 6974 656d 2e6d 6f64 756c 652d 2d3e 5d5d item.module-->]] │ │ │ +00098ec0: 3e0a 0a0a 3c21 454e 5449 5459 2025 2074 >........< │ │ │ +00098f70: 215b 2574 6f6b 656e 2e65 6c65 6d65 6e74 ![%token.element │ │ │ +00098f80: 3b5b 0a3c 2145 4c45 4d45 4e54 2074 6f6b ;[..]]>... │ │ │ +00098ff0: 3c21 5b25 746f 6b65 6e2e 6174 746c 6973 . │ │ │ +00099070: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2074 ]]>.]] │ │ │ +00099090: 3e0a 0a3c 2145 4e54 4954 5920 2520 7479 >........]] │ │ │ +00099190: 3e0a 0a3c 2145 4e54 4954 5920 2520 7479 >....]] │ │ │ +00099250: 3e0a 0a3c 2145 4e54 4954 5920 2520 7573 >........]]>.]]>..........]]>....]]>.]]>... │ │ │ +000997d0: 3c21 5b25 6163 726f 6e79 6d2e 6174 746c .]]>.]]>..< │ │ │ +00099880: 2145 4e54 4954 5920 2520 6369 7461 7469 !ENTITY % citati │ │ │ +00099890: 6f6e 2e6d 6f64 756c 6520 2249 4e43 4c55 on.module "INCLU │ │ │ +000998a0: 4445 223e 0a3c 215b 2563 6974 6174 696f DE">.. │ │ │ +000998e0: 3c21 454e 5449 5459 2025 2063 6974 6174 │ │ │ +00099910: 0a0a 3c21 454e 5449 5459 2025 2063 6974 ....]]>.. │ │ │ +000999c0: 0a3c 215b 2563 6974 6174 696f 6e2e 6174 .. │ │ │ +00099a50: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2063 ]]>.]]>....]]>.]]> │ │ │ +00099cb0: 0a0a 3c21 454e 5449 5459 2025 2072 6566 ........ │ │ │ +00099df0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.. │ │ │ +00099e20: 0a3c 215b 2572 6566 656e 7472 7974 6974 ..]]>.] │ │ │ +00099ef0: 5d3e 0a0a 3c21 454e 5449 5459 2025 206d ]>........]]>.]]>.. │ │ │ +0009a120: 0a3c 215b 2563 6974 6574 6974 6c65 2e6d ... │ │ │ +0009a190: 0a3c 2145 4e54 4954 5920 2520 6369 7465 ...]]>.......]]>.]]>... │ │ │ +0009a3f0: 3c21 5b25 656d 7068 6173 6973 2e6d 6f64 ..... │ │ │ +0009a4e0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.< │ │ │ +0009a5a0: 212d 2d65 6e64 206f 6620 656d 7068 6173 !--end of emphas │ │ │ +0009a5b0: 6973 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a is.module-->]]>. │ │ │ +0009a5c0: 0a3c 2145 4e54 4954 5920 2520 6669 7273 ...... │ │ │ +0009a680: 3c21 5b25 6669 7273 7474 6572 6d2e 656c . │ │ │ +0009a6c0: 3c21 2d2d 656e 6420 6f66 2066 6972 7374 ] │ │ │ +0009a6e0: 5d3e 0a0a 3c21 2d2d 2074 6f20 476c 6f73 ]>... │ │ │ +0009a710: 0a0a 3c21 454e 5449 5459 2025 2066 6972 ... │ │ │ +0009a7c0: 0a3c 212d 2d65 6e64 206f 6620 6669 7273 . │ │ │ +0009a7e0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2066 ]]>.]]>....]] │ │ │ +0009aa20: 3e0a 3c21 2d2d 656e 6420 6f66 2066 6f72 >.]]>... │ │ │ +0009aa70: 3c21 5b25 676c 6f73 7374 6572 6d2e 6d6f ... │ │ │ +0009aae0: 3c21 454e 5449 5459 2025 2067 6c6f 7373 ..]]>........]]>.]]>...< │ │ │ +0009ad20: 215b 2570 6872 6173 652e 6d6f 6475 6c65 ![%phrase.module │ │ │ +0009ad30: 3b5b 0a3c 2145 4e54 4954 5920 2520 6c6f ;[...... │ │ │ +0009aeb0: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2070 ]]>.] │ │ │ +0009aed0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2071 ]>.......< │ │ │ +0009af80: 215b 2571 756f 7465 2e65 6c65 6d65 6e74 ![%quote.element │ │ │ +0009af90: 3b5b 0a3c 2145 4c45 4d45 4e54 2071 756f ;[..]]>.< │ │ │ +0009b080: 212d 2d65 6e64 206f 6620 7175 6f74 652e !--end of quote. │ │ │ +0009b090: 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a 3c21 module-->]]>....< │ │ │ +0009b100: 2145 4e54 4954 5920 2520 7373 7363 7269 !ENTITY % ssscri │ │ │ +0009b110: 7074 2e72 6f6c 652e 6174 7472 6962 2022 pt.role.attrib " │ │ │ +0009b120: 2572 6f6c 652e 6174 7472 6962 3b22 3e0a %role.attrib;">. │ │ │ +0009b130: 0a3c 2145 4e54 4954 5920 2520 7375 6273 ...]]>....]]>....]]>....]]> │ │ │ +0009b510: 0a3c 212d 2d65 6e64 206f 6620 7373 7363 .]] │ │ │ +0009b530: 3e0a 0a3c 2145 4e54 4954 5920 2520 7472 >........]]>.......]]>.]]>...... │ │ │ +0009b920: 0a3c 215b 2577 6f72 6461 7377 6f72 642e ..]]>.. │ │ │ +0009b9b0: 0a3c 215b 2577 6f72 6461 7377 6f72 642e ..]]>.]]> │ │ │ +0009ba70: 0a0a 3c21 2d2d 204c 696e 6b73 2061 6e64 ..]]>.........]]>. │ │ │ +0009be10: 3c21 2d2d 656e 6420 6f66 206c 696e 6b2e ]]>.. │ │ │ +0009be50: 0a3c 215b 256f 6c69 6e6b 2e6d 6f64 756c ..... │ │ │ +0009bf10: 0a3c 212d 2d65 6e64 206f 6620 6f6c 696e .]]>. │ │ │ +0009bf30: 0a3c 212d 2d20 5461 7267 6574 446f 6345 .... │ │ │ +0009c050: 0a0a 0a3c 2145 4e54 4954 5920 2520 6f6c .....]]>.]]>.... │ │ │ +0009c210: 0a0a 3c21 454e 5449 5459 2025 2075 6c69 ....]]>.......< │ │ │ +0009c320: 215b 2575 6c69 6e6b 2e61 7474 6c69 7374 ![%ulink.attlist │ │ │ +0009c330: 3b5b 0a3c 2141 5454 4c49 5354 2075 6c69 ;[..] │ │ │ +0009c3d0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 756c ]>.]]> │ │ │ +0009c3f0: 0a0a 3c21 454e 5449 5459 2025 2066 6f6f ..... │ │ │ +0009c490: 0a3c 2145 4e54 4954 5920 2520 666f 6f74 ...]]>.......]]>.]]>. │ │ │ +0009c660: 0a3c 2145 4e54 4954 5920 2520 7872 6566 ....... │ │ │ +0009c730: 3c21 2d2d 656e 6420 6f66 2078 7265 662e ]]>..< │ │ │ +0009c750: 212d 2d20 456e 6474 6572 6d3a 2049 4420 !-- Endterm: ID │ │ │ +0009c760: 6f66 2065 6c65 6d65 6e74 2063 6f6e 7461 of element conta │ │ │ +0009c770: 696e 696e 6720 7465 7874 2074 6861 7420 ining text that │ │ │ +0009c780: 6973 2074 6f20 6265 0a09 0966 6574 6368 is to be...fetch │ │ │ +0009c790: 6564 2066 726f 6d20 656c 7365 7768 6572 ed from elsewher │ │ │ +0009c7a0: 6520 696e 2074 6865 2064 6f63 756d 656e e in the documen │ │ │ +0009c7b0: 7420 746f 2061 7070 6561 7220 6173 0a09 t to appear as.. │ │ │ +0009c7c0: 0974 6865 2063 6f6e 7465 6e74 206f 6620 .the content of │ │ │ +0009c7d0: 7468 6973 2065 6c65 6d65 6e74 202d 2d3e this element --> │ │ │ +0009c7e0: 0a3c 212d 2d20 746f 206c 696e 6b65 642d .... │ │ │ +0009c800: 3c21 454e 5449 5459 2025 2078 7265 662e ..]] │ │ │ +0009c8d0: 3e0a 3c21 2d2d 656e 6420 6f66 2078 7265 >.]]>.. │ │ │ +0009c8f0: 3c21 2d2d 2055 6269 7175 6974 6f75 7320 . │ │ │ +0009c940: 0a3c 2145 4e54 4954 5920 2520 616e 6368 ..... │ │ │ +0009c9f0: 0a3c 215b 2561 6e63 686f 722e 656c 656d ..]]>..< │ │ │ +0009ca40: 212d 2d20 7265 7175 6972 6564 202d 2d3e !-- required --> │ │ │ +0009ca50: 0a3c 212d 2d20 7265 706c 6163 6573 204c .....< │ │ │ +0009ca90: 215b 2561 6e63 686f 722e 6174 746c 6973 ![%anchor.attlis │ │ │ +0009caa0: 743b 5b0a 3c21 4154 544c 4953 5420 616e t;[..]]>.]]>... │ │ │ +0009cc00: 0a3c 2145 4e54 4954 5920 2520 6265 6769 .....< │ │ │ +0009cc90: 212d 2d65 6e64 206f 6620 6265 6769 6e70 !--end of beginp │ │ │ +0009cca0: 6167 652e 656c 656d 656e 742d 2d3e 5d5d age.element-->]] │ │ │ +0009ccb0: 3e0a 0a3c 212d 2d20 5061 6765 4e75 6d3a >..... │ │ │ +0009ccf0: 3c21 454e 5449 5459 2025 2062 6567 696e .. │ │ │ +0009cda0: 3c21 2d2d 656e 6420 6f66 2062 6567 696e ] │ │ │ +0009cdc0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 6265 ]>.... │ │ │ +0009ceb0: 0a3c 215b 2569 6e64 6578 7465 726d 2e6d ... │ │ │ +0009cf20: 0a3c 2145 4e54 4954 5920 2520 696e 6465 ...]]>.........< │ │ │ +0009d310: 215b 2569 6e64 6578 7465 726d 2e61 7474 ![%indexterm.att │ │ │ +0009d320: 6c69 7374 3b5b 0a3c 2141 5454 4c49 5354 list;[..]]>.< │ │ │ +0009d490: 212d 2d65 6e64 206f 6620 696e 6465 7874 !--end of indext │ │ │ +0009d4a0: 6572 6d2e 6d6f 6475 6c65 2d2d 3e5d 5d3e erm.module-->]]> │ │ │ +0009d4b0: 0a0a 3c21 454e 5449 5459 2025 2070 7269 .........]]>... │ │ │ +0009d740: 0a3c 215b 2573 6563 6f6e 6461 7279 2e65 ..]]>.]]>. │ │ │ +0009d8f0: 0a0a 3c21 454e 5449 5459 2025 2074 6572 ....]]>... │ │ │ +0009da10: 0a3c 215b 2574 6572 7469 6172 792e 6174 .. │ │ │ +0009daa0: 3c21 2d2d 656e 6420 6f66 2074 6572 7469 ]] │ │ │ +0009dac0: 3e0a 0a3c 212d 2d65 6e64 206f 6620 7072 >..]]>....] │ │ │ +0009dca0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2073 ]>....]]>.. │ │ │ +0009dd50: 0a3c 215b 2573 6565 616c 736f 2e61 7474 ..]]>.]] │ │ │ +0009de30: 3e0a 0a3c 212d 2d20 456e 6420 6f66 2044 >.....Tab │ │ │ +0009e2b0: 6c65 2054 6573 743c 2f74 6974 6c65 3e0a le Test. │ │ │ +0009e2c0: 0a3c 212d 2d20 5468 6973 2074 6162 6c65 .. │ │ │ +0009e310: 0a3c 696e 666f 726d 616c 7461 626c 6520 .... │ │ │ +0009e350: 3c72 6f77 3e0a 3c65 6e74 7279 3e66 6f6f .foo │ │ │ +0009e360: 3c2f 656e 7472 793e 3c2f 726f 773e 0a3c .< │ │ │ +0009e370: 726f 773e 3c65 6e74 7279 3e62 6172 3c2f row>bar... │ │ │ +0009e3a0: 3c2f 696e 666f 726d 616c 7461 626c 653e │ │ │ +0009e3b0: 0a0a 3c74 6162 6c65 2069 643d 2262 6172 ..bar │ │ │ +0009e3e0: 0a3c 7467 726f 7570 2063 6f6c 733d 2231 ... │ │ │ +0009e400: 3c65 6e74 7279 3e62 6172 3c2f 656e 7472 bar..... │ │ │ +0009e440: 0a0a b600 0000 1d64 656d 6f2f 646f 6373 .......demo/docs │ │ │ +0009e450: 7263 2f44 6f63 426f 6f6b 2f43 4f50 5952 rc/DocBook/COPYR │ │ │ +0009e460: 4947 4854 df00 0004 2c44 6f63 426b 2058 IGHT....,DocBk X │ │ │ +0009e470: 4d4c 2056 332e 312e 3720 4454 440a 436f ML V3.1.7 DTD.Co │ │ │ +0009e480: 7079 7269 6768 7420 2843 2920 3139 3938 pyright (C) 1998 │ │ │ +0009e490: 2c20 3139 3939 204e 6f72 6d61 6e20 5761 , 1999 Norman Wa │ │ │ +0009e4a0: 6c73 680a 6874 7470 3a2f 2f6e 7761 6c73 lsh.http://nwals │ │ │ +0009e4b0: 682e 636f 6d2f 646f 6362 6f6f 6b2f 786d h.com/docbook/xm │ │ │ +0009e4c0: 6c2f 0a0a 596f 7520 6d61 7920 6469 7374 l/..You may dist │ │ │ +0009e4d0: 7269 6275 7465 2074 6869 7320 4454 4420 ribute this DTD │ │ │ +0009e4e0: 756e 6465 7220 7468 6520 7361 6d65 2074 under the same t │ │ │ +0009e4f0: 6572 6d73 2061 7320 446f 6342 6f6f 6b2e erms as DocBook. │ │ │ +0009e500: 0a0a 506c 6561 7365 2064 6972 6563 7420 ..Please direct │ │ │ +0009e510: 616c 6c20 7175 6573 7469 6f6e 7320 616e all questions an │ │ │ +0009e520: 6420 636f 6d6d 656e 7473 2061 626f 7574 d comments about │ │ │ +0009e530: 2074 6869 7320 4454 4420 746f 0a4e 6f72 this DTD to.Nor │ │ │ +0009e540: 6d61 6e20 5761 6c73 682c 203c 6e64 7740 man Walsh, ...Th │ │ │ +0009e560: 6973 2044 5444 2069 7320 6261 7365 6420 is DTD is based │ │ │ +0009e570: 6f6e 2074 6865 2044 6f63 426f 6f6b 2056 on the DocBook V │ │ │ +0009e580: 332e 3120 4454 4420 6672 6f6d 204f 4153 3.1 DTD from OAS │ │ │ +0009e590: 4953 3a0a 0a20 205b 446f 6342 6f6f 6b20 IS:.. [DocBook │ │ │ +0009e5a0: 6973 5d20 436f 7079 7269 6768 7420 3139 is] Copyright 19 │ │ │ +0009e5b0: 3932 2c20 3139 3933 2c20 3139 3934 2c20 92, 1993, 1994, │ │ │ +0009e5c0: 3139 3935 2c20 3139 3936 2c20 3139 3938 1995, 1996, 1998 │ │ │ +0009e5d0: 2c0a 2020 3139 3939 2048 614c 2043 6f6d ,. 1999 HaL Com │ │ │ +0009e5e0: 7075 7465 7220 5379 7374 656d 732c 2049 puter Systems, I │ │ │ +0009e5f0: 6e63 2e2c 204f 2752 6569 6c6c 7920 2620 nc., O'Reilly & │ │ │ +0009e600: 4173 736f 6369 6174 6573 2c20 496e 632e Associates, Inc. │ │ │ +0009e610: 2c0a 2020 4172 626f 7254 6578 742c 2049 ,. ArborText, I │ │ │ +0009e620: 6e63 2e2c 2046 756a 6974 7375 2053 6f66 nc., Fujitsu Sof │ │ │ +0009e630: 7477 6172 6520 436f 7270 6f72 6174 696f tware Corporatio │ │ │ +0009e640: 6e2c 2061 6e64 2074 6865 0a20 204f 7267 n, and the. Org │ │ │ +0009e650: 616e 697a 6174 696f 6e20 666f 7220 7468 anization for th │ │ │ +0009e660: 6520 4164 7661 6e63 656d 656e 7420 6f66 e Advancement of │ │ │ +0009e670: 2053 7472 7563 7475 7265 6420 496e 666f Structured Info │ │ │ +0009e680: 726d 6174 696f 6e0a 2020 5374 616e 6461 rmation. Standa │ │ │ +0009e690: 7264 7320 284f 4153 4953 292e 0a0a 2020 rds (OASIS)... │ │ │ +0009e6a0: 5065 726d 6973 7369 6f6e 2074 6f20 7573 Permission to us │ │ │ +0009e6b0: 652c 2063 6f70 792c 206d 6f64 6966 7920 e, copy, modify │ │ │ +0009e6c0: 616e 6420 6469 7374 7269 6275 7465 2074 and distribute t │ │ │ +0009e6d0: 6865 2044 6f63 426f 6f6b 0a20 2044 5444 he DocBook. DTD │ │ │ +0009e6e0: 2061 6e64 2069 7473 2061 6363 6f6d 7061 and its accompa │ │ │ +0009e6f0: 6e79 696e 6720 646f 6375 6d65 6e74 6174 nying documentat │ │ │ +0009e700: 696f 6e20 666f 7220 616e 7920 7075 7270 ion for any purp │ │ │ +0009e710: 6f73 6520 616e 640a 2020 7769 7468 6f75 ose and. withou │ │ │ +0009e720: 7420 6665 6520 6973 2068 6572 6562 7920 t fee is hereby │ │ │ +0009e730: 6772 616e 7465 6420 696e 2070 6572 7065 granted in perpe │ │ │ +0009e740: 7475 6974 792c 2070 726f 7669 6465 6420 tuity, provided │ │ │ +0009e750: 7468 6174 0a20 2074 6865 2061 626f 7665 that. the above │ │ │ +0009e760: 2063 6f70 7972 6967 6874 206e 6f74 6963 copyright notic │ │ │ +0009e770: 6520 616e 6420 7468 6973 2070 6172 6167 e and this parag │ │ │ +0009e780: 7261 7068 2061 7070 6561 7220 696e 2061 raph appear in a │ │ │ +0009e790: 6c6c 0a20 2063 6f70 6965 732e 2020 5468 ll. copies. Th │ │ │ +0009e7a0: 6520 636f 7079 7269 6768 7420 686f 6c64 e copyright hold │ │ │ +0009e7b0: 6572 7320 6d61 6b65 206e 6f20 7265 7072 ers make no repr │ │ │ +0009e7c0: 6573 656e 7461 7469 6f6e 2061 626f 7574 esentation about │ │ │ +0009e7d0: 0a20 2074 6865 2073 7569 7461 6269 6c69 . the suitabili │ │ │ +0009e7e0: 7479 206f 6620 7468 6520 4454 4420 666f ty of the DTD fo │ │ │ +0009e7f0: 7220 616e 7920 7075 7270 6f73 652e 2020 r any purpose. │ │ │ +0009e800: 4974 2069 7320 7072 6f76 6964 6564 0a20 It is provided. │ │ │ +0009e810: 2022 6173 2069 7322 2077 6974 686f 7574 "as is" without │ │ │ +0009e820: 2065 7870 7265 7373 6564 206f 7220 696d expressed or im │ │ │ +0009e830: 706c 6965 6420 7761 7272 616e 7479 2e0a plied warranty.. │ │ │ +0009e840: 0a46 6f72 206d 6f72 6520 696e 666f 726d .For more inform │ │ │ +0009e850: 6174 696f 6e20 6162 6f75 7420 7468 6520 ation about the │ │ │ +0009e860: 446f 6342 6f6f 6b20 4454 442c 2073 6565 DocBook DTD, see │ │ │ +0009e870: 200a 6874 7470 3a2f 2f77 7777 2e6f 6173 .http://www.oas │ │ │ +0009e880: 6973 2d6f 7065 6e2e 6f72 672f 646f 6362 is-open.org/docb │ │ │ +0009e890: 6f6f 6b2f 0ab6 0000 001f 6465 6d6f 2f64 ook/......demo/d │ │ │ +0009e8a0: 6f63 7372 632f 446f 6342 6f6f 6b2f 6462 ocsrc/DocBook/db │ │ │ +0009e8b0: 6365 6e74 782e 6d6f 64df 0000 1842 3c21 centx.mod....B....< │ │ │ +0009e9b0: 212d 2d20 436f 7079 7269 6768 7420 3139 !-- Copyright 19 │ │ │ +0009e9c0: 3932 2d32 3030 3020 4861 4c20 436f 6d70 92-2000 HaL Comp │ │ │ +0009e9d0: 7574 6572 2053 7973 7465 6d73 2c20 496e uter Systems, In │ │ │ +0009e9e0: 632e 2c0a 2020 2020 204f 2752 6569 6c6c c.,. O'Reill │ │ │ +0009e9f0: 7920 2620 4173 736f 6369 6174 6573 2c20 y & Associates, │ │ │ +0009ea00: 496e 632e 2c20 4172 626f 7254 6578 742c Inc., ArborText, │ │ │ +0009ea10: 2049 6e63 2e2c 2046 756a 6974 7375 2053 Inc., Fujitsu S │ │ │ +0009ea20: 6f66 7477 6172 650a 2020 2020 2043 6f72 oftware. Cor │ │ │ +0009ea30: 706f 7261 7469 6f6e 2c20 4e6f 726d 616e poration, Norman │ │ │ +0009ea40: 2057 616c 7368 2c20 616e 6420 7468 6520 Walsh, and the │ │ │ +0009ea50: 4f72 6761 6e69 7a61 7469 6f6e 2066 6f72 Organization for │ │ │ +0009ea60: 2074 6865 2041 6476 616e 6365 6d65 6e74 the Advancement │ │ │ +0009ea70: 0a20 2020 2020 6f66 2053 7472 7563 7475 . of Structu │ │ │ +0009ea80: 7265 6420 496e 666f 726d 6174 696f 6e20 red Information │ │ │ +0009ea90: 5374 616e 6461 7264 7320 284f 4153 4953 Standards (OASIS │ │ │ +0009eaa0: 292e 0a0a 2020 2020 2024 4964 240a 0a20 )... $Id$.. │ │ │ +0009eab0: 2020 2020 5065 726d 6973 7369 6f6e 2074 Permission t │ │ │ +0009eac0: 6f20 7573 652c 2063 6f70 792c 206d 6f64 o use, copy, mod │ │ │ +0009ead0: 6966 7920 616e 6420 6469 7374 7269 6275 ify and distribu │ │ │ +0009eae0: 7465 2074 6865 2044 6f63 426f 6f6b 2058 te the DocBook X │ │ │ +0009eaf0: 4d4c 2044 5444 0a20 2020 2020 616e 6420 ML DTD. and │ │ │ +0009eb00: 6974 7320 6163 636f 6d70 616e 7969 6e67 its accompanying │ │ │ +0009eb10: 2064 6f63 756d 656e 7461 7469 6f6e 2066 documentation f │ │ │ +0009eb20: 6f72 2061 6e79 2070 7572 706f 7365 2061 or any purpose a │ │ │ +0009eb30: 6e64 2077 6974 686f 7574 2066 6565 0a20 nd without fee. │ │ │ +0009eb40: 2020 2020 6973 2068 6572 6562 7920 6772 is hereby gr │ │ │ +0009eb50: 616e 7465 6420 696e 2070 6572 7065 7475 anted in perpetu │ │ │ +0009eb60: 6974 792c 2070 726f 7669 6465 6420 7468 ity, provided th │ │ │ +0009eb70: 6174 2074 6865 2061 626f 7665 2063 6f70 at the above cop │ │ │ +0009eb80: 7972 6967 6874 0a20 2020 2020 6e6f 7469 yright. noti │ │ │ +0009eb90: 6365 2061 6e64 2074 6869 7320 7061 7261 ce and this para │ │ │ +0009eba0: 6772 6170 6820 6170 7065 6172 2069 6e20 graph appear in │ │ │ +0009ebb0: 616c 6c20 636f 7069 6573 2e20 2054 6865 all copies. The │ │ │ +0009ebc0: 2063 6f70 7972 6967 6874 0a20 2020 2020 copyright. │ │ │ +0009ebd0: 686f 6c64 6572 7320 6d61 6b65 206e 6f20 holders make no │ │ │ +0009ebe0: 7265 7072 6573 656e 7461 7469 6f6e 2061 representation a │ │ │ +0009ebf0: 626f 7574 2074 6865 2073 7569 7461 6269 bout the suitabi │ │ │ +0009ec00: 6c69 7479 206f 6620 7468 6520 4454 4420 lity of the DTD │ │ │ +0009ec10: 666f 720a 2020 2020 2061 6e79 2070 7572 for. any pur │ │ │ +0009ec20: 706f 7365 2e20 2049 7420 6973 2070 726f pose. It is pro │ │ │ +0009ec30: 7669 6465 6420 2261 7320 6973 2220 7769 vided "as is" wi │ │ │ +0009ec40: 7468 6f75 7420 6578 7072 6573 7365 6420 thout expressed │ │ │ +0009ec50: 6f72 2069 6d70 6c69 6564 0a20 2020 2020 or implied. │ │ │ +0009ec60: 7761 7272 616e 7479 2e0a 0a20 2020 2020 warranty... │ │ │ +0009ec70: 4966 2079 6f75 206d 6f64 6966 7920 7468 If you modify th │ │ │ +0009ec80: 6520 446f 6342 6f6f 6b20 584d 4c20 4454 e DocBook XML DT │ │ │ +0009ec90: 4420 696e 2061 6e79 2077 6179 2c20 6578 D in any way, ex │ │ │ +0009eca0: 6365 7074 2066 6f72 2064 6563 6c61 7269 cept for declari │ │ │ +0009ecb0: 6e67 2061 6e64 0a20 2020 2020 7265 6665 ng and. refe │ │ │ +0009ecc0: 7265 6e63 696e 6720 6164 6469 7469 6f6e rencing addition │ │ │ +0009ecd0: 616c 2073 6574 7320 6f66 2067 656e 6572 al sets of gener │ │ │ +0009ece0: 616c 2065 6e74 6974 6965 7320 616e 6420 al entities and │ │ │ +0009ecf0: 6465 636c 6172 696e 670a 2020 2020 2061 declaring. a │ │ │ +0009ed00: 6464 6974 696f 6e61 6c20 6e6f 7461 7469 dditional notati │ │ │ +0009ed10: 6f6e 732c 206c 6162 656c 2079 6f75 7220 ons, label your │ │ │ +0009ed20: 4454 4420 6173 2061 2076 6172 6961 6e74 DTD as a variant │ │ │ +0009ed30: 206f 6620 446f 6342 6f6f 6b2e 2020 5365 of DocBook. Se │ │ │ +0009ed40: 650a 2020 2020 2074 6865 206d 6169 6e74 e. the maint │ │ │ +0009ed50: 656e 616e 6365 2064 6f63 756d 656e 7461 enance documenta │ │ │ +0009ed60: 7469 6f6e 2066 6f72 206d 6f72 6520 696e tion for more in │ │ │ +0009ed70: 666f 726d 6174 696f 6e2e 0a0a 2020 2020 formation... │ │ │ +0009ed80: 2050 6c65 6173 6520 6469 7265 6374 2061 Please direct a │ │ │ +0009ed90: 6c6c 2071 7565 7374 696f 6e73 2c20 6275 ll questions, bu │ │ │ +0009eda0: 6720 7265 706f 7274 732c 206f 7220 7375 g reports, or su │ │ │ +0009edb0: 6767 6573 7469 6f6e 7320 666f 720a 2020 ggestions for. │ │ │ +0009edc0: 2020 2063 6861 6e67 6573 2074 6f20 7468 changes to th │ │ │ +0009edd0: 6520 646f 6362 6f6f 6b40 6c69 7374 732e e docbook@lists. │ │ │ +0009ede0: 6f61 7369 732d 6f70 656e 2e6f 7267 206d oasis-open.org m │ │ │ +0009edf0: 6169 6c69 6e67 206c 6973 742e 2046 6f72 ailing list. For │ │ │ +0009ee00: 206d 6f72 650a 2020 2020 2069 6e66 6f72 more. infor │ │ │ +0009ee10: 6d61 7469 6f6e 2c20 7365 6520 6874 7470 mation, see http │ │ │ +0009ee20: 3a2f 2f77 7777 2e6f 6173 6973 2d6f 7065 ://www.oasis-ope │ │ │ +0009ee30: 6e2e 6f72 672f 646f 6362 6f6f 6b2f 2e0a n.org/docbook/.. │ │ │ +0009ee40: 2d2d 3e0a 0a3c 212d 2d20 2e2e 2e2e 2e2e -->....]]>....%I │ │ │ +0009f2d0: 534f 616d 7362 3b0a 3c21 2d2d 656e 6420 SOamsb;.]]>....%ISOamsc;.]]>....% │ │ │ +0009f480: 4953 4f61 6d73 6e3b 0a3c 212d 2d65 6e64 ISOamsn;.]]>...< │ │ │ +0009f4d0: 215b 2549 534f 616d 736f 2e6d 6f64 756c ![%ISOamso.modul │ │ │ +0009f4e0: 653b 5b0a 3c21 454e 5449 5459 2025 2049 e;[..%ISOamso;.]]>....%ISOamsr;. │ │ │ +0009f630: 3c21 2d2d 656e 6420 6f66 2049 534f 616d ]]>. │ │ │ +0009f650: 0a3c 2145 4e54 4954 5920 2520 4953 4f62 ...%IS │ │ │ +0009f6f0: 4f62 6f78 3b0a 3c21 2d2d 656e 6420 6f66 Obox;.]]>....%IS │ │ │ +0009f880: 4f63 7972 323b 0a3c 212d 2d65 6e64 206f Ocyr2;.]]>... │ │ │ +0009f940: 0a25 4953 4f64 6961 3b0a 3c21 2d2d 656e .%ISOdia;.]]>...< │ │ │ +0009f990: 215b 2549 534f 6772 6b31 2e6d 6f64 756c ![%ISOgrk1.modul │ │ │ +0009f9a0: 653b 5b0a 3c21 454e 5449 5459 2025 2049 e;[..%ISOgrk1;.]]>....%ISOgr │ │ │ +0009fad0: 6b32 3b0a 3c21 2d2d 656e 6420 6f66 2049 k2;. │ │ │ +0009faf0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....%I │ │ │ +0009fb90: 534f 6772 6b33 3b0a 3c21 2d2d 656e 6420 SOgrk3;.]]>....%I │ │ │ +0009fc60: 534f 6772 6b34 3b0a 3c21 2d2d 656e 6420 SOgrk4;.]]>....%ISOlat1;.]]>....%ISOlat2;. │ │ │ +0009fdf0: 3c21 2d2d 656e 6420 6f66 2049 534f 6c61 ]]>. │ │ │ +0009fe10: 0a3c 2145 4e54 4954 5920 2520 4953 4f6e ...%ISOnum;.]]>.. │ │ │ +0009ff00: 0a3c 215b 2549 534f 7075 622e 6d6f 6475 ..% │ │ │ +0009ff70: 4953 4f70 7562 3b0a 3c21 2d2d 656e 6420 ISOpub;.]]>....%ISOtech;.< │ │ │ +000a0040: 212d 2d65 6e64 206f 6620 4953 4f74 6563 !--end of ISOtec │ │ │ +000a0050: 682e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a h.module-->]]>.. │ │ │ +000a0060: 3c21 2d2d 2045 6e64 206f 6620 446f 6342 . │ │ │ +000a00b0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +000a0100: b600 0000 1f64 656d 6f2f 646f 6373 7263 .....demo/docsrc │ │ │ +000a0110: 2f44 6f63 426f 6f6b 2f74 626c 7863 6867 /DocBook/tblxchg │ │ │ +000a0120: 2e78 6d6c df00 0005 463c 212d 2d0a 202d .xml....F.. │ │ │ +000a04a0: 3c21 444f 4354 5950 4520 6172 7469 636c .Table │ │ │ +000a04e0: 5465 7374 3c2f 7469 746c 653e 0a0a 3c21 Test........foo.bar.....< │ │ │ +000a05e0: 7461 626c 6520 6964 3d22 6261 7222 2072 table id="bar" r │ │ │ +000a05f0: 6f6c 653d 2274 6573 7422 3e3c 7469 746c ole="test">bar.. │ │ │ +000a0620: 3c74 626f 6479 3e0a 3c72 6f77 3e3c 656e .bar< │ │ │ +000a0640: 2f72 6f77 3e0a 3c2f 7462 6f64 793e 0a3c /row>..< │ │ │ +000a0650: 2f74 6772 6f75 703e 0a3c 2f74 6162 6c65 /tgroup>.
..... │ │ │ +000a0670: 0000 001e 6465 6d6f 2f64 6f63 7372 632f ....demo/docsrc/ │ │ │ +000a0680: 446f 6342 6f6f 6b2f 7265 6164 6d65 2e74 DocBook/readme.t │ │ │ +000a0690: 7874 df00 0001 6652 4541 444d 4520 666f xt....fREADME fo │ │ │ +000a06a0: 7220 446f 6342 6f6f 6b20 584d 4c20 5634 r DocBook XML V4 │ │ │ +000a06b0: 2e30 0a0a 5468 6973 2069 7320 446f 6342 .0..This is DocB │ │ │ +000a06c0: 6f6f 6b20 584d 4c20 5634 2e30 2c20 7265 ook XML V4.0, re │ │ │ +000a06d0: 6c65 6173 6564 2031 3820 4d61 7920 3230 leased 18 May 20 │ │ │ +000a06e0: 3030 2e0a 0a53 6565 2034 3063 6867 2e74 00...See 40chg.t │ │ │ +000a06f0: 7874 2066 6f72 2069 6e66 6f72 6d61 7469 xt for informati │ │ │ +000a0700: 6f6e 2061 626f 7574 2077 6861 7420 6861 on about what ha │ │ │ +000a0710: 7320 6368 616e 6765 6420 7369 6e63 6520 s changed since │ │ │ +000a0720: 446f 6342 6f6f 6b20 332e 312e 0a0a 466f DocBook 3.1...Fo │ │ │ +000a0730: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ +000a0740: 6f6e 2061 626f 7574 2044 6f63 426f 6f6b on about DocBook │ │ │ +000a0750: 2c20 706c 6561 7365 2073 6565 0a0a 2020 , please see.. │ │ │ +000a0760: 6874 7470 3a2f 2f77 7777 2e6f 6173 6973 http://www.oasis │ │ │ +000a0770: 2d6f 7065 6e2e 6f72 672f 646f 6362 6f6f -open.org/docboo │ │ │ +000a0780: 6b2f 0a0a 506c 6561 7365 2073 656e 6420 k/..Please send │ │ │ +000a0790: 616c 6c20 7175 6573 7469 6f6e 732c 2063 all questions, c │ │ │ +000a07a0: 6f6d 6d65 6e74 732c 2063 6f6e 6365 726e omments, concern │ │ │ +000a07b0: 732c 2061 6e64 2062 7567 2072 6570 6f72 s, and bug repor │ │ │ +000a07c0: 7473 2074 6f20 7468 650a 446f 6342 6f6f ts to the.DocBoo │ │ │ +000a07d0: 6b20 6d61 696c 696e 6720 6c69 7374 3a20 k mailing list: │ │ │ +000a07e0: 646f 6362 6f6f 6b40 6c69 7374 732e 6f61 docbook@lists.oa │ │ │ +000a07f0: 7369 732d 6f70 656e 2e6f 7267 0ab6 0000 sis-open.org.... │ │ │ +000a0800: 0021 6465 6d6f 2f64 6f63 7372 632f 446f .!demo/docsrc/Do │ │ │ +000a0810: 6342 6f6f 6b2f 6462 7462 6c63 616c 732e cBook/dbtblcals. │ │ │ +000a0820: 6474 64df 0000 005e 3c21 454e 5449 5459 dtd....^. │ │ │ +000a0850: 0a3c 2145 4e54 4954 5920 2520 646f 6362 ..%docb │ │ │ +000a0880: 6f6f 6b3b 0a0a b600 0000 2064 656d 6f2f ook;...... demo/ │ │ │ +000a0890: 646f 6373 7263 2f44 6f63 426f 6f6b 2f64 docsrc/DocBook/d │ │ │ +000a08a0: 6267 656e 656e 742e 656e 74df 0000 063b bgenent.ent....; │ │ │ +000a08b0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +000a0900: 3c21 2d2d 2044 6f63 426f 6f6b 2058 4d4c . │ │ │ +000a0950: 0a3c 212d 2d20 436f 7079 7269 6768 7420 ... │ │ │ +000a0b50: 3c21 2d2d 2046 696c 6520 6462 6765 6e65 . │ │ │ +000a0ba0: 0a3c 212d 2d20 596f 7520 6361 6e20 6564 .......... │ │ │ +000a0ef0: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ +000a0f00: 6f6f 6b2f 3430 6368 672e 7478 74df 0000 ook/40chg.txt... │ │ │ +000a0f10: 0929 3138 204d 6179 2032 3030 300a 0a43 .)18 May 2000..C │ │ │ +000a0f20: 6861 6e67 6573 2066 726f 6d20 446f 6342 hanges from DocB │ │ │ +000a0f30: 6f6f 6b20 5633 2e31 2074 6f20 446f 6342 ook V3.1 to DocB │ │ │ +000a0f40: 6f6f 6b20 584d 4c20 5634 2e30 3a0a 0a47 ook XML V4.0:..G │ │ │ +000a0f50: 6c6f 6261 6c3a 0a0a 2d20 4272 6f61 6420 lobal:..- Broad │ │ │ +000a0f60: 6368 616e 6765 7320 7265 7175 6972 6564 changes required │ │ │ +000a0f70: 2066 6f72 2058 4d4c 2063 6f6d 7061 7469 for XML compati │ │ │ +000a0f80: 6269 6c69 7479 0a2d 2041 6464 6564 2061 bility.- Added a │ │ │ +000a0f90: 202a 7072 6f76 6973 696f 6e61 6c2a 2073 *provisional* s │ │ │ +000a0fa0: 6574 206f 6620 6368 6172 6163 7465 7220 et of character │ │ │ +000a0fb0: 656e 7469 7469 6573 2062 6173 6564 206f entities based o │ │ │ +000a0fc0: 6e20 7468 6520 4953 4f0a 2020 656e 7469 n the ISO. enti │ │ │ +000a0fd0: 7479 2073 6574 732e 2054 6865 2044 6f63 ty sets. The Doc │ │ │ +000a0fe0: 426f 6f6b 2054 4320 6973 206e 6f74 2077 Book TC is not w │ │ │ +000a0ff0: 696c 6c69 6e67 2074 6f20 6163 6365 7074 illing to accept │ │ │ +000a1000: 2074 6865 206c 6f6e 672d 7465 726d 0a20 the long-term. │ │ │ +000a1010: 2072 6573 706f 6e73 6962 696c 6974 7920 responsibility │ │ │ +000a1020: 666f 7220 6465 6669 6e69 6e67 2061 6e64 for defining and │ │ │ +000a1030: 206d 6169 6e74 6169 6e69 6e67 2074 6865 maintaining the │ │ │ +000a1040: 7365 2073 6574 732e 2054 6865 2054 430a se sets. The TC. │ │ │ +000a1050: 2020 7769 6c6c 2061 736b 204f 4153 4953 will ask OASIS │ │ │ +000a1060: 2074 6f20 666f 726d 2061 206e 6577 2054 to form a new T │ │ │ +000a1070: 4320 666f 7220 7468 6973 2070 7572 706f C for this purpo │ │ │ +000a1080: 7365 2e0a 0a4d 6172 6b75 703a 0a0a 2d20 se...Markup:..- │ │ │ +000a1090: 5246 4520 2031 373a 2041 6464 6564 2061 RFE 17: Added a │ │ │ +000a10a0: 2063 6f6d 6d6f 6e20 6174 7472 6962 7574 common attribut │ │ │ +000a10b0: 6520 2743 6f6e 6469 7469 6f6e 2720 666f e 'Condition' fo │ │ │ +000a10c0: 7220 6765 6e65 7269 6320 6566 6665 6374 r generic effect │ │ │ +000a10d0: 6976 6974 790a 2d20 5246 4520 2033 383a ivity.- RFE 38: │ │ │ +000a10e0: 2054 6865 206e 6176 2e63 6c61 7373 2065 The nav.class e │ │ │ +000a10f0: 6c65 6d65 6e74 7320 2854 6f43 7c4c 6f54 lements (ToC|LoT │ │ │ +000a1100: 7c49 6e64 6578 7c47 6c6f 7373 6172 797c |Index|Glossary| │ │ │ +000a1110: 4269 626c 696f 6772 6170 6879 2920 6172 Bibliography) ar │ │ │ +000a1120: 650a 2020 2020 2020 2020 2020 206e 6f77 e. now │ │ │ +000a1130: 2061 6c6c 6f77 6564 2061 7420 7468 6520 allowed at the │ │ │ +000a1140: 6265 6769 6e6e 696e 6720 616e 6420 656e beginning and en │ │ │ +000a1150: 6420 6f66 2063 6f6d 706f 6e65 6e74 7320 d of components │ │ │ +000a1160: 616e 6420 7365 6374 696f 6e73 0a2d 2052 and sections.- R │ │ │ +000a1170: 4645 2020 3538 3a20 5468 6520 276f 7074 FE 58: The 'opt │ │ │ +000a1180: 6d75 6c74 2720 616e 6420 2772 6571 6d75 mult' and 'reqmu │ │ │ +000a1190: 6c74 2720 6174 7472 6962 7574 6520 7661 lt' attribute va │ │ │ +000a11a0: 6c75 6573 2068 6176 6520 6265 656e 0a20 lues have been. │ │ │ +000a11b0: 2020 2020 2020 2020 2020 7265 6d6f 7665 remove │ │ │ +000a11c0: 6420 6672 6f6d 2047 726f 7570 0a2d 2052 d from Group.- R │ │ │ +000a11d0: 4645 2020 3635 3a20 4164 6465 6420 7365 FE 65: Added se │ │ │ +000a11e0: 7665 7261 6c20 636c 6173 7320 6174 7472 veral class attr │ │ │ +000a11f0: 6962 7574 6520 7661 6c75 6573 2074 6f20 ibute values to │ │ │ +000a1200: 4669 6c65 6e61 6d65 2061 6e64 2053 7973 Filename and Sys │ │ │ +000a1210: 7465 6d49 7465 6d0a 2020 2020 2020 2020 temItem. │ │ │ +000a1220: 2020 2061 7420 7468 6520 7265 7175 6573 at the reques │ │ │ +000a1230: 7420 6f66 2074 6865 204c 696e 7578 2063 t of the Linux c │ │ │ +000a1240: 6f6d 6d75 6e69 7479 0a2d 2052 4645 2020 ommunity.- RFE │ │ │ +000a1250: 3733 3a20 5265 6d6f 7665 6420 426f 6f6b 73: Removed Book │ │ │ +000a1260: 4269 626c 696f 2061 6e64 2053 6572 6965 Biblio and Serie │ │ │ +000a1270: 7349 6e66 6f0a 2d20 5246 4520 2038 313a sInfo.- RFE 81: │ │ │ +000a1280: 2041 6464 6564 2053 6964 6562 6172 496e Added SidebarIn │ │ │ +000a1290: 666f 2074 6f20 5369 6465 6261 720a 2d20 fo to Sidebar.- │ │ │ +000a12a0: 5246 4520 2038 373a 2041 6464 6564 2027 RFE 87: Added ' │ │ │ +000a12b0: 786d 6c70 6927 2061 6e64 2027 656d 7074 xmlpi' and 'empt │ │ │ +000a12c0: 7974 6167 2720 6173 2063 6c61 7373 2076 ytag' as class v │ │ │ +000a12d0: 616c 7565 7320 6f66 2053 474d 4c54 6167 alues of SGMLTag │ │ │ +000a12e0: 0a2d 2052 4645 2020 3932 3a20 4164 6465 .- RFE 92: Adde │ │ │ +000a12f0: 6420 2743 4f27 2074 6f20 5379 6e6f 7073 d 'CO' to Synops │ │ │ +000a1300: 6973 2061 6e64 204c 6974 6572 616c 4c61 is and LiteralLa │ │ │ +000a1310: 796f 7574 0a2d 2052 4645 2020 3939 3a20 yout.- RFE 99: │ │ │ +000a1320: 4164 6465 6420 5369 6d70 6c65 4d73 6745 Added SimpleMsgE │ │ │ +000a1330: 6e74 7279 2061 7320 616e 2061 6c74 6572 ntry as an alter │ │ │ +000a1340: 6e61 7469 7665 2074 6f20 4d73 6745 6e74 native to MsgEnt │ │ │ +000a1350: 7279 2069 6e20 6f72 6465 720a 2020 2020 ry in order. │ │ │ +000a1360: 2020 2020 2020 2074 6f20 7072 6f76 6964 to provid │ │ │ +000a1370: 6520 6120 7369 6d70 6c65 7220 4d73 6753 e a simpler MsgS │ │ │ +000a1380: 6574 2063 6f6e 7374 7275 6374 0a2d 2052 et construct.- R │ │ │ +000a1390: 4645 2031 3033 3a20 4164 6465 6420 5265 FE 103: Added Re │ │ │ +000a13a0: 7644 6573 6372 6970 7469 6f6e 2061 7320 vDescription as │ │ │ +000a13b0: 616e 2061 6c74 6572 6e61 7469 7665 2074 an alternative t │ │ │ +000a13c0: 6f20 5265 7652 656d 6172 6b20 696e 0a20 o RevRemark in. │ │ │ +000a13d0: 2020 2020 2020 2020 2020 5265 7648 6973 RevHis │ │ │ +000a13e0: 746f 7279 3b20 7468 6973 2061 6c6c 6f77 tory; this allow │ │ │ +000a13f0: 7320 6c6f 6e67 6572 2064 6573 6372 6970 s longer descrip │ │ │ +000a1400: 7469 7665 2074 6578 7420 696e 2061 2072 tive text in a r │ │ │ +000a1410: 6576 6973 696f 6e0a 2d20 5246 4520 3130 evision.- RFE 10 │ │ │ +000a1420: 343a 2041 6464 6564 2027 5370 6563 6966 4: Added 'Specif │ │ │ +000a1430: 6963 6174 696f 6e27 2074 6f20 7468 6520 ication' to the │ │ │ +000a1440: 6c69 7374 206f 6620 646f 6375 6d65 6e74 list of document │ │ │ +000a1450: 2063 6c61 7373 6573 206f 6e20 4172 7469 classes on Arti │ │ │ +000a1460: 636c 650a 2d20 5246 4520 3130 383a 2041 cle.- RFE 108: A │ │ │ +000a1470: 6c6c 6f77 2061 646d 6f6e 6974 696f 6e73 llow admonitions │ │ │ +000a1480: 2069 6e20 416e 7377 6572 730a 2d20 5246 in Answers.- RF │ │ │ +000a1490: 4520 3131 303a 2041 6c6c 6f77 2061 2052 E 110: Allow a R │ │ │ +000a14a0: 6576 4869 7374 6f72 7920 6f6e 2051 616e evHistory on Qan │ │ │ +000a14b0: 6441 456e 7472 790a 2d20 5246 4520 3131 dAEntry.- RFE 11 │ │ │ +000a14c0: 353a 2041 6c6c 6f77 206f 7074 696f 6e61 5: Allow optiona │ │ │ +000a14d0: 6c20 5469 746c 6520 6f6e 204f 7264 6572 l Title on Order │ │ │ +000a14e0: 6564 4c69 7374 2061 6e64 2049 7465 6d69 edList and Itemi │ │ │ +000a14f0: 7a65 644c 6973 740a 2d20 5246 4520 3131 zedList.- RFE 11 │ │ │ +000a1500: 363a 2041 6464 6564 204c 696e 654e 756d 6: Added LineNum │ │ │ +000a1510: 6265 7269 6e67 2061 7474 7269 6275 7465 bering attribute │ │ │ +000a1520: 2074 6f20 6c69 6e65 7370 6563 6966 6963 to linespecific │ │ │ +000a1530: 2065 6e76 6972 6f6e 6d65 6e74 7320 666f environments fo │ │ │ +000a1540: 720a 2020 2020 2020 2020 2020 2070 7265 r. pre │ │ │ +000a1550: 7365 6e74 6174 696f 6e20 6f66 206c 696e sentation of lin │ │ │ +000a1560: 6520 6e75 6d62 6572 730a 2d20 4164 6465 e numbers.- Adde │ │ │ +000a1570: 6420 6120 636f 6d6d 6f6e 2061 7474 7269 d a common attri │ │ │ +000a1580: 6275 7465 2027 5365 6375 7269 7479 2720 bute 'Security' │ │ │ +000a1590: 666f 7220 6566 6665 6374 6976 6974 790a for effectivity. │ │ │ +000a15a0: 2d20 4164 6465 6420 7379 6e6f 7073 6973 - Added synopsis │ │ │ +000a15b0: 206d 6172 6b75 7020 666f 7220 6d6f 6465 markup for mode │ │ │ +000a15c0: 726e 2070 726f 6772 616d 6d69 6e67 206c rn programming l │ │ │ +000a15d0: 616e 6775 6167 6573 2028 652e 672c 206f anguages (e.g, o │ │ │ +000a15e0: 626a 6563 740a 2020 6f72 6965 6e74 6564 bject. oriented │ │ │ +000a15f0: 206c 616e 6775 6167 6573 206c 696b 6520 languages like │ │ │ +000a1600: 4a61 7661 2c20 432b 2b2c 2061 6e64 2049 Java, C++, and I │ │ │ +000a1610: 444c 290a 2d20 5265 6e61 6d65 6420 446f DL).- Renamed Do │ │ │ +000a1620: 6349 6e66 6f20 746f 2050 7265 6661 6365 cInfo to Preface │ │ │ +000a1630: 496e 666f 2c20 4368 6170 7465 7249 6e66 Info, ChapterInf │ │ │ +000a1640: 6f2c 2041 7070 656e 6469 7849 6e66 6f2c o, AppendixInfo, │ │ │ +000a1650: 2065 7463 2e0a 0a4f 7468 6572 3a0a 0a2d etc...Other:..- │ │ │ +000a1660: 2052 4645 2020 3838 3a20 4164 6465 6420 RFE 88: Added │ │ │ +000a1670: 5045 7320 746f 2069 6e63 6c75 6465 2f69 PEs to include/i │ │ │ +000a1680: 676e 6f72 6520 6462 6e6f 746e 2e6d 6f64 gnore dbnotn.mod │ │ │ +000a1690: 2061 6e64 2064 6263 656e 742e 6d6f 640a and dbcent.mod. │ │ │ +000a16a0: 2d20 5246 4520 3130 323a 2046 6978 6564 - RFE 102: Fixed │ │ │ +000a16b0: 2073 6f6d 6520 6f75 7473 7461 6e64 696e some outstandin │ │ │ +000a16c0: 6720 6e61 6d65 6361 7365 2070 726f 626c g namecase probl │ │ │ +000a16d0: 656d 730a 2d20 5246 4520 3130 353a 2041 ems.- RFE 105: A │ │ │ +000a16e0: 6464 6564 2050 4e47 206e 6f74 6174 696f dded PNG notatio │ │ │ +000a16f0: 6e0a 2d20 5246 4520 3130 363a 2052 656d n.- RFE 106: Rem │ │ │ +000a1700: 6f76 6564 2073 6f6d 6520 6f64 6420 2a2e oved some odd *. │ │ │ +000a1710: 636f 6e74 656e 7420 5045 7320 7468 6174 content PEs that │ │ │ +000a1720: 2069 6e74 6572 6665 7265 6420 7769 7468 interfered with │ │ │ +000a1730: 0a20 2020 2020 2020 2020 2020 6375 7374 . cust │ │ │ +000a1740: 6f6d 697a 6174 696f 6e20 6c61 7965 7273 omization layers │ │ │ +000a1750: 0a2d 2052 4645 2031 3039 3a20 4164 6465 .- RFE 109: Adde │ │ │ +000a1760: 6420 4650 4920 746f 2063 6f6e 7465 6e74 d FPI to content │ │ │ +000a1770: 206f 6620 6462 6765 6e65 6e74 2e6d 6f64 of dbgenent.mod │ │ │ +000a1780: 2028 666f 7220 636f 6e73 6973 7465 6e63 (for consistenc │ │ │ +000a1790: 7929 0a2d 2052 4645 2031 3131 3a20 4164 y).- RFE 111: Ad │ │ │ +000a17a0: 6465 6420 7468 6520 4575 726f 2073 796d ded the Euro sym │ │ │ +000a17b0: 626f 6c0a 2d20 4669 7865 6420 6275 6720 bol.- Fixed bug │ │ │ +000a17c0: 696e 2063 616c 732d 7462 6c2e 6474 643b in cals-tbl.dtd; │ │ │ +000a17d0: 2061 206d 6f64 656c 2067 726f 7570 2077 a model group w │ │ │ +000a17e0: 6173 2075 7365 6420 666f 7220 7468 6520 as used for the │ │ │ +000a17f0: 656c 656d 656e 740a 2020 6465 636c 6172 element. declar │ │ │ +000a1800: 6174 696f 6e2c 2062 7574 2074 6865 2061 ation, but the a │ │ │ +000a1810: 7474 6c69 7374 2064 6563 6c61 7261 7469 ttlist declarati │ │ │ +000a1820: 6f6e 2075 7365 6420 2254 6162 6c65 2220 on used "Table" │ │ │ +000a1830: 6c69 7465 7261 6c6c 792e 0ab6 0000 001f literally....... │ │ │ +000a1840: 6465 6d6f 2f64 6f63 7372 632f 446f 6342 demo/docsrc/DocB │ │ │ +000a1850: 6f6f 6b2f 6462 6869 6572 782e 6d6f 64df ook/dbhierx.mod. │ │ │ +000a1860: 0000 e898 3c21 2d2d 202e 2e2e 2e2e 2e2e .......................< │ │ │ +000a23b0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +000a23c0: 6170 7065 6e64 6978 2e63 6c61 7373 2022 appendix.class " │ │ │ +000a23d0: 223e 0a3c 2145 4e54 4954 5920 2520 6170 ">.. │ │ │ +000a2410: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ....< │ │ │ +000a2470: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +000a2480: 626f 6f6b 2e63 6c61 7373 2022 223e 0a3c book.class "">.< │ │ │ +000a2490: 2145 4e54 4954 5920 2520 626f 6f6b 2e63 !ENTITY % book.c │ │ │ +000a24a0: 6c61 7373 0909 2262 6f6f 6b20 256c 6f63 lass.."book %loc │ │ │ +000a24b0: 616c 2e62 6f6f 6b2e 636c 6173 733b 223e al.book.class;"> │ │ │ +000a24c0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 ..... │ │ │ +000a2520: 3c21 454e 5449 5459 2025 206c 6f63 616c │ │ │ +000a2540: 0a3c 2145 4e54 4954 5920 2520 696e 6465 ... │ │ │ +000a2580: 3c21 454e 5449 5459 2025 206c 6f63 616c . │ │ │ +000a25e0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 .. │ │ │ +000a2600: 0a3c 2145 4e54 4954 5920 2520 6e61 762e ........ │ │ │ +000a27c0: 0a25 7264 6268 6965 723b 0a3c 212d 2d65 .%rdbhier;.]]> │ │ │ +000a27f0: 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e .......... │ │ │ +000a2ac0: 3c21 454e 5449 5459 2025 2072 6566 636f │ │ │ +000a2bd0: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 ..... │ │ │ +000a2d30: 0a3c 2145 4e54 4954 5920 2520 7265 666e .... │ │ │ +000a2db0: 3c21 454e 5449 5459 2025 2070 6172 7463 ... │ │ │ +000a2f70: 0a0a 3c21 454e 5449 5459 2025 206c 6f63 .....< │ │ │ +000a2ff0: 212d 2d20 5265 6465 636c 6172 6174 696f !-- Redeclaratio │ │ │ +000a3000: 6e20 706c 6163 6568 6f6c 6465 7220 3220 n placeholder 2 │ │ │ +000a3010: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000a3020: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000a3030: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a0a .......... -->.. │ │ │ +000a3040: 3c21 2d2d 2046 6f72 2072 6564 6563 6c61 ....%rd │ │ │ +000a3160: 6268 6965 7232 3b0a 3c21 2d2d 656e 6420 bhier2;.]]>.. │ │ │ +000a3190: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +000a31e0: 3c21 2d2d 2045 6e74 6974 6965 7320 666f . │ │ │ +000a3230: 0a3c 2145 4e54 4954 5920 2520 6469 762e . │ │ │ +000a3270: 0a0a 3c21 454e 5449 5459 2025 2062 6f6f ......< │ │ │ +000a3300: 2145 4e54 4954 5920 2520 7265 6673 6563 !ENTITY % refsec │ │ │ +000a3310: 742e 7469 746c 652e 636f 6e74 656e 740a t.title.content. │ │ │ +000a3320: 0922 7469 746c 652c 2073 7562 7469 746c ."title, subtitl │ │ │ +000a3330: 653f 2c20 7469 746c 6561 6262 7265 763f e?, titleabbrev? │ │ │ +000a3340: 223e 0a0a 3c21 454e 5449 5459 2025 2062 ">......... │ │ │ +000a34f0: 3c21 5b25 7365 742e 6d6f 6475 6c65 3b5b │ │ │ +000a3520: 0a3c 2145 4e54 4954 5920 2520 7365 742e .... │ │ │ +000a3570: 3c21 5b25 7365 742e 656c 656d 656e 743b .]]>.]]> │ │ │ +000a3880: 0a0a 3c21 2d2d 2043 6f6e 7465 6e74 733a .......]]>..............]]>.< │ │ │ +000a3e90: 212d 2d65 6e64 206f 6620 626f 6f6b 2e6d !--end of book.m │ │ │ +000a3ea0: 6f64 756c 652d 2d3e 5d5d 3e0a 0a3c 2145 odule-->]]>...... │ │ │ +000a3f40: 3c21 454e 5449 5459 2025 2062 6f6f 6b69 ..]]>.. │ │ │ +000a4030: 3c21 2d2d 2043 6f6e 7465 6e74 733a 2049 ..... │ │ │ +000a41a0: 3c21 2d2d 656e 6420 6f66 2062 6f6f 6b69 ]] │ │ │ +000a41c0: 3e0a 3c21 2d2d 656e 6420 6f66 2062 6f6f >.] │ │ │ +000a41e0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 626f ]>.]]>...... │ │ │ +000a4310: 0a3c 2145 4e54 4954 5920 2520 6465 6469 .....]]> │ │ │ +000a43f0: 0a0a 3c21 454e 5449 5459 2025 2064 6564 ....]]>.]]>... │ │ │ +000a4550: 0a3c 2145 4e54 4954 5920 2520 636f 6c6f .....]]>... │ │ │ +000a4650: 3c21 5b20 2563 6f6c 6f70 686f 6e2e 6174 .]]>.. │ │ │ +000a4740: 0a3c 215b 2574 6f63 2e63 6f6e 7465 6e74 .......]]>....]]>.]]>. │ │ │ +000a4a70: 0a3c 212d 2d20 746f 2065 6c65 6d65 6e74 .. │ │ │ +000a4aa0: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 .... │ │ │ +000a4b70: 3c21 2d2d 656e 6420 6f66 2074 6f63 6672 ]] │ │ │ +000a4b90: 3e0a 3c21 2d2d 656e 6420 6f66 2074 6f63 >.] │ │ │ +000a4bb0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2074 ]>........]]>..< │ │ │ +000a4cd0: 212d 2d20 746f 2065 6c65 6d65 6e74 2074 !-- to element t │ │ │ +000a4ce0: 6861 7420 7468 6973 2065 6e74 7279 2072 hat this entry r │ │ │ +000a4cf0: 6570 7265 7365 6e74 7320 2d2d 3e0a 0a0a epresents -->... │ │ │ +000a4d00: 3c21 454e 5449 5459 2025 2074 6f63 656e ..]]>.< │ │ │ +000a4de0: 212d 2d65 6e64 206f 6620 746f 6365 6e74 !--end of tocent │ │ │ +000a4df0: 7279 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a ry.module-->]]>. │ │ │ +000a4e00: 0a3c 2145 4e54 4954 5920 2520 746f 6370 ...< │ │ │ +000a4e60: 2145 4e54 4954 5920 2520 746f 6370 6172 !ENTITY % tocpar │ │ │ +000a4e70: 742e 726f 6c65 2e61 7474 7269 6220 2225 t.role.attrib "% │ │ │ +000a4e80: 726f 6c65 2e61 7474 7269 623b 223e 0a0a role.attrib;">.. │ │ │ +000a4e90: 3c21 454e 5449 5459 2025 2074 6f63 7061 ..]]>.]]>.. │ │ │ +000a5010: 0a3c 215b 2574 6f63 6368 6170 2e6d 6f64 .... │ │ │ +000a50a0: 0a3c 215b 2574 6f63 6368 6170 2e65 6c65 ..] │ │ │ +000a5100: 5d3e 0a0a 3c21 454e 5449 5459 2025 2074 ]>....]]>.]]>.. │ │ │ +000a5210: 0a3c 215b 2574 6f63 6c65 7665 6c31 2e6d ... │ │ │ +000a5280: 0a3c 2145 4e54 4954 5920 2520 746f 636c ...]]> │ │ │ +000a5310: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 ....< │ │ │ +000a53b0: 212d 2d65 6e64 206f 6620 746f 636c 6576 !--end of toclev │ │ │ +000a53c0: 656c 312e 6174 746c 6973 742d 2d3e 5d5d el1.attlist-->]] │ │ │ +000a53d0: 3e0a 3c21 2d2d 656e 6420 6f66 2074 6f63 >. │ │ │ +000a53f0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>....]]>.]]>.. │ │ │ +000a5600: 3c21 454e 5449 5459 2025 2074 6f63 6c65 .....< │ │ │ +000a56c0: 215b 2574 6f63 6c65 7665 6c33 2e65 6c65 ![%toclevel3.ele │ │ │ +000a56d0: 6d65 6e74 3b5b 0a3c 2145 4c45 4d45 4e54 ment;[..]]>... │ │ │ +000a5750: 3c21 5b25 746f 636c 6576 656c 332e 6174 .]]>.]]>....< │ │ │ +000a5870: 2145 4e54 4954 5920 2520 746f 636c 6576 !ENTITY % toclev │ │ │ +000a5880: 656c 342e 726f 6c65 2e61 7474 7269 6220 el4.role.attrib │ │ │ +000a5890: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ +000a58a0: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 ....< │ │ │ +000a5910: 212d 2d65 6e64 206f 6620 746f 636c 6576 !--end of toclev │ │ │ +000a5920: 656c 342e 656c 656d 656e 742d 2d3e 5d5d el4.element-->]] │ │ │ +000a5930: 3e0a 0a3c 2145 4e54 4954 5920 2520 746f >.... │ │ │ +000a59d0: 3c21 2d2d 656e 6420 6f66 2074 6f63 6c65 ] │ │ │ +000a59f0: 5d3e 0a3c 212d 2d65 6e64 206f 6620 746f ]>.]]> │ │ │ +000a5b30: 0a0a 3c21 454e 5449 5459 2025 2074 6f63 ....< │ │ │ +000a5bd0: 212d 2d65 6e64 206f 6620 746f 636c 6576 !--end of toclev │ │ │ +000a5be0: 656c 352e 6174 746c 6973 742d 2d3e 5d5d el5.attlist-->]] │ │ │ +000a5bf0: 3e0a 3c21 2d2d 656e 6420 6f66 2074 6f63 >. │ │ │ +000a5c10: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>........]]>......< │ │ │ +000a5d80: 215b 2574 6f63 6261 636b 2e61 7474 6c69 ![%tocback.attli │ │ │ +000a5d90: 7374 3b5b 0a3c 2141 5454 4c49 5354 2074 st;[..] │ │ │ +000a5e40: 5d3e 0a3c 212d 2d65 6e64 206f 6620 746f ]>.] │ │ │ +000a5e60: 5d3e 0a3c 212d 2d65 6e64 206f 6620 746f ]>.]]>.. │ │ │ +000a5eb0: 0a3c 215b 256c 6f74 2e63 6f6e 7465 6e74 .......]]>....]]> │ │ │ +000a60a0: 0a0a 3c21 454e 5449 5459 2025 206c 6f74 ........]]>......< │ │ │ +000a6330: 212d 2d65 6e64 206f 6620 6c6f 7465 6e74 !--end of lotent │ │ │ +000a6340: 7279 2e61 7474 6c69 7374 2d2d 3e5d 5d3e ry.attlist-->]]> │ │ │ +000a6350: 0a3c 212d 2d65 6e64 206f 6620 6c6f 7465 .]] │ │ │ +000a6370: 3e0a 3c21 2d2d 656e 6420 6f66 206c 6f74 >..........]]>.. │ │ │ +000a6620: 3c21 454e 5449 5459 2025 2061 7070 656e ..]]>.]]>..< │ │ │ +000a6720: 2145 4e54 4954 5920 2520 6368 6170 7465 !ENTITY % chapte │ │ │ +000a6730: 722e 6d6f 6475 6c65 2022 494e 434c 5544 r.module "INCLUD │ │ │ +000a6740: 4522 3e0a 3c21 5b25 6368 6170 7465 722e E">......]]>....]]>.< │ │ │ +000a69d0: 212d 2d65 6e64 206f 6620 6368 6170 7465 !--end of chapte │ │ │ +000a69e0: 722e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a r.module-->]]>.. │ │ │ +000a69f0: 3c21 454e 5449 5459 2025 2070 6172 742e ........]]>....]]>. │ │ │ +000a6c60: 3c21 2d2d 454c 454d 454e 5420 5061 7274 .]]>.. │ │ │ +000a6e80: 3c21 454e 5449 5459 2025 2070 7265 6661 ..] │ │ │ +000a70f0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>....]]>.. │ │ │ +000a7200: 3c21 2d2d 656e 6420 6f66 2072 6566 6572 ]] │ │ │ +000a7220: 3e0a 0a3c 2145 4e54 4954 5920 2520 7061 >........]]>.]]>....... │ │ │ +000a75a0: 0a0a 3c21 454e 5449 5459 2025 2061 7070 ....]]>.. │ │ │ +000a76b0: 3c21 454e 5449 5459 2025 2061 7070 656e .. │ │ │ +000a7780: 5d5d 3e0a 3c21 2d2d 656e 6420 6f66 2061 ]]>.]]>......< │ │ │ +000a7860: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ +000a7870: 6772 6170 6879 696e 666f 2e65 6c65 6d65 graphyinfo.eleme │ │ │ +000a7880: 6e74 2022 494e 434c 5544 4522 3e0a 3c21 nt "INCLUDE">..]]>....< │ │ │ +000a7a40: 212d 2d65 6e64 206f 6620 6269 626c 696f !--end of biblio │ │ │ +000a7a50: 6772 6170 6879 696e 666f 2e61 7474 6c69 graphyinfo.attli │ │ │ +000a7a60: 7374 2d2d 3e5d 5d3e 0a3c 212d 2d65 6e64 st-->]]>.]] │ │ │ +000a7a90: 3e0a 0a3c 2145 4e54 4954 5920 2520 6368 >....< │ │ │ +000a7b00: 2145 4e54 4954 5920 2520 6368 6170 7465 !ENTITY % chapte │ │ │ +000a7b10: 7269 6e66 6f2e 726f 6c65 2e61 7474 7269 rinfo.role.attri │ │ │ +000a7b20: 6220 2225 726f 6c65 2e61 7474 7269 623b b "%role.attrib; │ │ │ +000a7b30: 223e 0a0a 3c21 454e 5449 5459 2025 2063 ">....]]>....]]>.]]>. │ │ │ +000a7d30: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 ... │ │ │ +000a7da0: 3c21 454e 5449 5459 2025 2067 6c6f 7373 .. │ │ │ +000a7e00: 0a3c 215b 2025 676c 6f73 7361 7279 696e ..] │ │ │ +000a7ee0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2067 ]>...< │ │ │ +000a7f10: 215b 2025 676c 6f73 7361 7279 696e 666f ![ %glossaryinfo │ │ │ +000a7f20: 2e61 7474 6c69 7374 3b20 5b0a 3c21 4154 .attlist; [..]]>.]]>.......< │ │ │ +000a80a0: 215b 2025 696e 6465 7869 6e66 6f2e 656c ![ %indexinfo.el │ │ │ +000a80b0: 656d 656e 743b 205b 0a3c 2145 4c45 4d45 ement; [..]]>.. │ │ │ +000a81a0: 0a3c 215b 2025 696e 6465 7869 6e66 6f2e ..]]>.]]>........]]>. │ │ │ +000a8410: 0a3c 2145 4e54 4954 5920 2520 7365 7469 ...< │ │ │ +000a84c0: 212d 2d65 6e64 206f 6620 7365 7469 6e64 !--end of setind │ │ │ +000a84d0: 6578 696e 666f 2e61 7474 6c69 7374 2d2d exinfo.attlist-- │ │ │ +000a84e0: 3e5d 5d3e 0a3c 212d 2d65 6e64 206f 6620 >]]>.]]>.. │ │ │ +000a8530: 0a3c 215b 2025 7061 7274 696e 666f 2e6d .... │ │ │ +000a85a0: 3c21 454e 5449 5459 2025 2070 6172 7469 ..]]>....]]>.]]>....... │ │ │ +000a8900: 0a3c 212d 2d65 6e64 206f 6620 7072 6566 .]]>......< │ │ │ +000a8ac0: 2145 4e54 4954 5920 2520 7265 6665 6e74 !ENTITY % refent │ │ │ +000a8ad0: 7279 696e 666f 2e65 6c65 6d65 6e74 2022 ryinfo.element " │ │ │ +000a8ae0: 494e 434c 5544 4522 3e0a 3c21 5b20 2572 INCLUDE">..]]>....]]> │ │ │ +000a8ca0: 0a3c 212d 2d65 6e64 206f 6620 7265 6665 .]]>....]]>.] │ │ │ +000a8f70: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>........ │ │ │ +000a9100: 3c21 2d2d 656e 6420 6f66 2072 6566 7365 ]]>.]]>. │ │ │ +000a9220: 0a3c 2145 4e54 4954 5920 2520 7265 6673 ... │ │ │ +000a9290: 3c21 454e 5449 5459 2025 2072 6566 7365 .. │ │ │ +000a92f0: 0a3c 215b 2025 7265 6673 6563 7433 696e ..] │ │ │ +000a93d0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>...< │ │ │ +000a9400: 215b 2025 7265 6673 6563 7433 696e 666f ![ %refsect3info │ │ │ +000a9410: 2e61 7474 6c69 7374 3b20 5b0a 3c21 4154 .attlist; [..]]>.]]>....< │ │ │ +000a9550: 2145 4e54 4954 5920 2520 7265 6673 796e !ENTITY % refsyn │ │ │ +000a9560: 6f70 7369 7364 6976 696e 666f 2e72 6f6c opsisdivinfo.rol │ │ │ +000a9570: 652e 6174 7472 6962 2022 2572 6f6c 652e e.attrib "%role. │ │ │ +000a9580: 6174 7472 6962 3b22 3e0a 0a3c 2145 4e54 attrib;">....]]>. │ │ │ +000a96b0: 0a3c 2145 4e54 4954 5920 2520 7265 6673 ...]]>. │ │ │ +000a97d0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>... │ │ │ +000a9800: 3c21 5b20 2572 6566 6572 656e 6365 696e .....]]>.. │ │ │ +000a9990: 3c21 454e 5449 5459 2025 2072 6566 6572 ..]]>.]]>. │ │ │ +000a9a90: 0a3c 2145 4e54 4954 5920 2520 6c6f 6361 ......]]>....]]>.......]]> │ │ │ +000a9fe0: 0a0a 3c21 454e 5449 5459 2025 2073 6563 ....< │ │ │ +000aa080: 212d 2d65 6e64 206f 6620 7365 6374 3369 !--end of sect3i │ │ │ +000aa090: 6e66 6f2e 6174 746c 6973 742d 2d3e 5d5d nfo.attlist-->]] │ │ │ +000aa0a0: 3e0a 0a3c 2145 4e54 4954 5920 2520 6c6f >.......]]>... │ │ │ +000aa210: 3c21 5b25 7365 6374 3469 6e66 6f2e 6174 .]]>...< │ │ │ +000aa2d0: 2145 4e54 4954 5920 2520 7365 6374 3569 !ENTITY % sect5i │ │ │ +000aa2e0: 6e66 6f2e 726f 6c65 2e61 7474 7269 6220 nfo.role.attrib │ │ │ +000aa2f0: 2225 726f 6c65 2e61 7474 7269 623b 223e "%role.attrib;"> │ │ │ +000aa300: 0a0a 3c21 454e 5449 5459 2025 2073 6563 ....]]>....]]>..< │ │ │ +000aa4b0: 212d 2d20 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e !-- ............ │ │ │ +000aa4c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000aa4d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000aa4e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000aa4f0: 2e2e 2e2e 2e2e 2e2e 2e2e 202d 2d3e 0a3c .......... -->.< │ │ │ +000aa500: 212d 2d20 5365 6374 696f 6e20 2870 6172 !-- Section (par │ │ │ +000aa510: 616c 6c65 6c20 746f 2053 6563 742a 2920 allel to Sect*) │ │ │ +000aa520: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000aa530: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ +000aa540: 2e2e 2e2e 2e2e 2e2e 2e20 2d2d 3e0a 0a3c ......... -->..< │ │ │ +000aa550: 2145 4e54 4954 5920 2520 7365 6374 696f !ENTITY % sectio │ │ │ +000aa560: 6e2e 636f 6e74 656e 742e 6d6f 6475 6c65 n.content.module │ │ │ +000aa570: 2022 494e 434c 5544 4522 3e0a 3c21 5b20 "INCLUDE">.. │ │ │ +000aa5c0: 3c21 5b20 2573 6563 7469 6f6e 2e6d 6f64 .....]]>.< │ │ │ +000aa830: 212d 2d65 6e64 206f 6620 7365 6374 696f !--end of sectio │ │ │ +000aa840: 6e2e 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a n.module-->]]>.. │ │ │ +000aa850: 3c21 454e 5449 5459 2025 2073 6563 7469 ... │ │ │ +000aa8f0: 0a3c 2145 4e54 4954 5920 2520 7365 6374 .. │ │ │ +000aa9c0: 0a3c 212d 2d65 6e64 206f 6620 7365 6374 .]]>.]]> │ │ │ +000aab00: 0a0a 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e .. │ │ │ +000aad50: 5d5d 3e0a 0a3c 212d 2d20 5265 6e64 6572 ]]>..]]>.]]>...< │ │ │ +000aaef0: 215b 2573 6563 7432 2e6d 6f64 756c 653b ![%sect2.module; │ │ │ +000aaf00: 5b0a 3c21 454e 5449 5459 2025 206c 6f63 [......]]>..... │ │ │ +000ab0f0: 0a3c 215b 2573 6563 7432 2e61 7474 6c69 .. │ │ │ +000ab1f0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....... │ │ │ +000ab2a0: 3c21 5b25 7365 6374 332e 656c 656d 656e ...... │ │ │ +000ab4e0: 3c21 2d2d 656e 6420 6f66 2073 6563 7433 ]]>.< │ │ │ +000ab500: 212d 2d65 6e64 206f 6620 7365 6374 332e !--end of sect3. │ │ │ +000ab510: 6d6f 6475 6c65 2d2d 3e5d 5d3e 0a0a 3c21 module-->]]>.. │ │ │ +000ab540: 0a3c 215b 2573 6563 7434 2e6d 6f64 756c ...... │ │ │ +000ab6b0: 3c21 2d2d 656e 6420 6f66 2073 6563 7434 ]]>.. │ │ │ +000ab6d0: 3c21 2d2d 2052 656e 6465 7261 733a 2049 ...< │ │ │ +000ab720: 2145 4e54 4954 5920 2520 7365 6374 342e !ENTITY % sect4. │ │ │ +000ab730: 6174 746c 6973 7420 2249 4e43 4c55 4445 attlist "INCLUDE │ │ │ +000ab740: 223e 0a3c 215b 2573 6563 7434 2e61 7474 ">..]]>.] │ │ │ +000ab9e0: 5d3e 0a0a 3c21 2d2d 2052 656e 6465 7261 ]>.. │ │ │ +000aba30: 0a0a 0a3c 2145 4e54 4954 5920 2520 7365 .....]]>.]]>.......< │ │ │ +000abc20: 215b 2573 696d 706c 6573 6563 742e 656c ![%simplesect.el │ │ │ +000abc30: 656d 656e 743b 5b0a 3c21 454c 454d 454e ement;[..]] │ │ │ +000abca0: 3e0a 0a3c 2145 4e54 4954 5920 2520 7369 >....]]>.]]>...... │ │ │ +000abe60: 3c21 5b25 6269 626c 696f 6772 6170 6879 ..< │ │ │ +000abef0: 2145 4e54 4954 5920 2520 6269 626c 696f !ENTITY % biblio │ │ │ +000abf00: 6772 6170 6879 2e72 6f6c 652e 6174 7472 graphy.role.attr │ │ │ +000abf10: 6962 2022 2572 6f6c 652e 6174 7472 6962 ib "%role.attrib │ │ │ +000abf20: 3b22 3e0a 0a3c 2145 4e54 4954 5920 2520 ;">... │ │ │ +000abf50: 3c21 5b25 6269 626c 696f 6772 6170 6879 │ │ │ +000ac040: 0a3c 212d 2d65 6e64 206f 6620 6269 626c .]]>....]]>.]]> │ │ │ +000ac170: 0a0a 3c21 454e 5449 5459 2025 2062 6962 ...... │ │ │ +000ac230: 0a3c 215b 2562 6962 6c69 6f64 6976 2e65 ..]]>....]]>. │ │ │ +000ac3a0: 3c21 2d2d 656e 6420 6f66 2062 6962 6c69 ]] │ │ │ +000ac3c0: 3e0a 3c21 2d2d 656e 6420 6f66 2062 6962 >.]]>.. │ │ │ +000ac3f0: 3c21 2d2d 202e 2e2e 2e2e 2e2e 2e2e 2e2e . │ │ │ +000ac440: 3c21 2d2d 2047 6c6f 7373 6172 7920 2e2e . │ │ │ +000ac490: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 ..< │ │ │ +000ac4c0: 215b 2567 6c6f 7373 6172 792e 636f 6e74 ![%glossary.cont │ │ │ +000ac4d0: 656e 742e 6d6f 6475 6c65 3b5b 0a3c 2145 ent.module;[..... │ │ │ +000ac570: 3c21 454e 5449 5459 2025 2067 6c6f 7373 ..]]>. │ │ │ +000ac690: 0a3c 2145 4e54 4954 5920 2520 676c 6f73 ...]]>.]]>..< │ │ │ +000ac780: 2145 4e54 4954 5920 2520 676c 6f73 7364 !ENTITY % glossd │ │ │ +000ac790: 6976 2e6d 6f64 756c 6520 2249 4e43 4c55 iv.module "INCLU │ │ │ +000ac7a0: 4445 223e 0a3c 215b 2567 6c6f 7373 6469 DE">.. │ │ │ +000ac7e0: 3c21 454e 5449 5459 2025 2067 6c6f 7373 │ │ │ +000ac810: 0a0a 3c21 454e 5449 5459 2025 2067 6c6f .... │ │ │ +000ac8a0: 3c21 2d2d 656e 6420 6f66 2067 6c6f 7373 ]] │ │ │ +000ac8c0: 3e0a 0a3c 2145 4e54 4954 5920 2520 676c >....]]>.< │ │ │ +000ac990: 212d 2d65 6e64 206f 6620 676c 6f73 7364 !--end of glossd │ │ │ +000ac9a0: 6976 2e6d 6f64 756c 652d 2d3e 5d5d 3e0a iv.module-->]]>. │ │ │ +000ac9b0: 3c21 2d2d 656e 6420 6f66 2067 6c6f 7373 ]]>........< │ │ │ +000acb20: 2145 4e54 4954 5920 2520 696e 6465 7865 !ENTITY % indexe │ │ │ +000acb30: 732e 726f 6c65 2e61 7474 7269 6220 2225 s.role.attrib "% │ │ │ +000acb40: 726f 6c65 2e61 7474 7269 623b 223e 0a0a role.attrib;">.. │ │ │ +000acb50: 3c21 454e 5449 5459 2025 2069 6e64 6578 ..]]>.... │ │ │ +000acdf0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....]]>.]]>........ │ │ │ +000acfe0: 0a3c 215b 2569 6e64 6578 6469 762e 656c ..]]>...< │ │ │ +000ad0b0: 215b 2569 6e64 6578 6469 762e 6174 746c ![%indexdiv.attl │ │ │ +000ad0c0: 6973 743b 5b0a 3c21 4154 544c 4953 5420 ist;[.. │ │ │ +000ad120: 3c21 2d2d 656e 6420 6f66 2069 6e64 6578 ]] │ │ │ +000ad140: 3e0a 3c21 2d2d 656e 6420 6f66 2069 6e64 >.] │ │ │ +000ad160: 5d3e 0a0a 3c21 454e 5449 5459 2025 2069 ]>.....< │ │ │ +000ad1e0: 2145 4e54 4954 5920 2520 6c6f 6361 6c2e !ENTITY % local. │ │ │ +000ad1f0: 696e 6465 7865 6e74 7279 2e61 7474 7269 indexentry.attri │ │ │ +000ad200: 6220 2222 3e0a 3c21 454e 5449 5459 2025 b "">.....]]>.. │ │ │ +000ad330: 0a3c 215b 2569 6e64 6578 656e 7472 792e ..]]>.]]> │ │ │ +000ad3f0: 0a0a 3c21 454e 5449 5459 2025 2070 7269 ....< │ │ │ +000ad460: 2145 4e54 4954 5920 2520 7072 696d 7365 !ENTITY % primse │ │ │ +000ad470: 6374 6572 6965 2e72 6f6c 652e 6174 7472 cterie.role.attr │ │ │ +000ad480: 6962 2022 2572 6f6c 652e 6174 7472 6962 ib "%role.attrib │ │ │ +000ad490: 3b22 3e0a 0a3c 2145 4e54 4954 5920 2520 ;">.... │ │ │ +000ad500: 3c21 2d2d 656e 6420 6f66 2070 7269 6d61 ] │ │ │ +000ad520: 5d3e 0a0a 3c21 2d2d 2074 6f20 496e 6465 ]>.... │ │ │ +000ad580: 0a3c 215b 2570 7269 6d61 7279 6965 2e61 ..< │ │ │ +000ad610: 212d 2d65 6e64 206f 6620 7072 696d 6172 !--end of primar │ │ │ +000ad620: 7969 652e 6174 746c 6973 742d 2d3e 5d5d yie.attlist-->]] │ │ │ +000ad630: 3e0a 0a3c 2145 4e54 4954 5920 2520 7365 >....]]>....< │ │ │ +000ad700: 2145 4e54 4954 5920 2520 7365 636f 6e64 !ENTITY % second │ │ │ +000ad710: 6172 7969 652e 6174 746c 6973 7420 2249 aryie.attlist "I │ │ │ +000ad720: 4e43 4c55 4445 223e 0a3c 215b 2573 6563 NCLUDE">..]]>. │ │ │ +000ad7e0: 0a3c 2145 4e54 4954 5920 2520 7465 7274 ...< │ │ │ +000ad850: 212d 2d65 6e64 206f 6620 7465 7274 6961 !--end of tertia │ │ │ +000ad860: 7279 6965 2e65 6c65 6d65 6e74 2d2d 3e5d ryie.element-->] │ │ │ +000ad870: 5d3e 0a0a 3c21 2d2d 2074 6f20 496e 6465 ]>......]]>... │ │ │ +000ad9d0: 0a3c 215b 2573 6565 6965 2e6d 6f64 756c ......] │ │ │ +000adab0: 5d3e 0a0a 3c21 2d2d 2074 6f20 496e 6465 ]>.......]] │ │ │ +000adb90: 3e0a 3c21 2d2d 656e 6420 6f66 2073 6565 >.]]>. │ │ │ +000adbb0: 0a3c 2145 4e54 4954 5920 2520 7365 6561 ...... │ │ │ +000adc70: 3c21 5b25 7365 6561 6c73 6f69 652e 656c ......]]>.]]>.< │ │ │ +000addf0: 212d 2d65 6e64 206f 6620 696e 6465 782e !--end of index. │ │ │ +000ade00: 636f 6e74 656e 742e 6d6f 6475 6c65 2d2d content.module-- │ │ │ +000ade10: 3e5d 5d3e 0a0a 3c21 2d2d 202e 2e2e 2e2e >]]>............]] │ │ │ +000ae170: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6566 >.] │ │ │ +000ae190: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>........]]>....< │ │ │ +000ae3a0: 212d 2d65 6e64 206f 6620 7265 666d 6574 !--end of refmet │ │ │ +000ae3b0: 612e 6174 746c 6973 742d 2d3e 5d5d 3e0a a.attlist-->]]>. │ │ │ +000ae3c0: 3c21 2d2d 656e 6420 6f66 2072 6566 6d65 ]]>. │ │ │ +000ae3e0: 0a3c 2145 4e54 4954 5920 2520 7265 666d ..... │ │ │ +000ae480: 3c21 454e 5449 5459 2025 2072 6566 6d69 . │ │ │ +000ae4f0: 0a3c 212d 2d65 6e64 206f 6620 7265 666d ... │ │ │ +000ae550: 0a3c 2145 4e54 4954 5920 2520 7265 666d .. │ │ │ +000ae610: 0a3c 212d 2d65 6e64 206f 6620 7265 666d .]]>.......< │ │ │ +000ae720: 215b 2572 6566 6e61 6d65 6469 762e 656c ![%refnamediv.el │ │ │ +000ae730: 656d 656e 743b 5b0a 3c21 454c 454d 454e ement;[..< │ │ │ +000ae7a0: 212d 2d65 6e64 206f 6620 7265 666e 616d !--end of refnam │ │ │ +000ae7b0: 6564 6976 2e65 6c65 6d65 6e74 2d2d 3e5d ediv.element-->] │ │ │ +000ae7c0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>....]]>.]]>...< │ │ │ +000ae8b0: 2145 4e54 4954 5920 2520 7265 6664 6573 !ENTITY % refdes │ │ │ +000ae8c0: 6372 6970 746f 722e 6d6f 6475 6c65 2022 criptor.module " │ │ │ +000ae8d0: 494e 434c 5544 4522 3e0a 3c21 5b25 7265 INCLUDE">..< │ │ │ +000ae920: 2145 4e54 4954 5920 2520 7265 6664 6573 !ENTITY % refdes │ │ │ +000ae930: 6372 6970 746f 722e 726f 6c65 2e61 7474 criptor.role.att │ │ │ +000ae940: 7269 6220 2225 726f 6c65 2e61 7474 7269 rib "%role.attri │ │ │ +000ae950: 623b 223e 0a0a 3c21 454e 5449 5459 2025 b;">.... │ │ │ +000ae9f0: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>.. │ │ │ +000aea20: 0a3c 215b 2572 6566 6465 7363 7269 7074 ..]]>.] │ │ │ +000aeaf0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>........]]>... │ │ │ +000aec30: 3c21 5b25 7265 666e 616d 652e 6174 746c .]]>.]]>..< │ │ │ +000aece0: 2145 4e54 4954 5920 2520 7265 6670 7572 !ENTITY % refpur │ │ │ +000aecf0: 706f 7365 2e6d 6f64 756c 6520 2249 4e43 pose.module "INC │ │ │ +000aed00: 4c55 4445 223e 0a3c 215b 2572 6566 7075 LUDE">......]]>..< │ │ │ +000aee10: 2145 4e54 4954 5920 2520 7265 6670 7572 !ENTITY % refpur │ │ │ +000aee20: 706f 7365 2e61 7474 6c69 7374 2022 494e pose.attlist "IN │ │ │ +000aee30: 434c 5544 4522 3e0a 3c21 5b25 7265 6670 CLUDE">. │ │ │ +000aeeb0: 0a3c 212d 2d65 6e64 206f 6620 7265 6670 .]]>...< │ │ │ +000aef20: 215b 2572 6566 636c 6173 732e 6d6f 6475 ![%refclass.modu │ │ │ +000aef30: 6c65 3b5b 0a3c 2145 4e54 4954 5920 2520 le;[......]]>...< │ │ │ +000af040: 215b 2572 6566 636c 6173 732e 6174 746c ![%refclass.attl │ │ │ +000af050: 6973 743b 5b0a 3c21 4154 544c 4953 5420 ist;[.. │ │ │ +000af0b0: 3c21 2d2d 656e 6420 6f66 2072 6566 636c ]] │ │ │ +000af0d0: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6566 >.] │ │ │ +000af0f0: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>... │ │ │ +000af120: 3c21 5b25 7265 6673 796e 6f70 7369 7364 ...< │ │ │ +000af1a0: 2145 4e54 4954 5920 2520 7265 6673 796e !ENTITY % refsyn │ │ │ +000af1b0: 6f70 7369 7364 6976 2e65 6c65 6d65 6e74 opsisdiv.element │ │ │ +000af1c0: 2022 494e 434c 5544 4522 3e0a 3c21 5b25 "INCLUDE">..] │ │ │ +000af290: 5d3e 0a0a 3c21 454e 5449 5459 2025 2072 ]>.. │ │ │ +000af2c0: 0a3c 215b 2572 6566 7379 6e6f 7073 6973 ..]] │ │ │ +000af370: 3e0a 3c21 2d2d 656e 6420 6f66 2072 6566 >.]]>... │ │ │ +000af3c0: 3c21 5b25 7265 6673 6563 7431 2e6d 6f64 .....]]>. │ │ │ +000af500: 0a3c 2145 4e54 4954 5920 2520 7265 6673 ...]]>.]]>..< │ │ │ +000af5f0: 2145 4e54 4954 5920 2520 7265 6673 6563 !ENTITY % refsec │ │ │ +000af600: 7432 2e6d 6f64 756c 6520 2249 4e43 4c55 t2.module "INCLU │ │ │ +000af610: 4445 223e 0a3c 215b 2572 6566 7365 6374 DE">.. │ │ │ +000af650: 3c21 454e 5449 5459 2025 2072 6566 7365 │ │ │ +000af680: 0a0a 3c21 454e 5449 5459 2025 2072 6566 .... │ │ │ +000af750: 5d5d 3e0a 0a3c 2145 4e54 4954 5920 2520 ]]>....< │ │ │ +000af800: 212d 2d65 6e64 206f 6620 7265 6673 6563 !--end of refsec │ │ │ +000af810: 7432 2e61 7474 6c69 7374 2d2d 3e5d 5d3e t2.attlist-->]]> │ │ │ +000af820: 0a3c 212d 2d65 6e64 206f 6620 7265 6673 .]] │ │ │ +000af840: 3e0a 0a3c 2145 4e54 4954 5920 2520 7265 >........]]>..< │ │ │ +000af990: 2145 4e54 4954 5920 2520 7265 6673 6563 !ENTITY % refsec │ │ │ +000af9a0: 7433 2e61 7474 6c69 7374 2022 494e 434c t3.attlist "INCL │ │ │ +000af9b0: 5544 4522 3e0a 3c21 5b25 7265 6673 6563 UDE">..]]>.]]>.............] │ │ │ +000afe10: 5d3e 0a0a 3c21 2d2d 2043 6c61 7373 3a20 ]>....... │ │ │ +000afef0: 3c21 5b25 6172 7469 636c 652e 6174 746c .]]>.]]>........ │ │ │ +000b0100: 2064 656d 6f2f 646f 6373 7263 2f44 6f63 demo/docsrc/Doc │ │ │ +000b0110: 426f 6f6b 2f64 6f63 626f 6f6b 782e 6474 Book/docbookx.dt │ │ │ +000b0120: 64df 0000 11e7 3c21 2d2d 202e 2e2e 2e2e d....................%dbno │ │ │ +000b0c30: 746e 3b0a 5d5d 3e0a 0a3c 212d 2d20 2e2e tn;.]]>........ │ │ │ +000b0db0: 2564 6263 656e 743b 0a5d 5d3e 0a0a 3c21 %dbcent;.]]>.....< │ │ │ +000b0e60: 212d 2d20 496e 666f 726d 6174 696f 6e20 !-- Information │ │ │ +000b0e70: 706f 6f6c 202e 2e2e 2e2e 2e2e 2e2e 2e2e pool ........... │ │ │ +000b0e80: 2e2e 2e20 2d2d 3e0a 0a3c 2145 4e54 4954 ... -->....%dbpool;. │ │ │ +000b0f30: 5d5d 3e0a 0a3c 212d 2d20 5265 6465 636c ]]>....< │ │ │ +000b0f60: 2145 4e54 4954 5920 2520 696e 7465 726d !ENTITY % interm │ │ │ +000b0f70: 6f64 2e72 6564 6563 6c2e 6d6f 6475 6c65 od.redecl.module │ │ │ +000b0f80: 2022 4947 4e4f 5245 223e 0a3c 215b 2569 "IGNORE">...%rdbmods;. │ │ │ +000b1030: 5d5d 3e0a 0a3c 212d 2d20 446f 6375 6d65 ]]>....< │ │ │ +000b1060: 2145 4e54 4954 5920 2520 6462 6869 6572 !ENTITY % dbhier │ │ │ +000b1070: 2e6d 6f64 756c 6520 2249 4e43 4c55 4445 .module "INCLUDE │ │ │ +000b1080: 223e 0a3c 215b 2025 6462 6869 6572 2e6d ">..% │ │ │ +000b1100: 6462 6869 6572 3b0a 5d5d 3e0a 0a3c 212d dbhier;.]]>.......%db │ │ │ +000b1260: 6765 6e65 6e74 3b0a 5d5d 3e0a 0a3c 212d genent;.]]>....... │ │ │ +000b1310: 001c 6465 6d6f 2f64 6f63 7372 632f 446f ..demo/docsrc/Do │ │ │ +000b1320: 6342 6f6f 6b2f 7465 7374 2e78 6d6c df00 cBook/test.xml.. │ │ │ +000b1330: 0005 fb3c 212d 2d0a 202d 2020 0a20 2d20 ......foo</ti │ │ │ +000b1720: 746c 653e 0a0a 3c63 6861 7074 6572 3e3c tle>..<chapter>< │ │ │ +000b1730: 7469 746c 653e 6261 723c 2f74 6974 6c65 title>bar...foo..... │ │ │ +000b1780: 0a3c 726f 773e 0a3c 656e 7472 793e 666f ..fo │ │ │ +000b1790: 6f3c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a o. │ │ │ +000b17a0: 3c72 6f77 3e3c 656e 7472 793e 6261 723c bar< │ │ │ +000b17b0: 2f65 6e74 7279 3e3c 2f72 6f77 3e0a 3c2f /entry>.. │ │ │ +000b17d0: 0a3c 2f69 6e66 6f72 6d61 6c74 6162 6c65 ...bar..< │ │ │ +000b1810: 7462 6f64 793e 0a3c 726f 773e 3c65 6e74 tbody>.bar...
│ │ │ +000b1850: 0a0a 3c2f 6368 6170 7465 723e 0a0a 3c67 ..... │ │ │ +000b1880: 666f 6f3c 2f67 6c6f 7373 7465 726d 3e0a foo. │ │ │ +000b1890: 3c69 6e64 6578 7465 726d 3e3c 7072 696d foo... │ │ │ +000b18d0: 536f 6d65 2061 7070 726f 7072 6961 7465 Some appropriate │ │ │ +000b18e0: 2064 6566 696e 6974 696f 6e20 676f 6573 definition goes │ │ │ +000b18f0: 2068 6572 652e 0a3c 2f70 6172 613e 0a3c here...< │ │ │ +000b1900: 2f67 6c6f 7373 6465 663e 0a3c 2f67 6c6f /glossdef>....
... │ │ │ 000b1930: 0000 1864 656d 6f2f 646f 6373 7263 2f56 ...demo/docsrc/V │ │ │ 000b1940: 6972 7464 6f63 732e 7370 70df 0000 097b irtdocs.spp....{ │ │ │ 000b1950: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... │ │ │ -001d8b70: 0a20 2020 203c 7265 6665 6e74 7279 7469 . year. dconv< │ │ │ -001d8bb0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001d8bc0: 2020 3c72 6566 6d69 7363 696e 666f 3e74 t │ │ │ -001d8bd0: 696d 653c 2f72 6566 6d69 7363 696e 666f ime. . │ │ │ -001d8bf0: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -001d8c00: 2020 3c72 6566 6e61 6d65 3e79 6561 723c year< │ │ │ -001d8c10: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. get ye │ │ │ -001d8c30: 6172 2066 726f 6d20 6120 6461 7465 7469 ar from a dateti │ │ │ -001d8c40: 6d65 3c2f 7265 6670 7572 706f 7365 3e0a me. │ │ │ -001d8c50: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -001d8c60: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ -001d8cc0: 2020 2020 3c66 756e 6364 6566 3e3c 6675 year │ │ │ -001d8cf0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -001d8d00: 7061 7261 6d65 7465 723e 6474 3c2f 7061 parameter>dt datetim │ │ │ -001d8d20: 653c 2f70 6172 616d 6465 663e 0a20 2020 e. │ │ │ -001d8d30: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . De │ │ │ -001d8d90: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. year takes a datetime and returns. │ │ │ -001d8df0: 2020 2020 616e 203c 7479 7065 3e69 6e74 an int │ │ │ -001d8e00: 6567 6572 3c2f 7479 7065 3e20 636f 6e74 eger cont │ │ │ -001d8e10: 6169 6e69 6e67 2061 206e 756d 6265 7220 aining a number │ │ │ -001d8e20: 7265 7072 6573 656e 7469 6e67 2074 6865 representing the │ │ │ -001d8e30: 2079 6561 7220 6f66 2074 6865 2064 6174 year of the dat │ │ │ -001d8e40: 6574 696d 652e 3c2f 7061 7261 3e0a 2020 etime.. │ │ │ -001d8e50: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . │ │ │ -001d8e80: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -001d8e90: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -001d8ea0: 3e3c 7469 746c 653e 6474 3c2f 7469 746c ><title>dt</titl │ │ │ -001d8eb0: 653e 0a20 2020 2020 203c 7061 7261 3e41 e>. <para>A │ │ │ -001d8ec0: 203c 7479 7065 3e64 6174 6574 696d 653c <type>datetime< │ │ │ -001d8ed0: 2f74 7970 653e 2e3c 2f70 6172 613e 0a20 /type>.</para>. │ │ │ -001d8ee0: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ -001d8ef0: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ -001d8f00: 7265 6673 6563 7431 2069 643d 2272 6574 refsect1 id="ret │ │ │ -001d8f10: 5f79 6561 7222 3e3c 7469 746c 653e 5265 _year"><title>Re │ │ │ -001d8f20: 7475 726e 2056 616c 7565 733c 2f74 6974 turn Values</tit │ │ │ -001d8f30: 6c65 3e0a 2020 2020 3c70 6172 613e 416e le>. <para>An │ │ │ -001d8f40: 203c 7479 7065 3e49 4e54 4547 4552 3c2f <type>INTEGER</ │ │ │ -001d8f50: 7479 7065 3e20 636f 6e74 6169 6e69 6e67 type> containing │ │ │ -001d8f60: 2074 6865 2079 6561 722e 3c2f 7061 7261 the year.</para │ │ │ -001d8f70: 3e3c 2f72 6566 7365 6374 313e 0a3c 212d ></refsect1>.<!- │ │ │ -001d8f80: 2d20 203c 7265 6673 6563 7431 2069 643d - <refsect1 id= │ │ │ -001d8f90: 2265 7272 6f72 735f 7965 6172 223e 3c74 "errors_year"><t │ │ │ -001d8fa0: 6974 6c65 3e45 7272 6f72 733c 2f74 6974 itle>Errors</tit │ │ │ -001d8fb0: 6c65 3e0a 2020 2020 3c74 6162 6c65 3e3c le>. <table>< │ │ │ -001d8fc0: 7469 746c 653e 4572 726f 7273 2073 6967 title>Errors sig │ │ │ -001d8fd0: 6e61 6c6c 6564 2062 7920 7965 6172 3c2f nalled by year</ │ │ │ -001d8fe0: 7469 746c 653e 0a20 2020 2020 203c 7467 title>. <tg │ │ │ -001d8ff0: 726f 7570 2063 6f6c 733d 2234 223e 0a20 roup cols="4">. │ │ │ -001d9000: 2020 2020 2020 3c74 6865 6164 3e3c 726f <thead><ro │ │ │ -001d9010: 773e 3c65 6e74 7279 3e53 514c 5374 6174 w><entry>SQLStat │ │ │ -001d9020: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e</entry><entry> │ │ │ -001d9030: 4572 726f 7220 436f 6465 3c2f 656e 7472 Error Code</entr │ │ │ -001d9040: 793e 3c65 6e74 7279 3e45 7272 6f72 2054 y><entry>Error T │ │ │ -001d9050: 6578 743c 2f65 6e74 7279 3e3c 656e 7472 ext</entry><entr │ │ │ -001d9060: 793e 4465 7363 7269 7074 696f 6e3c 2f65 y>Description</e │ │ │ -001d9070: 6e74 7279 3e3c 2f72 6f77 3e3c 2f74 6865 ntry></row></the │ │ │ -001d9080: 6164 3e0a 093c 7462 6f64 793e 0a09 2020 ad>..<tbody>.. │ │ │ -001d9090: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 <row>.. <entr │ │ │ -001d90a0: 793e 3c65 7272 6f72 636f 6465 3e3c 2f65 y><errorcode></e │ │ │ -001d90b0: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ -001d90c0: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ -001d90d0: 7272 6f72 636f 6465 3e3c 2f65 7272 6f72 rrorcode></error │ │ │ -001d90e0: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ -001d90f0: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ -001d9100: 6e61 6d65 3e3c 2f65 7272 6f72 6e61 6d65 name></errorname │ │ │ -001d9110: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ -001d9120: 656e 7472 793e 3c2f 656e 7472 793e 0a09 entry></entry>.. │ │ │ -001d9130: 2020 3c2f 726f 773e 0a09 3c2f 7462 6f64 </row>..</tbod │ │ │ -001d9140: 793e 0a20 2020 2020 203c 2f74 6772 6f75 y>. </tgrou │ │ │ -001d9150: 703e 0a20 2020 203c 2f74 6162 6c65 3e0a p>. </table>. │ │ │ -001d9160: 2020 3c2f 7265 6673 6563 7431 3e20 2d2d </refsect1> -- │ │ │ -001d9170: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ -001d9180: 3d22 6578 616d 706c 6573 5f79 6561 7222 ="examples_year" │ │ │ -001d9190: 3e3c 7469 746c 653e 4578 616d 706c 6573 ><title>Examples │ │ │ -001d91a0: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Simple │ │ │ -001d91d0: 2065 7861 6d70 6c65 3c2f 7469 746c 653e example │ │ │ -001d91e0: 0a20 2020 2020 203c 7061 7261 3e47 6574 . Get │ │ │ -001d91f0: 2063 7572 7265 6e74 2079 6561 722e 3c2f current year.. SQL> select │ │ │ -001d9220: 7965 6172 2028 6e6f 7720 2829 293b 0a63 year (now ());.c │ │ │ -001d9230: 616c 6c72 6574 0a49 4e54 4547 4552 0a5f allret.INTEGER._ │ │ │ -001d9240: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001d9250: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001d9260: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001d9270: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001d9280: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ -001d9290: 3230 3031 0a0a 3c2f 7363 7265 656e 3e0a 2001... │ │ │ -001d92a0: 2020 2020 3c2f 6578 616d 706c 653e 0a20 . │ │ │ -001d92b0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001d92c0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ -001d92d0: 616c 736f 223e 3c74 6974 6c65 3e53 6565 also">See │ │ │ -001d92e0: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -001d92f0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 day │ │ │ -001d9320: 6e61 6d65 3c2f 6675 6e63 7469 6f6e 3e3c name< │ │ │ -001d9330: 2f6c 696e 6b3e 2c0a 3c21 2d2d 2020 2020 /link>,.. dayofmonth
, │ │ │ -001d93d0: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . dayo │ │ │ -001d9400: 6677 6565 6b3c 2f66 756e 6374 696f 6e3e fweek │ │ │ -001d9410: 3c2f 6c69 6e6b 3e2c 0a20 2020 203c 6c69 ,.
  • dayofyear, │ │ │ -001d9460: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . │ │ │ -001d9480: 3c66 756e 6374 696f 6e3e 7175 6172 7465 quarte │ │ │ -001d9490: 723c 2f66 756e 6374 696f 6e3e 3c2f 6c69 r
  • ,. week< │ │ │ -001d94d0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. │ │ │ -001d9500: 3c66 756e 6374 696f 6e3e 6d6f 6e74 683c month< │ │ │ -001d9510: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. < │ │ │ -001d9540: 6675 6e63 7469 6f6e 3e68 6f75 723c 2f66 function>hour
    , │ │ │ -001d9560: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . < │ │ │ -001d9580: 6675 6e63 7469 6f6e 3e6d 696e 7574 653c function>minute< │ │ │ -001d9590: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. secon │ │ │ -001d95d0: 643c 2f66 756e 6374 696f 6e3e 3c2f 6c69 d,. t │ │ │ -001d9610: 696d 657a 6f6e 653c 2f66 756e 6374 696f imezone │ │ │ -001d9630: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ -001d9640: 2f72 6566 656e 7472 793e 0ab6 0000 0021 /refentry>.....! │ │ │ -001d9650: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -001d9660: 7265 662f 7874 7265 655f 646f 632e 786d ref/xtree_doc.xm │ │ │ -001d9670: 6cdf 0000 140e 3c3f 786d 6c20 7665 7273 l....... │ │ │ -001d9a20: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -001d9a30: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -001d9a40: 7874 7265 655f 646f 633c 2f72 6566 656e xtree_doc. xml. < │ │ │ -001d9a80: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . xtree_doc< │ │ │ -001d9ab0: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. return │ │ │ -001d9ad0: 7320 616e 2065 6e74 6974 7920 6f62 6a65 s an entity obje │ │ │ -001d9ae0: 6374 2063 7265 6174 6564 2066 726f 6d20 ct created from │ │ │ -001d9af0: 616e 2058 4d4c 2064 6f63 756d 656e 743c an XML document< │ │ │ -001d9b00: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -001d9b10: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -001d9b20: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -001d9b30: 2020 2020 3c66 756e 6373 796e 6f70 7369 . . x │ │ │ -001d9ba0: 7472 6565 5f64 6f63 3c2f 6675 6e63 7469 tree_doc. │ │ │ -001d9bc0: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001d9bd0: 696e 203c 7061 7261 6d65 7465 723e 646f in do │ │ │ -001d9be0: 6375 6d65 6e74 3c2f 7061 7261 6d65 7465 cument varchar.

    in │ │ │ -001d9c30: 7061 7273 6572 5f6d 6f64 653c 2f70 6172 parser_mode integer< │ │ │ -001d9c50: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>.

    in │ │ │ -001d9c90: 6261 7365 5f75 7269 3c2f 7061 7261 6d65 base_uri varchar. i │ │ │ -001d9ce0: 6e20 3c70 6172 616d 6574 6572 3e63 6f6e n con │ │ │ -001d9cf0: 7465 6e74 5f65 6e63 6f64 696e 673c 2f70 tent_encoding

    varcha │ │ │ -001d9d10: 723c 2f6f 7074 696f 6e61 6c3e 3c2f 7061 r. │ │ │ -001d9d30: 3c70 6172 616d 6465 663e 3c6f 7074 696f in content_langua │ │ │ -001d9d60: 6765 3c2f 7061 7261 6d65 7465 723e 2076 ge
    v │ │ │ -001d9d70: 6172 6368 6172 3c2f 6f70 7469 6f6e 616c archar
    . │ │ │ -001d9d90: 2020 2020 203c 7061 7261 6d64 6566 3e3c < │ │ │ -001d9da0: 6f70 7469 6f6e 616c 3e69 6e20 3c70 6172 optional>in dtd_valid │ │ │ -001d9dc0: 6174 6f72 5f63 6f6e 6669 673c 2f70 6172 ator_config varchar< │ │ │ -001d9de0: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>. . │ │ │ -001d9e10: 203c 2f66 756e 6373 796e 6f70 7369 733e │ │ │ -001d9e20: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . . Description. │ │ │ -001d9e70: 5468 6973 2070 6172 7365 7320 7468 6520 This parses the │ │ │ -001d9e80: 6172 6775 6d65 6e74 2c20 7768 6963 6820 argument, which │ │ │ -001d9e90: 6973 2065 7870 6563 7465 6420 746f 2062 is expected to b │ │ │ -001d9ea0: 6520 6120 7765 6c6c 2066 6f72 6d65 6420 e a well formed │ │ │ -001d9eb0: 584d 4c20 6672 6167 6d65 6e74 2061 6e64 XML fragment and │ │ │ -001d9ec0: 2072 6574 7572 6e73 2061 0a70 6172 7365 returns a.parse │ │ │ -001d9ed0: 2074 7265 6520 6173 2061 2073 7065 6369 tree as a speci │ │ │ -001d9ee0: 616c 206d 656d 6f72 792d 7265 7369 6465 al memory-reside │ │ │ -001d9ef0: 6e74 206f 626a 6563 742e 2057 6869 6c65 nt object. While │ │ │ -001d9f00: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 xpe │ │ │ -001d9f20: 725f 646f 633c 2f6c 696e 6b3e 2063 7265 r_doc cre │ │ │ -001d9f30: 6174 6573 0a73 6f6d 6520 6469 736b 2d72 ates.some disk-r │ │ │ -001d9f40: 6573 6964 656e 7420 6461 7461 2073 7472 esident data str │ │ │ -001d9f50: 7563 7475 7265 2c20 7874 7265 655f 646f ucture, xtree_do │ │ │ -001d9f60: 6328 2920 7769 6c6c 2077 6f72 6b20 6661 c() will work fa │ │ │ -001d9f70: 7374 6572 2062 7574 2069 7420 6d61 7920 ster but it may │ │ │ -001d9f80: 7265 7175 6972 6520 6d6f 7265 206d 656d require more mem │ │ │ -001d9f90: 6f72 792e 2059 6f75 206d 6179 0a77 6973 ory. You may.wis │ │ │ -001d9fa0: 6820 746f 2075 7365 2078 7472 6565 5f64 h to use xtree_d │ │ │ -001d9fb0: 6f63 2066 6f72 2073 6d61 6c6c 2064 6f63 oc for small doc │ │ │ -001d9fc0: 756d 656e 7473 2028 652e 672e 206c 6573 uments (e.g. les │ │ │ -001d9fd0: 7320 7468 616e 2035 206d 6567 6162 7974 s than 5 megabyt │ │ │ -001d9fe0: 6573 2061 6e64 2078 7065 725f 646f 6320 es and xper_doc │ │ │ -001d9ff0: 666f 7220 6c61 7267 6572 2064 6f63 756d for larger docum │ │ │ -001da000: 656e 7473 2e0a 093c 2f70 6172 613e 0a20 ents.... │ │ │ -001da010: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001da020: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -001da030: 616d 7322 3e3c 7469 746c 653e 5061 7261 ams">Para │ │ │ -001da040: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ -001da050: 2020 203c 7265 6673 6563 7432 3e3c 7469 document. well formed XML │ │ │ -001da090: 206f 7220 4854 4d4c 2064 6f63 756d 656e or HTML documen │ │ │ -001da0a0: 743c 2f70 6172 613e 3c2f 7265 6673 6563 t. parser_ │ │ │ -001da0d0: 6d6f 6465 3c2f 7469 746c 653e 0a20 2020 mode. │ │ │ -001da0e0: 2020 203c 7061 7261 3e30 2c20 3120 6f72 0, 1 or │ │ │ -001da0f0: 2032 3b20 3020 2d20 584d 4c20 7061 7273 2; 0 - XML pars │ │ │ -001da100: 6572 206d 6f64 652c 2031 202d 2048 544d er mode, 1 - HTM │ │ │ -001da110: 4c20 7061 7273 6572 206d 6f64 652c 2032 L parser mode, 2 │ │ │ -001da120: 202d 2027 6469 7274 7920 4854 4d4c 2720 - 'dirty HTML' │ │ │ -001da130: 0a6d 6f64 6520 2877 6974 6820 7175 6965 .mode (with quie │ │ │ -001da140: 7420 7265 636f 7665 7279 2061 6674 6572 t recovery after │ │ │ -001da150: 2061 6e79 2073 796e 7461 7820 6572 726f any syntax erro │ │ │ -001da160: 7229 3c2f 7061 7261 3e3c 2f72 6566 7365 r). base_u │ │ │ -001da190: 7269 3c2f 7469 746c 653e 0a20 2020 2020 ri. │ │ │ -001da1a0: 203c 7061 7261 3e69 6e20 4854 4d4c 2070 in HTML p │ │ │ -001da1b0: 6172 7365 7220 6d6f 6465 2063 6861 6e67 arser mode chang │ │ │ -001da1c0: 6520 616c 6c20 6162 736f 6c75 7465 2072 e all absolute r │ │ │ -001da1d0: 6566 6572 656e 6365 7320 746f 2072 656c eferences to rel │ │ │ -001da1e0: 6174 6976 6520 6672 6f6d 2067 6976 656e ative from given │ │ │ -001da1f0: 200a 6261 7365 5f75 7269 2028 6874 7470 .base_uri (http │ │ │ -001da200: 3a2f 2f26 6c74 3b68 6f73 7426 6774 3b3a ://<host>: │ │ │ -001da210: 266c 743b 706f 7274 2667 743b 2f26 6c74 <port>/< │ │ │ -001da220: 3b70 6174 6826 6774 3b29 3c2f 7061 7261 ;path>). │ │ │ -001da240: 203c 7265 6673 6563 7432 3e3c 7469 746c content_encodi │ │ │ -001da260: 6e67 3c2f 7469 746c 653e 0a20 2020 2020 ng. │ │ │ -001da270: 203c 7061 7261 3e73 7472 696e 6720 7769 string wi │ │ │ -001da280: 7468 2063 6f6e 7465 6e74 2065 6e63 6f64 th content encod │ │ │ -001da290: 696e 6720 7479 7065 206f 6620 266c 743b ing type of < │ │ │ -001da2a0: 646f 6375 6d65 6e74 2667 743b 3b20 7661 document>; va │ │ │ -001da2b0: 6c69 6420 6172 6520 2741 5343 4949 272c lid are 'ASCII', │ │ │ -001da2c0: 2027 4953 4f27 2c20 0a27 5554 4638 272c 'ISO', .'UTF8', │ │ │ -001da2d0: 2027 4953 4f38 3835 392d 3127 2c20 274c 'ISO8859-1', 'L │ │ │ -001da2e0: 4154 494e 2d31 2720 6574 632e 2c20 6465 ATIN-1' etc., de │ │ │ -001da2f0: 6661 756c 7473 2061 7265 2027 5554 462d faults are 'UTF- │ │ │ -001da300: 3827 2066 6f72 2058 4d4c 206d 6f64 6520 8' for XML mode │ │ │ -001da310: 616e 6420 274c 4154 494e 2d31 2720 666f and 'LATIN-1' fo │ │ │ -001da320: 7220 0a48 544d 4c20 6d6f 6465 2e3c 2f70 r .HTML mode.

    . │ │ │ -001da340: 2020 2020 3c72 6566 7365 6374 323e 3c74 content_lan │ │ │ -001da360: 6775 6167 653c 2f74 6974 6c65 3e0a 2020 guage. │ │ │ -001da370: 2020 2020 3c70 6172 613e 7374 7269 6e67 string │ │ │ -001da380: 2077 6974 6820 6c61 6e67 7561 6765 2074 with language t │ │ │ -001da390: 6167 206f 6620 636f 6e74 656e 7420 6f66 ag of content of │ │ │ -001da3a0: 2026 6c74 3b64 6f63 756d 656e 7426 6774 <document> │ │ │ -001da3b0: 3b3b 2076 616c 6964 206e 616d 6573 2061 ;; valid names a │ │ │ -001da3c0: 7265 206c 6973 7465 6420 696e 200a 4945 re listed in .IE │ │ │ -001da3d0: 5446 2052 4643 2031 3736 362c 2064 6566 TF RFC 1766, def │ │ │ -001da3e0: 6175 6c74 2069 7320 2778 2d61 6e79 2720 ault is 'x-any' │ │ │ -001da3f0: 2869 7420 6d65 616e 7320 276d 6978 206f (it means 'mix o │ │ │ -001da400: 6620 776f 7264 7320 6672 6f6d 2076 6172 f words from var │ │ │ -001da410: 696f 7573 2068 756d 616e 206c 616e 6775 ious human langu │ │ │ -001da420: 6167 6573 2729 3c2f 7061 7261 3e3c 2f72 ages')
    . dt │ │ │ -001da450: 645f 7661 6c69 6461 746f 725f 636f 6e66 d_validator_conf │ │ │ -001da460: 6967 3c2f 7469 746c 653e 0a20 2020 2020 ig. │ │ │ -001da470: 203c 7061 7261 3e63 6f6e 6669 6775 7261 configura │ │ │ -001da480: 7469 6f6e 2073 7472 696e 6720 666f 7220 tion string for │ │ │ -001da490: 4454 4420 7661 6c69 6461 746f 722c 2064 DTD validator, d │ │ │ -001da4a0: 6566 6175 6c74 2069 7320 656d 7074 7920 efault is empty │ │ │ -001da4b0: 7374 7269 6e67 206d 6561 6e69 6e67 2074 string meaning t │ │ │ -001da4c0: 6861 7420 4454 4420 0a76 616c 6964 6174 hat DTD .validat │ │ │ -001da4d0: 6f72 2073 686f 756c 6420 6265 2066 756c or should be ful │ │ │ -001da4e0: 6c79 2064 6973 6162 6c65 642e 0a53 6565 ly disabled..See │ │ │ -001da4f0: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 Conf │ │ │ -001da510: 6967 7572 6174 696f 6e20 4f70 7469 6f6e iguration Option │ │ │ -001da520: 7320 6f66 2074 6865 2044 5444 2056 616c s of the DTD Val │ │ │ -001da530: 6964 6174 6f72 3c2f 6c69 6e6b 3e20 666f idator fo │ │ │ -001da540: 7220 6465 7461 696c 732e 3c2f 7061 7261 r details.. < │ │ │ -001da560: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. │ │ │ -001da580: 3c74 6974 6c65 3e52 6574 7572 6e20 5479 Return Ty │ │ │ -001da590: 7065 733c 2f74 6974 6c65 3e3c 7061 7261 pesXML entity with │ │ │ -001da5b0: 2075 6e64 6572 6c79 696e 6720 7061 7273 underlying pars │ │ │ -001da5c0: 6520 7472 6565 200a 6f66 2073 6f75 7263 e tree .of sourc │ │ │ -001da5d0: 6520 646f 6375 6d65 6e74 3b20 7468 6520 e document; the │ │ │ -001da5e0: 7472 6565 2077 696c 6c20 6265 2061 206d tree will be a m │ │ │ -001da5f0: 656d 6f72 792d 7265 7369 6465 6e74 2073 emory-resident s │ │ │ -001da600: 7472 7563 7475 7265 206f 6620 6e65 7374 tructure of nest │ │ │ -001da610: 6564 2068 6574 6572 6f67 656e 656f 7573 ed heterogeneous │ │ │ -001da620: 200a 7665 6374 6f72 732e 3c2f 7061 7261 .vectors..Errors. │ │ │ -001da670: 2020 2020 3c74 6162 6c65 3e3c 7469 746c Errors signall │ │ │ -001da690: 6564 2062 793c 2f74 6974 6c65 3e0a 2020 ed by. │ │ │ -001da6a0: 2020 2020 3c74 6772 6f75 7020 636f 6c73 . . │ │ │ -001da800: 3c2f 7467 726f 7570 3e0a 2020 2020 3c2f . . .-->. Exampl │ │ │ -001da850: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ -001da860: 6578 616d 706c 6520 6964 3d22 6578 5f78 example id="ex_x │ │ │ -001da870: 7472 6565 5f64 6f63 223e 3c74 6974 6c65 tree_doc">xtree_doc</titl │ │ │ -001da890: 653e 0a3c 7072 6f67 7261 6d6c 6973 7469 e>.<programlisti │ │ │ -001da8a0: 6e67 3e0a 6465 636c 6172 6520 7472 6565 ng>.declare tree │ │ │ -001da8b0: 2061 6e79 3b0a 0a74 7265 6520 3a3d 2078 any;..tree := x │ │ │ -001da8c0: 7472 6565 5f64 6f63 2028 6669 6c65 5f74 tree_doc (file_t │ │ │ -001da8d0: 6f5f 7374 7269 6e67 2028 2764 6f63 2e68 o_string ('doc.h │ │ │ -001da8e0: 746d 6c27 292c 2031 2c20 0a09 0927 6874 tml'), 1, ...'ht │ │ │ -001da8f0: 7470 3a2f 2f6c 6f63 616c 686f 7374 2e6c tp://localhost.l │ │ │ -001da900: 6f63 616c 646f 6d61 696e 2f27 2c20 2749 ocaldomain/', 'I │ │ │ -001da910: 534f 2729 3b0a 2e2e 2e0a 7472 6565 203a SO');.....tree : │ │ │ -001da920: 3d20 7874 7265 655f 646f 6320 2866 696c = xtree_doc (fil │ │ │ -001da930: 655f 746f 5f73 7472 696e 6720 2827 646f e_to_string ('do │ │ │ -001da940: 632e 786d 6c27 2929 3b0a 3c2f 7072 6f67 c.xml'));.</prog │ │ │ -001da950: 7261 6d6c 6973 7469 6e67 3e0a 2020 2020 ramlisting>. │ │ │ -001da960: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 </example>. </r │ │ │ -001da970: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -001da980: 6563 7431 2069 643d 2273 6565 616c 736f ect1 id="seealso │ │ │ -001da990: 223e 3c74 6974 6c65 3e53 6565 2041 6c73 "><title>See Als │ │ │ -001da9a0: 6f3c 2f74 6974 6c65 3e0a 2020 2020 3c70 o.

    │ │ │ -001da9d0: 786d 6c5f 7472 6565 3c2f 6c69 6e6b 3e3c xml_tree< │ │ │ -001da9e0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xml_tree_doc. │ │ │ -001daa30: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xper_doc. .......(demo/do │ │ │ -001daa90: 6373 7263 2f66 756e 6372 6566 2f78 7465 csrc/funcref/xte │ │ │ -001daaa0: 5f6e 6f64 6562 6c64 5f69 6e69 742e 786d _nodebld_init.xm │ │ │ -001daab0: 6cdf 0000 0cab 3c3f 786d 6c20 7665 7273 l........ . xte_nodeb │ │ │ -001dae90: 6c64 5f69 6e69 743c 2f72 6566 656e 7472 ld_init. xml. . . xte_nodebld_ │ │ │ -001daf00: 696e 6974 3c2f 7265 666e 616d 653e 0a20 init. │ │ │ -001daf10: 2020 203c 7265 6670 7572 706f 7365 3e43 C │ │ │ -001daf20: 7265 6174 6573 2074 6865 2065 6d70 7479 reates the empty │ │ │ -001daf30: 2076 6563 746f 723c 2f72 6566 7075 7270 vector. . . . . │ │ │ -001dafd0: 203c 6675 6e63 6465 663e 3c66 756e 6374 xte_nodebld_ │ │ │ -001daff0: 696e 6974 3c2f 6675 6e63 7469 6f6e 3e3c init< │ │ │ -001db000: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -001db010: 2020 3c70 6172 616d 6465 663e 696e 6f75 inou │ │ │ -001db020: 7420 3c70 6172 616d 6574 6572 3e61 7267 t arg │ │ │ -001db030: 3c2f 7061 7261 6d65 7465 723e 2061 6e79 any │ │ │ -001db040: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ -001db050: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . Descrip │ │ │ -001db0c0: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ -001db0d0: 203c 7061 7261 3e54 6869 7320 6675 6e63 This func │ │ │ -001db0e0: 7469 6f6e 2063 7265 6174 6573 2074 6865 tion creates the │ │ │ -001db0f0: 2065 6d70 7479 2076 6563 746f 7220 616e empty vector an │ │ │ -001db100: 6420 6173 7369 676e 2069 7420 746f 2074 d assign it to t │ │ │ -001db110: 6865 2061 7267 756d 656e 742e 0a20 2020 he argument.. │ │ │ -001db120: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . . │ │ │ -001db160: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -001db170: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -001db180: 3e3c 7469 746c 653e 6172 673c 2f74 6974 ><title>arg</tit │ │ │ -001db190: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -001db1a0: 5661 7269 6162 6c65 206f 6620 616e 7920 Variable of any │ │ │ -001db1b0: 7479 7065 3c2f 7061 7261 3e0a 2020 2020 type</para>. │ │ │ -001db1c0: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f </refsect2>. </ │ │ │ -001db1d0: 7265 6673 6563 7431 3e0a 0a20 203c 7265 refsect1>.. <re │ │ │ -001db1e0: 6673 6563 7431 2069 643d 2265 7272 6f72 fsect1 id="error │ │ │ -001db1f0: 735f 7874 655f 6e6f 6465 626c 645f 696e s_xte_nodebld_in │ │ │ -001db200: 6974 223e 0a20 2020 203c 7469 746c 653e it">. <title> │ │ │ -001db210: 4572 726f 7273 3c2f 7469 746c 653e 0a20 Errors. │ │ │ -001db220: 2020 203c 7461 626c 653e 3c74 6974 6c65

    │ │ │ -001da6d0: 5351 4c53 7461 7465 3c2f 656e 7472 793e SQLState │ │ │ -001da6e0: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ -001da6f0: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ -001da700: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ -001da720: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion.... .. │ │ │ -001da750: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 │ │ │ -001da770: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 .. │ │ │ -001da790: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. │ │ │ -001da7d0: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ -001da7f0: 093c 2f74 626f 6479 3e0a 2020 2020 2020 .
    Errors signalle │ │ │ -001db240: 6420 6279 203c 6675 6e63 7469 6f6e 3e78 d by <function>x │ │ │ -001db250: 7465 5f6e 6f64 6562 6c64 5f69 6e69 743c te_nodebld_init< │ │ │ -001db260: 2f66 756e 6374 696f 6e3e 3c2f 7469 746c /function></titl │ │ │ -001db270: 653e 0a20 2020 2020 203c 7467 726f 7570 e>. <tgroup │ │ │ -001db280: 2063 6f6c 733d 2234 223e 0a09 3c74 6865 cols="4">..<the │ │ │ -001db290: 6164 3e0a 0920 203c 726f 773e 0a09 2020 ad>.. <row>.. │ │ │ -001db2a0: 2020 3c65 6e74 7279 3e53 514c 5374 6174 <entry>SQLStat │ │ │ -001db2b0: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e</entry><entry> │ │ │ -001db2c0: 4572 726f 7220 436f 6465 3c2f 656e 7472 Error Code</entr │ │ │ -001db2d0: 793e 3c65 6e74 7279 3e45 7272 6f72 2054 y><entry>Error T │ │ │ -001db2e0: 6578 743c 2f65 6e74 7279 3e3c 656e 7472 ext</entry><entr │ │ │ -001db2f0: 793e 4465 7363 7269 7074 696f 6e3c 2f65 y>Description</e │ │ │ -001db300: 6e74 7279 3e0a 0920 203c 2f72 6f77 3e0a ntry>.. </row>. │ │ │ -001db310: 093c 2f74 6865 6164 3e0a 093c 7462 6f64 .</thead>..<tbod │ │ │ -001db320: 793e 0a09 2020 3c72 6f77 3e0a 0920 2020 y>.. <row>.. │ │ │ -001db330: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ -001db340: 6465 3e32 3230 3033 3c2f 6572 726f 7263 de>22003</errorc │ │ │ -001db350: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ -001db360: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 <entry><errorc │ │ │ -001db370: 6f64 653e 5352 3334 343c 2f65 7272 6f72 ode>SR344</error │ │ │ -001db380: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ -001db390: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ -001db3a0: 6e61 6d65 3e54 6f6f 2066 6577 2061 7267 name>Too few arg │ │ │ -001db3b0: 756d 656e 7473 2066 6f72 2078 7465 5f6e uments for xte_n │ │ │ -001db3c0: 6f64 6562 6c64 5f69 6e69 743c 2f65 7272 odebld_init</err │ │ │ -001db3d0: 6f72 6e61 6d65 3e3c 2f65 6e74 7279 3e0a orname></entry>. │ │ │ -001db3e0: 0920 2020 203c 656e 7472 793e 3c2f 656e . <entry></en │ │ │ -001db3f0: 7472 793e 0a09 2020 3c2f 726f 773e 0a09 try>.. </row>.. │ │ │ -001db400: 3c2f 7462 6f64 793e 0a20 2020 2020 203c </tbody>. < │ │ │ -001db410: 2f74 6772 6f75 703e 0a20 2020 203c 2f74 /tgroup>. </t │ │ │ -001db420: 6162 6c65 3e0a 2020 3c2f 7265 6673 6563 able>. </refsec │ │ │ -001db430: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ -001db440: 6964 3d22 7874 655f 6e6f 6465 626c 645f id="xte_nodebld_ │ │ │ -001db450: 696e 6974 223e 3c74 6974 6c65 3e45 7861 init"><title>Exa │ │ │ -001db460: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ -001db470: 2020 3c65 7861 6d70 6c65 2069 643d 2265 Simpl │ │ │ -001db4a0: 6520 5573 653c 2f74 6974 6c65 3e0a 2020 e Use. │ │ │ -001db4b0: 2020 2020 3c70 6172 613e 4166 7465 7220 After │ │ │ -001db4c0: 6361 6c6c 696e 6720 7874 655f 6e6f 6465 calling xte_node │ │ │ -001db4d0: 626c 645f 696e 6974 2829 2074 6865 2076 bld_init() the v │ │ │ -001db4e0: 6563 746f 7220 6163 6320 6f66 2074 7970 ector acc of typ │ │ │ -001db4f0: 6520 616e 7920 6973 2065 6d70 7479 2061 e any is empty a │ │ │ -001db500: 6e64 206d 6179 2062 6520 7573 6564 2020 nd may be used │ │ │ -001db510: 0a20 2020 2020 2020 2020 2020 2062 7920 . by │ │ │ -001db520: 7874 655f 6e6f 6465 626c 645f 6163 6320 xte_nodebld_acc │ │ │ -001db530: 6675 6e63 7469 6f6e 203c 2f70 6172 613e function │ │ │ -001db540: 0a20 2020 2020 203c 7363 7265 656e 3e20 . │ │ │ -001db550: 2078 7465 5f6e 6f64 6562 6c64 5f69 6e69 xte_nodebld_ini │ │ │ -001db560: 7428 6163 6329 3b3c 2f73 6372 6565 6e3e t(acc); │ │ │ -001db570: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -001db580: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -001db590: 3c72 6566 7365 6374 3120 6964 3d22 7365 S │ │ │ -001db5c0: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ -001db5d0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xte_head() │ │ │ -001db600: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -001db610: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xte_node()< │ │ │ -001db640: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -001db650: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xte_node_from_n │ │ │ -001db690: 6f64 6562 6c64 2829 3c2f 6c69 6e6b 3e3c odebld()< │ │ │ -001db6a0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xte_nodebld_ │ │ │ -001db6e0: 6163 6328 293c 2f6c 696e 6b3e 3c2f 7061 acc(). xte_nodebld_f │ │ │ -001db730: 696e 616c 2829 3c2f 6c69 6e6b 3e3c 2f70 inal()

    . ... │ │ │ -001db760: 0ab6 0000 0029 6465 6d6f 2f64 6f63 7372 .....)demo/docsr │ │ │ -001db770: 632f 6675 6e63 7265 662f 7874 655f 6e6f c/funcref/xte_no │ │ │ -001db780: 6465 626c 645f 6669 6e61 6c2e 786d 6cdf debld_final.xml. │ │ │ -001db790: 0000 1659 3c3f 786d 6c20 7665 7273 696f ...Y. │ │ │ -001db7c0: 3c21 2d2d 200a 202d 2020 0a20 2d20 2054 .. │ │ │ -001dd1d0: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -001dd1e0: 7265 6665 6e74 7279 7469 746c 653e 7874 refentrytitle>xt │ │ │ -001dd1f0: 655f 6e6f 6465 626c 645f 6163 633c 2f72 e_nodebld_acc. │ │ │ -001dd210: 2020 3c72 6566 6d69 7363 696e 666f 3e78 x │ │ │ -001dd220: 6d6c 3c2f 7265 666d 6973 6369 6e66 6f3e ml │ │ │ -001dd230: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ -001dd240: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ -001dd250: 203c 7265 666e 616d 653e 7874 655f 6e6f xte_no │ │ │ -001dd260: 6465 626c 645f 6163 633c 2f72 6566 6e61 debld_acc. Adds to the │ │ │ -001dd290: 6669 7273 7420 6172 6775 6d65 6e74 7320 first arguments │ │ │ -001dd2a0: 616c 6c20 7265 6d61 696e 696e 6720 6172 all remaining ar │ │ │ -001dd2b0: 6775 6d65 6e74 7320 3c2f 7265 6670 7572 guments . . . . . │ │ │ -001dd350: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 xte_nodebld_a │ │ │ -001dd370: 6363 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 cc. │ │ │ -001dd390: 3c70 6172 616d 6465 663e 696e 203c 7061 in acc any. < │ │ │ -001dd3d0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in arg1 any. < │ │ │ -001dd410: 7061 7261 6d64 6566 3e20 3c70 6172 616d paramdef> ... │ │ │ -001dd440: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in argN any │ │ │ -001dd480: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ -001dd4c0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Des │ │ │ -001dd4f0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -001dd500: 0a20 2020 203c 7061 7261 3e20 5468 6520 . The │ │ │ -001dd510: 7874 655f 6e6f 6465 626c 645f 6163 6328 xte_nodebld_acc( │ │ │ -001dd520: 2920 6675 6e63 7469 6f6e 2073 7563 6365 ) function succe │ │ │ -001dd530: 7373 6976 656c 7920 6164 6473 2020 0a20 ssively adds . │ │ │ -001dd540: 2020 2074 6865 2072 656d 6169 6e69 6e67 the remaining │ │ │ -001dd550: 2061 7267 756d 656e 7473 2074 6f20 7468 arguments to th │ │ │ -001dd560: 6520 6669 7273 7420 6f6e 652e 0a20 2020 e first one.. │ │ │ -001dd570: 2049 6620 7468 6520 6c61 7374 2069 7465 If the last ite │ │ │ -001dd580: 6d73 206f 6620 7468 6520 6669 7273 7420 ms of the first │ │ │ -001dd590: 6172 6775 6d65 6e74 2061 6e64 2073 6f6d argument and som │ │ │ -001dd5a0: 6520 666f 6c6c 6f77 696e 6720 6172 6775 e following argu │ │ │ -001dd5b0: 6d65 6e74 7320 6172 6520 7374 7269 6e67 ments are string │ │ │ -001dd5c0: 732c 0a20 2020 2074 6865 7920 6172 6520 s,. they are │ │ │ -001dd5d0: 636f 6e63 6174 656e 6174 6564 2e20 416c concatenated. Al │ │ │ -001dd5e0: 6c20 7375 6363 6573 7369 7665 2073 7472 l successive str │ │ │ -001dd5f0: 696e 6773 2061 7265 2063 6f6e 6361 7465 ings are concate │ │ │ -001dd600: 6e61 7465 642e 0a20 2020 2054 6865 2076 nated.. The v │ │ │ -001dd610: 616c 7565 206f 6620 7468 6520 6669 7273 alue of the firs │ │ │ -001dd620: 7420 6974 656d 2069 7320 7468 6520 6e75 t item is the nu │ │ │ -001dd630: 6d62 6572 206f 6620 7468 6520 6e6f 6e2d mber of the non- │ │ │ -001dd640: 656d 7074 7920 6974 656d 7320 696e 2074 empty items in t │ │ │ -001dd650: 6865 200a 2020 2020 7265 7475 726e 6564 he . returned │ │ │ -001dd660: 2076 6563 746f 722e 2054 6865 206c 656e vector. The len │ │ │ -001dd670: 6774 6820 6f66 2074 6865 2072 6574 7572 gth of the retur │ │ │ -001dd680: 6e65 6420 7665 6374 6f72 2069 7320 7468 ned vector is th │ │ │ -001dd690: 6520 7375 6d20 6f66 2074 6865 206c 656e e sum of the len │ │ │ -001dd6a0: 6774 6820 0a20 2020 206f 6620 7468 6520 gth . of the │ │ │ -001dd6b0: 6669 7273 7420 6172 6775 6d65 6e74 2061 first argument a │ │ │ -001dd6c0: 6e64 206e 756d 6265 7220 6f66 2074 6865 nd number of the │ │ │ -001dd6d0: 2072 656d 6169 6e69 6e67 2061 7267 756d remaining argum │ │ │ -001dd6e0: 656e 7473 2e0a 2020 2020 3c2f 7061 7261 ents.. . . │ │ │ -001dd700: 2020 3c72 6566 7365 6374 3120 6964 3d22 Paramete │ │ │ -001dd730: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -001dd740: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -001dd750: 6163 633c 2f74 6974 6c65 3e0a 2020 2020 acc. │ │ │ -001dd760: 2020 3c70 6172 613e 4120 7665 6374 6f72 A vector │ │ │ -001dd770: 2069 6e69 7469 6174 6564 2062 7920 7874 initiated by xt │ │ │ -001dd780: 655f 6e6f 6465 626c 645f 696e 6974 2829 e_nodebld_init() │ │ │ -001dd790: 2066 756e 6374 696f 6e20 616e 6420 6669 function and fi │ │ │ -001dd7a0: 6c6c 6564 2062 7920 0a20 2020 2078 7465 lled by . xte │ │ │ -001dd7b0: 5f6e 6f64 6562 6c64 5f61 6363 2829 2066 _nodebld_acc() f │ │ │ -001dd7c0: 756e 6374 696f 6e73 0a20 2020 203c 2f70 unctions.

    . . argI</ │ │ │ -001dd800: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -001dd810: 7261 3e41 2073 7472 696e 6720 6f72 2061 ra>A string or a │ │ │ -001dd820: 2076 6563 746f 7220 7265 7475 726e 6564 vector returned │ │ │ -001dd830: 2062 7920 7874 655f 6e6f 6465 5f66 726f by xte_node_fro │ │ │ -001dd840: 6d5f 6e6f 6465 626c 6420 6f72 200a 0920 m_nodebld or .. │ │ │ -001dd850: 2078 7465 5f6e 6f64 6520 6675 6e63 7469 xte_node functi │ │ │ -001dd860: 6f6e 733c 2f70 6172 613e 0a20 2020 203c ons</para>. < │ │ │ -001dd870: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ -001dd880: 6566 7365 6374 313e 0a0a 2020 3c72 6566 efsect1>.. <ref │ │ │ -001dd890: 7365 6374 3120 6964 3d22 6572 726f 7273 sect1 id="errors │ │ │ -001dd8a0: 5f78 7465 5f6e 6f64 6562 6c64 5f61 6363 _xte_nodebld_acc │ │ │ -001dd8b0: 223e 0a20 2020 203c 7469 746c 653e 4572 ">. <title>Er │ │ │ -001dd8c0: 726f 7273 3c2f 7469 746c 653e 0a20 2020 rors. │ │ │ -001dd8d0: 203c 7461 626c 653e 3c74 6974 6c65 3e45
    E │ │ │ -001dd8e0: 7272 6f72 7320 7369 676e 616c 6c65 6420 rrors signalled │ │ │ -001dd8f0: 6279 203c 6675 6e63 7469 6f6e 3e78 7465 by <function>xte │ │ │ -001dd900: 5f6e 6f64 6562 6c64 5f61 6363 3c2f 6675 _nodebld_acc</fu │ │ │ -001dd910: 6e63 7469 6f6e 3e3c 2f74 6974 6c65 3e0a nction>. │ │ │ -001dd920: 2020 2020 2020 3c74 6772 6f75 7020 636f .. │ │ │ -001dd940: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ -001dd950: 656e 7472 793e 5351 4c53 7461 7465 3c2f entry>SQLStateErr │ │ │ -001dd970: 6f72 2043 6f64 653c 2f65 6e74 7279 3e3c or Code< │ │ │ -001dd980: 656e 7472 793e 4572 726f 7220 5465 7874 entry>Error Text │ │ │ -001dd990: 3c2f 656e 7472 793e 3c65 6e74 7279 3e44 D │ │ │ -001dd9a0: 6573 6372 6970 7469 6f6e 3c2f 656e 7472 escription.. ..... │ │ │ -001dd9d0: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ -001dd9f0: 3232 3030 333c 2f65 7272 6f72 636f 6465 22003.. < │ │ │ -001dda10: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>SR345.. │ │ │ -001dda40: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Too few argume │ │ │ -001dda60: 6e74 7320 666f 7220 7874 655f 6e6f 6465 nts for xte_node │ │ │ -001dda70: 626c 645f 6163 633c 2f65 7272 6f72 6e61 bld_acc.. │ │ │ -001dda90: 203c 656e 7472 793e 3c2f 656e 7472 793e │ │ │ -001ddaa0: 0a09 2020 3c2f 726f 773e 0a09 2020 3c72 .. .. .. │ │ │ -001ddac0: 3c65 7272 6f72 636f 6465 3e32 3230 3033 22003 │ │ │ -001ddad0: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. SR34 │ │ │ -001ddb00: 363c 2f65 7272 6f72 636f 6465 3e3c 2f65 6.. The │ │ │ -001ddb30: 2066 6972 7374 2061 7267 756d 656e 7420 first argument │ │ │ -001ddb40: 6f66 2078 7465 5f6e 6f64 6562 6c64 5f61 of xte_nodebld_a │ │ │ -001ddb50: 6363 2069 7320 6e6f 7420 6d61 6465 2062 cc is not made b │ │ │ -001ddb60: 7920 7874 655f 6e6f 6465 626c 645f 696e y xte_nodebld_in │ │ │ -001ddb70: 6974 2829 2066 756e 6374 696f 6e3c 2f65 it() function.. .. │ │ │ -001ddbb0: 0a09 3c2f 7462 6f64 793e 0a20 2020 2020 ... │ │ │ -001ddbc0: 203c 2f74 6772 6f75 703e 0a20 2020 203c . < │ │ │ -001ddbd0: 2f74 6162 6c65 3e0a 2020 3c2f 7265 6673 /table>. . Ex │ │ │ -001ddc10: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ -001ddc20: 2020 203c 6578 616d 706c 6520 6964 3d22 Simpl │ │ │ -001ddc50: 6520 5573 653c 2f74 6974 6c65 3e0a 2020 e Use. │ │ │ -001ddc60: 2020 2020 3c73 6372 6565 6e3e 6372 6561 crea │ │ │ -001ddc70: 7465 2070 726f 6365 6475 7265 2074 6573 te procedure tes │ │ │ -001ddc80: 745f 6e6f 6465 626c 6428 290a 2020 2020 t_nodebld(). │ │ │ -001ddc90: 2020 2020 2020 2020 2020 7b0a 2020 2020 {. │ │ │ -001ddca0: 2020 2020 2020 2020 2020 2020 6465 636c decl │ │ │ -001ddcb0: 6172 6520 6163 6320 616e 793b 0a20 2020 are acc any;. │ │ │ -001ddcc0: 2020 2020 2020 2020 2020 2020 2078 7465 xte │ │ │ -001ddcd0: 5f6e 6f64 6562 6c64 5f69 6e69 7420 2861 _nodebld_init (a │ │ │ -001ddce0: 6363 293b 0a20 2020 2020 2020 2020 2020 cc);. │ │ │ -001ddcf0: 2020 2020 2078 7465 5f6e 6f64 6562 6c64 xte_nodebld │ │ │ -001ddd00: 5f61 6363 2028 6163 632c 2773 7472 696e _acc (acc,'strin │ │ │ -001ddd10: 6731 272c 2073 7472 696e 6732 2729 3b0a g1', string2');. │ │ │ -001ddd20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ -001ddd30: 7874 655f 6e6f 6465 626c 645f 6163 6328 xte_nodebld_acc( │ │ │ -001ddd40: 6163 632c 2027 7374 7269 6e67 3327 2c78 acc, 'string3',x │ │ │ -001ddd50: 7465 5f6e 6f64 6528 7874 655f 6865 6164 te_node(xte_head │ │ │ -001ddd60: 2028 2773 7570 706c 6965 7227 2c20 2743 ('supplier', 'C │ │ │ -001ddd70: 6f6d 7061 6e79 4e61 6d65 272c 2753 656c ompanyName','Sel │ │ │ -001ddd80: 6c65 7227 2929 293b 0a09 092e 202e 202e ler')));.... . . │ │ │ -001ddd90: 200a 0920 2020 2020 207d 200a 2020 2020 .. } . │ │ │ -001ddda0: 203c 2f73 6372 6565 6e3e 0a20 2020 2020 . │ │ │ -001dddb0: 203c 7061 7261 3e54 6865 206c 656e 6774 The lengt │ │ │ -001dddc0: 6820 6f66 2074 6865 2076 6563 746f 7220 h of the vector │ │ │ -001dddd0: 6163 6320 6173 2074 6865 2072 6573 756c acc as the resul │ │ │ -001ddde0: 7420 6f66 2074 6865 2074 776f 2078 7465 t of the two xte │ │ │ -001dddf0: 5f6e 6f64 6562 6c64 5f61 6363 2829 2063 _nodebld_acc() c │ │ │ -001dde00: 616c 6c73 2062 656c 6f77 2069 7320 6571 alls below is eq │ │ │ -001dde10: 7561 6c20 746f 2034 2c20 6275 7420 6f6e ual to 4, but on │ │ │ -001dde20: 6c79 0a20 2020 2020 2074 6872 6565 2069 ly. three i │ │ │ -001dde30: 7465 6d73 2061 7265 206e 6f74 2065 6d70 tems are not emp │ │ │ -001dde40: 7479 3a3c 2f70 6172 613e 0a20 2020 2020 ty:. │ │ │ -001dde50: 203c 7061 7261 3e20 2733 2720 286e 756d '3' (num │ │ │ -001dde60: 6265 7220 6f66 206e 6f74 2065 6d70 7479 ber of not empty │ │ │ -001dde70: 2065 6c65 6d65 6e74 7320 6f66 2074 6865 elements of the │ │ │ -001dde80: 2076 6563 746f 7220 696e 636c 7564 696e vector includin │ │ │ -001dde90: 6720 7468 6973 2069 7465 6d29 3c2f 7061 g this item). │ │ │ -001ddeb0: 2027 7374 7269 6e67 3173 7472 696e 6732 'string1string2 │ │ │ -001ddec0: 7374 7269 6e67 3327 2028 7468 6520 7265 string3' (the re │ │ │ -001dded0: 7375 6c74 206f 6620 636f 6e63 6174 656e sult of concaten │ │ │ -001ddee0: 6174 696f 6e29 3c2f 7061 7261 3e0a 2020 ation). │ │ │ -001ddef0: 2020 2020 3c70 6172 613e 2076 6563 746f vecto │ │ │ -001ddf00: 7220 636f 7272 6573 706f 6e64 696e 6720 r corresponding │ │ │ -001ddf10: 7468 6520 666f 6c6c 6f77 696e 6720 584d the following XM │ │ │ -001ddf20: 4c20 656c 656d 656e 743a 0a20 2020 2020 L element:. │ │ │ -001ddf30: 2020 2020 2020 2020 266c 743b 7375 7070 <supp │ │ │ -001ddf40: 6c69 6572 2020 436f 6d70 616e 794e 616d lier CompanyNam │ │ │ -001ddf50: 653d 2253 656c 6c65 7222 2667 743b 2020 e="Seller"> │ │ │ -001ddf60: 266c 743b 2f73 7570 706c 6965 7226 6774 </supplier> │ │ │ -001ddf70: 3b0a 2020 2020 2020 3c2f 7061 7261 3e0a ;. . │ │ │ -001ddf80: 2020 2020 3c2f 6578 616d 706c 653e 0a20 . │ │ │ -001ddf90: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001ddfa0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ -001ddfb0: 616c 736f 5f78 7465 5f6e 6f64 6562 6c64 also_xte_nodebld │ │ │ -001ddfc0: 5f61 6363 223e 3c74 6974 6c65 3e53 6565 _acc">See │ │ │ -001ddfd0: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -001ddfe0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xte_head(). │ │ │ -001de020: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xte_node(). │ │ │ -001de060: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b x │ │ │ -001de090: 7465 5f6e 6f64 655f 6672 6f6d 5f6e 6f64 te_node_from_nod │ │ │ -001de0a0: 6562 6c64 2829 3c2f 6c69 6e6b 3e3c 2f70 ebld()

    . < │ │ │ -001de0c0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001de0d0: 5f78 7465 5f6e 6f64 6562 6c64 5f66 696e _xte_nodebld_fin │ │ │ -001de0e0: 616c 223e 7874 655f 6e6f 6465 626c 645f al">xte_nodebld_ │ │ │ -001de0f0: 6669 6e61 6c28 293c 2f6c 696e 6b3e 3c2f final(). │ │ │ -001de110: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xte_nodebld_ │ │ │ -001de140: 696e 6974 2829 3c2f 6c69 6e6b 3e3c 2f70 init()

    .
    ... │ │ │ -001de170: 0ab6 0000 002d 6465 6d6f 2f64 6f63 7372 .....-demo/docsr │ │ │ -001de180: 632f 6675 6e63 7265 662f 7874 655f 6e6f c/funcref/xte_no │ │ │ -001de190: 6465 5f66 726f 6d5f 6e6f 6465 626c 642e de_from_nodebld. │ │ │ -001de1a0: 786d 6cdf 0000 121a 3c3f 786d 6c20 7665 xml........ │ │ │ -001de560: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -001de570: 7265 6665 6e74 7279 7469 746c 653e 7874 refentrytitle>xt │ │ │ -001de580: 655f 6e6f 6465 5f66 726f 6d5f 6e6f 6465 e_node_from_node │ │ │ -001de590: 626c 643c 2f72 6566 656e 7472 7974 6974 bld. xml. . . │ │ │ -001de5f0: 7874 655f 6e6f 6465 5f66 726f 6d5f 6e6f xte_node_from_no │ │ │ -001de600: 6465 626c 643c 2f72 6566 6e61 6d65 3e0a debld. │ │ │ -001de610: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -001de620: 5265 7475 726e 7320 7468 6520 7665 6374 Returns the vect │ │ │ -001de630: 6f72 2063 6f72 7265 7370 6f6e 6469 6e67 or corresponding │ │ │ -001de640: 2074 6f20 6120 584d 4c20 656c 656d 656e to a XML elemen │ │ │ -001de650: 7420 3c2f 7265 6670 7572 706f 7365 3e0a t . │ │ │ -001de660: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -001de670: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ -001de6f0: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ -001de700: 6675 6e63 7469 6f6e 3e78 7465 5f6e 6f64 function>xte_nod │ │ │ -001de710: 655f 6672 6f6d 5f6e 6f64 6562 6c64 3c2f e_from_nodebld. in head any. inout element any. │ │ │ -001de7c0: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -001de7d0: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . Desc │ │ │ -001de830: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -001de840: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ -001de850: 756e 6374 696f 6e20 7265 706c 6163 6573 unction replaces │ │ │ -001de860: 2074 6865 2066 6972 7374 2069 7465 6d20 the first item │ │ │ -001de870: 6f66 2074 6865 2073 6563 6f6e 6420 6172 of the second ar │ │ │ -001de880: 6775 6d65 6e74 2062 7920 7468 6520 6669 gument by the fi │ │ │ -001de890: 7273 7420 6172 6775 6d65 6e74 2061 6e64 rst argument and │ │ │ -001de8a0: 2072 6574 7572 6e73 0a20 2020 2061 2076 returns. a v │ │ │ -001de8b0: 6563 746f 7220 636f 7272 6573 706f 6e64 ector correspond │ │ │ -001de8c0: 696e 6720 746f 2061 6e20 584d 4c20 656c ing to an XML el │ │ │ -001de8d0: 656d 656e 742e 0a20 2020 203c 2f70 6172 ement.. . │ │ │ -001de8f0: 0a20 203c 7265 6673 6563 7431 2069 643d . P │ │ │ -001de920: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ -001de940: 3c74 6974 6c65 3e68 6561 643c 2f74 6974 head</tit │ │ │ -001de950: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -001de960: 5468 6973 2061 7267 756d 656e 7420 6973 This argument is │ │ │ -001de970: 2061 2076 6563 746f 7220 7265 7475 726e a vector return │ │ │ -001de980: 6564 2062 7920 7874 655f 6865 6164 2829 ed by xte_head() │ │ │ -001de990: 2066 756e 6374 696f 6e3c 2f70 6172 613e function</para> │ │ │ -001de9a0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 </refsect2>. │ │ │ -001de9b0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 <refsect2><title │ │ │ -001de9c0: 3e65 6c65 6d65 6e74 3c2f 7469 746c 653e >element │ │ │ -001de9d0: 0a20 2020 2020 203c 7061 7261 3e54 6869 . Thi │ │ │ -001de9e0: 7320 6172 6775 6d65 6e74 2069 7320 6120 s argument is a │ │ │ -001de9f0: 7665 6374 6f72 2063 7265 6174 6564 2062 vector created b │ │ │ -001dea00: 7920 7874 655f 6e6f 6465 626c 6420 5f69 y xte_nodebld _i │ │ │ -001dea10: 6e74 2829 2066 756e 6374 696f 6e20 616e nt() function an │ │ │ -001dea20: 6420 7468 656e 2066 696c 6c65 6420 6279 d then filled by │ │ │ -001dea30: 2078 7465 5f6e 6f64 6562 6c64 5f61 6363 xte_nodebld_acc │ │ │ -001dea40: 200a 2020 2020 2020 616e 6420 7874 655f . and xte_ │ │ │ -001dea50: 6e6f 6465 626c 645f 6669 6e61 6c28 2920 nodebld_final() │ │ │ -001dea60: 6675 6e63 7469 6f6e 733c 2f70 6172 613e functions │ │ │ -001dea70: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ -001dea80: 0a20 203c 2f72 6566 7365 6374 313e 0a0a . .. │ │ │ -001dea90: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ -001deac0: 2020 203c 7469 746c 653e 4572 726f 7273 Errors │ │ │ -001dead0: 3c2f 7469 746c 653e 0a20 2020 203c 7461 . Error │ │ │ -001deaf0: 7320 7369 676e 616c 6c65 6420 6279 203c s signalled by < │ │ │ -001deb00: 6675 6e63 7469 6f6e 3e78 7465 5f6e 6f64 function>xte_nod │ │ │ -001deb10: 655f 6672 6f6d 5f6e 6f64 6562 6c64 3c2f e_from_nodebld</ │ │ │ -001deb20: 6675 6e63 7469 6f6e 3e3c 2f74 6974 6c65 function>. .... .. │ │ │ -001deb60: 203c 656e 7472 793e 5351 4c53 7461 7465 SQLState │ │ │ -001deb70: 3c2f 656e 7472 793e 3c65 6e74 7279 3e45 E │ │ │ -001deb80: 7272 6f72 2043 6f64 653c 2f65 6e74 7279 rror CodeError Te │ │ │ -001deba0: 7874 3c2f 656e 7472 793e 3c65 6e74 7279 xtDescription.. .. │ │ │ -001debd0: 3c2f 7468 6561 643e 0a09 3c74 626f 6479 .... .. │ │ │ -001debf0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 22003.. │ │ │ -001dec20: 203c 656e 7472 793e 3c65 7272 6f72 636f SR349.. │ │ │ -001dec50: 2020 3c65 6e74 7279 3e3c 6572 726f 726e Too few argu │ │ │ -001dec70: 6d65 6e74 7320 666f 7220 7874 655f 6e6f ments for xte_no │ │ │ -001dec80: 6465 5f66 726f 6d5f 6e6f 6465 626c 643c de_from_nodebld< │ │ │ -001dec90: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname>.. │ │ │ -001decb0: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f .. .. .. │ │ │ -001decd0: 203c 656e 7472 793e 3c65 7272 6f72 636f 22003.. │ │ │ -001ded00: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 SR350.. │ │ │ -001ded30: 2020 203c 656e 7472 793e 3c65 7272 6f72 The second │ │ │ -001ded50: 6172 6775 6d65 6e74 206f 6620 7874 655f argument of xte_ │ │ │ -001ded60: 6e6f 6465 5f66 726f 6d5f 6e6f 6465 626c node_from_nodebl │ │ │ -001ded70: 6420 6973 206e 6f74 206d 6164 6520 6279 d is not made by │ │ │ -001ded80: 2078 7465 5f6e 6f64 6562 6c64 5f69 6e69 xte_nodebld_ini │ │ │ -001ded90: 7428 2920 6675 6e63 7469 6f6e 3c2f 6572 t() function │ │ │ -001dedb0: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ -001dedd0: 093c 2f74 626f 6479 3e0a 2020 2020 2020 .. │ │ │ -001dede0: 3c2f 7467 726f 7570 3e0a 2020 2020 3c2f . . . Examples. < │ │ │ -001dee70: 7469 746c 653e 5369 6d70 6c65 2055 7365 title>Simple Use │ │ │ -001dee80: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -001dee90: 7061 7261 3e54 6865 2076 6563 746f 7220 para>The vector │ │ │ -001deea0: 7265 7320 2062 656c 6f77 2069 7320 636f res below is co │ │ │ -001deeb0: 7272 6573 706f 6e64 696e 6720 746f 2074 rresponding to t │ │ │ -001deec0: 6865 2066 6f6c 6c6f 7769 6e67 2058 4d4c he following XML │ │ │ -001deed0: 2065 6c65 6d65 6e74 3a20 203c 2f70 6172 element: . & │ │ │ -001deef0: 6c74 3b70 726f 6475 6374 2667 743b 266c lt;product>&l │ │ │ -001def00: 743b 7375 7070 6c69 6572 2043 6f6d 7061 t;supplier Compa │ │ │ -001def10: 6e79 4e61 6d65 3d22 5365 6c6c 6572 2226 nyName="Seller"& │ │ │ -001def20: 6774 3b26 6c74 3b2f 7375 7070 6c69 6572 gt;</supplier │ │ │ -001def30: 2667 743b 266c 743b 2f70 726f 6475 6374 ></product │ │ │ -001def40: 2667 743b 3c2f 7061 7261 3e0a 2020 2020 >. │ │ │ -001def50: 2020 3c73 6372 6565 6e3e 6372 6561 7465 create │ │ │ -001def60: 2070 726f 6365 6475 7265 2074 6573 745f procedure test_ │ │ │ -001def70: 6e6f 6465 626c 6428 290a 2020 2020 2020 nodebld(). │ │ │ -001def80: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ -001def90: 2020 2020 2020 2020 2020 6465 636c 6172 declar │ │ │ -001defa0: 6520 6163 6320 616e 793b 0a09 0964 6563 e acc any;...dec │ │ │ -001defb0: 6c61 7265 2072 6573 2061 6e79 3b0a 2020 lare res any;. │ │ │ -001defc0: 2020 2020 2020 2020 2020 2020 2020 7874 xt │ │ │ -001defd0: 655f 6e6f 6465 626c 645f 696e 6974 2028 e_nodebld_init ( │ │ │ -001defe0: 6163 6329 3b0a 2020 2020 2020 2020 2020 acc);. │ │ │ -001deff0: 2020 2020 2020 7874 655f 6e6f 6465 626c xte_nodebl │ │ │ -001df000: 645f 6163 6328 6163 632c 7874 655f 6e6f d_acc(acc,xte_no │ │ │ -001df010: 6465 2878 7465 5f68 6561 6420 2827 7375 de(xte_head ('su │ │ │ -001df020: 7070 6c69 6572 272c 2027 436f 6d70 616e pplier', 'Compan │ │ │ -001df030: 794e 616d 6527 2c27 5365 6c6c 6572 2729 yName','Seller') │ │ │ -001df040: 2929 3b0a 0909 6163 633a 3d78 7465 5f6e ));...acc:=xte_n │ │ │ -001df050: 6f64 6562 6c64 5f66 696e 616c 2861 6363 odebld_final(acc │ │ │ -001df060: 293b 0a20 2020 2020 2020 2020 2020 2020 );. │ │ │ -001df070: 2020 2072 6573 3a3d 7874 655f 6e6f 6465 res:=xte_node │ │ │ -001df080: 5f66 726f 6d5f 6e6f 6465 626c 6428 7874 _from_nodebld(xt │ │ │ -001df090: 655f 6865 6164 2827 7072 6f64 7563 7427 e_head('product' │ │ │ -001df0a0: 292c 2061 6363 293b 0a09 0972 6573 756c ), acc);...resul │ │ │ -001df0b0: 7420 286c 656e 6774 6828 7265 7329 2c20 t (length(res), │ │ │ -001df0c0: 786d 6c5f 7472 6565 5f64 6f63 2028 7265 xml_tree_doc (re │ │ │ -001df0d0: 7329 293b 0a09 2020 2020 2020 7d3b 0a74 s));.. };.t │ │ │ -001df0e0: 6573 745f 6e6f 6465 626c 6428 290a 5265 est_nodebld().Re │ │ │ -001df0f0: 734c 656e 2020 2020 2020 5265 730a 494e sLen Res.IN │ │ │ -001df100: 5445 4745 5220 2020 2020 5641 5243 4841 TEGER VARCHA │ │ │ -001df110: 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f R.______________ │ │ │ -001df120: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001df130: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001df140: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001df150: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001df160: 5f0a 200a 3220 2020 2020 2020 2020 2020 _. .2 │ │ │ -001df170: 266c 743b 7072 6f64 7563 7426 6774 3b26 <product>& │ │ │ -001df180: 6c74 3b73 7570 706c 6965 7220 436f 6d70 lt;supplier Comp │ │ │ -001df190: 616e 794e 616d 653d 2253 656c 6c65 7222 anyName="Seller" │ │ │ -001df1a0: 202f 2667 743b 266c 743b 2f70 726f 6475 /></produ │ │ │ -001df1b0: 6374 2667 743b 2020 2020 2020 2020 2009 ct> . │ │ │ -001df1c0: 2020 2020 2020 0a20 2020 2020 203c 2f73 . . . . See Al │ │ │ -001df230: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ -001df240: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xte_head().

    │ │ │ -001df2a0: 7874 655f 6e6f 6465 2829 3c2f 6c69 6e6b xte_node(). xte_nodebl │ │ │ -001df2f0: 645f 6163 6328 293c 2f6c 696e 6b3e 3c2f d_acc(). │ │ │ -001df310: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xte_nodebld │ │ │ -001df340: 5f66 696e 616c 2829 3c2f 6c69 6e6b 3e3c _final()< │ │ │ -001df350: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xte_nodebld │ │ │ -001df390: 5f69 6e69 7428 293c 2f6c 696e 6b3e 3c2f _init(). .. │ │ │ -001df3c0: 0a0a b600 0000 2064 656d 6f2f 646f 6373 ...... demo/docs │ │ │ -001df3d0: 7263 2f66 756e 6372 6566 2f78 7465 5f6e rc/funcref/xte_n │ │ │ -001df3e0: 6f64 652e 786d 6cdf 0000 0ee3 3c3f 786d ode.xml........ . xte_node. │ │ │ -001df7d0: 2020 3c72 6566 6d69 7363 696e 666f 3e78 x │ │ │ -001df7e0: 6d6c 3c2f 7265 666d 6973 6369 6e66 6f3e ml │ │ │ -001df7f0: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ -001df800: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ -001df810: 203c 7265 666e 616d 653e 7874 655f 6e6f xte_no │ │ │ -001df820: 6465 3c2f 7265 666e 616d 653e 0a20 2020 de. │ │ │ -001df830: 203c 7265 6670 7572 706f 7365 3e52 6574 Ret │ │ │ -001df840: 7572 6e73 2074 6865 2076 6563 746f 7220 urns the vector │ │ │ -001df850: 636f 7272 6573 706f 6e64 696e 6720 746f corresponding to │ │ │ -001df860: 2061 2058 4d4c 2065 6c65 6d65 6e74 203c a XML element < │ │ │ -001df870: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -001df880: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -001df890: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -001df8a0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . │ │ │ -001df8f0: 0a20 2020 2020 2020 203c 6675 6e63 6465 . xte_ │ │ │ -001df910: 6e6f 6465 3c2f 6675 6e63 7469 6f6e 3e3c node< │ │ │ -001df920: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -001df930: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -001df940: 7061 7261 6d65 7465 723e 6865 6164 3c2f parameter>head any. │ │ │ -001df970: 2020 3c70 6172 616d 6465 663e 3c6f 7074 in arg1 any. │ │ │ -001df9c0: 2020 2020 2020 203c 7061 7261 6d64 6566 ...< │ │ │ -001df9e0: 2f70 6172 616d 6574 6572 3e20 3c2f 7061 /parameter> . │ │ │ -001dfa00: 3c70 6172 616d 6465 663e 3c6f 7074 696f in argN any. │ │ │ -001dfa50: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . Description. │ │ │ -001dfad0: 5468 6973 2066 756e 6374 696f 6e20 7265 This function re │ │ │ -001dfae0: 7475 726e 7320 7468 6520 7665 6374 6f72 turns the vector │ │ │ -001dfaf0: 2077 6869 6368 2063 6f72 7265 7370 6f6e which correspon │ │ │ -001dfb00: 6473 2074 6f20 6120 584d 4c20 656c 656d ds to a XML elem │ │ │ -001dfb10: 656e 742e 2054 6865 2066 6972 7374 0a20 ent. The first. │ │ │ -001dfb20: 2020 2070 6172 616d 6574 6572 2069 7320 parameter is │ │ │ -001dfb30: 6120 6865 6164 206f 6620 7468 6520 656c a head of the el │ │ │ -001dfb40: 656d 656e 742e 2054 6865 2072 656d 6169 ement. The remai │ │ │ -001dfb50: 6e69 6e67 2070 6172 616d 6574 6572 7320 ning parameters │ │ │ -001dfb60: 6172 6520 6f70 7469 6f6e 616c 2e20 0a20 are optional. . │ │ │ -001dfb70: 2020 2045 6163 6820 6f70 7469 6f6e 616c Each optional │ │ │ -001dfb80: 2070 6172 616d 6574 6572 2065 6974 6865 parameter eithe │ │ │ -001dfb90: 7220 6973 2061 2058 4d4c 2065 6c65 6d65 r is a XML eleme │ │ │ -001dfba0: 6e74 206f 7220 6120 7374 7269 6e67 2e20 nt or a string. │ │ │ -001dfbb0: 5477 6f20 6f72 206d 6f72 6520 7375 6363 Two or more succ │ │ │ -001dfbc0: 6573 7369 7665 2073 7472 696e 6773 2061 essive strings a │ │ │ -001dfbd0: 7265 200a 2020 2020 636f 6e63 6174 656e re . concaten │ │ │ -001dfbe0: 6174 6564 2e0a 2020 2020 3c2f 7061 7261 ated.. . . │ │ │ -001dfc00: 2020 3c72 6566 7365 6374 3120 6964 3d22 Parameters</tit │ │ │ -001dfc30: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -001dfc40: 323e 3c74 6974 6c65 3e61 7267 493c 2f74 2><title>argI</t │ │ │ -001dfc50: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001dfc60: 613e 4120 584d 4c20 656c 656d 656e 7420 a>A XML element │ │ │ -001dfc70: 206f 7220 6120 7374 7269 6e67 3c2f 7061 or a string</pa │ │ │ -001dfc80: 7261 3e3c 2f72 6566 7365 6374 323e 0a20 ra></refsect2>. │ │ │ -001dfc90: 203c 2f72 6566 7365 6374 313e 0a0a 2020 </refsect1>.. │ │ │ -001dfca0: 3c72 6566 7365 6374 3120 6964 3d22 6572 <refsect1 id="er │ │ │ -001dfcb0: 726f 7273 5f78 7465 5f6e 6f64 6522 3e0a rors_xte_node">. │ │ │ -001dfcc0: 2020 2020 3c74 6974 6c65 3e45 7272 6f72 <title>Error │ │ │ -001dfcd0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c74 s. Erro │ │ │ -001dfcf0: 7273 2073 6967 6e61 6c6c 6564 2062 7920 rs signalled by │ │ │ -001dfd00: 3c66 756e 6374 696f 6e3e 7874 655f 6e6f <function>xte_no │ │ │ -001dfd10: 6465 3c2f 6675 6e63 7469 6f6e 3e3c 2f74 de</function></t │ │ │ -001dfd20: 6974 6c65 3e0a 2020 2020 2020 3c74 6772 itle>. <tgr │ │ │ -001dfd30: 6f75 7020 636f 6c73 3d22 3422 3e0a 093c oup cols="4">..< │ │ │ -001dfd40: 7468 6561 643e 0a09 2020 3c72 6f77 3e0a thead>.. <row>. │ │ │ -001dfd50: 0920 2020 203c 656e 7472 793e 5351 4c53 . <entry>SQLS │ │ │ -001dfd60: 7461 7465 3c2f 656e 7472 793e 3c65 6e74 tate</entry><ent │ │ │ -001dfd70: 7279 3e45 7272 6f72 2043 6f64 653c 2f65 ry>Error Code</e │ │ │ -001dfd80: 6e74 7279 3e3c 656e 7472 793e 4572 726f ntry><entry>Erro │ │ │ -001dfd90: 7220 5465 7874 3c2f 656e 7472 793e 3c65 r Text</entry><e │ │ │ -001dfda0: 6e74 7279 3e44 6573 6372 6970 7469 6f6e ntry>Description │ │ │ -001dfdb0: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f </entry>.. </ro │ │ │ -001dfdc0: 773e 0a09 3c2f 7468 6561 643e 0a09 3c74 w>..</thead>..<t │ │ │ -001dfdd0: 626f 6479 3e0a 0920 203c 726f 773e 0a09 body>.. <row>.. │ │ │ -001dfde0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ -001dfdf0: 7263 6f64 653e 3432 3030 303c 2f65 7272 rcode>42000</err │ │ │ -001dfe00: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ -001dfe10: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ -001dfe20: 6f72 636f 6465 3e58 5445 3032 3c2f 6572 orcode>XTE02</er │ │ │ -001dfe30: 726f 7263 6f64 653e 3c2f 656e 7472 793e rorcode></entry> │ │ │ -001dfe40: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -001dfe50: 726f 726e 616d 653e 4675 6e63 7469 6f6e rorname>Function │ │ │ -001dfe60: 203c 6675 6e63 7469 6f6e 3e78 7465 5f6e <function>xte_n │ │ │ -001dfe70: 6f64 653c 2f66 756e 6374 696f 6e3e 2073 ode</function> s │ │ │ -001dfe80: 686f 756c 6420 6861 7665 2061 7420 6c65 hould have at le │ │ │ -001dfe90: 6173 7420 6f6e 6520 7061 7261 6d65 7465 ast one paramete │ │ │ -001dfea0: 723c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 r</errorname></e │ │ │ -001dfeb0: 6e74 7279 3e0a 0920 2020 203c 656e 7472 ntry>.. <entr │ │ │ -001dfec0: 793e 3c2f 656e 7472 793e 0a09 2020 3c2f y></entry>.. </ │ │ │ -001dfed0: 726f 773e 0a09 3c2f 7462 6f64 793e 0a20 row>..</tbody>. │ │ │ -001dfee0: 2020 2020 203c 2f74 6772 6f75 703e 0a20 </tgroup>. │ │ │ -001dfef0: 2020 203c 2f74 6162 6c65 3e0a 2020 3c2f </table>. </ │ │ │ -001dff00: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -001dff10: 7365 6374 3120 6964 3d22 7874 655f 6e6f sect1 id="xte_no │ │ │ -001dff20: 6465 223e 3c74 6974 6c65 3e45 7861 6d70 de"><title>Examp │ │ │ -001dff30: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ -001dff40: 3c65 7861 6d70 6c65 2069 643d 2265 785f Simple Use</tit │ │ │ -001dff70: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -001dff80: 5468 6520 7874 655f 6e6f 6465 2829 2063 The xte_node() c │ │ │ -001dff90: 616c 6c20 3c2f 7061 7261 3e20 0a20 2020 all </para> . │ │ │ -001dffa0: 2020 203c 7363 7265 656e 3e78 7465 5f6e <screen>xte_n │ │ │ -001dffb0: 6f64 6528 7874 655f 6865 6164 2028 2773 ode(xte_head ('s │ │ │ -001dffc0: 7570 706c 6965 7227 2c20 2743 6f6d 7061 upplier', 'Compa │ │ │ -001dffd0: 6e79 4e61 6d65 272c 2027 5365 6c6c 6572 nyName', 'Seller │ │ │ -001dffe0: 2729 2c20 2774 6869 7320 7374 7269 6e67 '), 'this string │ │ │ -001dfff0: 2077 696c 6c20 6265 2027 2c20 2763 6f6e will be ', 'con │ │ │ -001e0000: 6361 7465 6e61 7465 6420 7769 7468 2069 catenated with i │ │ │ -001e0010: 7427 293c 2f73 6372 6565 6e3e 0a20 2020 t')</screen>. │ │ │ -001e0020: 2020 203c 7061 7261 3e70 726f 6475 6365 <para>produce │ │ │ -001e0030: 7320 6120 7665 6374 6f72 2063 6f72 7265 s a vector corre │ │ │ -001e0040: 7370 6f6e 6469 6e67 2074 6865 2066 6f6c sponding the fol │ │ │ -001e0050: 6c6f 7769 6e67 2058 4d4c 2065 6c65 6d65 lowing XML eleme │ │ │ -001e0060: 6e74 3a20 3c2f 7061 7261 3e0a 2020 2020 nt: </para>. │ │ │ -001e0070: 2020 3c70 6172 613e 2026 6c74 3b73 7570 <para> <sup │ │ │ -001e0080: 706c 6965 7220 2043 6f6d 7061 6e79 4e61 plier CompanyNa │ │ │ -001e0090: 6d65 3d22 5365 6c6c 6572 2226 6774 3b74 me="Seller">t │ │ │ -001e00a0: 6869 7320 7374 7269 6e67 2077 696c 6c20 his string will │ │ │ -001e00b0: 6265 2063 6f6e 6361 7465 6e61 7465 6420 be concatenated │ │ │ -001e00c0: 7769 7468 2069 7420 266c 743b 2f73 7570 with it </sup │ │ │ -001e00d0: 706c 6965 7226 6774 3b3c 2f70 6172 613e plier></para> │ │ │ -001e00e0: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . </example>. │ │ │ -001e00f0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -001e0100: 3c72 6566 7365 6374 3120 6964 3d22 7365 <refsect1 id="se │ │ │ -001e0110: 6561 6c73 6f5f 7874 655f 6e6f 6465 223e ealso_xte_node"> │ │ │ -001e0120: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c <title>See Also< │ │ │ -001e0130: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -001e0140: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ -001e0150: 2266 6e5f 7874 655f 6865 6164 223e 7874 "fn_xte_head">xt │ │ │ -001e0160: 655f 6865 6164 3c2f 6c69 6e6b 3e3c 2f70 e_head</link></p │ │ │ -001e0170: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ -001e0180: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001e0190: 5f78 7465 5f6e 6f64 655f 6672 6f6d 5f6e _xte_node_from_n │ │ │ -001e01a0: 6f64 6562 6c64 223e 7874 655f 6e6f 6465 odebld">xte_node │ │ │ -001e01b0: 5f66 726f 6d5f 6e6f 6465 626c 643c 2f6c _from_nodebld</l │ │ │ -001e01c0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ -001e01d0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ -001e01e0: 656e 643d 2266 6e5f 7874 655f 6e6f 6465 end="fn_xte_node │ │ │ -001e01f0: 626c 645f 6163 6322 3e78 7465 5f6e 6f64 bld_acc">xte_nod │ │ │ -001e0200: 6562 6c64 5f61 6363 3c2f 6c69 6e6b 3e3c ebld_acc</link>< │ │ │ -001e0210: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ -001e0220: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ -001e0230: 666e 5f78 7465 5f6e 6f64 6562 6c64 5f66 fn_xte_nodebld_f │ │ │ -001e0240: 696e 616c 223e 7874 655f 6e6f 6465 626c inal">xte_nodebl │ │ │ -001e0250: 645f 6669 6e61 6c3c 2f6c 696e 6b3e 3c2f d_final</link></ │ │ │ -001e0260: 7061 7261 3e0a 2020 2020 3c70 6172 613e para>. <para> │ │ │ -001e0270: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ -001e0280: 6e5f 7874 655f 6e6f 6465 626c 645f 696e n_xte_nodebld_in │ │ │ -001e0290: 6974 223e 7874 655f 6e6f 6465 626c 645f it">xte_nodebld_ │ │ │ -001e02a0: 696e 6974 3c2f 6c69 6e6b 3e3c 2f70 6172 init</link></par │ │ │ -001e02b0: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ -001e02c0: 0a0a 3c2f 7265 6665 6e74 7279 3e0a 0ab6 ..</refentry>... │ │ │ -001e02d0: 0000 0020 6465 6d6f 2f64 6f63 7372 632f ... demo/docsrc/ │ │ │ -001e02e0: 6675 6e63 7265 662f 7874 655f 6865 6164 funcref/xte_head │ │ │ -001e02f0: 2e78 6d6c df00 0010 ea3c 3f78 6d6c 2076 .xml.....<?xml v │ │ │ -001e0300: 6572 7369 6f6e 3d22 312e 3022 2065 6e63 ersion="1.0" enc │ │ │ -001e0310: 6f64 696e 673d 2249 534f 2d38 3835 392d oding="ISO-8859- │ │ │ -001e0320: 3122 3f3e 0a3c 212d 2d20 0a20 2d20 200a 1"?>.<!-- . - . │ │ │ -001e0330: 202d 2020 5468 6973 2066 696c 6520 6973 - This file is │ │ │ -001e0340: 2070 6172 7420 6f66 2074 6865 204f 7065 part of the Ope │ │ │ -001e0350: 6e4c 696e 6b20 536f 6674 7761 7265 2056 nLink Software V │ │ │ -001e0360: 6972 7475 6f73 6f20 4f70 656e 2d53 6f75 irtuoso Open-Sou │ │ │ -001e0370: 7263 6520 2856 4f53 290a 202d 2020 7072 rce (VOS). - pr │ │ │ -001e0380: 6f6a 6563 742e 0a20 2d20 200a 202d 2020 oject.. - . - │ │ │ -001e0390: 436f 7079 7269 6768 7420 2843 2920 3139 Copyright (C) 19 │ │ │ -001e03a0: 3938 2d32 3032 3420 4f70 656e 4c69 6e6b 98-2024 OpenLink │ │ │ -001e03b0: 2053 6f66 7477 6172 650a 202d 2020 0a20 Software. - . │ │ │ -001e03c0: 2d20 2054 6869 7320 7072 6f6a 6563 7420 - This project │ │ │ -001e03d0: 6973 2066 7265 6520 736f 6674 7761 7265 is free software │ │ │ -001e03e0: 3b20 796f 7520 6361 6e20 7265 6469 7374 ; you can redist │ │ │ -001e03f0: 7269 6275 7465 2069 7420 616e 642f 6f72 ribute it and/or │ │ │ -001e0400: 206d 6f64 6966 7920 6974 0a20 2d20 2075 modify it. - u │ │ │ -001e0410: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ -001e0420: 6620 7468 6520 474e 5520 4765 6e65 7261 f the GNU Genera │ │ │ -001e0430: 6c20 5075 626c 6963 204c 6963 656e 7365 l Public License │ │ │ -001e0440: 2061 7320 7075 626c 6973 6865 6420 6279 as published by │ │ │ -001e0450: 2074 6865 0a20 2d20 2046 7265 6520 536f the. - Free So │ │ │ -001e0460: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ -001e0470: 6e3b 206f 6e6c 7920 7665 7273 696f 6e20 n; only version │ │ │ -001e0480: 3220 6f66 2074 6865 204c 6963 656e 7365 2 of the License │ │ │ -001e0490: 2c20 6461 7465 6420 4a75 6e65 2031 3939 , dated June 199 │ │ │ -001e04a0: 312e 0a20 2d20 200a 202d 2020 5468 6973 1.. - . - This │ │ │ -001e04b0: 2070 726f 6772 616d 2069 7320 6469 7374 program is dist │ │ │ -001e04c0: 7269 6275 7465 6420 696e 2074 6865 2068 ributed in the h │ │ │ -001e04d0: 6f70 6520 7468 6174 2069 7420 7769 6c6c ope that it will │ │ │ -001e04e0: 2062 6520 7573 6566 756c 2c20 6275 740a be useful, but. │ │ │ -001e04f0: 202d 2020 5749 5448 4f55 5420 414e 5920 - WITHOUT ANY │ │ │ -001e0500: 5741 5252 414e 5459 3b20 7769 7468 6f75 WARRANTY; withou │ │ │ -001e0510: 7420 6576 656e 2074 6865 2069 6d70 6c69 t even the impli │ │ │ -001e0520: 6564 2077 6172 7261 6e74 7920 6f66 0a20 ed warranty of. │ │ │ -001e0530: 2d20 204d 4552 4348 414e 5441 4249 4c49 - MERCHANTABILI │ │ │ -001e0540: 5459 206f 7220 4649 544e 4553 5320 464f TY or FITNESS FO │ │ │ -001e0550: 5220 4120 5041 5254 4943 554c 4152 2050 R A PARTICULAR P │ │ │ -001e0560: 5552 504f 5345 2e20 5365 6520 7468 6520 URPOSE. See the │ │ │ -001e0570: 474e 550a 202d 2020 4765 6e65 7261 6c20 GNU. - General │ │ │ -001e0580: 5075 626c 6963 204c 6963 656e 7365 2066 Public License f │ │ │ -001e0590: 6f72 206d 6f72 6520 6465 7461 696c 732e or more details. │ │ │ -001e05a0: 0a20 2d20 200a 202d 2020 596f 7520 7368 . - . - You sh │ │ │ -001e05b0: 6f75 6c64 2068 6176 6520 7265 6365 6976 ould have receiv │ │ │ -001e05c0: 6564 2061 2063 6f70 7920 6f66 2074 6865 ed a copy of the │ │ │ -001e05d0: 2047 4e55 2047 656e 6572 616c 2050 7562 GNU General Pub │ │ │ -001e05e0: 6c69 6320 4c69 6365 6e73 6520 616c 6f6e lic License alon │ │ │ -001e05f0: 670a 202d 2020 7769 7468 2074 6869 7320 g. - with this │ │ │ -001e0600: 7072 6f67 7261 6d3b 2069 6620 6e6f 742c program; if not, │ │ │ -001e0610: 2077 7269 7465 2074 6f20 7468 6520 4672 write to the Fr │ │ │ -001e0620: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ -001e0630: 6461 7469 6f6e 2c20 496e 632e 2c0a 202d dation, Inc.,. - │ │ │ -001e0640: 2020 3531 2046 7261 6e6b 6c69 6e20 5374 51 Franklin St │ │ │ -001e0650: 2c20 4669 6674 6820 466c 6f6f 722c 2042 , Fifth Floor, B │ │ │ -001e0660: 6f73 746f 6e2c 204d 4120 3032 3131 302d oston, MA 02110- │ │ │ -001e0670: 3133 3031 2055 5341 0a20 2d20 200a 202d 1301 USA. - . - │ │ │ -001e0680: 2020 0a2d 2d3e 0a3c 7265 6665 6e74 7279 .-->.<refentry │ │ │ -001e0690: 2069 643d 2266 6e5f 7874 655f 6865 6164 id="fn_xte_head │ │ │ -001e06a0: 223e 0a20 203c 7265 666d 6574 613e 0a20 ">. <refmeta>. │ │ │ -001e06b0: 2020 203c 7265 6665 6e74 7279 7469 746c <refentrytitl │ │ │ -001e06c0: 653e 7874 655f 6865 6164 3c2f 7265 6665 e>xte_head</refe │ │ │ -001e06d0: 6e74 7279 7469 746c 653e 0a20 2020 203c ntrytitle>. < │ │ │ -001e06e0: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ -001e06f0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001e0700: 3c2f 7265 666d 6574 613e 0a20 203c 7265 </refmeta>. <re │ │ │ -001e0710: 666e 616d 6564 6976 3e0a 2020 2020 3c72 fnamediv>. <r │ │ │ -001e0720: 6566 6e61 6d65 3e78 7465 5f68 6561 643c efname>xte_head< │ │ │ -001e0730: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. <r │ │ │ -001e0740: 6566 7075 7270 6f73 653e 5265 7475 726e efpurpose>Return │ │ │ -001e0750: 7320 7468 6520 7665 6374 6f72 2063 6f72 s the vector cor │ │ │ -001e0760: 7265 7370 6f6e 6469 6e67 2074 6f20 6120 responding to a │ │ │ -001e0770: 6865 6164 206f 6620 6120 584d 4c20 656c head of a XML el │ │ │ -001e0780: 656d 656e 7420 3c2f 7265 6670 7572 706f ement </refpurpo │ │ │ -001e0790: 7365 3e0a 2020 3c2f 7265 666e 616d 6564 se>. </refnamed │ │ │ -001e07a0: 6976 3e0a 2020 3c72 6566 7379 6e6f 7073 iv>. <refsynops │ │ │ -001e07b0: 6973 6469 763e 0a20 2020 203c 6675 6e63 isdiv>. <func │ │ │ -001e07c0: 7379 6e6f 7073 6973 2069 643d 2266 7379 synopsis id="fsy │ │ │ -001e07d0: 6e5f 7874 655f 6865 6164 223e 0a20 2020 n_xte_head">. │ │ │ -001e07e0: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ -001e07f0: 6520 6964 3d22 6670 726f 746f 5f78 7465 e id="fproto_xte │ │ │ -001e0800: 5f68 6561 6422 3e0a 2020 2020 2020 2020 _head">. │ │ │ -001e0810: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 <funcdef><functi │ │ │ -001e0820: 6f6e 3e78 7465 5f68 6561 643c 2f66 756e on>xte_head</fun │ │ │ -001e0830: 6374 696f 6e3e 3c2f 6675 6e63 6465 663e ction></funcdef> │ │ │ -001e0840: 0a20 2020 2020 2020 203c 7061 7261 6d64 . <paramd │ │ │ -001e0850: 6566 3e69 6e20 3c70 6172 616d 6574 6572 ef>in <parameter │ │ │ -001e0860: 3e74 6167 6e61 6d65 3c2f 7061 7261 6d65 >tagname</parame │ │ │ -001e0870: 7465 723e 2076 6172 6368 6172 3c2f 7061 ter> varchar</pa │ │ │ -001e0880: 7261 6d64 6566 3e0a 2020 2020 2020 2020 ramdef>. │ │ │ -001e0890: 3c70 6172 616d 6465 663e 3c6f 7074 696f <paramdef><optio │ │ │ -001e08a0: 6e61 6c3e 696e 203c 7061 7261 6d65 7465 nal>in <paramete │ │ │ -001e08b0: 723e 6174 7472 316e 616d 653c 2f70 6172 r>attr1name</par │ │ │ -001e08c0: 616d 6574 6572 3e20 7661 7263 6861 723c ameter> varchar< │ │ │ -001e08d0: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional></para │ │ │ -001e08e0: 6d64 6566 3e0a 2020 2020 2020 2020 3c70 mdef>. <p │ │ │ -001e08f0: 6172 616d 6465 663e 3c6f 7074 696f 6e61 aramdef><optiona │ │ │ -001e0900: 6c3e 696e 203c 7061 7261 6d65 7465 723e l>in <parameter> │ │ │ -001e0910: 6174 7472 3176 616c 3c2f 7061 7261 6d65 attr1val</parame │ │ │ -001e0920: 7465 723e 2076 6172 6368 6172 3c2f 6f70 ter> varchar</op │ │ │ -001e0930: 7469 6f6e 616c 3e3c 2f70 6172 616d 6465 tional></paramde │ │ │ -001e0940: 663e 0a20 2020 2020 2020 203c 7061 7261 f>. <para │ │ │ -001e0950: 6d64 6566 3e3c 7061 7261 6d65 7465 723e mdef><parameter> │ │ │ -001e0960: 2e2e 2e3c 2f70 6172 616d 6574 6572 3e20 ...</parameter> │ │ │ -001e0970: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -001e0980: 2020 2020 3c70 6172 616d 6465 663e 3c6f <paramdef><o │ │ │ -001e0990: 7074 696f 6e61 6c3e 696e 203c 7061 7261 ptional>in <para │ │ │ -001e09a0: 6d65 7465 723e 6174 7472 4e6e 616d 653c meter>attrNname< │ │ │ -001e09b0: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ -001e09c0: 6861 723c 2f6f 7074 696f 6e61 6c3e 3c2f har</optional></ │ │ │ -001e09d0: 7061 7261 6d64 6566 3e0a 2020 2020 2020 paramdef>. │ │ │ -001e09e0: 2020 3c70 6172 616d 6465 663e 3c6f 7074 <paramdef><opt │ │ │ -001e09f0: 696f 6e61 6c3e 696e 203c 7061 7261 6d65 ional>in <parame │ │ │ -001e0a00: 7465 723e 6174 7472 4e76 616c 3c2f 7061 ter>attrNval</pa │ │ │ -001e0a10: 7261 6d65 7465 723e 2076 6172 6368 6172 rameter> varchar │ │ │ -001e0a20: 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 6172 </optional></par │ │ │ -001e0a30: 616d 6465 663e 0a20 2020 2020 203c 2f66 amdef>. </f │ │ │ -001e0a40: 756e 6370 726f 746f 7479 7065 3e0a 2020 uncprototype>. │ │ │ -001e0a50: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 </funcsynopsis │ │ │ -001e0a60: 3e0a 2020 3c2f 7265 6673 796e 6f70 7369 >. </refsynopsi │ │ │ -001e0a70: 7364 6976 3e0a 2020 3c72 6566 7365 6374 sdiv>. <refsect │ │ │ -001e0a80: 3120 6964 3d22 6465 7363 5f78 7465 5f68 1 id="desc_xte_h │ │ │ -001e0a90: 6561 6422 3e3c 7469 746c 653e 4465 7363 ead"><title>Desc │ │ │ -001e0aa0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -001e0ab0: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ -001e0ac0: 756e 6374 696f 6e20 7461 6b65 7320 6f64 unction takes od │ │ │ -001e0ad0: 6420 6e75 6d62 6572 206f 6620 7061 7261 d number of para │ │ │ -001e0ae0: 6d65 7465 7273 2061 6e64 2063 7265 6174 meters and creat │ │ │ -001e0af0: 6573 2076 6563 746f 7220 7768 6963 6820 es vector which │ │ │ -001e0b00: 0a20 2020 2063 6f72 7265 7370 6f6e 6473 . corresponds │ │ │ -001e0b10: 2074 6f20 6120 6865 6164 206f 6620 6120 to a head of a │ │ │ -001e0b20: 584d 4c20 656c 656d 656e 742e 2054 6865 XML element. The │ │ │ -001e0b30: 2066 6972 7374 2070 6172 616d 6574 6572 first parameter │ │ │ -001e0b40: 2069 7320 6120 7461 6720 6e61 6d65 206f is a tag name o │ │ │ -001e0b50: 6620 7468 6520 6865 6164 2e20 0a20 2020 f the head. . │ │ │ -001e0b60: 2054 6865 2072 656d 6169 6e69 6e67 2070 The remaining p │ │ │ -001e0b70: 6172 616d 6574 6572 7320 6172 6520 6f70 arameters are op │ │ │ -001e0b80: 7469 6f6e 616c 2e20 4561 6368 2065 7665 tional. Each eve │ │ │ -001e0b90: 6e20 7061 7261 6d65 7465 7220 6973 2061 n parameter is a │ │ │ -001e0ba0: 206e 616d 6520 6f66 2061 6e20 6174 7472 name of an attr │ │ │ -001e0bb0: 6962 7574 652c 200a 2020 2020 6561 6368 ibute, . each │ │ │ -001e0bc0: 206e 6578 7420 6f64 6420 7061 7261 6d65 next odd parame │ │ │ -001e0bd0: 7465 7220 6973 2061 2076 616c 7565 206f ter is a value o │ │ │ -001e0be0: 6620 7468 6973 2061 7474 7269 6275 7465 f this attribute │ │ │ -001e0bf0: 2e20 4966 2074 776f 206f 7220 6d6f 7265 . If two or more │ │ │ -001e0c00: 2061 7474 7269 6275 7465 7320 6861 7665 attributes have │ │ │ -001e0c10: 2074 6865 200a 2020 2020 7361 6d65 206e the . same n │ │ │ -001e0c20: 616d 652c 2074 6865 2068 6561 6420 776f ame, the head wo │ │ │ -001e0c30: 756c 6420 6861 7665 206f 6e6c 7920 7468 uld have only th │ │ │ -001e0c40: 6520 6c61 7374 2070 6169 722e 0a20 2020 e last pair.. │ │ │ -001e0c50: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . . Paramete │ │ │ -001e0c90: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -001e0ca0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -001e0cb0: 7461 676e 616d 653c 2f74 6974 6c65 3e0a tagname. │ │ │ -001e0cc0: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -001e0cd0: 7461 6720 6e61 6d65 206f 6620 7468 6520 tag name of the │ │ │ -001e0ce0: 6865 6164 3c2f 7061 7261 3e3c 2f72 6566 head. attr │ │ │ -001e0d10: 496e 616d 653c 2f74 6974 6c65 3e0a 2020 Iname. │ │ │ -001e0d20: 2020 2020 3c70 6172 613e 2054 6865 206e The n │ │ │ -001e0d30: 616d 6520 6f66 2074 6865 2049 2d74 6820 ame of the I-th │ │ │ -001e0d40: 6174 7472 6962 7574 653c 2f70 6172 613e attribute │ │ │ -001e0d50: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -001e0d60: 3c72 6566 7365 6374 323e 3c74 6974 6c65 attrIval. T │ │ │ -001e0d90: 6865 2076 616c 7565 206f 6620 7468 6520 he value of the │ │ │ -001e0da0: 492d 7468 2061 7474 7269 6275 7465 3c2f I-th attribute │ │ │ -001e0dc0: 0a20 203c 2f72 6566 7365 6374 313e 0a0a . .. │ │ │ -001e0dd0: 2020 3c72 6566 7365 6374 3120 6964 3d22 . Err │ │ │ -001e0e00: 6f72 733c 2f74 6974 6c65 3e0a 2020 2020 ors. │ │ │ -001e0e10: 3c74 6162 6c65 3e3c 7469 746c 653e 4572

    Er │ │ │ -001e0e20: 726f 7273 2073 6967 6e61 6c6c 6564 2062 rors signalled b │ │ │ -001e0e30: 7920 3c66 756e 6374 696f 6e3e 7874 655f y <function>xte_ │ │ │ -001e0e40: 6865 6164 3c2f 6675 6e63 7469 6f6e 3e3c head</function>< │ │ │ -001e0e50: 2f74 6974 6c65 3e0a 2020 2020 2020 3c74 /title>. <t │ │ │ -001e0e60: 6772 6f75 7020 636f 6c73 3d22 3422 3e0a group cols="4">. │ │ │ -001e0e70: 093c 7468 6561 643e 0a09 2020 3c72 6f77 .<thead>.. <row │ │ │ -001e0e80: 3e0a 0920 2020 203c 656e 7472 793e 5351 >.. <entry>SQ │ │ │ -001e0e90: 4c53 7461 7465 3c2f 656e 7472 793e 3c65 LState</entry><e │ │ │ -001e0ea0: 6e74 7279 3e45 7272 6f72 2043 6f64 653c ntry>Error Code< │ │ │ -001e0eb0: 2f65 6e74 7279 3e3c 656e 7472 793e 4572 /entry><entry>Er │ │ │ -001e0ec0: 726f 7220 5465 7874 3c2f 656e 7472 793e ror Text</entry> │ │ │ -001e0ed0: 3c65 6e74 7279 3e44 6573 6372 6970 7469 <entry>Descripti │ │ │ -001e0ee0: 6f6e 3c2f 656e 7472 793e 0a09 2020 3c2f on</entry>.. </ │ │ │ -001e0ef0: 726f 773e 0a09 3c2f 7468 6561 643e 0a09 row>..</thead>.. │ │ │ -001e0f00: 3c74 626f 6479 3e0a 0920 203c 726f 773e <tbody>.. <row> │ │ │ -001e0f10: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -001e0f20: 726f 7263 6f64 653e 3432 3030 303c 2f65 rorcode>42000</e │ │ │ -001e0f30: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ -001e0f40: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ -001e0f50: 7272 6f72 636f 6465 3e58 5445 3031 3c2f rrorcode>XTE01</ │ │ │ -001e0f60: 6572 726f 7263 6f64 653e 3c2f 656e 7472 errorcode></entr │ │ │ -001e0f70: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -001e0f80: 6572 726f 726e 616d 653e 4675 6e63 7469 errorname>Functi │ │ │ -001e0f90: 6f6e 203c 6675 6e63 7469 6f6e 3e78 7465 on <function>xte │ │ │ -001e0fa0: 5f68 6561 643c 2f66 756e 6374 696f 6e3e _head</function> │ │ │ -001e0fb0: 2073 686f 756c 6420 6861 7665 2061 6e20 should have an │ │ │ -001e0fc0: 6f64 6420 6e75 6d62 6572 206f 6620 7061 odd number of pa │ │ │ -001e0fd0: 7261 6d65 7465 7273 3c2f 6572 726f 726e rameters</errorn │ │ │ -001e0fe0: 616d 653e 3c2f 656e 7472 793e 0a09 2020 ame></entry>.. │ │ │ -001e0ff0: 2020 3c65 6e74 7279 3e3c 2f65 6e74 7279 <entry></entry │ │ │ -001e1000: 3e0a 0920 203c 2f72 6f77 3e0a 093c 2f74 >.. </row>..</t │ │ │ -001e1010: 626f 6479 3e0a 2020 2020 2020 3c2f 7467 body>. </tg │ │ │ -001e1020: 726f 7570 3e0a 2020 2020 3c2f 7461 626c roup>. </tabl │ │ │ -001e1030: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ -001e1040: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ -001e1050: 2278 7465 5f68 6561 6422 3e3c 7469 746c "xte_head"><titl │ │ │ -001e1060: 653e 4578 616d 706c 6573 3c2f 7469 746c e>Examples</titl │ │ │ -001e1070: 653e 0a20 2020 203c 6578 616d 706c 6520 e>. <example │ │ │ -001e1080: 6964 3d22 6578 5f78 7465 5f68 6561 6422 id="ex_xte_head" │ │ │ -001e1090: 3e3c 7469 746c 653e 5369 6d70 6c65 2055 ><title>Simple U │ │ │ -001e10a0: 7365 3c2f 7469 746c 653e 0a20 2020 2020 se. │ │ │ -001e10b0: 203c 7061 7261 3e54 6865 2078 7465 5f68 The xte_h │ │ │ -001e10c0: 6561 6428 2920 6361 6c6c 2062 656c 6f77 ead() call below │ │ │ -001e10d0: 2074 616b 6573 2074 6872 6565 2073 7472 takes three str │ │ │ -001e10e0: 696e 6773 203c 2f70 6172 613e 0a20 2020 ings . │ │ │ -001e10f0: 2020 203c 7363 7265 656e 3e78 7465 5f68 xte_h │ │ │ -001e1100: 6561 6420 2827 7375 7070 6c69 6572 272c ead ('supplier', │ │ │ -001e1110: 2027 436f 6d70 616e 794e 616d 6527 2c20 'CompanyName', │ │ │ -001e1120: 2753 656c 6c65 7227 2029 3c2f 7363 7265 'Seller' ). │ │ │ -001e1140: 616e 6420 7072 6f64 7563 6573 2074 6865 and produces the │ │ │ -001e1150: 2072 6573 756c 7420 7665 6374 6f72 2077 result vector w │ │ │ -001e1160: 6869 6368 200a 2020 2020 2020 2020 2020 hich . │ │ │ -001e1170: 2020 636f 7272 6573 706f 6e64 7320 7468 corresponds th │ │ │ -001e1180: 6520 666f 6c6c 6f77 696e 6720 6865 6164 e following head │ │ │ -001e1190: 206f 6620 6120 584d 4c20 656c 656d 656e of a XML elemen │ │ │ -001e11a0: 743a 0a20 2020 2020 203c 2f70 6172 613e t:. │ │ │ -001e11b0: 0a20 2020 2020 203c 7061 7261 3e26 6c74 . < │ │ │ -001e11c0: 3b73 7570 706c 6965 7220 2043 6f6d 7061 ;supplier Compa │ │ │ -001e11d0: 6e79 4e61 6d65 3d22 5365 6c6c 6572 2226 nyName="Seller"& │ │ │ -001e11e0: 6774 3b3c 2f70 6172 613e 0a20 2020 203c gt;. < │ │ │ -001e11f0: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. . See Also. xte_node │ │ │ -001e1270: 2829 3c2f 6c69 6e6b 3e3c 2f70 6172 613e () │ │ │ -001e1280: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xte_node_fro │ │ │ -001e12c0: 6d5f 6e6f 6465 626c 6428 293c 2f6c 696e m_nodebld().

    xte_nodeb │ │ │ -001e1310: 6c64 5f61 6363 2829 3c2f 6c69 6e6b 3e3c ld_acc()< │ │ │ -001e1320: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xte_nodebl │ │ │ -001e1360: 645f 6669 6e61 6c28 293c 2f6c 696e 6b3e d_final() │ │ │ -001e1370: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xte_nodebl │ │ │ -001e13b0: 645f 696e 6974 2829 3c2f 6c69 6e6b 3e3c d_init()< │ │ │ -001e13c0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. ........"demo/doc │ │ │ -001e13f0: 7372 632f 6675 6e63 7265 662f 7873 6c74 src/funcref/xslt │ │ │ -001e1400: 5f73 7461 6c65 2e78 6d6c df00 000d d43c _stale.xml.....< │ │ │ -001e1410: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -001e1420: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -001e1430: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . xslt_st │ │ │ -001e17e0: 616c 653c 2f72 6566 656e 7472 7974 6974 ale. xml. . . │ │ │ -001e1840: 7873 6c74 5f73 7461 6c65 3c2f 7265 666e xslt_stale. force reloa │ │ │ -001e1870: 6420 6f66 2058 534c 2073 7479 6c65 7368 d of XSL stylesh │ │ │ -001e1880: 6565 743c 2f72 6566 7075 7270 6f73 653e eet │ │ │ -001e1890: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -001e18a0: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . │ │ │ -001e18e0: 2020 3c66 756e 6370 726f 746f 7479 7065 . │ │ │ -001e1910: 203c 6675 6e63 6465 663e 3c66 756e 6374 xslt_stale. in uri varchar. . │ │ │ -001e19a0: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . . Description...T │ │ │ -001e1a10: 6869 7320 6675 6e63 7469 6f6e 2063 616e his function can │ │ │ -001e1a20: 2062 6520 7573 6564 2074 6f20 666f 7263 be used to forc │ │ │ -001e1a30: 6520 5669 7274 756f 736f 2074 6f20 7265 e Virtuoso to re │ │ │ -001e1a40: 6c6f 6164 2061 2063 6163 6865 640a 7374 load a cached.st │ │ │ -001e1a50: 796c 6573 6865 6574 2066 726f 6d20 7468 ylesheet from th │ │ │ -001e1a60: 6520 5552 4920 7768 656e 206e 6578 7420 e URI when next │ │ │ -001e1a70: 7573 6564 2077 6974 680a 3c66 756e 6374 used with.xslt() or http_xslt()..Using │ │ │ -001e1ac0: 2074 6869 7320 6675 6e63 7469 6f6e 2062 this function b │ │ │ -001e1ad0: 6566 6f72 6520 6576 6572 7920 6170 706c efore every appl │ │ │ -001e1ae0: 6963 6174 696f 6e20 6f66 2074 6865 2073 ication of the s │ │ │ -001e1af0: 7479 6c65 7368 6565 7420 6973 0a65 7874 tylesheet is.ext │ │ │ -001e1b00: 7265 6d65 6c79 2069 6e65 6666 6963 6965 remely inefficie │ │ │ -001e1b10: 6e74 2e20 2049 6620 7374 796c 6573 6865 nt. If styleshe │ │ │ -001e1b20: 6574 7320 6172 6520 7374 6f72 6564 2069 ets are stored i │ │ │ -001e1b30: 6e20 7468 6520 6461 7461 6261 7365 2c20 n the database, │ │ │ -001e1b40: 796f 750a 6361 6e20 7573 6520 7468 6973 you.can use this │ │ │ -001e1b50: 2066 756e 6374 696f 6e20 696e 2061 6e20 function in an │ │ │ -001e1b60: 7570 6461 7465 2074 7269 6767 6572 206f update trigger o │ │ │ -001e1b70: 6e20 7468 6520 7461 626c 6520 7374 6f72 n the table stor │ │ │ -001e1b80: 696e 6720 7468 650a 7374 796c 6573 6865 ing the.styleshe │ │ │ -001e1b90: 6574 7320 6275 7420 796f 7520 646f 6e27 ets but you don' │ │ │ -001e1ba0: 7420 6861 7665 2074 6f20 7573 6520 6974 t have to use it │ │ │ -001e1bb0: 2062 6566 6f72 6520 6576 6572 7920 6170 before every ap │ │ │ -001e1bc0: 706c 6963 6174 696f 6e20 6f66 2074 6865 plication of the │ │ │ -001e1bd0: 0a73 6865 6574 2e0a 3c2f 7061 7261 3e0a .sheet... │ │ │ -001e1be0: 0a3c 7061 7261 3e54 6869 7320 6675 6e63 .This func │ │ │ -001e1bf0: 7469 6f6e 206e 6576 6572 206e 6565 6473 tion never needs │ │ │ -001e1c00: 2074 6f20 6265 2061 7070 6c69 6564 2074 to be applied t │ │ │ -001e1c10: 6f20 6120 7374 796c 6573 6865 6574 2055 o a stylesheet U │ │ │ -001e1c20: 5249 2077 6974 680a 7468 6520 6669 6c65 RI with.the file │ │ │ -001e1c30: 3a2f 2f20 7072 6f74 6f63 6f6c 2073 696e :// protocol sin │ │ │ -001e1c40: 6365 203c 6675 6e63 7469 6f6e 3e78 736c ce xsl │ │ │ -001e1c50: 7428 293c 2f66 756e 6374 696f 6e3e 2061 t() a │ │ │ -001e1c60: 6e64 0a3c 6675 6e63 7469 6f6e 3e68 7474 nd.htt │ │ │ -001e1c70: 705f 7873 6c74 2829 3c2f 6675 6e63 7469 p_xslt() will automat │ │ │ -001e1c90: 6963 616c 6c79 2064 6574 6563 7420 6120 ically detect a │ │ │ -001e1ca0: 7374 616c 650a 6361 6368 6520 656e 7472 stale.cache entr │ │ │ -001e1cb0: 792e 2020 486f 7765 7665 7220 6966 2074 y. However if t │ │ │ -001e1cc0: 6865 2073 7479 6c65 7368 6565 7420 6973 he stylesheet is │ │ │ -001e1cd0: 2073 746f 7265 6420 6f6e 2061 2072 656d stored on a rem │ │ │ -001e1ce0: 6f74 6520 7765 620a 7365 7276 6572 2c20 ote web.server, │ │ │ -001e1cf0: 6f72 2069 6620 7468 6520 7374 796c 6573 or if the styles │ │ │ -001e1d00: 6865 6574 2063 6f6e 7461 696e 7320 7375 heet contains su │ │ │ -001e1d10: 6264 6f63 756d 656e 7473 2028 0a65 2e67 bdocuments (.e.g │ │ │ -001e1d20: 2e20 6578 7465 726e 616c 2058 4d4c 2065 . external XML e │ │ │ -001e1d30: 6e74 6974 6965 732c 2078 736c 3a69 6e63 ntities, xsl:inc │ │ │ -001e1d40: 6c75 6465 206f 7220 7873 6c3a 696d 706f lude or xsl:impo │ │ │ -001e1d50: 7274 2073 7461 7465 6d65 6e74 7329 0a74 rt statements).t │ │ │ -001e1d60: 6869 7320 6675 6e63 7469 6f6e 2069 7320 his function is │ │ │ -001e1d70: 6e65 6564 6564 2074 6f20 666f 7263 6520 needed to force │ │ │ -001e1d80: 6120 7265 6c6f 6164 2e0a 3c2f 7061 7261 a reload... . │ │ │ -001e1da0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Parame │ │ │ -001e1dd0: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -001e1de0: 203c 7265 6673 6563 7432 3e3c 7469 746c uri. │ │ │ -001e1e00: 2020 2020 3c70 6172 613e 5468 6520 6c6f The lo │ │ │ -001e1e10: 6361 7469 6f6e 206f 6620 7468 6520 7374 cation of the st │ │ │ -001e1e20: 796c 6520 7368 6565 7420 746f 2066 6f72 yle sheet to for │ │ │ -001e1e30: 6365 2061 2072 656c 6f61 642e 3c2f 7061 ce a reload.. │ │ │ -001e1e50: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001e1e60: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ -001e1e70: 6f72 735f 7873 6c74 5f73 7461 6c65 223e ors_xslt_stale"> │ │ │ -001e1e80: 3c74 6974 6c65 3e45 7272 6f72 733c 2f74 Errors</t │ │ │ -001e1e90: 6974 6c65 3e0a 0920 2020 203c 7061 7261 itle>.. <para │ │ │ -001e1ea0: 3e54 6865 2066 756e 6374 696f 6e20 6e65 >The function ne │ │ │ -001e1eb0: 7665 7220 7369 676e 616c 7320 616e 7920 ver signals any │ │ │ -001e1ec0: 6572 726f 7273 2e0a 452e 672e 2069 7420 errors..E.g. it │ │ │ -001e1ed0: 6973 206e 6f74 2061 6e20 6572 726f 7220 is not an error │ │ │ -001e1ee0: 6966 2074 6865 2073 7065 6369 6669 6564 if the specified │ │ │ -001e1ef0: 2073 7479 6c65 7368 6565 7420 646f 6573 stylesheet does │ │ │ -001e1f00: 206e 6f74 2065 7869 7374 0a6f 7220 6966 not exist.or if │ │ │ -001e1f10: 2074 6865 2073 7065 6369 6669 6564 2073 the specified s │ │ │ -001e1f20: 7479 6c65 7368 6565 7420 6973 2075 7365 tylesheet is use │ │ │ -001e1f30: 6420 6279 206f 7468 6572 2074 7261 6e73 d by other trans │ │ │ -001e1f40: 6163 7469 6f6e 2077 6865 6e0a 7468 6520 action when.the │ │ │ -001e1f50: 3c66 756e 6374 696f 6e3e 7873 6c74 5f73 <function>xslt_s │ │ │ -001e1f60: 7461 6c65 2829 3c2f 6675 6e63 7469 6f6e tale()</function │ │ │ -001e1f70: 3e20 6973 2063 616c 6c65 642e 0a20 2020 > is called.. │ │ │ -001e1f80: 2020 2020 2020 2020 203c 2f70 6172 613e </para> │ │ │ -001e1f90: 0a20 203c 2f72 6566 7365 6374 313e 0a0a . </refsect1>.. │ │ │ -001e1fa0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -001e1fb0: 6578 616d 706c 6573 5f78 736c 745f 7374 examples_xslt_st │ │ │ -001e1fc0: 616c 6522 3e3c 7469 746c 653e 4578 616d ale"><title>Exam │ │ │ -001e1fd0: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ -001e1fe0: 203c 6578 616d 706c 6520 6964 3d22 6578 Simple Use. .sh │ │ │ -001e2030: 6565 7420 3a3d 2027 7669 7274 3a2f 2f57 eet := 'virt://W │ │ │ -001e2040: 532e 5753 2e53 5953 5f44 4156 5f52 4553 S.WS.SYS_DAV_RES │ │ │ -001e2050: 2e52 4553 5f46 554c 4c5f 5041 5448 2e52 .RES_FULL_PATH.R │ │ │ -001e2060: 4553 5f43 4f4e 5445 4e54 3a2f 4441 562f ES_CONTENT:/DAV/ │ │ │ -001e2070: 7374 796c 6573 6865 6574 732f 646f 6375 stylesheets/docu │ │ │ -001e2080: 6d65 6e74 2e78 736c 273b 0a78 736c 745f ment.xsl';.xslt_ │ │ │ -001e2090: 7374 616c 6520 2873 6865 6574 293b 0a78 stale (sheet);.x │ │ │ -001e20a0: 736c 7428 7368 6565 742c 2078 6d6c 5f64 slt(sheet, xml_d │ │ │ -001e20b0: 6f63 5f74 7265 6529 3b0a 3c2f 7072 6f67 oc_tree);.. │ │ │ -001e20d0: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . See Also. < │ │ │ -001e2130: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001e2140: 5f78 736c 7422 3e3c 6675 6e63 7469 6f6e _xslt">xslt() │ │ │ -001e2170: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . http_xslt()< │ │ │ -001e21c0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -001e21e0: 0a0a 0ab6 0000 0022 6465 6d6f 2f64 6f63 ......."demo/doc │ │ │ -001e21f0: 7372 632f 6675 6e63 7265 662f 7873 6c74 src/funcref/xslt │ │ │ -001e2200: 5f73 6865 6574 2e78 6d6c df00 0010 e83c _sheet.xml.....< │ │ │ -001e2210: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -001e2220: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -001e2230: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . xslt_sh │ │ │ -001e25e0: 6565 743c 2f72 6566 656e 7472 7974 6974 eet. xml. . . │ │ │ -001e2640: 7873 6c74 5f73 6865 6574 3c2f 7265 666e xslt_sheet. declares an │ │ │ -001e2670: 2058 534c 2073 7479 6c65 7368 6565 7420 XSL stylesheet │ │ │ -001e2680: 666f 7220 7573 653c 2f72 6566 7075 7270 for use. . . . │ │ │ -001e26e0: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ -001e2710: 2020 2020 203c 6675 6e63 6465 663e 3c66 xslt_she │ │ │ -001e2730: 6574 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 et. │ │ │ -001e2750: 3c70 6172 616d 6465 663e 696e 203c 7061 in uri varchar< │ │ │ -001e2780: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -001e2790: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -001e27a0: 3c70 6172 616d 6574 6572 3e65 6e74 6974 entit │ │ │ -001e27b0: 793c 2f70 6172 616d 6574 6572 3e20 616e y an │ │ │ -001e27c0: 793c 2f70 6172 616d 6465 663e 0a20 2020 y. │ │ │ -001e27d0: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . Description< │ │ │ -001e2840: 2f74 6974 6c65 3e0a 093c 7061 7261 3e0a /title>... │ │ │ -001e2850: 5468 6973 2066 756e 6374 696f 6e20 7461 This function ta │ │ │ -001e2860: 6b65 7320 6120 6e61 6d65 2061 6e64 2074 kes a name and t │ │ │ -001e2870: 6865 2072 6f6f 7420 656c 656d 656e 7420 he root element │ │ │ -001e2880: 6f66 2061 2070 6172 7365 6420 584d 4c0a of a parsed XML. │ │ │ -001e2890: 646f 6375 6d65 6e74 2061 6e64 2064 6566 document and def │ │ │ -001e28a0: 696e 6573 2074 6865 7365 2061 7320 6120 ines these as a │ │ │ -001e28b0: 7374 796c 6573 6865 6574 2e20 2054 6865 stylesheet. The │ │ │ -001e28c0: 2075 6e69 7175 6520 656c 656d 656e 7420 unique element │ │ │ -001e28d0: 6368 696c 640a 6f66 2074 6865 2065 6e74 child.of the ent │ │ │ -001e28e0: 6974 7920 6f62 6a65 6374 2661 706f 733b ity object' │ │ │ -001e28f0: 7320 646f 6375 6d65 6e74 2073 686f 756c s document shoul │ │ │ -001e2900: 6420 6265 2061 6e20 7873 6c3a 7374 796c d be an xsl:styl │ │ │ -001e2910: 6573 6865 6574 0a65 6c65 6d65 6e74 2e20 esheet.element. │ │ │ -001e2920: 2049 6e63 6c75 6465 6420 6f72 2069 6d70 Included or imp │ │ │ -001e2930: 6f72 7465 6420 7374 796c 6573 6865 6574 orted stylesheet │ │ │ -001e2940: 7320 7769 6c6c 2062 6520 6c6f 6361 7465 s will be locate │ │ │ -001e2950: 6420 7265 6c61 7469 7665 2074 6f0a 7468 d relative to.th │ │ │ -001e2960: 6520 6261 7365 2055 5249 206f 6620 7468 e base URI of th │ │ │ -001e2970: 6520 656e 7469 7479 2070 6173 7365 6420 e entity passed │ │ │ -001e2980: 746f 0a3c 6675 6e63 7469 6f6e 3e78 736c to.xsl │ │ │ -001e2990: 745f 7368 6565 7428 293c 2f66 756e 6374 t_sheet(). Once a st │ │ │ -001e29b0: 796c 6573 6865 6574 2074 6875 7320 6465 ylesheet thus de │ │ │ -001e29c0: 6669 6e65 6420 6974 0a63 616e 2062 6520 fined it.can be │ │ │ -001e29d0: 7573 6564 2061 7320 7468 6520 7374 796c used as the styl │ │ │ -001e29e0: 6573 6865 6574 2061 7267 756d 656e 7420 esheet argument │ │ │ -001e29f0: 6f66 2078 736c 742e 0a3c 2f70 6172 613e of xslt.. │ │ │ -001e2a00: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -001e2a10: 203c 7265 6673 6563 7431 2069 643d 2270 Paramet │ │ │ -001e2a40: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -001e2a50: 3c72 6566 7365 6374 323e 3c74 6974 6c65 uri. │ │ │ -001e2a70: 2020 203c 7061 7261 3e54 6865 206c 6f63 The loc │ │ │ -001e2a80: 6174 696f 6e20 6f66 2074 6865 2058 534c ation of the XSL │ │ │ -001e2a90: 5420 7374 796c 6520 7368 6565 743c 2f70 T style sheet

    . │ │ │ -001e2ab0: 2020 2020 3c72 6566 7365 6374 323e 3c74 entity. │ │ │ -001e2ae0: 4120 7661 6c69 6420 5853 4c20 7374 796c A valid XSL styl │ │ │ -001e2af0: 6520 7368 6565 742c 2058 4d4c 2065 6e74 e sheet, XML ent │ │ │ -001e2b00: 6974 7920 7061 7273 6564 2075 7369 6e67 ity parsed using │ │ │ -001e2b10: 2074 6865 203c 6675 6e63 7469 6f6e 3e78 the x │ │ │ -001e2b20: 6d6c 5f74 7265 655f 646f 6328 293c 2f66 ml_tree_doc() functio │ │ │ -001e2b40: 6e3c 2f70 6172 613e 3c2f 7265 6673 6563 n. .. Examples. Prep │ │ │ -001e2e20: 6172 696e 6720 6120 5374 796c 6520 5368 aring a Style Sh │ │ │ -001e2e30: 6565 7420 6672 6f6d 2074 6865 2046 696c eet from the Fil │ │ │ -001e2e40: 6520 5379 7374 656d 3c2f 7469 746c 653e e System │ │ │ -001e2e50: 0a20 2020 2020 203c 7061 7261 3e0a 5468 . .Th │ │ │ -001e2e60: 6520 3c66 756e 6374 696f 6e3e 7873 6c74 e xslt │ │ │ -001e2e70: 5f76 6965 7728 293c 2f66 756e 6374 696f _view() function firs │ │ │ -001e2e90: 7420 6465 6669 6e65 7320 7468 6520 7374 t defines the st │ │ │ -001e2ea0: 796c 650a 7368 6565 7420 6672 6f6d 2061 yle.sheet from a │ │ │ -001e2eb0: 2066 696c 652e 2054 6865 203c 6675 6e63 file. The xslt_sheet( │ │ │ -001e2ed0: 293c 2f66 756e 6374 696f 6e3e 2066 756e ) fun │ │ │ -001e2ee0: 6374 696f 6e20 6973 0a63 616c 6c65 6420 ction is.called │ │ │ -001e2ef0: 7769 7468 2074 6865 206e 616d 6520 616e with the name an │ │ │ -001e2f00: 6420 7468 6520 726f 6f74 2065 6c65 6d65 d the root eleme │ │ │ -001e2f10: 6e74 206f 6620 7468 6520 7061 7273 6564 nt of the parsed │ │ │ -001e2f20: 2066 696c 652e 0a3c 6675 6e63 7469 6f6e file..xslt_view() next get │ │ │ -001e2f50: 7320 7468 6520 7374 7269 6e67 2074 6f20 s the string to │ │ │ -001e2f60: 7072 6f63 6573 732c 0a70 6172 7365 7320 process,.parses │ │ │ -001e2f70: 7468 6520 7374 7269 6e67 2061 7320 584d the string as XM │ │ │ -001e2f80: 4c20 616e 6420 636f 6e76 6572 7473 2074 L and converts t │ │ │ -001e2f90: 6865 2070 6172 7365 2074 7265 6520 696e he parse tree in │ │ │ -001e2fa0: 746f 2061 6e20 656e 7469 7479 0a6f 626a to an entity.obj │ │ │ -001e2fb0: 6563 742e 2054 6869 7320 6973 2074 6865 ect. This is the │ │ │ -001e2fc0: 6e20 7061 7373 6564 2074 6f20 7468 6520 n passed to the │ │ │ -001e2fd0: 3c66 756e 6374 696f 6e3e 7873 6c74 2829 xslt() │ │ │ -001e2fe0: 3c2f 6675 6e63 7469 6f6e 3e0a 6675 6e63 .func │ │ │ -001e2ff0: 7469 6f6e 2e20 5468 6520 7265 7375 6c74 tion. The result │ │ │ -001e3000: 2069 7320 616e 6f74 6865 7220 656e 7469 is another enti │ │ │ -001e3010: 7479 206f 626a 6563 742e 2054 6869 7320 ty object. This │ │ │ -001e3020: 6973 2066 696e 616c 6c79 0a73 6572 6961 is finally.seria │ │ │ -001e3030: 6c69 7a65 6420 6173 2058 4d4c 2074 6578 lized as XML tex │ │ │ -001e3040: 7420 616e 6420 7772 6974 7465 6e20 696e t and written in │ │ │ -001e3050: 746f 2074 6865 2066 696c 650a 3c70 6172 to the file.xslt.out< │ │ │ -001e3070: 2f70 6172 616d 6574 6572 3e2e 0a3c 2f70 /parameter>..

    . .crea │ │ │ -001e30a0: 7465 2070 726f 6365 6475 7265 2078 736c te procedure xsl │ │ │ -001e30b0: 745f 7669 6577 2028 696e 2076 2076 6172 t_view (in v var │ │ │ -001e30c0: 6368 6172 2c20 696e 2078 7374 2076 6172 char, in xst var │ │ │ -001e30d0: 6368 6172 290a 7b0a 2020 6465 636c 6172 char).{. declar │ │ │ -001e30e0: 6520 7374 722c 2072 2076 6172 6368 6172 e str, r varchar │ │ │ -001e30f0: 3b0a 2020 7873 6c74 5f73 6865 6574 2028 ;. xslt_sheet ( │ │ │ -001e3100: 7873 742c 2078 6d6c 5f74 7265 655f 646f xst, xml_tree_do │ │ │ -001e3110: 6320 2878 6d6c 5f74 7265 6520 2028 6669 c (xml_tree (fi │ │ │ -001e3120: 6c65 5f74 6f5f 7374 7269 6e67 2028 7873 le_to_string (xs │ │ │ -001e3130: 7429 2929 293b 0a20 2073 7472 203a 3d20 t))));. str := │ │ │ -001e3140: 786d 6c5f 7669 6577 5f73 7472 696e 6720 xml_view_string │ │ │ -001e3150: 2876 293b 0a20 2072 203a 3d20 7873 6c74 (v);. r := xslt │ │ │ -001e3160: 2028 7873 742c 2078 6d6c 5f74 7265 655f (xst, xml_tree_ │ │ │ -001e3170: 646f 6320 2878 6d6c 5f74 7265 6520 2873 doc (xml_tree (s │ │ │ -001e3180: 7472 2929 293b 0a20 2064 6563 6c61 7265 tr)));. declare │ │ │ -001e3190: 2073 7472 2061 6e79 3b0a 2020 7374 7220 str any;. str │ │ │ -001e31a0: 3a3d 2073 7472 696e 675f 6f75 7470 7574 := string_output │ │ │ -001e31b0: 2028 293b 0a20 2068 7474 705f 7661 6c75 ();. http_valu │ │ │ -001e31c0: 6520 2872 2c20 302c 2073 7472 293b 0a20 e (r, 0, str);. │ │ │ -001e31d0: 2073 7472 696e 675f 746f 5f66 696c 6520 string_to_file │ │ │ -001e31e0: 2827 7873 6c74 2e6f 7574 272c 2073 7472 ('xslt.out', str │ │ │ -001e31f0: 696e 675f 6f75 7470 7574 5f73 7472 696e ing_output_strin │ │ │ -001e3200: 6720 2873 7472 292c 2030 293b 0a7d 0a3c g (str), 0);.}.< │ │ │ -001e3210: 2f70 726f 6772 616d 6c69 7374 696e 673e /programlisting> │ │ │ -001e3220: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -001e3230: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -001e3240: 3c72 6566 7365 6374 3120 6964 3d22 7365 See Als │ │ │ -001e3270: 6f3c 2f74 6974 6c65 3e0a 2020 2020 3c70 o.

    xml_tree_doc() │ │ │ -001e32c0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e . .........(demo │ │ │ -001e3300: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -001e3310: 7873 6c74 5f70 726f 665f 656e 6162 6c65 xslt_prof_enable │ │ │ -001e3320: 2e78 6d6c df00 000a 713c 3f78 6d6c 2076 .xml....q... │ │ │ -001e36e0: 3c72 6566 6d65 7461 3e20 0a20 2020 203c . < │ │ │ -001e36f0: 7265 6665 6e74 7279 7469 746c 653e 3c2f refentrytitle> . │ │ │ -001e3710: 2020 2020 3c72 6566 6d69 7363 696e 666f . │ │ │ -001e3730: 2020 3c2f 7265 666d 6574 613e 200a 2020 . │ │ │ -001e3740: 3c72 6566 6e61 6d65 6469 763e 200a 2020 . │ │ │ -001e3750: 2020 3c72 6566 6e61 6d65 3e3c 2f72 6566 . . . . . │ │ │ -001e37e0: 2020 3c66 756e 6370 726f 746f 7479 7065 . .. │ │ │ -001e3850: 3c70 6172 616d 6574 6572 3e3c 2f70 6172 . . < │ │ │ -001e3890: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ -001e38a0: 203c 2f72 6566 7379 6e6f 7073 6973 6469 . . │ │ │ -001e38e0: 2020 3c74 6974 6c65 3e44 6573 6372 6970 Descrip │ │ │ -001e38f0: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ -001e3900: 203c 7061 7261 3e3c 2f70 6172 613e 0a20 . │ │ │ -001e3910: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001e3920: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -001e3930: 616d 735f 7873 6c74 5f70 726f 6669 6c65 ams_xslt_profile │ │ │ -001e3940: 5f65 6e61 626c 6522 3e0a 2020 2020 3c74 _enable">. Parameters< │ │ │ -001e3960: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. </t │ │ │ -001e3980: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001e3990: 613e 3c2f 7061 7261 3e0a 2020 2020 3c2f a></para>. </ │ │ │ -001e39a0: 7265 6673 6563 7432 3e0a 2020 3c2f 7265 refsect2>. </re │ │ │ -001e39b0: 6673 6563 7431 3e0a 2020 3c72 6566 7365 fsect1>. <refse │ │ │ -001e39c0: 6374 3120 6964 3d22 7265 745f 7873 6c74 ct1 id="ret_xslt │ │ │ -001e39d0: 5f70 726f 6669 6c65 5f65 6e61 626c 6522 _profile_enable" │ │ │ -001e39e0: 3e3c 7469 746c 653e 5265 7475 726e 2054 ><title>Return T │ │ │ -001e39f0: 7970 6573 3c2f 7469 746c 653e 0a20 2020 ypes. │ │ │ -001e3a00: 203c 7061 7261 3e3c 2f70 6172 613e 0a20 . │ │ │ -001e3a10: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001e3a20: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ -001e3a30: 6f72 735f 7873 6c74 5f70 726f 6669 6c65 ors_xslt_profile │ │ │ -001e3a40: 5f65 6e61 626c 6522 3e0a 2020 2020 3c74 _enable">. Errors... . . See │ │ │ -001e3ca0: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -001e3cb0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ -001e3ce0: 3c66 756e 6374 696f 6e3e 7873 6c74 5f70 xslt_p │ │ │ -001e3cf0: 726f 6669 6c65 5f64 6973 6162 6c65 2829 rofile_disable() │ │ │ -001e3d00: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    xslt_profile_ │ │ │ -001e3d60: 6c69 7374 2829 3c2f 6675 6e63 7469 6f6e list(). │ │ │ -001e3d80: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......*d │ │ │ -001e3da0: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -001e3db0: 6566 2f78 736c 745f 666f 726d 6174 5f6e ef/xslt_format_n │ │ │ -001e3dc0: 756d 6265 722e 786d 6cdf 0000 0c17 3c3f umber.xml....... │ │ │ -001e4180: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -001e4190: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -001e41a0: 7873 6c74 5f66 6f72 6d61 745f 6e75 6d62 xslt_format_numb │ │ │ -001e41b0: 6572 3c2f 7265 6665 6e74 7279 7469 746c er. xml. . . x │ │ │ -001e4210: 736c 745f 666f 726d 6174 5f6e 756d 6265 slt_format_numbe │ │ │ -001e4220: 723c 2f72 6566 6e61 6d65 3e0a 2020 2020 r. │ │ │ -001e4230: 3c72 6566 7075 7270 6f73 653e 7265 7475 retu │ │ │ -001e4240: 726e 7320 666f 726d 6174 7465 6420 7374 rns formatted st │ │ │ -001e4250: 7269 6e67 2072 6570 7265 7365 6e74 6174 ring representat │ │ │ -001e4260: 696f 6e20 6f66 2061 206e 756d 6572 6963 ion of a numeric │ │ │ -001e4270: 2076 616c 7565 3c2f 7265 6670 7572 706f value. . . . . │ │ │ -001e4310: 2020 2020 3c66 756e 6364 6566 3e3c 6675 xslt_form │ │ │ -001e4330: 6174 5f6e 756d 6265 723c 2f66 756e 6374 at_number. │ │ │ -001e4350: 2020 2020 2020 203c 7061 7261 6d64 6566 numb │ │ │ -001e4370: 6572 3c2f 7061 7261 6d65 7465 723e 2061 er a │ │ │ -001e4380: 6e79 3c2f 7061 7261 6d64 6566 3e0a 2020 ny. │ │ │ -001e4390: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001e43a0: 3c70 6172 616d 6574 6572 3e66 6f72 6d61 forma │ │ │ -001e43b0: 745f 7374 7269 6e67 3c2f 7061 7261 6d65 t_string varchar. . │ │ │ -001e43f0: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Description< │ │ │ -001e4440: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. xslt_format_nu │ │ │ -001e4460: 6d62 6572 2069 7320 616e 2066 756e 6374 mber is an funct │ │ │ -001e4470: 696f 6e20 7772 6170 7065 7220 666f 7220 ion wrapper for │ │ │ -001e4480: 7468 6520 666f 726d 6174 2d6e 756d 6265 the format-numbe │ │ │ -001e4490: 7228 2920 5853 4c54 2066 756e 6374 696f r() XSLT functio │ │ │ -001e44a0: 6e2e 3c2f 7061 7261 3e0a 2020 2020 3c70 n..

    It always us │ │ │ -001e44c0: 6573 2074 6865 2064 6566 6175 6c74 2066 es the default f │ │ │ -001e44d0: 6f72 6d61 7474 696e 6720 7061 7261 6d65 ormatting parame │ │ │ -001e44e0: 7465 7273 2064 6573 6372 6962 6564 2069 ters described i │ │ │ -001e44f0: 6e20 7468 6520 5853 4c54 2073 7461 6e64 n the XSLT stand │ │ │ -001e4500: 6172 642e 3c2f 7061 7261 3e0a 2020 3c2f ard.. . Paramet │ │ │ -001e4540: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -001e4550: 3c72 6566 7365 6374 323e 3c74 6974 6c65 <parameter>numb │ │ │ -001e4570: 6572 3c2f 7061 7261 6d65 7465 723e 3c2f er</parameter></ │ │ │ -001e4580: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -001e4590: 7261 3e0a 2020 2020 2020 2020 3c74 7970 ra>. <typ │ │ │ -001e45a0: 653e 696e 7465 6765 723c 2f74 7970 653e e>integer</type> │ │ │ -001e45b0: 2c20 3c74 7970 653e 6e75 6d65 7269 633c , <type>numeric< │ │ │ -001e45c0: 2f74 7970 653e 206f 7220 3c74 7970 653e /type> or <type> │ │ │ -001e45d0: 7374 7269 6e67 3c2f 7479 7065 3e2e 0a20 string</type>.. │ │ │ -001e45e0: 2020 2020 203c 2f70 6172 613e 0a20 2020 </para>. │ │ │ -001e45f0: 203c 2f72 6566 7365 6374 323e 0a20 2020 </refsect2>. │ │ │ -001e4600: 203c 7265 6673 6563 7432 3e3c 7469 746c <refsect2><titl │ │ │ -001e4610: 653e 3c70 6172 616d 6574 6572 3e66 6f72 e><parameter>for │ │ │ -001e4620: 6d61 745f 7374 7269 6e67 3c2f 7061 7261 mat_string</para │ │ │ -001e4630: 6d65 7465 723e 3c2f 7469 746c 653e 0a20 meter>. │ │ │ -001e4640: 2020 2020 203c 7061 7261 3e3c 7479 7065 string. . . │ │ │ -001e46a0: 5265 7475 726e 2056 616c 7565 733c 2f74 Return Values</t │ │ │ -001e46b0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ -001e46c0: 416e 203c 7479 7065 3e73 7472 696e 673c An <type>string< │ │ │ -001e46d0: 2f74 7970 653e 2072 6570 7265 7365 6e74 /type> represent │ │ │ -001e46e0: 6174 696f 6e20 6f66 2074 6865 206e 756d ation of the num │ │ │ -001e46f0: 6572 6963 2076 616c 7565 206f 6620 3c70 eric value of <p │ │ │ -001e4700: 6172 616d 6574 6572 3e6e 756d 6265 723c arameter>number< │ │ │ -001e4710: 2f70 6172 616d 6574 6572 3e20 636f 6e76 /parameter> conv │ │ │ -001e4720: 6572 7465 6420 6163 636f 7264 696e 6720 erted according │ │ │ -001e4730: 746f 2074 6865 2066 6f72 6d61 7420 3c70 to the format <p │ │ │ -001e4740: 6172 616d 6574 6572 3e66 6f72 6d61 745f arameter>format_ │ │ │ -001e4750: 7374 7269 6e67 3c2f 7061 7261 6d65 7465 string</paramete │ │ │ -001e4760: 723e 2e3c 2f70 6172 613e 0a20 203c 2f72 r>.</para>. </r │ │ │ -001e4770: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -001e4780: 6563 7431 2069 643d 2265 7861 6d70 6c65 ect1 id="example │ │ │ -001e4790: 7322 3e3c 7469 746c 653e 4578 616d 706c s"><title>Exampl │ │ │ -001e47a0: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ -001e47b0: 6578 616d 706c 6520 6964 3d22 6578 5f66 example id="ex_f │ │ │ -001e47c0: 6e5f 7873 6c74 5f66 6f72 6d61 745f 6e75 n_xslt_format_nu │ │ │ -001e47d0: 6d62 6572 5f31 223e 3c74 6974 6c65 3e53 mber_1">S │ │ │ -001e47e0: 696d 706c 6520 6578 616d 706c 6573 3c2f imple examples</ │ │ │ -001e47f0: 7469 746c 653e 0a20 2020 2020 203c 7363 title>. <sc │ │ │ -001e4800: 7265 656e 3e0a 7873 6c74 5f66 6f72 6d61 reen>.xslt_forma │ │ │ -001e4810: 745f 6e75 6d62 6572 2028 3533 3531 2c20 t_number (5351, │ │ │ -001e4820: 2723 2c23 2323 2729 2c20 2020 2020 2020 '#,###'), │ │ │ -001e4830: 2035 2c33 3531 0a78 736c 745f 666f 726d 5,351.xslt_form │ │ │ -001e4840: 6174 5f6e 756d 6265 7220 2827 3533 3531 at_number ('5351 │ │ │ -001e4850: 272c 2027 232e 3030 2729 2c20 2020 2020 ', '#.00'), │ │ │ -001e4860: 2020 3533 3531 2e30 300a 7873 6c74 5f66 5351.00.xslt_f │ │ │ -001e4870: 6f72 6d61 745f 6e75 6d62 6572 2028 3533 ormat_number (53 │ │ │ -001e4880: 2e35 312c 2027 232e 3030 3030 2729 2c20 .51, '#.0000'), │ │ │ -001e4890: 2020 2020 2035 332e 3531 3030 0a78 736c 53.5100.xsl │ │ │ -001e48a0: 745f 666f 726d 6174 5f6e 756d 6265 7220 t_format_number │ │ │ -001e48b0: 2835 332e 3531 2c20 2730 3030 302e 3030 (53.51, '0000.00 │ │ │ -001e48c0: 3030 2729 2c20 2020 3030 3533 2e35 3130 00'), 0053.510 │ │ │ -001e48d0: 300a 7873 6c74 5f66 6f72 6d61 745f 6e75 0.xslt_format_nu │ │ │ -001e48e0: 6d62 6572 2028 3533 2e35 312c 2027 3030 mber (53.51, '00 │ │ │ -001e48f0: 3030 2e23 2323 2327 292c 2020 2030 3035 00.####'), 005 │ │ │ -001e4900: 332e 3531 0a78 736c 745f 666f 726d 6174 3.51.xslt_format │ │ │ -001e4910: 5f6e 756d 6265 7220 2835 332e 3536 2c20 _number (53.56, │ │ │ -001e4920: 2730 2e30 2729 3b09 2020 2020 2020 3533 '0.0');. 53 │ │ │ -001e4930: 2e36 0a20 2020 2020 203c 2f73 6372 6565 .6. </scree │ │ │ -001e4940: 6e3e 0a20 2020 203c 2f65 7861 6d70 6c65 n>. </example │ │ │ -001e4950: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ -001e4960: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -001e4970: 7365 6561 6c73 6f22 3e3c 7469 746c 653e seealso"><title> │ │ │ -001e4980: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ -001e4990: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . casting. .......demo/d │ │ │ -001e49f0: 6f63 7372 632f 6675 6e63 7265 662f 7873 ocsrc/funcref/xs │ │ │ -001e4a00: 6c74 2e78 6d6c df00 001e a33c 3f78 6d6c lt.xml........ │ │ │ -001e4db0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ -001e4dc0: 3c72 6566 656e 7472 7974 6974 6c65 3e78 x │ │ │ -001e4dd0: 736c 743c 2f72 6566 656e 7472 7974 6974 slt. xml. . . │ │ │ -001e4e30: 7873 6c74 3c2f 7265 666e 616d 653e 0a20 xslt. │ │ │ -001e4e40: 2020 203c 7265 6670 7572 706f 7365 3e72 r │ │ │ -001e4e50: 6574 7572 6e73 2061 6e20 584d 4c20 646f eturns an XML do │ │ │ -001e4e60: 6375 6d65 6e74 2074 7261 6e73 666f 726d cument transform │ │ │ -001e4e70: 6564 2062 7920 616e 2058 534c 5420 7374 ed by an XSLT st │ │ │ -001e4e80: 796c 6573 6865 6574 3c2f 7265 6670 7572 ylesheet. . . . │ │ │ -001e4ee0: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . xml_entity xslt. in sheet_uri varchar< │ │ │ -001e4f80: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -001e4f90: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -001e4fa0: 3c70 6172 616d 6574 6572 3e65 6e74 6974 entit │ │ │ -001e4fb0: 793c 2f70 6172 616d 6574 6572 3e20 616e y an │ │ │ -001e4fc0: 793c 2f70 6172 616d 6465 663e 0a20 2020 y. │ │ │ -001e4fd0: 2020 2020 203c 7061 7261 6d64 6566 3e3c < │ │ │ -001e4fe0: 6f70 7469 6f6e 616c 3e69 6e20 3c70 6172 optional>in sheet_par │ │ │ -001e5000: 616d 733c 2f70 6172 616d 6574 6572 3e20 ams │ │ │ -001e5010: 7665 6374 6f72 3c2f 6f70 7469 6f6e 616c vector. │ │ │ -001e5030: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . De │ │ │ -001e5090: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription..This fu │ │ │ -001e50b0: 6e63 7469 6f6e 2074 616b 6573 2074 6865 nction takes the │ │ │ -001e50c0: 2055 5249 206f 6620 6120 7374 796c 6573 URI of a styles │ │ │ -001e50d0: 6865 6574 2061 6e64 2061 6e20 584d 4c20 heet and an XML │ │ │ -001e50e0: 656e 7469 7479 2061 6e64 0a70 726f 6475 entity and.produ │ │ │ -001e50f0: 6365 7320 616e 2058 4d4c 2065 6e74 6974 ces an XML entit │ │ │ -001e5100: 7920 7265 7072 6573 656e 7469 6e67 2074 y representing t │ │ │ -001e5110: 6865 2074 7261 6e73 666f 726d 6174 696f he transformatio │ │ │ -001e5120: 6e20 7265 7375 6c74 206f 6620 7468 650a n result of the. │ │ │ -001e5130: 6769 7665 6e20 656e 7469 7479 2077 6974 given entity wit │ │ │ -001e5140: 6820 7468 6520 6769 7665 6e20 7374 796c h the given styl │ │ │ -001e5150: 6573 6865 6574 2e20 2054 6865 2072 6573 esheet. The res │ │ │ -001e5160: 756c 7420 7472 6565 2069 7320 7365 7061 ult tree is sepa │ │ │ -001e5170: 7261 7465 0a66 726f 6d20 7468 6520 6172 rate.from the ar │ │ │ -001e5180: 6775 6d65 6e74 2074 7265 6520 616e 6420 gument tree and │ │ │ -001e5190: 7468 6520 6f6e 6c79 2072 6566 6572 656e the only referen │ │ │ -001e51a0: 6365 2074 6f20 6974 2069 7320 7468 6520 ce to it is the │ │ │ -001e51b0: 7265 7475 726e 6564 0a65 6e74 6974 792e returned.entity. │ │ │ -001e51c0: 2020 4572 726f 7273 206f 6363 7572 7269 Errors occurri │ │ │ -001e51d0: 6e67 2069 6e20 7468 6520 7472 616e 7366 ng in the transf │ │ │ -001e51e0: 6f72 6d61 7469 6f6e 2077 696c 6c20 6265 ormation will be │ │ │ -001e51f0: 2073 6967 6e61 6c6c 6564 2061 730a 5351 signalled as.SQ │ │ │ -001e5200: 4c20 7374 6174 6573 2c20 7769 7468 2058 L states, with X │ │ │ -001e5210: 4d4c 206f 7220 5853 4c54 2073 7065 6369 ML or XSLT speci │ │ │ -001e5220: 6669 6320 636f 6e64 6974 696f 6e73 2062 fic conditions b │ │ │ -001e5230: 6567 696e 6e69 6e67 2077 6974 6820 5853 eginning with XS │ │ │ -001e5240: 206f 720a 5850 2e0a 3c2f 7061 7261 3e0a or.XP... │ │ │ -001e5250: 093c 7061 7261 3e0a 5468 6520 7374 796c ..The styl │ │ │ -001e5260: 6573 6865 6574 2063 616e 2062 6520 7061 esheet can be pa │ │ │ -001e5270: 7373 6564 2070 6172 616d 6574 6572 7320 ssed parameters │ │ │ -001e5280: 6279 2073 7065 6369 6679 696e 6720 6120 by specifying a │ │ │ -001e5290: 7468 6972 6420 6172 6775 6d65 6e74 0a74 third argument.t │ │ │ -001e52a0: 6f20 3c66 756e 6374 696f 6e3e 7873 6c74 o xslt │ │ │ -001e52b0: 2829 3c2f 6675 6e63 7469 6f6e 3e2e 2020 (). │ │ │ -001e52c0: 5468 6973 2077 696c 6c20 6265 2061 2076 This will be a v │ │ │ -001e52d0: 6563 746f 7220 6f66 206e 616d 652f 7661 ector of name/va │ │ │ -001e52e0: 6c75 650a 7061 6972 732e 2054 6865 2076 lue.pairs. The v │ │ │ -001e52f0: 616c 7565 7320 6361 6e20 6265 2072 6566 alues can be ref │ │ │ -001e5300: 6572 656e 6365 6420 6672 6f6d 2069 6e73 erenced from ins │ │ │ -001e5310: 6964 6520 5850 6174 6820 6578 7072 6573 ide XPath expres │ │ │ -001e5320: 7369 6f6e 7320 696e 0a74 6865 2073 7479 sions in.the sty │ │ │ -001e5330: 6c65 7368 6565 742e 2059 6f75 206d 6179 lesheet. You may │ │ │ -001e5340: 2075 7365 2061 6e79 2056 6972 7475 6f73 use any Virtuos │ │ │ -001e5350: 6f20 6461 7461 2074 7970 652e 2020 5468 o data type. Th │ │ │ -001e5360: 6520 6e61 6d65 7320 696e 2074 6865 0a70 e names in the.p │ │ │ -001e5370: 6172 616d 6574 6572 2076 6563 746f 7220 arameter vector │ │ │ -001e5380: 7368 6f75 6c64 2061 7070 6561 7220 7769 should appear wi │ │ │ -001e5390: 7468 6f75 7420 7468 6520 2724 2720 7369 thout the '$' si │ │ │ -001e53a0: 676e 2e20 2049 6620 616e 7920 6f66 2074 gn. If any of t │ │ │ -001e53b0: 6865 0a70 6172 616d 6574 6572 2076 616c he.parameter val │ │ │ -001e53c0: 7565 7320 6973 204e 554c 4c20 7468 6520 ues is NULL the │ │ │ -001e53d0: 7061 7261 6d65 7465 7220 7769 6c6c 2062 parameter will b │ │ │ -001e53e0: 6520 6967 6e6f 7265 6420 6265 6361 7573 e ignored becaus │ │ │ -001e53f0: 6520 4e55 4c4c 0a68 6173 206e 6f20 5850 e NULL.has no XP │ │ │ -001e5400: 6174 6820 636f 756e 7465 7270 6172 742e ath counterpart. │ │ │ -001e5410: 0a49 6620 7468 6520 7361 6d65 206e 616d .If the same nam │ │ │ -001e5420: 6520 6170 7065 6172 7320 6d6f 7265 2074 e appears more t │ │ │ -001e5430: 6861 6e20 6f6e 6365 2069 6e20 7468 6520 han once in the │ │ │ -001e5440: 7665 6374 6f72 2c20 7468 6520 6c61 7374 vector, the last │ │ │ -001e5450: 206e 616d 652f 7661 6c75 6520 7061 6972 name/value pair │ │ │ -001e5460: 2069 730a 7573 6564 2061 6e64 2061 6c6c is.used and all │ │ │ -001e5470: 2070 7265 6365 6469 6e67 2070 6169 7273 preceding pairs │ │ │ -001e5480: 2077 6974 6820 7468 6973 206e 616d 6520 with this name │ │ │ -001e5490: 6172 6520 7369 6c65 6e74 6c79 2069 676e are silently ign │ │ │ -001e54a0: 6f72 6564 2e0a 4f62 7669 6f75 736c 792c ored..Obviously, │ │ │ -001e54b0: 206e 616d 6573 2073 686f 756c 6420 6265 names should be │ │ │ -001e54c0: 2073 7472 696e 6773 2074 6861 7420 6172 strings that ar │ │ │ -001e54d0: 6520 7661 6c69 6420 5850 6174 6820 7661 e valid XPath va │ │ │ -001e54e0: 7269 6162 6c65 206e 616d 6573 2e0a 3c2f riable names.....xslt() applie │ │ │ -001e5520: 7320 7468 6520 7472 616e 7366 6f72 6d61 s the transforma │ │ │ -001e5530: 7469 6f6e 2069 6e20 7468 6520 7368 6565 tion in the shee │ │ │ -001e5540: 7420 746f 0a74 6865 2073 7065 6369 6669 t to.the specifi │ │ │ -001e5550: 6564 2065 6e74 6974 792e 2020 5468 6520 ed entity. The │ │ │ -001e5560: 7265 7375 6c74 2069 7320 7468 6520 726f result is the ro │ │ │ -001e5570: 6f74 2065 6c65 6d65 6e74 206f 6620 7468 ot element of th │ │ │ -001e5580: 6520 7265 7375 6c74 0a74 7265 652c 2061 e result.tree, a │ │ │ -001e5590: 6e20 584d 4c20 656e 7469 7479 2e20 2054 n XML entity. T │ │ │ -001e55a0: 6869 7320 656e 7469 7479 2063 616e 2062 his entity can b │ │ │ -001e55b0: 6520 7573 6564 2061 7320 696e 7075 7420 e used as input │ │ │ -001e55c0: 746f 2061 6e6f 7468 6572 0a74 7261 6e73 to another.trans │ │ │ -001e55d0: 666f 726d 6174 696f 6e2c 2063 616e 2062 formation, can b │ │ │ -001e55e0: 6520 7365 7269 616c 697a 6564 2061 6e64 e serialized and │ │ │ -001e55f0: 2073 656e 7420 746f 2061 6e20 4854 5450 sent to an HTTP │ │ │ -001e5600: 2063 6c69 656e 7420 6f72 2073 746f 7265 client or store │ │ │ -001e5610: 642c 0a65 7463 2e0a 3c2f 7061 7261 3e0a d,.etc... │ │ │ -001e5620: 093c 7061 7261 3e0a 5468 6520 5552 4920 ..The URI │ │ │ -001e5630: 6f66 2074 6865 2073 6865 6574 2069 7320 of the sheet is │ │ │ -001e5640: 7573 6564 2074 6f20 6c6f 6361 7465 2074 used to locate t │ │ │ -001e5650: 6865 2073 7479 6c65 7368 6565 742e 2020 he stylesheet. │ │ │ -001e5660: 5468 6520 7072 6f74 6f63 6f6c 0a63 616e The protocol.can │ │ │ -001e5670: 2062 6520 6874 7470 2c20 6669 6c65 206f be http, file o │ │ │ -001e5680: 7220 7669 7274 2e20 204f 6e63 6520 7468 r virt. Once th │ │ │ -001e5690: 6520 7374 796c 6573 6865 6574 2068 6173 e stylesheet has │ │ │ -001e56a0: 2062 6565 6e20 7265 7472 6965 7665 6420 been retrieved │ │ │ -001e56b0: 6974 0a69 7320 6361 6368 6564 2061 6e64 it.is cached and │ │ │ -001e56c0: 206e 6f74 2072 6566 6574 6368 6564 2075 not refetched u │ │ │ -001e56d0: 6e74 696c 2074 6865 2063 6163 6865 2069 ntil the cache i │ │ │ -001e56e0: 7320 696e 7661 6c69 6461 7465 6420 7769 s invalidated wi │ │ │ -001e56f0: 7468 0a3c 6675 6e63 7469 6f6e 3e78 736c th.xsl │ │ │ -001e5700: 745f 7374 616c 6528 293c 2f66 756e 6374 t_stale(). Included │ │ │ -001e5720: 6f72 2069 6d70 6f72 7465 6420 7374 796c or imported styl │ │ │ -001e5730: 6520 7368 6565 7473 0a77 696c 6c20 6265 e sheets.will be │ │ │ -001e5740: 2066 6574 6368 6564 2061 7574 6f6d 6174 fetched automat │ │ │ -001e5750: 6963 616c 6c79 2c20 7573 696e 6720 7468 ically, using th │ │ │ -001e5760: 6520 696e 6974 6961 6c20 5552 4920 6173 e initial URI as │ │ │ -001e5770: 2062 6173 6520 666f 7220 616e 790a 7265 base for any.re │ │ │ -001e5780: 6c61 7469 7665 2072 6566 6572 656e 6365 lative reference │ │ │ -001e5790: 732e 2020 5468 6520 3c70 6172 616d 6574 s. The sheet_uri is the │ │ │ -001e57c0: 5552 490a 6f66 2061 2073 7479 6c65 7368 URI.of a stylesh │ │ │ -001e57d0: 6565 742e 2020 5468 6973 2073 686f 756c eet. This shoul │ │ │ -001e57e0: 6420 6265 2061 6e20 6162 736f 6c75 7465 d be an absolute │ │ │ -001e57f0: 2055 5249 2072 6573 6f6c 7661 626c 6520 URI resolvable │ │ │ -001e5800: 7769 7468 0a3c 6675 6e63 7469 6f6e 3e78 with.x │ │ │ -001e5810: 6d6c 5f75 7269 5f67 6574 2829 3c2f 6675 ml_uri_get(). If the │ │ │ -001e5830: 2055 5249 2068 6173 2070 7265 7669 6f75 URI has previou │ │ │ -001e5840: 736c 7920 6265 656e 0a75 7365 6420 6173 sly been.used as │ │ │ -001e5850: 2061 2073 7479 6c65 7368 6565 7420 616e a stylesheet an │ │ │ -001e5860: 6420 6861 7320 6e6f 7420 6265 656e 206d d has not been m │ │ │ -001e5870: 6172 6b65 6420 7374 616c 6520 7769 7468 arked stale with │ │ │ -001e5880: 0a3c 6675 6e63 7469 6f6e 3e78 736c 745f .xslt_ │ │ │ -001e5890: 7374 616c 6528 293c 2f66 756e 6374 696f stale(), Virtuoso wil │ │ │ -001e58b0: 6c20 7573 6520 7468 6520 6361 6368 6564 l use the cached │ │ │ -001e58c0: 2064 6174 610a 696e 7374 6561 6420 6f66 data.instead of │ │ │ -001e58d0: 2066 6574 6368 696e 6720 616e 6420 7061 fetching and pa │ │ │ -001e58e0: 7273 696e 6720 7468 6520 7374 796c 6573 rsing the styles │ │ │ -001e58f0: 6865 6574 2072 6573 6f75 7263 652e 0a3c heet resource..< │ │ │ -001e5900: 2f70 6172 613e 0a3c 7061 7261 3e0a 5768 /para>..Wh │ │ │ -001e5910: 656e 2061 2072 6573 6f75 7263 6520 7769 en a resource wi │ │ │ -001e5920: 7468 2061 202e 7873 6c20 6578 7465 6e73 th a .xsl extens │ │ │ -001e5930: 696f 6e20 6973 2073 746f 7265 6420 696e ion is stored in │ │ │ -001e5940: 746f 2074 6865 2057 6562 4441 562c 0a56 to the WebDAV,.V │ │ │ -001e5950: 6972 7475 6f73 6f20 6d61 726b 7320 6173 irtuoso marks as │ │ │ -001e5960: 2073 7461 6c65 2061 6e79 2072 656c 6174 stale any relat │ │ │ -001e5970: 6564 2063 6163 6865 6420 7265 736f 7572 ed cached resour │ │ │ -001e5980: 6365 2e20 2054 6865 2055 5249 2066 6f72 ce. The URI for │ │ │ -001e5990: 2073 7563 680a 7374 796c 6573 6865 6574 such.stylesheet │ │ │ -001e59a0: 7320 7769 6c6c 2062 650a 3c70 726f 6772 s will be.virt:/ │ │ │ -001e59c0: 2f57 532e 5753 2e53 5953 5f44 4156 5f52 /WS.WS.SYS_DAV_R │ │ │ -001e59d0: 4553 2e52 4553 5f46 554c 4c5f 5041 5448 ES.RES_FULL_PATH │ │ │ -001e59e0: 2e52 4553 5f43 4f4e 5445 4e54 3a26 6c74 .RES_CONTENT:< │ │ │ -001e59f0: 3b70 6174 6826 6774 3b3c 2f70 726f 6772 ;path>. See. │ │ │ -001e5a10: 7468 6520 7365 6374 696f 6e20 6162 6f75 the section abou │ │ │ -001e5a20: 7420 656e 7469 7479 2072 6566 6572 656e t entity referen │ │ │ -001e5a30: 6365 7320 696e 2073 746f 7265 6420 7465 ces in stored te │ │ │ -001e5a40: 7874 2066 6f72 206d 6f72 6520 6f6e 2074 xt for more on t │ │ │ -001e5a50: 6869 730a 7479 7065 206f 6620 5552 492e his.type of URI. │ │ │ -001e5a60: 2020 4966 2074 6865 2055 5249 2075 7365 If the URI use │ │ │ -001e5a70: 7320 7468 6520 6669 6c65 2070 726f 746f s the file proto │ │ │ -001e5a80: 636f 6c2c 2056 6972 7475 6f73 6f20 7769 col, Virtuoso wi │ │ │ -001e5a90: 6c6c 2063 6f6d 7061 7265 0a74 6865 2064 ll compare.the d │ │ │ -001e5aa0: 6174 6520 6f66 2074 6865 2066 696c 6520 ate of the file │ │ │ -001e5ab0: 6167 6169 6e73 7420 7468 6520 6461 7465 against the date │ │ │ -001e5ac0: 206f 6620 7468 6520 6361 6368 6564 2073 of the cached s │ │ │ -001e5ad0: 7479 6c65 7368 6565 742c 0a61 7574 6f6d tylesheet,.autom │ │ │ -001e5ae0: 6174 6963 616c 6c79 2072 656c 6f61 6469 atically reloadi │ │ │ -001e5af0: 6e67 2074 6865 2073 6865 6574 2069 6620 ng the sheet if │ │ │ -001e5b00: 7468 6520 6669 6c65 2063 6861 6e67 6573 the file changes │ │ │ -001e5b10: 2e20 2054 6869 7320 7072 6f74 6f63 6f6c . This protocol │ │ │ -001e5b20: 0a69 7320 7375 626a 6563 7420 746f 2074 .is subject to t │ │ │ -001e5b30: 6865 206c 696d 6974 6174 696f 6e73 206f he limitations o │ │ │ -001e5b40: 6e20 6669 6c65 2073 7973 7465 6d20 6163 n file system ac │ │ │ -001e5b50: 6365 7373 2069 6d70 6f73 6564 2062 7920 cess imposed by │ │ │ -001e5b60: 7468 650a 686f 7374 206f 7065 7261 7469 the.host operati │ │ │ -001e5b70: 6e67 2073 7973 7465 6d20 616e 6420 7468 ng system and th │ │ │ -001e5b80: 6520 7669 7274 756f 736f 2e69 6e69 2066 e virtuoso.ini f │ │ │ -001e5b90: 696c 6520 7379 7374 656d 2061 6363 6573 ile system acces │ │ │ -001e5ba0: 7320 636f 6e74 726f 6c0a 7365 7474 696e s control.settin │ │ │ -001e5bb0: 6773 2e0a 3c2f 7061 7261 3e0a 2020 3c2f gs... . Pa │ │ │ -001e5bf0: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ -001e5c00: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -001e5c10: 7469 746c 653e 7368 6565 745f 7572 693c title>sheet_uri< │ │ │ -001e5c20: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    URI pointing │ │ │ -001e5c40: 2074 6f20 7468 6520 6c6f 6361 7469 6f6e to the location │ │ │ -001e5c50: 206f 6620 616e 2058 534c 2073 7479 6c65 of an XSL style │ │ │ -001e5c60: 7368 6565 742e 3c2f 7061 7261 3e3c 2f72 sheet.. en │ │ │ -001e5c90: 7469 7479 3c2f 7469 746c 653e 0a20 2020 tity. │ │ │ -001e5ca0: 2020 203c 7061 7261 3e70 6172 7365 6420 parsed │ │ │ -001e5cb0: 584d 4c20 656e 7469 7479 2073 7563 6820 XML entity such │ │ │ -001e5cc0: 6173 2074 6861 7420 7265 7475 726e 6564 as that returned │ │ │ -001e5cd0: 2062 7920 7468 6520 7874 7265 655f 646f by the xtree_do │ │ │ -001e5ce0: 6328 2920 6675 6e63 7469 6f6e 3c2f 7061 c() function. │ │ │ -001e5d00: 2020 2020 3c72 6566 7365 6374 323e 3c74 sheet_param │ │ │ -001e5d20: 733c 2f74 6974 6c65 3e0a 2020 2020 2020 s. │ │ │ -001e5d30: 3c70 6172 613e 4120 7665 6374 6f72 206f A vector o │ │ │ -001e5d40: 6620 6b65 7977 6f72 642f 7661 6c75 6520 f keyword/value │ │ │ -001e5d50: 7061 7261 6d65 7465 7273 2074 6f20 6265 parameters to be │ │ │ -001e5d60: 2070 6173 7365 6420 746f 2074 6865 0a20 passed to the. │ │ │ -001e5d70: 2020 2058 534c 5420 656e 6769 6e65 2066 XSLT engine f │ │ │ -001e5d80: 6f72 2075 7365 2069 6e20 7468 6520 7472 or use in the tr │ │ │ -001e5d90: 616e 7366 6f72 6d61 7469 6f6e 2e3c 2f70 ansformation.

    . │ │ │ -001e5db0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001e5dc0: 7265 6673 6563 7431 2069 643d 2272 6574 refsect1 id="ret │ │ │ -001e5dd0: 5f78 736c 7422 3e3c 7469 746c 653e 5265 _xslt">Re │ │ │ -001e5de0: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ -001e5df0: 653e 3c70 6172 613e 416e 2058 4d4c 0a20 e><para>An XML. │ │ │ -001e5e00: 2065 6e74 6974 7920 7265 7375 6c74 696e entity resultin │ │ │ -001e5e10: 6720 6672 6f6d 2074 7261 6e73 666f 726d g from transform │ │ │ -001e5e20: 696e 6720 7468 6520 6769 7665 6e20 584d ing the given XM │ │ │ -001e5e30: 4c20 656e 7469 7479 2069 6e70 7574 2077 L entity input w │ │ │ -001e5e40: 6974 680a 2020 7468 6520 6769 7665 6e20 ith. the given │ │ │ -001e5e50: 7374 796c 6520 7368 6565 742e 3c2f 7061 style sheet.</pa │ │ │ -001e5e60: 7261 3e3c 2f72 6566 7365 6374 313e 0a3c ra></refsect1>.< │ │ │ -001e5e70: 212d 2d0a 2020 3c72 6566 7365 6374 3120 !--. <refsect1 │ │ │ -001e5e80: 6964 3d22 6572 726f 7273 5f78 736c 7422 id="errors_xslt" │ │ │ -001e5e90: 3e3c 7469 746c 653e 4572 726f 7273 3c2f ><title>Errors</ │ │ │ -001e5ea0: 7469 746c 653e 0a20 2020 203c 7461 626c title>. <tabl │ │ │ -001e5eb0: 653e 3c74 6974 6c65 3e45 7272 6f72 7320 e><title>Errors │ │ │ -001e5ec0: 7369 676e 616c 6c65 6420 6279 2078 736c signalled by xsl │ │ │ -001e5ed0: 7428 293c 2f74 6974 6c65 3e0a 2020 2020 t(). │ │ │ -001e5ee0: 2020 3c74 6772 6f75 7020 636f 6c73 3d22 .
    .. SQL StateError C │ │ │ -001e5f30: 6f64 653c 2f65 6e74 7279 3e3c 656e 7472 odeError TextDescr │ │ │ -001e5f60: 6970 7469 6f6e 3c2f 656e 7472 793e 3c2f iption. .... < │ │ │ -001e5f90: 726f 773e 0a09 2020 2020 3c65 6e74 7279 row>.. │ │ │ -001e5fc0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. .. │ │ │ -001e5ff0: 2020 3c65 6e74 7279 3e3c 6572 726f 726e │ │ │ -001e6010: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 .. .. │ │ │ -001e6030: 203c 2f72 6f77 3e0a 093c 2f74 626f 6479 ... .
    . │ │ │ -001e6060: 203c 2f72 6566 7365 6374 313e 0a2d 2d3e .--> │ │ │ -001e6070: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ -001e6090: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ -001e60a0: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -001e60b0: 6d70 6c65 2069 643d 2265 785f 7873 6c74 mple id="ex_xslt │ │ │ -001e60c0: 223e 3c74 6974 6c65 3e42 6173 6963 2055 "><title>Basic U │ │ │ -001e60d0: 7365 3c2f 7469 746c 653e 0a20 2020 2020 se. │ │ │ -001e60e0: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 .declare sheet, │ │ │ -001e6100: 2078 6d6c 2076 6172 6368 6172 3b0a 6465 xml varchar;.de │ │ │ -001e6110: 636c 6172 6520 786d 6c5f 656e 7469 7479 clare xml_entity │ │ │ -001e6120: 2c20 6d79 7061 7261 6d73 2061 6e79 3b0a , myparams any;. │ │ │ -001e6130: 0a73 6865 6574 203a 3d20 2776 6972 743a .sheet := 'virt: │ │ │ -001e6140: 2f2f 5753 2e57 532e 5359 535f 4441 565f //WS.WS.SYS_DAV_ │ │ │ -001e6150: 5245 532e 5245 535f 4655 4c4c 5f50 4154 RES.RES_FULL_PAT │ │ │ -001e6160: 482e 5245 535f 434f 4e54 454e 543a 2f44 H.RES_CONTENT:/D │ │ │ -001e6170: 4156 2f73 7479 6c65 7368 6565 7473 2f6d AV/stylesheets/m │ │ │ -001e6180: 7973 6865 6574 2e78 736c 273b 0a78 6d6c ysheet.xsl';.xml │ │ │ -001e6190: 203a 3d20 2776 6972 743a 2f2f 5753 2e57 := 'virt://WS.W │ │ │ -001e61a0: 532e 5359 535f 4441 565f 5245 532e 5245 S.SYS_DAV_RES.RE │ │ │ -001e61b0: 535f 4655 4c4c 5f50 4154 482e 5245 535f S_FULL_PATH.RES_ │ │ │ -001e61c0: 434f 4e54 454e 543a 2f44 4156 2f78 6d6c CONTENT:/DAV/xml │ │ │ -001e61d0: 736f 7572 6365 2f6d 7978 6d6c 2e78 6d6c source/myxml.xml │ │ │ -001e61e0: 273b 0a78 6d6c 5f65 6e74 6974 7920 3a3d ';.xml_entity := │ │ │ -001e61f0: 2078 7472 6565 5f64 6f63 2878 6d6c 293b xtree_doc(xml); │ │ │ -001e6200: 0a0a 6d79 7061 7261 6d73 203a 3d20 7665 ..myparams := ve │ │ │ -001e6210: 6374 6f72 2827 6368 6170 7465 7227 2c20 ctor('chapter', │ │ │ -001e6220: 276f 7665 7276 6965 7727 2c20 2769 6d67 'overview', 'img │ │ │ -001e6230: 726f 6f74 272c 2027 2f44 4156 2f69 6d61 root', '/DAV/ima │ │ │ -001e6240: 6765 732f 2729 3b0a 0a68 7474 705f 7661 ges/');..http_va │ │ │ -001e6250: 6c75 6528 7873 6c74 2873 6865 6574 2c20 lue(xslt(sheet, │ │ │ -001e6260: 786d 6c5f 656e 7469 7479 2c20 6d79 7061 xml_entity, mypa │ │ │ -001e6270: 7261 6d73 2929 3b0a 3c2f 7072 6f67 7261 rams));.. │ │ │ -001e6290: 3c70 6172 613e 5468 6973 2063 6f64 6520 This code │ │ │ -001e62a0: 7769 6c6c 2073 656e 6420 7468 6520 7265 will send the re │ │ │ -001e62b0: 7375 6c74 616e 7420 7472 616e 7366 6f72 sultant transfor │ │ │ -001e62c0: 6d61 7469 6f6e 2074 6f20 7468 650a 6874 mation to the.ht │ │ │ -001e62d0: 7470 2073 7472 6561 6d2e 2020 4e6f 7465 tp stream. Note │ │ │ -001e62e0: 2074 6861 7420 7468 6520 3c70 6172 616d that the xml_entity< │ │ │ -001e6300: 2f70 6172 616d 6574 6572 3e20 6d75 7374 /parameter> must │ │ │ -001e6310: 2062 650a 6120 7061 7273 6564 2058 4d4c be.a parsed XML │ │ │ -001e6320: 2065 6e74 6974 7920 7375 6368 2061 7320 entity such as │ │ │ -001e6330: 7468 6174 2070 726f 6475 6365 6420 6279 that produced by │ │ │ -001e6340: 0a3c 7061 7261 6d65 7465 723e 7874 7265 .xtre │ │ │ -001e6350: 655f 646f 633c 2f70 6172 616d 6574 6572 e_doc...<? │ │ │ -001e6380: 786d 6c20 7665 7273 696f 6e3d 2731 2e30 xml version='1.0 │ │ │ -001e6390: 273f 2667 743b 0a26 6c74 3b78 736c 3a73 '?>.<xsl:s │ │ │ -001e63a0: 7479 6c65 7368 6565 7420 786d 6c6e 733a tylesheet xmlns: │ │ │ -001e63b0: 7873 6c3d 2268 7474 703a 2f2f 7777 772e xsl="http://www. │ │ │ -001e63c0: 7733 2e6f 7267 2f54 522f 5744 2d78 736c w3.org/TR/WD-xsl │ │ │ -001e63d0: 2226 6774 3b0a 0a20 2026 6c74 3b78 736c ">.. <xsl │ │ │ -001e63e0: 3a70 6172 616d 206e 616d 653d 2263 6861 :param name="cha │ │ │ -001e63f0: 7074 6572 2226 6774 3b64 6566 6175 6c74 pter">default │ │ │ -001e6400: 266c 743b 2f78 736c 3a70 6172 616d 2667 </xsl:param&g │ │ │ -001e6410: 743b 0a20 2026 6c74 3b78 736c 3a70 6172 t;. <xsl:par │ │ │ -001e6420: 616d 206e 616d 653d 2269 6d67 726f 6f74 am name="imgroot │ │ │ -001e6430: 2226 6774 3b26 6c74 3b2f 7873 6c3a 7061 "></xsl:pa │ │ │ -001e6440: 7261 6d26 6774 3b0a 0a20 2026 6c74 3b78 ram>.. <x │ │ │ -001e6450: 736c 3a74 656d 706c 6174 6520 6d61 7463 sl:template matc │ │ │ -001e6460: 683d 222f 2226 6774 3b0a 2020 2020 266c h="/">. &l │ │ │ -001e6470: 743b 7873 6c3a 7465 7874 2667 743b 5661 t;xsl:text>Va │ │ │ -001e6480: 6c75 6520 6f66 2063 6861 7074 6572 3a20 lue of chapter: │ │ │ -001e6490: 266c 743b 2f78 736c 3a74 6578 7426 6774 </xsl:text> │ │ │ -001e64a0: 3b26 6c74 3b78 736c 3a76 616c 7565 2d6f ;<xsl:value-o │ │ │ -001e64b0: 6620 7365 6c65 6374 3d22 2463 6861 7074 f select="$chapt │ │ │ -001e64c0: 6572 2220 2f26 6774 3b0a 2020 2020 266c er" />. &l │ │ │ -001e64d0: 743b 7873 6c3a 7465 7874 2667 743b 5661 t;xsl:text>Va │ │ │ -001e64e0: 6c75 6520 6f66 2069 6d67 726f 6f74 3a20 lue of imgroot: │ │ │ -001e64f0: 266c 743b 2f78 736c 3a74 6578 7426 6774 </xsl:text> │ │ │ -001e6500: 3b26 6c74 3b78 736c 3a76 616c 7565 2d6f ;<xsl:value-o │ │ │ -001e6510: 6620 7365 6c65 6374 3d22 2469 6d67 726f f select="$imgro │ │ │ -001e6520: 6f74 2220 2f26 6774 3b0a 2020 266c 743b ot" />. < │ │ │ -001e6530: 2f78 736c 3a74 656d 706c 6174 6526 6774 /xsl:template> │ │ │ -001e6540: 3b0a 0a26 6c74 3b2f 7873 6c3a 7374 796c ;..</xsl:styl │ │ │ -001e6550: 6573 6865 6574 2667 743b 0a3c 2f70 726f esheet>...This style s │ │ │ -001e6580: 6865 6574 2069 6c6c 7573 7472 6174 6573 heet illustrates │ │ │ -001e6590: 2075 7369 6e67 2070 6172 616d 6574 6572 using parameter │ │ │ -001e65a0: 732e 2020 4e6f 7465 2068 6f77 2064 6566 s. Note how def │ │ │ -001e65b0: 6175 6c74 0a76 616c 7565 7320 6361 6e20 ault.values can │ │ │ -001e65c0: 6265 2070 726f 7669 6465 6420 696e 2074 be provided in t │ │ │ -001e65d0: 6865 2073 7479 6c65 2073 6865 6574 2077 he style sheet w │ │ │ -001e65e0: 6865 6e20 7468 6520 7061 7261 6d65 7465 hen the paramete │ │ │ -001e65f0: 7273 2061 7265 0a64 6563 6c61 7265 6420 rs are.declared │ │ │ -001e6600: 7573 696e 6720 7468 6520 3c70 6172 616d using the xsl:param tag.. │ │ │ -001e6630: 3c2f 7061 7261 3e0a 2020 2020 3c2f 6578 . . . See Al │ │ │ -001e6680: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ -001e6690: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xtre │ │ │ -001e66c0: 655f 646f 6328 293c 2f66 756e 6374 696f e_doc() │ │ │ -001e66e0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xper_doc()

    . < │ │ │ -001e6740: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001e6750: 5f78 6d6c 5f74 7265 655f 646f 6322 3e3c _xml_tree_doc">< │ │ │ -001e6760: 6675 6e63 7469 6f6e 3e78 6d6c 5f74 7265 function>xml_tre │ │ │ -001e6770: 655f 646f 6328 293c 2f66 756e 6374 696f e_doc() │ │ │ -001e6790: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xml_tree()

    . < │ │ │ -001e67f0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001e6800: 5f78 736c 745f 7374 616c 6522 3e3c 6675 _xslt_stale">xslt_stal │ │ │ -001e6820: 6528 293c 2f66 756e 6374 696f 6e3e 3c2f e()
    . │ │ │ -001e6840: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e XM │ │ │ -001e6870: 4c55 7064 6174 6528 293c 2f66 756e 6374 LUpdate().
    │ │ │ -001e68a0: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 .
    .... │ │ │ -001e68b0: 0000 2364 656d 6f2f 646f 6373 7263 2f66 ..#demo/docsrc/f │ │ │ -001e68c0: 756e 6372 6566 2f78 7175 6572 795f 6576 uncref/xquery_ev │ │ │ -001e68d0: 616c 2e78 6d6c df00 0019 7a3c 3f78 6d6c al.xml....z... . xquery_eva │ │ │ -001e6cb0: 6c3c 2f72 6566 656e 7472 7974 6974 6c65 l. xml. . │ │ │ -001e6d00: 0a20 2020 203c 7265 666e 616d 653e 7871 . xq │ │ │ -001e6d10: 7565 7279 5f65 7661 6c3c 2f72 6566 6e61 uery_eval. Applies an X │ │ │ -001e6d40: 5155 4552 5920 6578 7072 6573 7369 6f6e QUERY expression │ │ │ -001e6d50: 2074 6f20 6120 636f 6e74 6578 7420 6e6f to a context no │ │ │ -001e6d60: 6465 2061 6e64 2072 6574 7572 6e73 2072 de and returns r │ │ │ -001e6d70: 6573 756c 7428 7329 2e3c 2f72 6566 7075 esult(s).. . . . │ │ │ -001e6e00: 0a20 2020 2020 2020 203c 6675 6e63 6465 . xque │ │ │ -001e6e20: 7279 5f65 7661 6c3c 2f66 756e 6374 696f ry_eval. │ │ │ -001e6e40: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ -001e6e50: 6e20 3c70 6172 616d 6574 6572 3e78 7175 n xqu │ │ │ -001e6e60: 6572 795f 6578 7072 6573 7369 6f6e 3c2f ery_expression varch │ │ │ -001e6e80: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -001e6e90: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001e6ea0: 696e 203c 7061 7261 6d65 7465 723e 786d in xm │ │ │ -001e6eb0: 6c5f 7472 6565 3c2f 7061 7261 6d65 7465 l_tree XML Entity

    . │ │ │ -001e6ee0: 203c 7061 7261 6d64 6566 3e3c 6f70 7469 in index integer. i │ │ │ -001e6f50: 6e20 3c70 6172 616d 6574 6572 3e6e 616d n nam │ │ │ -001e6f60: 6564 5f70 6172 616d 733c 2f70 6172 616d ed_params vector. . . │ │ │ -001e6fc0: 3c2f 7265 6673 796e 6f70 7369 7364 6976 . D │ │ │ -001e6ff0: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ -001e7000: 653e 0a09 093c 7061 7261 3e0a 5468 6520 e>...<para>.The │ │ │ -001e7010: 7871 7565 7279 5f65 7661 6c20 6675 6e63 xquery_eval func │ │ │ -001e7020: 7469 6f6e 2072 6574 7572 6e73 2074 6865 tion returns the │ │ │ -001e7030: 2072 6573 756c 7420 6f66 2061 7070 6c79 result of apply │ │ │ -001e7040: 696e 6720 7468 6520 7871 7565 7279 2065 ing the xquery e │ │ │ -001e7050: 7870 7265 7373 696f 6e20 746f 2074 6865 xpression to the │ │ │ -001e7060: 0a63 6f6e 7465 7874 206e 6f64 652e 2020 .context node. │ │ │ -001e7070: 4279 2064 6566 6175 6c74 206f 6e6c 7920 By default only │ │ │ -001e7080: 7468 6520 6669 7273 7420 7265 7375 6c74 the first result │ │ │ -001e7090: 2069 7320 7265 7475 726e 6564 2c20 6275 is returned, bu │ │ │ -001e70a0: 7420 7375 7070 6c79 696e 6720 6120 7468 t supplying a th │ │ │ -001e70b0: 6972 6420 6172 6775 6d65 6e74 0a61 6c6c ird argument.all │ │ │ -001e70c0: 6f77 7320 796f 7520 746f 2073 7065 6369 ows you to speci │ │ │ -001e70d0: 6679 2061 6e20 696e 6465 7820 666f 7220 fy an index for │ │ │ -001e70e0: 7468 6520 7661 6c75 652c 2074 6865 2064 the value, the d │ │ │ -001e70f0: 6566 6175 6c74 2061 7373 756d 6573 2061 efault assumes a │ │ │ -001e7100: 2076 616c 7565 206f 6620 3120 6865 7265 value of 1 here │ │ │ -001e7110: 2e0a 4120 7661 6c75 6520 6f66 2030 2072 ..A value of 0 r │ │ │ -001e7120: 6574 7572 6e73 2061 6e20 6172 7261 7920 eturns an array │ │ │ -001e7130: 6f66 2030 206f 7220 6d6f 7265 2065 6c65 of 0 or more ele │ │ │ -001e7140: 6d65 6e74 732c 206f 6e65 2066 6f72 2065 ments, one for e │ │ │ -001e7150: 6163 6820 7661 6c75 6520 6361 6c63 756c ach value calcul │ │ │ -001e7160: 6174 6564 2062 7920 7468 650a 7871 7565 ated by the.xque │ │ │ -001e7170: 7279 2065 7870 7265 7373 696f 6e2e 0a09 ry expression... │ │ │ -001e7180: 3c2f 7061 7261 3e0a 093c 7061 7261 3e0a </para>..<para>. │ │ │ -001e7190: 5768 656e 2061 6e20 656e 7469 7479 2069 When an entity i │ │ │ -001e71a0: 7320 7265 7475 726e 6564 2069 6e20 6120 s returned in a │ │ │ -001e71b0: 7265 7375 6c74 2073 6574 2074 6f20 6120 result set to a │ │ │ -001e71c0: 636c 6965 6e74 2074 6865 2063 6c69 656e client the clien │ │ │ -001e71d0: 7420 7769 6c6c 2073 6565 2061 6e20 6e76 t will see an nv │ │ │ -001e71e0: 6172 6368 6172 2076 616c 7565 2063 6f6e archar value con │ │ │ -001e71f0: 7461 696e 696e 6720 7468 650a 7365 7269 taining the.seri │ │ │ -001e7200: 616c 697a 6174 696f 6e20 6f66 2074 6865 alization of the │ │ │ -001e7210: 2065 6e74 6974 792c 2063 6f6d 706c 6574 entity, complet │ │ │ -001e7220: 6520 7769 7468 206d 6172 6b75 702e 0a57 e with markup..W │ │ │ -001e7230: 6865 6e20 7468 6520 656e 7469 7479 2069 hen the entity i │ │ │ -001e7240: 7320 7061 7373 6564 2061 7320 6120 5351 s passed as a SQ │ │ │ -001e7250: 4c20 7661 6c75 6520 6974 2072 656d 6169 L value it remai │ │ │ -001e7260: 6e73 0a61 6e20 656e 7469 7479 2072 6566 ns.an entity ref │ │ │ -001e7270: 6572 656e 6369 6e67 2074 6865 206e 6f64 erencing the nod │ │ │ -001e7280: 6520 6f66 2061 2070 6172 7365 6420 584d e of a parsed XM │ │ │ -001e7290: 4c20 7472 6565 2c20 7065 726d 6974 7469 L tree, permitti │ │ │ -001e72a0: 6e67 206e 6176 6967 6174 696f 6e20 696e ng navigation in │ │ │ -001e72b0: 7369 6465 2074 6865 2074 7265 652e 0a09 side the tree... │ │ │ -001e72c0: 3c2f 7061 7261 3e0a 093c 7061 7261 3e0a </para>..<para>. │ │ │ -001e72d0: 5468 6520 6578 7072 6573 7369 6f6e 2063 The expression c │ │ │ -001e72e0: 616e 2062 6520 7061 7373 6564 2070 6172 an be passed par │ │ │ -001e72f0: 616d 6574 6572 7320 6279 2073 7065 6369 ameters by speci │ │ │ -001e7300: 6679 696e 6720 6120 666f 7572 7468 2061 fying a fourth a │ │ │ -001e7310: 7267 756d 656e 740a 746f 203c 6675 6e63 rgument.to <func │ │ │ -001e7320: 7469 6f6e 3e78 7175 6572 795f 6576 616c tion>xquery_eval │ │ │ -001e7330: 2829 3c2f 6675 6e63 7469 6f6e 3e2e 2020 ()</function>. │ │ │ -001e7340: 5468 6973 2077 696c 6c20 6265 2061 2076 This will be a v │ │ │ -001e7350: 6563 746f 7220 6f66 206e 616d 652f 7661 ector of name/va │ │ │ -001e7360: 6c75 650a 7061 6972 732e 2054 6865 2076 lue.pairs. The v │ │ │ -001e7370: 616c 7565 7320 6361 6e20 6265 2072 6566 alues can be ref │ │ │ -001e7380: 6572 656e 6365 6420 6672 6f6d 2069 6e73 erenced from ins │ │ │ -001e7390: 6964 6520 5850 6174 6820 6578 7072 6573 ide XPath expres │ │ │ -001e73a0: 7369 6f6e 2062 7920 7573 696e 670a 7468 sion by using.th │ │ │ -001e73b0: 6569 7220 6e61 6d65 7320 7769 7468 2027 eir names with ' │ │ │ -001e73c0: 2427 2070 7265 6669 782e 2059 6f75 206d $' prefix. You m │ │ │ -001e73d0: 6179 2075 7365 2061 6e79 2056 6972 7475 ay use any Virtu │ │ │ -001e73e0: 6f73 6f20 6461 7461 2074 7970 652e 0a54 oso data type..T │ │ │ -001e73f0: 6865 206e 616d 6573 2069 6e20 7468 6520 he names in the │ │ │ -001e7400: 7061 7261 6d65 7465 7220 7665 6374 6f72 parameter vector │ │ │ -001e7410: 2073 686f 756c 6420 6170 7065 6172 2077 should appear w │ │ │ -001e7420: 6974 686f 7574 2074 6865 2027 2427 2073 ithout the '$' s │ │ │ -001e7430: 6967 6e2e 0a49 6620 616e 7920 6f66 2074 ign..If any of t │ │ │ -001e7440: 6865 2070 6172 616d 6574 6572 2076 616c he parameter val │ │ │ -001e7450: 7565 7320 6973 204e 554c 4c20 7468 6520 ues is NULL the │ │ │ -001e7460: 7061 7261 6d65 7465 7220 7769 6c6c 2062 parameter will b │ │ │ -001e7470: 6520 6967 6e6f 7265 6420 6265 6361 7573 e ignored becaus │ │ │ -001e7480: 6520 4e55 4c4c 0a68 6173 206e 6f20 5850 e NULL.has no XP │ │ │ -001e7490: 6174 6820 636f 756e 7465 7270 6172 742e ath counterpart. │ │ │ -001e74a0: 0a49 6620 7468 6520 7361 6d65 206e 616d .If the same nam │ │ │ -001e74b0: 6520 6170 7065 6172 7320 6d6f 7265 2074 e appears more t │ │ │ -001e74c0: 6861 6e20 6f6e 6365 2069 6e20 7468 6520 han once in the │ │ │ -001e74d0: 7665 6374 6f72 2c20 7468 6520 6c61 7374 vector, the last │ │ │ -001e74e0: 206e 616d 652f 7661 6c75 6520 7061 6972 name/value pair │ │ │ -001e74f0: 2069 730a 7573 6564 2061 6e64 2061 6c6c is.used and all │ │ │ -001e7500: 2070 7265 6365 6469 6e67 2070 6169 7273 preceding pairs │ │ │ -001e7510: 2077 6974 6820 7468 6973 206e 616d 6520 with this name │ │ │ -001e7520: 6172 6520 7369 6c65 6e74 6c79 2069 676e are silently ign │ │ │ -001e7530: 6f72 6564 2e0a 4f62 7669 6f75 736c 792c ored..Obviously, │ │ │ -001e7540: 206e 616d 6573 2073 686f 756c 6420 6265 names should be │ │ │ -001e7550: 2073 7472 696e 6773 2074 6861 7420 6172 strings that ar │ │ │ -001e7560: 6520 7661 6c69 6420 5851 7565 7279 2076 e valid XQuery v │ │ │ -001e7570: 6172 6961 626c 6520 6e61 6d65 732e 0a3c ariable names..< │ │ │ -001e7580: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. </refse │ │ │ -001e7590: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ -001e75a0: 2069 643d 2270 6172 616d 7322 3e3c 7469 id="params"><ti │ │ │ -001e75b0: 746c 653e 5061 7261 6d65 7465 7273 3c2f tle>Parameters</ │ │ │ -001e75c0: 7469 746c 653e 0a20 2020 203c 7265 6673 title>. <refs │ │ │ -001e75d0: 6563 7432 3e3c 7469 746c 653e 7871 7565 ect2><title>xque │ │ │ -001e75e0: 7279 5f65 7870 7265 7373 696f 6e3c 2f74 ry_expression</t │ │ │ -001e75f0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001e7600: 613e 4120 7661 6c69 6420 5851 7565 7279 a>A valid XQuery │ │ │ -001e7610: 2065 7870 7265 7373 696f 6e2e 2049 6e20 expression. In │ │ │ -001e7620: 616c 6d6f 7374 2061 6c6c 2061 7070 6c69 almost all appli │ │ │ -001e7630: 6361 7469 6f6e 7320 7468 6973 2069 7320 cations this is │ │ │ -001e7640: 6120 7374 7269 6e67 2e0a 5468 6572 6520 a string..There │ │ │ -001e7650: 6973 2061 2074 7269 636b 7920 6578 7465 is a tricky exte │ │ │ -001e7660: 6e73 696f 6e20 7468 6174 2069 7320 7573 nsion that is us │ │ │ -001e7670: 6564 2062 7920 4250 454c 2d6c 696b 6520 ed by BPEL-like │ │ │ -001e7680: 6170 706c 6963 6174 696f 6e73 3a20 3c70 applications: <p │ │ │ -001e7690: 6172 616d 6574 6572 3e78 7061 7468 5f65 arameter>xpath_e │ │ │ -001e76a0: 7870 7265 7373 696f 6e3c 2f70 6172 616d xpression</param │ │ │ -001e76b0: 6574 6572 3e20 6361 6e20 6265 2061 6e20 eter> can be an │ │ │ -001e76c0: 584d 4c20 656e 7469 7479 0a77 686f 7374 XML entity.whost │ │ │ -001e76d0: 2073 7472 696e 672d 7661 6c75 6520 6973 string-value is │ │ │ -001e76e0: 2061 2076 616c 6964 2058 5175 6572 7920 a valid XQuery │ │ │ -001e76f0: 6578 7072 6573 7369 6f6e 2e20 416e 2065 expression. An e │ │ │ -001e7700: 7861 6d70 6c65 206f 6620 7375 6368 2061 xample of such a │ │ │ -001e7710: 6e20 656e 7469 7479 2069 7320 2671 756f n entity is &quo │ │ │ -001e7720: 743b 7365 6c65 6374 2671 756f 743b 206f t;select" o │ │ │ -001e7730: 7220 2671 756f 743b 7465 7374 2671 756f r "test&quo │ │ │ -001e7740: 743b 0a61 7474 7269 6275 7465 2069 6e20 t;.attribute in │ │ │ -001e7750: 5853 4c54 2073 7479 6c65 7368 6565 742e XSLT stylesheet. │ │ │ -001e7760: 2054 6869 7320 7472 6963 6b20 6c65 7473 This trick lets │ │ │ -001e7770: 2058 5175 6572 7920 7072 6f63 6573 736f XQuery processo │ │ │ -001e7780: 7220 746f 2072 6573 6f6c 7665 206e 616d r to resolve nam │ │ │ -001e7790: 6573 7061 6365 2070 7265 6669 7865 7320 espace prefixes │ │ │ -001e77a0: 6279 206c 6f6f 6b69 6e67 2061 7420 6e61 by looking at na │ │ │ -001e77b0: 6d65 7370 6163 6520 6465 636c 6172 6174 mespace declarat │ │ │ -001e77c0: 696f 6e73 0a61 7420 7468 6520 6865 6164 ions.at the head │ │ │ -001e77d0: 6572 206f 6620 7468 6520 7374 796c 6573 er of the styles │ │ │ -001e77e0: 6865 6574 2e3c 2f70 6172 613e 3c2f 7265 heet.</para></re │ │ │ -001e77f0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ -001e7800: 7365 6374 323e 3c74 6974 6c65 3e78 6d6c sect2><title>xml │ │ │ -001e7810: 5f74 7265 653c 2f74 6974 6c65 3e0a 2020 _tree. │ │ │ -001e7820: 2020 2020 3c70 6172 613e 416e 2058 4d4c An XML │ │ │ -001e7830: 2065 6e74 6974 7920 7375 6368 2061 7320 entity such as │ │ │ -001e7840: 7468 6174 2072 6574 7572 6e65 6420 6672 that returned fr │ │ │ -001e7850: 6f6d 2074 6865 203c 6675 6e63 7469 6f6e om the xtree_doc() function │ │ │ -001e7880: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .. index</ │ │ │ -001e78b0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -001e78c0: 7261 3e52 6573 756c 7420 696e 6465 782e ra>Result index. │ │ │ -001e78d0: 2020 5468 6973 2070 6172 616d 6574 6572 This parameter │ │ │ -001e78e0: 2069 7320 6f70 7469 6f6e 616c 2e20 2049 is optional. I │ │ │ -001e78f0: 6620 6f6d 6974 7465 6420 6120 7661 6c75 f omitted a valu │ │ │ -001e7900: 6520 6f66 2031 2069 7320 6173 7375 6d65 e of 1 is assume │ │ │ -001e7910: 642c 0a6d 6561 6e69 6e67 206f 6e6c 7920 d,.meaning only │ │ │ -001e7920: 7468 6520 6669 7273 7420 7265 7375 6c74 the first result │ │ │ -001e7930: 2069 7320 7265 7475 726e 6564 2e20 2049 is returned. I │ │ │ -001e7940: 6620 6120 7661 6c75 6520 6f66 2030 2069 f a value of 0 i │ │ │ -001e7950: 7320 7375 7070 6c69 6564 2074 6865 6e20 s supplied then │ │ │ -001e7960: 616e 2061 7272 6179 206f 6620 3020 6f72 an array of 0 or │ │ │ -001e7970: 206d 6f72 650a 7265 7375 6c74 7320 6973 more.results is │ │ │ -001e7980: 2072 6574 7572 6e65 6420 636f 6e74 6169 returned contai │ │ │ -001e7990: 6e69 6e67 206f 6e65 2065 6c65 6d65 6e74 ning one element │ │ │ -001e79a0: 2070 6572 2072 6573 756c 742e 2028 4e6f per result. (No │ │ │ -001e79b0: 7465 2074 6861 7420 7265 7375 6c74 7320 te that results │ │ │ -001e79c0: 6361 6e20 6265 2069 6e20 7475 726e 2073 can be in turn s │ │ │ -001e79d0: 6571 7565 6e63 6573 206f 6620 6174 6f6d equences of atom │ │ │ -001e79e0: 6963 2076 616c 7565 7329 2e3c 2f70 6172 ic values).</par │ │ │ -001e79f0: 613e 3c2f 7265 6673 6563 7432 3e0a 2020 a></refsect2>. │ │ │ -001e7a00: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ -001e7a10: 746c 653e 6e61 6d65 645f 7061 7261 6d73 tle>named_params │ │ │ -001e7a20: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -001e7a30: 7061 7261 3e41 2076 6563 746f 7220 6f66 para>A vector of │ │ │ -001e7a40: 206b 6579 776f 7264 2f76 616c 7565 2070 keyword/value p │ │ │ -001e7a50: 6172 616d 6574 6572 7320 746f 2062 6520 arameters to be │ │ │ -001e7a60: 7061 7373 6564 2074 6f20 7468 650a 2020 passed to the. │ │ │ -001e7a70: 2020 5851 7565 7279 2070 726f 6365 7373 XQuery process │ │ │ -001e7a80: 6f72 2e3c 2f70 6172 613e 3c2f 7265 6673 or.. . │ │ │ -001e7ac0: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ -001e7ad0: 746c 653e 3c70 6172 613e 5468 6973 2066 tle><para>This f │ │ │ -001e7ae0: 756e 6374 696f 6e20 7769 6c6c 2072 6574 unction will ret │ │ │ -001e7af0: 7572 6e20 7468 650a 6669 7273 7420 6f72 urn the.first or │ │ │ -001e7b00: 2069 6e64 6578 2073 656c 6563 7465 6420 index selected │ │ │ -001e7b10: 7265 7375 6c74 206f 6620 6170 706c 7969 result of applyi │ │ │ -001e7b20: 6e67 2074 6865 2078 7061 7468 2065 7870 ng the xpath exp │ │ │ -001e7b30: 7265 7373 696f 6e20 746f 2074 6865 203c ression to the < │ │ │ -001e7b40: 7061 7261 6d65 7465 723e 786d 6c5f 7472 parameter>xml_tr │ │ │ -001e7b50: 6565 3c2f 7061 7261 6d65 7465 723e 2069 ee</parameter> i │ │ │ -001e7b60: 6e70 7574 2e0a 4966 2061 6e20 696e 6465 nput..If an inde │ │ │ -001e7b70: 7820 7661 6c75 6520 6f66 2030 2069 7320 x value of 0 is │ │ │ -001e7b80: 7375 7070 6c69 6564 2074 6865 6e20 7468 supplied then th │ │ │ -001e7b90: 6520 6f75 7470 7574 2069 7320 616e 2061 e output is an a │ │ │ -001e7ba0: 7272 6179 2e3c 2f70 6172 613e 3c2f 7265 rray.</para></re │ │ │ -001e7bb0: 6673 6563 7431 3e0a 3c21 2d2d 0a20 203c fsect1>.<!--. < │ │ │ -001e7bc0: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ -001e7bd0: 6f72 7322 3e3c 7469 746c 653e 4572 726f ors"><title>Erro │ │ │ -001e7be0: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -001e7bf0: 7461 626c 653e 3c74 6974 6c65 3e45 7272 table>Err │ │ │ -001e7c00: 6f72 7320 7369 676e 616c 6c65 6420 6279 ors signalled by │ │ │ -001e7c10: 203c 2f74 6974 6c65 3e0a 2020 2020 2020 . │ │ │ -001e7c20: 3c74 6772 6f75 7020 636f 6c73 3d22 3422 . . │ │ │ -001e7c40: 0920 203c 726f 773e 3c65 6e74 7279 3e53 . S │ │ │ -001e7c50: 514c 2053 7461 7465 3c2f 656e 7472 793e QL State │ │ │ -001e7c60: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ -001e7c70: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ -001e7c80: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ -001e7ca0: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion. │ │ │ -001e7cc0: 0a09 3c74 626f 6479 3e0a 0920 203c 726f .... .. < │ │ │ -001e7ce0: 6572 726f 7263 6f64 653e 3c2f 6572 726f errorcode>.. │ │ │ -001e7d00: 2020 2020 3c65 6e74 7279 3e3c 6572 726f .. │ │ │ -001e7d30: 3c65 6e74 7279 3e3c 6572 726f 726e 616d .. .. < │ │ │ -001e7d70: 2f72 6f77 3e0a 093c 2f74 626f 6479 3e0a /row>... │ │ │ -001e7d80: 2020 2020 2020 3c2f 7467 726f 7570 3e0a . │ │ │ -001e7d90: 2020 2020 3c2f 7461 626c 653e 0a20 203c . < │ │ │ -001e7da0: 2f72 6566 7365 6374 313e 0a2d 2d3e 0a20 /refsect1>.-->. │ │ │ -001e7db0: 203c 7265 6673 6563 7431 2069 643d 2265 │ │ │ -001e7dd0: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ -001e7de0: 0a20 2020 203c 6578 616d 706c 6520 6964 . Finding │ │ │ -001e7e10: 2074 6865 2041 7574 686f 7273 206f 6620 the Authors of │ │ │ -001e7e20: 446f 6375 6d65 6e74 2054 6974 6c65 733c Document Titles< │ │ │ -001e7e30: 2f74 6974 6c65 3e0a 0909 3c70 726f 6772 /title>...<progr │ │ │ -001e7e40: 616d 6c69 7374 696e 673e 0a73 656c 6563 amlisting>.selec │ │ │ -001e7e50: 7420 7874 5f66 696c 652c 2078 7175 6572 t xt_file, xquer │ │ │ -001e7e60: 795f 6576 616c 2028 2661 706f 733b 266c y_eval ('&l │ │ │ -001e7e70: 743b 6175 7468 6f72 7326 6774 3b2f 2f61 t;authors>//a │ │ │ -001e7e80: 7574 686f 7226 6c74 3b2f 6175 7468 6f72 uthor</author │ │ │ -001e7e90: 7326 6774 3b26 6170 6f73 3b2c 2074 2920 s>', t) │ │ │ -001e7ea0: 6672 6f6d 2078 6d6c 5f74 6578 740a 0977 from xml_text..w │ │ │ -001e7eb0: 6865 7265 2078 7061 7468 5f63 6f6e 7461 here xpath_conta │ │ │ -001e7ec0: 696e 7320 2878 745f 7465 7874 2c20 2661 ins (xt_text, &a │ │ │ -001e7ed0: 706f 733b 2f2f 6368 6170 7465 722f 7469 pos;//chapter/ti │ │ │ -001e7ee0: 746c 655b 2e20 3d20 2661 706f 733b 496e tle[. = 'In │ │ │ -001e7ef0: 7472 6f64 7563 7469 6f6e 2661 706f 733b troduction' │ │ │ -001e7f00: 5d26 6170 6f73 3b2c 2074 293b 0a3c 2f70 ]', t);.</p │ │ │ -001e7f10: 726f 6772 616d 6c69 7374 696e 673e 0a09 rogramlisting>.. │ │ │ -001e7f20: 093c 7061 7261 3e0a 5468 6973 2077 696c .<para>.This wil │ │ │ -001e7f30: 6c20 7365 6c65 6374 2061 6c6c 2074 6974 l select all tit │ │ │ -001e7f40: 6c65 7320 7468 6174 2061 7265 2064 6573 les that are des │ │ │ -001e7f50: 6365 6e64 616e 7473 206f 6620 6368 6170 cendants of chap │ │ │ -001e7f60: 7465 7220 616e 6420 6861 7665 2061 2073 ter and have a s │ │ │ -001e7f70: 7472 696e 6720 7661 6c75 6520 6f66 0a26 tring value of.& │ │ │ -001e7f80: 6170 6f73 3b49 6e74 726f 6475 6374 696f apos;Introductio │ │ │ -001e7f90: 6e26 6170 6f73 3b2e 2020 5468 6973 2077 n'. This w │ │ │ -001e7fa0: 696c 6c20 6e65 7874 2065 7661 6c75 6174 ill next evaluat │ │ │ -001e7fb0: 6520 2f2f 6175 7468 6f72 2069 6e20 7468 e //author in th │ │ │ -001e7fc0: 6520 636f 6e74 6578 7420 6f66 2065 6163 e context of eac │ │ │ -001e7fd0: 682c 2072 6574 7269 6576 696e 6720 7468 h, retrieving th │ │ │ -001e7fe0: 650a 6175 7468 6f72 2065 6e74 6974 6965 e.author entitie │ │ │ -001e7ff0: 7320 696e 2074 6865 2064 6f63 756d 656e s in the documen │ │ │ -001e8000: 7420 6f66 2074 6865 2074 6974 6c65 2061 t of the title a │ │ │ -001e8010: 6e64 2063 6f6e 7374 7275 6374 2061 6e20 nd construct an │ │ │ -001e8020: 656c 656d 656e 7420 7768 6f73 6520 6e61 element whose na │ │ │ -001e8030: 6d65 2069 7320 2671 756f 743b 6175 7468 me is "auth │ │ │ -001e8040: 6f72 7326 7175 6f74 3b0a 616e 6420 6c69 ors".and li │ │ │ -001e8050: 7374 206f 6620 6368 696c 6472 656e 2063 st of children c │ │ │ -001e8060: 6f6e 7461 696e 7320 616c 6c20 7265 7472 ontains all retr │ │ │ -001e8070: 6965 7665 6420 656e 7469 7469 6573 2e0a ieved entities.. │ │ │ -001e8080: 093c 2f70 6172 613e 0a20 2020 203c 2f65 .</para>. </e │ │ │ -001e8090: 7861 6d70 6c65 3e0a 2020 3c2f 7265 6673 xample>. </refs │ │ │ -001e80a0: 6563 7431 3e0a 2020 3c72 6566 7365 6374 ect1>. <refsect │ │ │ -001e80b0: 3120 6964 3d22 7365 6561 6c73 6f22 3e3c 1 id="seealso">< │ │ │ -001e80c0: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also</ │ │ │ -001e80d0: 7469 746c 653e 0a20 2020 203c 7061 7261 title>. <para │ │ │ -001e80e0: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ -001e80f0: 666e 5f78 7061 7468 5f65 7661 6c22 3e3c fn_xpath_eval">< │ │ │ -001e8100: 6675 6e63 7469 6f6e 3e78 7061 7468 5f65 function>xpath_e │ │ │ -001e8110: 7661 6c28 293c 2f66 756e 6374 696f 6e3e val()</function> │ │ │ -001e8120: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ -001e8130: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ -001e8140: 696e 6b65 6e64 3d22 7870 6174 6863 6f6e inkend="xpathcon │ │ │ -001e8150: 7461 696e 7353 514c 5072 6564 223e 7870 tainsSQLPred">xp │ │ │ -001e8160: 6174 685f 636f 6e74 6169 6e73 2053 514c ath_contains SQL │ │ │ -001e8170: 2070 7265 6469 6361 7465 3c2f 6c69 6e6b predicate</link │ │ │ -001e8180: 3e3c 2f70 6172 613e 0a20 2020 203c 7061 ></para>. <pa │ │ │ -001e8190: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ -001e81a0: 3d22 7863 6f6e 7461 696e 7370 7265 6469 ="xcontainspredi │ │ │ -001e81b0: 6361 7465 223e 7863 6f6e 7461 696e 7320 cate">xcontains │ │ │ -001e81c0: 5351 4c20 7072 6564 6963 6174 653c 2f6c SQL predicate</l │ │ │ -001e81d0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ -001e81e0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ -001e81f0: 656e 643d 2278 7066 5f70 726f 6365 7373 end="xpf_process │ │ │ -001e8200: 5851 7565 7279 223e 3c66 756e 6374 696f XQuery"><functio │ │ │ -001e8210: 6e3e 7072 6f63 6573 7358 5175 6572 7928 n>processXQuery( │ │ │ -001e8220: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )</function></li │ │ │ -001e8230: 6e6b 3e3c 2f70 6172 613e 0a20 203c 2f72 nk></para>. </r │ │ │ -001e8240: 6566 7365 6374 313e 0a3c 2f72 6566 656e efsect1>.</refen │ │ │ -001e8250: 7472 793e 0ab6 0000 002c 6465 6d6f 2f64 try>.....,demo/d │ │ │ -001e8260: 6f63 7372 632f 6675 6e63 7265 662f 7870 ocsrc/funcref/xp │ │ │ -001e8270: 665f 6578 7465 6e73 696f 6e5f 7265 6d6f f_extension_remo │ │ │ -001e8280: 7665 2e78 6d6c df00 000c 033c 3f78 6d6c ve.xml.....<?xml │ │ │ -001e8290: 2076 6572 7369 6f6e 3d22 312e 3022 2065 version="1.0" e │ │ │ -001e82a0: 6e63 6f64 696e 673d 2249 534f 2d38 3835 ncoding="ISO-885 │ │ │ -001e82b0: 392d 3122 3f3e 0a3c 212d 2d20 0a20 2d20 9-1"?>.<!-- . - │ │ │ -001e82c0: 200a 202d 2020 5468 6973 2066 696c 6520 . - This file │ │ │ -001e82d0: 6973 2070 6172 7420 6f66 2074 6865 204f is part of the O │ │ │ -001e82e0: 7065 6e4c 696e 6b20 536f 6674 7761 7265 penLink Software │ │ │ -001e82f0: 2056 6972 7475 6f73 6f20 4f70 656e 2d53 Virtuoso Open-S │ │ │ -001e8300: 6f75 7263 6520 2856 4f53 290a 202d 2020 ource (VOS). - │ │ │ -001e8310: 7072 6f6a 6563 742e 0a20 2d20 200a 202d project.. - . - │ │ │ -001e8320: 2020 436f 7079 7269 6768 7420 2843 2920 Copyright (C) │ │ │ -001e8330: 3139 3938 2d32 3032 3420 4f70 656e 4c69 1998-2024 OpenLi │ │ │ -001e8340: 6e6b 2053 6f66 7477 6172 650a 202d 2020 nk Software. - │ │ │ -001e8350: 0a20 2d20 2054 6869 7320 7072 6f6a 6563 . - This projec │ │ │ -001e8360: 7420 6973 2066 7265 6520 736f 6674 7761 t is free softwa │ │ │ -001e8370: 7265 3b20 796f 7520 6361 6e20 7265 6469 re; you can redi │ │ │ -001e8380: 7374 7269 6275 7465 2069 7420 616e 642f stribute it and/ │ │ │ -001e8390: 6f72 206d 6f64 6966 7920 6974 0a20 2d20 or modify it. - │ │ │ -001e83a0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ -001e83b0: 206f 6620 7468 6520 474e 5520 4765 6e65 of the GNU Gene │ │ │ -001e83c0: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ -001e83d0: 7365 2061 7320 7075 626c 6973 6865 6420 se as published │ │ │ -001e83e0: 6279 2074 6865 0a20 2d20 2046 7265 6520 by the. - Free │ │ │ -001e83f0: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ -001e8400: 696f 6e3b 206f 6e6c 7920 7665 7273 696f ion; only versio │ │ │ -001e8410: 6e20 3220 6f66 2074 6865 204c 6963 656e n 2 of the Licen │ │ │ -001e8420: 7365 2c20 6461 7465 6420 4a75 6e65 2031 se, dated June 1 │ │ │ -001e8430: 3939 312e 0a20 2d20 200a 202d 2020 5468 991.. - . - Th │ │ │ -001e8440: 6973 2070 726f 6772 616d 2069 7320 6469 is program is di │ │ │ -001e8450: 7374 7269 6275 7465 6420 696e 2074 6865 stributed in the │ │ │ -001e8460: 2068 6f70 6520 7468 6174 2069 7420 7769 hope that it wi │ │ │ -001e8470: 6c6c 2062 6520 7573 6566 756c 2c20 6275 ll be useful, bu │ │ │ -001e8480: 740a 202d 2020 5749 5448 4f55 5420 414e t. - WITHOUT AN │ │ │ -001e8490: 5920 5741 5252 414e 5459 3b20 7769 7468 Y WARRANTY; with │ │ │ -001e84a0: 6f75 7420 6576 656e 2074 6865 2069 6d70 out even the imp │ │ │ -001e84b0: 6c69 6564 2077 6172 7261 6e74 7920 6f66 lied warranty of │ │ │ -001e84c0: 0a20 2d20 204d 4552 4348 414e 5441 4249 . - MERCHANTABI │ │ │ -001e84d0: 4c49 5459 206f 7220 4649 544e 4553 5320 LITY or FITNESS │ │ │ -001e84e0: 464f 5220 4120 5041 5254 4943 554c 4152 FOR A PARTICULAR │ │ │ -001e84f0: 2050 5552 504f 5345 2e20 5365 6520 7468 PURPOSE. See th │ │ │ -001e8500: 6520 474e 550a 202d 2020 4765 6e65 7261 e GNU. - Genera │ │ │ -001e8510: 6c20 5075 626c 6963 204c 6963 656e 7365 l Public License │ │ │ -001e8520: 2066 6f72 206d 6f72 6520 6465 7461 696c for more detail │ │ │ -001e8530: 732e 0a20 2d20 200a 202d 2020 596f 7520 s.. - . - You │ │ │ -001e8540: 7368 6f75 6c64 2068 6176 6520 7265 6365 should have rece │ │ │ -001e8550: 6976 6564 2061 2063 6f70 7920 6f66 2074 ived a copy of t │ │ │ -001e8560: 6865 2047 4e55 2047 656e 6572 616c 2050 he GNU General P │ │ │ -001e8570: 7562 6c69 6320 4c69 6365 6e73 6520 616c ublic License al │ │ │ -001e8580: 6f6e 670a 202d 2020 7769 7468 2074 6869 ong. - with thi │ │ │ -001e8590: 7320 7072 6f67 7261 6d3b 2069 6620 6e6f s program; if no │ │ │ -001e85a0: 742c 2077 7269 7465 2074 6f20 7468 6520 t, write to the │ │ │ -001e85b0: 4672 6565 2053 6f66 7477 6172 6520 466f Free Software Fo │ │ │ -001e85c0: 756e 6461 7469 6f6e 2c20 496e 632e 2c0a undation, Inc.,. │ │ │ -001e85d0: 202d 2020 3531 2046 7261 6e6b 6c69 6e20 - 51 Franklin │ │ │ -001e85e0: 5374 2c20 4669 6674 6820 466c 6f6f 722c St, Fifth Floor, │ │ │ -001e85f0: 2042 6f73 746f 6e2c 204d 4120 3032 3131 Boston, MA 0211 │ │ │ -001e8600: 302d 3133 3031 2055 5341 0a20 2d20 200a 0-1301 USA. - . │ │ │ -001e8610: 202d 2020 0a2d 2d3e 0a3c 7265 6665 6e74 - .-->.<refent │ │ │ -001e8620: 7279 2069 643d 2266 6e5f 7870 665f 6578 ry id="fn_xpf_ex │ │ │ -001e8630: 7465 6e73 696f 6e5f 7265 6d6f 7665 223e tension_remove"> │ │ │ -001e8640: 0a20 203c 7265 666d 6574 613e 200a 2020 . <refmeta> . │ │ │ -001e8650: 2020 3c72 6566 656e 7472 7974 6974 6c65 <refentrytitle │ │ │ -001e8660: 3e78 7066 5f65 7874 656e 7369 6f6e 5f72 >xpf_extension_r │ │ │ -001e8670: 656d 6f76 653c 2f72 6566 656e 7472 7974 emove</refentryt │ │ │ -001e8680: 6974 6c65 3e20 0a20 2020 203c 7265 666d itle> . <refm │ │ │ -001e8690: 6973 6369 6e66 6f3e 786d 6c3c 2f72 6566 iscinfo>xml</ref │ │ │ -001e86a0: 6d69 7363 696e 666f 3e0a 2020 3c2f 7265 miscinfo>. </re │ │ │ -001e86b0: 666d 6574 613e 200a 2020 3c72 6566 6e61 fmeta> . <refna │ │ │ -001e86c0: 6d65 6469 763e 200a 2020 2020 3c72 6566 mediv> . <ref │ │ │ -001e86d0: 6e61 6d65 3e78 7066 5f65 7874 656e 7369 name>xpf_extensi │ │ │ -001e86e0: 6f6e 5f72 656d 6f76 653c 2f72 6566 6e61 on_remove</refna │ │ │ -001e86f0: 6d65 3e20 0a20 2020 203c 7265 6670 7572 me> . <refpur │ │ │ -001e8700: 706f 7365 3e64 6973 6361 7264 7320 616e pose>discards an │ │ │ -001e8710: 2058 5061 7468 2065 7874 656e 7369 6f6e XPath extension │ │ │ -001e8720: 2066 756e 6374 696f 6e3c 2f72 6566 7075 function</refpu │ │ │ -001e8730: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ -001e8740: 6d65 6469 763e 200a 2020 3c72 6566 7379 mediv> . <refsy │ │ │ -001e8750: 6e6f 7073 6973 6469 763e 200a 2020 2020 nopsisdiv> . │ │ │ -001e8760: 3c66 756e 6373 796e 6f70 7369 7320 6964 <funcsynopsis id │ │ │ -001e8770: 3d22 6673 796e 5f78 7066 5f65 7874 656e ="fsyn_xpf_exten │ │ │ -001e8780: 7369 6f6e 5f72 656d 6f76 6522 3e0a 2020 sion_remove">. │ │ │ -001e8790: 2020 2020 3c66 756e 6370 726f 746f 7479 <funcprototy │ │ │ -001e87a0: 7065 2069 643d 2266 7072 6f74 6f5f 7870 pe id="fproto_xp │ │ │ -001e87b0: 665f 6578 7465 6e73 696f 6e5f 7265 6d6f f_extension_remo │ │ │ -001e87c0: 7665 223e 0a20 2020 2020 2020 203c 6675 ve">. <fu │ │ │ -001e87d0: 6e63 6465 663e 766f 6964 203c 6675 6e63 ncdef>void <func │ │ │ -001e87e0: 7469 6f6e 3e78 7066 5f65 7874 656e 7369 tion>xpf_extensi │ │ │ -001e87f0: 6f6e 5f72 656d 6f76 653c 2f66 756e 6374 on_remove</funct │ │ │ -001e8800: 696f 6e3e 3c2f 6675 6e63 6465 663e 200a ion></funcdef> . │ │ │ -001e8810: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .<paramdef>in <p │ │ │ -001e8820: 6172 616d 6574 6572 3e66 6e61 6d65 3c2f arameter>fname</ │ │ │ -001e8830: 7061 7261 6d65 7465 723e 2076 6172 6368 parameter> varch │ │ │ -001e8840: 6172 3c2f 7061 7261 6d64 6566 3e0a 093c ar</paramdef>..< │ │ │ -001e8850: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in <par │ │ │ -001e8860: 616d 6574 6572 3e70 726f 6365 6475 7265 ameter>procedure │ │ │ -001e8870: 5f6e 616d 653c 2f70 6172 616d 6574 6572 _name</parameter │ │ │ -001e8880: 3e20 7661 7263 6861 723c 2f70 6172 616d > varchar</param │ │ │ -001e8890: 6465 663e 0a20 2020 2020 203c 2f66 756e def>. </fun │ │ │ -001e88a0: 6370 726f 746f 7479 7065 3e0a 2020 2020 cprototype>. │ │ │ -001e88b0: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a </funcsynopsis>. │ │ │ -001e88c0: 2020 3c2f 7265 6673 796e 6f70 7369 7364 </refsynopsisd │ │ │ -001e88d0: 6976 3e0a 2020 3c72 6566 7365 6374 3120 iv>. <refsect1 │ │ │ -001e88e0: 6964 3d22 6465 7363 5f78 7066 5f65 7874 id="desc_xpf_ext │ │ │ -001e88f0: 656e 7369 6f6e 5f72 656d 6f76 6522 3e3c ension_remove">< │ │ │ -001e8900: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ -001e8910: 6e3c 2f74 6974 6c65 3e0a 2020 3c70 6172 n. Removes a user │ │ │ -001e8930: 2d64 6566 696e 6564 2058 5061 7468 2066 -defined XPath f │ │ │ -001e8940: 756e 6374 696f 6e2e 3c2f 7061 7261 3e0a unction.. │ │ │ -001e8950: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -001e8960: 3c72 6566 7365 6374 3120 6964 3d22 7061 Parameters. fname< │ │ │ -001e89c0: 2f74 6974 6c65 3e20 3c70 6172 613e 5468 /title> <para>Th │ │ │ -001e89d0: 6520 6578 7061 6e64 6564 2051 4e61 6d65 e expanded QName │ │ │ -001e89e0: 206f 6620 7468 650a 2020 2020 6578 7465 of the. exte │ │ │ -001e89f0: 6e73 696f 6e20 6675 6e63 7469 6f6e 2074 nsion function t │ │ │ -001e8a00: 6f20 6265 2072 656d 6f76 6564 3c2f 7061 o be removed</pa │ │ │ -001e8a10: 7261 3e3c 2f72 6566 7365 6374 323e 0a20 ra></refsect2>. │ │ │ -001e8a20: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ -001e8a30: 746c 653e 7072 6f63 6564 7572 655f 6e61 tle>procedure_na │ │ │ -001e8a40: 6d65 3c2f 7469 746c 653e 203c 7061 7261 me The fully quali │ │ │ -001e8a60: 6669 6564 0a20 2020 206e 616d 6520 6f66 fied. name of │ │ │ -001e8a70: 2074 6865 2050 4c20 7072 6f63 6564 7572 the PL procedur │ │ │ -001e8a80: 6520 7768 6963 6820 6163 7473 2061 7320 e which acts as │ │ │ -001e8a90: 7468 6520 6578 7465 6e73 696f 6e0a 2020 the extension. │ │ │ -001e8aa0: 2020 6675 6e63 7469 6f6e 2e3c 2f70 6172 function.. │ │ │ -001e8ac0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . Ret │ │ │ -001e8b00: 7572 6e20 5479 7065 733c 2f74 6974 6c65 urn Types. None ( │ │ │ -001e8b20: 766f 6964 292e 3c2f 7061 7261 3e3c 2f72 void). . Er │ │ │ -001e8b70: 726f 7273 3c2f 7469 746c 653e 0a20 2020 rors. │ │ │ -001e8b80: 203c 7461 626c 653e 3c74 6974 6c65 3e45 E │ │ │ -001e8b90: 7272 6f72 7320 7369 676e 616c 6c65 6420 rrors signalled │ │ │ -001e8ba0: 6279 3c2f 7469 746c 653e 0a20 2020 2020 by. │ │ │ -001e8bb0: 203c 7467 726f 7570 2063 6f6c 733d 2234 . SQL │ │ │ -001e8be0: 5374 6174 653c 2f65 6e74 7279 3e3c 656e StateError CodeErr │ │ │ -001e8c10: 6f72 2054 6578 743c 2f65 6e74 7279 3e3c or Text< │ │ │ -001e8c20: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ -001e8c30: 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e3c n< │ │ │ -001e8c40: 2f74 6865 6164 3e0a 093c 7462 6f64 793e /thead>.. │ │ │ -001e8c50: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ -001e8c60: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>42001.. │ │ │ -001e8c90: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 XPE03.. │ │ │ -001e8cc0: 203c 656e 7472 793e 3c65 7272 6f72 6e61 function │ │ │ -001e8d00: 2022 3c66 756e 6320 6e61 6d65 3e22 2063 "" c │ │ │ -001e8d10: 616e 6e6f 7420 6265 2072 656d 6f76 6564 annot be removed │ │ │ -001e8d20: 5d5d 3e3c 2f65 7272 6f72 6e61 6d65 3e3c ]]>< │ │ │ -001e8d30: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. if XPATH or │ │ │ -001e8d50: 5851 5545 5259 2066 756e 6374 696f 6e20 XQUERY function │ │ │ -001e8d60: 746f 2062 6520 756e 2d72 6567 6973 7465 to be un-registe │ │ │ -001e8d70: 7265 6420 6973 2061 2063 6f72 6520 6675 red is a core fu │ │ │ -001e8d80: 6e63 7469 6f6e 2e3c 2f65 6e74 7279 3e0a nction.. │ │ │ -001e8d90: 0920 203c 2f72 6f77 3e0a 093c 2f74 626f . ... .
    │ │ │ -001e8dc0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 .
    . │ │ │ -001e8dd0: 203c 7265 6673 6563 7431 2069 643d 2273 See Also. < │ │ │ -001e8e20: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001e8e30: 5f78 7066 5f65 7874 656e 7369 6f6e 223e _xpf_extension"> │ │ │ -001e8e40: 3c66 756e 6374 696f 6e3e 7870 665f 6578 xpf_ex │ │ │ -001e8e50: 7465 6e73 696f 6e28 293c 2f66 756e 6374 tension(). │ │ │ -001e8e80: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 .
    .... │ │ │ -001e8e90: 0000 2564 656d 6f2f 646f 6373 7263 2f66 ..%demo/docsrc/f │ │ │ -001e8ea0: 756e 6372 6566 2f78 7066 5f65 7874 656e uncref/xpf_exten │ │ │ -001e8eb0: 7369 6f6e 2e78 6d6c df00 0017 a23c 3f78 sion.xml........ . xpf_ │ │ │ -001e9290: 6578 7465 6e73 696f 6e3c 2f72 6566 656e extension . < │ │ │ -001e92b0: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ -001e92c0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001e92d0: 3c2f 7265 666d 6574 613e 200a 2020 3c72 . . │ │ │ -001e92f0: 3c72 6566 6e61 6d65 3e78 7066 5f65 7874 xpf_ext │ │ │ -001e9300: 656e 7369 6f6e 3c2f 7265 666e 616d 653e ension │ │ │ -001e9310: 200a 2020 2020 3c72 6566 7075 7270 6f73 . declare an XPa │ │ │ -001e9330: 7468 2065 7874 656e 7369 6f6e 2066 756e th extension fun │ │ │ -001e9340: 6374 696f 6e20 3c2f 7265 6670 7572 706f ction . . . . . void xpf_extensio │ │ │ -001e9400: 6e3c 2f66 756e 6374 696f 6e3e 3c2f 6675 n
    ..in fname varchar..in p │ │ │ -001e9470: 726f 6365 6475 7265 5f6e 616d 653c 2f70 rocedure_name

    varcha │ │ │ -001e9490: 723c 2f70 6172 616d 6465 663e 0a20 2020 r
    . │ │ │ -001e94a0: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . │ │ │ -001e9500: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ -001e9510: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ -001e9520: 7061 7261 3e0a 2020 2020 5468 6973 2066 para>. This f │ │ │ -001e9530: 756e 6374 696f 6e20 6973 2075 7365 6420 unction is used │ │ │ -001e9540: 746f 2064 6563 6c61 7265 2061 206e 6577 to declare a new │ │ │ -001e9550: 2058 5061 7468 2065 7874 656e 7369 6f6e XPath extension │ │ │ -001e9560: 2066 756e 6374 696f 6e20 6f72 0a72 6564 function or.red │ │ │ -001e9570: 6566 696e 6520 616e 2065 7869 7374 696e efine an existin │ │ │ -001e9580: 6720 6675 6e63 7469 6f6e 2e20 2049 7420 g function. It │ │ │ -001e9590: 6361 6e20 6265 2075 7365 6420 696e 2058 can be used in X │ │ │ -001e95a0: 5061 7468 2071 7565 7269 6573 2061 6e64 Path queries and │ │ │ -001e95b0: 0a58 534c 5420 7374 796c 6573 6865 6574 .XSLT stylesheet │ │ │ -001e95c0: 732e 2020 596f 7520 7368 6f75 6c64 2075 s. You should u │ │ │ -001e95d0: 7365 2051 4e61 6d65 7320 666f 7220 6578 se QNames for ex │ │ │ -001e95e0: 7465 6e73 696f 6e20 6675 6e63 7469 6f6e tension function │ │ │ -001e95f0: 732e 0a4e 6f74 6520 7468 6174 2074 6865 s..Note that the │ │ │ -001e9600: 2073 7461 6e64 6172 6420 5850 6174 6820 standard XPath │ │ │ -001e9610: 6675 6e63 7469 6f6e 7320 6361 6e6e 6f74 functions cannot │ │ │ -001e9620: 2062 6520 7265 6465 6669 6e65 642e 3c2f be redefined...xpf_exten │ │ │ -001e9650: 7369 6f6e 2829 3c2f 6675 6e63 7469 6f6e sion() stores the fun │ │ │ -001e9670: 6374 696f 6e73 2069 6e74 6f0a 7468 6520 ctions into.the │ │ │ -001e9680: 5359 535f 5850 465f 4558 5445 4e53 494f SYS_XPF_EXTENSIO │ │ │ -001e9690: 4e53 2073 7973 7465 6d20 7461 626c 652e NS system table. │ │ │ -001e96a0: 0a20 2020 203c 2f70 6172 613e 0a20 2020 . . │ │ │ -001e96b0: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 . CREATE T │ │ │ -001e96d0: 4142 4c45 200a 2020 2020 2020 2020 4442 ABLE . DB │ │ │ -001e96e0: 2e44 4241 2e53 5953 5f58 5046 5f45 5854 .DBA.SYS_XPF_EXT │ │ │ -001e96f0: 454e 5349 4f4e 5320 280a 0920 2020 2058 ENSIONS (.. X │ │ │ -001e9700: 5045 5f4e 414d 4520 5641 5243 4841 5220 PE_NAME VARCHAR │ │ │ -001e9710: 5052 494d 4152 5920 4b45 592c 200a 0920 PRIMARY KEY, .. │ │ │ -001e9720: 2020 2058 5045 5f50 4e41 4d45 2056 4152 XPE_PNAME VAR │ │ │ -001e9730: 4348 4152 0a09 2020 2020 290a 2020 2020 CHAR.. ). │ │ │ -001e9740: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 .. . │ │ │ -001e9760: 2020 5468 6520 696e 7075 7420 7061 7261 The input para │ │ │ -001e9770: 6d65 7465 7273 2077 696c 6c20 6265 2072 meters will be r │ │ │ -001e9780: 6574 7269 6576 6564 2061 7320 6120 7374 etrieved as a st │ │ │ -001e9790: 7269 6e67 7320 616e 6420 7468 656e 2077 rings and then w │ │ │ -001e97a0: 696c 6c20 6265 2063 6f6e 7665 7274 6564 ill be converted │ │ │ -001e97b0: 2074 6f20 7468 6520 6461 7461 7479 7065 to the datatype │ │ │ -001e97c0: 206f 6620 0a20 2020 2074 6865 2063 6f72 of . the cor │ │ │ -001e97d0: 7265 7370 6f6e 6469 6e67 2061 7267 756d responding argum │ │ │ -001e97e0: 656e 7420 6f66 2074 6865 2073 746f 7265 ent of the store │ │ │ -001e97f0: 6420 7072 6f63 6564 7572 652e 200a 2020 d procedure. . │ │ │ -001e9800: 2020 3c2f 7061 7261 3e0a 2020 2020 0a20 . . │ │ │ -001e9810: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -001e9820: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -001e9830: 616d 735f 7870 665f 6578 7465 6e73 696f ams_xpf_extensio │ │ │ -001e9840: 6e22 3e3c 7469 746c 653e 5061 7261 6d65 n">Parame │ │ │ -001e9850: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -001e9860: 203c 7265 6673 6563 7432 3e3c 7469 746c fname. │ │ │ -001e9880: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -001e9890: 6e61 6d65 206f 6620 7468 6520 6578 7465 name of the exte │ │ │ -001e98a0: 6e73 696f 6e20 6675 6e63 7469 6f6e 2c20 nsion function, │ │ │ -001e98b0: 7768 6963 6820 6d75 7374 2062 6520 7468 which must be th │ │ │ -001e98c0: 6520 6578 7061 6e64 6564 2051 4e61 6d65 e expanded QName │ │ │ -001e98d0: 200a 2020 2020 2020 6f66 2074 6865 2065 . of the e │ │ │ -001e98e0: 7874 656e 7369 6f6e 2066 756e 6374 696f xtension functio │ │ │ -001e98f0: 6e3c 2f70 6172 613e 3c2f 7265 6673 6563 n. procedu │ │ │ -001e9920: 7265 5f6e 616d 653c 2f74 6974 6c65 3e0a re_name. │ │ │ -001e9930: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -001e9940: 6675 6c6c 7920 7175 616c 6966 6965 6420 fully qualified │ │ │ -001e9950: 6e61 6d65 206f 6620 7468 6520 504c 2070 name of the PL p │ │ │ -001e9960: 726f 6365 6475 7265 2077 6869 6368 2061 rocedure which a │ │ │ -001e9970: 6374 7320 6173 200a 2020 2020 2020 7468 cts as . th │ │ │ -001e9980: 6520 6578 7465 6e73 696f 6e20 6675 6e63 e extension func │ │ │ -001e9990: 7469 6f6e 2e20 5468 6520 7072 6f63 6564 tion. The proced │ │ │ -001e99a0: 7572 6520 696e 2071 7565 7374 696f 6e20 ure in question │ │ │ -001e99b0: 6d75 7374 2062 6520 6772 616e 7465 6420 must be granted │ │ │ -001e99c0: 746f 2050 5542 4c49 432c 0a20 2020 2020 to PUBLIC,. │ │ │ -001e99d0: 206f 7468 6572 7769 7365 2069 7420 7769 otherwise it wi │ │ │ -001e99e0: 6c6c 206e 6f74 2062 6520 7265 6769 7374 ll not be regist │ │ │ -001e99f0: 6572 6564 2061 6e64 2065 7272 6f72 2077 ered and error w │ │ │ -001e9a00: 696c 6c20 6265 2073 6967 6e61 6c6c 6564 ill be signalled │ │ │ -001e9a10: 2e20 0a20 2020 2020 203c 2f70 6172 613e . . │ │ │ -001e9a20: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f . . Return Types │ │ │ -001e9a70: 3c2f 7469 746c 653e 0a20 203c 7061 7261 . None (void).

    │ │ │ -001e9aa0: 0a20 203c 7265 6673 6563 7431 2069 643d . Er │ │ │ -001e9ad0: 726f 7273 3c2f 7469 746c 653e 0a20 2020 rors. │ │ │ -001e9ae0: 203c 7461 626c 653e 3c74 6974 6c65 3e45 E │ │ │ -001e9af0: 7272 6f72 7320 7369 676e 616c 6c65 6420 rrors signalled │ │ │ -001e9b00: 6279 3c2f 7469 746c 653e 0a20 2020 2020 by. │ │ │ -001e9b10: 203c 7467 726f 7570 2063 6f6c 733d 2234 . SQL │ │ │ -001e9b40: 5374 6174 653c 2f65 6e74 7279 3e3c 656e StateError CodeErr │ │ │ -001e9b70: 6f72 2054 6578 743c 2f65 6e74 7279 3e3c or Text< │ │ │ -001e9b80: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ -001e9b90: 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e3c n< │ │ │ -001e9ba0: 2f74 6865 6164 3e0a 093c 7462 6f64 793e /thead>.. │ │ │ -001e9bb0: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ -001e9bc0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>42001.. │ │ │ -001e9bf0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 XPE01.. │ │ │ -001e9c20: 203c 656e 7472 793e 3c65 7272 6f72 6e61 The function │ │ │ -001e9c40: 266c 743b 7072 6f63 6564 7572 655f 6e61 <procedure_na │ │ │ -001e9c50: 6d65 2667 743b 2064 6f65 7320 6e6f 7420 me> does not │ │ │ -001e9c60: 6578 6973 743c 2f65 7272 6f72 6e61 6d65 exist.. < │ │ │ -001e9c80: 656e 7472 793e 6966 2070 726f 6365 6475 entry>if procedu │ │ │ -001e9c90: 7265 2074 6f20 6465 6669 6e65 2061 7320 re to define as │ │ │ -001e9ca0: 6120 5850 4154 4820 6578 7465 6e73 696f a XPATH extensio │ │ │ -001e9cb0: 6e20 6675 6e63 7469 6f6e 2069 7320 6e6f n function is no │ │ │ -001e9cc0: 7420 6578 6973 7469 6e67 206f 6e65 2e3c t existing one.< │ │ │ -001e9cd0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ -001e9cf0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 42001.. │ │ │ -001e9d20: 203c 656e 7472 793e 3c65 7272 6f72 636f XPE02.. │ │ │ -001e9d50: 2020 3c65 6e74 7279 3e3c 6572 726f 726e functio │ │ │ -001e9d90: 6e20 223c 6675 6e63 206e 616d 653e 2220 n "" │ │ │ -001e9da0: 6361 6e6e 6f74 2062 6520 7265 2d64 6566 cannot be re-def │ │ │ -001e9db0: 696e 6564 5d5d 3e3c 2f65 7272 6f72 6e61 ined]]>.. │ │ │ -001e9dd0: 203c 656e 7472 793e 6966 2058 5041 5448 if XPATH │ │ │ -001e9de0: 206f 7220 5851 5545 5259 2066 756e 6374 or XQUERY funct │ │ │ -001e9df0: 696f 6e20 746f 2062 6520 7265 6769 7374 ion to be regist │ │ │ -001e9e00: 6572 6564 2069 7320 6120 636f 7265 2066 ered is a core f │ │ │ -001e9e10: 756e 6374 696f 6e2e 3c2f 656e 7472 793e unction. │ │ │ -001e9e20: 0a09 2020 3c2f 726f 773e 0a09 3c2f 7462 .. ... .
    .
    . │ │ │ -001e9e60: 2020 3c72 6566 7365 6374 3120 6964 3d22 E │ │ │ -001e9e90: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ -001e9ea0: 2020 2020 3c65 7861 6d70 6c65 2069 643d Declar │ │ │ -001e9ed0: 696e 6720 6120 4e65 7720 5853 4c54 2046 ing a New XSLT F │ │ │ -001e9ee0: 756e 6374 696f 6e3c 2f74 6974 6c65 3e0a unction. │ │ │ -001e9ef0: 0a3c 7061 7261 3e46 6972 7374 2064 6566 .First def │ │ │ -001e9f00: 696e 6520 6120 504c 2070 726f 6365 6475 ine a PL procedu │ │ │ -001e9f10: 7265 2c20 7468 656e 2064 6563 6c61 7265 re, then declare │ │ │ -001e9f20: 2061 6e20 5850 6174 6820 6578 7465 6e73 an XPath extens │ │ │ -001e9f30: 696f 6e0a 6675 6e63 7469 6f6e 2061 6e64 ion.function and │ │ │ -001e9f40: 2074 6f20 7265 7072 6573 656e 7420 6974 to represent it │ │ │ -001e9f50: 2e3c 2f70 6172 613e 0a0a 3c70 726f 6772 .... create │ │ │ -001e9f80: 2070 726f 6365 6475 7265 2044 422e 4442 procedure DB.DB │ │ │ -001e9f90: 412e 7374 725f 636f 6e63 6174 2028 696e A.str_concat (in │ │ │ -001e9fa0: 2061 2076 6172 6368 6172 2c20 696e 2062 a varchar, in b │ │ │ -001e9fb0: 2076 6172 6368 6172 290a 2020 2020 207b varchar). { │ │ │ -001e9fc0: 0a20 2020 2020 2020 7265 7475 726e 2063 . return c │ │ │ -001e9fd0: 6f6e 6361 7420 2861 2c20 273a 272c 2062 oncat (a, ':', b │ │ │ -001e9fe0: 293b 0a20 2020 2020 7d3b 0a0a 5351 4c3e );. };..SQL> │ │ │ -001e9ff0: 2078 7066 5f65 7874 656e 7369 6f6e 2028 xpf_extension ( │ │ │ -001ea000: 2768 7474 703a 2f2f 6578 616d 706c 652e 'http://example. │ │ │ -001ea010: 636f 6d2f 7669 7274 756f 736f 2f78 736c com/virtuoso/xsl │ │ │ -001ea020: 743a 636f 6e63 6174 5f73 7472 696e 6773 t:concat_strings │ │ │ -001ea030: 272c 2027 4442 2e44 4241 2e73 7472 5f63 ', 'DB.DBA.str_c │ │ │ -001ea040: 6f6e 6361 7427 293b 0a5d 5d3e 0a3c 2f70 oncat');.]]>.

    .. │ │ │ -001ea060: 3c70 6172 613e 2054 6865 2073 6f75 7263 The sourc │ │ │ -001ea070: 6520 6f66 2074 6865 2028 5b68 7474 705f e of the ([http_ │ │ │ -001ea080: 726f 6f74 5d2f 6578 742e 7873 6c29 2058 root]/ext.xsl) X │ │ │ -001ea090: 534c 5420 7374 796c 6573 6865 6574 203c SLT stylesheet < │ │ │ -001ea0a0: 2f70 6172 613e 0a0a 3c70 726f 6772 616d /para>..... │ │ │ -001ea160: 0a20 2020 203c 4854 4d4c 3e0a 2020 2020 . . │ │ │ -001ea170: 203c 424f 4459 3e0a 2020 2020 203c 7873 . . . . . │ │ │ -001ea220: 0a20 203c 2f78 736c 3a74 656d 706c 6174 . ..]]>.
    ..The source of │ │ │ -001ea270: 7468 650a 3c70 726f 6772 616d 6c69 7374 the.([http_root] │ │ │ -001ea290: 2f65 7874 2e76 7370 293c 2f70 726f 6772 /ext.vsp) VSP p │ │ │ -001ea2b0: 6167 653a 0a3c 2f70 6172 613e 0a0a 3c70 age:.
    ..

    .< │ │ │ -001ea2d0: 215b 4344 4154 415b 0a3c 3f76 7370 0a20 ![CDATA[. │ │ │ -001ea300: 0a3c 646f 633e 0a3c 612f 3e0a 3c2f 646f ....]]>... │ │ │ -001ea330: 0a54 6869 7320 7769 6c6c 2070 726f 6475 .This will produ │ │ │ -001ea340: 6365 2074 6865 2066 6f6c 6c6f 7769 6e67 ce the following │ │ │ -001ea350: 2048 544d 4c20 7061 6765 3a0a 3c2f 7061 HTML page:....<HTML&g │ │ │ -001ea380: 743b 266c 743b 424f 4459 2667 743b 666f t;<BODY>fo │ │ │ -001ea390: 6f3a 6261 7226 6c74 3b2f 424f 4459 2667 o:bar</BODY&g │ │ │ -001ea3a0: 743b 266c 743b 2f48 544d 4c26 6774 3b0a t;</HTML>. │ │ │ -001ea3b0: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 ..Using t │ │ │ -001ea3d0: 6865 2064 6566 696e 6974 696f 6e20 6f66 he definition of │ │ │ -001ea3e0: 2074 6865 2058 5061 7468 2065 7874 656e the XPath exten │ │ │ -001ea3f0: 7369 6f6e 2066 756e 6374 696f 6e2c 2077 sion function, w │ │ │ -001ea400: 6520 6361 6e0a 696e 636c 7564 6520 6974 e can.include it │ │ │ -001ea410: 2069 6e20 5850 6174 6820 6578 7072 6573 in XPath expres │ │ │ -001ea420: 7369 6f6e 732e 3c2f 7061 7261 3e0a 0a3c sions...< │ │ │ -001ea430: 7072 6f67 7261 6d6c 6973 7469 6e67 3e0a programlisting>. │ │ │ -001ea440: 5351 4c3e 2073 656c 6563 7420 7020 6672 SQL> select p fr │ │ │ -001ea450: 6f6d 2077 732e 2e73 7973 5f64 6176 5f72 om ws..sys_dav_r │ │ │ -001ea460: 6573 0a77 6865 7265 2078 7061 7468 5f63 es.where xpath_c │ │ │ -001ea470: 6f6e 7461 696e 7320 2852 4553 5f43 4f4e ontains (RES_CON │ │ │ -001ea480: 5445 4e54 2c0a 275b 786d 6c6e 733a 7669 TENT,.'[xmlns:vi │ │ │ -001ea490: 7274 3d27 2768 7474 703a 2f2f 6578 616d rt=''http://exam │ │ │ -001ea4a0: 706c 652e 636f 6d2f 7669 7274 756f 736f ple.com/virtuoso │ │ │ -001ea4b0: 2f78 736c 7427 275d 0a76 6972 743a 636f /xslt''].virt:co │ │ │ -001ea4c0: 6e63 6174 5f73 7472 696e 6773 2028 2727 ncat_strings ('' │ │ │ -001ea4d0: 5469 746c 6520 2727 2c20 7374 7269 6e67 Title '', string │ │ │ -001ea4e0: 282f 6368 6170 7465 722f 7469 746c 6529 (/chapter/title) │ │ │ -001ea4f0: 2927 2c20 7029 3b0a 3c2f 7072 6f67 7261 )', p);...This will retur │ │ │ -001ea520: 6e20 7468 6520 636f 6e74 656e 7473 206f n the contents o │ │ │ -001ea530: 6620 616e 7920 272f 6368 6170 7465 722f f any '/chapter/ │ │ │ -001ea540: 7469 746c 6527 206e 6f64 6573 2c20 7072 title' nodes, pr │ │ │ -001ea550: 6566 6978 6564 0a77 6974 6820 636f 6e73 efixed.with cons │ │ │ -001ea560: 7461 6e74 2073 7472 696e 6720 2754 6974 tant string 'Tit │ │ │ -001ea570: 6c65 272e 3c2f 7061 7261 3e0a 2020 2020 le'.. │ │ │ -001ea580: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . ... See Als │ │ │ -001ea5d0: 6f3c 2f74 6974 6c65 3e0a 2020 2020 3c70 o.

    xpf_extens │ │ │ -001ea620: 696f 6e5f 7265 6d6f 7665 3c2f 6675 6e63 ion_remove. .... │ │ │ -001ea660: 0000 0027 6465 6d6f 2f64 6f63 7372 632f ...'demo/docsrc/ │ │ │ -001ea670: 6675 6e63 7265 662f 7870 6572 5f6e 6176 funcref/xper_nav │ │ │ -001ea680: 6967 6174 696f 6e2e 786d 6cdf 0000 287e igation.xml...(~ │ │ │ -001ea690: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... . │ │ │ -001eaa50: 2020 203c 7265 6665 6e74 7279 7469 746c XPER navigatio │ │ │ -001eaa70: 6e3c 2f72 6566 656e 7472 7974 6974 6c65 n. xml. . │ │ │ -001eaac0: 0a20 2020 203c 7265 666e 616d 653e 7870 . xp │ │ │ -001eaad0: 6572 5f72 6967 6874 5f73 6962 6c69 6e67 er_right_sibling │ │ │ -001eaae0: 3c2f 7265 666e 616d 653e 0a20 2020 203c . < │ │ │ -001eaaf0: 7265 666e 616d 653e 7870 6572 5f6c 6566 refname>xper_lef │ │ │ -001eab00: 745f 7369 626c 696e 673c 2f72 6566 6e61 t_sibling. xper_parent. xper_root_en │ │ │ -001eab50: 7469 7479 3c2f 7265 666e 616d 653e 0a20 tity. │ │ │ -001eab60: 2020 203c 7265 666e 616d 653e 7870 6572 xper │ │ │ -001eab70: 5f74 656c 6c3c 2f72 6566 6e61 6d65 3e0a _tell. │ │ │ -001eab80: 2020 2020 3c72 6566 6e61 6d65 3e78 7065 xpe │ │ │ -001eab90: 725f 6c65 6e67 7468 3c2f 7265 666e 616d r_length. low-level nav │ │ │ -001eabc0: 6967 6174 696f 6e20 6675 6e63 7469 6f6e igation function │ │ │ -001eabd0: 7320 666f 7220 7065 7273 6973 7465 6e74 s for persistent │ │ │ -001eabe0: 2058 4d4c 732c 2075 7365 6675 6c20 666f XMLs, useful fo │ │ │ -001eabf0: 7220 696d 706f 7274 206f 6620 6875 6765 r import of huge │ │ │ -001eac00: 2061 6d6f 756e 7473 206f 6620 584d 4c20 amounts of XML │ │ │ -001eac10: 6461 7461 3c2f 7265 6670 7572 706f 7365 data. . . . . │ │ │ -001eacb0: 2020 3c66 756e 6364 6566 3e3c 6675 6e63 xper_right_ │ │ │ -001eacd0: 7369 626c 696e 673c 2f66 756e 6374 696f sibling. │ │ │ -001eacf0: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ -001ead00: 6e20 3c70 6172 616d 6574 6572 3e78 7065 n xpe │ │ │ -001ead10: 725f 656e 7469 7479 3c2f 7061 7261 6d65 r_entityXML_entity. │ │ │ -001ead40: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -001ead50: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . . │ │ │ -001eadd0: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 xper_left_sib │ │ │ -001eadf0: 6c69 6e67 3c2f 6675 6e63 7469 6f6e 3e3c ling< │ │ │ -001eae00: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -001eae10: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -001eae20: 7061 7261 6d65 7465 723e 7870 6572 5f65 parameter>xper_e │ │ │ -001eae30: 6e74 6974 793c 2f70 6172 616d 6574 6572 ntityXML_entity. . │ │ │ -001eae70: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . │ │ │ -001eaeb0: 2020 3c66 756e 6370 726f 746f 7479 7065 . │ │ │ -001eaee0: 2020 3c66 756e 6364 6566 3e3c 6675 6e63 xper_parent │ │ │ -001eaf00: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e .

    in xper_entit │ │ │ -001eaf40: 793c 2f70 6172 616d 6574 6572 3e58 4d4c yXML │ │ │ -001eaf50: 5f65 6e74 6974 793c 2f70 6172 616d 6465 _entity. . < │ │ │ -001eaf80: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ -001eaf90: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . │ │ │ -001eafc0: 2020 203c 6675 6e63 7072 6f74 6f74 7970 . │ │ │ -001eaff0: 2020 2020 2020 2020 3c66 756e 6364 6566 xper_ │ │ │ -001eb010: 726f 6f74 5f65 6e74 6974 793c 2f66 756e root_entity │ │ │ -001eb030: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in xper_entityXML_enti │ │ │ -001eb070: 7479 3c2f 7061 7261 6d64 6566 3e0a 2020 ty. │ │ │ -001eb080: 2020 2020 203c 2f66 756e 6370 726f 746f . . │ │ │ -001eb0d0: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . │ │ │ -001eb100: 2020 2020 203c 6675 6e63 6465 663e 3c66 xper_tel │ │ │ -001eb120: 6c3c 2f66 756e 6374 696f 6e3e 3c2f 6675 l. < │ │ │ -001eb140: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in xper_enti │ │ │ -001eb160: 7479 3c2f 7061 7261 6d65 7465 723e 584d tyXM │ │ │ -001eb170: 4c5f 656e 7469 7479 3c2f 7061 7261 6d64 L_entity. . │ │ │ -001eb1a0: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ -001eb1b0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . < │ │ │ -001eb1e0: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -001eb1f0: 3d22 6670 726f 746f 5f78 7065 725f 6c65 ="fproto_xper_le │ │ │ -001eb200: 6e67 7468 223e 0a20 2020 2020 2020 203c ngth">. < │ │ │ -001eb210: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>xper_length. in xper_entityXML_en │ │ │ -001eb280: 7469 7479 3c2f 7061 7261 6d64 6566 3e0a tity. │ │ │ -001eb290: 2020 2020 2020 203c 2f66 756e 6370 726f . . . │ │ │ -001eb2d0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Des │ │ │ -001eb2f0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -001eb300: 0a20 2020 203c 7061 7261 3e0a 416c 6c20 . .All │ │ │ -001eb310: 7468 6573 6520 6675 6e63 7469 6f6e 7320 these functions │ │ │ -001eb320: 776f 726b 2077 6974 6820 2671 756f 743b work with " │ │ │ -001eb330: 7065 7273 6973 7465 6e74 2058 4d4c 2671 persistent XML&q │ │ │ -001eb340: 756f 743b 2028 5850 4552 2920 656e 7469 uot; (XPER) enti │ │ │ -001eb350: 7469 6573 206f 6e6c 792c 2073 6967 6e61 ties only, signa │ │ │ -001eb360: 6c6c 696e 6720 6572 726f 7273 2069 660a lling errors if. │ │ │ -001eb370: 6769 7665 6e20 656e 7469 7479 2070 6f69 given entity poi │ │ │ -001eb380: 6e74 7320 746f 2026 7175 6f74 3b58 4d4c nts to "XML │ │ │ -001eb390: 2074 7265 6526 7175 6f74 3b2e 2020 5468 tree". Th │ │ │ -001eb3a0: 6579 2061 7265 2075 7365 6675 6c20 7768 ey are useful wh │ │ │ -001eb3b0: 656e 2061 7070 6c69 6361 7469 6f6e 7320 en applications │ │ │ -001eb3c0: 6e65 6564 2074 6f20 7265 6164 2061 0a68 need to read a.h │ │ │ -001eb3d0: 7567 6520 584d 4c20 646f 6375 6d65 6e74 uge XML document │ │ │ -001eb3e0: 2c20 6573 7065 6369 616c 6c79 2073 6f6d , especially som │ │ │ -001eb3f0: 6574 6869 6e67 206c 696b 6520 6120 6461 ething like a da │ │ │ -001eb400: 7461 7368 6565 7420 6475 6d70 206f 7220 tasheet dump or │ │ │ -001eb410: 6576 656e 7420 6c6f 6720 7769 7468 2061 event log with a │ │ │ -001eb420: 206c 6172 6765 206e 756d 6265 720a 6f66 large number.of │ │ │ -001eb430: 2075 6e69 666f 726d 2072 6563 6f72 6473 uniform records │ │ │ -001eb440: 2c20 616e 6420 6973 2072 6571 7569 7265 , and is require │ │ │ -001eb450: 6420 746f 2070 726f 6365 7373 2061 6c6c d to process all │ │ │ -001eb460: 2072 6563 6f72 6473 206f 6620 7468 6520 records of the │ │ │ -001eb470: 646f 6375 6d65 6e74 2c20 652e 672e 2069 document, e.g. i │ │ │ -001eb480: 6d70 6f72 7420 7468 656d 2069 6e74 6f0a mport them into. │ │ │ -001eb490: 7468 6520 6461 7461 6261 7365 2e0a 3c2f the database... .C │ │ │ -001eb4b0: 6f6e 7369 6465 7220 6120 7265 616c 2073 onsider a real s │ │ │ -001eb4c0: 616d 706c 6520 6f66 2069 6d70 6f72 7420 ample of import │ │ │ -001eb4d0: 616c 6c20 6461 7461 2066 726f 6d20 4f44 all data from OD │ │ │ -001eb4e0: 5027 7320 636f 6e74 656e 742e 786d 6c20 P's content.xml │ │ │ -001eb4f0: 6475 6d70 2077 6869 6368 2063 6f6e 7461 dump which conta │ │ │ -001eb500: 696e 7320 6d6f 7265 2074 6861 6e0a 322c ins more than.2, │ │ │ -001eb510: 3030 302c 3030 3020 6465 7363 7269 7074 000,000 descript │ │ │ -001eb520: 696f 6e73 206f 6620 7661 7269 6f75 7320 ions of various │ │ │ -001eb530: 5765 622d 7369 7465 732c 2061 6e64 2074 Web-sites, and t │ │ │ -001eb540: 6865 206c 656e 6774 6820 6f66 2074 6865 he length of the │ │ │ -001eb550: 2066 696c 6520 6973 206d 6f72 6520 7468 file is more th │ │ │ -001eb560: 616e 2036 3030 4d62 2e20 2054 6865 0a66 an 600Mb. The.f │ │ │ -001eb570: 696c 6520 6861 7320 726f 6f74 2065 6c65 ile has root ele │ │ │ -001eb580: 6d65 6e74 206e 616d 6564 2027 5244 4627 ment named 'RDF' │ │ │ -001eb590: 2061 6e64 2061 6c6c 2064 6573 6372 6970 and all descrip │ │ │ -001eb5a0: 7469 6f6e 7320 6172 6520 7468 6569 7220 tions are their │ │ │ -001eb5b0: 6368 696c 6472 656e 206e 616d 6564 2065 children named e │ │ │ -001eb5c0: 6974 6865 7220 2754 6f70 6963 2720 6f72 ither 'Topic' or │ │ │ -001eb5d0: 0a27 4578 7465 726e 616c 5061 6765 272e .'ExternalPage'. │ │ │ -001eb5e0: 2054 6869 7320 636f 6465 206c 6f6f 6b73 This code looks │ │ │ -001eb5f0: 2073 7569 7461 626c 6520 666f 7220 696d suitable for im │ │ │ -001eb600: 706f 7274 696e 6720 7468 6573 6520 6368 porting these ch │ │ │ -001eb610: 696c 6472 656e 3a3c 2f70 6172 613e 0a20 ildren:. │ │ │ -001eb620: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 .create procedu │ │ │ -001eb640: 7265 0a20 2069 6d70 6f72 745f 636f 6e74 re. import_cont │ │ │ -001eb650: 656e 745f 786d 6c20 2829 0a20 207b 0a20 ent_xml (). {. │ │ │ -001eb660: 2020 2066 6f72 2073 656c 6563 7420 5f66 for select _f │ │ │ -001eb670: 7261 672c 2078 7061 7468 5f65 7661 6c28 rag, xpath_eval( │ │ │ -001eb680: 276c 6f63 616c 5f6e 616d 6528 2927 2c20 'local_name()', │ │ │ -001eb690: 5f66 7261 6729 2061 7320 5f74 6167 2066 _frag) as _tag f │ │ │ -001eb6a0: 726f 6d20 534f 5552 4345 5f58 4d4c 0a20 rom SOURCE_XML. │ │ │ -001eb6b0: 2020 2020 2077 6865 7265 204e 414d 453d where NAME= │ │ │ -001eb6c0: 2763 6f6e 7465 6e74 2e78 6d6c 2720 616e 'content.xml' an │ │ │ -001eb6d0: 6420 7870 6174 685f 636f 6e74 6169 6e73 d xpath_contains │ │ │ -001eb6e0: 2858 5045 522c 272f 5244 462f 2a27 2c5f (XPER,'/RDF/*',_ │ │ │ -001eb6f0: 6672 6167 290a 2020 2020 646f 0a20 2020 frag). do. │ │ │ -001eb700: 207b 0a20 2020 2020 2069 6620 285f 7461 {. if (_ta │ │ │ -001eb710: 673d 2754 6f70 6963 2729 2069 6d70 6f72 g='Topic') impor │ │ │ -001eb720: 745f 746f 7069 6320 285f 6672 6167 293b t_topic (_frag); │ │ │ -001eb730: 0a20 2020 2020 2065 6c73 650a 2020 2020 . else. │ │ │ -001eb740: 2020 7b0a 2020 2020 2020 2020 6966 2028 {. if ( │ │ │ -001eb750: 5f74 6167 3d27 4578 7465 726e 616c 5061 _tag='ExternalPa │ │ │ -001eb760: 6765 2729 2069 6d70 6f72 745f 6578 7465 ge') import_exte │ │ │ -001eb770: 726e 616c 2028 5f66 7261 6729 3b0a 2020 rnal (_frag);. │ │ │ -001eb780: 2020 2020 2020 656c 7365 206c 6f67 5f69 else log_i │ │ │ -001eb790: 6d70 6f72 745f 6572 726f 7220 285f 6672 mport_error (_fr │ │ │ -001eb7a0: 6167 2c20 2671 756f 743b 556e 6b6e 6f77 ag, "Unknow │ │ │ -001eb7b0: 6e20 7479 7065 206f 6620 7265 636f 7264 n type of record │ │ │ -001eb7c0: 2671 756f 743b 293b 0a20 2020 2020 207d ");. } │ │ │ -001eb7d0: 0a20 2020 207d 0a20 207d 3b0a 2020 2d2d . }. };. -- │ │ │ -001eb7e0: 2054 6869 7320 7368 6f75 6c64 206c 6f61 This should loa │ │ │ -001eb7f0: 6420 6669 6c65 7320 6c69 6b65 2063 6f6e d files like con │ │ │ -001eb800: 7465 6e74 2e78 6d6c 2c20 616e 6420 706c tent.xml, and pl │ │ │ -001eb810: 6163 6520 5850 4552 7320 696e 746f 2053 ace XPERs into S │ │ │ -001eb820: 4f55 5243 455f 584d 4c20 7461 626c 650a OURCE_XML table. │ │ │ -001eb830: 0a72 6561 645f 736f 7572 6365 5f78 6d6c .read_source_xml │ │ │ -001eb840: 7328 293b 0a20 202d 2d20 4e6f 7720 534f s();. -- Now SO │ │ │ -001eb850: 5552 4345 5f58 4d4c 2069 7320 6669 6c6c URCE_XML is fill │ │ │ -001eb860: 6564 2061 6e64 2064 6174 6120 7368 6f75 ed and data shou │ │ │ -001eb870: 6c64 2062 6520 696d 706f 7274 6564 2e0a ld be imported.. │ │ │ -001eb880: 0a69 6d70 6f72 745f 636f 6e74 656e 745f .import_content_ │ │ │ -001eb890: 786d 6c28 293b 0a69 6d70 6f72 745f 7374 xml();.import_st │ │ │ -001eb8a0: 7275 6374 7572 655f 786d 6c28 293b 0a69 ructure_xml();.i │ │ │ -001eb8b0: 6d70 6f72 745f 7072 6f66 696c 6573 5f78 mport_profiles_x │ │ │ -001eb8c0: 6d6c 2829 3b0a 202e 2e2e 0a3c 2f70 726f ml();. ...... │ │ │ -001eb8e0: 3c70 6172 613e 0a49 7420 6c6f 6f6b 7320 .It looks │ │ │ -001eb8f0: 6669 6e65 2061 6e64 2069 7420 7061 7373 fine and it pass │ │ │ -001eb900: 6573 2073 6d61 6c6c 2074 6573 7473 2062 es small tests b │ │ │ -001eb910: 7574 2069 7420 7769 6c6c 206e 6f74 2077 ut it will not w │ │ │ -001eb920: 6f72 6b20 6f6e 2072 6561 6c20 6461 7461 ork on real data │ │ │ -001eb930: 213c 2f70 6172 613e 0a20 203c 7061 7261 !. .First problem │ │ │ -001eb950: 6973 2072 6567 756c 6172 2063 6865 636b is regular check │ │ │ -001eb960: 706f 696e 7473 2028 6576 6572 7920 3120 points (every 1 │ │ │ -001eb970: 686f 7572 2062 7920 6465 6661 756c 7429 hour by default) │ │ │ -001eb980: 2c0a 736f 2069 6d70 6f72 745f 636f 6e74 ,.so import_cont │ │ │ -001eb990: 656e 745f 786d 6c20 6861 7320 6e6f 2063 ent_xml has no c │ │ │ -001eb9a0: 6861 6e63 6520 746f 2062 6520 636f 6d70 hance to be comp │ │ │ -001eb9b0: 6c65 7465 6420 6966 2069 7420 7461 6b65 leted if it take │ │ │ -001eb9c0: 7320 312e 3520 686f 7572 7320 6f66 2043 s 1.5 hours of C │ │ │ -001eb9d0: 5055 2074 696d 653b 0a74 6865 2066 756e PU time;.the fun │ │ │ -001eb9e0: 6374 696f 6e20 6368 6563 6b70 6f69 6e74 ction checkpoint │ │ │ -001eb9f0: 5f69 6e74 6572 7661 6c20 7368 6f75 6c64 _interval should │ │ │ -001eba00: 2062 6520 7573 6564 2074 6f20 7465 6d70 be used to temp │ │ │ -001eba10: 6f72 6172 696c 7920 6469 7361 626c 6520 orarily disable │ │ │ -001eba20: 7468 6573 6520 6368 6563 6b70 6f69 6e74 these checkpoint │ │ │ -001eba30: 732e 0a54 6865 6e2c 2074 6865 206c 656e s..Then, the len │ │ │ -001eba40: 6774 6820 6f66 2074 7261 6e73 6163 7469 gth of transacti │ │ │ -001eba50: 6f6e 206c 6f67 2062 6563 6f6d 6520 6578 on log become ex │ │ │ -001eba60: 7472 656d 656c 7920 6c61 7267 6520 6166 tremely large af │ │ │ -001eba70: 7465 7220 7377 6974 6368 696e 6720 6368 ter switching ch │ │ │ -001eba80: 6563 6b70 6f69 6e74 7320 6f66 662c 0a61 eckpoints off,.a │ │ │ -001eba90: 6e64 2069 7420 6973 2062 6574 7465 7220 nd it is better │ │ │ -001ebaa0: 746f 2069 6e73 6572 7420 6578 706c 6963 to insert explic │ │ │ -001ebab0: 6974 2063 6865 636b 706f 696e 7473 2062 it checkpoints b │ │ │ -001ebac0: 6574 7765 656e 2063 616c 6c73 206f 6620 etween calls of │ │ │ -001ebad0: 7468 6573 6520 6675 6e63 7469 6f6e 732e these functions. │ │ │ -001ebae0: 0a46 696e 616c 6c79 2c20 696d 706f 7274 .Finally, import │ │ │ -001ebaf0: 5f63 6f6e 7465 6e74 5f78 6d6c 2077 696c _content_xml wil │ │ │ -001ebb00: 6c20 6368 616e 6765 206d 6f72 6520 7468 l change more th │ │ │ -001ebb10: 616e 2034 2067 6967 6162 7974 6573 206f an 4 gigabytes o │ │ │ -001ebb20: 6620 6461 7461 2069 6e20 6f6e 6520 7472 f data in one tr │ │ │ -001ebb30: 616e 7361 6374 696f 6e2e 0a54 6869 7320 ansaction..This │ │ │ -001ebb40: 776f 756c 6420 6265 2069 6d70 6f73 7369 would be impossi │ │ │ -001ebb50: 626c 6520 6f6e 2061 6e79 2033 322d 6269 ble on any 32-bi │ │ │ -001ebb60: 7420 706c 6174 666f 726d 2c20 6265 6361 t platform, beca │ │ │ -001ebb70: 7573 6520 626f 7468 206d 656d 6f72 7920 use both memory │ │ │ -001ebb80: 6176 6169 6c61 626c 6520 616e 6420 6164 available and ad │ │ │ -001ebb90: 6472 6573 7320 7370 6163 650a 6265 636f dress space.beco │ │ │ -001ebba0: 6d65 2069 6e73 7566 6669 6369 656e 742e me insufficient. │ │ │ -001ebbb0: 2020 4164 6469 6e67 2069 6e74 6572 6d65 Adding interme │ │ │ -001ebbc0: 6469 6174 6520 2763 6f6d 6d69 7420 776f diate 'commit wo │ │ │ -001ebbd0: 726b 2720 7374 6174 656d 656e 7473 2069 rk' statements i │ │ │ -001ebbe0: 6e73 6964 6520 7468 6520 6c6f 6f70 2773 nside the loop's │ │ │ -001ebbf0: 2062 6f64 790a 7769 6c6c 206e 6f74 2068 body.will not h │ │ │ -001ebc00: 656c 7020 6265 6361 7573 6520 626f 7468 elp because both │ │ │ -001ebc10: 2027 636f 6d6d 6974 2077 6f72 6b27 2061 'commit work' a │ │ │ -001ebc20: 6e64 2027 726f 6c6c 6261 636b 2077 6f72 nd 'rollback wor │ │ │ -001ebc30: 6b27 2073 7461 7465 6d65 6e74 7320 7769 k' statements wi │ │ │ -001ebc40: 6c6c 2063 6c6f 7365 2061 6c6c 206f 7065 ll close all ope │ │ │ -001ebc50: 6e65 6420 6375 7273 6f72 732e 0a4c 6f6f ned cursors..Loo │ │ │ -001ebc60: 7020 2766 6f72 2073 656c 6563 7420 2e2e p 'for select .. │ │ │ -001ebc70: 2e20 6672 6f6d 202e 2e2e 2064 6f27 2075 . from ... do' u │ │ │ -001ebc80: 7365 7320 616e 2069 6d70 6c69 6369 7420 ses an implicit │ │ │ -001ebc90: 6375 7273 6f72 2074 6f20 6974 6572 6174 cursor to iterat │ │ │ -001ebca0: 6520 7468 6520 7265 7375 6c74 7365 742c e the resultset, │ │ │ -001ebcb0: 2062 7574 2074 6865 0a27 636f 6d6d 6974 but the.'commit │ │ │ -001ebcc0: 2077 6f72 6b27 206f 7065 7261 746f 7220 work' operator │ │ │ -001ebcd0: 7769 6c6c 2063 6c6f 7365 2074 6869 7320 will close this │ │ │ -001ebce0: 6375 7273 6f72 2061 6e64 2061 626f 7274 cursor and abort │ │ │ -001ebcf0: 2074 6865 206c 6f6f 702e 3c2f 7061 7261 the loop.. .Funct │ │ │ -001ebd10: 696f 6e20 7870 6572 5f72 6967 6874 5f73 ion xper_right_s │ │ │ -001ebd20: 6962 6c69 6e67 2069 7320 6465 7369 676e ibling is design │ │ │ -001ebd30: 6564 2073 7065 6369 616c 6c79 2074 6f20 ed specially to │ │ │ -001ebd40: 736f 6c76 6520 7468 6520 6c61 7374 2070 solve the last p │ │ │ -001ebd50: 726f 626c 656d 2e20 2049 7420 616c 6c6f roblem. It allo │ │ │ -001ebd60: 7773 2079 6f75 0a74 6f20 6974 6572 6174 ws you.to iterat │ │ │ -001ebd70: 6520 6368 696c 6472 656e 206f 6620 736f e children of so │ │ │ -001ebd80: 6d65 2065 6c65 6d65 6e74 2077 6974 686f me element witho │ │ │ -001ebd90: 7574 2075 7369 6e67 2061 6e79 2063 7572 ut using any cur │ │ │ -001ebda0: 736f 7220 6174 2061 6c6c 2e0a 4974 2072 sor at all..It r │ │ │ -001ebdb0: 6574 7572 6e73 2074 6865 2072 6967 6874 eturns the right │ │ │ -001ebdc0: 2063 6869 6c64 206f 6620 7468 6520 656e child of the en │ │ │ -001ebdd0: 7469 7479 2070 6173 7365 6420 6173 2069 tity passed as i │ │ │ -001ebde0: 7473 2061 7267 756d 656e 742e 2020 4966 ts argument. If │ │ │ -001ebdf0: 2074 6865 2067 6976 656e 2065 6e74 6974 the given entit │ │ │ -001ebe00: 790a 6973 2074 6865 206c 6173 7420 6368 y.is the last ch │ │ │ -001ebe10: 696c 6420 6f66 2069 7473 2070 6172 656e ild of its paren │ │ │ -001ebe20: 742c 2074 6865 2066 756e 6374 696f 6e20 t, the function │ │ │ -001ebe30: 7769 6c6c 2072 6574 7572 6e20 4e55 4c4c will return NULL │ │ │ -001ebe40: 2e20 2053 696d 696c 6172 6c79 2c20 7870 . Similarly, xp │ │ │ -001ebe50: 6572 5f6c 6566 745f 7369 626c 696e 6720 er_left_sibling │ │ │ -001ebe60: 7769 6c6c 0a72 6574 7572 6e20 7468 6520 will.return the │ │ │ -001ebe70: 7072 6576 696f 7573 2063 6869 6c64 206f previous child o │ │ │ -001ebe80: 7220 4e55 4c4c 2066 6f72 2074 6865 2066 r NULL for the f │ │ │ -001ebe90: 6972 7374 2063 6869 6c64 2c20 7870 6572 irst child, xper │ │ │ -001ebea0: 5f70 6172 656e 7420 7769 6c6c 2072 6574 _parent will ret │ │ │ -001ebeb0: 7572 6e20 7061 7265 6e74 206f 660a 656e urn parent of.en │ │ │ -001ebec0: 7469 7479 206f 7220 4e55 4c4c 2066 6f72 tity or NULL for │ │ │ -001ebed0: 2074 6865 2064 6f63 756d 656e 7427 7320 the document's │ │ │ -001ebee0: 726f 6f74 2061 6e64 2078 7065 725f 726f root and xper_ro │ │ │ -001ebef0: 6f74 5f65 6e74 6974 7920 7769 6c6c 2072 ot_entity will r │ │ │ -001ebf00: 6574 7572 6e20 7468 6520 726f 6f74 2066 eturn the root f │ │ │ -001ebf10: 6f72 2061 6e79 0a65 6e74 6974 792e 2020 or any.entity. │ │ │ -001ebf20: 5573 696e 6720 7468 6573 6520 6675 6e63 Using these func │ │ │ -001ebf30: 7469 6f6e 732c 2069 7420 6973 2070 6f73 tions, it is pos │ │ │ -001ebf40: 7369 626c 6520 746f 2073 6361 6e20 7468 sible to scan th │ │ │ -001ebf50: 6520 646f 6375 6d65 6e74 2066 6f72 7761 e document forwa │ │ │ -001ebf60: 7264 2028 6672 6f6d 206c 6566 740a 746f rd (from left.to │ │ │ -001ebf70: 2072 6967 6874 292c 2062 6163 6b77 6172 right), backwar │ │ │ -001ebf80: 6420 616e 6420 746f 2026 7175 6f74 3b63 d and to "c │ │ │ -001ebf90: 6c69 6d62 2075 7026 7175 6f74 3b20 746f limb up" to │ │ │ -001ebfa0: 7761 7264 2074 6865 2072 6f6f 7420 6f66 ward the root of │ │ │ -001ebfb0: 2074 6865 2065 6c65 6d65 6e74 7327 2074 the elements' t │ │ │ -001ebfc0: 7265 652e 2020 5468 6573 650a 6675 6e63 ree. These.func │ │ │ -001ebfd0: 7469 6f6e 7320 6172 6520 6361 6c6c 6564 tions are called │ │ │ -001ebfe0: 203c 656d 7068 6173 6973 3e58 4d4c 204e XML N │ │ │ -001ebff0: 6176 6967 6174 696f 6e20 4675 6e63 7469 avigation Functi │ │ │ -001ec000: 6f6e 733c 2f65 6d70 6861 7369 733e 2062 ons b │ │ │ -001ec010: 6563 6175 7365 2074 6865 7920 6172 6520 ecause they are │ │ │ -001ec020: 6c69 6b65 0a74 6865 2073 7461 7465 6d65 like.the stateme │ │ │ -001ec030: 6e74 7320 2671 756f 743b 6e65 7874 2072 nts "next r │ │ │ -001ec040: 6563 6f72 6426 7175 6f74 3b2c 2026 7175 ecord", &qu │ │ │ -001ec050: 6f74 3b70 7265 7620 7265 636f 7264 2671 ot;prev record&q │ │ │ -001ec060: 756f 743b 2065 7463 2e2c 2075 7365 6420 uot; etc., used │ │ │ -001ec070: 696e 2063 7572 736f 720a 6c69 6b65 206e in cursor.like n │ │ │ -001ec080: 6176 6967 6174 696f 6e20 6f66 2064 6174 avigation of dat │ │ │ -001ec090: 6162 6173 6573 2e3c 2f70 6172 613e 0a20 abases.. │ │ │ -001ec0a0: 203c 7061 7261 3e0a 5468 6572 6520 6172 .There ar │ │ │ -001ec0b0: 6520 6e6f 2073 7065 6369 616c 2066 756e e no special fun │ │ │ -001ec0c0: 6374 696f 6e73 2074 6f20 2671 756f 743b ctions to " │ │ │ -001ec0d0: 676f 2064 6f77 6e26 7175 6f74 3b2c 2065 go down", e │ │ │ -001ec0e0: 2e67 2e20 746f 2066 696e 6420 6669 7273 .g. to find firs │ │ │ -001ec0f0: 7420 6368 696c 6472 656e 206f 660a 6769 t children of.gi │ │ │ -001ec100: 7665 6e20 656c 656d 656e 742c 2062 6563 ven element, bec │ │ │ -001ec110: 6175 7365 2078 7061 7468 5f65 7661 6c20 ause xpath_eval │ │ │ -001ec120: 6361 6e20 646f 2061 6e79 2073 7563 6820 can do any such │ │ │ -001ec130: 6d6f 7665 6d65 6e74 2076 6572 7920 7175 movement very qu │ │ │ -001ec140: 6963 6b6c 792e 3c2f 7061 7261 3e0a 2020 ickly.. │ │ │ -001ec150: 3c70 6172 613e 0a53 6f6d 6574 696d 6573 .Sometimes │ │ │ -001ec160: 2064 6174 6120 696d 706f 7274 2069 7320 data import is │ │ │ -001ec170: 636f 6e74 726f 6c6c 6564 2066 726f 6d20 controlled from │ │ │ -001ec180: 736f 6d65 2063 6c69 656e 7420 6170 706c some client appl │ │ │ -001ec190: 6963 6174 696f 6e2e 2020 4966 206f 6e65 ication. If one │ │ │ -001ec1a0: 206f 7065 7261 7469 6f6e 2074 616b 6573 operation takes │ │ │ -001ec1b0: 0a68 6f75 7273 2c20 736f 6d65 2073 6f72 .hours, some sor │ │ │ -001ec1c0: 7420 6f66 2026 7175 6f74 3b70 726f 6772 t of "progr │ │ │ -001ec1d0: 6573 7320 6261 7226 7175 6f74 3b20 6265 ess bar" be │ │ │ -001ec1e0: 636f 6d65 7320 7665 7279 2075 7365 6675 comes very usefu │ │ │ -001ec1f0: 6c2c 2061 7420 6c65 6173 7420 746f 2073 l, at least to s │ │ │ -001ec200: 6565 2077 6865 7468 6572 0a61 7070 6c69 ee whether.appli │ │ │ -001ec210: 6361 7469 6f6e 2077 6f72 6b73 206f 7220 cation works or │ │ │ -001ec220: 6861 6e67 732e 2078 7065 725f 6c65 6e67 hangs. xper_leng │ │ │ -001ec230: 7468 2074 616b 6573 2061 6e20 5850 4552 th takes an XPER │ │ │ -001ec240: 2065 6e74 6974 7920 616e 6420 7265 7475 entity and retu │ │ │ -001ec250: 726e 7320 7768 6f6c 6520 6c65 6e67 7468 rns whole length │ │ │ -001ec260: 206f 660a 5850 4552 2064 6973 6b20 696d of.XPER disk im │ │ │ -001ec270: 6167 6520 696e 2062 7974 6573 2e20 7870 age in bytes. xp │ │ │ -001ec280: 6572 5f74 656c 6c20 7461 6b65 7320 616e er_tell takes an │ │ │ -001ec290: 2058 5045 5220 656e 7469 7479 2061 6e64 XPER entity and │ │ │ -001ec2a0: 2072 6574 7572 6e73 2073 6f6d 6574 6869 returns somethi │ │ │ -001ec2b0: 6e67 206c 696b 6520 656e 7469 7479 2773 ng like entity's │ │ │ -001ec2c0: 206f 6666 7365 740a 696e 7369 6465 2074 offset.inside t │ │ │ -001ec2d0: 6865 2064 6f63 756d 656e 742e 2020 5468 he document. Th │ │ │ -001ec2e0: 6569 7220 7265 7375 6c74 7320 6d61 7920 eir results may │ │ │ -001ec2f0: 6265 2075 7365 6420 6279 2074 6865 2063 be used by the c │ │ │ -001ec300: 6c69 656e 7420 6170 706c 6963 6174 696f lient applicatio │ │ │ -001ec310: 6e20 746f 206d 6f6e 6974 6f72 2074 6865 n to monitor the │ │ │ -001ec320: 2070 726f 6772 6573 730a 616e 6420 6573 progress.and es │ │ │ -001ec330: 7469 6d61 7465 2074 6865 2074 696d 6520 timate the time │ │ │ -001ec340: 756e 7469 6c20 636f 6d70 6c65 7469 6f6e until completion │ │ │ -001ec350: 2e20 2054 6865 7920 6d61 7920 6265 2065 . They may be e │ │ │ -001ec360: 7370 6563 6961 6c6c 7920 7573 6566 756c specially useful │ │ │ -001ec370: 2066 6f72 2064 6562 7567 6769 6e67 2070 for debugging p │ │ │ -001ec380: 7572 706f 7365 732c 0a65 2e67 2e20 746f urposes,.e.g. to │ │ │ -001ec390: 2072 6570 6f72 7420 706f 7369 7469 6f6e report position │ │ │ -001ec3a0: 206f 6620 6572 726f 722e 2020 556e 666f of error. Unfo │ │ │ -001ec3b0: 7274 756e 6174 656c 7920 2671 756f 743b rtunately " │ │ │ -001ec3c0: 7870 6572 5f73 6565 6b26 7175 6f74 3b20 xper_seek" │ │ │ -001ec3d0: 6973 206e 6f74 2070 6f73 7369 626c 6520 is not possible │ │ │ -001ec3e0: 666f 720a 5850 4552 732c 2075 6e6c 696b for.XPERs, unlik │ │ │ -001ec3f0: 6520 7479 7069 6361 6c20 7261 6e64 6f6d e typical random │ │ │ -001ec400: 2061 6363 6573 7320 746f 2066 696c 6573 access to files │ │ │ -001ec410: 2e3c 2f70 6172 613e 0a20 203c 7061 7261 .. .Ultimately, th │ │ │ -001ec430: 6520 776f 726b 696e 6720 7665 7273 696f e working versio │ │ │ -001ec440: 6e20 6f66 2074 6865 2070 726f 6365 6475 n of the procedu │ │ │ -001ec450: 7265 2064 6573 6372 6962 6564 2061 626f re described abo │ │ │ -001ec460: 7665 2077 696c 6c20 6c6f 6f6b 206c 696b ve will look lik │ │ │ -001ec470: 6520 7468 6973 3a3c 2f70 6172 613e 0a0a e this:.. │ │ │ -001ec480: 2020 3c70 726f 6772 616d 6c69 7374 696e .create proced │ │ │ -001ec4a0: 7572 650a 2020 696d 706f 7274 5f63 6f6e ure. import_con │ │ │ -001ec4b0: 7465 6e74 5f78 6d6c 2028 290a 2020 7b0a tent_xml (). {. │ │ │ -001ec4c0: 2020 2020 6465 636c 6172 6520 5f66 7261 declare _fra │ │ │ -001ec4d0: 6720 616e 793b 0a20 2020 2064 6563 6c61 g any;. decla │ │ │ -001ec4e0: 7265 205f 7461 6720 616e 793b 0a20 2020 re _tag any;. │ │ │ -001ec4f0: 2064 6563 6c61 7265 205f 6e6f 6465 6964 declare _nodeid │ │ │ -001ec500: 2061 6e79 3b0a 2020 2020 6465 636c 6172 any;. declar │ │ │ -001ec510: 6520 5f72 5f69 6420 7661 7263 6861 723b e _r_id varchar; │ │ │ -001ec520: 0a20 2020 2064 6563 6c61 7265 205f 6162 . declare _ab │ │ │ -001ec530: 6f75 742c 205f 7469 746c 652c 205f 6465 out, _title, _de │ │ │ -001ec540: 7363 7269 7074 696f 6e20 7661 7263 6861 scription varcha │ │ │ -001ec550: 723b 0a20 2020 2064 6563 6c61 7265 2043 r;. declare C │ │ │ -001ec560: 7572 5469 6d65 2076 6172 6368 6172 3b0a urTime varchar;. │ │ │ -001ec570: 2020 2020 6465 636c 6172 6520 4672 6167 declare Frag │ │ │ -001ec580: 732c 2049 6e73 6572 7473 2c20 506f 732c s, Inserts, Pos, │ │ │ -001ec590: 204c 656e 6774 6820 696e 7465 6765 723b Length integer; │ │ │ -001ec5a0: 0a0a 2020 2020 7365 6c65 6374 205f 6672 .. select _fr │ │ │ -001ec5b0: 6167 3120 696e 746f 205f 6672 6167 2066 ag1 into _frag f │ │ │ -001ec5c0: 726f 6d20 534f 5552 4345 5f58 4d4c 0a20 rom SOURCE_XML. │ │ │ -001ec5d0: 2020 2020 2077 6865 7265 204e 414d 4520 where NAME │ │ │ -001ec5e0: 3d20 2763 6f6e 7465 6e74 2e78 6d6c 2720 = 'content.xml' │ │ │ -001ec5f0: 616e 6420 7870 6174 685f 636f 6e74 6169 and xpath_contai │ │ │ -001ec600: 6e73 2028 5850 4552 2c20 272f 5244 462f ns (XPER, '/RDF/ │ │ │ -001ec610: 2a27 2c20 5f66 7261 6731 293b 0a0a 2020 *', _frag1);.. │ │ │ -001ec620: 2020 6966 2028 6e6f 7420 6973 656e 7469 if (not isenti │ │ │ -001ec630: 7479 285f 6672 6167 2929 2073 6967 6e61 ty(_frag)) signa │ │ │ -001ec640: 6c28 2734 324f 4450 272c 2027 584d 4c20 l('42ODP', 'XML │ │ │ -001ec650: 736f 7572 6365 2022 436f 6e74 656e 7422 source "Content" │ │ │ -001ec660: 2069 7320 656d 7074 7927 293b 0a0a 2020 is empty');.. │ │ │ -001ec670: 2020 4672 6167 7320 3a3d 2030 3b0a 2020 Frags := 0;. │ │ │ -001ec680: 2020 496e 7365 7274 7320 3a3d 2030 3b0a Inserts := 0;. │ │ │ -001ec690: 2020 2020 4c65 6e67 7468 203a 3d20 7870 Length := xp │ │ │ -001ec6a0: 6572 5f6c 656e 6774 6828 5f66 7261 6729 er_length(_frag) │ │ │ -001ec6b0: 3b0a 2020 2020 7265 7375 6c74 5f6e 616d ;. result_nam │ │ │ -001ec6c0: 6573 2028 4375 7254 696d 652c 2046 7261 es (CurTime, Fra │ │ │ -001ec6d0: 6773 2c20 506f 732c 204c 656e 6774 6829 gs, Pos, Length) │ │ │ -001ec6e0: 3b0a 2020 2020 2d2d 2049 7427 7320 6e6f ;. -- It's no │ │ │ -001ec6f0: 7420 7468 6520 6265 7374 2077 6179 2074 t the best way t │ │ │ -001ec700: 6f20 7072 6f63 6573 7320 6465 6164 6c6f o process deadlo │ │ │ -001ec710: 636b 732c 2062 7574 2069 7420 6d61 7920 cks, but it may │ │ │ -001ec720: 6265 2062 6574 7465 7220 7468 616e 206e be better than n │ │ │ -001ec730: 6f74 6869 6e67 2e0a 0a20 2020 2077 6865 othing... whe │ │ │ -001ec740: 6e65 7665 7220 7371 6c73 7461 7465 2027 never sqlstate ' │ │ │ -001ec750: 3430 3030 3127 2067 6f74 6f20 6e65 7874 40001' goto next │ │ │ -001ec760: 5f66 7261 673b 0a0a 2020 2020 6e65 7874 _frag;.. next │ │ │ -001ec770: 5f66 7261 673a 0a0a 2020 2020 2d2d 2053 _frag:.. -- S │ │ │ -001ec780: 6572 7665 7220 7769 6c6c 2069 6e66 6f72 erver will infor │ │ │ -001ec790: 6d20 636c 6965 6e74 2061 7070 6c69 6361 m client applica │ │ │ -001ec7a0: 7469 6f6e 2061 626f 7574 2070 726f 6772 tion about progr │ │ │ -001ec7b0: 6573 7320 6166 7465 7220 6576 6572 7920 ess after every │ │ │ -001ec7c0: 3130 3030 3020 7265 636f 7264 732e 0a20 10000 records.. │ │ │ -001ec7d0: 2020 2069 6620 286d 6f64 2846 7261 6773 if (mod(Frags │ │ │ -001ec7e0: 2c31 3030 3030 2920 3d20 3029 0a20 2020 ,10000) = 0). │ │ │ -001ec7f0: 207b 0a20 2020 2020 202d 2d20 4e6f 7465 {. -- Note │ │ │ -001ec800: 2074 6861 7420 6966 2069 7420 6e65 6564 that if it need │ │ │ -001ec810: 7320 746f 2065 7374 696d 6174 6520 7468 s to estimate th │ │ │ -001ec820: 6520 7469 6d65 2074 6f20 636f 6d70 6c65 e time to comple │ │ │ -001ec830: 7469 6f6e 2c20 7469 6d65 2073 686f 756c tion, time shoul │ │ │ -001ec840: 6420 6265 206d 6561 7375 7265 640a 2020 d be measured. │ │ │ -001ec850: 2020 2020 2d2d 206f 6e20 7365 7276 6572 -- on server │ │ │ -001ec860: 2073 6964 652c 2062 6563 6175 7365 2072 side, because r │ │ │ -001ec870: 6573 756c 7473 206d 6179 2062 6520 7265 esults may be re │ │ │ -001ec880: 7475 726e 6564 206f 6e20 6261 7463 6865 turned on batche │ │ │ -001ec890: 7320 746f 2072 6564 7563 6520 6e65 7477 s to reduce netw │ │ │ -001ec8a0: 6f72 6b0a 2020 2020 2020 2d2d 2074 7261 ork. -- tra │ │ │ -001ec8b0: 6666 6963 2c20 616e 6420 6974 206d 6179 ffic, and it may │ │ │ -001ec8c0: 2062 6520 6120 7369 676e 6966 6963 616e be a significan │ │ │ -001ec8d0: 7420 6465 6c61 7920 6265 7477 6565 6e20 t delay between │ │ │ -001ec8e0: 6361 6c6c 206f 6620 7265 7375 6c74 2066 call of result f │ │ │ -001ec8f0: 756e 6374 696f 6e20 6f6e 0a20 2020 2020 unction on. │ │ │ -001ec900: 202d 2d20 7365 7276 6572 2061 6e64 2066 -- server and f │ │ │ -001ec910: 6574 6368 206f 6e20 636c 6965 6e74 2073 etch on client s │ │ │ -001ec920: 6964 652e 0a20 2020 2020 2043 7572 5469 ide.. CurTi │ │ │ -001ec930: 6d65 203a 3d20 6361 7374 286e 6f77 2829 me := cast(now() │ │ │ -001ec940: 2061 7320 7661 7263 6861 7229 3b0a 2020 as varchar);. │ │ │ -001ec950: 2020 2020 506f 7320 3a3d 2078 7065 725f Pos := xper_ │ │ │ -001ec960: 7465 6c6c 285f 6672 6167 293b 0a20 2020 tell(_frag);. │ │ │ -001ec970: 2020 2072 6573 756c 7420 2843 7572 5469 result (CurTi │ │ │ -001ec980: 6d65 2c20 4672 6167 732c 2049 6e73 6572 me, Frags, Inser │ │ │ -001ec990: 7473 2c20 506f 732c 204c 656e 6774 6829 ts, Pos, Length) │ │ │ -001ec9a0: 3b0a 2020 2020 7d0a 2020 2020 5f74 6167 ;. }. _tag │ │ │ -001ec9b0: 203a 3d20 7870 6174 685f 6576 616c 2827 := xpath_eval(' │ │ │ -001ec9c0: 6c6f 6361 6c2d 6e61 6d65 2829 272c 205f local-name()', _ │ │ │ -001ec9d0: 6672 6167 293b 0a20 2020 2069 6620 285f frag);. if (_ │ │ │ -001ec9e0: 7461 6720 3d20 2754 6f70 6963 2729 0a20 tag = 'Topic'). │ │ │ -001ec9f0: 2020 207b 0a20 2020 2020 2069 6d70 6f72 {. impor │ │ │ -001eca00: 745f 746f 7069 6328 5f66 7261 6729 3b0a t_topic(_frag);. │ │ │ -001eca10: 2020 2020 2020 676f 746f 2061 6476 616e goto advan │ │ │ -001eca20: 6365 3b0a 2020 2020 7d0a 2020 2020 6966 ce;. }. if │ │ │ -001eca30: 2028 5f74 6167 203d 2027 4578 7465 726e (_tag = 'Extern │ │ │ -001eca40: 616c 5061 6765 2729 0a20 2020 207b 0a20 alPage'). {. │ │ │ -001eca50: 2020 2020 2069 6d70 6f72 745f 6578 7465 import_exte │ │ │ -001eca60: 726e 616c 285f 6672 6167 293b 0a20 2020 rnal(_frag);. │ │ │ -001eca70: 2020 2067 6f74 6f20 6164 7661 6e63 653b goto advance; │ │ │ -001eca80: 0a20 2020 207d 0a20 2020 206c 6f67 5f69 . }. log_i │ │ │ -001eca90: 6d70 6f72 745f 6572 726f 7220 285f 6672 mport_error (_fr │ │ │ -001ecaa0: 6167 2c20 2671 756f 743b 556e 6b6e 6f77 ag, "Unknow │ │ │ -001ecab0: 6e20 7479 7065 206f 6620 7265 636f 7264 n type of record │ │ │ -001ecac0: 2671 756f 743b 293b 0a20 2020 2067 6f74 ");. got │ │ │ -001ecad0: 6f20 6e6f 636f 6d6d 6974 5f61 6476 616e o nocommit_advan │ │ │ -001ecae0: 6365 3b0a 0a20 2020 2061 6476 616e 6365 ce;.. advance │ │ │ -001ecaf0: 3a0a 2020 2020 496e 7365 7274 7320 3a3d :. Inserts := │ │ │ -001ecb00: 2049 6e73 6572 7473 202b 2031 3b0a 2020 Inserts + 1;. │ │ │ -001ecb10: 2020 2d2d 204e 6f74 6520 7468 6174 2069 -- Note that i │ │ │ -001ecb20: 7420 6d61 7920 6265 2066 6173 7465 7220 t may be faster │ │ │ -001ecb30: 746f 2068 6176 6520 3120 636f 6d6d 6974 to have 1 commit │ │ │ -001ecb40: 2070 6572 2031 3030 206f 7220 3130 3030 per 100 or 1000 │ │ │ -001ecb50: 2072 6563 6f72 6473 2069 6e20 736f 6d65 records in some │ │ │ -001ecb60: 2063 6173 6573 2e0a 0a20 2020 2063 6f6d cases... com │ │ │ -001ecb70: 6d69 7420 776f 726b 3b0a 0a20 2020 206e mit work;.. n │ │ │ -001ecb80: 6f63 6f6d 6d69 745f 6164 7661 6e63 653a ocommit_advance: │ │ │ -001ecb90: 0a20 2020 2046 7261 6773 203a 3d20 4672 . Frags := Fr │ │ │ -001ecba0: 6167 7320 2b20 313b 0a0a 2020 2020 5f66 ags + 1;.. _f │ │ │ -001ecbb0: 7261 6720 3a3d 2078 7065 725f 7269 6768 rag := xper_righ │ │ │ -001ecbc0: 745f 7369 626c 696e 6728 5f66 7261 6729 t_sibling(_frag) │ │ │ -001ecbd0: 3b0a 2020 2020 6966 2028 6973 656e 7469 ;. if (isenti │ │ │ -001ecbe0: 7479 285f 6672 6167 2929 2067 6f74 6f20 ty(_frag)) goto │ │ │ -001ecbf0: 6e65 7874 5f66 7261 673b 202d 2d20 4966 next_frag; -- If │ │ │ -001ecc00: 205f 6672 6167 2069 7320 4e55 4c4c 2c20 _frag is NULL, │ │ │ -001ecc10: 7765 2776 6520 636f 6d70 6c65 7465 6420 we've completed │ │ │ -001ecc20: 7468 6520 696d 706f 7274 2e0a 0a20 2020 the import... │ │ │ -001ecc30: 2043 7572 5469 6d65 203a 3d20 6361 7374 CurTime := cast │ │ │ -001ecc40: 286e 6f77 2829 2061 7320 7661 7263 6861 (now() as varcha │ │ │ -001ecc50: 7229 3b0a 2020 2020 7265 7375 6c74 2028 r);. result ( │ │ │ -001ecc60: 4375 7254 696d 652c 2046 7261 6773 2c20 CurTime, Frags, │ │ │ -001ecc70: 496e 7365 7274 732c 204c 656e 6774 682c Inserts, Length, │ │ │ -001ecc80: 204c 656e 6774 6829 3b0a 2020 7d3b 0a0a Length);. };.. │ │ │ -001ecc90: 2020 6368 6563 6b70 6f69 6e74 5f69 6e74 checkpoint_int │ │ │ -001ecca0: 6572 7661 6c28 3029 3b0a 2020 6368 6563 erval(0);. chec │ │ │ -001eccb0: 6b70 6f69 6e74 3b0a 0a20 2072 6561 645f kpoint;.. read_ │ │ │ -001eccc0: 736f 7572 6365 5f78 6d6c 7328 293b 0a20 source_xmls();. │ │ │ -001eccd0: 2063 6865 636b 706f 696e 743b 0a0a 2020 checkpoint;.. │ │ │ -001ecce0: 696d 706f 7274 5f63 6f6e 7465 6e74 5f78 import_content_x │ │ │ -001eccf0: 6d6c 2829 3b0a 2020 6368 6563 6b70 6f69 ml();. checkpoi │ │ │ -001ecd00: 6e74 3b0a 0a20 2069 6d70 6f72 745f 7374 nt;.. import_st │ │ │ -001ecd10: 7275 6374 7572 655f 786d 6c28 293b 0a20 ructure_xml();. │ │ │ -001ecd20: 2063 6865 636b 706f 696e 743b 0a0a 2020 checkpoint;.. │ │ │ -001ecd30: 696d 706f 7274 5f70 726f 6669 6c65 735f import_profiles_ │ │ │ -001ecd40: 786d 6c28 293b 0a20 2063 6865 636b 706f xml();. checkpo │ │ │ -001ecd50: 696e 743b 0a20 202e 2e2e 0a0a 2020 6368 int;. ..... ch │ │ │ -001ecd60: 6563 6b70 6f69 6e74 5f69 6e74 6572 7661 eckpoint_interva │ │ │ -001ecd70: 6c28 3630 293b 0a20 203c 2f70 726f 6772 l(60);. . . Paramete │ │ │ -001ecdc0: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -001ecdd0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -001ecde0: 7870 6572 5f65 6e74 6974 793c 2f74 6974 xper_entity</tit │ │ │ -001ecdf0: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -001ece00: 5065 7273 6973 7465 6e74 2058 4d4c 2065 Persistent XML e │ │ │ -001ece10: 6e74 6974 7920 746f 206f 7065 7261 7465 ntity to operate │ │ │ -001ece20: 206f 6e2e 3c2f 7061 7261 3e3c 2f72 6566 on.</para></ref │ │ │ -001ece30: 7365 6374 323e 0a20 203c 2f72 6566 7365 sect2>. </refse │ │ │ -001ece40: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ -001ece50: 2069 643d 2273 6565 616c 736f 223e 3c74 id="seealso"><t │ │ │ -001ece60: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ -001ece70: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ -001ece80: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ -001ece90: 6e5f 7870 6572 5f64 6f63 223e 7870 6572 n_xper_doc">xper │ │ │ -001ecea0: 5f64 6f63 2829 3c2f 6c69 6e6b 3e3c 2f70 _doc()</link></p │ │ │ -001eceb0: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ -001ecec0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -001eced0: 5f78 7065 725f 6375 7422 3e78 7065 725f _xper_cut">xper_ │ │ │ -001ecee0: 6375 7428 293c 2f6c 696e 6b3e 3c2f 7061 cut()</link></pa │ │ │ -001ecef0: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ -001ecf00: 3e0a 3c2f 7265 6665 6e74 7279 3e0a b600 >.</refentry>... │ │ │ -001ecf10: 0000 2964 656d 6f2f 646f 6373 7263 2f66 ..)demo/docsrc/f │ │ │ -001ecf20: 756e 6372 6566 2f78 7065 725f 6c6f 6361 uncref/xper_loca │ │ │ -001ecf30: 7465 5f77 6f72 6473 2e78 6d6c df00 0009 te_words.xml.... │ │ │ -001ecf40: 693c 3f78 6d6c 2076 6572 7369 6f6e 3d22 i<?xml version=" │ │ │ -001ecf50: 312e 3022 2065 6e63 6f64 696e 673d 2249 1.0" encoding="I │ │ │ -001ecf60: 534f 2d38 3835 392d 3122 3f3e 0a3c 212d SO-8859-1"?>.<!- │ │ │ -001ecf70: 2d0a 202d 2020 0a20 2d20 2054 6869 7320 -. - . - This │ │ │ -001ecf80: 6669 6c65 2069 7320 7061 7274 206f 6620 file is part of │ │ │ -001ecf90: 7468 6520 4f70 656e 4c69 6e6b 2053 6f66 the OpenLink Sof │ │ │ -001ecfa0: 7477 6172 6520 5669 7274 756f 736f 204f tware Virtuoso O │ │ │ -001ecfb0: 7065 6e2d 536f 7572 6365 2028 564f 5329 pen-Source (VOS) │ │ │ -001ecfc0: 0a20 2d20 2070 726f 6a65 6374 2e0a 202d . - project.. - │ │ │ -001ecfd0: 2020 0a20 2d20 2043 6f70 7972 6967 6874 . - Copyright │ │ │ -001ecfe0: 2028 4329 2031 3939 382d 3230 3234 204f (C) 1998-2024 O │ │ │ -001ecff0: 7065 6e4c 696e 6b20 536f 6674 7761 7265 penLink Software │ │ │ -001ed000: 0a20 2d20 200a 202d 2020 5468 6973 2070 . - . - This p │ │ │ -001ed010: 726f 6a65 6374 2069 7320 6672 6565 2073 roject is free s │ │ │ -001ed020: 6f66 7477 6172 653b 2079 6f75 2063 616e oftware; you can │ │ │ -001ed030: 2072 6564 6973 7472 6962 7574 6520 6974 redistribute it │ │ │ -001ed040: 2061 6e64 2f6f 7220 6d6f 6469 6679 2069 and/or modify i │ │ │ -001ed050: 740a 202d 2020 756e 6465 7220 7468 6520 t. - under the │ │ │ -001ed060: 7465 726d 7320 6f66 2074 6865 2047 4e55 terms of the GNU │ │ │ -001ed070: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -001ed080: 4c69 6365 6e73 6520 6173 2070 7562 6c69 License as publi │ │ │ -001ed090: 7368 6564 2062 7920 7468 650a 202d 2020 shed by the. - │ │ │ -001ed0a0: 4672 6565 2053 6f66 7477 6172 6520 466f Free Software Fo │ │ │ -001ed0b0: 756e 6461 7469 6f6e 3b20 6f6e 6c79 2076 undation; only v │ │ │ -001ed0c0: 6572 7369 6f6e 2032 206f 6620 7468 6520 ersion 2 of the │ │ │ -001ed0d0: 4c69 6365 6e73 652c 2064 6174 6564 204a License, dated J │ │ │ -001ed0e0: 756e 6520 3139 3931 2e0a 202d 2020 0a20 une 1991.. - . │ │ │ -001ed0f0: 2d20 2054 6869 7320 7072 6f67 7261 6d20 - This program │ │ │ -001ed100: 6973 2064 6973 7472 6962 7574 6564 2069 is distributed i │ │ │ -001ed110: 6e20 7468 6520 686f 7065 2074 6861 7420 n the hope that │ │ │ -001ed120: 6974 2077 696c 6c20 6265 2075 7365 6675 it will be usefu │ │ │ -001ed130: 6c2c 2062 7574 0a20 2d20 2057 4954 484f l, but. - WITHO │ │ │ -001ed140: 5554 2041 4e59 2057 4152 5241 4e54 593b UT ANY WARRANTY; │ │ │ -001ed150: 2077 6974 686f 7574 2065 7665 6e20 7468 without even th │ │ │ -001ed160: 6520 696d 706c 6965 6420 7761 7272 616e e implied warran │ │ │ -001ed170: 7479 206f 660a 202d 2020 4d45 5243 4841 ty of. - MERCHA │ │ │ -001ed180: 4e54 4142 494c 4954 5920 6f72 2046 4954 NTABILITY or FIT │ │ │ -001ed190: 4e45 5353 2046 4f52 2041 2050 4152 5449 NESS FOR A PARTI │ │ │ -001ed1a0: 4355 4c41 5220 5055 5250 4f53 452e 2053 CULAR PURPOSE. S │ │ │ -001ed1b0: 6565 2074 6865 2047 4e55 0a20 2d20 2047 ee the GNU. - G │ │ │ -001ed1c0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -001ed1d0: 6365 6e73 6520 666f 7220 6d6f 7265 2064 cense for more d │ │ │ -001ed1e0: 6574 6169 6c73 2e0a 202d 2020 0a20 2d20 etails.. - . - │ │ │ -001ed1f0: 2059 6f75 2073 686f 756c 6420 6861 7665 You should have │ │ │ -001ed200: 2072 6563 6569 7665 6420 6120 636f 7079 received a copy │ │ │ -001ed210: 206f 6620 7468 6520 474e 5520 4765 6e65 of the GNU Gene │ │ │ -001ed220: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ -001ed230: 7365 2061 6c6f 6e67 0a20 2d20 2077 6974 se along. - wit │ │ │ -001ed240: 6820 7468 6973 2070 726f 6772 616d 3b20 h this program; │ │ │ -001ed250: 6966 206e 6f74 2c20 7772 6974 6520 746f if not, write to │ │ │ -001ed260: 2074 6865 2046 7265 6520 536f 6674 7761 the Free Softwa │ │ │ -001ed270: 7265 2046 6f75 6e64 6174 696f 6e2c 2049 re Foundation, I │ │ │ -001ed280: 6e63 2e2c 0a20 2d20 2035 3120 4672 616e nc.,. - 51 Fran │ │ │ -001ed290: 6b6c 696e 2053 742c 2046 6966 7468 2046 klin St, Fifth F │ │ │ -001ed2a0: 6c6f 6f72 2c20 426f 7374 6f6e 2c20 4d41 loor, Boston, MA │ │ │ -001ed2b0: 2030 3231 3130 2d31 3330 3120 5553 410a 02110-1301 USA. │ │ │ -001ed2c0: 202d 2020 0a20 2d20 200a 2d2d 3e0a 3c72 - . - .-->.<r │ │ │ -001ed2d0: 6566 656e 7472 7920 6964 3d22 666e 5f78 efentry id="fn_x │ │ │ -001ed2e0: 7065 725f 6c6f 6361 7465 5f77 6f72 6473 per_locate_words │ │ │ -001ed2f0: 223e 0a20 203c 7265 666d 6574 613e 0a20 ">. <refmeta>. │ │ │ -001ed300: 2020 203c 7265 6665 6e74 7279 7469 746c <refentrytitl │ │ │ -001ed310: 653e 7870 6572 5f6c 6f63 6174 655f 776f e>xper_locate_wo │ │ │ -001ed320: 7264 733c 2f72 6566 656e 7472 7974 6974 rds</refentrytit │ │ │ -001ed330: 6c65 3e0a 2020 2020 3c72 6566 6d69 7363 le>. <refmisc │ │ │ -001ed340: 696e 666f 3e78 6d6c 3c2f 7265 666d 6973 info>xml</refmis │ │ │ -001ed350: 6369 6e66 6f3e 0a20 203c 2f72 6566 6d65 cinfo>. </refme │ │ │ -001ed360: 7461 3e0a 2020 3c72 6566 6e61 6d65 6469 ta>. <refnamedi │ │ │ -001ed370: 763e 0a20 2020 203c 7265 666e 616d 653e v>. <refname> │ │ │ -001ed380: 7870 6572 5f6c 6f63 6174 655f 776f 7264 xper_locate_word │ │ │ -001ed390: 733c 2f72 6566 6e61 6d65 3e0a 2020 2020 s</refname>. │ │ │ -001ed3a0: 3c72 6566 7075 7270 6f73 653e 7265 7475 <refpurpose>retu │ │ │ -001ed3b0: 726e 7320 6120 736d 616c 6c65 7374 2066 rns a smallest f │ │ │ -001ed3c0: 7261 676d 656e 7420 6f66 2070 6572 7369 ragment of persi │ │ │ -001ed3d0: 7374 656e 7420 584d 4c20 656e 7469 7479 stent XML entity │ │ │ -001ed3e0: 206f 626a 6563 7420 2827 5850 4552 2065 object ('XPER e │ │ │ -001ed3f0: 6e74 6974 7927 2920 7375 6368 2074 6861 ntity') such tha │ │ │ -001ed400: 7420 6974 2063 6f6e 7461 696e 7320 736f t it contains so │ │ │ -001ed410: 6d65 2072 616e 6765 206f 6620 776f 7264 me range of word │ │ │ -001ed420: 7320 696e 2069 7473 2074 6578 743c 2f72 s in its text</r │ │ │ -001ed430: 6566 7075 7270 6f73 653e 0a20 203c 2f72 efpurpose>. </r │ │ │ -001ed440: 6566 6e61 6d65 6469 763e 0a20 203c 7265 efnamediv>. <re │ │ │ -001ed450: 6673 796e 6f70 7369 7364 6976 3e0a 2020 fsynopsisdiv>. │ │ │ -001ed460: 2020 3c66 756e 6373 796e 6f70 7369 7320 <funcsynopsis │ │ │ -001ed470: 6964 3d22 6673 796e 5f78 7065 725f 646f id="fsyn_xper_do │ │ │ -001ed480: 6322 3e0a 2020 2020 2020 3c66 756e 6370 c">. <funcp │ │ │ -001ed490: 726f 746f 7479 7065 2069 643d 2266 7072 rototype id="fpr │ │ │ -001ed4a0: 6f74 6f5f 7870 6572 5f64 6f63 223e 0a20 oto_xper_doc">. │ │ │ -001ed4b0: 2020 2020 2020 203c 6675 6e63 6465 663e <funcdef> │ │ │ -001ed4c0: 3c66 756e 6374 696f 6e3e 7870 6572 5f6c <function>xper_l │ │ │ -001ed4d0: 6f63 6174 655f 776f 7264 733c 2f66 756e ocate_words</fun │ │ │ -001ed4e0: 6374 696f 6e3e 3c2f 6675 6e63 6465 663e ction></funcdef> │ │ │ -001ed4f0: 0a20 2020 2020 2020 203c 7061 7261 6d64 . <paramd │ │ │ -001ed500: 6566 3e69 6e20 3c70 6172 616d 6574 6572 ef>in <parameter │ │ │ -001ed510: 3e65 6e74 6974 793c 2f70 6172 616d 6574 >entity</paramet │ │ │ -001ed520: 6572 3e61 6e79 3c2f 7061 7261 6d64 6566 er>any</paramdef │ │ │ -001ed530: 3e0a 2020 2020 2020 2020 3c70 6172 616d >. <param │ │ │ -001ed540: 6465 663e 3c6f 7074 696f 6e61 6c3e 696e def><optional>in │ │ │ -001ed550: 203c 7061 7261 6d65 7465 723e 7374 6172 <parameter>star │ │ │ -001ed560: 7469 6e67 5f77 6f72 643c 2f70 6172 616d ting_word</param │ │ │ -001ed570: 6574 6572 3e20 696e 7465 6765 723c 2f6f eter> integer</o │ │ │ -001ed580: 7074 696f 6e61 6c3e 3c2f 7061 7261 6d64 ptional></paramd │ │ │ -001ed590: 6566 3e0a 2020 2020 2020 2020 3c70 6172 ef>. <par │ │ │ -001ed5a0: 616d 6465 663e 3c6f 7074 696f 6e61 6c3e amdef><optional> │ │ │ -001ed5b0: 696e 203c 7061 7261 6d65 7465 723e 656e in <parameter>en │ │ │ -001ed5c0: 6469 6e67 5f77 6f72 643c 2f70 6172 616d ding_word</param │ │ │ -001ed5d0: 6574 6572 3e20 696e 7465 6765 723c 2f6f eter> integer</o │ │ │ -001ed5e0: 7074 696f 6e61 6c3e 3c2f 7061 7261 6d64 ptional></paramd │ │ │ -001ed5f0: 6566 3e0a 2020 2020 2020 3c2f 6675 6e63 ef>. </func │ │ │ -001ed600: 7072 6f74 6f74 7970 653e 0a20 2020 203c prototype>. < │ │ │ -001ed610: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ -001ed620: 203c 2f72 6566 7379 6e6f 7073 6973 6469 </refsynopsisdi │ │ │ -001ed630: 763e 0a20 203c 7265 6673 6563 7431 2069 v>. <refsect1 i │ │ │ -001ed640: 643d 2264 6573 6322 3e3c 7469 746c 653e d="desc"><title> │ │ │ -001ed650: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -001ed660: 6c65 3e0a 2020 2020 3c70 6172 613e 5468 le>. <para>Th │ │ │ -001ed670: 6973 2072 6563 6569 7665 7320 7468 6520 is receives the │ │ │ -001ed680: 584d 4c20 656e 7469 7479 2061 6e64 2072 XML entity and r │ │ │ -001ed690: 6574 7572 6e73 2069 7473 2066 7261 676d eturns its fragm │ │ │ -001ed6a0: 656e 7420 6f72 2073 6967 6e61 6c73 2061 ent or signals a │ │ │ -001ed6b0: 6e20 6572 726f 722e 3c2f 7061 7261 3e0a n error.</para>. │ │ │ -001ed6c0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -001ed6d0: 3c72 6566 7365 6374 3120 6964 3d22 7061 <refsect1 id="pa │ │ │ -001ed6e0: 7261 6d73 223e 3c74 6974 6c65 3e50 6172 rams"><title>Par │ │ │ -001ed6f0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -001ed700: 2020 2020 3c72 6566 7365 6374 323e 3c74 entity. │ │ │ -001ed730: 4120 2770 6572 7369 7374 656e 7420 584d A 'persistent XM │ │ │ -001ed740: 4c27 2065 6e74 6974 7920 746f 2062 6520 L' entity to be │ │ │ -001ed750: 7365 6172 6368 6564 3c2f 7061 7261 3e3c searched< │ │ │ -001ed760: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -001ed770: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -001ed780: 7374 6172 7469 6e67 5f77 6f72 643c 2f74 starting_word</t │ │ │ -001ed790: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001ed7a0: 613e 5468 6520 6e75 6d62 6572 206f 6620 a>The number of │ │ │ -001ed7b0: 7468 6520 6c65 6674 6d6f 7374 2077 6f72 the leftmost wor │ │ │ -001ed7c0: 6420 7768 6963 6820 7368 6f75 6c64 2062 d which should b │ │ │ -001ed7d0: 6520 696e 2074 6865 2073 656c 6563 7465 e in the selecte │ │ │ -001ed7e0: 6420 6672 6167 6d65 6e74 3c2f 7061 7261 d fragment</para │ │ │ -001ed7f0: 3e3c 2f72 6566 7365 6374 323e 0a20 2020 ></refsect2>. │ │ │ -001ed800: 203c 7265 6673 6563 7432 3e3c 7469 746c <refsect2><titl │ │ │ -001ed810: 653e 656e 6469 6e67 5f77 6f72 643c 2f74 e>ending_word</t │ │ │ -001ed820: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001ed830: 613e 5468 6520 6e75 6d62 6572 206f 6620 a>The number of │ │ │ -001ed840: 7468 6520 7269 6768 746d 6f73 7420 776f the rightmost wo │ │ │ -001ed850: 7264 2077 6869 6368 2073 686f 756c 6420 rd which should │ │ │ -001ed860: 6265 2069 6e20 7468 6520 7365 6c65 6374 be in the select │ │ │ -001ed870: 6564 2066 7261 676d 656e 743c 2f70 6172 ed fragment</par │ │ │ -001ed880: 613e 3c2f 7265 6673 6563 7432 3e0a 2020 a></refsect2>. │ │ │ -001ed890: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 </refsect1>.</re │ │ │ -001ed8a0: 6665 6e74 7279 3e0a 0a0a b600 0000 2064 fentry>....... d │ │ │ -001ed8b0: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -001ed8c0: 6566 2f78 7065 725f 646f 632e 786d 6cdf ef/xper_doc.xml. │ │ │ -001ed8d0: 0000 192a 3c3f 786d 6c20 7665 7273 696f ...*<?xml versio │ │ │ -001ed8e0: 6e3d 2231 2e30 2220 656e 636f 6469 6e67 n="1.0" encoding │ │ │ -001ed8f0: 3d22 4953 4f2d 3838 3539 2d31 223f 3e0a ="ISO-8859-1"?>. │ │ │ -001ed900: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 <!--. - . - Th │ │ │ -001ed910: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ -001ed920: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ -001ed930: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ -001ed940: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ -001ed950: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ -001ed960: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ -001ed970: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ -001ed980: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ -001ed990: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ -001ed9a0: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ -001ed9b0: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ -001ed9c0: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ -001ed9d0: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ -001ed9e0: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ -001ed9f0: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ -001eda00: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -001eda10: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ -001eda20: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ -001eda30: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ -001eda40: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ -001eda50: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ -001eda60: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ -001eda70: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ -001eda80: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ -001eda90: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ -001edaa0: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ -001edab0: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ -001edac0: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ -001edad0: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ -001edae0: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ -001edaf0: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ -001edb00: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ -001edb10: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ -001edb20: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ -001edb30: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ -001edb40: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ -001edb50: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ -001edb60: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ -001edb70: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ -001edb80: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ -001edb90: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ -001edba0: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ -001edbb0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -001edbc0: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ -001edbd0: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ -001edbe0: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ -001edbf0: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ -001edc00: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -001edc10: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ -001edc20: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ -001edc30: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ -001edc40: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ -001edc50: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ -001edc60: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .<refentry id="f │ │ │ -001edc70: 6e5f 7870 6572 5f64 6f63 223e 0a20 203c n_xper_doc">. < │ │ │ -001edc80: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. <re │ │ │ -001edc90: 6665 6e74 7279 7469 746c 653e 7870 6572 fentrytitle>xper │ │ │ -001edca0: 5f64 6f63 3c2f 7265 6665 6e74 7279 7469 _doc</refentryti │ │ │ -001edcb0: 746c 653e 0a20 2020 203c 7265 666d 6973 tle>. <refmis │ │ │ -001edcc0: 6369 6e66 6f3e 786d 6c3c 2f72 6566 6d69 cinfo>xml</refmi │ │ │ -001edcd0: 7363 696e 666f 3e0a 2020 3c2f 7265 666d scinfo>. </refm │ │ │ -001edce0: 6574 613e 0a20 203c 7265 666e 616d 6564 eta>. <refnamed │ │ │ -001edcf0: 6976 3e0a 2020 2020 3c72 6566 6e61 6d65 iv>. <refname │ │ │ -001edd00: 3e78 7065 725f 646f 633c 2f72 6566 6e61 >xper_doc</refna │ │ │ -001edd10: 6d65 3e0a 2020 2020 3c72 6566 7075 7270 me>. <refpurp │ │ │ -001edd20: 6f73 653e 7265 7475 726e 7320 616e 2065 ose>returns an e │ │ │ -001edd30: 6e74 6974 7920 6f62 6a65 6374 2028 2758 ntity object ('X │ │ │ -001edd40: 5045 5220 656e 7469 7479 2729 2063 7265 PER entity') cre │ │ │ -001edd50: 6174 6564 2066 726f 6d20 616e 2058 4d4c ated from an XML │ │ │ -001edd60: 2064 6f63 756d 656e 743c 2f72 6566 7075 document</refpu │ │ │ -001edd70: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ -001edd80: 6d65 6469 763e 0a20 203c 7265 6673 796e mediv>. <refsyn │ │ │ -001edd90: 6f70 7369 7364 6976 3e0a 2020 2020 3c66 opsisdiv>. <f │ │ │ -001edda0: 756e 6373 796e 6f70 7369 7320 6964 3d22 uncsynopsis id=" │ │ │ -001eddb0: 6673 796e 5f78 7065 725f 646f 6322 3e0a fsyn_xper_doc">. │ │ │ -001eddc0: 2020 2020 2020 3c66 756e 6370 726f 746f <funcproto │ │ │ -001eddd0: 7479 7065 2069 643d 2266 7072 6f74 6f5f type id="fproto_ │ │ │ -001edde0: 7870 6572 5f64 6f63 223e 0a20 2020 2020 xper_doc">. │ │ │ -001eddf0: 2020 203c 6675 6e63 6465 663e 3c66 756e <funcdef><fun │ │ │ -001ede00: 6374 696f 6e3e 7870 6572 5f64 6f63 3c2f ction>xper_doc</ │ │ │ -001ede10: 6675 6e63 7469 6f6e 3e3c 2f66 756e 6364 function></funcd │ │ │ -001ede20: 6566 3e0a 2020 2020 2020 2020 3c70 6172 ef>. <par │ │ │ -001ede30: 616d 6465 663e 696e 203c 7061 7261 6d65 amdef>in <parame │ │ │ -001ede40: 7465 723e 646f 6375 6d65 6e74 3c2f 7061 ter>document</pa │ │ │ -001ede50: 7261 6d65 7465 723e 2076 6172 6368 6172 rameter> varchar │ │ │ -001ede60: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -001ede70: 2020 2020 3c70 6172 616d 6465 663e 3c6f <paramdef><o │ │ │ -001ede80: 7074 696f 6e61 6c3e 696e 203c 7061 7261 ptional>in <para │ │ │ -001ede90: 6d65 7465 723e 7061 7273 6572 5f6d 6f64 meter>parser_mod │ │ │ -001edea0: 653c 2f70 6172 616d 6574 6572 3e20 696e e</parameter> in │ │ │ -001edeb0: 7465 6765 723c 2f6f 7074 696f 6e61 6c3e teger</optional> │ │ │ -001edec0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -001eded0: 2020 2020 3c70 6172 616d 6465 663e 3c6f <paramdef><o │ │ │ -001edee0: 7074 696f 6e61 6c3e 696e 203c 7061 7261 ptional>in <para │ │ │ -001edef0: 6d65 7465 723e 6261 7365 5f75 7269 3c2f meter>base_uri</ │ │ │ -001edf00: 7061 7261 6d65 7465 723e 2076 6172 6368 parameter> varch │ │ │ -001edf10: 6172 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 ar</optional></p │ │ │ -001edf20: 6172 616d 6465 663e 0a20 2020 2020 2020 aramdef>. │ │ │ -001edf30: 203c 7061 7261 6d64 6566 3e3c 6f70 7469 <paramdef><opti │ │ │ -001edf40: 6f6e 616c 3e69 6e20 3c70 6172 616d 6574 onal>in <paramet │ │ │ -001edf50: 6572 3e63 6f6e 7465 6e74 5f65 6e63 6f64 er>content_encod │ │ │ -001edf60: 696e 673c 2f70 6172 616d 6574 6572 3e20 ing</parameter> │ │ │ -001edf70: 7661 7263 6861 723c 2f6f 7074 696f 6e61 varchar</optiona │ │ │ -001edf80: 6c3e 3c2f 7061 7261 6d64 6566 3e0a 2020 l></paramdef>. │ │ │ -001edf90: 2020 2020 2020 3c70 6172 616d 6465 663e <paramdef> │ │ │ -001edfa0: 3c6f 7074 696f 6e61 6c3e 696e 203c 7061 <optional>in <pa │ │ │ -001edfb0: 7261 6d65 7465 723e 636f 6e74 656e 745f rameter>content_ │ │ │ -001edfc0: 6c61 6e67 7561 6765 3c2f 7061 7261 6d65 language</parame │ │ │ -001edfd0: 7465 723e 2076 6172 6368 6172 3c2f 6f70 ter> varchar</op │ │ │ -001edfe0: 7469 6f6e 616c 3e3c 2f70 6172 616d 6465 tional></paramde │ │ │ -001edff0: 663e 0a20 2020 2020 2020 203c 7061 7261 f>. <para │ │ │ -001ee000: 6d64 6566 3e3c 6f70 7469 6f6e 616c 3e69 mdef><optional>i │ │ │ -001ee010: 6e20 3c70 6172 616d 6574 6572 3e64 7464 n <parameter>dtd │ │ │ -001ee020: 5f76 616c 6964 6174 6f72 5f63 6f6e 6669 _validator_confi │ │ │ -001ee030: 673c 2f70 6172 616d 6574 6572 3e20 7661 g</parameter> va │ │ │ -001ee040: 7263 6861 723c 2f6f 7074 696f 6e61 6c3e rchar</optional> │ │ │ -001ee050: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -001ee060: 2020 2020 3c70 6172 616d 6465 663e 3c6f <paramdef><o │ │ │ -001ee070: 7074 696f 6e61 6c3e 696e 203c 7061 7261 ptional>in <para │ │ │ -001ee080: 6d65 7465 723e 696e 6465 785f 6174 7472 meter>index_attr │ │ │ -001ee090: 733c 2f70 6172 616d 6574 6572 3e20 696e s</parameter> in │ │ │ -001ee0a0: 7465 6765 723c 2f6f 7074 696f 6e61 6c3e teger</optional> │ │ │ -001ee0b0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -001ee0c0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 </funcprototyp │ │ │ -001ee0d0: 653e 0a20 2020 203c 2f66 756e 6373 796e e>. </funcsyn │ │ │ -001ee0e0: 6f70 7369 733e 0a20 203c 2f72 6566 7379 opsis>. </refsy │ │ │ -001ee0f0: 6e6f 7073 6973 6469 763e 0a20 203c 7265 nopsisdiv>. <re │ │ │ -001ee100: 6673 6563 7431 2069 643d 2264 6573 6322 fsect1 id="desc" │ │ │ -001ee110: 3e3c 7469 746c 653e 4465 7363 7269 7074 ><title>Descript │ │ │ -001ee120: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ -001ee130: 3c70 6172 613e 0a54 6869 7320 7061 7273 .This pars │ │ │ -001ee140: 6573 2074 6865 2061 7267 756d 656e 742c es the argument, │ │ │ -001ee150: 2077 6869 6368 2069 7320 6578 7065 6374 which is expect │ │ │ -001ee160: 6564 2074 6f20 6265 2061 2077 656c 6c20 ed to be a well │ │ │ -001ee170: 666f 726d 6564 2058 4d4c 0a66 7261 676d formed XML.fragm │ │ │ -001ee180: 656e 7420 616e 6420 7265 7475 726e 7320 ent and returns │ │ │ -001ee190: 6120 7061 7273 6520 7472 6565 2061 7320 a parse tree as │ │ │ -001ee1a0: 6120 7370 6563 6961 6c20 6f62 6a65 6374 a special object │ │ │ -001ee1b0: 2077 6974 6820 756e 6465 726c 7969 6e67 with underlying │ │ │ -001ee1c0: 2064 6973 6b20 7374 7275 6374 7572 652c disk structure, │ │ │ -001ee1d0: 206e 616d 6564 0a26 7175 6f74 3b70 6572 named."per │ │ │ -001ee1e0: 7369 7374 656e 7420 584d 4c26 7175 6f74 sistent XML" │ │ │ -001ee1f0: 3b20 6f72 2026 7175 6f74 3b58 5045 5226 ; or "XPER& │ │ │ -001ee200: 7175 6f74 3b0a 5768 696c 6520 7468 6520 quot;.While the │ │ │ -001ee210: 7265 7375 6c74 206f 6620 3c6c 696e 6b20 result of xml_tree is a memor │ │ │ -001ee250: 792d 7265 7369 6465 6e74 2061 7272 6179 y-resident array │ │ │ -001ee260: 206f 6620 7665 6374 6f72 732c 0a74 6865 of vectors,.the │ │ │ -001ee270: 2058 5045 5220 6f62 6a65 6374 2063 6f6e XPER object con │ │ │ -001ee280: 7375 6d65 7320 6f6e 6c79 2061 206c 6974 sumes only a lit │ │ │ -001ee290: 746c 6520 616d 6f75 6e74 206f 6620 6d65 tle amount of me │ │ │ -001ee2a0: 6d6f 7279 2c20 616e 6420 616c 6d6f 7374 mory, and almost │ │ │ -001ee2b0: 2061 6c6c 2064 6174 6120 6172 6520 6469 all data are di │ │ │ -001ee2c0: 736b 2d72 6573 6964 656e 742e 0a58 5045 sk-resident..XPE │ │ │ -001ee2d0: 5273 2061 7265 2062 6574 7465 7220 7468 Rs are better th │ │ │ -001ee2e0: 656e 2026 7175 6f74 3b58 4d4c 2074 7265 en "XML tre │ │ │ -001ee2f0: 6573 2671 756f 743b 2066 6f72 206c 6172 es" for lar │ │ │ -001ee300: 6765 2064 6f63 756d 656e 7473 2061 6e64 ge documents and │ │ │ -001ee310: 0a66 6f72 2026 7175 6f74 3b77 7269 7465 .for "write │ │ │ -001ee320: 206f 6e63 6520 2d2d 2072 6561 6420 6d61 once -- read ma │ │ │ -001ee330: 6e79 2671 756f 743b 2073 746f 7265 7320 ny" stores │ │ │ -001ee340: 7375 6368 2061 7320 6120 7461 626c 6520 such as a table │ │ │ -001ee350: 7769 7468 0a6f 6e65 2058 4d4c 2064 6f63 with.one XML doc │ │ │ -001ee360: 756d 656e 7420 7065 7220 726f 7720 7573 ument per row us │ │ │ -001ee370: 6564 2061 7320 6120 2671 756f 743b 6c69 ed as a "li │ │ │ -001ee380: 6272 6172 7926 7175 6f74 3b20 6f66 2064 brary" of d │ │ │ -001ee390: 6f63 756d 656e 7473 2e0a 546f 2062 6520 ocuments..To be │ │ │ -001ee3a0: 7361 7665 6420 696e 2061 204c 4f4e 4720 saved in a LONG │ │ │ -001ee3b0: 5641 5243 4841 5220 636f 6c75 6d6e 2c20 VARCHAR column, │ │ │ -001ee3c0: 2671 756f 743b 584d 4c20 7472 6565 2671 "XML tree&q │ │ │ -001ee3d0: 756f 743b 2065 6e74 6974 7920 7769 6c6c uot; entity will │ │ │ -001ee3e0: 2062 650a 636f 6e76 6572 7465 6420 6261 be.converted ba │ │ │ -001ee3f0: 636b 2074 6f20 706c 6169 6e20 7465 7874 ck to plain text │ │ │ -001ee400: 206f 6620 584d 4c20 7379 6e74 6178 3b20 of XML syntax; │ │ │ -001ee410: 6275 7420 2671 756f 743b 5850 4552 2671 but "XPER&q │ │ │ -001ee420: 756f 743b 2065 6e74 6974 790a 7769 6c6c uot; entity.will │ │ │ -001ee430: 2062 6520 7361 7665 6420 6173 2061 2072 be saved as a r │ │ │ -001ee440: 6561 6479 2d74 6f2d 7573 6520 6469 736b eady-to-use disk │ │ │ -001ee450: 2073 7472 7563 7475 7265 2e0a 093c 2f70 structure...

    . . Parameters
    . docume │ │ │ -001ee4c0: 6e74 3c2f 7469 746c 653e 0a20 2020 2020 nt. │ │ │ -001ee4d0: 203c 7061 7261 3e77 656c 6c20 666f 726d well form │ │ │ -001ee4e0: 6564 2058 4d4c 206f 7220 4854 4d4c 2064 ed XML or HTML d │ │ │ -001ee4f0: 6f63 756d 656e 743c 2f70 6172 613e 3c2f ocument. p │ │ │ -001ee520: 6172 7365 725f 6d6f 6465 3c2f 7469 746c arser_mode</titl │ │ │ -001ee530: 653e 0a20 2020 2020 203c 7061 7261 3e30 e>. <para>0 │ │ │ -001ee540: 2c20 3120 6f72 2032 3b20 3020 2d20 584d , 1 or 2; 0 - XM │ │ │ -001ee550: 4c20 7061 7273 6572 206d 6f64 652c 2031 L parser mode, 1 │ │ │ -001ee560: 202d 2048 544d 4c20 7061 7273 6572 206d - HTML parser m │ │ │ -001ee570: 6f64 652c 2032 202d 2027 6469 7274 7920 ode, 2 - 'dirty │ │ │ -001ee580: 4854 4d4c 270a 6d6f 6465 2028 7769 7468 HTML'.mode (with │ │ │ -001ee590: 2071 7569 6574 2072 6563 6f76 6572 7920 quiet recovery │ │ │ -001ee5a0: 6166 7465 7220 616e 7920 7379 6e74 6178 after any syntax │ │ │ -001ee5b0: 2065 7272 6f72 293c 2f70 6172 613e 3c2f error)</para></ │ │ │ -001ee5c0: 7265 6673 6563 7432 3e0a 2020 2020 3c72 refsect2>. <r │ │ │ -001ee5d0: 6566 7365 6374 323e 3c74 6974 6c65 3e62 efsect2><title>b │ │ │ -001ee5e0: 6173 655f 7572 693c 2f74 6974 6c65 3e0a ase_uri. │ │ │ -001ee5f0: 2020 2020 2020 3c70 6172 613e 696e 2048 in H │ │ │ -001ee600: 544d 4c20 7061 7273 6572 206d 6f64 6520 TML parser mode │ │ │ -001ee610: 6368 616e 6765 2061 6c6c 2061 6273 6f6c change all absol │ │ │ -001ee620: 7574 6520 7265 6665 7265 6e63 6573 2074 ute references t │ │ │ -001ee630: 6f20 7265 6c61 7469 7665 2066 726f 6d0a o relative from. │ │ │ -001ee640: 6769 7665 6e20 6261 7365 5f75 7269 2028 given base_uri ( │ │ │ -001ee650: 6874 7470 3a2f 2f26 6c74 3b68 6f73 7426 http://<host& │ │ │ -001ee660: 6774 3b3a 266c 743b 706f 7274 2667 743b gt;:<port> │ │ │ -001ee670: 2f26 6c74 3b70 6174 6826 6774 3b29 3c2f /<path>) │ │ │ -001ee690: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -001ee6a0: 7469 746c 653e 636f 6e74 656e 745f 656e title>content_en │ │ │ -001ee6b0: 636f 6469 6e67 3c2f 7469 746c 653e 0a20 coding. │ │ │ -001ee6c0: 2020 2020 203c 7061 7261 3e73 7472 696e strin │ │ │ -001ee6d0: 6720 7769 7468 2063 6f6e 7465 6e74 2065 g with content e │ │ │ -001ee6e0: 6e63 6f64 696e 6720 7479 7065 206f 6620 ncoding type of │ │ │ -001ee6f0: 266c 743b 646f 6375 6d65 6e74 2667 743b <document> │ │ │ -001ee700: 3b20 7661 6c69 6420 6172 650a 2741 5343 ; valid are.'ASC │ │ │ -001ee710: 4949 272c 2027 4953 4f27 2c20 2755 5446 II', 'ISO', 'UTF │ │ │ -001ee720: 3827 2c20 2749 534f 3838 3539 2d31 272c 8', 'ISO8859-1', │ │ │ -001ee730: 2027 4c41 5449 4e2d 3127 2065 7463 2e2c 'LATIN-1' etc., │ │ │ -001ee740: 2064 6566 6175 6c74 7320 6172 6520 2755 defaults are 'U │ │ │ -001ee750: 5446 2d38 2720 666f 720a 584d 4c20 6d6f TF-8' for.XML mo │ │ │ -001ee760: 6465 2061 6e64 2027 4c41 5449 4e2d 3127 de and 'LATIN-1' │ │ │ -001ee770: 2066 6f72 2048 544d 4c20 6d6f 6465 2e3c for HTML mode.< │ │ │ -001ee780: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ -001ee7a0: 3c74 6974 6c65 3e63 6f6e 7465 6e74 5f6c content_l │ │ │ -001ee7b0: 616e 6775 6167 653c 2f74 6974 6c65 3e0a anguage. │ │ │ -001ee7c0: 2020 2020 2020 3c70 6172 613e 7374 7269 stri │ │ │ -001ee7d0: 6e67 2077 6974 6820 6c61 6e67 7561 6765 ng with language │ │ │ -001ee7e0: 2074 6167 206f 6620 636f 6e74 656e 7420 tag of content │ │ │ -001ee7f0: 6f66 2026 6c74 3b64 6f63 756d 656e 7426 of <document& │ │ │ -001ee800: 6774 3b3b 2076 616c 6964 206e 616d 6573 gt;; valid names │ │ │ -001ee810: 0a61 7265 206c 6973 7465 6420 696e 2049 .are listed in I │ │ │ -001ee820: 4554 4620 5246 4320 3137 3636 2c20 6465 ETF RFC 1766, de │ │ │ -001ee830: 6661 756c 7420 6973 2027 782d 616e 7927 fault is 'x-any' │ │ │ -001ee840: 2028 6974 206d 6561 6e73 2027 6d69 7820 (it means 'mix │ │ │ -001ee850: 6f66 2077 6f72 6473 2066 726f 6d20 7661 of words from va │ │ │ -001ee860: 7269 6f75 730a 6875 6d61 6e20 6c61 6e67 rious.human lang │ │ │ -001ee870: 7561 6765 7329 3c2f 7061 7261 3e3c 2f72 uages). dt │ │ │ -001ee8a0: 645f 7661 6c69 6461 746f 725f 636f 6e66 d_validator_conf │ │ │ -001ee8b0: 6967 3c2f 7469 746c 653e 0a20 2020 2020 ig. │ │ │ -001ee8c0: 203c 7061 7261 3e63 6f6e 6669 6775 7261 configura │ │ │ -001ee8d0: 7469 6f6e 2073 7472 696e 6720 666f 7220 tion string for │ │ │ -001ee8e0: 4454 4420 7661 6c69 6461 746f 722c 2064 DTD validator, d │ │ │ -001ee8f0: 6566 6175 6c74 2069 7320 656d 7074 7920 efault is empty │ │ │ -001ee900: 7374 7269 6e67 206d 6561 6e69 6e67 0a74 string meaning.t │ │ │ -001ee910: 6861 7420 4454 4420 7661 6c69 6461 746f hat DTD validato │ │ │ -001ee920: 7220 7368 6f75 6c64 2062 6520 6675 6c6c r should be full │ │ │ -001ee930: 7920 6469 7361 626c 6564 2e0a 5365 6520 y disabled..See │ │ │ -001ee940: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2264 Confi │ │ │ -001ee960: 6775 7261 7469 6f6e 204f 7074 696f 6e73 guration Options │ │ │ -001ee970: 206f 6620 7468 6520 4454 4420 5661 6c69 of the DTD Vali │ │ │ -001ee980: 6461 746f 723c 2f6c 696e 6b3e 2066 6f72 dator for │ │ │ -001ee990: 2064 6574 6169 6c73 2e3c 2f70 6172 613e details. │ │ │ -001ee9a0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -001ee9b0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 index_attrs</ti │ │ │ -001ee9d0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -001ee9e0: 3e31 206f 7220 302c 2069 6e64 6963 6174 >1 or 0, indicat │ │ │ -001ee9f0: 696e 6720 6966 2061 6464 6974 696f 6e61 ing if additiona │ │ │ -001eea00: 6c20 6672 6565 2d74 6578 7420 696e 6465 l free-text inde │ │ │ -001eea10: 7869 6e67 2069 6e66 6f72 6d61 7469 6f6e xing information │ │ │ -001eea20: 206d 7573 7420 6265 0a73 746f 7265 6420 must be.stored │ │ │ -001eea30: 666f 7220 616c 6c20 6174 7472 6962 7574 for all attribut │ │ │ -001eea40: 6573 206f 6620 7468 6520 646f 6375 6d65 es of the docume │ │ │ -001eea50: 6e74 2e20 4974 2069 7320 3120 6279 2064 nt. It is 1 by d │ │ │ -001eea60: 6566 6175 6c74 2e20 4966 2073 6574 2074 efault. If set t │ │ │ -001eea70: 6f20 2730 272c 2069 7420 7769 6c6c 0a70 o '0', it will.p │ │ │ -001eea80: 726f 6475 6365 2061 2064 6973 6b20 7374 roduce a disk st │ │ │ -001eea90: 7275 6374 7572 6520 636f 6d70 6174 6962 ructure compatib │ │ │ -001eeaa0: 6c65 2077 6974 6820 6f6c 6420 7665 7273 le with old vers │ │ │ -001eeab0: 696f 6e73 206f 6620 5669 7274 756f 736f ions of Virtuoso │ │ │ -001eeac0: 2061 6e64 2077 696c 6c20 6769 7665 2061 and will give a │ │ │ -001eead0: 2073 6d61 6c6c 0a62 656e 6566 6974 2069 small.benefit i │ │ │ -001eeae0: 6e20 6469 736b 2075 7361 6765 2062 7574 n disk usage but │ │ │ -001eeaf0: 2069 7420 7769 6c6c 2064 6973 6162 6c65 it will disable │ │ │ -001eeb00: 2073 6f6d 6520 696d 706f 7274 616e 7420 some important │ │ │ -001eeb10: 6f70 7469 6d69 7a61 7469 6f6e 7320 696e optimizations in │ │ │ -001eeb20: 2066 7265 652d 7465 7874 0a73 6561 7263 free-text.searc │ │ │ -001eeb30: 6820 6f70 6572 6174 696f 6e73 2e3c 2f70 h operations.</p │ │ │ -001eeb40: 6172 613e 3c2f 7265 6673 6563 7432 3e0a ara></refsect2>. │ │ │ -001eeb50: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -001eeb60: 3c72 6566 7365 6374 3120 6964 3d22 7265 <refsect1 id="re │ │ │ -001eeb70: 7422 3e3c 7469 746c 653e 5265 7475 726e t"><title>Return │ │ │ -001eeb80: 2054 7970 6573 3c2f 7469 746c 653e 3c70 Types

    XML entity w │ │ │ -001eeba0: 6974 6820 756e 6465 726c 7969 6e67 0a70 ith underlying.p │ │ │ -001eebb0: 6172 7365 2074 7265 6520 6f66 2073 6f75 arse tree of sou │ │ │ -001eebc0: 7263 6520 646f 6375 6d65 6e74 3b20 7468 rce document; th │ │ │ -001eebd0: 6520 7472 6565 2077 696c 6c20 6265 2061 e tree will be a │ │ │ -001eebe0: 2073 7065 6369 616c 2073 6f72 7420 6f66 special sort of │ │ │ -001eebf0: 2042 4c4f 422e 3c2f 7061 7261 3e3c 2f72 BLOB... < │ │ │ -001eee10: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. Xper │ │ │ -001eee50: 5f44 6f63 3c2f 7469 746c 653e 0a3c 7363 _Doc..declare tr │ │ │ -001eee70: 6565 2061 6e79 3b0a 0a74 7265 6520 3a3d ee any;..tree := │ │ │ -001eee80: 2078 7065 725f 646f 6320 2866 696c 655f xper_doc (file_ │ │ │ -001eee90: 746f 5f73 7472 696e 6720 2827 646f 632e to_string ('doc. │ │ │ -001eeea0: 6874 6d6c 2729 2c20 312c 0a09 0927 6874 html'), 1,...'ht │ │ │ -001eeeb0: 7470 3a2f 2f6c 6f63 616c 686f 7374 2e6c tp://localhost.l │ │ │ -001eeec0: 6f63 616c 646f 6d61 696e 2f27 2c20 2749 ocaldomain/', 'I │ │ │ -001eeed0: 534f 2729 3b0a 2e2e 2e0a 7472 6565 203a SO');.....tree : │ │ │ -001eeee0: 3d20 7870 6572 5f64 6f63 2028 6669 6c65 = xper_doc (file │ │ │ -001eeef0: 5f74 6f5f 7374 7269 6e67 2028 2764 6f63 _to_string ('doc │ │ │ -001eef00: 2e78 6d6c 2729 293b 0a2e 2e2e 0a2d 2d20 .xml'));.....-- │ │ │ -001eef10: 5374 7269 6e67 2063 616e 6e6f 7420 6265 String cannot be │ │ │ -001eef20: 206c 6f6e 6765 7220 7468 616e 2031 3020 longer than 10 │ │ │ -001eef30: 6d65 6761 6279 7465 732e 2053 7472 696e megabytes. Strin │ │ │ -001eef40: 6720 7365 7373 696f 6e20 6361 6e2e 0a74 g session can..t │ │ │ -001eef50: 7265 6520 3a3d 2078 7065 725f 646f 6320 ree := xper_doc │ │ │ -001eef60: 2866 696c 655f 746f 5f73 7472 696e 675f (file_to_string_ │ │ │ -001eef70: 6f75 7470 7574 2028 2768 7567 655f 646f output ('huge_do │ │ │ -001eef80: 632e 786d 6c27 2929 3b0a 2e2e 2e0a 2d2d c.xml'));.....-- │ │ │ -001eef90: 2041 2073 7065 6369 616c 2077 6179 2074 A special way t │ │ │ -001eefa0: 6f20 7265 6164 206c 6f63 616c 2066 696c o read local fil │ │ │ -001eefb0: 6573 2e0a 2d2d 2053 7472 696e 6773 2073 es..-- Strings s │ │ │ -001eefc0: 7461 7274 6564 2066 726f 6d20 6368 6172 tarted from char │ │ │ -001eefd0: 6163 7465 7273 2027 6669 6c65 3a2f 2f27 acters 'file://' │ │ │ -001eefe0: 0a2d 2d20 6172 6520 7472 6561 7465 6420 .-- are treated │ │ │ -001eeff0: 6173 206c 6f63 616c 2066 696c 6573 7973 as local filesys │ │ │ -001ef000: 7465 6d20 5552 4973 2e0a 7472 6565 203a tem URIs..tree : │ │ │ -001ef010: 3d20 7870 6572 5f64 6f63 2028 2766 696c = xper_doc ('fil │ │ │ -001ef020: 653a 2f2f 646f 632e 786d 6c27 293b 0a3c e://doc.xml');.< │ │ │ -001ef030: 2f73 6372 6565 6e3e 0a20 2020 203c 2f65 /screen>. . . < │ │ │ -001ef070: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also. xt │ │ │ -001ef0b0: 7265 655f 646f 633c 2f6c 696e 6b3e 3c2f ree_doc. │ │ │ -001ef0d0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 │ │ │ -001ef0f0: 786d 6c5f 7472 6565 5f64 6f63 3c2f 6c69 xml_tree_doc. < │ │ │ -001ef110: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xper_cut │ │ │ -001ef140: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xper_rig │ │ │ -001ef180: 6874 5f73 6962 6c69 6e67 2c20 7870 6572 ht_sibling, xper │ │ │ -001ef190: 5f6c 6566 745f 7369 626c 696e 672c 2078 _left_sibling, x │ │ │ -001ef1a0: 7065 725f 7061 7265 6e74 2c20 7870 6572 per_parent, xper │ │ │ -001ef1b0: 5f72 6f6f 745f 656e 7469 7479 2c20 7870 _root_entity, xp │ │ │ -001ef1c0: 6572 5f74 656c 6c2c 2078 7065 725f 6c65 er_tell, xper_le │ │ │ -001ef1d0: 6e67 7468 3c2f 6c69 6e6b 3e3c 2f70 6172 ngth. │ │ │ -001ef1f0: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 ..... │ │ │ -001ef200: 0000 2064 656d 6f2f 646f 6373 7263 2f66 .. demo/docsrc/f │ │ │ -001ef210: 756e 6372 6566 2f78 7065 725f 6375 742e uncref/xper_cut. │ │ │ -001ef220: 786d 6cdf 0000 18cb 3c3f 786d 6c20 7665 xml....... │ │ │ -001ef5d0: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -001ef5e0: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -001ef5f0: 7870 6572 5f63 7574 3c2f 7265 6665 6e74 xper_cut. xml. . . xper_cut. creates │ │ │ -001ef680: 6120 6e65 7720 2671 756f 743b 7065 7273 a new "pers │ │ │ -001ef690: 6973 7465 6e74 2058 4d4c 2671 756f 743b istent XML" │ │ │ -001ef6a0: 646f 6375 6d65 6e74 2077 6869 6368 2063 document which c │ │ │ -001ef6b0: 6f6e 7461 696e 7320 6120 636f 7079 206f ontains a copy o │ │ │ -001ef6c0: 6620 6461 7461 2070 6f69 6e74 6564 2062 f data pointed b │ │ │ -001ef6d0: 7920 6769 7665 6e20 5850 4552 2065 6e74 y given XPER ent │ │ │ -001ef6e0: 6974 793c 2f72 6566 7075 7270 6f73 653e ity │ │ │ -001ef6f0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -001ef700: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . │ │ │ -001ef740: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ -001ef780: 7870 6572 5f63 7574 3c2f 6675 6e63 7469 xper_cut. │ │ │ -001ef7a0: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001ef7b0: 696e 203c 7061 7261 6d65 7465 723e 736f in so │ │ │ -001ef7c0: 7572 6365 5f78 7065 723c 2f70 6172 616d urce_xperXML_Entity< │ │ │ -001ef7e0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -001ef7f0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . │ │ │ -001ef840: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ -001ef850: 6f6e 3c2f 7469 746c 653e 0a09 093c 7061 on....As noted in │ │ │ -001ef870: 7468 6520 3c6c 696e 6b20 6c69 6e6b 656e the │ │ │ -001ef890: 5374 6f72 6167 6520 696e 2044 6174 6162 Storage in Datab │ │ │ -001ef8a0: 6173 653c 2f6c 696e 6b3e 2073 6563 7469 ase secti │ │ │ -001ef8b0: 6f6e 2c0a 6120 7375 6274 7265 6520 6d61 on,.a subtree ma │ │ │ -001ef8c0: 7920 6265 2065 7874 7261 6374 6564 2066 y be extracted f │ │ │ -001ef8d0: 726f 6d20 6120 646f 6375 6d65 6e74 2064 rom a document d │ │ │ -001ef8e0: 7572 696e 6720 7772 6974 696e 6720 6f66 uring writing of │ │ │ -001ef8f0: 2026 7175 6f74 3b70 6572 7369 7374 656e "persisten │ │ │ -001ef900: 7420 584d 4c26 7175 6f74 3b0a 656e 7469 t XML".enti │ │ │ -001ef910: 7479 2069 6e74 6f20 6669 656c 6420 6f66 ty into field of │ │ │ -001ef920: 2074 7970 6520 4c4f 4e47 2056 4152 4348 type LONG VARCH │ │ │ -001ef930: 4152 2e20 5468 6520 7072 6f63 6564 7572 AR. The procedur │ │ │ -001ef940: 6520 6f66 2063 6f6e 7665 7274 696e 6720 e of converting │ │ │ -001ef950: 6120 7375 6274 7265 6520 696e 746f 0a63 a subtree into.c │ │ │ -001ef960: 6f6d 706c 6574 6520 646f 6375 6d65 6e74 omplete document │ │ │ -001ef970: 2069 7320 6b6e 6f77 6e20 6173 2026 7175 is known as &qu │ │ │ -001ef980: 6f74 3b63 7574 7469 6e67 2671 756f 743b ot;cutting" │ │ │ -001ef990: 2e20 2043 7574 7469 6e67 2069 7320 7065 . Cutting is pe │ │ │ -001ef9a0: 7266 6f72 6d65 6420 6f6e 6c79 2066 6f72 rformed only for │ │ │ -001ef9b0: 0a26 7175 6f74 3b70 6572 7369 7374 656e ."persisten │ │ │ -001ef9c0: 7420 584d 4c26 7175 6f74 3b20 646f 6375 t XML" docu │ │ │ -001ef9d0: 6d65 6e74 732c 2069 7420 6861 7320 6e6f ments, it has no │ │ │ -001ef9e0: 7468 696e 6720 636f 6d6d 6f6e 2077 6974 thing common wit │ │ │ -001ef9f0: 6820 7365 7269 616c 697a 6174 696f 6e20 h serialization │ │ │ -001efa00: 6f66 0a58 4d4c 2065 6e74 6974 6965 7320 of.XML entities │ │ │ -001efa10: 696e 2066 6f72 6d20 6f66 2070 6c61 696e in form of plain │ │ │ -001efa20: 2058 4d4c 2074 6578 742e 3c2f 7061 7261 XML text.....Usual │ │ │ -001efa40: 6c79 2069 7420 6973 2074 6865 206a 6f62 ly it is the job │ │ │ -001efa50: 206f 6620 7468 6520 5365 7276 6572 2069 of the Server i │ │ │ -001efa60: 7473 656c 6620 7768 6f0a 6465 6369 6465 tself who.decide │ │ │ -001efa70: 7320 7768 6574 6865 7220 6120 6375 7474 s whether a cutt │ │ │ -001efa80: 696e 6720 6f70 6572 6174 696f 6e20 7368 ing operation sh │ │ │ -001efa90: 6f75 6c64 2062 6520 7065 7266 6f72 6d65 ould be performe │ │ │ -001efaa0: 6420 6f72 206e 6f74 2c20 7769 7468 6f75 d or not, withou │ │ │ -001efab0: 7420 616e 7920 7370 6563 6966 6963 0a61 t any specific.a │ │ │ -001efac0: 6374 6976 6974 7920 6174 2061 7070 6c69 ctivity at appli │ │ │ -001efad0: 6361 7469 6f6e 206c 6576 656c 2e0a 5468 cation level..Th │ │ │ -001efae0: 6520 4350 5520 7469 6d65 206f 6363 7570 e CPU time occup │ │ │ -001efaf0: 6965 6420 6475 6520 746f 2063 7574 7469 ied due to cutti │ │ │ -001efb00: 6e67 2069 7320 7570 2074 6f20 3130 2074 ng is up to 10 t │ │ │ -001efb10: 696d 6573 2067 7265 6174 6572 2074 6861 imes greater tha │ │ │ -001efb20: 6e20 7468 6520 4350 5520 7469 6d65 206f n the CPU time o │ │ │ -001efb30: 6620 706c 6169 6e20 636f 7079 696e 6720 f plain copying │ │ │ -001efb40: 6f66 204c 4f4e 4720 5641 5243 4841 522c of LONG VARCHAR, │ │ │ -001efb50: 0a62 7574 2074 6865 2061 6d6f 756e 7420 .but the amount │ │ │ -001efb60: 6f66 2064 6973 6b20 492f 4f20 6973 2061 of disk I/O is a │ │ │ -001efb70: 626f 7574 2074 6865 2073 616d 652c 2073 bout the same, s │ │ │ -001efb80: 6f20 7468 6520 6f70 7469 6d69 7a61 7469 o the optimizati │ │ │ -001efb90: 6f6e 2072 756c 6573 2064 6973 6375 7373 on rules discuss │ │ │ -001efba0: 6564 2062 656c 6f77 2061 7265 0a69 6d70 ed below are.imp │ │ │ -001efbb0: 6f72 7461 6e74 206f 6e6c 7920 666f 7220 ortant only for │ │ │ -001efbc0: 7469 6d65 2d63 7269 7469 6361 6c2c 206d time-critical, m │ │ │ -001efbd0: 656d 6f72 792d 6c6f 6361 7465 6420 6461 emory-located da │ │ │ -001efbe0: 7461 6261 7365 2061 7070 6c69 6361 7469 tabase applicati │ │ │ -001efbf0: 6f6e 732e 3c2f 7061 7261 3e0a 0909 3c70 ons....

    .The Virtuos │ │ │ -001efc10: 6f20 5365 7276 6572 2074 7269 6573 2074 o Server tries t │ │ │ -001efc20: 6f20 7265 6475 6365 2074 6865 206e 756d o reduce the num │ │ │ -001efc30: 6265 7220 6f66 2063 7574 7469 6e67 7320 ber of cuttings │ │ │ -001efc40: 746f 2061 6e20 6162 736f 6c75 7465 206d to an absolute m │ │ │ -001efc50: 696e 696d 756d 2e0a 4669 7273 7420 6f66 inimum..First of │ │ │ -001efc60: 2061 6c6c 2c20 6375 7474 696e 6720 6973 all, cutting is │ │ │ -001efc70: 206e 6f74 2070 6572 666f 726d 6564 2077 not performed w │ │ │ -001efc80: 6865 6e20 6120 6769 7665 6e20 584d 4c20 hen a given XML │ │ │ -001efc90: 656e 7469 7479 0a72 6566 6572 7320 746f entity.refers to │ │ │ -001efca0: 2074 6865 2072 6f6f 7420 6f66 2074 6865 the root of the │ │ │ -001efcb0: 2064 6f63 756d 656e 742c 206f 7220 746f document, or to │ │ │ -001efcc0: 2074 6865 206f 6e6c 7920 6368 696c 6420 the only child │ │ │ -001efcd0: 6f66 2074 6865 2072 6f6f 742c 0a62 6563 of the root,.bec │ │ │ -001efce0: 6175 7365 2074 6865 2072 6573 756c 7420 ause the result │ │ │ -001efcf0: 6f66 2073 7563 6820 6375 7474 696e 6720 of such cutting │ │ │ -001efd00: 7769 6c6c 2062 6520 6964 656e 7469 6361 will be identica │ │ │ -001efd10: 6c20 746f 206f 7269 6769 6e61 6c20 646f l to original do │ │ │ -001efd20: 6375 6d65 6e74 2e0a 496e 2061 6464 6974 cument..In addit │ │ │ -001efd30: 696f 6e2c 2065 7665 7279 2064 6f63 756d ion, every docum │ │ │ -001efd40: 656e 7420 7265 6d65 6d62 6572 7320 7468 ent remembers th │ │ │ -001efd50: 6520 7265 7375 6c74 206f 6620 6c61 7374 e result of last │ │ │ -001efd60: 2063 7574 7469 6e67 2070 6572 666f 726d cutting perform │ │ │ -001efd70: 6564 206f 6e20 6461 7461 2066 726f 6d0a ed on data from. │ │ │ -001efd80: 7468 6973 2064 6f63 756d 656e 742c 2073 this document, s │ │ │ -001efd90: 6f20 6966 2064 6174 6120 6f66 2073 6f6d o if data of som │ │ │ -001efda0: 6520 584d 4c20 656e 7469 7479 2061 7265 e XML entity are │ │ │ -001efdb0: 2073 6176 6564 2069 6e20 6d61 6e79 2070 saved in many p │ │ │ -001efdc0: 6c61 6365 7320 7769 7468 6f75 7420 7361 laces without sa │ │ │ -001efdd0: 7669 6e67 206f 660a 6f74 6865 7220 584d ving of.other XM │ │ │ -001efde0: 4c20 656e 7469 7469 6573 2062 6574 7765 L entities betwe │ │ │ -001efdf0: 656e 2074 6865 6d2c 2063 7574 7469 6e67 en them, cutting │ │ │ -001efe00: 2077 696c 6c20 6265 2064 6f6e 6520 6f6e will be done on │ │ │ -001efe10: 6c79 206f 6e63 6520 616e 6420 706c 6169 ly once and plai │ │ │ -001efe20: 6e20 636f 7079 696e 6720 7769 6c6c 0a62 n copying will.b │ │ │ -001efe30: 6520 646f 6e65 2066 6f72 2065 7665 7279 e done for every │ │ │ -001efe40: 2073 7562 7365 7175 656e 7420 7361 7669 subsequent savi │ │ │ -001efe50: 6e67 2e3c 2f70 6172 613e 0a09 093c 7061 ng.....The only sit │ │ │ -001efe70: 7561 7469 6f6e 2077 6865 6e20 6375 7474 uation when cutt │ │ │ -001efe80: 696e 6720 6d61 7920 6265 2073 6572 696f ing may be serio │ │ │ -001efe90: 7573 6c79 206f 7074 696d 697a 6564 2062 usly optimized b │ │ │ -001efea0: 7920 7468 6520 6170 706c 6963 6174 696f y the applicatio │ │ │ -001efeb0: 6e20 6465 7665 6c6f 7065 7220 6973 2069 n developer is i │ │ │ -001efec0: 6e20 636f 6465 0a6c 696b 6520 7468 6520 n code.like the │ │ │ -001efed0: 666f 6c6c 6f77 696e 673a 3c2f 7061 7261 following:..declare _blan │ │ │ -001eff00: 6b5f 666f 726d 732c 205f 706c 6169 6e2c k_forms, _plain, │ │ │ -001eff10: 205f 6973 646e 2061 6e79 3b0a 5f62 6c61 _isdn any;._bla │ │ │ -001eff20: 6e6b 5f66 6f72 6d73 203a 3d20 786d 6c5f nk_forms := xml_ │ │ │ -001eff30: 7065 7273 6973 7465 6e74 2028 2766 696c persistent ('fil │ │ │ -001eff40: 653a 2f2f 626c 616e 6b5f 666f 726d 732e e://blank_forms. │ │ │ -001eff50: 786d 6c27 293b 0a5f 706c 6169 6e20 3d20 xml');._plain = │ │ │ -001eff60: 7870 6174 685f 6576 616c 2028 2661 706f xpath_eval (&apo │ │ │ -001eff70: 733b 2f66 6f72 6d73 2f66 6f72 6d5b 406e s;/forms/form[@n │ │ │ -001eff80: 616d 6520 3d20 2661 706f 733b 2661 706f ame = '&apo │ │ │ -001eff90: 733b 5068 6f6e 6520 496e 7374 616c 6c61 s;Phone Installa │ │ │ -001effa0: 7469 6f6e 2661 706f 733b 2661 706f 733b tion'' │ │ │ -001effb0: 5d26 6170 6f73 3b2c 205f 626c 616e 6b5f ]', _blank_ │ │ │ -001effc0: 666f 726d 7329 3b0a 5f69 7364 6e20 3d20 forms);._isdn = │ │ │ -001effd0: 7870 6174 685f 6576 616c 2028 2661 706f xpath_eval (&apo │ │ │ -001effe0: 733b 2f66 6f72 6d73 2f66 6f72 6d5b 406e s;/forms/form[@n │ │ │ -001efff0: 616d 6520 3d20 2661 706f 733b 2661 706f ame = '&apo │ │ │ -001f0000: 733b 4953 444e 2049 6e73 7461 6c6c 6174 s;ISDN Installat │ │ │ -001f0010: 696f 6e26 6170 6f73 3b26 6170 6f73 3b5d ion''] │ │ │ -001f0020: 2661 706f 733b 2c20 5f62 6c61 6e6b 5f66 ', _blank_f │ │ │ -001f0030: 6f72 6d73 293b 0a66 6f72 2073 656c 6563 orms);.for selec │ │ │ -001f0040: 7420 4944 2061 7320 5f69 642c 2053 4552 t ID as _id, SER │ │ │ -001f0050: 5649 4345 2061 7320 5f73 6572 7669 6365 VICE as _service │ │ │ -001f0060: 2c20 4144 4452 4553 5320 6173 205f 6164 , ADDRESS as _ad │ │ │ -001f0070: 6472 6573 7320 6672 6f6d 2043 4c49 454e dress from CLIEN │ │ │ -001f0080: 5453 2064 6f0a 7b0a 2020 6966 2028 6973 TS do.{. if (is │ │ │ -001f0090: 5f69 7364 6e28 5f73 6572 7669 6365 2929 _isdn(_service)) │ │ │ -001f00a0: 0a20 2020 207b 0a20 2020 2020 2069 6e73 . {. ins │ │ │ -001f00b0: 6572 7420 696e 746f 204a 4f42 5f44 4554 ert into JOB_DET │ │ │ -001f00c0: 4149 4c53 2028 4944 2c20 5155 4552 595f AILS (ID, QUERY_ │ │ │ -001f00d0: 584d 4c29 2076 616c 7565 7320 285f 6964 XML) values (_id │ │ │ -001f00e0: 2c20 5f69 7364 6e29 3b0a 2020 2020 7d0a , _isdn);. }. │ │ │ -001f00f0: 2020 656c 7365 0a20 2020 207b 0a20 2020 else. {. │ │ │ -001f0100: 2020 2069 6e73 6572 7420 696e 746f 204a insert into J │ │ │ -001f0110: 4f42 5f44 4554 4149 4c53 2028 4944 2c20 OB_DETAILS (ID, │ │ │ -001f0120: 5155 4552 595f 584d 4c29 2076 616c 7565 QUERY_XML) value │ │ │ -001f0130: 7320 285f 6964 2c20 5f70 6c61 696e 293b s (_id, _plain); │ │ │ -001f0140: 0a20 2020 207d 0a7d 0a3c 2f70 726f 6772 . }.}.....Calls of xpa │ │ │ -001f0170: 7468 5f65 7661 6c20 6172 6520 6f75 7473 th_eval are outs │ │ │ -001f0180: 6964 6520 7468 6520 6c6f 6f70 2c20 736f ide the loop, so │ │ │ -001f0190: 2069 7420 6973 2066 6173 7465 7220 7468 it is faster th │ │ │ -001f01a0: 616e 2072 6574 7269 6576 616c 206f 6620 an retrieval of │ │ │ -001f01b0: 7375 6974 6162 6c65 2066 6f72 6d20 666f suitable form fo │ │ │ -001f01c0: 720a 6576 6572 7920 7365 6c65 6374 6564 r.every selected │ │ │ -001f01d0: 2072 6563 6f72 642e 2020 4275 7420 7661 record. But va │ │ │ -001f01e0: 6c75 6573 206f 6620 626f 7468 205f 706c lues of both _pl │ │ │ -001f01f0: 6169 6e20 616e 6420 5f69 7364 6e20 7368 ain and _isdn sh │ │ │ -001f0200: 6172 6573 2074 6865 2073 616d 6520 756e ares the same un │ │ │ -001f0210: 6465 726c 7969 6e67 2058 4d4c 2064 6f63 derlying XML doc │ │ │ -001f0220: 756d 656e 740a 616e 6420 7468 6579 2077 ument.and they w │ │ │ -001f0230: 696c 6c20 6265 2061 7373 6967 6e65 6420 ill be assigned │ │ │ -001f0240: 6d61 6e79 2074 696d 6573 2062 7920 7468 many times by th │ │ │ -001f0250: 6520 2769 6e73 6572 7427 206f 7065 7261 e 'insert' opera │ │ │ -001f0260: 7469 6f6e 2e20 2054 6865 2058 4d4c 2064 tion. The XML d │ │ │ -001f0270: 6f63 756d 656e 7420 6861 7320 6e6f 2070 ocument has no p │ │ │ -001f0280: 6c61 6365 2074 6f20 6361 6368 650a 7477 lace to cache.tw │ │ │ -001f0290: 6f20 7265 7375 6c74 7320 6f66 2063 7574 o results of cut │ │ │ -001f02a0: 7469 6e67 732c 2073 6f20 6e65 7720 6375 tings, so new cu │ │ │ -001f02b0: 7474 696e 6720 7769 6c6c 2062 6520 646f tting will be do │ │ │ -001f02c0: 6e65 2065 7665 7279 2074 696d 650a 7768 ne every time.wh │ │ │ -001f02d0: 656e 205f 6973 646e 2065 6e74 6974 7920 en _isdn entity │ │ │ -001f02e0: 6973 2073 6176 6564 2061 6674 6572 205f is saved after _ │ │ │ -001f02f0: 706c 6169 6e20 6f72 205f 706c 6169 6e20 plain or _plain │ │ │ -001f0300: 7361 7665 6420 6166 7465 7220 5f69 7364 saved after _isd │ │ │ -001f0310: 6e2e 2020 546f 206f 7074 696d 697a 652c n. To optimize, │ │ │ -001f0320: 2069 7420 6973 2062 6574 7465 7220 746f it is better to │ │ │ -001f0330: 0a63 7574 2074 6865 6d20 6f6e 6365 206f .cut them once o │ │ │ -001f0340: 7574 7369 6465 2074 6865 206c 6f6f 703a utside the loop: │ │ │ -001f0350: 3c2f 7061 7261 3e0a 0a3c 7072 6f67 7261 ...declar │ │ │ -001f0370: 6520 5f62 6c61 6e6b 5f66 6f72 6d73 2c20 e _blank_forms, │ │ │ -001f0380: 5f70 6c61 696e 2c20 5f69 7364 6e20 616e _plain, _isdn an │ │ │ -001f0390: 793b 0a5f 626c 616e 6b5f 666f 726d 7320 y;._blank_forms │ │ │ -001f03a0: 3a3d 2078 6d6c 5f70 6572 7369 7374 656e := xml_persisten │ │ │ -001f03b0: 7420 2827 6669 6c65 3a2f 2f62 6c61 6e6b t ('file://blank │ │ │ -001f03c0: 5f66 6f72 6d73 2e78 6d6c 2729 3b0a 5f70 _forms.xml');._p │ │ │ -001f03d0: 6c61 696e 203d 2078 7065 725f 6375 7420 lain = xper_cut │ │ │ -001f03e0: 2878 7061 7468 5f65 7661 6c20 2826 6170 (xpath_eval (&ap │ │ │ -001f03f0: 6f73 3b2f 666f 726d 732f 666f 726d 5b40 os;/forms/form[@ │ │ │ -001f0400: 6e61 6d65 203d 2026 6170 6f73 3b26 6170 name = '&ap │ │ │ -001f0410: 6f73 3b50 686f 6e65 2049 6e73 7461 6c6c os;Phone Install │ │ │ -001f0420: 6174 696f 6e26 6170 6f73 3b26 6170 6f73 ation'&apos │ │ │ -001f0430: 3b5d 2661 706f 733b 2c20 5f62 6c61 6e6b ;]', _blank │ │ │ -001f0440: 5f66 6f72 6d73 2929 3b0a 5f69 7364 6e20 _forms));._isdn │ │ │ -001f0450: 3d20 7870 6572 5f63 7574 2028 7870 6174 = xper_cut (xpat │ │ │ -001f0460: 685f 6576 616c 2028 2661 706f 733b 2f66 h_eval ('/f │ │ │ -001f0470: 6f72 6d73 2f66 6f72 6d5b 406e 616d 6520 orms/form[@name │ │ │ -001f0480: 3d20 2661 706f 733b 2661 706f 733b 4953 = ''IS │ │ │ -001f0490: 444e 2049 6e73 7461 6c6c 6174 696f 6e26 DN Installation& │ │ │ -001f04a0: 6170 6f73 3b26 6170 6f73 3b5d 2661 706f apos;']&apo │ │ │ -001f04b0: 733b 2c20 5f62 6c61 6e6b 5f66 6f72 6d73 s;, _blank_forms │ │ │ -001f04c0: 2929 3b0a 666f 7220 7365 6c65 6374 2049 ));.for select I │ │ │ -001f04d0: 4420 6173 205f 6964 2c20 5345 5256 4943 D as _id, SERVIC │ │ │ -001f04e0: 4520 6173 205f 7365 7276 6963 6520 6672 E as _service fr │ │ │ -001f04f0: 6f6d 2043 4c49 454e 5453 2064 6f0a 7b0a om CLIENTS do.{. │ │ │ -001f0500: 2020 6966 2028 6973 5f69 7364 6e28 5f73 if (is_isdn(_s │ │ │ -001f0510: 6572 7669 6365 2929 0a20 2020 207b 0a2d ervice)). {.- │ │ │ -001f0520: 2d20 5f69 7364 6e20 656e 7469 7479 2070 - _isdn entity p │ │ │ -001f0530: 6f69 6e74 7320 746f 2074 6865 2072 6f6f oints to the roo │ │ │ -001f0540: 7420 6f66 2069 7473 206f 776e 2064 6f63 t of its own doc │ │ │ -001f0550: 756d 656e 742c 2063 7574 7469 6e67 2069 ument, cutting i │ │ │ -001f0560: 7320 6e6f 7420 6e65 6564 6564 2066 6f72 s not needed for │ │ │ -001f0570: 2072 6f6f 742e 0a20 2020 2020 2069 6e73 root.. ins │ │ │ -001f0580: 6572 7420 696e 746f 204a 4f42 5f44 4554 ert into JOB_DET │ │ │ -001f0590: 4149 4c53 2028 4944 2c20 5155 4552 595f AILS (ID, QUERY_ │ │ │ -001f05a0: 584d 4c29 2076 616c 7565 7320 285f 6964 XML) values (_id │ │ │ -001f05b0: 2c20 5f69 7364 6e29 3b0a 2020 2020 7d0a , _isdn);. }. │ │ │ -001f05c0: 2020 656c 7365 0a20 2020 207b 0a2d 2d20 else. {.-- │ │ │ -001f05d0: 7369 6d69 6c61 726c 792c 205f 706c 6169 similarly, _plai │ │ │ -001f05e0: 6e20 656e 7469 7479 2070 6f69 6e74 7320 n entity points │ │ │ -001f05f0: 746f 2074 6865 2072 6f6f 7420 6f66 2069 to the root of i │ │ │ -001f0600: 7473 206f 776e 2064 6f63 756d 656e 742e ts own document. │ │ │ -001f0610: 0a20 2020 2020 2069 6e73 6572 7420 696e . insert in │ │ │ -001f0620: 746f 204a 4f42 5f44 4554 4149 4c53 2028 to JOB_DETAILS ( │ │ │ -001f0630: 4944 2c20 5155 4552 595f 584d 4c29 2076 ID, QUERY_XML) v │ │ │ -001f0640: 616c 7565 7320 285f 6964 2c20 5f70 6c61 alues (_id, _pla │ │ │ -001f0650: 696e 293b 0a20 2020 207d 0a7d 0a2d 2d20 in);. }.}.-- │ │ │ -001f0660: 4966 206e 6f20 7265 636f 7264 7320 666f If no records fo │ │ │ -001f0670: 756e 6420 6279 2074 6865 2027 7365 6c65 und by the 'sele │ │ │ -001f0680: 6374 2720 616e 6420 6e6f 2069 6e73 6572 ct' and no inser │ │ │ -001f0690: 7473 2064 6f6e 652c 0a2d 2d20 7468 656e ts done,.-- then │ │ │ -001f06a0: 2077 6527 7665 206d 6164 6520 7477 6f20 we've made two │ │ │ -001f06b0: 6375 7473 2066 6f72 206e 6f74 6869 6e67 cuts for nothing │ │ │ -001f06c0: 2e2e 2e0a 3c2f 7072 6f67 7261 6d6c 6973 ..... .The current n │ │ │ -001f06f0: 6f64 6520 6f66 2074 6865 2072 6573 756c ode of the resul │ │ │ -001f0700: 7469 6e67 2065 6e74 6974 7920 6973 2074 ting entity is t │ │ │ -001f0710: 6865 206e 6f64 6520 7468 6174 2069 7320 he node that is │ │ │ -001f0720: 6120 636f 7079 0a6f 6620 7468 6520 6375 a copy.of the cu │ │ │ -001f0730: 7272 656e 7420 6e6f 6465 206f 6620 7468 rrent node of th │ │ │ -001f0740: 6520 736f 7572 6365 2065 6e74 6974 792e e source entity. │ │ │ -001f0750: 2049 6e20 636f 6d6d 6f6e 2c0a 7468 6520 In common,.the │ │ │ -001f0760: 746f 702d 6c65 7665 6c20 6e6f 6465 206f top-level node o │ │ │ -001f0770: 6620 7468 6520 636f 7069 6564 2073 7562 f the copied sub │ │ │ -001f0780: 7472 6565 2062 6563 6f6d 6573 2074 6865 tree becomes the │ │ │ -001f0790: 2063 7572 7265 6e74 206e 6f64 6520 6f66 current node of │ │ │ -001f07a0: 2074 6865 2072 6573 756c 742e 0a54 6865 the result..The │ │ │ -001f07b0: 7265 2061 7265 2074 776f 2073 7065 6369 re are two speci │ │ │ -001f07c0: 616c 2063 6173 6573 2c20 686f 7765 7665 al cases, howeve │ │ │ -001f07d0: 722e 2049 6620 7468 6520 736f 7572 6365 r. If the source │ │ │ -001f07e0: 2065 6e74 6974 7920 6973 2061 6e20 6174 entity is an at │ │ │ -001f07f0: 7472 6962 7574 6520 656e 7469 7479 2c0a tribute entity,. │ │ │ -001f0800: 7468 656e 2074 6865 2072 6573 756c 7420 then the result │ │ │ -001f0810: 6973 2061 6c73 6f20 616e 2061 7474 7269 is also an attri │ │ │ -001f0820: 6275 7465 2065 6e74 6974 7920 616e 6420 bute entity and │ │ │ -001f0830: 7468 6520 6174 7472 6962 7574 6520 6e61 the attribute na │ │ │ -001f0840: 6d65 2072 656d 6169 6e73 2074 6865 2073 me remains the s │ │ │ -001f0850: 616d 652e 0a49 6620 7468 6520 736f 7572 ame..If the sour │ │ │ -001f0860: 6365 2065 6e74 6974 7920 706f 696e 7473 ce entity points │ │ │ -001f0870: 2074 6f20 7468 6520 726f 6f74 206f 6620 to the root of │ │ │ -001f0880: 7468 6520 646f 6375 6d65 6e74 2c20 7468 the document, th │ │ │ -001f0890: 6520 7265 7375 6c74 696e 6720 656e 7469 e resulting enti │ │ │ -001f08a0: 7479 0a61 6c73 6f20 706f 696e 7473 2074 ty.also points t │ │ │ -001f08b0: 6f20 7468 6520 726f 6f74 2c20 6e6f 7420 o the root, not │ │ │ -001f08c0: 746f 2069 7473 2074 6f70 2d6c 6576 656c to its top-level │ │ │ -001f08d0: 206e 6f64 652e 0a20 2020 2020 203c 2f70 node..

    . . Parameters. source │ │ │ -001f0940: 5f78 7065 723c 2f74 6974 6c65 3e0a 2020 _xper. │ │ │ -001f0950: 2020 2020 3c70 6172 613e 584d 4c20 456e XML En │ │ │ -001f0960: 7469 7479 3c2f 7061 7261 3e3c 2f72 6566 tity
    . . See Also. │ │ │ -001f09c0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xml_d │ │ │ -001f09e0: 6f63 2829 3c2f 6c69 6e6b 3e3c 2f70 6172 oc().
  • xper_do │ │ │ -001f0a20: 6328 293c 2f6c 696e 6b3e 3c2f 7061 7261 c(). xper_right_sib │ │ │ -001f0a70: 6c69 6e67 2829 2c20 7870 6572 5f6c 6566 ling(), xper_lef │ │ │ -001f0a80: 745f 7369 626c 696e 6728 292c 2078 7065 t_sibling(), xpe │ │ │ -001f0a90: 725f 7061 7265 6e74 2829 2c20 7870 6572 r_parent(), xper │ │ │ -001f0aa0: 5f72 6f6f 745f 656e 7469 7479 2829 2c20 _root_entity(), │ │ │ -001f0ab0: 7870 6572 5f74 656c 6c28 292c 2078 7065 xper_tell(), xpe │ │ │ -001f0ac0: 725f 6c65 6e67 7468 2829 3c2f 6c69 6e6b r_length(). ......"demo/doc │ │ │ -001f0b00: 7372 632f 6675 6e63 7265 662f 7870 6174 src/funcref/xpat │ │ │ -001f0b10: 685f 6576 616c 2e78 6d6c df00 0026 f83c h_eval.xml...&.< │ │ │ -001f0b20: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -001f0b30: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -001f0b40: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . xpath_e │ │ │ -001f0ef0: 7661 6c3c 2f72 6566 656e 7472 7974 6974 val. xml. . . │ │ │ -001f0f50: 7870 6174 685f 6576 616c 3c2f 7265 666e xpath_eval. Applies an │ │ │ -001f0f80: 5850 4154 4820 6578 7072 6573 7369 6f6e XPATH expression │ │ │ -001f0f90: 2074 6f20 6120 636f 6e74 6578 7420 6e6f to a context no │ │ │ -001f0fa0: 6465 2061 6e64 2072 6574 7572 6e73 2072 de and returns r │ │ │ -001f0fb0: 6573 756c 7428 7329 2e3c 2f72 6566 7075 esult(s).. . . . . │ │ │ -001f1040: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ -001f1050: 3c66 756e 6374 696f 6e3e 7870 6174 685f xpath_ │ │ │ -001f1060: 6576 616c 3c2f 6675 6e63 7469 6f6e 3e3c eval< │ │ │ -001f1070: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -001f1080: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -001f1090: 7061 7261 6d65 7465 723e 7870 6174 685f parameter>xpath_ │ │ │ -001f10a0: 6578 7072 6573 7369 6f6e 203c 2f70 6172 expression varchar. │ │ │ -001f10d0: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -001f10e0: 7061 7261 6d65 7465 723e 786d 6c5f 7472 parameter>xml_tr │ │ │ -001f10f0: 6565 203c 2f70 6172 616d 6574 6572 3e58 ee X │ │ │ -001f1100: 4d4c 2045 6e74 6974 793c 2f70 6172 616d ML Entity. in i │ │ │ -001f1140: 6e64 6578 203c 2f70 6172 616d 6574 6572 ndex integer. │ │ │ -001f1170: 2020 2020 2020 203c 7061 7261 6d64 6566 in

    named_p │ │ │ -001f11a0: 6172 616d 733c 2f70 6172 616d 6574 6572 arams vector. │ │ │ -001f11d0: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ -001f1210: 3c72 6566 7365 6374 3120 6964 3d22 6465 . │ │ │ -001f1230: 2020 2020 3c74 6974 6c65 3e44 6573 6372 Descr │ │ │ -001f1240: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ -001f1250: 2020 203c 7061 7261 3e0a 5468 6973 2066 .This f │ │ │ -001f1260: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ -001f1270: 7468 6520 7265 7375 6c74 206f 6620 6170 the result of ap │ │ │ -001f1280: 706c 7969 6e67 2074 6865 2058 5061 7468 plying the XPath │ │ │ -001f1290: 0a65 7870 7265 7373 696f 6e20 746f 2074 .expression to t │ │ │ -001f12a0: 6865 2063 6f6e 7465 7874 206e 6f64 652e he context node. │ │ │ -001f12b0: 2020 4279 2064 6566 6175 6c74 206f 6e6c By default onl │ │ │ -001f12c0: 7920 7468 6520 6669 7273 7420 7265 7375 y the first resu │ │ │ -001f12d0: 6c74 2069 730a 7265 7475 726e 6564 2c20 lt is.returned, │ │ │ -001f12e0: 6275 7420 7375 7070 6c79 696e 6720 6120 but supplying a │ │ │ -001f12f0: 7468 6972 6420 6172 6775 6d65 6e74 2061 third argument a │ │ │ -001f1300: 6c6c 6f77 7320 796f 7520 746f 2073 7065 llows you to spe │ │ │ -001f1310: 6369 6679 2061 6e0a 696e 6465 7820 666f cify an.index fo │ │ │ -001f1320: 7220 7468 6520 7661 6c75 653b 2074 6865 r the value; the │ │ │ -001f1330: 2064 6566 6175 6c74 2061 7373 756d 6573 default assumes │ │ │ -001f1340: 2061 2076 616c 7565 206f 6620 3120 6865 a value of 1 he │ │ │ -001f1350: 7265 2e20 2041 2076 616c 7565 0a6f 6620 re. A value.of │ │ │ -001f1360: 3020 7265 7475 726e 7320 616e 2061 7272 0 returns an arr │ │ │ -001f1370: 6179 206f 6620 3020 6f72 206d 6f72 6520 ay of 0 or more │ │ │ -001f1380: 656c 656d 656e 7473 2c20 6f6e 6520 666f elements, one fo │ │ │ -001f1390: 7220 6561 6368 2076 616c 7565 0a73 656c r each value.sel │ │ │ -001f13a0: 6563 7465 6420 6279 2074 6865 2058 5061 ected by the XPa │ │ │ -001f13b0: 7468 2065 7870 7265 7373 696f 6e2e 0a09 th expression... │ │ │ -001f13c0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . .When this fun │ │ │ -001f13e0: 6374 696f 6e20 7265 7475 726e 7320 616e ction returns an │ │ │ -001f13f0: 2065 6e74 6974 7920 696e 2061 2072 6573 entity in a res │ │ │ -001f1400: 756c 7420 7365 742c 2074 6865 2063 6c69 ult set, the cli │ │ │ -001f1410: 656e 7420 7769 6c6c 0a73 6565 2061 6e20 ent will.see an │ │ │ -001f1420: 6e76 6172 6368 6172 2076 616c 7565 2063 nvarchar value c │ │ │ -001f1430: 6f6e 7461 696e 696e 6720 7468 6520 7365 ontaining the se │ │ │ -001f1440: 7269 616c 697a 6174 696f 6e20 6f66 2074 rialization of t │ │ │ -001f1450: 6865 2065 6e74 6974 792c 0a63 6f6d 706c he entity,.compl │ │ │ -001f1460: 6574 6520 7769 7468 206d 6172 6b75 702e ete with markup. │ │ │ -001f1470: 2020 5768 656e 2074 6865 2065 6e74 6974 When the entit │ │ │ -001f1480: 7920 6973 2070 6173 7365 6420 6173 2061 y is passed as a │ │ │ -001f1490: 6e20 5351 4c20 7661 6c75 6520 6974 0a72 n SQL value it.r │ │ │ -001f14a0: 656d 6169 6e73 2061 6e20 656e 7469 7479 emains an entity │ │ │ -001f14b0: 2072 6566 6572 656e 6369 6e67 2074 6865 referencing the │ │ │ -001f14c0: 206e 6f64 6520 6f66 2061 2070 6172 7365 node of a parse │ │ │ -001f14d0: 6420 584d 4c20 7472 6565 2c0a 7065 726d d XML tree,.perm │ │ │ -001f14e0: 6974 7469 6e67 206e 6176 6967 6174 696f itting navigatio │ │ │ -001f14f0: 6e20 696e 7369 6465 2074 6865 2074 7265 n inside the tre │ │ │ -001f1500: 652e 0a09 3c2f 7061 7261 3e0a 2020 2020 e.... │ │ │ -001f1510: 3c70 6172 613e 0a54 6865 2065 7870 7265 .The expre │ │ │ -001f1520: 7373 696f 6e20 6361 6e20 6265 2070 6173 ssion can be pas │ │ │ -001f1530: 7365 6420 7061 7261 6d65 7465 7273 2062 sed parameters b │ │ │ -001f1540: 7920 7370 6563 6966 7969 6e67 2061 2066 y specifying a f │ │ │ -001f1550: 6f75 7274 6820 6172 6775 6d65 6e74 0a74 ourth argument.t │ │ │ -001f1560: 6f20 3c66 756e 6374 696f 6e3e 7870 6174 o xpat │ │ │ -001f1570: 685f 6576 616c 2829 3c2f 6675 6e63 7469 h_eval(). This will │ │ │ -001f1590: 6265 2061 2076 6563 746f 7220 6f66 206e be a vector of n │ │ │ -001f15a0: 616d 652f 7661 6c75 650a 7061 6972 732e ame/value.pairs. │ │ │ -001f15b0: 2054 6865 2076 616c 7565 7320 6361 6e20 The values can │ │ │ -001f15c0: 6265 2072 6566 6572 656e 6365 6420 6672 be referenced fr │ │ │ -001f15d0: 6f6d 2069 6e73 6964 6520 5850 6174 6820 om inside XPath │ │ │ -001f15e0: 6578 7072 6573 7369 6f6e 2062 7920 7573 expression by us │ │ │ -001f15f0: 696e 670a 7468 6569 7220 6e61 6d65 7320 ing.their names │ │ │ -001f1600: 7769 7468 2027 2427 2070 7265 6669 782e with '$' prefix. │ │ │ -001f1610: 2059 6f75 206d 6179 2075 7365 2061 6e79 You may use any │ │ │ -001f1620: 2056 6972 7475 6f73 6f20 6461 7461 2074 Virtuoso data t │ │ │ -001f1630: 7970 652e 0a54 6865 206e 616d 6573 2069 ype..The names i │ │ │ -001f1640: 6e20 7468 6520 7061 7261 6d65 7465 7220 n the parameter │ │ │ -001f1650: 7665 6374 6f72 2073 686f 756c 6420 6170 vector should ap │ │ │ -001f1660: 7065 6172 2077 6974 686f 7574 2074 6865 pear without the │ │ │ -001f1670: 2027 2427 2073 6967 6e2e 0a49 6620 616e '$' sign..If an │ │ │ -001f1680: 7920 6f66 2074 6865 2070 6172 616d 6574 y of the paramet │ │ │ -001f1690: 6572 2076 616c 7565 7320 6973 204e 554c er values is NUL │ │ │ -001f16a0: 4c20 7468 6520 7061 7261 6d65 7465 7220 L the parameter │ │ │ -001f16b0: 7769 6c6c 2062 6520 6967 6e6f 7265 6420 will be ignored │ │ │ -001f16c0: 6265 6361 7573 6520 4e55 4c4c 0a68 6173 because NULL.has │ │ │ -001f16d0: 206e 6f20 5850 6174 6820 636f 756e 7465 no XPath counte │ │ │ -001f16e0: 7270 6172 742e 0a49 6620 7468 6520 7361 rpart..If the sa │ │ │ -001f16f0: 6d65 206e 616d 6520 6170 7065 6172 7320 me name appears │ │ │ -001f1700: 6d6f 7265 2074 6861 6e20 6f6e 6365 2069 more than once i │ │ │ -001f1710: 6e20 7468 6520 7665 6374 6f72 2c20 7468 n the vector, th │ │ │ -001f1720: 6520 6c61 7374 206e 616d 652f 7661 6c75 e last name/valu │ │ │ -001f1730: 6520 7061 6972 2069 730a 7573 6564 2061 e pair is.used a │ │ │ -001f1740: 6e64 2061 6c6c 2070 7265 6365 6469 6e67 nd all preceding │ │ │ -001f1750: 2070 6169 7273 2077 6974 6820 7468 6973 pairs with this │ │ │ -001f1760: 206e 616d 6520 6172 6520 7369 6c65 6e74 name are silent │ │ │ -001f1770: 6c79 2069 676e 6f72 6564 2e0a 4f62 7669 ly ignored..Obvi │ │ │ -001f1780: 6f75 736c 792c 206e 616d 6573 2073 686f ously, names sho │ │ │ -001f1790: 756c 6420 6265 2073 7472 696e 6773 2074 uld be strings t │ │ │ -001f17a0: 6861 7420 6172 6520 7661 6c69 6420 5850 hat are valid XP │ │ │ -001f17b0: 6174 6820 7661 7269 6162 6c65 206e 616d ath variable nam │ │ │ -001f17c0: 6573 2e0a 3c2f 7061 7261 3e0a 2020 3c2f es... . . │ │ │ -001f1800: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ -001f1810: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -001f1820: 3c72 6566 7365 6374 323e 3c74 6974 6c65 xpath_expressio │ │ │ -001f1840: 6e3c 2f74 6974 6c65 3e0a 2020 2020 2020 n. │ │ │ -001f1850: 3c70 6172 613e 4120 7661 6c69 6420 5850 A valid XP │ │ │ -001f1860: 4154 4820 6578 7072 6573 7369 6f6e 2e20 ATH expression. │ │ │ -001f1870: 496e 2061 6c6d 6f73 7420 616c 6c20 6170 In almost all ap │ │ │ -001f1880: 706c 6963 6174 696f 6e20 7468 6973 2069 plication this i │ │ │ -001f1890: 7320 6120 7374 7269 6e67 2e0a 5468 6572 s a string..Ther │ │ │ -001f18a0: 6520 6973 2061 2074 7269 636b 7920 6578 e is a tricky ex │ │ │ -001f18b0: 7465 6e73 696f 6e20 7468 6174 2069 7320 tension that is │ │ │ -001f18c0: 7573 6564 2062 7920 4250 454c 2d6c 696b used by BPEL-lik │ │ │ -001f18d0: 6520 6170 706c 6963 6174 696f 6e73 3a20 e applications: │ │ │ -001f18e0: 3c70 6172 616d 6574 6572 3e78 7061 7468 xpath │ │ │ -001f18f0: 5f65 7870 7265 7373 696f 6e3c 2f70 6172 _expression can be a │ │ │ -001f1910: 6e20 584d 4c20 656e 7469 7479 0a77 686f n XML entity.who │ │ │ -001f1920: 7374 2073 7472 696e 672d 7661 6c75 6520 st string-value │ │ │ -001f1930: 6973 2061 2076 616c 6964 2058 5041 5448 is a valid XPATH │ │ │ -001f1940: 2065 7870 7265 7373 696f 6e2e 2041 6e20 expression. An │ │ │ -001f1950: 6578 616d 706c 6520 6f66 2073 7563 6820 example of such │ │ │ -001f1960: 616e 2065 6e74 6974 7920 6973 2026 7175 an entity is &qu │ │ │ -001f1970: 6f74 3b73 656c 6563 7426 7175 6f74 3b20 ot;select" │ │ │ -001f1980: 6f72 2026 7175 6f74 3b74 6573 7426 7175 or "test&qu │ │ │ -001f1990: 6f74 3b0a 6174 7472 6962 7574 6520 696e ot;.attribute in │ │ │ -001f19a0: 2058 534c 5420 7374 796c 6573 6865 6574 XSLT stylesheet │ │ │ -001f19b0: 2e20 5468 6973 2074 7269 636b 206c 6574 . This trick let │ │ │ -001f19c0: 7320 5850 4154 4820 7072 6f63 6573 736f s XPATH processo │ │ │ -001f19d0: 7220 746f 2072 6573 6f6c 7665 206e 616d r to resolve nam │ │ │ -001f19e0: 6573 7061 6365 2070 7265 6669 7865 7320 espace prefixes │ │ │ -001f19f0: 6279 206c 6f6f 6b69 6e67 2061 7420 6e61 by looking at na │ │ │ -001f1a00: 6d65 7370 6163 6520 6465 636c 6172 6174 mespace declarat │ │ │ -001f1a10: 696f 6e73 0a61 7420 7468 6520 6865 6164 ions.at the head │ │ │ -001f1a20: 6572 206f 6620 7468 6520 7374 796c 6573 er of the styles │ │ │ -001f1a30: 6865 6574 2e3c 2f70 6172 613e 0a20 2020 heet.. │ │ │ -001f1a40: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ -001f1a50: 203c 7265 6673 6563 7432 3e3c 7469 746c xml_tree. A │ │ │ -001f1a80: 6e20 584d 4c20 656e 7469 7479 2073 7563 n XML entity suc │ │ │ -001f1a90: 6820 6173 2074 6861 7420 7265 7475 726e h as that return │ │ │ -001f1aa0: 6564 2066 726f 6d20 7468 6520 3c66 756e ed from the xtree_doc( │ │ │ -001f1ac0: 293c 2f66 756e 6374 696f 6e3e 2066 756e ) fun │ │ │ -001f1ad0: 6374 696f 6e2e 3c2f 7061 7261 3e0a 2020 ction.. │ │ │ -001f1ae0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ -001f1af0: 2020 3c72 6566 7365 6374 323e 3c74 6974 index │ │ │ -001f1b10: 0a20 2020 2020 203c 7061 7261 3e52 6573 . Res │ │ │ -001f1b20: 756c 7420 696e 6465 782e 2020 5468 6973 ult index. This │ │ │ -001f1b30: 2070 6172 616d 6574 6572 2069 7320 6f70 parameter is op │ │ │ -001f1b40: 7469 6f6e 616c 2e20 2049 6620 6f6d 6974 tional. If omit │ │ │ -001f1b50: 7465 6420 610a 7661 6c75 6520 6f66 2031 ted a.value of 1 │ │ │ -001f1b60: 2069 7320 6173 7375 6d65 642c 206d 6561 is assumed, mea │ │ │ -001f1b70: 6e69 6e67 206f 6e6c 7920 7468 6520 6669 ning only the fi │ │ │ -001f1b80: 7273 7420 7265 7375 6c74 2069 7320 7265 rst result is re │ │ │ -001f1b90: 7475 726e 6564 2e20 2049 660a 6120 7661 turned. If.a va │ │ │ -001f1ba0: 6c75 6520 6f66 2030 2069 7320 7375 7070 lue of 0 is supp │ │ │ -001f1bb0: 6c69 6564 2074 6865 6e20 616e 2061 7272 lied then an arr │ │ │ -001f1bc0: 6179 206f 6620 3020 6f72 206d 6f72 6520 ay of 0 or more │ │ │ -001f1bd0: 656c 656d 656e 7473 2069 730a 7265 7475 elements is.retu │ │ │ -001f1be0: 726e 6564 2063 6f6e 7461 696e 696e 6720 rned containing │ │ │ -001f1bf0: 6f6e 6520 656c 656d 656e 7420 7065 7220 one element per │ │ │ -001f1c00: 7265 7375 6c74 2e3c 2f70 6172 613e 0a20 result.. │ │ │ -001f1c10: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ -001f1c20: 2020 203c 7265 6673 6563 7432 3e3c 7469 named_params │ │ │ -001f1c40: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -001f1c50: 7061 7261 3e41 2076 6563 746f 7220 6f66 para>A vector of │ │ │ -001f1c60: 206b 6579 776f 7264 2f76 616c 7565 2070 keyword/value p │ │ │ -001f1c70: 6172 616d 6574 6572 7320 746f 2062 6520 arameters to be │ │ │ -001f1c80: 7061 7373 6564 2074 6f20 7468 650a 2020 passed to the. │ │ │ -001f1c90: 2020 5850 6174 6820 7072 6f63 6573 736f XPath processo │ │ │ -001f1ca0: 722e 3c2f 7061 7261 3e0a 2020 2020 3c2f r.. . . . Return Types │ │ │ -001f1d00: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This function │ │ │ -001f1d20: 2077 696c 6c20 7265 7475 726e 2074 6865 will return the │ │ │ -001f1d30: 2066 6972 7374 206f 720a 3c70 6172 616d first or.index selected │ │ │ -001f1d60: 7265 7375 6c74 206f 6620 6170 706c 7969 result of applyi │ │ │ -001f1d70: 6e67 2074 6865 2058 5061 7468 0a65 7870 ng the XPath.exp │ │ │ -001f1d80: 7265 7373 696f 6e20 746f 2074 6865 203c ression to the < │ │ │ -001f1d90: 7061 7261 6d65 7465 723e 786d 6c5f 7472 parameter>xml_tr │ │ │ -001f1da0: 6565 3c2f 7061 7261 6d65 7465 723e 2069 ee i │ │ │ -001f1db0: 6e70 7574 2e20 2049 6620 616e 203c 7061 nput. If an index

    .value │ │ │ -001f1de0: 6f66 2030 2069 7320 7375 7070 6c69 6564 of 0 is supplied │ │ │ -001f1df0: 2074 6865 6e20 7468 6520 6f75 7470 7574 then the output │ │ │ -001f1e00: 2069 7320 616e 2061 7272 6179 2e3c 2f70 is an array.

    . . . Errors │ │ │ -001f1e60: 0a20 2020 203c 7461 626c 653e 0a20 2020 . . │ │ │ -001f1e70: 2020 203c 7469 746c 653e 4572 726f 7273 Errors │ │ │ -001f1e80: 2073 6967 6e61 6c6c 6564 2062 7920 7870 signalled by xp │ │ │ -001f1e90: 6174 685f 6576 616c 3c2f 7469 746c 653e ath_eval │ │ │ -001f1ea0: 0a20 2020 2020 203c 7467 726f 7570 2063 . . │ │ │ -001f1ec0: 203c 7468 6561 643e 0a20 2020 2020 2020 . │ │ │ -001f1ed0: 2020 203c 726f 773e 3c65 6e74 7279 3e53 S │ │ │ -001f1ee0: 514c 2053 7461 7465 3c2f 656e 7472 793e QL State │ │ │ -001f1ef0: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ -001f1f00: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ -001f1f10: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ -001f1f30: 7469 6f6e 3c2f 656e 7472 793e 0a20 2020 tion. │ │ │ -001f1f40: 2020 2020 2020 203c 2f72 6f77 3e0a 2020 . │ │ │ -001f1f50: 2020 2020 2020 3c2f 7468 6561 643e 0a20 . │ │ │ -001f1f60: 2020 2020 2020 203c 7462 6f64 793e 0a20 . │ │ │ -001f1f70: 2020 2020 2020 2020 203c 726f 773e 0a20 . │ │ │ -001f1f80: 2020 2020 2020 2020 2020 203c 656e 7472 . │ │ │ -001f1fa0: 203c 6572 726f 7263 6f64 653e 5850 3337 XP37 │ │ │ -001f1fb0: 303c 2f65 7272 6f72 636f 6465 3e0a 2020 0. │ │ │ -001f1fc0: 2020 2020 2020 2020 2020 3c2f 656e 7472 . < │ │ │ -001f1fe0: 656e 7472 793e 0a20 2020 2020 2020 2020 entry>. │ │ │ -001f1ff0: 2020 2020 203c 6572 726f 7263 6f64 653e │ │ │ -001f2000: 5849 3030 393c 2f65 7272 6f72 636f 6465 XI009. . │ │ │ -001f2030: 2020 203c 656e 7472 793e 0a20 2020 2020 . │ │ │ -001f2040: 2020 2020 2020 2020 203c 6572 726f 726e Argument 2 o │ │ │ -001f2060: 6620 7870 6174 685f 6576 616c 206d 7573 f xpath_eval mus │ │ │ -001f2070: 7420 6265 2061 6e20 656e 7469 7479 2c20 t be an entity, │ │ │ -001f2080: 6e6f 7420 6120 7661 6c75 6520 6f66 2074 not a value of t │ │ │ -001f2090: 7970 6520 5b74 7970 6520 6e61 6d65 5d20 ype [type name] │ │ │ -001f20a0: 285b 7479 7065 2063 6f64 655d 293c 2f65 ([type code]). │ │ │ -001f20c0: 2020 2020 2020 3c2f 656e 7472 793e 0a20 . │ │ │ -001f20d0: 2020 2020 2020 2020 2020 203c 656e 7472 The xml_tree parameter │ │ │ -001f2110: 7368 6f75 6c64 2061 6c77 6179 7320 6265 should always be │ │ │ -001f2120: 2061 6e20 656e 7469 7479 2e0a 496e 2073 an entity..In s │ │ │ -001f2130: 6f6d 6520 6361 7365 7320 7468 6520 5850 ome cases the XP │ │ │ -001f2140: 6174 6820 6578 7072 6573 7369 6f6e 2064 ath expression d │ │ │ -001f2150: 6f65 7320 6e6f 7420 7573 6520 636f 6e74 oes not use cont │ │ │ -001f2160: 6578 7420 656e 7469 7479 2c20 6275 7420 ext entity, but │ │ │ -001f2170: 6974 2073 686f 756c 6420 6265 2070 726f it should be pro │ │ │ -001f2180: 7669 6465 6420 616e 7977 6179 0a28 652e vided anyway.(e. │ │ │ -001f2190: 672e 2073 6f6d 6520 6661 6b65 2064 6f63 g. some fake doc │ │ │ -001f21a0: 756d 656e 7429 2e3c 2f65 6e74 7279 3e0a ument).. │ │ │ -001f21b0: 2020 2020 2020 2020 2020 3c2f 726f 773e │ │ │ -001f21c0: 0a20 2020 2020 2020 203c 2f74 626f 6479 . . .
    . │ │ │ -001f21f0: 203c 2f72 6566 7365 6374 313e 0a20 203c
    . < │ │ │ -001f2200: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ -001f2210: 6d70 6c65 735f 7870 6174 685f 6576 616c mples_xpath_eval │ │ │ -001f2220: 223e 0a20 2020 203c 7469 746c 653e 4578 ">. Ex │ │ │ -001f2230: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ -001f2240: 2020 203c 6578 616d 706c 6520 6964 3d22 . │ │ │ -001f2260: 2020 2020 2020 3c74 6974 6c65 3e46 696e Fin │ │ │ -001f2270: 6469 6e67 2074 6865 2041 7574 686f 7273 ding the Authors │ │ │ -001f2280: 206f 6620 446f 6375 6d65 6e74 2054 6974 of Document Tit │ │ │ -001f2290: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ -001f22a0: 2020 3c70 726f 6772 616d 6c69 7374 696e .select xt_fil │ │ │ -001f22c0: 652c 2078 7061 7468 5f65 7661 6c20 2826 e, xpath_eval (& │ │ │ -001f22d0: 6170 6f73 3b2f 2f61 7574 686f 7226 6170 apos;//author&ap │ │ │ -001f22e0: 6f73 3b2c 2074 2920 6672 6f6d 2078 6d6c os;, t) from xml │ │ │ -001f22f0: 5f74 6578 740a 0977 6865 7265 2078 7061 _text..where xpa │ │ │ -001f2300: 7468 5f63 6f6e 7461 696e 7320 2878 745f th_contains (xt_ │ │ │ -001f2310: 7465 7874 2c20 2661 706f 733b 2f2f 6368 text, '//ch │ │ │ -001f2320: 6170 7465 722f 7469 746c 655b 2e20 3d20 apter/title[. = │ │ │ -001f2330: 2661 706f 733b 496e 7472 6f64 7563 7469 'Introducti │ │ │ -001f2340: 6f6e 2661 706f 733b 5d26 6170 6f73 3b2c on']', │ │ │ -001f2350: 2074 293b 0a3c 2f70 726f 6772 616d 6c69 t);.. .This will se │ │ │ -001f2380: 6c65 6374 2061 6c6c 2074 6974 6c65 7320 lect all titles │ │ │ -001f2390: 7468 6174 2061 7265 2064 6573 6365 6e64 that are descend │ │ │ -001f23a0: 616e 7473 206f 6620 6368 6170 7465 7220 ants of chapter │ │ │ -001f23b0: 616e 6420 6861 7665 2061 0a73 7472 696e and have a.strin │ │ │ -001f23c0: 6720 7661 6c75 6520 6f66 2026 6170 6f73 g value of &apos │ │ │ -001f23d0: 3b49 6e74 726f 6475 6374 696f 6e26 6170 ;Introduction&ap │ │ │ -001f23e0: 6f73 3b2e 2020 5468 6973 2077 696c 6c20 os;. This will │ │ │ -001f23f0: 6e65 7874 2065 7661 6c75 6174 650a 3c70 next evaluate.

    //autho │ │ │ -001f2410: 723c 2f70 6172 616d 6574 6572 3e20 696e r in │ │ │ -001f2420: 2074 6865 2063 6f6e 7465 7874 206f 6620 the context of │ │ │ -001f2430: 6561 6368 2c20 7265 7472 6965 7669 6e67 each, retrieving │ │ │ -001f2440: 2074 6865 0a61 7574 686f 7220 656e 7469 the.author enti │ │ │ -001f2450: 7469 6573 2069 6e20 7468 6520 646f 6375 ties in the docu │ │ │ -001f2460: 6d65 6e74 206f 6620 7468 6520 7469 746c ment of the titl │ │ │ -001f2470: 652e 0a09 3c2f 7061 7261 3e0a 2020 2020 e.... │ │ │ -001f2480: 3c2f 6578 616d 706c 653e 0a20 2020 203c . < │ │ │ -001f2490: 6578 616d 706c 6520 6964 3d22 6578 5f78 example id="ex_x │ │ │ -001f24a0: 7061 7468 5f65 7661 6c32 223e 0a20 2020 path_eval2">. │ │ │ -001f24b0: 2020 203c 7469 746c 653e 7870 6174 685f xpath_ │ │ │ -001f24c0: 6576 616c 2061 6e64 2052 6570 6561 7469 eval and Repeati │ │ │ -001f24d0: 6e67 204e 6f64 6573 2e3c 2f74 6974 6c65 ng Nodes.. Th │ │ │ -001f24f0: 6973 2065 7861 6d70 6c65 2073 686f 7773 is example shows │ │ │ -001f2500: 2068 6f77 2074 6865 2078 7061 7468 5f65 how the xpath_e │ │ │ -001f2510: 7661 6c20 6361 6e20 6265 2075 7365 6420 val can be used │ │ │ -001f2520: 746f 2072 6574 7269 6576 6520 0a09 6d75 to retrieve ..mu │ │ │ -001f2530: 6c74 6970 6c65 206e 6f64 6520 616e 7377 ltiple node answ │ │ │ -001f2540: 6572 7320 746f 2071 7565 7269 6573 2e20 ers to queries. │ │ │ -001f2550: 2046 6972 7374 2074 6f20 7365 7420 7468 First to set th │ │ │ -001f2560: 6520 7363 656e 6520 636f 6e73 6964 6572 e scene consider │ │ │ -001f2570: 2074 6865 2066 6f6c 6c6f 7769 6e67 200a the following . │ │ │ -001f2580: 0973 7461 7465 6d65 6e74 7320 7468 6174 .statements that │ │ │ -001f2590: 2063 7265 6174 6520 6120 7461 626c 6520 create a table │ │ │ -001f25a0: 7769 7468 2058 4d4c 2069 6e73 6964 652e with XML inside. │ │ │ -001f25b0: 3c2f 7061 7261 3e0a 2020 2020 2020 3c70 .

    .john lennon.george harris │ │ │ -001f2790: 6f6e 3c2f 6265 6174 6c65 3e0a 3c2f 6265 on.'.WHERE ar │ │ │ -001f27b0: 7469 636c 655f 6964 203d 2031 3b0a 0a55 ticle_id = 1;..U │ │ │ -001f27c0: 5044 4154 4520 745f 6172 7469 636c 6573 PDATE t_articles │ │ │ -001f27d0: 2053 4554 2061 7274 6963 6c65 5f78 6d6c SET article_xml │ │ │ -001f27e0: 203d 2027 0a3c 6265 6174 6c65 7320 6964 = '..paul mccartne │ │ │ -001f2830: 793c 2f62 6561 746c 653e 0a3c 6265 6174 y.ringo star │ │ │ -001f2870: 723c 2f62 6561 746c 653e 0a3c 2f62 6561 r.'.WHERE art │ │ │ -001f2890: 6963 6c65 5f69 6420 3d20 323b 0a5d 5d3e icle_id = 2;.]]> │ │ │ -001f28a0: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 . No │ │ │ -001f28c0: 7720 7765 206d 616b 6520 6120 7175 6572 w we make a quer │ │ │ -001f28d0: 7920 7468 6174 2077 696c 6c20 7265 7475 y that will retu │ │ │ -001f28e0: 726e 2061 2076 6563 746f 7220 6f66 2072 rn a vector of r │ │ │ -001f28f0: 6573 756c 7473 2c20 6561 6368 0a76 6563 esults, each.vec │ │ │ -001f2900: 746f 7220 656c 656d 656e 7420 636f 7272 tor element corr │ │ │ -001f2910: 6573 706f 6e64 696e 6720 746f 2061 206e esponding to a n │ │ │ -001f2920: 6f64 652d 7365 7420 6f66 2074 6865 2072 ode-set of the r │ │ │ -001f2930: 6573 756c 742e 3c2f 7061 7261 3e0a 2020 esult.. │ │ │ -001f2940: 2020 2020 3c70 726f 6772 616d 6c69 7374 . < │ │ │ -001f2a00: 7061 7261 3e54 6865 2072 6570 6561 7469 para>The repeati │ │ │ -001f2a10: 6e67 206e 6f64 6573 2061 7265 2072 6574 ng nodes are ret │ │ │ -001f2a20: 7572 6e65 6420 6173 2070 6172 7420 6f66 urned as part of │ │ │ -001f2a30: 2061 2076 6563 746f 722c 2074 6865 2074 a vector, the t │ │ │ -001f2a40: 6869 7264 2061 7267 756d 656e 7420 0a74 hird argument .t │ │ │ -001f2a50: 6f20 7870 6174 685f 6576 616c 2069 7320 o xpath_eval is │ │ │ -001f2a60: 7365 7420 746f 2030 2c20 7768 6963 6820 set to 0, which │ │ │ -001f2a70: 6d65 616e 7320 7468 6174 2069 7420 6973 means that it is │ │ │ -001f2a80: 2074 6f20 7265 7475 726e 2061 6c6c 206e to return all n │ │ │ -001f2a90: 6f64 6573 2e3c 2f70 6172 613e 0a20 2020 odes.. │ │ │ -001f2aa0: 2020 203c 7061 7261 3e4f 7468 6572 7769 Otherwi │ │ │ -001f2ab0: 7365 2c20 7765 2063 616e 2073 656c 6563 se, we can selec │ │ │ -001f2ac0: 7420 7468 6520 6669 7273 7420 6e6f 6465 t the first node │ │ │ -001f2ad0: 2d73 6574 2062 7920 7375 7070 6c79 696e -set by supplyin │ │ │ -001f2ae0: 6720 3120 6173 2074 6865 2074 6869 7264 g 1 as the third │ │ │ -001f2af0: 200a 7061 7261 6d65 7465 7220 746f 2078 .parameter to x │ │ │ -001f2b00: 7061 7468 5f65 7661 6c3a 203c 2f70 6172 path_eval: . . │ │ │ -001f2bd0: 2020 3c2f 6578 616d 706c 653e 0a20 2020 . │ │ │ -001f2be0: 203c 6578 616d 706c 6520 6964 3d22 6578 . │ │ │ -001f2c00: 2020 2020 203c 7469 746c 653e 5061 7373 Pass │ │ │ -001f2c10: 696e 6720 6120 6e61 6d65 6420 7061 7261 ing a named para │ │ │ -001f2c20: 6d65 7465 7220 746f 2074 6865 2058 5061 meter to the XPa │ │ │ -001f2c30: 7468 3c2f 7469 746c 653e 0a20 2020 2020 th. │ │ │ -001f2c40: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 │ │ │ -001f2c60: 7365 6c65 6374 2078 7061 7468 5f65 7661 select xpath_eva │ │ │ -001f2c70: 6c28 0a20 2027 2f2f 7068 6f6e 655b 2e2e l(. '//phone[.. │ │ │ -001f2c80: 2f6e 616d 6520 6c69 6b65 2024 246e 5d27 /name like $$n]' │ │ │ -001f2c90: 2c0a 2020 7874 7265 655f 646f 6320 2827 ,. xtree_doc (' │ │ │ -001f2ca0: 3c70 686f 6e65 626f 6f6b 3e0a 2020 2020 . │ │ │ -001f2cb0: 2020 3c64 6570 743e 3c6e 616d 653e 496e In │ │ │ -001f2cc0: 7374 616c 6c61 7469 6f6e 2053 6572 7669 stallation Servi │ │ │ -001f2cd0: 6365 3c2f 6e61 6d65 3e3c 7068 6f6e 653e ce │ │ │ -001f2ce0: 3535 352d 3131 3131 3c2f 7068 6f6e 653e 555-1111 │ │ │ -001f2cf0: 3c2f 6465 7074 3e0a 2020 2020 2020 3c64 . Tech S │ │ │ -001f2d10: 7570 706f 7274 3c2f 6e61 6d65 3e3c 7068 upport555-1112. │ │ │ -001f2d40: 3c2f 7068 6f6e 6562 6f6f 6b3e 2729 2c0a '),. │ │ │ -001f2d50: 2020 312c 0a20 2076 6563 746f 7228 276e 1,. vector('n │ │ │ -001f2d60: 272c 2027 5465 6368 2527 2920 293b 0a63 ', 'Tech%') );.c │ │ │ -001f2d70: 616c 6c72 6574 0a56 4152 4348 4152 0a5f allret.VARCHAR._ │ │ │ -001f2d80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f2d90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f2da0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f2db0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f2dc0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ -001f2dd0: 3c70 686f 6e65 3e35 3535 2d31 3131 323c 555-1112< │ │ │ -001f2de0: 2f70 686f 6e65 3e0a 5d5d 3e3c 2f70 726f /phone>.]]>. │ │ │ -001f2e00: 2020 203c 7061 7261 3e0a 4c69 6b65 2069 .Like i │ │ │ -001f2e10: 6e20 5351 4c20 7175 6572 6965 732c 2058 n SQL queries, X │ │ │ -001f2e20: 5061 7468 2070 6172 616d 6574 6572 7320 Path parameters │ │ │ -001f2e30: 6172 6520 7573 6564 2074 6f20 6176 6f69 are used to avoi │ │ │ -001f2e40: 6420 7072 696e 7469 6e67 206c 6974 6572 d printing liter │ │ │ -001f2e50: 616c 2076 616c 7565 7320 696e 746f 0a74 al values into.t │ │ │ -001f2e60: 6865 2074 6578 7420 6f66 2074 6865 2071 he text of the q │ │ │ -001f2e70: 7565 7279 2e20 5468 6520 6c69 7374 696e uery. The listin │ │ │ -001f2e80: 6720 6162 6f76 6520 6465 6d6f 6e73 7472 g above demonstr │ │ │ -001f2e90: 6174 6573 2068 6f77 2074 6f20 6669 6e64 ates how to find │ │ │ -001f2ea0: 2074 6865 2070 686f 6e65 206f 660a 7468 the phone of.th │ │ │ -001f2eb0: 6520 6669 7273 7420 6465 7061 7274 6d65 e first departme │ │ │ -001f2ec0: 6e74 2077 686f 7365 206e 616d 6520 6973 nt whose name is │ │ │ -001f2ed0: 206c 696b 6520 7468 6520 7370 6563 6966 like the specif │ │ │ -001f2ee0: 6965 6420 7061 7474 6572 6e2e 0a09 3c2f ied pattern.... .Note that if │ │ │ -001f2f10: 7468 6520 7465 7874 206f 6620 7468 6520 the text of the │ │ │ -001f2f20: 5850 6174 6820 6578 7072 6573 7369 6f6e XPath expression │ │ │ -001f2f30: 2069 7320 656e 7465 7265 6420 6173 2061 is entered as a │ │ │ -001f2f40: 2073 7472 696e 6720 696e 2049 5351 4c2c string in ISQL, │ │ │ -001f2f50: 0a64 6f6c 6c61 7220 7369 676e 7320 696e .dollar signs in │ │ │ -001f2f60: 2066 726f 6e74 206f 6620 7061 7261 6d65 front of parame │ │ │ -001f2f70: 7465 7220 6e61 6d65 7320 7368 6f75 6c64 ter names should │ │ │ -001f2f80: 2062 6520 646f 7562 6c65 642c 2061 7320 be doubled, as │ │ │ -001f2f90: 696e 2074 6869 7320 7361 6d70 6c65 2e0a in this sample.. │ │ │ -001f2fa0: 4953 514c 2075 7365 7320 7468 6520 7361 ISQL uses the sa │ │ │ -001f2fb0: 6d65 2073 796e 7461 7820 2824 6e61 6d65 me syntax ($name │ │ │ -001f2fc0: 2920 666f 7220 6d61 6372 6f20 6578 7061 ) for macro expa │ │ │ -001f2fd0: 6e73 696f 6e2c 2061 6e64 2064 6f75 626c nsion, and doubl │ │ │ -001f2fe0: 6520 646f 6c6c 6172 2073 6967 6e0a 6973 e dollar sign.is │ │ │ -001f2ff0: 2072 6570 6c61 6365 6420 6279 2049 5351 replaced by ISQ │ │ │ -001f3000: 4c20 7769 7468 2073 696e 676c 6520 646f L with single do │ │ │ -001f3010: 6c6c 6172 2073 6967 6e20 6368 6172 6163 llar sign charac │ │ │ -001f3020: 7465 722e 0a09 3c2f 7061 7261 3e0a 2020 ter.... │ │ │ -001f3030: 2020 3c2f 6578 616d 706c 653e 0a20 203c . < │ │ │ -001f3040: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. . │ │ │ -001f3070: 2020 2020 3c74 6974 6c65 3e53 6565 2041 See A │ │ │ -001f3080: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -001f3090: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b x │ │ │ -001f30c0: 7175 6572 795f 6576 616c 2829 3c2f 6675 query_eval(). │ │ │ -001f30f0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2278 xpath_conta │ │ │ -001f3120: 696e 7320 5351 4c20 7072 6564 6963 6174 ins SQL predicat │ │ │ -001f3130: 653c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a e. │ │ │ -001f3140: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xco │ │ │ -001f3170: 6e74 6169 6e73 2053 514c 2050 7265 6469 ntains SQL Predi │ │ │ -001f3180: 6361 7465 3c2f 6c69 6e6b 3e3c 2f70 6172 cate. . < │ │ │ -001f3200: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......!demo │ │ │ -001f3220: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -001f3230: 786d 6c75 7064 6174 652e 786d 6cdf 0000 xmlupdate.xml... │ │ │ -001f3240: 2646 3c3f 786d 6c20 7665 7273 696f 6e3d &F < │ │ │ -001f3270: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ -001f3280: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -001f3290: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -001f32a0: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -001f32b0: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -001f32c0: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -001f32d0: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ -001f32e0: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -001f32f0: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -001f3300: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ -001f3310: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ -001f3320: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ -001f3330: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ -001f3340: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ -001f3350: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ -001f3360: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -001f3370: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -001f3380: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -001f3390: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ -001f33a0: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ -001f33b0: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ -001f33c0: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ -001f33d0: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ -001f33e0: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ -001f33f0: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ -001f3400: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ -001f3410: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ -001f3420: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ -001f3430: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ -001f3440: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ -001f3450: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ -001f3460: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ -001f3470: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ -001f3480: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -001f3490: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -001f34a0: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -001f34b0: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ -001f34c0: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -001f34d0: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ -001f34e0: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ -001f34f0: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ -001f3500: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -001f3510: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -001f3520: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -001f3530: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ -001f3540: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ -001f3550: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ -001f3560: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ -001f3570: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ -001f3580: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ -001f3590: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ -001f35a0: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ -001f35b0: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ -001f35c0: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ -001f35d0: 3c72 6566 656e 7472 7920 6964 3d22 666e ..XMLUpdate< │ │ │ -001f3610: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ -001f3620: 3c72 6566 6d69 7363 696e 666f 3e78 6d6c xml │ │ │ -001f3630: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a3c .< │ │ │ -001f3640: 2f72 6566 6d65 7461 3e0a 3c72 6566 6e61 /refmeta>.. │ │ │ -001f3660: 584d 4c55 7064 6174 653c 2f72 6566 6e61 XMLUpdate. │ │ │ -001f3680: 4372 6561 7465 2061 2063 6861 6e67 6564 Create a changed │ │ │ -001f3690: 2063 6f70 7920 6f66 2067 6976 656e 2064 copy of given d │ │ │ -001f36a0: 6f63 756d 656e 7420 6279 2072 6570 6c61 ocument by repla │ │ │ -001f36b0: 6369 6e67 2073 6f6d 6520 6e6f 6465 732e cing some nodes. │ │ │ -001f36c0: 3c2f 7265 6670 7572 706f 7365 3e0a 3c2f .... │ │ │ -001f3710: 3c66 756e 6370 726f 746f 7479 7065 2069 .a │ │ │ -001f3740: 6e79 203c 6675 6e63 7469 6f6e 3e58 4d4c ny XML │ │ │ -001f3750: 5570 6461 7465 3c2f 6675 6e63 7469 6f6e Update.inout source

    any

    .in path1 varchar. │ │ │ -001f37f0: 696e 203c 7061 7261 6d65 7465 723e 7265 in re │ │ │ -001f3800: 706c 6163 656d 656e 7431 3c2f 7061 7261 placement1 any. │ │ │ -001f3830: 696e 203c 7061 7261 6d65 7465 723e 7061 in pa │ │ │ -001f3840: 7468 323c 2f70 6172 616d 6574 6572 3e20 th2 │ │ │ -001f3850: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar.in │ │ │ -001f3870: 3c70 6172 616d 6574 6572 3e72 6570 6c61 repla │ │ │ -001f3880: 6365 6d65 6e74 323c 2f70 6172 616d 6574 cement2 any.....in │ │ │ -001f38e0: 3c70 6172 616d 6574 6572 3e70 6174 684e pathN │ │ │ -001f38f0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -001f3900: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -001f3910: 3c70 6172 616d 6465 663e 696e 203c 7061 in replacem │ │ │ -001f3930: 656e 744e 3c2f 7061 7261 6d65 7465 723e entN │ │ │ -001f3940: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any. │ │ │ -001f3950: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -001f3960: 0a3c 2f66 756e 6373 796e 6f70 7369 733e . │ │ │ -001f3970: 0a3c 2f72 6566 7379 6e6f 7073 6973 6469 ...Descrip │ │ │ -001f39b0: 7469 6f6e 3c2f 7469 746c 653e 0a3c 7061 tion.The function │ │ │ -001f39d0: 7461 6b65 7320 6f66 2074 6865 2058 4d4c takes of the XML │ │ │ -001f39e0: 2064 6f63 756d 656e 7420 7265 6665 7265 document refere │ │ │ -001f39f0: 6e63 6564 2062 790a 3c70 6172 616d 6574 nced by.source XML tree e │ │ │ -001f3a20: 6e74 6974 792c 206d 616b 6573 2061 2063 ntity, makes a c │ │ │ -001f3a30: 6f70 7920 6f66 2074 6861 7420 646f 6375 opy of that docu │ │ │ -001f3a40: 6d65 6e74 3b0a 7468 656e 2069 7420 6d6f ment;.then it mo │ │ │ -001f3a50: 6469 6669 6573 2074 6865 2063 6f70 7920 difies the copy │ │ │ -001f3a60: 6279 2066 696e 6469 6e67 2066 7261 676d by finding fragm │ │ │ -001f3a70: 656e 7473 2074 6861 7420 6172 6520 7661 ents that are va │ │ │ -001f3a80: 6c75 6573 206f 660a 3c70 6172 616d 6574 lues of.path1, path2, ..., pathN XPATH expr │ │ │ -001f3af0: 6573 7369 6f6e 7320 616e 6420 7265 706c essions and repl │ │ │ -001f3b00: 6163 696e 6720 7468 656d 2077 6974 680a acing them with. │ │ │ -001f3b10: 7661 6c75 6573 2073 7065 6369 6669 6564 values specified │ │ │ -001f3b20: 2062 7920 3c70 6172 616d 6574 6572 3e72 by r │ │ │ -001f3b30: 6570 6c61 6365 6d65 6e74 313c 2f70 6172 eplacement1, replacement2 │ │ │ -001f3b60: 3c2f 7061 7261 6d65 7465 723e 2c20 2e2e , .. │ │ │ -001f3b70: 2e2c 3c70 6172 616d 6574 6572 3e72 6570 .,rep │ │ │ -001f3b80: 6c61 6365 6d65 6e74 4e3c 2f70 6172 616d lacementN;.the modif │ │ │ -001f3ba0: 6965 6420 636f 7079 2069 7320 7265 7475 ied copy is retu │ │ │ -001f3bb0: 726e 6564 2061 7320 7468 6520 7265 7375 rned as the resu │ │ │ -001f3bc0: 6c74 206f 6620 7468 6520 6675 6e63 7469 lt of the functi │ │ │ -001f3bd0: 6f6e 2063 616c 6c2e 0a3c 2f70 6172 613e on call.. │ │ │ -001f3be0: 0a3c 7061 7261 3e45 7665 7279 203c 7061 .Every pathI

    should │ │ │ -001f3c10: 2062 6520 6120 7374 7269 6e67 2074 6861 be a string tha │ │ │ -001f3c20: 7420 6973 2020 6120 636f 7272 6563 7420 t is a correct │ │ │ -001f3c30: 5850 4154 4820 6578 7072 6573 7369 6f6e XPATH expression │ │ │ -001f3c40: 2e0a 4576 6572 7920 7375 6368 2065 7870 ..Every such exp │ │ │ -001f3c50: 7265 7373 696f 6e20 6973 2065 7661 6c75 ression is evalu │ │ │ -001f3c60: 6174 6564 2061 6363 6f72 6469 6e67 2074 ated according t │ │ │ -001f3c70: 6f20 7468 6520 7275 6c65 7320 666f 7220 o the rules for │ │ │ -001f3c80: 5850 4154 4820 6578 7072 6573 7369 6f6e XPATH expression │ │ │ -001f3c90: 7320 696e 2058 534c 5420 2861 7474 7269 s in XSLT (attri │ │ │ -001f3ca0: 6275 7465 2065 6e74 6974 6965 7320 6172 bute entities ar │ │ │ -001f3cb0: 6520 6e6f 7420 6361 7374 2074 6f20 7468 e not cast to th │ │ │ -001f3cc0: 6569 7220 7374 7269 6e67 2076 616c 7565 eir string value │ │ │ -001f3cd0: 7329 2e0a 5468 6520 636f 6e74 6578 7420 s)..The context │ │ │ -001f3ce0: 6e6f 6465 2069 7320 3c70 6172 616d 6574 node is source, context s │ │ │ -001f3d10: 697a 6520 616e 6420 706f 7369 7469 6f6e ize and position │ │ │ -001f3d20: 2061 7265 2062 6f74 6820 6571 7561 6c20 are both equal │ │ │ -001f3d30: 746f 2031 2e0a 3c2f 7061 7261 3e0a 3c70 to 1..
    .

    Every replacement │ │ │ -001f3d60: 493c 2f70 6172 616d 6574 6572 3e20 6d61 I ma │ │ │ -001f3d70: 7920 6265 2061 6e20 584d 4c20 7472 6565 y be an XML tree │ │ │ -001f3d80: 2065 6e74 6974 792c 2061 204e 554c 4c20 entity, a NULL │ │ │ -001f3d90: 6f72 2061 2076 616c 7565 206f 6620 736f or a value of so │ │ │ -001f3da0: 6d65 206f 7468 6572 2074 7970 6520 7468 me other type th │ │ │ -001f3db0: 6174 2077 696c 6c20 6265 2063 6f6e 7665 at will be conve │ │ │ -001f3dc0: 7274 6564 2074 6f20 7661 7263 6861 7220 rted to varchar │ │ │ -001f3dd0: 6265 666f 7265 2075 7365 2e0a 3c2f 7061 before use...For si │ │ │ -001f3df0: 6d70 6c69 6369 7479 2c20 636f 6e73 6964 mplicity, consid │ │ │ -001f3e00: 6572 2074 6865 2063 6173 6520 7768 656e er the case when │ │ │ -001f3e10: 2074 6865 7265 2069 7320 6f6e 6c79 206f there is only o │ │ │ -001f3e20: 6e65 203c 7061 7261 6d65 7465 723e 7061 ne pa │ │ │ -001f3e30: 7468 313c 2f70 6172 616d 6574 6572 3e20 th1 │ │ │ -001f3e40: 5850 4154 4820 6578 7072 6573 7369 6f6e XPATH expression │ │ │ -001f3e50: 2070 6172 616d 6574 6572 2061 6e64 206f parameter and o │ │ │ -001f3e60: 6e6c 7920 6f6e 650a 3c70 6172 616d 6574 nly one.replacement1< │ │ │ -001f3e80: 2f70 6172 616d 6574 6572 3e2e 2046 6972 /parameter>. Fir │ │ │ -001f3e90: 7374 206f 6620 616c 6c2c 2061 2063 6f70 st of all, a cop │ │ │ -001f3ea0: 7920 6f66 2074 6865 2064 6f63 756d 656e y of the documen │ │ │ -001f3eb0: 7420 6f66 2074 6865 203c 7061 7261 6d65 t of the source XML tree │ │ │ -001f3ee0: 656e 7469 7479 2069 7320 6372 6561 7465 entity is create │ │ │ -001f3ef0: 642e 0a54 6865 6e20 3c70 6172 616d 6574 d..Then path1 is evaluate │ │ │ -001f3f20: 642e 3c2f 7061 7261 3e0a 3c70 6172 613e d.. │ │ │ -001f3f30: 4966 2074 6865 2072 6573 756c 7420 6f66 If the result of │ │ │ -001f3f40: 2065 7661 6c75 6174 696f 6e20 6973 206e evaluation is n │ │ │ -001f3f50: 6f74 2061 6e20 584d 4c20 656e 7469 7479 ot an XML entity │ │ │ -001f3f60: 2074 6865 6e20 6e6f 2072 6570 6c61 6365 then no replace │ │ │ -001f3f70: 6d65 6e74 2069 7320 6d61 6465 2061 6e64 ment is made and │ │ │ -001f3f80: 0a74 6865 2063 6f70 7920 6f66 2074 6865 .the copy of the │ │ │ -001f3f90: 2073 6f75 7263 6520 646f 6375 6d65 6e74 source document │ │ │ -001f3fa0: 2069 7320 7265 7475 726e 6564 2075 6e63 is returned unc │ │ │ -001f3fb0: 6861 6e67 6564 2e0a 4966 2074 6865 2072 hanged..If the r │ │ │ -001f3fc0: 6573 756c 7420 6973 2061 6e20 584d 4c20 esult is an XML │ │ │ -001f3fd0: 656e 7469 7479 2074 6861 7420 6973 206e entity that is n │ │ │ -001f3fe0: 6f74 2069 6e20 7468 6520 736f 7572 6365 ot in the source │ │ │ -001f3ff0: 2064 6f63 756d 656e 7420 2865 2e67 2e20 document (e.g. │ │ │ -001f4000: 616e 2065 6e74 6974 7920 7265 7475 726e an entity return │ │ │ -001f4010: 6564 2062 7920 7468 6520 6361 6c6c 206f ed by the call o │ │ │ -001f4020: 6620 646f 6375 6d65 6e74 282e 2e2e 2920 f document(...) │ │ │ -001f4030: 6675 6e63 7469 6f6e 2e29 0a74 6865 6e20 function.).then │ │ │ -001f4040: 6e6f 2072 6570 6c61 6365 6d65 6e74 2069 no replacement i │ │ │ -001f4050: 7320 6d61 6465 2065 6974 6865 722e 0a3c s made either..< │ │ │ -001f4060: 2f70 6172 613e 0a3c 7061 7261 3e0a 4966 /para>..If │ │ │ -001f4070: 2074 6865 2072 6573 756c 7420 6f66 2065 the result of e │ │ │ -001f4080: 7661 6c75 6174 696f 6e20 6973 2061 6e20 valuation is an │ │ │ -001f4090: 584d 4c20 656e 7469 7479 2069 6e20 7468 XML entity in th │ │ │ -001f40a0: 6520 736f 7572 6365 2064 6f63 756d 656e e source documen │ │ │ -001f40b0: 7420 7468 656e 2074 6865 2066 756e 6374 t then the funct │ │ │ -001f40c0: 696f 6e20 6669 6e64 7320 6120 6e6f 6465 ion finds a node │ │ │ -001f40d0: 2069 6e20 7468 6520 636f 7069 6564 2064 in the copied d │ │ │ -001f40e0: 6f63 756d 656e 7420 7468 6174 2069 7320 ocument that is │ │ │ -001f40f0: 6120 636f 7079 206f 660a 7468 6520 6e6f a copy of.the no │ │ │ -001f4100: 6465 2069 6e20 7468 6520 736f 7572 6365 de in the source │ │ │ -001f4110: 2074 6861 7420 6973 2072 6574 7572 6e65 that is returne │ │ │ -001f4120: 6420 6279 2058 5041 5448 2065 7661 6c75 d by XPATH evalu │ │ │ -001f4130: 6174 696f 6e2e 2054 6869 7320 6e6f 6465 ation. This node │ │ │ -001f4140: 2069 6e20 7468 6520 636f 7069 6564 2064 in the copied d │ │ │ -001f4150: 6f63 756d 656e 7420 7769 6c6c 2062 6520 ocument will be │ │ │ -001f4160: 7265 6665 7272 6564 2074 6f20 6173 2061 referred to as a │ │ │ -001f4170: 2026 7175 6f74 3b68 6967 686c 6967 6874 "highlight │ │ │ -001f4180: 6564 2671 756f 743b 206e 6f64 652e 0a3c ed" node..< │ │ │ -001f4190: 2f70 6172 613e 0a3c 7061 7261 3e0a 4966 /para>..If │ │ │ -001f41a0: 2074 6865 2072 6573 756c 7420 6f66 2065 the result of e │ │ │ -001f41b0: 7661 6c75 6174 696f 6e20 6973 2061 6e20 valuation is an │ │ │ -001f41c0: 6174 7472 6962 7574 6520 656e 7469 7479 attribute entity │ │ │ -001f41d0: 2074 6865 6e20 7468 6520 7661 6c75 6520 then the value │ │ │ -001f41e0: 6f66 2074 6865 2061 7474 7269 6275 7465 of the attribute │ │ │ -001f41f0: 2069 6e20 7468 6520 6869 6768 6c69 6768 in the highligh │ │ │ -001f4200: 7465 6420 6e6f 6465 2069 7320 6368 616e ted node is chan │ │ │ -001f4210: 6765 642e 0a49 6620 3c70 6172 616d 6574 ged..If replacement1< │ │ │ -001f4230: 2f70 6172 616d 6574 6572 3e20 6973 204e /parameter> is N │ │ │ -001f4240: 554c 4c20 7468 656e 2074 6865 2061 7474 ULL then the att │ │ │ -001f4250: 7269 6275 7465 2069 7320 7265 6d6f 7665 ribute is remove │ │ │ -001f4260: 6420 6174 2061 6c6c 2c20 6f74 6865 7277 d at all, otherw │ │ │ -001f4270: 6973 6520 6974 7320 7661 6c75 6520 6973 ise its value is │ │ │ -001f4280: 2073 6574 2074 6f20 7468 6520 7374 7269 set to the stri │ │ │ -001f4290: 6e67 2076 616c 7565 206f 660a 7468 6520 ng value of.the │ │ │ -001f42a0: 3c70 6172 616d 6574 6572 3e72 6570 6c61 repla │ │ │ -001f42b0: 6365 6d65 6e74 313c 2f70 6172 616d 6574 cement1....If the resul │ │ │ -001f42e0: 7420 6f66 2065 7661 6c75 6174 696f 6e20 t of evaluation │ │ │ -001f42f0: 6973 206e 6f74 2061 6e20 6174 7472 6962 is not an attrib │ │ │ -001f4300: 7574 6520 656e 7469 7479 2062 7574 2061 ute entity but a │ │ │ -001f4310: 2065 6e74 6974 7920 7468 656e 2074 6865 entity then the │ │ │ -001f4320: 2068 6967 686c 6967 6874 6564 206e 6f64 highlighted nod │ │ │ -001f4330: 6520 6973 2072 6570 6c61 6365 6420 7769 e is replaced wi │ │ │ -001f4340: 7468 2074 6865 2076 616c 7565 206f 6620 th the value of │ │ │ -001f4350: 3c70 6172 616d 6574 6572 3e72 6570 6c61 repla │ │ │ -001f4360: 6365 6d65 6e74 313c 2f70 6172 616d 6574 cement1..The method │ │ │ -001f4380: 6f66 2020 7265 706c 6163 656d 656e 7420 of replacement │ │ │ -001f4390: 6465 7065 6e64 7320 6f6e 2074 6865 2074 depends on the t │ │ │ -001f43a0: 7970 6520 6f66 2074 6865 2072 6570 6c61 ype of the repla │ │ │ -001f43b0: 6365 6d65 6e74 2076 616c 7565 2e0a 4966 cement value..If │ │ │ -001f43c0: 203c 7061 7261 6d65 7465 723e 7265 706c repl │ │ │ -001f43d0: 6163 656d 656e 7431 3c2f 7061 7261 6d65 acement1 is NULL the │ │ │ -001f43f0: 6e20 7468 6520 6869 6768 6c69 6768 7465 n the highlighte │ │ │ -001f4400: 6420 6e6f 6465 2069 7320 7369 6d70 6c79 d node is simply │ │ │ -001f4410: 2072 656d 6f76 6564 2066 726f 6d20 7468 removed from th │ │ │ -001f4420: 6520 7265 7375 6c74 3b20 6966 2074 6865 e result; if the │ │ │ -001f4430: 206e 6f64 6520 6973 2074 6865 2072 6f6f node is the roo │ │ │ -001f4440: 7420 6f72 2061 0a73 696e 676c 6520 6368 t or a.single ch │ │ │ -001f4450: 696c 6420 6f66 2074 6865 2072 6f6f 7420 ild of the root │ │ │ -001f4460: 7468 656e 2066 756e 6374 696f 6e20 696d then function im │ │ │ -001f4470: 6d65 6469 6174 656c 7920 7265 7475 726e mediately return │ │ │ -001f4480: 7320 4e55 4c4c 2069 6e73 7465 6164 206f s NULL instead o │ │ │ -001f4490: 6620 616e 2058 4d4c 2065 6e74 6974 7920 f an XML entity │ │ │ -001f44a0: 2862 6563 6175 7365 2058 4d4c 2064 6f63 (because XML doc │ │ │ -001f44b0: 756d 656e 7420 6361 6e20 6e6f 7420 6265 ument can not be │ │ │ -001f44c0: 2074 6f74 616c 6c79 2065 6d70 7479 292c totally empty), │ │ │ -001f44d0: 0a6f 7468 6572 7769 7365 2074 6865 2070 .otherwise the p │ │ │ -001f44e0: 6172 656e 7420 6f66 2074 6865 2068 6967 arent of the hig │ │ │ -001f44f0: 686c 6967 6874 6564 206e 6f64 6520 7769 hlighted node wi │ │ │ -001f4500: 6c6c 2073 696d 706c 7920 6861 7665 206f ll simply have o │ │ │ -001f4510: 6e65 2063 6869 6c64 206c 6573 732e 0a49 ne child less..I │ │ │ -001f4520: 6620 3c70 6172 616d 6574 6572 3e72 6570 f rep │ │ │ -001f4530: 6c61 6365 6d65 6e74 313c 2f70 6172 616d lacement1 is an non- │ │ │ -001f4550: 656d 7074 7920 7374 7269 6e67 2074 6865 empty string the │ │ │ -001f4560: 6e20 7468 6520 6869 6768 6c69 6768 7465 n the highlighte │ │ │ -001f4570: 6420 6e6f 6465 2069 730a 7265 706c 6163 d node is.replac │ │ │ -001f4580: 6564 2077 6974 6820 6120 6e65 7720 7465 ed with a new te │ │ │ -001f4590: 7874 206e 6f64 6520 7768 6f73 6520 7374 xt node whose st │ │ │ -001f45a0: 7269 6e67 2076 616c 7565 2069 7320 6571 ring value is eq │ │ │ -001f45b0: 7561 6c20 746f 203c 7061 7261 6d65 7465 ual to replacement1..If < │ │ │ -001f45e0: 7061 7261 6d65 7465 723e 7265 706c 6163 parameter>replac │ │ │ -001f45f0: 656d 656e 7431 3c2f 7061 7261 6d65 7465 ement1 is an empty s │ │ │ -001f4610: 7472 696e 6720 7468 656e 2074 6865 2065 tring then the e │ │ │ -001f4620: 6666 6563 7420 6973 2065 7861 6374 6c79 ffect is exactly │ │ │ -001f4630: 2074 6865 2073 616d 6520 6173 2069 6e20 the same as in │ │ │ -001f4640: 6361 7365 206f 6620 4e55 4c4c 2062 6563 case of NULL bec │ │ │ -001f4650: 6175 7365 2074 6865 2073 7472 696e 6720 ause the string │ │ │ -001f4660: 7661 6c75 6520 6f66 2061 2074 6578 7420 value of a text │ │ │ -001f4670: 6e6f 6465 2063 616e 206e 6f74 2062 6520 node can not be │ │ │ -001f4680: 656d 7074 792e 0a49 6620 3c70 6172 616d empty..If replacement │ │ │ -001f46a0: 313c 2f70 6172 616d 6574 6572 3e20 6973 1 is │ │ │ -001f46b0: 2061 6e20 584d 4c20 656e 7469 7479 2074 an XML entity t │ │ │ -001f46c0: 6861 7420 6973 2061 2072 6f6f 7420 656e hat is a root en │ │ │ -001f46d0: 7469 7479 206f 6620 736f 6d65 2064 6f63 tity of some doc │ │ │ -001f46e0: 756d 656e 7420 7468 656e 2074 6865 2068 ument then the h │ │ │ -001f46f0: 6967 686c 6967 6874 6564 206e 6f64 6520 ighlighted node │ │ │ -001f4700: 6973 2072 6570 6c61 6365 6420 7769 7468 is replaced with │ │ │ -001f4710: 2061 2073 6571 7565 6e63 6520 6f66 2063 a sequence of c │ │ │ -001f4720: 6f70 6965 7320 6f66 2061 6c6c 2063 6869 opies of all chi │ │ │ -001f4730: 6c64 7265 6e20 6f66 2074 6861 7420 726f ldren of that ro │ │ │ -001f4740: 6f74 2e0a 4966 203c 7061 7261 6d65 7465 ot..If replacement1 is an │ │ │ -001f4770: 2058 4d4c 2065 6e74 6974 7920 6f66 2073 XML entity of s │ │ │ -001f4780: 6f6d 6520 6f74 6865 7220 736f 7274 2028 ome other sort ( │ │ │ -001f4790: 584d 4c20 656c 656d 656e 742c 2074 6578 XML element, tex │ │ │ -001f47a0: 742c 2063 6f6d 6d65 6e74 2065 7463 2e29 t, comment etc.) │ │ │ -001f47b0: 2074 6865 6e20 7468 6520 7468 6174 2069 then the that i │ │ │ -001f47c0: 7320 6e6f 7420 6120 726f 6f74 2065 6e74 s not a root ent │ │ │ -001f47d0: 6974 7920 6f66 2073 6f6d 6520 646f 6375 ity of some docu │ │ │ -001f47e0: 6d65 6e74 2074 6865 6e20 7468 6520 6869 ment then the hi │ │ │ -001f47f0: 6768 6c69 6768 7465 6420 6e6f 6465 2069 ghlighted node i │ │ │ -001f4800: 7320 7265 706c 6163 6564 2077 6974 6820 s replaced with │ │ │ -001f4810: 6120 7365 7175 656e 6365 206f 6620 636f a sequence of co │ │ │ -001f4820: 7069 6573 206f 6620 616c 6c20 6368 696c pies of all chil │ │ │ -001f4830: 6472 656e 206f 6620 7468 6174 2072 6f6f dren of that roo │ │ │ -001f4840: 742e 0a3c 2f70 6172 613e 0a3c 7061 7261 t....After editing │ │ │ -001f4860: 7468 6520 636f 7069 6564 2064 6f63 756d the copied docum │ │ │ -001f4870: 656e 742c 2073 6f6d 6520 6e6f 726d 616c ent, some normal │ │ │ -001f4880: 697a 6174 696f 6e20 6d61 7920 6861 7070 ization may happ │ │ │ -001f4890: 656e 2e20 5468 6520 6d6f 6469 6669 6564 en. The modified │ │ │ -001f48a0: 2064 6f63 756d 656e 7420 6d61 7920 636f document may co │ │ │ -001f48b0: 6e74 6169 6e20 6164 6a61 6365 6e74 2074 ntain adjacent t │ │ │ -001f48c0: 6578 7420 6e6f 6465 733b 2065 7665 7279 ext nodes; every │ │ │ -001f48d0: 2073 6571 7565 6e63 6520 6f66 2073 7563 sequence of suc │ │ │ -001f48e0: 6820 6e6f 6465 730a 6973 2072 6570 6c61 h nodes.is repla │ │ │ -001f48f0: 6365 6420 7769 7468 206f 6e65 2074 6578 ced with one tex │ │ │ -001f4900: 7420 6e6f 6465 2077 686f 7365 2073 7472 t node whose str │ │ │ -001f4910: 696e 6720 7661 6c75 6520 6973 2061 2063 ing value is a c │ │ │ -001f4920: 6f6e 6361 7465 6e61 7469 6f6e 206f 6620 oncatenation of │ │ │ -001f4930: 7374 7269 6e67 2076 616c 7565 7320 6f66 string values of │ │ │ -001f4940: 2074 6861 7420 6e6f 6465 732e 2045 2e67 that nodes. E.g │ │ │ -001f4950: 2e20 6966 2074 6865 2068 6967 686c 6967 . if the highlig │ │ │ -001f4960: 6874 6564 206e 6f64 6520 6973 2061 6e20 hted node is an │ │ │ -001f4970: 656c 656d 656e 7420 266c 743b 612f 2667 element <a/&g │ │ │ -001f4980: 743b 0a74 6861 7420 7265 7369 6465 7320 t;.that resides │ │ │ -001f4990: 6265 7477 6565 6e20 7477 6f20 7465 7874 between two text │ │ │ -001f49a0: 206e 6f64 6573 2026 7175 6f74 3b74 6578 nodes "tex │ │ │ -001f49b0: 7431 2671 756f 743b 2061 6e64 2026 7175 t1" and &qu │ │ │ -001f49c0: 6f74 3b74 6578 7432 2671 756f 743b 2061 ot;text2" a │ │ │ -001f49d0: 6e64 2074 6865 2068 6967 686c 6967 6874 nd the highlight │ │ │ -001f49e0: 6564 206e 6f64 6520 6973 2072 656d 6f76 ed node is remov │ │ │ -001f49f0: 6564 2c20 7468 656e 2074 6865 7365 2074 ed, then these t │ │ │ -001f4a00: 6578 7420 6e6f 6465 7320 6265 636f 6d65 ext nodes become │ │ │ -001f4a10: 206e 6569 6768 626f 7273 3b0a 6e6f 726d neighbors;.norm │ │ │ -001f4a20: 616c 697a 6174 696f 6e20 7769 6c6c 2072 alization will r │ │ │ -001f4a30: 6570 6c61 6365 2074 6865 6d20 7769 7468 eplace them with │ │ │ -001f4a40: 2061 2073 696e 676c 6520 7465 7874 206e a single text n │ │ │ -001f4a50: 6f64 6520 2671 756f 743b 7465 7874 3174 ode "text1t │ │ │ -001f4a60: 6578 7432 2671 756f 743b 0a3c 2f70 6172 ext2"...Now co │ │ │ -001f4a80: 6e73 6964 6572 2074 6865 2063 6173 6520 nsider the case │ │ │ -001f4a90: 6f66 206d 6f72 6520 7468 616e 206f 6e65 of more than one │ │ │ -001f4aa0: 2072 6570 6c61 6365 6d65 6e74 206d 6164 replacement mad │ │ │ -001f4ab0: 6520 696e 206f 6e65 2066 756e 6374 696f e in one functio │ │ │ -001f4ac0: 6e20 6361 6c6c 2e20 4966 206d 6f72 6520 n call. If more │ │ │ -001f4ad0: 7468 616e 206f 6e65 2070 6169 7220 6f66 than one pair of │ │ │ -001f4ae0: 2058 5041 5448 2065 7870 7265 7373 696f XPATH expressio │ │ │ -001f4af0: 6e20 616e 6420 7265 706c 6163 656d 656e n and replacemen │ │ │ -001f4b00: 7420 6973 2067 6976 656e 2074 6865 6e0a t is given then. │ │ │ -001f4b10: 7468 6520 6675 6e63 7469 6f6e 2066 6972 the function fir │ │ │ -001f4b20: 7374 2066 696e 6473 2061 6c6c 2068 6967 st finds all hig │ │ │ -001f4b30: 686c 6967 6874 6564 206e 6f64 6573 2c20 hlighted nodes, │ │ │ -001f4b40: 616c 6c20 746f 6765 7468 6572 2c20 7468 all together, th │ │ │ -001f4b50: 656e 2069 7420 7065 7266 6f72 6d73 2061 en it performs a │ │ │ -001f4b60: 6c6c 2072 6570 6c61 6365 6d65 6e74 732c ll replacements, │ │ │ -001f4b70: 2074 6865 6e20 6974 2070 6572 666f 726d then it perform │ │ │ -001f4b80: 7320 616e 206e 6f72 6d61 6c69 7a61 7469 s an normalizati │ │ │ -001f4b90: 6f6e 2e0a 4974 2069 7320 7665 7279 2069 on..It is very i │ │ │ -001f4ba0: 6d70 6f72 7461 6e74 2074 6f20 756e 6465 mportant to unde │ │ │ -001f4bb0: 7273 7461 6e64 2074 6861 7420 7468 6520 rstand that the │ │ │ -001f4bc0: 6f72 6465 7220 6f66 206d 616b 696e 6720 order of making │ │ │ -001f4bd0: 7265 706c 6163 656d 656e 7473 2068 6173 replacements has │ │ │ -001f4be0: 206e 6f74 6869 6e67 2074 6f20 646f 2020 nothing to do │ │ │ -001f4bf0: 7769 7468 2074 6865 206f 7264 6572 206f with the order o │ │ │ -001f4c00: 6620 7061 6972 7320 6f66 2070 6172 616d f pairs of param │ │ │ -001f4c10: 6574 6572 7320 696e 2074 6865 2066 756e eters in the fun │ │ │ -001f4c20: 6374 696f 6e20 6361 6c6c 2e0a 4966 2073 ction call..If s │ │ │ -001f4c30: 6f6d 6520 6869 6768 6c69 6768 7465 6420 ome highlighted │ │ │ -001f4c40: 6e6f 6465 2069 7320 616e 2061 6e63 6573 node is an ances │ │ │ -001f4c50: 746f 7220 6f66 2073 6f6d 6520 6f74 6865 tor of some othe │ │ │ -001f4c60: 7220 6869 6768 6c69 6768 7465 6420 6e6f r highlighted no │ │ │ -001f4c70: 6465 2074 6865 6e20 7468 6520 6566 6665 de then the effe │ │ │ -001f4c80: 6374 206f 6620 7468 6520 7265 706c 6163 ct of the replac │ │ │ -001f4c90: 656d 656e 7420 6f66 2074 6865 2064 6573 ement of the des │ │ │ -001f4ca0: 6365 6e64 616e 7420 6869 6768 6c69 6768 cendant highligh │ │ │ -001f4cb0: 7465 6420 6e6f 6465 2069 7320 766f 6964 ted node is void │ │ │ -001f4cc0: 3a0a 7468 6520 6465 7363 656e 6461 6e74 :.the descendant │ │ │ -001f4cd0: 2069 7320 7265 706c 6163 6564 2066 6972 is replaced fir │ │ │ -001f4ce0: 7374 3b20 7468 656e 2074 6865 2061 6e63 st; then the anc │ │ │ -001f4cf0: 6573 746f 7220 6973 2072 6570 6c61 6365 estor is replace │ │ │ -001f4d00: 6420 6173 2061 2077 686f 6c65 2c20 6e6f d as a whole, no │ │ │ -001f4d10: 206d 6174 7465 7220 6966 2073 6f6d 6520 matter if some │ │ │ -001f4d20: 6f66 2069 7473 2064 6573 6365 6e64 616e of its descendan │ │ │ -001f4d30: 7473 2061 7265 206d 6f64 6966 6965 642e ts are modified. │ │ │ -001f4d40: 0a49 6620 6120 6e6f 6465 2069 7320 7468 .If a node is th │ │ │ -001f4d50: 6520 7265 7375 6c74 206f 6620 7477 6f20 e result of two │ │ │ -001f4d60: 6469 6666 6572 656e 7420 5850 4154 4820 different XPATH │ │ │ -001f4d70: 6578 7072 6573 7369 6f6e 7320 2826 7175 expressions (&qu │ │ │ -001f4d80: 6f74 3b68 6967 686c 6967 6874 6564 206d ot;highlighted m │ │ │ -001f4d90: 6f72 6520 7468 616e 206f 6e63 6526 7175 ore than once&qu │ │ │ -001f4da0: 6f74 3b29 2c20 7468 6520 6f72 6465 7220 ot;), the order │ │ │ -001f4db0: 6f66 2070 6172 616d 6574 6572 7320 696e of parameters in │ │ │ -001f4dc0: 2074 6865 2066 756e 6374 696f 6e20 6361 the function ca │ │ │ -001f4dd0: 6c6c 0a69 7320 7573 6564 2074 6f20 7265 ll.is used to re │ │ │ -001f4de0: 736f 6c76 6520 616d 6269 6775 6974 793a solve ambiguity: │ │ │ -001f4df0: 2074 6865 206c 6173 7420 7061 6972 206f the last pair o │ │ │ -001f4e00: 6620 7061 7261 6d65 7465 7273 2077 696c f parameters wil │ │ │ -001f4e10: 6c20 6861 7665 2061 2068 6967 6865 7220 l have a higher │ │ │ -001f4e20: 7072 696f 7269 7479 2e0a 3c2f 7061 7261 priority.....< │ │ │ -001f4e60: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ -001f4e70: 3c2f 7469 746c 653e 0a3c 7265 6673 6563 ..sourc │ │ │ -001f4e90: 653c 2f74 6974 6c65 3e0a 3c70 6172 613e e. │ │ │ -001f4ea0: 4120 736f 7572 6365 2058 4d4c 2074 7265 A source XML tre │ │ │ -001f4eb0: 6520 656e 7469 7479 2e20 4974 2069 7320 e entity. It is │ │ │ -001f4ec0: 616e 2065 7272 6f72 2074 6f20 7061 7373 an error to pass │ │ │ -001f4ed0: 2070 6572 7369 7374 656e 7420 584d 4c20 persistent XML │ │ │ -001f4ee0: 656e 7469 7479 2061 7320 616e 2061 7267 entity as an arg │ │ │ -001f4ef0: 756d 656e 742e 3c2f 7061 7261 3e0a 3c2f ument....path │ │ │ -001f4f20: 493c 2f74 6974 6c65 3e0a 3c70 6172 613e I. │ │ │ -001f4f30: 4120 7465 7874 206f 6620 5850 4154 4820 A text of XPATH │ │ │ -001f4f40: 6578 7072 6573 7369 6f6e 2074 6f20 6265 expression to be │ │ │ -001f4f50: 2075 7365 6420 696e 206f 7264 6572 2074 used in order t │ │ │ -001f4f60: 6f20 6669 6e64 206e 6f64 6573 2074 6f20 o find nodes to │ │ │ -001f4f70: 7265 706c 6163 652e 3c2f 7061 7261 3e0a replace.. │ │ │ -001f4f80: 3c2f 7265 6673 6563 7432 3e0a 3c72 6566 ..re │ │ │ -001f4fa0: 706c 6163 656d 656e 7449 3c2f 7469 746c placementI</titl │ │ │ -001f4fb0: 653e 0a3c 7061 7261 3e41 2072 6570 6c61 e>.<para>A repla │ │ │ -001f4fc0: 6365 6d65 6e74 2076 616c 7565 2066 6f72 cement value for │ │ │ -001f4fd0: 2058 4d4c 206e 6f64 6573 2066 6f75 6e64 XML nodes found │ │ │ -001f4fe0: 2062 7920 3c70 6172 616d 6574 6572 3e70 by <parameter>p │ │ │ -001f4ff0: 6174 6849 3c2f 7061 7261 6d65 7465 723e athI</parameter> │ │ │ -001f5000: 3b20 6974 206d 6179 2062 6520 4e55 4c4c ; it may be NULL │ │ │ -001f5010: 206f 7220 584d 4c20 7472 6565 2065 6e74 or XML tree ent │ │ │ -001f5020: 6974 7920 6f72 2061 2073 7472 696e 6720 ity or a string │ │ │ -001f5030: 7220 616e 7974 6869 6e67 2065 6c73 6520 r anything else │ │ │ -001f5040: 6275 7420 6e6f 7420 616e 2070 6572 7369 but not an persi │ │ │ -001f5050: 7374 656e 7420 584d 4c20 656e 7469 7479 stent XML entity │ │ │ -001f5060: 2e3c 2f70 6172 613e 0a3c 2f72 6566 7365 .</para>.</refse │ │ │ -001f5070: 6374 323e 0a3c 2f72 6566 7365 6374 313e ct2>.</refsect1> │ │ │ -001f5080: 0a3c 7265 6673 6563 7431 2069 643d 2272 .<refsect1 id="r │ │ │ -001f5090: 6574 5f58 4d4c 5570 6461 7465 223e 0a3c et_XMLUpdate">.< │ │ │ -001f50a0: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ -001f50b0: 6573 3c2f 7469 746c 653e 0a3c 7061 7261 es.If the source parameter │ │ │ -001f50f0: 6973 2061 6e20 584d 4c20 7472 6565 2065 is an XML tree e │ │ │ -001f5100: 6e74 6974 7920 7468 656e 2074 6865 2066 ntity then the f │ │ │ -001f5110: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ -001f5120: 616e 2058 4d4c 2074 7265 6520 656e 7469 an XML tree enti │ │ │ -001f5130: 7479 2074 6861 7420 706f 696e 7473 2074 ty that points t │ │ │ -001f5140: 6f20 7468 6520 726f 6f74 206f 6620 7468 o the root of th │ │ │ -001f5150: 6520 6d6f 6469 6669 6564 2063 6f70 7920 e modified copy │ │ │ -001f5160: 6f66 2074 6865 2073 6f75 7263 6520 646f of the source do │ │ │ -001f5170: 6375 6d65 6e74 206f 7220 6120 4e55 4c4c cument or a NULL │ │ │ -001f5180: 2e0a 4966 2074 6865 203c 7061 7261 6d65 ..If the source is an ins │ │ │ -001f51b0: 7461 6e63 6520 6f66 2058 4d4c 5479 7065 tance of XMLType │ │ │ -001f51c0: 2074 6865 6e20 6120 6e6f 6e2d 7363 6865 then a non-sche │ │ │ -001f51d0: 6d61 2062 6173 6564 2069 6e73 7461 6e63 ma based instanc │ │ │ -001f51e0: 6520 6f66 2058 4d4c 5479 7065 2069 7320 e of XMLType is │ │ │ -001f51f0: 6372 6561 7465 6420 6672 6f6d 2074 6865 created from the │ │ │ -001f5200: 2072 6573 756c 7469 6e67 2058 4d4c 2074 resulting XML t │ │ │ -001f5210: 7265 6520 656e 7469 7479 2e0a 3c2f 7061 ree entity.... │ │ │ -001f5230: 3c72 6566 7365 6374 3120 6964 3d22 6578 .Exampl │ │ │ -001f5260: 6573 3c2f 7469 746c 653e 0a3c 6578 616d es.. │ │ │ -001f5290: 4120 7369 6d70 6c65 2072 6570 6c61 6365 A simple replace │ │ │ -001f52a0: 6d65 6e74 206f 6620 6f6e 6520 656c 656d ment of one elem │ │ │ -001f52b0: 656e 7420 7769 7468 206f 7468 6572 3c2f ent with other</ │ │ │ -001f52c0: 7469 746c 653e 0a3c 7061 7261 3e54 6865 title>.<para>The │ │ │ -001f52d0: 2063 616c 6c20 6f66 2066 756e 6374 696f call of functio │ │ │ -001f52e0: 6e20 3c66 756e 6374 696f 6e3e 584d 4c55 n <function>XMLU │ │ │ -001f52f0: 7064 6174 653c 2f66 756e 6374 696f 6e3e pdate</function> │ │ │ -001f5300: 2072 6570 6c61 6365 7320 656c 656d 656e replaces elemen │ │ │ -001f5310: 7420 2763 2720 7769 7468 2061 2063 6f70 t 'c' with a cop │ │ │ -001f5320: 7920 6f66 2065 6c65 6d65 6e74 2027 7265 y of element 're │ │ │ -001f5330: 706c 6163 656d 656e 7427 2e3c 2f70 6172 placement'.</par │ │ │ -001f5340: 613e 0a3c 7363 7265 656e 3e3c 215b 4344 a>.<screen><![CD │ │ │ -001f5350: 4154 415b 0a73 656c 6563 7420 584d 4c55 ATA[.select XMLU │ │ │ -001f5360: 7064 6174 6520 2878 7472 6565 5f64 6f63 pdate (xtree_doc │ │ │ -001f5370: 2827 3c61 3e3c 623e 3c71 2f3e 2d3c 633e ('<a><b><q/>-<c> │ │ │ -001f5380: 4865 6c6c 6f3c 2f63 3e2d 3c2f 623e 3c2f Hello</c>-</b></ │ │ │ -001f5390: 613e 2729 2c20 272f 2f63 272c 2078 7472 a>'), '//c', xtr │ │ │ -001f53a0: 6565 5f64 6f63 2827 3c72 6570 6c61 6365 ee_doc('<replace │ │ │ -001f53b0: 6d65 6e74 2f3e 2729 290a 6361 6c6c 7265 ment/>')).callre │ │ │ -001f53c0: 740a 5641 5243 4841 520a 5f5f 5f5f 5f5f t.VARCHAR.______ │ │ │ -001f53d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f53e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f53f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f5400: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f5410: 5f5f 5f5f 5f5f 5f5f 5f0a 0a3c 613e 3c62 _________..<a><b │ │ │ -001f5420: 3e3c 7120 2f3e 2d3c 7265 706c 6163 656d ><q />-<replacem │ │ │ -001f5430: 656e 7420 2f3e 2d3c 2f62 3e3c 2f61 3e5d ent />-</b></a>] │ │ │ -001f5440: 5d3e 0a3c 2f73 6372 6565 6e3e 0a3c 2f65 ]>.</screen>.</e │ │ │ -001f5450: 7861 6d70 6c65 3e0a 3c65 7861 6d70 6c65 xample>.<example │ │ │ -001f5460: 2069 643d 2265 785f 584d 4c55 7064 6174 id="ex_XMLUpdat │ │ │ -001f5470: 655f 3222 3e0a 3c74 6974 6c65 3e54 776f e_2">.<title>Two │ │ │ -001f5480: 2072 6570 6c61 6365 6d65 6e74 7320 696e replacements in │ │ │ -001f5490: 2070 6172 616c 6c65 6c3c 2f74 6974 6c65 parallel.Elements │ │ │ -001f54b0: 2074 6974 6c65 6420 2763 3127 2061 6e64 titled 'c1' and │ │ │ -001f54c0: 2027 6333 2720 6172 6520 7265 706c 6163 'c3' are replac │ │ │ -001f54d0: 6564 2077 6974 6820 7465 7874 206e 6f64 ed with text nod │ │ │ -001f54e0: 6573 2e3c 2f70 6172 613e 0a3c 7363 7265 es.. │ │ │ -001f5520: 3c63 313e 4865 6c6c 6f31 3c2f 6331 3e3c Hello1< │ │ │ -001f5530: 6332 3e48 656c 6c6f 323c 2f63 323e 3c63 c2>Hello2Hello3'), '//c1', │ │ │ -001f5560: 2027 776f 726c 6431 272c 2027 2f2f 6333 'world1', '//c3 │ │ │ -001f5570: 272c 2027 776f 726c 6433 2729 0a63 616c ', 'world3').cal │ │ │ -001f5580: 6c72 6574 0a56 4152 4348 4152 0a5f 5f5f lret.VARCHAR.___ │ │ │ -001f5590: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f55a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f55b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f55c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f55d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 3c61 ____________..world1He │ │ │ -001f55f0: 6c6c 6f32 3c2f 6332 3e77 6f72 6c64 333c llo2world3< │ │ │ -001f5600: 2f62 3e3c 2f61 3e5d 5d3e 0a3c 2f73 6372 /b>]]>... │ │ │ -001f5620: 3c2f 7265 6673 6563 7431 3e0a 3c72 6566 ..See Also.XMLReplace │ │ │ -001f56b0: 3c2f 7061 7261 3e0a 3c70 6172 613e 3c6c .XMLAd │ │ │ -001f56f0: 6441 7474 7269 6275 7465 3c2f 6675 6e63 dAttribute.< │ │ │ -001f5740: 6675 6e63 7469 6f6e 3e58 4d4c 4170 7065 function>XMLAppe │ │ │ -001f5750: 6e64 4368 696c 6472 656e 3c2f 6675 6e63 ndChildren.XMLInsert │ │ │ -001f57b0: 4265 666f 7265 3c2f 6675 6e63 7469 6f6e Before. │ │ │ -001f57d0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b XMLInsertAfter │ │ │ -001f5810: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e . │ │ │ -001f5830: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xslt. │ │ │ -001f5870: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 ......%dem │ │ │ -001f5890: 6f2f 646f 6373 7263 2f66 756e 6372 6566 o/docsrc/funcref │ │ │ -001f58a0: 2f78 6d6c 7371 6c5f 7570 6461 7465 2e78 /xmlsql_update.x │ │ │ -001f58b0: 6d6c df00 0011 103c 3f78 6d6c 2076 6572 ml........ │ │ │ -001f5c70: 0a20 2020 203c 7265 6665 6e74 7279 7469 . xmlsql_updat │ │ │ -001f5c90: 653c 2f72 6566 656e 7472 7974 6974 6c65 e. xml. . │ │ │ -001f5ce0: 0a20 2020 203c 7265 666e 616d 653e 786d . xm │ │ │ -001f5cf0: 6c73 716c 5f75 7064 6174 653c 2f72 6566 lsql_update. Performs i │ │ │ -001f5d20: 6e73 6572 742f 7570 6461 7465 2f64 656c nsert/update/del │ │ │ -001f5d30: 6574 6520 6f70 6572 6174 696f 6e73 0a20 ete operations. │ │ │ -001f5d40: 2020 2062 6173 6564 206f 6e20 616e 2058 based on an X │ │ │ -001f5d50: 4d4c 2075 7064 6174 6567 7261 6d2e 3c2f ML updategram.. . . │ │ │ -001f5d90: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . │ │ │ -001f5dc0: 3c66 756e 6370 726f 746f 7479 7065 2069 ..xm │ │ │ -001f5e00: 6c73 716c 5f75 7064 6174 653c 2f66 756e lsql_update │ │ │ -001f5e20: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -001f5e30: 7061 7261 6d65 7465 723e 786d 6c5f 6772 parameter>xml_gr │ │ │ -001f5e40: 616d 733c 2f70 6172 616d 6574 6572 3e58 amsX │ │ │ -001f5e50: 4d4c 5f45 6e74 6974 7920 3c2f 7061 7261 ML_Entity ..in

    input_p │ │ │ -001f5e90: 6172 616d 6574 6572 733c 2f70 6172 616d arameters vector..in debug integer< │ │ │ -001f5f00: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>. . │ │ │ -001f5f30: 203c 2f66 756e 6373 796e 6f70 7369 733e │ │ │ -001f5f40: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . . │ │ │ -001f5f80: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -001f5f90: 6c65 3e0a 2020 2020 3c70 6172 613e 3c66 le>. <para><f │ │ │ -001f5fa0: 756e 6374 696f 6e3e 786d 6c73 716c 5f75 unction>xmlsql_u │ │ │ -001f5fb0: 7064 6174 6528 293c 2f66 756e 6374 696f pdate()</functio │ │ │ -001f5fc0: 6e3e 2073 7570 706f 7274 7320 584d 4c2d n> supports XML- │ │ │ -001f5fd0: 6261 7365 6420 696e 7365 7274 2c0a 2020 based insert,. │ │ │ -001f5fe0: 2020 7570 6461 7465 2c20 616e 6420 6465 update, and de │ │ │ -001f5ff0: 6c65 7465 206f 7065 7261 7469 6f6e 7320 lete operations │ │ │ -001f6000: 7065 7266 6f72 6d65 6420 6f6e 2061 6e20 performed on an │ │ │ -001f6010: 6578 6973 7469 6e67 2074 6162 6c65 2069 existing table i │ │ │ -001f6020: 6e20 7468 650a 2020 2020 6461 7461 6261 n the. databa │ │ │ -001f6030: 7365 2e20 5365 6520 3c6c 696e 6b20 6c69 se. See <link li │ │ │ -001f6040: 6e6b 656e 643d 2275 7064 6174 6567 7261 nkend="updategra │ │ │ -001f6050: 6d73 223e 5570 6461 7465 6772 616d 7320 ms">Updategrams │ │ │ -001f6060: 6261 7369 6373 3c2f 6c69 6e6b 3e0a 2020 basics</link>. │ │ │ -001f6070: 2020 696e 2074 6865 2026 7175 6f74 3b57 in the "W │ │ │ -001f6080: 6562 2061 6e64 2058 4d4c 2073 6563 7469 eb and XML secti │ │ │ -001f6090: 6f6e 2671 756f 743b 2066 6f72 2061 2064 on" for a d │ │ │ -001f60a0: 6574 6169 6c65 6420 6578 706c 616e 6174 etailed explanat │ │ │ -001f60b0: 696f 6e2e 3c2f 7061 7261 3e0a 2020 3c2f ion.</para>. </ │ │ │ -001f60c0: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -001f60d0: 7365 6374 3120 6964 3d22 7061 7261 6d73 sect1 id="params │ │ │ -001f60e0: 5f78 6d6c 7371 6c5f 7570 6461 7465 223e _xmlsql_update"> │ │ │ -001f60f0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 <title>Parameter │ │ │ -001f6100: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. x │ │ │ -001f6120: 6d6c 5f67 7261 6d73 3c2f 7469 746c 653e ml_grams │ │ │ -001f6130: 0a20 2020 2020 203c 7061 7261 3e4d 616e . Man │ │ │ -001f6140: 6461 746f 7279 2070 6172 616d 6574 6572 datory parameter │ │ │ -001f6150: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ -001f6160: 584d 4c20 646f 6375 6d65 6e74 2077 6974 XML document wit │ │ │ -001f6170: 6820 6772 616d 2873 292e 0a20 2020 2020 h gram(s).. │ │ │ -001f6180: 2054 6869 7320 6361 6e20 6265 2070 726f This can be pro │ │ │ -001f6190: 6475 6365 6420 7769 7468 2073 6571 7565 duced with seque │ │ │ -001f61a0: 6e74 6961 6c20 6361 6c6c 7320 746f 2074 ntial calls to t │ │ │ -001f61b0: 6865 0a20 2020 203c 6675 6e63 7469 6f6e he. xml_tree() and. │ │ │ -001f61e0: 203c 6675 6e63 7469 6f6e 3e78 6d6c 5f74 xml_t │ │ │ -001f61f0: 7265 655f 646f 6328 293c 2f66 756e 6374 ree_doc() functions.< │ │ │ -001f6210: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . inpu │ │ │ -001f6240: 745f 7061 7261 6d65 7465 7273 3c2f 7469 t_parameters</ti │ │ │ -001f6250: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -001f6260: 3e4f 7074 696f 6e61 6c20 6172 7261 7920 >Optional array │ │ │ -001f6270: 6f72 2076 6563 746f 7220 6f66 2070 6172 or vector of par │ │ │ -001f6280: 616d 6574 6572 2070 6169 7273 2028 7061 ameter pairs (pa │ │ │ -001f6290: 7261 6d65 7465 725f 6e61 6d65 2c20 7061 rameter_name, pa │ │ │ -001f62a0: 7261 6d65 7465 725f 7661 6c75 6529 2e3c rameter_value).< │ │ │ -001f62b0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. </ref │ │ │ -001f62c0: 7365 6374 323e 0a20 2020 203c 7265 6673 sect2>. <refs │ │ │ -001f62d0: 6563 7432 3e3c 7469 746c 653e 6465 6275 ect2><title>debu │ │ │ -001f62e0: 673c 2f74 6974 6c65 3e0a 093c 7061 7261 g..The debug param │ │ │ -001f6300: 6574 6572 2074 616b 6573 2076 616c 7565 eter takes value │ │ │ -001f6310: 7320 312f 3020 746f 2065 6e61 626c 6528 s 1/0 to enable( │ │ │ -001f6320: 3129 206f 7220 6469 7361 626c 6528 3029 1) or disable(0) │ │ │ -001f6330: 2070 7269 6e74 696e 6720 6f66 2074 6865 printing of the │ │ │ -001f6340: 2053 514c 0a09 2020 2020 7374 6174 656d SQL.. statem │ │ │ -001f6350: 656e 7473 2069 7420 6765 6e65 7261 7465 ents it generate │ │ │ -001f6360: 7320 6672 6f6d 2074 6865 2075 7064 6174 s from the updat │ │ │ -001f6370: 6567 7261 6d73 206f 6e20 7468 6520 7365 egrams on the se │ │ │ -001f6380: 7276 6572 2773 2073 7461 6e64 6172 6420 rver's standard │ │ │ -001f6390: 6f75 7470 7574 2e20 4966 206e 6f74 2073 output. If not s │ │ │ -001f63a0: 7065 6369 6669 6564 2074 6865 2064 6566 pecified the def │ │ │ -001f63b0: 6175 6c74 2069 7320 6469 7361 626c 6564 ault is disabled │ │ │ -001f63c0: 2028 3029 2e3c 2f70 6172 613e 0a20 2020 (0).. │ │ │ -001f63d0: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ -001f63e0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Return Valu │ │ │ -001f6420: 6573 3c2f 7469 746c 653e 0a20 2020 2020 es. │ │ │ -001f6430: 203c 7061 7261 3e5a 6572 6f2c 2069 6620 Zero, if │ │ │ -001f6440: 6e6f 2065 7272 6f72 2069 7320 7369 676e no error is sign │ │ │ -001f6450: 616c 6c65 642e 3c2f 7061 7261 3e0a 2020 alled.. │ │ │ -001f6460: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . Errors< │ │ │ -001f64a0: 2f74 6974 6c65 3e0a 2020 2020 3c74 6162 /title>. <tab │ │ │ -001f64b0: 6c65 3e3c 7469 746c 653e 4572 726f 7273 le><title>Errors │ │ │ -001f64c0: 2073 6967 6e61 6c6c 6564 2062 7920 786d signalled by xm │ │ │ -001f64d0: 6c73 716c 5f75 7064 6174 653c 2f74 6974 lsql_update</tit │ │ │ -001f64e0: 6c65 3e0a 2020 2020 2020 3c74 6772 6f75 le>. <tgrou │ │ │ -001f64f0: 7020 636f 6c73 3d22 3222 3e0a 2020 2020 p cols="2">. │ │ │ -001f6500: 2020 2020 3c74 6865 6164 3e0a 0920 203c <thead>.. < │ │ │ -001f6510: 726f 773e 3c65 6e74 7279 3e45 7272 6f72 row><entry>Error │ │ │ -001f6520: 2043 6f64 653c 2f65 6e74 7279 3e3c 656e Code</entry><en │ │ │ -001f6530: 7472 793e 4572 726f 7220 5465 7874 3c2f try>Error Text</ │ │ │ -001f6540: 656e 7472 793e 3c2f 726f 773e 0a20 2020 entry></row>. │ │ │ -001f6550: 2020 2020 203c 2f74 6865 6164 3e0a 2020 </thead>. │ │ │ -001f6560: 2020 2020 2020 3c74 626f 6479 3e0a 0920 <tbody>.. │ │ │ -001f6570: 203c 726f 773e 0a09 2020 2020 3c65 6e74 <row>.. <ent │ │ │ -001f6580: 7279 3e3c 6572 726f 7263 6f64 653e 5850 ry><errorcode>XP │ │ │ -001f6590: 3337 303c 2f65 7272 6f72 636f 6465 3e3c 370</errorcode>< │ │ │ -001f65a0: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ -001f65b0: 7472 793e 3c65 7272 6f72 6e61 6d65 3e78 try><errorname>x │ │ │ -001f65c0: 6d6c 7371 6c5f 7570 6461 7465 206e 6565 mlsql_update nee │ │ │ -001f65d0: 6473 2061 6e20 656e 7469 7479 2061 7320 ds an entity as │ │ │ -001f65e0: 6172 6775 6d65 6e74 3c2f 6572 726f 726e argument</errorn │ │ │ -001f65f0: 616d 653e 3c2f 656e 7472 793e 0a09 2020 ame></entry>.. │ │ │ -001f6600: 3c2f 726f 773e 0a09 2020 3c72 6f77 3e0a </row>.. <row>. │ │ │ -001f6610: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ -001f6620: 6f72 636f 6465 3e34 3230 3030 3c2f 6572 orcode>42000</er │ │ │ -001f6630: 726f 7263 6f64 653e 3c2f 656e 7472 793e rorcode></entry> │ │ │ -001f6640: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -001f6650: 726f 726e 616d 653e 786d 6c73 716c 5f75 rorname>xmlsql_u │ │ │ -001f6660: 7064 6174 6520 6578 7065 6374 7320 6120 pdate expects a │ │ │ -001f6670: 7665 6374 6f72 206f 6620 6576 656e 206c vector of even l │ │ │ -001f6680: 656e 6774 6820 6173 2073 6563 6f6e 6420 ength as second │ │ │ -001f6690: 6172 6775 6d65 6e74 3c2f 6572 726f 726e argument</errorn │ │ │ -001f66a0: 616d 653e 3c2f 656e 7472 793e 0a09 2020 ame></entry>.. │ │ │ -001f66b0: 3c2f 726f 773e 0a09 2020 3c72 6f77 3e0a </row>.. <row>. │ │ │ -001f66c0: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ -001f66d0: 6f72 636f 6465 3e53 5839 3939 3c2f 6572 orcode>SX999</er │ │ │ -001f66e0: 726f 7263 6f64 653e 3c2f 656e 7472 793e rorcode></entry> │ │ │ -001f66f0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -001f6700: 726f 726e 616d 653e 456d 7074 7920 7061 rorname>Empty pa │ │ │ -001f6710: 7261 6d65 7465 7273 206c 6973 743c 2f65 rameters list</e │ │ │ -001f6720: 7272 6f72 6e61 6d65 3e3c 2f65 6e74 7279 rrorname></entry │ │ │ -001f6730: 3e0a 0920 203c 2f72 6f77 3e0a 0920 203c >.. </row>.. < │ │ │ -001f6740: 726f 773e 0a09 2020 2020 3c65 6e74 7279 row>.. <entry │ │ │ -001f6750: 3e3c 6572 726f 7263 6f64 653e 5358 3939 ><errorcode>SX99 │ │ │ -001f6760: 383c 2f65 7272 6f72 636f 6465 3e3c 2f65 8</errorcode></e │ │ │ -001f6770: 6e74 7279 3e0a 0920 2020 203c 656e 7472 ntry>.. <entr │ │ │ -001f6780: 793e 3c65 7272 6f72 6e61 6d65 3e54 6f6f y><errorname>Too │ │ │ -001f6790: 206d 616e 7920 7661 6c75 6573 2066 6f72 many values for │ │ │ -001f67a0: 2071 7565 7279 3c2f 6572 726f 726e 616d query</errornam │ │ │ -001f67b0: 653e 3c2f 656e 7472 793e 0a09 2020 3c2f e></entry>.. </ │ │ │ -001f67c0: 726f 773e 0a09 2020 3c72 6f77 3e0a 0920 row>.. <row>.. │ │ │ -001f67d0: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ -001f67e0: 636f 6465 3e53 5839 3938 3c2f 6572 726f code>SX998</erro │ │ │ -001f67f0: 7263 6f64 653e 3c2f 656e 7472 793e 0a09 rcode></entry>.. │ │ │ -001f6800: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ -001f6810: 726e 616d 653e 4e6f 2063 6f6c 756d 6e73 rname>No columns │ │ │ -001f6820: 2073 7065 6369 6669 6564 2069 6e20 7570 specified in up │ │ │ -001f6830: 6461 7465 6772 616d 3c2f 6572 726f 726e dategram</errorn │ │ │ -001f6840: 616d 653e 3c2f 656e 7472 793e 0a09 2020 ame></entry>.. │ │ │ -001f6850: 3c2f 726f 773e 0a09 3c2f 7462 6f64 793e </row>..</tbody> │ │ │ -001f6860: 0a20 2020 2020 203c 2f74 6772 6f75 703e . </tgroup> │ │ │ -001f6870: 0a20 2020 203c 2f74 6162 6c65 3e0a 2020 . </table>. │ │ │ -001f6880: 3c2f 7265 6673 6563 7431 3e0a 3c21 2d2d </refsect1>.<!-- │ │ │ -001f6890: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ -001f68a0: 2265 7861 6d70 6c65 735f 786d 6c73 716c "examples_xmlsql │ │ │ -001f68b0: 5f75 7064 6174 6522 3e3c 7469 746c 653e _update"><title> │ │ │ -001f68c0: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ -001f68d0: 0a20 2020 203c 6578 616d 706c 6520 6964 . </tit │ │ │ -001f6900: 6c65 3e0a 2020 2020 3c2f 6578 616d 706c le>. </exampl │ │ │ -001f6910: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ -001f6920: 0a2d 2d3e 0a20 203c 7265 6673 6563 7431 .-->. <refsect1 │ │ │ -001f6930: 2069 643d 2273 6565 616c 736f 5f78 6d6c id="seealso_xml │ │ │ -001f6940: 7371 6c5f 7570 6461 7465 223e 3c74 6974 sql_update"><tit │ │ │ -001f6950: 6c65 3e53 6565 2041 6c73 6f3c 2f74 6974 le>See Also</tit │ │ │ -001f6960: 6c65 3e0a 2020 2020 3c70 6172 613e 3c6c le>. <para><l │ │ │ -001f6970: 696e 6b20 6c69 6e6b 656e 643d 2275 7064 ink linkend="upd │ │ │ -001f6980: 6174 6567 7261 6d73 223e 5570 6461 7465 ategrams">Update │ │ │ -001f6990: 6772 616d 7320 6261 7369 6373 3c2f 6c69 grams basics</li │ │ │ -001f69a0: 6e6b 3e3c 2f70 6172 613e 0a20 203c 2f72 nk></para>. </r │ │ │ -001f69b0: 6566 7365 6374 313e 0a3c 2f72 6566 656e efsect1>.</refen │ │ │ -001f69c0: 7472 793e 0a0a 0ab6 0000 0027 6465 6d6f try>.......'demo │ │ │ -001f69d0: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -001f69e0: 786d 6c5f 7669 6577 5f73 6368 656d 612e xml_view_schema. │ │ │ -001f69f0: 786d 6cdf 0000 1aed 3c3f 786d 6c20 7665 xml.....<?xml ve │ │ │ -001f6a00: 7273 696f 6e3d 2231 2e30 2220 656e 636f rsion="1.0" enco │ │ │ -001f6a10: 6469 6e67 3d22 4953 4f2d 3838 3539 2d31 ding="ISO-8859-1 │ │ │ -001f6a20: 223f 3e0a 3c21 2d2d 200a 202d 2020 0a20 "?>.<!-- . - . │ │ │ -001f6a30: 2d20 2054 6869 7320 6669 6c65 2069 7320 - This file is │ │ │ -001f6a40: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ -001f6a50: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ -001f6a60: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ -001f6a70: 6365 2028 564f 5329 0a20 2d20 2070 726f ce (VOS). - pro │ │ │ -001f6a80: 6a65 6374 2e0a 202d 2020 0a20 2d20 2043 ject.. - . - C │ │ │ -001f6a90: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ -001f6aa0: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ -001f6ab0: 536f 6674 7761 7265 0a20 2d20 200a 202d Software. - . - │ │ │ -001f6ac0: 2020 5468 6973 2070 726f 6a65 6374 2069 This project i │ │ │ -001f6ad0: 7320 6672 6565 2073 6f66 7477 6172 653b s free software; │ │ │ -001f6ae0: 2079 6f75 2063 616e 2072 6564 6973 7472 you can redistr │ │ │ -001f6af0: 6962 7574 6520 6974 2061 6e64 2f6f 7220 ibute it and/or │ │ │ -001f6b00: 6d6f 6469 6679 2069 740a 202d 2020 756e modify it. - un │ │ │ -001f6b10: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ -001f6b20: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ -001f6b30: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ -001f6b40: 6173 2070 7562 6c69 7368 6564 2062 7920 as published by │ │ │ -001f6b50: 7468 650a 202d 2020 4672 6565 2053 6f66 the. - Free Sof │ │ │ -001f6b60: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -001f6b70: 3b20 6f6e 6c79 2076 6572 7369 6f6e 2032 ; only version 2 │ │ │ -001f6b80: 206f 6620 7468 6520 4c69 6365 6e73 652c of the License, │ │ │ -001f6b90: 2064 6174 6564 204a 756e 6520 3139 3931 dated June 1991 │ │ │ -001f6ba0: 2e0a 202d 2020 0a20 2d20 2054 6869 7320 .. - . - This │ │ │ -001f6bb0: 7072 6f67 7261 6d20 6973 2064 6973 7472 program is distr │ │ │ -001f6bc0: 6962 7574 6564 2069 6e20 7468 6520 686f ibuted in the ho │ │ │ -001f6bd0: 7065 2074 6861 7420 6974 2077 696c 6c20 pe that it will │ │ │ -001f6be0: 6265 2075 7365 6675 6c2c 2062 7574 0a20 be useful, but. │ │ │ -001f6bf0: 2d20 2057 4954 484f 5554 2041 4e59 2057 - WITHOUT ANY W │ │ │ -001f6c00: 4152 5241 4e54 593b 2077 6974 686f 7574 ARRANTY; without │ │ │ -001f6c10: 2065 7665 6e20 7468 6520 696d 706c 6965 even the implie │ │ │ -001f6c20: 6420 7761 7272 616e 7479 206f 660a 202d d warranty of. - │ │ │ -001f6c30: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ -001f6c40: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ -001f6c50: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ -001f6c60: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ -001f6c70: 4e55 0a20 2d20 2047 656e 6572 616c 2050 NU. - General P │ │ │ -001f6c80: 7562 6c69 6320 4c69 6365 6e73 6520 666f ublic License fo │ │ │ -001f6c90: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ -001f6ca0: 202d 2020 0a20 2d20 2059 6f75 2073 686f - . - You sho │ │ │ -001f6cb0: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ -001f6cc0: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ -001f6cd0: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -001f6ce0: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ -001f6cf0: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ -001f6d00: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ -001f6d10: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ -001f6d20: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ -001f6d30: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ -001f6d40: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ -001f6d50: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ -001f6d60: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ -001f6d70: 3330 3120 5553 410a 202d 2020 0a20 2d20 301 USA. - . - │ │ │ -001f6d80: 200a 2d2d 3e0a 3c72 6566 656e 7472 7920 .-->.<refentry │ │ │ -001f6d90: 6964 3d22 666e 5f78 6d6c 5f76 6965 775f id="fn_xml_view_ │ │ │ -001f6da0: 7363 6865 6d61 223e 0a20 203c 7265 666d schema">. <refm │ │ │ -001f6db0: 6574 613e 0a20 2020 203c 7265 6665 6e74 eta>. <refent │ │ │ -001f6dc0: 7279 7469 746c 653e 786d 6c5f 7669 6577 rytitle>xml_view │ │ │ -001f6dd0: 5f73 6368 656d 613c 2f72 6566 656e 7472 _schema</refentr │ │ │ -001f6de0: 7974 6974 6c65 3e0a 2020 2020 3c72 6566 ytitle>. <ref │ │ │ -001f6df0: 6d69 7363 696e 666f 3e78 6d6c 3c2f 7265 miscinfo>xml</re │ │ │ -001f6e00: 666d 6973 6369 6e66 6f3e 0a20 203c 2f72 fmiscinfo>. </r │ │ │ -001f6e10: 6566 6d65 7461 3e0a 2020 3c72 6566 6e61 efmeta>. <refna │ │ │ -001f6e20: 6d65 6469 763e 0a20 2020 203c 7265 666e mediv>. <refn │ │ │ -001f6e30: 616d 653e 786d 6c5f 7669 6577 5f73 6368 ame>xml_view_sch │ │ │ -001f6e40: 656d 613c 2f72 6566 6e61 6d65 3e0a 2020 ema</refname>. │ │ │ -001f6e50: 2020 3c72 6566 7075 7270 6f73 653e 7265 <refpurpose>re │ │ │ -001f6e60: 7475 726e 7320 616e 2058 4d4c 2073 6368 turns an XML sch │ │ │ -001f6e70: 656d 6120 666f 7220 7468 6520 6f75 7470 ema for the outp │ │ │ -001f6e80: 7574 206f 6620 6769 7665 6e20 584d 4c20 ut of given XML │ │ │ -001f6e90: 5649 4557 3c2f 7265 6670 7572 706f 7365 VIEW</refpurpose │ │ │ -001f6ea0: 3e0a 2020 3c2f 7265 666e 616d 6564 6976 >. </refnamediv │ │ │ -001f6eb0: 3e0a 2020 3c72 6566 7379 6e6f 7073 6973 >. <refsynopsis │ │ │ -001f6ec0: 6469 763e 0a20 2020 203c 6675 6e63 7379 div>. <funcsy │ │ │ -001f6ed0: 6e6f 7073 6973 2069 643d 2266 7379 6e5f nopsis id="fsyn_ │ │ │ -001f6ee0: 786d 6c5f 7669 6577 5f73 6368 656d 6122 xml_view_schema" │ │ │ -001f6ef0: 3e20 0a20 2020 2020 203c 6675 6e63 7072 > . <funcpr │ │ │ -001f6f00: 6f74 6f74 7970 6520 6964 3d22 6670 726f ototype id="fpro │ │ │ -001f6f10: 746f 5f78 6d6c 5f76 6965 775f 7363 6865 to_xml_view_sche │ │ │ -001f6f20: 6d61 223e 0a20 2020 2020 2020 203c 6675 ma">. <fu │ │ │ -001f6f30: 6e63 6465 663e 7661 7263 6861 7220 3c66 ncdef>varchar <f │ │ │ -001f6f40: 756e 6374 696f 6e3e 786d 6c5f 7669 6577 unction>xml_view │ │ │ -001f6f50: 5f73 6368 656d 613c 2f66 756e 6374 696f _schema</functio │ │ │ -001f6f60: 6e3e 3c2f 6675 6e63 6465 663e 0a20 2020 n></funcdef>. │ │ │ -001f6f70: 2020 2020 203c 7061 7261 6d64 6566 3e69 <paramdef>i │ │ │ -001f6f80: 6e20 3c70 6172 616d 6574 6572 3e71 7565 n <parameter>que │ │ │ -001f6f90: 7279 203c 2f70 6172 616d 6574 6572 3e76 ry </parameter>v │ │ │ -001f6fa0: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar</paramdef │ │ │ -001f6fb0: 3e0a 2020 2020 2020 2020 3c70 6172 616d >. <param │ │ │ -001f6fc0: 6465 663e 696e 203c 7061 7261 6d65 7465 def>in <paramete │ │ │ -001f6fd0: 723e 726f 6f74 5f65 6c65 6d65 6e74 203c r>root_element < │ │ │ -001f6fe0: 2f70 6172 616d 6574 6572 3e76 6172 6368 /parameter>varch │ │ │ -001f6ff0: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar</paramdef>. │ │ │ -001f7000: 2020 2020 3c2f 6675 6e63 7072 6f74 6f74 </funcprotot │ │ │ -001f7010: 7970 653e 0a20 2020 203c 2f66 756e 6373 ype>. </funcs │ │ │ -001f7020: 796e 6f70 7369 733e 0a20 203c 2f72 6566 ynopsis>. </ref │ │ │ -001f7030: 7379 6e6f 7073 6973 6469 763e 0a20 203c synopsisdiv>. < │ │ │ -001f7040: 7265 6673 6563 7431 2069 643d 2264 6573 refsect1 id="des │ │ │ -001f7050: 6322 3e3c 7469 746c 653e 4465 7363 7269 c"><title>Descri │ │ │ -001f7060: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -001f7070: 2020 3c70 6172 613e 0a54 6869 7320 6675 .This fu │ │ │ -001f7080: 6e63 7469 6f6e 2072 6574 7572 6e20 616e nction return an │ │ │ -001f7090: 2058 4d4c 2073 6368 656d 6120 666f 7220 XML schema for │ │ │ -001f70a0: 7468 6520 6f75 7470 7574 206f 6620 6769 the output of gi │ │ │ -001f70b0: 7665 6e20 584d 4c20 5649 4557 2e0a 5468 ven XML VIEW..Th │ │ │ -001f70c0: 6520 7265 7475 726e 6564 2073 6368 656d e returned schem │ │ │ -001f70d0: 6120 7769 6c6c 2062 6520 7661 6c69 6420 a will be valid │ │ │ -001f70e0: 6966 2074 6865 2048 5454 505f 2e2e 2e20 if the HTTP_... │ │ │ -001f70f0: 6f75 7470 7574 206f 6620 7669 6577 0a77 output of view.w │ │ │ -001f7100: 7261 7070 6564 2069 6e74 6f20 7468 6520 rapped into the │ │ │ -001f7110: 7370 6563 6966 6965 6420 726f 6f74 2065 specified root e │ │ │ -001f7120: 6c65 6d65 6e74 2e0a 3c2f 7061 7261 3e0a lement... │ │ │ -001f7130: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -001f7140: 3c72 6566 7365 6374 3120 6964 3d22 7061 Par │ │ │ -001f7160: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -001f7170: 2020 2020 3c72 6566 7365 6374 323e 3c74 query. a │ │ │ -001f71a0: 2073 7472 696e 6720 7768 6963 6820 636f string which co │ │ │ -001f71b0: 6e74 6169 6e73 2061 206e 616d 6520 6f66 ntains a name of │ │ │ -001f71c0: 2058 4d4c 2076 6965 7720 3c2f 7061 7261 XML view . │ │ │ -001f71e0: 203c 7265 6673 6563 7432 3e3c 7469 746c root_element < │ │ │ -001f7200: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    a string con │ │ │ -001f7220: 7461 696e 696e 6720 7468 6520 656c 656d taining the elem │ │ │ -001f7230: 656e 7420 6e61 6d65 2069 6e20 7768 6963 ent name in whic │ │ │ -001f7240: 6820 7468 6520 584d 4c20 7363 6865 6d61 h the XML schema │ │ │ -001f7250: 2077 6f75 6c64 2062 6520 7772 6170 7065 would be wrappe │ │ │ -001f7260: 6420 3c2f 7061 7261 3e3c 2f72 6566 7365 d . . R │ │ │ -001f72a0: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ -001f72b0: 6c65 3e3c 7061 7261 3e58 4d4c 2053 6368 le><para>XML Sch │ │ │ -001f72c0: 656d 613c 2f70 6172 613e 3c2f 7265 6673 ema</para></refs │ │ │ -001f72d0: 6563 7431 3e0a 0a20 203c 7265 6673 6563 ect1>.. <refsec │ │ │ -001f72e0: 7431 2069 643d 2265 7272 6f72 735f 786d t1 id="errors_xm │ │ │ -001f72f0: 6c5f 7669 6577 5f73 6368 656d 6122 3e3c l_view_schema">< │ │ │ -001f7300: 7469 746c 653e 4572 726f 7273 3c2f 7469 title>Errors</ti │ │ │ -001f7310: 746c 653e 0a20 2020 203c 7461 626c 653e tle>. <table> │ │ │ -001f7320: 3c74 6974 6c65 3e45 7272 6f72 7320 7369 <title>Errors si │ │ │ -001f7330: 676e 616c 6c65 6420 6279 3c2f 7469 746c gnalled by</titl │ │ │ -001f7340: 653e 0a20 2020 2020 203c 7467 726f 7570 e>. <tgroup │ │ │ -001f7350: 2063 6f6c 733d 2234 223e 0a20 2020 2020 cols="4">. │ │ │ -001f7360: 2020 3c74 6865 6164 3e3c 726f 773e 3c65 <thead><row><e │ │ │ -001f7370: 6e74 7279 3e53 514c 5374 6174 653c 2f65 ntry>SQLState</e │ │ │ -001f7380: 6e74 7279 3e3c 656e 7472 793e 4572 726f ntry><entry>Erro │ │ │ -001f7390: 7220 436f 6465 3c2f 656e 7472 793e 3c65 r Code</entry><e │ │ │ -001f73a0: 6e74 7279 3e45 7272 6f72 2054 6578 743c ntry>Error Text< │ │ │ -001f73b0: 2f65 6e74 7279 3e3c 656e 7472 793e 4465 /entry><entry>De │ │ │ -001f73c0: 7363 7269 7074 696f 6e3c 2f65 6e74 7279 scription</entry │ │ │ -001f73d0: 3e3c 2f72 6f77 3e3c 2f74 6865 6164 3e0a ></row></thead>. │ │ │ -001f73e0: 093c 7462 6f64 793e 0a09 2020 3c72 6f77 .<tbody>.. <row │ │ │ -001f73f0: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ -001f7400: 7272 6f72 636f 6465 3e34 3230 3030 3c2f rrorcode>42000</ │ │ │ -001f7410: 6572 726f 7263 6f64 653e 3c2f 656e 7472 errorcode></entr │ │ │ -001f7420: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -001f7430: 6572 726f 7263 6f64 653e 3c2f 6572 726f errorcode></erro │ │ │ -001f7440: 7263 6f64 653e 3c2f 656e 7472 793e 0a09 rcode></entry>.. │ │ │ -001f7450: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ -001f7460: 726e 616d 653e 4e6f 2058 4d4c 2076 6965 rname>No XML vie │ │ │ -001f7470: 7720 5b76 6965 775f 6e61 6d65 5d3c 2f65 w [view_name]</e │ │ │ -001f7480: 7272 6f72 6e61 6d65 3e3c 2f65 6e74 7279 rrorname></entry │ │ │ -001f7490: 3e0a 0920 2020 203c 656e 7472 793e 3c2f >.. <entry></ │ │ │ -001f74a0: 656e 7472 793e 0a09 2020 3c2f 726f 773e entry>.. </row> │ │ │ -001f74b0: 0a09 3c2f 7462 6f64 793e 0a20 2020 2020 ..</tbody>. │ │ │ -001f74c0: 203c 2f74 6772 6f75 703e 0a20 2020 203c </tgroup>. < │ │ │ -001f74d0: 2f74 6162 6c65 3e0a 2020 3c2f 7265 6673 /table>. </refs │ │ │ -001f74e0: 6563 7431 3e0a 0a20 203c 7265 6673 6563 ect1>.. <refsec │ │ │ -001f74f0: 7431 2069 643d 2265 7861 6d70 6c65 7322 t1 id="examples" │ │ │ -001f7500: 3e3c 7469 746c 653e 4578 616d 706c 6573 ><title>Examples │ │ │ -001f7510: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Creating an │ │ │ -001f7550: 2058 4d4c 2053 6368 656d 613c 2f74 6974 XML Schema.....SQL> │ │ │ -001f7e40: 7365 6c65 6374 2078 6d6c 5f76 6965 775f select xml_view_ │ │ │ -001f7e50: 7363 6865 6d61 2028 2763 6174 272c 2027 schema ('cat', ' │ │ │ -001f7e60: 726f 6f74 2729 3b0a 6361 6c6c 7265 740a root');.callret. │ │ │ -001f7e70: 5641 5243 4841 520a 5f5f 5f5f 5f5f 5f5f VARCHAR.________ │ │ │ -001f7e80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f7e90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f7ea0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f7eb0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001f7ec0: 5f5f 5f5f 5f5f 5f0a 200a 266c 743b 7873 _______. .<xs │ │ │ -001f7ed0: 643a 7363 6865 6d61 2078 6d6c 6e73 3a78 d:schema xmlns:x │ │ │ -001f7ee0: 7364 3d26 7175 6f74 3b68 7474 703a 2f2f sd="http:// │ │ │ -001f7ef0: 7777 772e 7733 2e6f 7267 2f32 3030 312f www.w3.org/2001/ │ │ │ -001f7f00: 584d 4c53 6368 656d 6126 7175 6f74 3b26 XMLSchema"& │ │ │ -001f7f10: 6774 3b0a 200a 2026 6c74 3b78 7364 3a61 gt;. . <xsd:a │ │ │ -001f7f20: 6e6e 6f74 6174 696f 6e26 6774 3b0a 2020 nnotation>. │ │ │ -001f7f30: 266c 743b 7873 643a 646f 6375 6d65 6e74 <xsd:document │ │ │ -001f7f40: 6174 696f 6e26 6774 3b0a 2020 2020 5363 ation>. Sc │ │ │ -001f7f50: 6865 6d61 206f 6620 584d 4c20 7669 6577 hema of XML view │ │ │ -001f7f60: 2027 6361 7427 0a20 2026 6c74 3b2f 7873 'cat'. </xs │ │ │ -001f7f70: 643a 646f 6375 6d65 6e74 6174 696f 6e26 d:documentation& │ │ │ -001f7f80: 6774 3b0a 2026 6c74 3b2f 7873 643a 616e gt;. </xsd:an │ │ │ -001f7f90: 6e6f 7461 7469 6f6e 2667 743b 0a20 0a20 notation>. . │ │ │ -001f7fa0: 266c 743b 7873 643a 656c 656d 656e 7420 <xsd:element │ │ │ -001f7fb0: 6e61 6d65 3d26 7175 6f74 3b72 6f6f 7426 name="root& │ │ │ -001f7fc0: 7175 6f74 3b20 7479 7065 3d26 7175 6f74 quot; type=" │ │ │ -001f7fd0: 3b72 6f6f 745f 5f54 7970 6526 7175 6f74 ;root__Type" │ │ │ -001f7fe0: 3b2f 2667 743b 0a20 0a20 266c 743b 7873 ;/>. . <xs │ │ │ -001f7ff0: 643a 636f 6d70 6c65 7854 7970 6520 6e61 d:complexType na │ │ │ -001f8000: 6d65 3d26 7175 6f74 3b72 6f6f 745f 5f54 me="root__T │ │ │ -001f8010: 7970 6526 7175 6f74 3b26 6774 3b0a 2020 ype">. │ │ │ -001f8020: 266c 743b 7873 643a 656c 656d 656e 7420 <xsd:element │ │ │ -001f8030: 6e61 6d65 3d26 7175 6f74 3b63 6174 6567 name="categ │ │ │ -001f8040: 6f72 7926 7175 6f74 3b20 7479 7065 3d26 ory" type=& │ │ │ -001f8050: 7175 6f74 3b72 6f6f 745f 6361 7465 676f quot;root_catego │ │ │ -001f8060: 7279 5f54 7970 6526 7175 6f74 3b20 6d69 ry_Type" mi │ │ │ -001f8070: 6e4f 6363 7572 733d 2671 756f 743b 3026 nOccurs="0& │ │ │ -001f8080: 7175 6f74 3b20 6d61 784f 6363 7572 733d quot; maxOccurs= │ │ │ -001f8090: 2671 756f 743b 756e 626f 756e 6465 6426 "unbounded& │ │ │ -001f80a0: 7175 6f74 3b2f 2667 743b 0a20 266c 743b quot;/>. < │ │ │ -001f80b0: 2f78 7364 3a63 6f6d 706c 6578 5479 7065 /xsd:complexType │ │ │ -001f80c0: 2667 743b 0a20 0a20 266c 743b 7873 643a >. . <xsd: │ │ │ -001f80d0: 636f 6d70 6c65 7854 7970 6520 6e61 6d65 complexType name │ │ │ -001f80e0: 3d26 7175 6f74 3b72 6f6f 745f 6361 7465 ="root_cate │ │ │ -001f80f0: 676f 7279 5f54 7970 6526 7175 6f74 3b26 gory_Type"& │ │ │ -001f8100: 6774 3b0a 2020 266c 743b 7873 643a 6174 gt;. <xsd:at │ │ │ -001f8110: 7472 6962 7574 6520 6e61 6d65 3d26 7175 tribute name=&qu │ │ │ -001f8120: 6f74 3b43 6174 6567 6f72 7949 4426 7175 ot;CategoryID&qu │ │ │ -001f8130: 6f74 3b20 7479 7065 3d26 7175 6f74 3b78 ot; type="x │ │ │ -001f8140: 7364 3a73 7472 696e 6726 7175 6f74 3b2f sd:string"/ │ │ │ -001f8150: 2667 743b 2020 0a26 6c74 3b21 2d2d 2026 > .<!-- & │ │ │ -001f8160: 6c74 3b78 7364 3a61 7474 7269 6275 7465 lt;xsd:attribute │ │ │ -001f8170: 206e 616d 653d 2671 756f 743b 4361 7465 name="Cate │ │ │ -001f8180: 676f 7279 4944 2671 756f 743b 2074 7970 goryID" typ │ │ │ -001f8190: 653d 2671 756f 743b 7873 643a 696e 7426 e="xsd:int& │ │ │ -001f81a0: 7175 6f74 3b2f 2667 743b 202d 2d26 6774 quot;/> --> │ │ │ -001f81b0: 3b0a 2020 266c 743b 7873 643a 6174 7472 ;. <xsd:attr │ │ │ -001f81c0: 6962 7574 6520 6e61 6d65 3d26 7175 6f74 ibute name=" │ │ │ -001f81d0: 3b64 6573 6372 6970 7469 6f6e 2671 756f ;description&quo │ │ │ -001f81e0: 743b 2074 7970 653d 2671 756f 743b 7873 t; type="xs │ │ │ -001f81f0: 643a 7374 7269 6e67 2671 756f 743b 2f26 d:string"/& │ │ │ -001f8200: 6774 3b0a 2020 266c 743b 7873 643a 656c gt;. <xsd:el │ │ │ -001f8210: 656d 656e 7420 6e61 6d65 3d26 7175 6f74 ement name=" │ │ │ -001f8220: 3b70 726f 6475 6374 2671 756f 743b 2074 ;product" t │ │ │ -001f8230: 7970 653d 2671 756f 743b 6361 7465 676f ype="catego │ │ │ -001f8240: 7279 5f70 726f 6475 6374 5f54 7970 6526 ry_product_Type& │ │ │ -001f8250: 7175 6f74 3b20 6d69 6e4f 6363 7572 733d quot; minOccurs= │ │ │ -001f8260: 2671 756f 743b 3026 7175 6f74 3b20 6d61 "0" ma │ │ │ -001f8270: 784f 6363 7572 733d 2671 756f 743b 756e xOccurs="un │ │ │ -001f8280: 626f 756e 6465 6426 7175 6f74 3b2f 2667 bounded"/&g │ │ │ -001f8290: 743b 0a20 266c 743b 2f78 7364 3a63 6f6d t;. </xsd:com │ │ │ -001f82a0: 706c 6578 5479 7065 2667 743b 0a20 0a20 plexType>. . │ │ │ -001f82b0: 266c 743b 7873 643a 636f 6d70 6c65 7854 <xsd:complexT │ │ │ -001f82c0: 7970 6520 6e61 6d65 3d26 7175 6f74 3b63 ype name="c │ │ │ -001f82d0: 6174 6567 6f72 795f 7072 6f64 7563 745f ategory_product_ │ │ │ -001f82e0: 5479 7065 2671 756f 743b 2667 743b 0a20 Type">. │ │ │ -001f82f0: 2026 6c74 3b78 7364 3a61 7474 7269 6275 <xsd:attribu │ │ │ -001f8300: 7465 206e 616d 653d 2671 756f 743b 5072 te name="Pr │ │ │ -001f8310: 6f64 7563 744e 616d 6526 7175 6f74 3b20 oductName" │ │ │ -001f8320: 7479 7065 3d26 7175 6f74 3b78 7364 3a73 type="xsd:s │ │ │ -001f8330: 7472 696e 6726 7175 6f74 3b2f 2667 743b tring"/> │ │ │ -001f8340: 0a20 266c 743b 2f78 7364 3a63 6f6d 706c . </xsd:compl │ │ │ -001f8350: 6578 5479 7065 2667 743b 0a26 6c74 3b2f exType>.</ │ │ │ -001f8360: 7873 643a 7363 6865 6d61 2667 743b 0a20 xsd:schema>. │ │ │ -001f8370: 0a31 2052 6f77 732e 202d 2d20 3920 6d73 .1 Rows. -- 9 ms │ │ │ -001f8380: 6563 2e20 2020 2020 0a3c 2f70 726f 6772 ec. ... │ │ │ -001f83a0: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . See Als │ │ │ -001f83e0: 6f3c 2f74 6974 6c65 3e0a 2020 2020 3c70 o.

    xml_view_dtd │ │ │ -001f8420: 2829 3c2f 6c69 6e6b 3e3c 2f70 6172 613e () │ │ │ -001f8430: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . x │ │ │ -001f8460: 6d6c 5f76 616c 6964 6174 655f 6474 6428 ml_validate_dtd( │ │ │ -001f8470: 293c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ). │ │ │ -001f8480: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xml_ │ │ │ -001f84b0: 7065 7273 6973 7465 6e74 2829 3c2f 6c69 persistent()

  • .
    ......$demo/d │ │ │ -001f84f0: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ -001f8500: 6c5f 7669 6577 5f64 7464 2e78 6d6c df00 l_view_dtd.xml.. │ │ │ -001f8510: 000c 9b3c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -001f8540: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ -001f8550: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -001f8560: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -001f8570: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -001f8580: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -001f8590: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -001f85a0: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ -001f85b0: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -001f85c0: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -001f85d0: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ -001f85e0: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ -001f85f0: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ -001f8600: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ -001f8610: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ -001f8620: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ -001f8630: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -001f8640: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -001f8650: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -001f8660: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ -001f8670: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ -001f8680: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ -001f8690: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ -001f86a0: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ -001f86b0: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ -001f86c0: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ -001f86d0: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ -001f86e0: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ -001f86f0: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ -001f8700: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ -001f8710: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ -001f8720: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ -001f8730: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ -001f8740: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ -001f8750: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -001f8760: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -001f8770: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -001f8780: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ -001f8790: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -001f87a0: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ -001f87b0: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ -001f87c0: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ -001f87d0: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -001f87e0: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -001f87f0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -001f8800: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ -001f8810: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ -001f8820: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ -001f8830: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ -001f8840: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ -001f8850: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ -001f8860: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ -001f8870: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ -001f8880: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ -001f8890: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ -001f88a0: 3c72 6566 656e 7472 7920 6964 3d22 666e . │ │ │ -001f88c0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ -001f88d0: 3c72 6566 656e 7472 7974 6974 6c65 3e78 x │ │ │ -001f88e0: 6d6c 5f76 6965 775f 6474 643c 2f72 6566 ml_view_dtd. │ │ │ -001f8900: 3c72 6566 6d69 7363 696e 666f 3e78 6d6c xml │ │ │ -001f8910: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -001f8920: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72 . . < │ │ │ -001f8940: 7265 666e 616d 653e 786d 6c5f 7669 6577 refname>xml_view │ │ │ -001f8950: 5f64 7464 3c2f 7265 666e 616d 653e 0a20 _dtd. │ │ │ -001f8960: 2020 203c 7265 6670 7572 706f 7365 3e72 r │ │ │ -001f8970: 6574 7572 6e73 2061 6e20 584d 4c20 4454 eturns an XML DT │ │ │ -001f8980: 4420 666f 7220 7468 6520 6f75 7470 7574 D for the output │ │ │ -001f8990: 206f 6620 6769 7665 6e20 584d 4c20 5649 of given XML VI │ │ │ -001f89a0: 4557 3c2f 7265 6670 7572 706f 7365 3e0a EW. │ │ │ -001f89b0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -001f89c0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . │ │ │ -001f8a00: 2020 203c 6675 6e63 7072 6f74 6f74 7970 . │ │ │ -001f8a30: 2020 2020 3c66 756e 6364 6566 3e76 6172 var │ │ │ -001f8a40: 6368 6172 203c 6675 6e63 7469 6f6e 3e78 char x │ │ │ -001f8a50: 6d6c 5f76 6965 775f 6474 643c 2f66 756e ml_view_dtd │ │ │ -001f8a70: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in view_namevarchar

    . │ │ │ -001f8ac0: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    root_el │ │ │ -001f8ae0: 656d 656e 743c 2f70 6172 616d 6574 6572 ementvarchar. . < │ │ │ -001f8b20: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ -001f8b30: 203c 2f72 6566 7379 6e6f 7073 6973 6469 . │ │ │ -001f8b60: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -001f8b70: 6c65 3e0a 2020 2020 3c70 6172 613e 0a54 le>. <para>.T │ │ │ -001f8b80: 6869 7320 6675 6e63 7469 6f6e 2077 696c his function wil │ │ │ -001f8b90: 6c20 7265 7475 726e 2061 6e20 584d 4c20 l return an XML │ │ │ -001f8ba0: 4454 4420 666f 7220 7468 6520 6f75 7470 DTD for the outp │ │ │ -001f8bb0: 7574 206f 6620 6120 6769 7665 6e20 584d ut of a given XM │ │ │ -001f8bc0: 4c20 5649 4557 2e0a 5468 6520 7265 7475 L VIEW..The retu │ │ │ -001f8bd0: 726e 6564 2044 5444 2077 696c 6c20 6265 rned DTD will be │ │ │ -001f8be0: 2076 616c 6964 2069 6620 7468 6520 4854 valid if the HT │ │ │ -001f8bf0: 5450 5f2e 2e2e 206f 7574 7075 7420 6f66 TP_... output of │ │ │ -001f8c00: 2074 6865 2076 6965 7720 6973 0a77 7261 the view is.wra │ │ │ -001f8c10: 7070 6564 2069 6e74 6f20 7468 6520 7370 pped into the sp │ │ │ -001f8c20: 6563 6966 6965 6420 726f 6f74 2065 6c65 ecified root ele │ │ │ -001f8c30: 6d65 6e74 2e0a 3c2f 7061 7261 3e0a 2020 ment..</para>. │ │ │ -001f8c40: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ -001f8c50: 6566 7365 6374 3120 6964 3d22 7061 7261 efsect1 id="para │ │ │ -001f8c60: 6d73 223e 3c74 6974 6c65 3e50 6172 616d ms"><title>Param │ │ │ -001f8c70: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -001f8c80: 2020 3c72 6566 7365 6374 323e 3c74 6974 view_name. Name of an XML │ │ │ -001f8cc0: 5669 6577 2e3c 2f70 6172 613e 3c2f 7265 View.. roo │ │ │ -001f8cf0: 745f 656c 656d 656e 743c 2f74 6974 6c65 t_element. Na │ │ │ -001f8d10: 6d65 206f 6620 7468 6520 726f 6f74 2065 me of the root e │ │ │ -001f8d20: 6c65 6d65 6e74 2e3c 2f70 6172 613e 3c2f lement.. . Return Types │ │ │ -001f8d70: 3c2f 7469 746c 653e 3c70 6172 613e 584d XM │ │ │ -001f8d80: 4c20 4454 4420 666f 7220 7468 6520 6769 L DTD for the gi │ │ │ -001f8d90: 7665 6e20 584d 4c20 5649 4557 3c2f 7061 ven XML VIEW.< │ │ │ -001f8db0: 212d 2d0a 2020 3c72 6566 7365 6374 3120 !--. Errors. Errors signa │ │ │ -001f8e00: 6c6c 6564 2062 793c 2f74 6974 6c65 3e0a lled by. │ │ │ -001f8e10: 2020 2020 2020 3c74 6772 6f75 7020 636f . < │ │ │ -001f8e30: 7468 6561 643e 3c72 6f77 3e3c 656e 7472 thead>SQLStateError C │ │ │ -001f8e60: 6f64 653c 2f65 6e74 7279 3e3c 656e 7472 odeError TextDescr │ │ │ -001f8e90: 6970 7469 6f6e 3c2f 656e 7472 793e 3c2f iption.... .. │ │ │ -001f8ec0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f .. │ │ │ -001f8ef0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 .. .. < │ │ │ -001f8f50: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. ... │ │ │ -001f8f70: 2020 3c2f 7467 726f 7570 3e0a 2020 2020 . │ │ │ -001f8f80: 3c2f 7461 626c 653e 0a20 203c 2f72 6566
    . . Examples │ │ │ -001f8fc0: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . < │ │ │ -001f8fe0: 7469 746c 653e 3c2f 7469 746c 653e 0a20 title>. │ │ │ -001f8ff0: 2020 2020 203c 7061 7261 3e3c 2f70 6172 . . < │ │ │ -001f9020: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. .-->. See │ │ │ -001f9060: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ -001f9070: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xml_view_sch │ │ │ -001f90b0: 656d 6128 293c 2f66 756e 6374 696f 6e3e ema() │ │ │ -001f90c0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -001f90d0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_valid │ │ │ -001f9110: 6174 655f 6474 6428 293c 2f66 756e 6374 ate_dtd().

  • < │ │ │ -001f9160: 6675 6e63 7469 6f6e 3e78 6d6c 5f70 6572 function>xml_per │ │ │ -001f9170: 7369 7374 656e 7428 293c 2f66 756e 6374 sistent(). │ │ │ -001f91a0: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 ..... │ │ │ -001f91b0: 0000 2b64 656d 6f2f 646f 6373 7263 2f66 ..+demo/docsrc/f │ │ │ -001f91c0: 756e 6372 6566 2f78 6d6c 5f76 616c 6964 uncref/xml_valid │ │ │ -001f91d0: 6174 655f 7363 6865 6d61 2e78 6d6c df00 ate_schema.xml.. │ │ │ -001f91e0: 0017 003c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -001f9210: 212d 2d20 0a20 2d20 200a 202d 2020 5468 !-- . - . - Th │ │ │ -001f9220: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ -001f9230: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ -001f9240: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ -001f9250: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ -001f9260: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ -001f9270: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ -001f9280: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ -001f9290: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ -001f92a0: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ -001f92b0: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ -001f92c0: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ -001f92d0: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ -001f92e0: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ -001f92f0: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ -001f9300: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ -001f9310: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -001f9320: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ -001f9330: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ -001f9340: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ -001f9350: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ -001f9360: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ -001f9370: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ -001f9380: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ -001f9390: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ -001f93a0: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ -001f93b0: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ -001f93c0: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ -001f93d0: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ -001f93e0: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ -001f93f0: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ -001f9400: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ -001f9410: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ -001f9420: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ -001f9430: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ -001f9440: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ -001f9450: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ -001f9460: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ -001f9470: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ -001f9480: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ -001f9490: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ -001f94a0: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ -001f94b0: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ -001f94c0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -001f94d0: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ -001f94e0: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ -001f94f0: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ -001f9500: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ -001f9510: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -001f9520: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ -001f9530: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ -001f9540: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ -001f9550: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ -001f9560: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ -001f9570: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . xml_valid │ │ │ -001f95c0: 6174 655f 7363 6865 6d61 3c2f 7265 6665 ate_schema. < │ │ │ -001f95e0: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ -001f95f0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001f9600: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . xml_valid │ │ │ -001f9630: 6174 655f 7363 6865 6d61 3c2f 7265 666e ate_schema. returns a s │ │ │ -001f9660: 7472 696e 6720 7769 7468 206c 6973 7420 tring with list │ │ │ -001f9670: 6f66 2065 7272 6f72 7320 6465 7465 6374 of errors detect │ │ │ -001f9680: 6564 2062 7920 4454 4420 616e 6420 584d ed by DTD and XM │ │ │ -001f9690: 4c20 0a20 2020 2053 6368 656d 6120 7661 L . Schema va │ │ │ -001f96a0: 6c69 6461 746f 7220 6f6e 2072 6561 6469 lidator on readi │ │ │ -001f96b0: 6e67 2067 6976 656e 2058 4d4c 2064 6f63 ng given XML doc │ │ │ -001f96c0: 756d 656e 742e 3c2f 7265 6670 7572 706f ument.. . . . < │ │ │ -001f9730: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -001f9740: 3d22 6670 726f 746f 5f78 6d6c 5f76 616c ="fproto_xml_val │ │ │ -001f9750: 6964 6174 655f 7363 6865 6d61 223e 0a20 idate_schema">. │ │ │ -001f9760: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ -001f9770: 3c66 756e 6374 696f 6e3e 786d 6c5f 7661 xml_va │ │ │ -001f9780: 6c69 6461 7465 5f73 6368 656d 613c 2f66 lidate_schema. in document varchar< │ │ │ -001f97e0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -001f97f0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -001f9800: 3c70 6172 616d 6574 6572 3e70 6172 7365 parse │ │ │ -001f9810: 725f 6d6f 6465 3c2f 7061 7261 6d65 7465 r_mode integer.

    in base_uri varch │ │ │ -001f9870: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -001f9880: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001f9890: 696e 203c 7061 7261 6d65 7465 723e 636f in co │ │ │ -001f98a0: 6e74 656e 745f 656e 636f 6469 6e67 3c2f ntent_encoding varch │ │ │ -001f98c0: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -001f98d0: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001f98e0: 696e 203c 7061 7261 6d65 7465 723e 636f in co │ │ │ -001f98f0: 6e74 656e 745f 6c61 6e67 7561 6765 3c2f ntent_language varch │ │ │ -001f9910: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -001f9920: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -001f9930: 696e 203c 7061 7261 6d65 7465 723e 6474 in dt │ │ │ -001f9940: 645f 7661 6c69 6461 746f 725f 636f 6e66 d_validator_conf │ │ │ -001f9950: 6967 3c2f 7061 7261 6d65 7465 723e 2076 ig v │ │ │ -001f9960: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. . . < │ │ │ -001f99a0: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -001f99b0: 0a20 203c 7265 6673 6563 7431 2069 643d . De │ │ │ -001f99d0: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. .Thi │ │ │ -001f99f0: 7320 7061 7273 6573 2074 6865 2061 7267 s parses the arg │ │ │ -001f9a00: 756d 656e 742c 2077 6869 6368 2069 7320 ument, which is │ │ │ -001f9a10: 6578 7065 6374 6564 2074 6f20 6265 2061 expected to be a │ │ │ -001f9a20: 6e20 584d 4c20 0a66 7261 676d 656e 7420 n XML .fragment │ │ │ -001f9a30: 2870 6f73 7369 626c 7920 7769 7468 2073 (possibly with s │ │ │ -001f9a40: 796e 7461 7820 6572 726f 7273 2c20 7669 yntax errors, vi │ │ │ -001f9a50: 6f6c 6174 696f 6e73 206f 6620 7661 6c69 olations of vali │ │ │ -001f9a60: 6469 7479 2063 6f6e 6469 7469 6f6e 7320 dity conditions │ │ │ -001f9a70: 6574 632e 290a 616e 6420 7265 7475 726e etc.).and return │ │ │ -001f9a80: 7320 6120 6875 6d61 6e2d 7265 6164 6162 s a human-readab │ │ │ -001f9a90: 6c65 206c 6973 7420 6f66 2065 7272 6f72 le list of error │ │ │ -001f9aa0: 7320 6173 2061 2073 7472 696e 672e 0a49 s as a string..I │ │ │ -001f9ab0: 6620 7468 6572 6520 6973 2061 2022 7363 f there is a "sc │ │ │ -001f9ac0: 6865 6d61 4c6f 6361 7469 6f6e 2220 6174 hemaLocation" at │ │ │ -001f9ad0: 7472 6962 7574 6520 696e 2072 6f6f 7420 tribute in root │ │ │ -001f9ae0: 656c 656d 656e 742c 0a58 4d4c 2053 6368 element,.XML Sch │ │ │ -001f9af0: 656d 6120 6465 636c 6172 6174 696f 6e20 ema declaration │ │ │ -001f9b00: 7769 6c6c 2062 6520 6c6f 6164 6564 2061 will be loaded a │ │ │ -001f9b10: 6e64 2070 6172 7469 616c 0a73 6368 656d nd partial.schem │ │ │ -001f9b20: 6120 7661 6c69 6461 7469 6f6e 2077 696c a validation wil │ │ │ -001f9b30: 6c20 6265 2070 6572 666f 726d 6564 2e20 l be performed. │ │ │ -001f9b40: 2049 6620 7468 6973 2061 7474 7269 6275 If this attribu │ │ │ -001f9b50: 7465 2064 6f65 7320 6e6f 7420 6578 6973 te does not exis │ │ │ -001f9b60: 7420 616e 6420 0a74 6865 2056 616c 6964 t and .the Valid │ │ │ -001f9b70: 6174 696f 6e20 6f70 7469 6f6e 2062 656c ation option bel │ │ │ -001f9b80: 6f77 2069 7320 6e6f 7420 7365 7420 746f ow is not set to │ │ │ -001f9b90: 2044 4953 4142 4c45 442c 2074 6865 6e20 DISABLED, then │ │ │ -001f9ba0: 616e 2065 7272 6f72 2077 696c 6c20 6265 an error will be │ │ │ -001f9bb0: 200a 7265 7475 726e 6564 3a20 2827 4641 .returned: ('FA │ │ │ -001f9bc0: 5441 4c20 203a 2053 6368 656d 6120 6465 TAL : Schema de │ │ │ -001f9bd0: 636c 6172 6174 696f 6e20 6973 206e 6f74 claration is not │ │ │ -001f9be0: 206c 6f61 6465 6427 292e 3c2f 7061 7261 loaded').. .The │ │ │ -001f9c00: 2058 4d4c 2053 6368 656d 6120 7661 6c69 XML Schema vali │ │ │ -001f9c10: 6461 7469 6f6e 2072 6f75 7469 6e65 7320 dation routines │ │ │ -001f9c20: 6172 6520 7469 6768 746c 7920 636f 7570 are tightly coup │ │ │ -001f9c30: 6c65 6420 7769 7468 2044 5444 2076 616c led with DTD val │ │ │ -001f9c40: 6964 6174 6f72 2e0a 4966 2074 6865 2064 idator..If the d │ │ │ -001f9c50: 6f63 756d 656e 7420 636f 6e74 6169 6e73 ocument contains │ │ │ -001f9c60: 2062 6f74 6820 5363 6865 6d61 2061 6e64 both Schema and │ │ │ -001f9c70: 2044 5444 2069 6e66 6f72 6d61 7469 6f6e DTD information │ │ │ -001f9c80: 2074 6865 6e20 626f 7468 2076 616c 6964 then both valid │ │ │ -001f9c90: 6174 696f 6e73 2061 7265 0a6d 6164 6520 ations are.made │ │ │ -001f9ca0: 696e 2074 6865 2073 616d 6520 7469 6d65 in the same time │ │ │ -001f9cb0: 2069 6e20 6f72 6465 7220 746f 2070 726f in order to pro │ │ │ -001f9cc0: 7669 6465 2061 7320 6163 6375 7261 7465 vide as accurate │ │ │ -001f9cd0: 2064 6961 676e 6f73 7469 6373 2061 7320 diagnostics as │ │ │ -001f9ce0: 706f 7373 6962 6c65 2e0a 486f 7765 7665 possible..Howeve │ │ │ -001f9cf0: 722c 2069 7420 6973 2069 6d70 6f73 7369 r, it is impossi │ │ │ -001f9d00: 626c 6520 746f 2063 6865 636b 2077 6865 ble to check whe │ │ │ -001f9d10: 7468 6572 2074 6865 2064 6563 6c61 7265 ther the declare │ │ │ -001f9d20: 6420 4454 4420 6d61 7463 6865 7320 6f72 d DTD matches or │ │ │ -001f9d30: 2063 6f6e 7472 6164 6963 7473 2074 6f20 contradicts to │ │ │ -001f9d40: 7468 6520 6465 636c 6172 6564 2053 6368 the declared Sch │ │ │ -001f9d50: 656d 612c 0a73 6f20 7468 6520 7061 7273 ema,.so the pars │ │ │ -001f9d60: 6572 2070 6572 666f 726d 7320 7477 6f20 er performs two │ │ │ -001f9d70: 696e 6465 7065 6e64 656e 7420 7661 6c69 independent vali │ │ │ -001f9d80: 6461 7469 6f6e 7320 746f 2065 7665 7279 dations to every │ │ │ -001f9d90: 2069 7465 6d20 6f66 2073 6f75 7263 6520 item of source │ │ │ -001f9da0: 6461 7461 2e0a 452e 672e 2069 6620 4454 data..E.g. if DT │ │ │ -001f9db0: 4420 636f 6e74 7261 6469 6374 7320 746f D contradicts to │ │ │ -001f9dc0: 2074 6865 2073 6368 656d 6120 696e 2064 the schema in d │ │ │ -001f9dd0: 6573 6372 6970 7469 6f6e 206f 6620 736f escription of so │ │ │ -001f9de0: 6d65 2070 6172 7469 6375 6c61 7220 656c me particular el │ │ │ -001f9df0: 656d 656e 7420 616e 640a 6461 7461 2069 ement and.data i │ │ │ -001f9e00: 6e20 7468 6520 646f 6375 6d65 6e74 2064 n the document d │ │ │ -001f9e10: 6f65 7320 6e6f 7420 636f 6e74 6169 6e20 oes not contain │ │ │ -001f9e20: 7468 6973 2065 6c65 6d65 6e74 2074 6865 this element the │ │ │ -001f9e30: 6e20 6e6f 2065 7272 6f72 7320 6973 2072 n no errors is r │ │ │ -001f9e40: 6570 6f72 7465 643b 2062 7574 2069 660a eported; but if. │ │ │ -001f9e50: 7375 6e20 616e 2065 6c65 6d65 6e74 206f sun an element o │ │ │ -001f9e60: 6363 7572 7320 696e 2074 6865 2064 6f63 ccurs in the doc │ │ │ -001f9e70: 756d 656e 7420 7468 656e 2065 6974 6865 ument then eithe │ │ │ -001f9e80: 7220 4454 4420 7661 6c69 6461 746f 7220 r DTD validator │ │ │ -001f9e90: 6f72 2053 6368 656d 6120 7661 6c69 6461 or Schema valida │ │ │ -001f9ea0: 746f 7220 7769 6c6c 206c 6f67 2061 6e20 tor will log an │ │ │ -001f9eb0: 6572 726f 722e 0a20 2020 203c 2f70 6172 error.. . .. Parameters. docu │ │ │ -001f9f20: 6d65 6e74 3c2f 7469 746c 653e 0a20 2020 ment. │ │ │ -001f9f30: 2020 203c 7061 7261 3e58 4d4c 206f 7220 XML or │ │ │ -001f9f40: 4854 4d4c 2064 6f63 756d 656e 7420 746f HTML document to │ │ │ -001f9f50: 2063 6865 636b 3c2f 7061 7261 3e3c 2f72 check. pa │ │ │ -001f9f80: 7273 6572 5f6d 6f64 653c 2f74 6974 6c65 rser_mode. 0 │ │ │ -001f9fa0: 6f72 2031 3b20 3020 2d20 584d 4c20 7061 or 1; 0 - XML pa │ │ │ -001f9fb0: 7273 6572 206d 6f64 6520 3120 2d20 4854 rser mode 1 - HT │ │ │ -001f9fc0: 4d4c 2070 6172 7365 7220 6d6f 6465 3c2f ML parser mode │ │ │ -001f9fe0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -001f9ff0: 7469 746c 653e 6261 7365 5f75 7269 3c2f title>base_uri. in HTML parse │ │ │ -001fa020: 7220 6d6f 6465 2063 6861 6e67 6520 616c r mode change al │ │ │ -001fa030: 6c20 6162 736f 6c75 7465 2072 6566 6572 l absolute refer │ │ │ -001fa040: 656e 6365 7320 746f 2072 656c 6174 6976 ences to relativ │ │ │ -001fa050: 6520 6672 6f6d 2067 6976 656e 2062 6173 e from given bas │ │ │ -001fa060: 655f 7572 6920 2868 7474 703a 2f2f 266c e_uri (http://&l │ │ │ -001fa070: 743b 686f 7374 2667 743b 3a26 6c74 3b70 t;host>:<p │ │ │ -001fa080: 6f72 7426 6774 3b2f 266c 743b 7061 7468 ort>/<path │ │ │ -001fa090: 2667 743b 293c 2f70 6172 613e 3c2f 7265 >). con │ │ │ -001fa0c0: 7465 6e74 5f65 6e63 6f64 696e 673c 2f74 tent_encoding</t │ │ │ -001fa0d0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001fa0e0: 613e 7374 7269 6e67 2077 6974 6820 636f a>string with co │ │ │ -001fa0f0: 6e74 656e 7420 656e 636f 6469 6e67 2074 ntent encoding t │ │ │ -001fa100: 7970 6520 6f66 2026 6c74 3b64 6f63 756d ype of <docum │ │ │ -001fa110: 656e 7426 6774 3b3b 2076 616c 6964 2061 ent>; valid a │ │ │ -001fa120: 7265 2027 4153 4349 4927 2c20 2749 534f re 'ASCII', 'ISO │ │ │ -001fa130: 272c 2027 5554 4638 272c 2027 4953 4f38 ', 'UTF8', 'ISO8 │ │ │ -001fa140: 3835 392d 3127 2c20 274c 4154 494e 2d31 859-1', 'LATIN-1 │ │ │ -001fa150: 2720 6574 632e 2c20 6465 6661 756c 7473 ' etc., defaults │ │ │ -001fa160: 2061 7265 2027 5554 462d 3827 2066 6f72 are 'UTF-8' for │ │ │ -001fa170: 2058 4d4c 206d 6f64 6520 616e 6420 274c XML mode and 'L │ │ │ -001fa180: 4154 494e 2d31 2720 666f 7220 4854 4d4c ATIN-1' for HTML │ │ │ -001fa190: 206d 6f64 653c 2f70 6172 613e 3c2f 7265 mode</para></re │ │ │ -001fa1a0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ -001fa1b0: 7365 6374 323e 3c74 6974 6c65 3e63 6f6e sect2><title>con │ │ │ -001fa1c0: 7465 6e74 5f6c 616e 6775 6167 653c 2f74 tent_language</t │ │ │ -001fa1d0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -001fa1e0: 613e 7374 7269 6e67 2077 6974 6820 6c61 a>string with la │ │ │ -001fa1f0: 6e67 7561 6765 2074 6167 206f 6620 636f nguage tag of co │ │ │ -001fa200: 6e74 656e 7420 6f66 2026 6c74 3b64 6f63 ntent of <doc │ │ │ -001fa210: 756d 656e 7426 6774 3b3b 2076 616c 6964 ument>; valid │ │ │ -001fa220: 206e 616d 6573 2061 7265 206c 6973 7465 names are liste │ │ │ -001fa230: 6420 696e 2049 4554 4620 5246 4320 3137 d in IETF RFC 17 │ │ │ -001fa240: 3636 2c20 6465 6661 756c 7420 6973 2027 66, default is ' │ │ │ -001fa250: 782d 616e 7927 2028 6974 206d 6561 6e73 x-any' (it means │ │ │ -001fa260: 2027 6d69 7820 6f66 2077 6f72 6473 2066 'mix of words f │ │ │ -001fa270: 726f 6d20 7661 7269 6f75 7320 6875 6d61 rom various huma │ │ │ -001fa280: 6e20 6c61 6e67 7561 6765 7329 3c2f 7061 n languages)</pa │ │ │ -001fa290: 7261 3e3c 2f72 6566 7365 6374 323e 0a20 ra></refsect2>. │ │ │ -001fa2a0: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ -001fa2b0: 746c 653e 6474 645f 7661 6c69 6461 746f tle>dtd_validato │ │ │ -001fa2c0: 725f 636f 6e66 6967 3c2f 7469 746c 653e r_config │ │ │ -001fa2d0: 0a20 2020 2020 203c 7061 7261 3e63 6f6e . con │ │ │ -001fa2e0: 6669 6775 7261 7469 6f6e 2073 7472 696e figuration strin │ │ │ -001fa2f0: 6720 6f66 2074 6865 2076 616c 6964 6174 g of the validat │ │ │ -001fa300: 6f72 2c20 6465 6661 756c 7420 6973 2065 or, default is e │ │ │ -001fa310: 6d70 7479 2073 7472 696e 6720 6d65 616e mpty string mean │ │ │ -001fa320: 696e 6720 7468 6174 2044 5444 2076 616c ing that DTD val │ │ │ -001fa330: 6964 6174 6f72 2073 686f 756c 6420 6265 idator should be │ │ │ -001fa340: 2066 756c 6c79 2064 6973 6162 6c65 6420 fully disabled │ │ │ -001fa350: 616e 6420 6f6e 6c79 2063 7269 7469 6361 and only critica │ │ │ -001fa360: 6c20 6572 726f 7273 2073 686f 756c 6420 l errors should │ │ │ -001fa370: 6265 2072 6570 6f72 7465 642e 0a49 7420 be reported..It │ │ │ -001fa380: 6973 2076 6572 7920 7072 6f62 6162 6c65 is very probable │ │ │ -001fa390: 2074 6861 7420 7468 6973 2069 7320 6e6f that this is no │ │ │ -001fa3a0: 7420 7468 6520 6265 7374 2063 686f 6963 t the best choic │ │ │ -001fa3b0: 6520 666f 7220 796f 7572 2061 7070 6c69 e for your appli │ │ │ -001fa3c0: 6361 7469 6f6e 2c20 736f 2070 6c65 6173 cation, so pleas │ │ │ -001fa3d0: 6520 2020 2020 200a 7265 6665 7220 3c6c e .refer Configu │ │ │ -001fa400: 7261 7469 6f6e 204f 7074 696f 6e73 206f ration Options o │ │ │ -001fa410: 6620 7468 6520 4454 4420 5661 6c69 6461 f the DTD Valida │ │ │ -001fa420: 746f 723c 2f6c 696e 6b3e 2074 6f20 6669 tor to fi │ │ │ -001fa430: 6e64 206f 7574 0a68 6f77 2074 6f20 6c65 nd out.how to le │ │ │ -001fa440: 7420 7661 6c69 6461 746f 7220 746f 2064 t validator to d │ │ │ -001fa450: 6f20 6265 7474 6572 206a 6f62 2e3c 2f70 o better job.

    . │ │ │ -001fa470: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -001fa480: 3c72 6566 7365 6374 3120 6964 3d22 7265 Return │ │ │ -001fa4a0: 2054 7970 6573 3c2f 7469 746c 653e 3c70 Types

    Human readab │ │ │ -001fa4c0: 6c65 206c 6973 7420 6f66 2065 7272 6f72 le list of error │ │ │ -001fa4d0: 7320 6966 2061 7070 6c69 6361 626c 6520 s if applicable │ │ │ -001fa4e0: 6173 2061 2076 6172 6368 6172 2e3c 2f70 as a varchar.

    . │ │ │ -001fa500: 2020 3c72 6566 7365 6374 3120 6964 3d22 Validating XML │ │ │ -001fa530: 4167 6169 6e73 7420 6120 4454 443c 2f74 Against a DTD</t │ │ │ -001fa540: 6974 6c65 3e0a 2020 2020 3c65 7861 6d70 itle>. <examp │ │ │ -001fa550: 6c65 2069 643d 2265 785f 786d 6c5f 7661 le id="ex_xml_va │ │ │ -001fa560: 6c69 6461 7465 5f73 6368 656d 6122 3e3c lidate_schema">< │ │ │ -001fa570: 7469 746c 653e 5369 6d70 6c65 2055 7365 title>Simple Use │ │ │ -001fa580: 3c2f 7469 746c 653e 0a3c 7072 6f67 7261 ..declar │ │ │ -001fa5a0: 6520 5f72 6573 756c 7420 7661 7263 6861 e _result varcha │ │ │ -001fa5b0: 723b 2020 0a5f 7265 7375 6c74 203a 3d20 r; ._result := │ │ │ -001fa5c0: 786d 6c5f 7661 6c69 6461 7465 5f73 6368 xml_validate_sch │ │ │ -001fa5d0: 656d 6120 280a 2020 5f74 6578 742c 2030 ema (. _text, 0 │ │ │ -001fa5e0: 2c20 2768 7474 703a 2f2f 6c6f 6361 6c68 , 'http://localh │ │ │ -001fa5f0: 6f73 742e 6c6f 6361 6c64 6f6d 6169 6e2f ost.localdomain/ │ │ │ -001fa600: 786d 6c72 6570 6f73 6974 6f72 7927 2c20 xmlrepository', │ │ │ -001fa610: 2755 5446 2d38 272c 2027 782d 616e 7927 'UTF-8', 'x-any' │ │ │ -001fa620: 2c0a 2020 2756 616c 6964 6174 696f 6e3d ,. 'Validation= │ │ │ -001fa630: 5347 4d4c 2046 7361 4261 6457 733d 4947 SGML FsaBadWs=IG │ │ │ -001fa640: 4e4f 5245 2042 7569 6c64 5374 616e 6461 NORE BuildStanda │ │ │ -001fa650: 6c6f 6e65 3d45 4e41 424c 4520 4d61 7845 lone=ENABLE MaxE │ │ │ -001fa660: 7272 6f72 733d 3130 3027 293b 0a0a 6966 rrors=100');..if │ │ │ -001fa670: 2028 5f72 6573 203d 2027 2729 205f 7265 (_res = '') _re │ │ │ -001fa680: 7320 3a3d 2027 4e4f 2045 5252 4f52 5320 s := 'NO ERRORS │ │ │ -001fa690: 4445 5445 4354 4544 273b 200a 3c2f 7072 DETECTED'; .. │ │ │ -001fa6b0: 2020 3c2f 6578 616d 706c 653e 0a20 203c . < │ │ │ -001fa6c0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. See A │ │ │ -001fa6f0: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -001fa700: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xml_validate │ │ │ -001fa740: 5f64 7464 2829 3c2f 6675 6e63 7469 6f6e _dtd()
    . │ │ │ -001fa760: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xml_view_dtd │ │ │ -001fa7a0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ -001fa7c0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xml_view_sche │ │ │ -001fa800: 6d61 2829 3c2f 6675 6e63 7469 6f6e 3e3c ma()< │ │ │ -001fa810: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -001fa820: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 x │ │ │ -001fa850: 7472 6565 5f64 6f63 2829 3c2f 6675 6e63 tree_doc()
    . xper_doc() │ │ │ -001fa8c0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . .
    ......(demo/doc │ │ │ -001fa8f0: 7372 632f 6675 6e63 7265 662f 786d 6c5f src/funcref/xml_ │ │ │ -001fa900: 7661 6c69 6461 7465 5f64 7464 2e78 6d6c validate_dtd.xml │ │ │ -001fa910: df00 0012 b23c 3f78 6d6c 2076 6572 7369 ..... │ │ │ -001fa940: 0a3c 212d 2d0a 202d 2020 0a20 2d20 2054 .. │ │ │ -001fd6e0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xslt(). │ │ │ -001fd720: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 http_value( │ │ │ -001fd750: 293c 2f70 6172 613e 0a20 2020 203c 7061 ). xml_tr │ │ │ -001fd790: 6565 5f64 6f63 2829 3c2f 7061 7261 3e0a ee_doc(). │ │ │ -001fd7a0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xml │ │ │ -001fd7d0: 5f74 7265 6528 293c 2f70 6172 613e 0a20 _tree(). │ │ │ -001fd7e0: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 ......../ │ │ │ -001fd800: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -001fd810: 7265 662f 786d 6c5f 7472 6565 5f64 6f63 ref/xml_tree_doc │ │ │ -001fd820: 5f6d 6564 6961 5f74 7970 652e 786d 6cdf _media_type.xml. │ │ │ -001fd830: 0000 0fd0 3c3f 786d 6c20 7665 7273 696f ..... │ │ │ -001fd860: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 │ │ │ -001fdbc0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . xml_t │ │ │ -001fdc10: 7265 655f 646f 635f 6d65 6469 615f 7479 ree_doc_media_ty │ │ │ -001fdc20: 7065 3c2f 7265 6665 6e74 7279 7469 746c pe. xml. . . x │ │ │ -001fdc80: 6d6c 5f74 7265 655f 646f 635f 6d65 6469 ml_tree_doc_medi │ │ │ -001fdc90: 615f 7479 7065 3c2f 7265 666e 616d 653e a_type │ │ │ -001fdca0: 0a20 2020 203c 7265 6670 7572 706f 7365 . . │ │ │ -001fdcc0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -001fdcd0: 203c 7265 6673 796e 6f70 7369 7364 6976 . . │ │ │ -001fdd50: 0a20 2020 2020 2020 203c 6675 6e63 6465 . varchar xml_tree_doc │ │ │ -001fdd80: 5f6d 6564 6961 5f74 7970 653c 2f66 756e _media_type │ │ │ -001fdda0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -001fddb0: 7061 7261 6d65 7465 723e 786d 6c5f 656e parameter>xml_en │ │ │ -001fddc0: 7469 7479 3c2f 7061 7261 6d65 7465 723e tity │ │ │ -001fddd0: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any. │ │ │ -001fdde0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -001fde20: 203c 7265 6673 6563 7431 2069 643d 2264 . │ │ │ -001fde50: 2020 3c74 6974 6c65 3e44 6573 6372 6970 Descrip │ │ │ -001fde60: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ -001fde70: 203c 7061 7261 3e54 6869 7320 6675 6e63 This func │ │ │ -001fde80: 7469 6f6e 2072 6574 7572 6e73 2074 6865 tion returns the │ │ │ -001fde90: 206d 6564 6961 2074 7970 6520 696e 2065 media type in e │ │ │ -001fdea0: 6666 6563 7420 666f 7220 7468 6520 7265 ffect for the re │ │ │ -001fdeb0: 7375 6c74 206f 6620 7468 6520 7873 6c74 sult of the xslt │ │ │ -001fdec0: 2829 200a 2020 2020 2858 534c 2d54 2920 () . (XSL-T) │ │ │ -001fded0: 7472 616e 7366 6f72 6d61 7469 6f6e 202c transformation , │ │ │ -001fdee0: 2062 6173 6564 206f 6e20 7873 6c3a 6f75 based on xsl:ou │ │ │ -001fdef0: 7470 7574 2022 6d65 6469 612d 7479 7065 tput "media-type │ │ │ -001fdf00: 2220 616e 6420 226d 6574 686f 6422 200a " and "method" . │ │ │ -001fdf10: 2020 2020 6174 7472 6962 7574 6573 206f attributes o │ │ │ -001fdf20: 6620 7468 6520 5853 4c2d 5420 7374 796c f the XSL-T styl │ │ │ -001fdf30: 652d 7368 6565 7420 6170 706c 6965 642e e-sheet applied. │ │ │ -001fdf40: 2020 0a20 2020 2049 7420 6163 6365 7074 . It accept │ │ │ -001fdf50: 7320 616e 2065 6e74 6974 7920 2870 6f74 s an entity (pot │ │ │ -001fdf60: 656e 7469 616c 6c79 2072 6573 756c 7469 entially resulti │ │ │ -001fdf70: 6e67 2066 726f 6d20 7573 696e 6720 7873 ng from using xs │ │ │ -001fdf80: 6c74 2829 2920 6173 2061 2061 7267 756d lt()) as a argum │ │ │ -001fdf90: 656e 7420 0a20 2020 2061 6e64 2077 696c ent . and wil │ │ │ -001fdfa0: 6c20 7265 7475 726e 2061 2073 7472 696e l return a strin │ │ │ -001fdfb0: 6720 636f 6e74 6169 6e69 6e67 2074 6865 g containing the │ │ │ -001fdfc0: 206d 6564 6961 2d74 7970 652e 203c 2f70 media-type.

    . . . P │ │ │ -001fe020: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ -001fe040: 3c74 6974 6c65 3e78 6d6c 5f65 6e74 6974 xml_entit │ │ │ -001fe050: 793c 2f74 6974 6c65 3e0a 2020 2020 2020 y. │ │ │ -001fe060: 3c70 6172 613e 416e 2058 4d4c 2065 6e74 An XML ent │ │ │ -001fe070: 6974 7920 7375 6368 2061 7320 7468 6174 ity such as that │ │ │ -001fe080: 2072 6574 7572 6e65 6420 6279 2074 6865 returned by the │ │ │ -001fe090: 2078 736c 7428 2920 6675 6e63 7469 6f6e xslt() function │ │ │ -001fe0a0: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . Retur │ │ │ -001fe100: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ -001fe110: 2020 2020 3c70 6172 613e 4966 2078 736c If xsl │ │ │ -001fe120: 3a6f 7574 7075 7420 226d 6564 6961 2d74 :output "media-t │ │ │ -001fe130: 7970 6522 2073 7065 6369 6669 6564 2069 ype" specified i │ │ │ -001fe140: 6e20 5853 4c2d 5420 7368 6565 7420 6974 n XSL-T sheet it │ │ │ -001fe150: 2773 2076 616c 7565 2077 696c 6c20 6265 's value will be │ │ │ -001fe160: 200a 2020 2020 7265 7475 726e 6564 2e20 . returned. │ │ │ -001fe170: 2049 6620 6e6f 2022 6d65 6469 612d 7479 If no "media-ty │ │ │ -001fe180: 7065 2220 2069 7320 7370 6563 6966 6965 pe" is specifie │ │ │ -001fe190: 642c 2074 6865 2076 616c 6964 2072 6573 d, the valid res │ │ │ -001fe1a0: 756c 7473 2064 6570 656e 6465 6e74 206f ults dependent o │ │ │ -001fe1b0: 6e20 0a20 2020 2074 6865 2026 6c74 3b78 n . the <x │ │ │ -001fe1c0: 736c 3a6f 7574 7075 7420 226d 6574 686f sl:output "metho │ │ │ -001fe1d0: 6422 2061 7474 7269 6275 7465 2061 7265 d" attribute are │ │ │ -001fe1e0: 3a3c 2f70 6172 613e 0a20 2020 203c 7369 :. . < │ │ │ -001fe200: 6d65 6d62 6572 3e69 6620 756e 6b6e 6f77 member>if unknow │ │ │ -001fe210: 6e20 3a20 6e6f 6e2d 7374 7269 6e67 2076 n : non-string v │ │ │ -001fe220: 616c 7565 3c2f 6d65 6d62 6572 3e0a 2020 alue. │ │ │ -001fe230: 2020 203c 6d65 6d62 6572 3e69 6620 2768 if 'h │ │ │ -001fe240: 746d 6c27 203a 2027 7465 7874 2f68 746d tml' : 'text/htm │ │ │ -001fe250: 6c27 3c2f 6d65 6d62 6572 3e0a 2020 2020 l'. │ │ │ -001fe260: 203c 6d65 6d62 6572 3e69 6620 2778 6874 if 'xht │ │ │ -001fe270: 6d6c 2720 3a20 2774 6578 742f 6874 6d6c ml' : 'text/html │ │ │ -001fe280: 273c 2f6d 656d 6265 723e 0a20 2020 2020 '. │ │ │ -001fe290: 3c6d 656d 6265 723e 6966 2027 786d 6c27 if 'xml' │ │ │ -001fe2a0: 203a 2027 7465 7874 2f78 6d6c 273c 2f6d : 'text/xml'. if 'text' : │ │ │ -001fe2d0: 2774 6578 742f 706c 6169 6e27 2e3c 2f6d 'text/plain'.. . . . Errors. This │ │ │ -001fe360: 2066 756e 6374 696f 6e20 6361 6e20 6765 function can ge │ │ │ -001fe370: 6e65 7261 7465 2074 6865 2066 6f6c 6c6f nerate the follo │ │ │ -001fe380: 7769 6e67 2065 7272 6f72 733a 3c2f 7061 wing errors:. 22023 SR003 . Fun │ │ │ -001fe3e0: 6374 696f 6e20 786d 6c5f 7472 6565 5f64 ction xml_tree_d │ │ │ -001fe3f0: 6f63 5f6d 6564 6961 5f74 7970 6520 6e65 oc_media_type ne │ │ │ -001fe400: 6564 7320 616e 2058 4d4c 2065 6e74 6974 eds an XML entit │ │ │ -001fe410: 7920 6173 2061 7267 756d 656e 7420 312c y as argument 1, │ │ │ -001fe420: 206e 6f74 200a 2020 2020 616e 2061 7267 not . an arg │ │ │ -001fe430: 206f 6620 7479 7065 2026 6c74 3b74 7970 of type <typ │ │ │ -001fe440: 655f 6e61 6d65 2667 743b 2028 266c 743b e_name> (< │ │ │ -001fe450: 7479 7065 2667 743b 293c 2f70 6172 613e type>) │ │ │ -001fe460: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -001fe470: 203c 7265 6673 6563 7431 2069 643d 2265 . Exa │ │ │ -001fe4b0: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ -001fe4c0: 2020 3c65 7861 6d70 6c65 2069 643d 2265 Assessing the │ │ │ -001fe500: 6d65 6469 6120 7479 7065 3c2f 7469 746c media type. . ........ │ │ │ -001fe5c0: 2d2d 2065 7865 6375 7465 2061 2073 696d -- execute a sim │ │ │ -001fe5d0: 706c 6520 7472 616e 7366 6f72 6d61 7469 ple transformati │ │ │ -001fe5e0: 6f6e 2076 6961 2049 5351 4c20 746f 6f6c on via ISQL tool │ │ │ -001fe5f0: 0a53 514c 3e20 7365 6c65 6374 2078 6d6c .SQL> select xml │ │ │ -001fe600: 5f74 7265 655f 646f 635f 6d65 6469 615f _tree_doc_media_ │ │ │ -001fe610: 7479 7065 2028 7873 6c74 2028 2766 696c type (xslt ('fil │ │ │ -001fe620: 653a 2f78 2e78 736c 272c 786d 6c5f 7472 e:/x.xsl',xml_tr │ │ │ -001fe630: 6565 5f64 6f63 2028 273c 4120 2f3e 2729 ee_doc ('') │ │ │ -001fe640: 2929 3b0a 436f 6e6e 6563 7465 6420 746f ));.Connected to │ │ │ -001fe650: 204f 7065 6e4c 696e 6b20 5669 7274 756f OpenLink Virtuo │ │ │ -001fe660: 736f 0a44 7269 7665 723a 2030 332e 3030 so.Driver: 03.00 │ │ │ -001fe670: 2e32 3331 3020 4f70 656e 4c69 6e6b 2056 .2310 OpenLink V │ │ │ -001fe680: 6972 7475 6f73 6f20 4f44 4243 2044 7269 irtuoso ODBC Dri │ │ │ -001fe690: 7665 720a 6361 6c6c 7265 740a 5641 5243 ver.callret.VARC │ │ │ -001fe6a0: 4841 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f HAR.____________ │ │ │ -001fe6b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001fe6c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001fe6d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001fe6e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -001fe6f0: 5f5f 5f0a 0a74 6578 742f 706c 6169 6e0a ___..text/plain. │ │ │ -001fe700: 0a31 2052 6f77 732e 202d 2d20 3935 206d .1 Rows. -- 95 m │ │ │ -001fe710: 7365 632e 0a5d 5d3e 0a3c 2f73 6372 6565 sec..]]>.. . . │ │ │ -001fe740: 2020 3c72 6566 7365 6374 3120 6964 3d22 . See │ │ │ -001fe780: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -001fe790: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xml_tree_doc() │ │ │ -001fe7d0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e . ......$demo/do │ │ │ -001fe810: 6373 7263 2f66 756e 6372 6566 2f78 6d6c csrc/funcref/xml │ │ │ -001fe820: 5f74 7265 655f 646f 632e 786d 6cdf 0000 _tree_doc.xml... │ │ │ -001fe830: 134e 3c3f 786d 6c20 7665 7273 696f 6e3d .N..< │ │ │ -001febc0: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ -001febd0: 786d 6c5f 7472 6565 5f64 6f63 223e 0a20 xml_tree_doc">. │ │ │ -001febe0: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -001febf0: 7265 6665 6e74 7279 7469 746c 653e 786d refentrytitle>xm │ │ │ -001fec00: 6c5f 7472 6565 5f64 6f63 3c2f 7265 6665 l_tree_doc. < │ │ │ -001fec20: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ -001fec30: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001fec40: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . xml_tree_ │ │ │ -001fec70: 646f 633c 2f72 6566 6e61 6d65 3e0a 2020 doc. │ │ │ -001fec80: 2020 3c72 6566 7075 7270 6f73 653e 7265 re │ │ │ -001fec90: 7475 726e 7320 616e 2065 6e74 6974 7920 turns an entity │ │ │ -001feca0: 6f62 6a65 6374 2067 6976 656e 2061 2074 object given a t │ │ │ -001fecb0: 7265 6520 6672 6f6d 2078 6d6c 5f74 7265 ree from xml_tre │ │ │ -001fecc0: 653c 2f72 6566 7075 7270 6f73 653e 0a20 e. │ │ │ -001fecd0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -001fece0: 203c 7265 6673 796e 6f70 7369 7364 6976 . . │ │ │ -001fed20: 2020 3c66 756e 6370 726f 746f 7479 7065 . │ │ │ -001fed50: 2020 203c 6675 6e63 6465 663e 3c66 756e xml_tree_d │ │ │ -001fed70: 6f63 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 oc. │ │ │ -001fed90: 3c70 6172 616d 6465 663e 696e 203c 7061 in tree any. │ │ │ -001fedd0: 3c70 6172 616d 6465 663e 3c6f 7074 696f in base_uri
    varchar. . │ │ │ -001fee40: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ -001fee50: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . Description</ti │ │ │ -001fee90: 746c 653e 0a09 0909 3c70 6172 613e 0a54 tle>....<para>.T │ │ │ -001feea0: 6869 7320 7265 7475 726e 7320 616e 2065 his returns an e │ │ │ -001feeb0: 6e74 6974 7920 6f62 6a65 6374 2067 6976 ntity object giv │ │ │ -001feec0: 656e 2061 2074 7265 6520 6f66 2074 6865 en a tree of the │ │ │ -001feed0: 2066 6f72 6d20 7265 7475 726e 6564 2062 form returned b │ │ │ -001feee0: 7920 786d 6c5f 7472 6565 2e0a 093c 2f70 y xml_tree...</p │ │ │ -001feef0: 6172 613e 0a09 0909 3c70 6172 613e 0a49 ara>....<para>.I │ │ │ -001fef00: 6620 6974 2069 7320 6769 7665 6e20 6120 f it is given a │ │ │ -001fef10: 7374 7269 6e67 2061 7320 616e 2061 7267 string as an arg │ │ │ -001fef20: 756d 656e 742c 2069 7420 7769 6c6c 2061 ument, it will a │ │ │ -001fef30: 7574 6f6d 6174 6963 616c 6c79 2067 656e utomatically gen │ │ │ -001fef40: 6572 6174 650a 7468 6520 7061 7273 6520 erate.the parse │ │ │ -001fef50: 7472 6565 2061 6e64 2075 7365 2069 7420 tree and use it │ │ │ -001fef60: 746f 206d 616b 6520 7468 6520 656e 7469 to make the enti │ │ │ -001fef70: 7479 2069 6e73 7465 6164 2072 6571 7569 ty instead requi │ │ │ -001fef80: 7269 6e67 2079 6f75 2074 6f20 7275 6e20 ring you to run │ │ │ -001fef90: 7468 6520 7374 7269 6e67 2074 6872 6f75 the string throu │ │ │ -001fefa0: 6768 0a78 6d6c 5f74 7265 6520 6669 7273 gh.xml_tree firs │ │ │ -001fefb0: 742e 204e 6f74 6520 7468 6174 2069 7420 t. Note that it │ │ │ -001fefc0: 6973 2062 6574 7465 7220 746f 2075 7365 is better to use │ │ │ -001fefd0: 203c 6675 6e63 7469 6f6e 3e3c 6c69 6e6b <function><link │ │ │ -001fefe0: 206c 696e 6b65 6e64 3d22 666e 5f78 7472 linkend="fn_xtr │ │ │ -001feff0: 6565 5f64 6f63 223e 7874 7265 655f 646f ee_doc">xtree_do │ │ │ -001ff000: 633c 2f6c 696e 6b3e 3c2f 6675 6e63 7469 c</link></functi │ │ │ -001ff010: 6f6e 3e20 6f72 0a3c 6675 6e63 7469 6f6e on> or.<function │ │ │ -001ff020: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ -001ff030: 666e 5f78 7065 725f 646f 6322 3e78 7065 fn_xper_doc">xpe │ │ │ -001ff040: 725f 646f 633c 2f6c 696e 6b3e 3c2f 6675 r_doc</link></fu │ │ │ -001ff050: 6e63 7469 6f6e 3e0a 666f 7220 636f 6e76 nction>.for conv │ │ │ -001ff060: 6572 7469 6e67 2073 6f75 7263 6520 584d erting source XM │ │ │ -001ff070: 4c20 7465 7874 2064 6972 6563 746c 7920 L text directly │ │ │ -001ff080: 746f 2061 6e20 584d 4c20 656e 7469 7479 to an XML entity │ │ │ -001ff090: 2e0a 093c 2f70 6172 613e 0a09 0909 3c70 ...</para>....<p │ │ │ -001ff0a0: 6172 613e 0a49 6620 7468 6520 6172 6775 ara>.If the argu │ │ │ -001ff0b0: 6d65 6e74 2069 7320 616e 2058 4d4c 2074 ment is an XML t │ │ │ -001ff0c0: 7265 6520 656e 7469 7479 2c20 7468 6520 ree entity, the │ │ │ -001ff0d0: 6675 6e63 7469 6f6e 2077 696c 6c20 7265 function will re │ │ │ -001ff0e0: 7475 726e 2069 7420 6173 2069 732c 2073 turn it as is, s │ │ │ -001ff0f0: 6f0a 652e 672e 2072 6564 756e 6461 6e74 o.e.g. redundant │ │ │ -001ff100: 2063 616c 6c73 206f 6620 3c66 756e 6374 calls of <funct │ │ │ -001ff110: 696f 6e3e 786d 6c5f 7472 6565 5f64 6f63 ion>xml_tree_doc │ │ │ -001ff120: 3c2f 6675 6e63 7469 6f6e 3e20 7769 6c6c </function> will │ │ │ -001ff130: 2068 6176 6520 6e6f 2065 6666 6563 742e have no effect. │ │ │ -001ff140: 0a54 6865 206f 6e6c 7920 7468 696e 6720 .The only thing │ │ │ -001ff150: 786d 6c5f 7472 6565 5f64 6f63 2063 616e xml_tree_doc can │ │ │ -001ff160: 2061 6c74 6572 2069 6e20 7468 6520 7265 alter in the re │ │ │ -001ff170: 7475 726e 6564 2076 616c 7565 2069 7320 turned value is │ │ │ -001ff180: 6261 7365 2055 5249 206f 660a 7468 6520 base URI of.the │ │ │ -001ff190: 646f 6375 6d65 6e74 2065 6e74 6974 793a document entity: │ │ │ -001ff1a0: 2069 6620 3c70 6172 616d 6574 6572 3e62 if <parameter>b │ │ │ -001ff1b0: 6173 655f 7572 693c 2f70 6172 616d 6574 ase_uri</paramet │ │ │ -001ff1c0: 6572 3e20 6973 2070 726f 7669 6465 6420 er> is provided │ │ │ -001ff1d0: 616e 6420 6973 0a6e 6f74 204e 554c 4c2c and is.not NULL, │ │ │ -001ff1e0: 2061 6e64 2061 7267 756d 656e 7420 656e and argument en │ │ │ -001ff1f0: 7469 7479 2068 6173 206e 6f20 6261 7365 tity has no base │ │ │ -001ff200: 2055 5249 2073 6574 2074 6865 6e20 7468 URI set then th │ │ │ -001ff210: 6520 7072 6f76 6964 6564 2055 5249 0a69 e provided URI.i │ │ │ -001ff220: 7320 6173 7369 676e 6564 2074 6f20 7468 s assigned to th │ │ │ -001ff230: 6520 7265 7475 726e 6564 2065 6e74 6974 e returned entit │ │ │ -001ff240: 792e 0a09 3c2f 7061 7261 3e0a 0909 093c y...</para>....< │ │ │ -001ff250: 7061 7261 3e0a 416e 7920 6f74 6865 7220 para>.Any other │ │ │ -001ff260: 7479 7065 206f 6620 6172 6775 6d65 6e74 type of argument │ │ │ -001ff270: 2069 7320 696c 6c65 6761 6c2c 2069 6e63 is illegal, inc │ │ │ -001ff280: 6c75 6469 6e67 2058 4d4c 2070 6572 7369 luding XML persi │ │ │ -001ff290: 7374 656e 7420 656e 7469 7479 2e0a 093c stent entity...< │ │ │ -001ff2a0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. </refse │ │ │ -001ff2b0: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ -001ff2c0: 2069 643d 2270 6172 616d 7322 3e3c 7469 id="params"><ti │ │ │ -001ff2d0: 746c 653e 5061 7261 6d65 7465 7273 3c2f tle>Parameters</ │ │ │ -001ff2e0: 7469 746c 653e 0a20 2020 203c 7265 6673 title>. <refs │ │ │ -001ff2f0: 6563 7432 3e3c 7469 746c 653e 7472 6565 ect2><title>tree │ │ │ -001ff300: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -001ff310: 7061 7261 3e65 6974 6865 7220 616e 2058 para>either an X │ │ │ -001ff320: 4d4c 2074 7265 6520 7375 6368 2061 7320 ML tree such as │ │ │ -001ff330: 7468 6174 2072 6574 7572 6e65 6420 6279 that returned by │ │ │ -001ff340: 2078 6d6c 5f74 7265 6528 292c 206f 7220 xml_tree(), or │ │ │ -001ff350: 6120 7374 7269 6e67 206f 6620 584d 4c20 a string of XML │ │ │ -001ff360: 6461 7461 2e0a 4966 2061 2073 7472 696e data..If a strin │ │ │ -001ff370: 6720 6973 2070 726f 7669 6465 6420 7468 g is provided th │ │ │ -001ff380: 656e 2069 7420 7769 6c6c 2061 7574 6f6d en it will autom │ │ │ -001ff390: 6174 6963 616c 6c79 2067 656e 6572 6174 atically generat │ │ │ -001ff3a0: 6520 7468 6520 7061 7273 6520 7472 6565 e the parse tree │ │ │ -001ff3b0: 2061 6e64 2066 6f72 6d20 616e 0a65 6e74 and form an.ent │ │ │ -001ff3c0: 6974 7920 696e 7374 6561 6420 6f66 2072 ity instead of r │ │ │ -001ff3d0: 6571 7569 7269 6e67 2079 6f75 2074 6f20 equiring you to │ │ │ -001ff3e0: 7275 6e20 7468 6520 7374 7269 6e67 2074 run the string t │ │ │ -001ff3f0: 6872 6f75 6768 2078 6d6c 5f74 7265 6528 hrough xml_tree( │ │ │ -001ff400: 2920 6669 7273 742e 3c2f 7061 7261 3e3c ) first.< │ │ │ -001ff410: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -001ff420: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -001ff430: 6261 7365 5f75 7269 3c2f 7469 746c 653e base_uri │ │ │ -001ff440: 0a20 2020 2020 203c 7061 7261 3e42 6173 . Bas │ │ │ -001ff450: 6520 5552 4920 6f66 2074 6865 206f 7269 e URI of the ori │ │ │ -001ff460: 6769 6e61 6c20 646f 6375 6d65 6e74 2c20 ginal document, │ │ │ -001ff470: 6966 206b 6e6f 776e 2e0a 4974 2077 696c if known..It wil │ │ │ -001ff480: 6c20 6265 2075 7365 6675 6c20 6966 2074 l be useful if t │ │ │ -001ff490: 6865 2064 6f63 756d 656e 7420 6973 206e he document is n │ │ │ -001ff4a0: 6f74 2026 7175 6f74 3b73 7461 6e64 616c ot "standal │ │ │ -001ff4b0: 6f6e 6526 7175 6f74 3b20 616e 6420 736f one" and so │ │ │ -001ff4c0: 6d65 2065 6e74 6974 7920 7265 6665 7265 me entity refere │ │ │ -001ff4d0: 6e63 6573 0a61 7265 2072 656c 6174 6976 nces.are relativ │ │ │ -001ff4e0: 6520 7265 6665 7265 6e63 6573 2074 6f20 e references to │ │ │ -001ff4f0: 7265 736f 7572 6365 7320 6c6f 6361 7465 resources locate │ │ │ -001ff500: 6420 2671 756f 743b 736f 6d65 7768 6572 d "somewher │ │ │ -001ff510: 6520 6e65 6172 2671 756f 743b 2074 6865 e near" the │ │ │ -001ff520: 0a26 7175 6f74 3b74 6f70 2d6c 6576 656c ."top-level │ │ │ -001ff530: 2671 756f 743b 2064 6f63 756d 656e 7420 " document │ │ │ -001ff540: 7061 7373 6573 2061 7320 2671 756f 743b passes as " │ │ │ -001ff550: 7472 6565 2671 756f 743b 2070 6172 616d tree" param │ │ │ -001ff560: 6574 6572 2e3c 2f70 6172 613e 3c2f 7265 eter.. . Return TypesXML │ │ │ -001ff5c0: 656e 7469 7479 206f 626a 6563 743c 2f70 entity object

    . │ │ │ -001ff5e0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Erro │ │ │ -001ff610: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -001ff620: 7461 626c 653e 3c74 6974 6c65 3e45 7272 table>Err │ │ │ -001ff630: 6f72 7320 7369 676e 616c 6c65 6420 6279 ors signalled by │ │ │ -001ff640: 203c 2f74 6974 6c65 3e0a 2020 2020 2020 . │ │ │ -001ff650: 3c74 6772 6f75 7020 636f 6c73 3d22 3422 . . │ │ │ -001ff670: 0920 203c 726f 773e 3c65 6e74 7279 3e53 . S │ │ │ -001ff680: 514c 2053 7461 7465 3c2f 656e 7472 793e QL State │ │ │ -001ff690: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ -001ff6a0: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ -001ff6b0: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ -001ff6d0: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion. │ │ │ -001ff6f0: 0a09 3c74 626f 6479 3e0a 0920 203c 726f .... .. < │ │ │ -001ff710: 6572 726f 7263 6f64 653e 3c2f 6572 726f errorcode>.. │ │ │ -001ff730: 2020 2020 3c65 6e74 7279 3e3c 6572 726f .. │ │ │ -001ff760: 3c65 6e74 7279 3e3c 6572 726f 726e 616d .. .. < │ │ │ -001ff7a0: 2f72 6f77 3e0a 093c 2f74 626f 6479 3e0a /row>... │ │ │ -001ff7b0: 2020 2020 2020 3c2f 7467 726f 7570 3e0a . │ │ │ -001ff7c0: 2020 2020 3c2f 7461 626c 653e 0a20 203c . < │ │ │ -001ff7d0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Exam │ │ │ -001ff800: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ -001ff810: 203c 6578 616d 706c 6520 6964 3d22 6578 < │ │ │ -001ff830: 7469 746c 653e 5472 616e 7366 6f72 6d69 title>Transformi │ │ │ -001ff840: 6e67 2061 6e20 584d 4c20 446f 6375 6d65 ng an XML Docume │ │ │ -001ff850: 6e74 3c2f 7469 746c 653e 0a20 2020 2020 nt. │ │ │ -001ff860: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 .declare doc_ba │ │ │ -001ff880: 7365 2076 6172 6368 6172 3b0a 6465 636c se varchar;.decl │ │ │ -001ff890: 6172 6520 646f 635f 7472 6565 2061 6e79 are doc_tree any │ │ │ -001ff8a0: 3b0a 0a64 6f63 5f62 6173 6520 3a3d 2027 ;..doc_base := ' │ │ │ -001ff8b0: 7669 7274 3a2f 2f57 532e 5753 2e53 5953 virt://WS.WS.SYS │ │ │ -001ff8c0: 5f44 4156 5f52 4553 2e52 4553 5f46 554c _DAV_RES.RES_FUL │ │ │ -001ff8d0: 4c5f 5041 5448 2e52 4553 5f43 4f4e 5445 L_PATH.RES_CONTE │ │ │ -001ff8e0: 4e54 3a2f 4441 562f 646f 6373 7263 2f27 NT:/DAV/docsrc/' │ │ │ -001ff8f0: 3b0a 646f 635f 7472 6565 203a 3d20 786d ;.doc_tree := xm │ │ │ -001ff900: 6c5f 7472 6565 5f64 6f63 2878 6d6c 5f74 l_tree_doc(xml_t │ │ │ -001ff910: 7265 6528 0a20 2020 2078 6d6c 5f75 7269 ree(. xml_uri │ │ │ -001ff920: 5f67 6574 2864 6f63 5f62 6173 652c 2027 _get(doc_base, ' │ │ │ -001ff930: 7669 7274 646f 6373 2e78 6d6c 2729 0a20 virtdocs.xml'). │ │ │ -001ff940: 2020 2020 2029 2c20 646f 635f 6261 7365 ), doc_base │ │ │ -001ff950: 293b 0a0a 6874 7470 5f76 616c 7565 280a );..http_value(. │ │ │ -001ff960: 2020 7873 6c74 2827 7669 7274 3a2f 2f57 xslt('virt://W │ │ │ -001ff970: 532e 5753 2e53 5953 5f44 4156 5f52 4553 S.WS.SYS_DAV_RES │ │ │ -001ff980: 2e52 4553 5f46 554c 4c5f 5041 5448 2e52 .RES_FULL_PATH.R │ │ │ -001ff990: 4553 5f43 4f4e 5445 4e54 3a2f 4441 562f ES_CONTENT:/DAV/ │ │ │ -001ff9a0: 7374 796c 6573 6865 6574 732f 6874 6d6c stylesheets/html │ │ │ -001ff9b0: 5f63 6861 7074 6572 2e78 736c 272c 0a20 _chapter.xsl',. │ │ │ -001ff9c0: 2020 2064 6f63 5f74 7265 650a 2020 290a doc_tree. ). │ │ │ -001ff9d0: 293b 0a3c 2f70 726f 6772 616d 6c69 7374 );.. . . See Also.
  • xtree_ │ │ │ -001ffa60: 646f 633c 2f6c 696e 6b3e 3c2f 7061 7261 doc. xper_doc │ │ │ -001ffaa0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -001ffab0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_tree. │ │ │ -001ffaf0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xs │ │ │ -001ffb10: 6c74 3c2f 6c69 6e6b 3e3c 2f70 6172 613e lt │ │ │ -001ffb20: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xml_ur │ │ │ -001ffb50: 695f 6765 743c 2f6c 696e 6b3e 3c2f 7061 i_get. .... │ │ │ -001ffb80: b600 0000 2064 656d 6f2f 646f 6373 7263 .... demo/docsrc │ │ │ -001ffb90: 2f66 756e 6372 6566 2f78 6d6c 5f74 7265 /funcref/xml_tre │ │ │ -001ffba0: 652e 786d 6cdf 0000 1321 3c3f 786d 6c20 e.xml....!... . │ │ │ -001fff60: 2020 203c 7265 6665 6e74 7279 7469 746c xml_tree. < │ │ │ -001fff90: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ -001fffa0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -001fffb0: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . xml_tree< │ │ │ -001fffe0: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Parses │ │ │ -00200000: 2061 6e20 584d 4c20 6672 6167 6d65 6e74 an XML fragment │ │ │ -00200010: 2061 6e64 2072 6574 7572 6e73 2074 6865 and returns the │ │ │ -00200020: 2070 6172 7365 2074 7265 6520 6173 206e parse tree as n │ │ │ -00200030: 6573 7465 6420 7665 6374 6f72 732e 3c2f ested vectors.. . . │ │ │ -00200070: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . . │ │ │ -002000c0: 2020 2020 2020 2020 3c66 756e 6364 6566 xml_t │ │ │ -002000e0: 7265 653c 2f66 756e 6374 696f 6e3e 3c2f ree. │ │ │ -00200100: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    documen │ │ │ -00200120: 743c 2f70 6172 616d 6574 6572 3e20 2076 t v │ │ │ -00200130: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. in │ │ │ -00200160: 203c 7061 7261 6d65 7465 723e 7061 7273 pars │ │ │ -00200170: 6572 5f6d 6f64 653c 2f70 6172 616d 6574 er_mode integer. in │ │ │ -002001c0: 203c 7061 7261 6d65 7465 723e 6261 7365 base │ │ │ -002001d0: 5f75 7269 3c2f 7061 7261 6d65 7465 723e _uri │ │ │ -002001e0: 2076 6172 6368 6172 3c2f 6f70 7469 6f6e varchar. │ │ │ -00200200: 2020 2020 2020 203c 7061 7261 6d64 6566 in

    content │ │ │ -00200230: 5f65 6e63 6f64 696e 673c 2f70 6172 616d _encoding varchar. │ │ │ -00200280: 696e 203c 7061 7261 6d65 7465 723e 636f in co │ │ │ -00200290: 6e74 656e 745f 6c61 6e67 7561 6765 3c2f ntent_language varch │ │ │ -002002b0: 6172 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 ar

    . │ │ │ -002002d0: 203c 7061 7261 6d64 6566 3e3c 6f70 7469 in dtd_validator │ │ │ -00200300: 5f63 6f6e 6669 673c 2f70 6172 616d 6574 _config varchar. . . < │ │ │ -00200360: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -00200370: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ -00200390: 0a20 2020 203c 7469 746c 653e 4465 7363 . Desc │ │ │ -002003a0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -002003b0: 2020 2020 2020 3c70 6172 613e 5468 6973 This │ │ │ -002003c0: 2070 6172 7365 7320 7468 6520 6172 6775 parses the argu │ │ │ -002003d0: 6d65 6e74 2c20 7768 6963 6820 6973 2065 ment, which is e │ │ │ -002003e0: 7870 6563 7465 6420 746f 2062 6520 6120 xpected to be a │ │ │ -002003f0: 7765 6c6c 2066 6f72 6d65 6420 584d 4c0a well formed XML. │ │ │ -00200400: 2020 2020 2020 6672 6167 6d65 6e74 2061 fragment a │ │ │ -00200410: 6e64 2072 6574 7572 6e73 2061 2070 6172 nd returns a par │ │ │ -00200420: 7365 2074 7265 6520 6173 2061 2073 7472 se tree as a str │ │ │ -00200430: 7563 7475 7265 206f 6620 6e65 7374 6564 ucture of nested │ │ │ -00200440: 2068 6574 6572 6f67 656e 656f 7573 2076 heterogeneous v │ │ │ -00200450: 6563 746f 7273 2e3c 2f70 6172 613e 0a20 ectors.. │ │ │ -00200460: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -00200470: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -00200480: 616d 735f 786d 6c5f 7472 6565 223e 0a20 ams_xml_tree">. │ │ │ -00200490: 2020 203c 7469 746c 653e 5061 7261 6d65 Parame │ │ │ -002004a0: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -002004b0: 203c 7265 6673 6563 7432 3e3c 7469 746c document . │ │ │ -002004e0: 286d 616e 6461 746f 7279 2920 4120 7765 (mandatory) A we │ │ │ -002004f0: 6c6c 2066 6f72 6d65 6420 584d 4c20 6f72 ll formed XML or │ │ │ -00200500: 2048 544d 4c20 646f 6375 6d65 6e74 3c2f HTML document │ │ │ -00200520: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00200530: 7469 746c 653e 7061 7273 6572 5f6d 6f64 title>parser_mod │ │ │ -00200540: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -00200550: 3c70 6172 613e 302c 2031 206f 7220 323b 0, 1 or 2; │ │ │ -00200560: 2030 202d 2058 4d4c 2070 6172 7365 7220 0 - XML parser │ │ │ -00200570: 6d6f 6465 2c20 3120 2d20 4854 4d4c 2070 mode, 1 - HTML p │ │ │ -00200580: 6172 7365 7220 6d6f 6465 2c20 3220 2d20 arser mode, 2 - │ │ │ -00200590: 2764 6972 7479 2048 544d 4c27 206d 6f64 'dirty HTML' mod │ │ │ -002005a0: 6520 2877 6974 6820 7175 6965 7420 7265 e (with quiet re │ │ │ -002005b0: 636f 7665 7279 2061 6674 6572 2061 6e79 covery after any │ │ │ -002005c0: 2073 796e 7461 7820 6572 726f 7229 3c2f syntax error) │ │ │ -002005e0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -002005f0: 7469 746c 653e 6261 7365 5f75 7269 3c2f title>base_uri. (optional) in │ │ │ -00200620: 2048 544d 4c20 7061 7273 6572 206d 6f64 HTML parser mod │ │ │ -00200630: 6520 6368 616e 6765 2061 6c6c 2061 6273 e change all abs │ │ │ -00200640: 6f6c 7574 6520 7265 6665 7265 6e63 6573 olute references │ │ │ -00200650: 2074 6f20 7265 6c61 7469 7665 2066 726f to relative fro │ │ │ -00200660: 6d20 6769 7665 6e20 6261 7365 5f75 7269 m given base_uri │ │ │ -00200670: 2028 6874 7470 3a2f 2f26 6c74 3b68 6f73 (http://<hos │ │ │ -00200680: 7426 6774 3b3a 266c 743b 706f 7274 2667 t>:<port&g │ │ │ -00200690: 743b 2f26 6c74 3b70 6174 6826 6774 3b29 t;/<path>) │ │ │ -002006a0: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374
    . content_ │ │ │ -002006d0: 656e 636f 6469 6e67 3c2f 7469 746c 653e encoding │ │ │ -002006e0: 0a20 2020 2020 203c 7061 7261 3e28 6f70 . (op │ │ │ -002006f0: 7469 6f6e 616c 2920 7374 7269 6e67 2077 tional) string w │ │ │ -00200700: 6974 6820 636f 6e74 656e 7420 656e 636f ith content enco │ │ │ -00200710: 6469 6e67 2074 7970 6520 6f66 2026 6c74 ding type of < │ │ │ -00200720: 3b64 6f63 756d 656e 7426 6774 3b20 7661 ;document> va │ │ │ -00200730: 6c69 6420 6973 2027 4153 4349 4927 2c20 lid is 'ASCII', │ │ │ -00200740: 2749 534f 272c 2027 5554 4638 272c 2027 'ISO', 'UTF8', ' │ │ │ -00200750: 4953 4f38 3835 392d 3127 2c20 274c 4154 ISO8859-1', 'LAT │ │ │ -00200760: 494e 2d31 272e 3c2f 7061 7261 3e3c 2f72 IN-1'.. co │ │ │ -00200790: 6e74 656e 745f 6c61 6e67 7561 6765 3c2f ntent_language</ │ │ │ -002007a0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -002007b0: 7261 3e28 6f70 7469 6f6e 616c 2920 2d20 ra>(optional) - │ │ │ -002007c0: 7374 7269 6e67 2077 6974 6820 6c61 6e67 string with lang │ │ │ -002007d0: 7561 6765 2074 6167 206f 6620 636f 6e74 uage tag of cont │ │ │ -002007e0: 656e 7420 6f66 2026 6c74 3b64 6f63 756d ent of <docum │ │ │ -002007f0: 656e 7426 6774 3b3b 2076 616c 6964 206e ent>; valid n │ │ │ -00200800: 616d 6573 2061 7265 206c 6973 7465 6420 ames are listed │ │ │ -00200810: 696e 2049 4554 4620 5246 4320 3137 3636 in IETF RFC 1766 │ │ │ -00200820: 2c20 6465 6661 756c 7420 6973 2027 782d , default is 'x- │ │ │ -00200830: 616e 7927 2028 6974 206d 6561 6e73 2027 any' (it means ' │ │ │ -00200840: 6d69 7820 6f66 2077 6f72 6473 2066 726f mix of words fro │ │ │ -00200850: 6d20 7661 7269 6f75 7320 6875 6d61 6e20 m various human │ │ │ -00200860: 6c61 6e67 7561 6765 7329 2e3c 2f70 6172 languages).</par │ │ │ -00200870: 613e 3c2f 7265 6673 6563 7432 3e0a 2020 a></refsect2>. │ │ │ -00200880: 2020 3c72 6566 7365 6374 323e 3c74 6974 <refsect2><tit │ │ │ -00200890: 6c65 3e64 7464 5f76 616c 6964 6174 6f72 le>dtd_validator │ │ │ -002008a0: 5f63 6f6e 6669 673c 2f74 6974 6c65 3e0a _config. │ │ │ -002008b0: 2020 2020 2020 3c70 6172 613e 636f 6e66 conf │ │ │ -002008c0: 6967 7572 6174 696f 6e20 7374 7269 6e67 iguration string │ │ │ -002008d0: 2066 6f72 2044 5444 2076 616c 6964 6174 for DTD validat │ │ │ -002008e0: 6f72 2c20 6465 6661 756c 7420 6973 2065 or, default is e │ │ │ -002008f0: 6d70 7479 2073 7472 696e 6720 6d65 616e mpty string mean │ │ │ -00200900: 696e 6720 7468 6174 2044 5444 2076 616c ing that DTD val │ │ │ -00200910: 6964 6174 6f72 2073 686f 756c 6420 6265 idator should be │ │ │ -00200920: 2066 756c 6c79 2064 6973 6162 6c65 642e fully disabled. │ │ │ -00200930: 0a20 5365 6520 3c6c 696e 6b20 6c69 6e6b . See Configuration O │ │ │ -00200960: 7074 696f 6e73 206f 6620 7468 6520 4454 ptions of the DT │ │ │ -00200970: 4420 5661 6c69 6461 746f 723c 2f6c 696e D Validator for details.< │ │ │ -00200990: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. . │ │ │ -002009b0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Return Type │ │ │ -002009e0: 733c 2f74 6974 6c65 3e3c 7061 7261 3e76 sv │ │ │ -002009f0: 6563 746f 7220 6f66 2076 6563 746f 7273 ector of vectors │ │ │ -00200a00: 2072 6570 7265 7365 6e74 696e 6720 7468 representing th │ │ │ -00200a10: 6520 7061 7273 6564 2074 7265 6520 6f66 e parsed tree of │ │ │ -00200a20: 2058 4d4c 2e3c 2f70 6172 613e 3c2f 7265 XML... │ │ │ -00200c60: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ -00200c70: 0a20 2020 203c 6578 616d 706c 6520 6964 . < │ │ │ -00200c90: 7469 746c 653e 4d61 6b69 6e67 2061 6e20 title>Making an │ │ │ -00200ca0: 584d 4c20 7472 6565 3c2f 7469 746c 653e XML tree │ │ │ -00200cb0: 0a20 2020 2020 203c 7363 7265 656e 3e64 . d │ │ │ -00200cc0: 6563 6c61 7265 2074 7265 6520 616e 793b eclare tree any; │ │ │ -00200cd0: 0a0a 7472 6565 203a 3d20 786d 6c5f 7472 ..tree := xml_tr │ │ │ -00200ce0: 6565 2028 6669 6c65 5f74 6f5f 7374 7269 ee (file_to_stri │ │ │ -00200cf0: 6e67 2028 2764 6f63 2e68 746d 6c27 292c ng ('doc.html'), │ │ │ -00200d00: 2031 2c0a 0909 2768 7474 703a 2f2f 6c6f 1,...'http://lo │ │ │ -00200d10: 6361 6c68 6f73 742e 6c6f 6361 6c64 6f6d calhost.localdom │ │ │ -00200d20: 6169 6e2f 272c 2027 4953 4f27 293b 0a2e ain/', 'ISO');.. │ │ │ -00200d30: 2e2e 0a74 7265 6520 3a3d 2078 6d6c 5f74 ...tree := xml_t │ │ │ -00200d40: 7265 6520 2866 696c 655f 746f 5f73 7472 ree (file_to_str │ │ │ -00200d50: 696e 6720 2827 646f 632e 786d 6c27 2929 ing ('doc.xml')) │ │ │ -00200d60: 3b0a 3c2f 7363 7265 656e 3e0a 2020 2020 ;.. │ │ │ -00200d70: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . See Also.
  • x │ │ │ -00200df0: 736c 743c 2f66 756e 6374 696f 6e3e 3c2f slt,. xml_uri_get< │ │ │ -00200e40: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. xml_validat │ │ │ -00200e90: 655f 6474 643c 2f66 756e 6374 696f 6e3e e_dtd │ │ │ -00200ea0: 3c2f 6c69 6e6b 3e2e 3c2f 7061 7261 3e0a .. │ │ │ -00200eb0: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f .......$ │ │ │ -00200ed0: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -00200ee0: 7265 662f 786d 6c5f 7465 6d70 6c61 7465 ref/xml_template │ │ │ -00200ef0: 2e78 6d6c df00 0010 cd3c 3f78 6d6c 2076 .xml........ . xml_templat │ │ │ -002012d0: 653c 2f72 6566 656e 7472 7974 6974 6c65 e. xml. . │ │ │ -00201320: 0a20 2020 203c 7265 666e 616d 653e 786d . xm │ │ │ -00201330: 6c5f 7465 6d70 6c61 7465 3c2f 7265 666e l_template. Execute XML │ │ │ -00201360: 2074 656d 706c 6174 6520 6672 6f6d 2056 template from V │ │ │ -00201370: 6972 7475 6f73 6f20 504c 3c2f 7265 6670 irtuoso PL. . . < │ │ │ -002013b0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -002013c0: 2266 7379 6e5f 786d 6c5f 7465 6d70 6c61 "fsyn_xml_templa │ │ │ -002013d0: 7465 223e 0a20 2020 2020 203c 6675 6e63 te">. . x │ │ │ -00201420: 6d6c 5f74 656d 706c 6174 653c 2f66 756e ml_template │ │ │ -00201440: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in xml_document_en │ │ │ -00201470: 7469 7479 3c2f 7061 7261 6d65 7465 723e tity │ │ │ -00201480: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any. │ │ │ -00201490: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -002014b0: 7061 7261 6d65 7465 7273 3c2f 7061 7261 parameters vector

    . │ │ │ -002014e0: 203c 7061 7261 6d64 6566 3e3c 6f70 7469 inout session

    string │ │ │ -00201520: 5f73 6573 7369 6f6e 3c2f 6f70 7469 6f6e _session
    . │ │ │ -00201540: 2020 2020 203c 2f66 756e 6370 726f 746f .
    . . │ │ │ -00201580: 3c72 6566 7365 6374 3120 6964 3d22 6465 . Des │ │ │ -002015b0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -002015c0: 0a20 2020 203c 7061 7261 3e54 6865 203c . The < │ │ │ -002015d0: 6675 6e63 7469 6f6e 3e78 6d6c 5f74 656d function>xml_tem │ │ │ -002015e0: 706c 6174 6528 293c 2f66 756e 6374 696f plate() function was │ │ │ -00201600: 696e 7472 6f64 7563 6564 2074 6f20 0a20 introduced to . │ │ │ -00201610: 2020 2065 6e61 626c 6520 504c 2070 726f enable PL pro │ │ │ -00201620: 6772 616d 6d69 6e67 2074 6f20 6d61 6b65 gramming to make │ │ │ -00201630: 2075 7365 206f 6620 584d 4c20 7465 6d70 use of XML temp │ │ │ -00201640: 6c61 7465 732e 2020 0a20 2020 2054 6869 lates. . Thi │ │ │ -00201650: 7320 6675 6e63 7469 6f6e 2065 7870 6563 s function expec │ │ │ -00201660: 7473 2061 6e20 584d 4c20 656e 7469 7479 ts an XML entity │ │ │ -00201670: 2066 6f72 2074 6865 2066 6972 7374 2061 for the first a │ │ │ -00201680: 7267 756d 656e 742c 2074 6861 7420 7769 rgument, that wi │ │ │ -00201690: 6c6c 2062 650a 2020 2020 7468 6520 584d ll be. the XM │ │ │ -002016a0: 4c20 7465 6d70 6c61 7465 2066 696c 6520 L template file │ │ │ -002016b0: 636f 6e74 656e 7473 2e20 2055 7375 616c contents. Usual │ │ │ -002016c0: 6c79 2074 6869 7320 656e 7469 7479 2069 ly this entity i │ │ │ -002016d0: 7320 636f 6d70 6f73 6564 206d 616b 696e s composed makin │ │ │ -002016e0: 6720 0a20 2020 2075 7365 206f 6620 7468 g . use of th │ │ │ -002016f0: 6520 3c66 756e 6374 696f 6e3e 7874 7265 e xtre │ │ │ -00201700: 655f 646f 6328 293c 2f66 756e 6374 696f e_doc() function from │ │ │ -00201720: 2074 6865 2058 4d4c 200a 2020 2020 7465 the XML . te │ │ │ -00201730: 6d70 6c61 7465 2066 696c 652e 3c2f 7061 mplate file.. Th │ │ │ -00201750: 6520 7365 636f 6e64 2061 7267 756d 656e e second argumen │ │ │ -00201760: 7420 7368 6f75 6c64 2062 6520 6120 7665 t should be a ve │ │ │ -00201770: 6374 6f72 206f 6620 6e61 6d65 2d76 616c ctor of name-val │ │ │ -00201780: 7565 2070 6169 7273 206f 6620 7468 6520 ue pairs of the │ │ │ -00201790: 0a20 2020 2070 6172 616d 6574 6572 7320 . parameters │ │ │ -002017a0: 666f 7220 584d 4c20 7465 6d70 6c61 7465 for XML template │ │ │ -002017b0: 2e3c 2f70 6172 613e 0a20 2020 203c 7061 .. The last argu │ │ │ -002017d0: 6d65 6e74 2069 7320 616e 206f 7574 7075 ment is an outpu │ │ │ -002017e0: 7420 7374 7269 6e67 2073 7472 6561 6d20 t string stream │ │ │ -002017f0: 666f 7220 7468 6520 7265 7375 6c74 2e20 for the result. │ │ │ -00201800: 2049 6620 7468 6520 0a20 2020 206f 7574 If the . out │ │ │ -00201810: 7075 7420 7374 7265 616d 2069 7320 6e6f put stream is no │ │ │ -00201820: 7420 7370 6563 6966 6965 6420 7468 6520 t specified the │ │ │ -00201830: 4854 5450 2069 6e74 6572 6e61 6c20 7374 HTTP internal st │ │ │ -00201840: 7265 616d 2077 696c 6c20 6265 2075 7365 ream will be use │ │ │ -00201850: 6420 0a20 2020 2069 6620 6974 2069 7320 d . if it is │ │ │ -00201860: 6176 6169 6c61 626c 652c 206f 7468 6572 available, other │ │ │ -00201870: 7769 7365 2061 6e20 6572 726f 7220 7769 wise an error wi │ │ │ -00201880: 6c6c 2062 6520 7369 676e 616c 6c65 642e ll be signalled. │ │ │ -00201890: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . │ │ │ -002018d0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ -002018e0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. x │ │ │ -00201900: 6d6c 5f64 6f63 756d 656e 745f 656e 7469 ml_document_enti │ │ │ -00201910: 7479 3c2f 7469 746c 653e 0a20 2020 2020 ty. │ │ │ -00201920: 203c 7061 7261 3e58 4d4c 2065 6e74 6974 XML entit │ │ │ -00201930: 7920 7375 6368 2061 7320 7468 6174 2072 y such as that r │ │ │ -00201940: 6574 7572 6e65 6420 6279 203c 6675 6e63 eturned by xtree_doc() │ │ │ -00201960: 3c2f 6675 6e63 7469 6f6e 3e3c 2f70 6172 . │ │ │ -00201980: 2020 3c72 6566 7365 6374 323e 3c74 6974 parameters. Vector or name │ │ │ -002019c0: 2d76 616c 7565 2070 6169 7273 3a20 7665 -value pairs: ve │ │ │ -002019d0: 6374 6f72 2827 6e61 6d65 3127 2c20 2776 ctor('name1', 'v │ │ │ -002019e0: 616c 7565 3127 2c20 276e 616d 6532 272c alue1', 'name2', │ │ │ -002019f0: 2027 7661 6c75 6532 272c 202e 2e2e 292e 'value2', ...). │ │ │ -00201a00: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . session< │ │ │ -00201a30: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -00201a40: 6172 613e 4f75 7470 7574 2073 7472 6561 ara>Output strea │ │ │ -00201a50: 6d20 666f 7220 6861 6e64 6c69 6e67 2074 m for handling t │ │ │ -00201a60: 6865 2072 6573 756c 7473 206f 6620 584d he results of XM │ │ │ -00201a70: 4c20 7465 6d70 6c61 7465 2e20 2049 6620 L template. If │ │ │ -00201a80: 7468 6973 200a 2020 2020 2020 7061 7261 this . para │ │ │ -00201a90: 6d65 7465 7220 6973 2075 6e73 7065 6369 meter is unspeci │ │ │ -00201aa0: 6669 6564 2074 6865 6e20 7468 6520 4854 fied then the HT │ │ │ -00201ab0: 5450 2069 6e74 6572 6e61 6c20 7374 7265 TP internal stre │ │ │ -00201ac0: 616d 2077 696c 6c20 6265 2061 7373 756d am will be assum │ │ │ -00201ad0: 6564 2c20 0a20 2020 2020 2077 6869 6368 ed, . which │ │ │ -00201ae0: 2069 6620 6e6f 7420 6170 706c 6963 6162 if not applicab │ │ │ -00201af0: 6c65 2077 696c 6c20 7369 676e 616c 2061 le will signal a │ │ │ -00201b00: 6e20 6572 726f 722e 3c2f 7061 7261 3e3c n error.</para>< │ │ │ -00201b10: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ -00201b20: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -00201b30: 6563 7431 2069 643d 2272 6574 5f78 6d6c ect1 id="ret_xml │ │ │ -00201b40: 5f74 656d 706c 6174 6522 3e3c 7469 746c _template"><titl │ │ │ -00201b50: 653e 5265 7475 726e 2054 7970 6573 3c2f e>Return Types</ │ │ │ -00201b60: 7469 746c 653e 0a20 2020 203c 7061 7261 title>. <para │ │ │ -00201b70: 3e41 2055 524c 206f 6620 7468 6520 5853 >A URL of the XS │ │ │ -00201b80: 4c54 2073 7479 6c65 7368 6565 7420 666f LT stylesheet fo │ │ │ -00201b90: 7220 6675 7274 6865 7220 7472 616e 7366 r further transf │ │ │ -00201ba0: 6f72 6d61 7469 6f6e 2077 696c 6c20 6265 ormation will be │ │ │ -00201bb0: 200a 2020 2020 7265 7475 726e 6564 2e20 . returned. │ │ │ -00201bc0: 2049 6620 7873 6c20 6174 7472 6962 7574 If xsl attribut │ │ │ -00201bd0: 6520 7761 7320 6e6f 7420 7370 6563 6966 e was not specif │ │ │ -00201be0: 6965 6420 696e 2074 6865 2058 4d4c 2074 ied in the XML t │ │ │ -00201bf0: 656d 706c 6174 6520 7468 656e 2074 6865 emplate then the │ │ │ -00201c00: 200a 2020 2020 7265 7475 726e 2076 616c . return val │ │ │ -00201c10: 7565 2077 696c 6c20 6265 204e 554c 4c2e ue will be NULL. │ │ │ -00201c20: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 </para>. </refs │ │ │ -00201c30: 6563 7431 3e0a 3c21 2d2d 0a3c 7265 6673 ect1>.<!--.<refs │ │ │ -00201c40: 6563 7431 2069 643d 2265 7272 6f72 735f ect1 id="errors_ │ │ │ -00201c50: 223e 0a20 2020 203c 7469 746c 653e 4572 ">. <title>Er │ │ │ -00201c60: 726f 7273 3c2f 7469 746c 653e 0a20 2020 rors. │ │ │ -00201c70: 203c 7461 626c 653e 0a20 2020 2020 203c . < │ │ │ -00201c80: 7469 746c 653e 4572 726f 7273 2073 6967 title>Errors sig │ │ │ -00201c90: 6e61 6c6c 6564 2062 793c 2f74 6974 6c65 nalled by. . │ │ │ -00201cc0: 203c 7468 6561 643e 0a20 2020 2020 2020 . │ │ │ -00201cd0: 2020 3c72 6f77 3e0a 2020 2020 2020 2020 . │ │ │ -00201ce0: 2020 203c 656e 7472 793e 5351 4c53 7461 SQLSta │ │ │ -00201cf0: 7465 3c2f 656e 7472 793e 0a20 2020 2020 te. │ │ │ -00201d00: 2020 2020 2020 3c65 6e74 7279 3e45 7272 Err │ │ │ -00201d10: 6f72 2043 6f64 653c 2f65 6e74 7279 3e0a or Code. │ │ │ -00201d20: 2020 2020 2020 2020 2020 203c 656e 7472 Error Text. │ │ │ -00201d50: 3c65 6e74 7279 3e44 6573 6372 6970 7469 Descripti │ │ │ -00201d60: 6f6e 3c2f 656e 7472 793e 3c2f 726f 773e on │ │ │ -00201d70: 3c2f 7468 6561 643e 0a09 3c74 626f 6479 .... .. │ │ │ -00201d90: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 .. .. < │ │ │ -00201df0: 6572 726f 726e 616d 653e 3c2f 6572 726f errorname>.. │ │ │ -00201e10: 2020 2020 3c65 6e74 7279 3e3c 2f65 6e74 .. ..< │ │ │ -00201e30: 2f74 626f 6479 3e0a 2020 2020 2020 3c2f /tbody>. . . . . < │ │ │ -00201e90: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. . │ │ │ -00201ed0: 2020 203c 7061 7261 3e3c 2f70 6172 613e │ │ │ -00201ee0: 0a20 2020 2020 203c 7363 7265 656e 3e3c . < │ │ │ -00201ef0: 215b 4344 4154 415b 0a5d 5d3e 0a3c 2f73 ![CDATA[.]]>.. . . . < │ │ │ -00201f50: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also. │ │ │ -00201fa0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . -->......'demo/ │ │ │ -00201fd0: 646f 6373 7263 2f66 756e 6372 6566 2f78 docsrc/funcref/x │ │ │ -00201fe0: 6d6c 5f73 6574 5f6e 735f 6465 636c 2e78 ml_set_ns_decl.x │ │ │ -00201ff0: 6d6c df00 000b ee3c 3f78 6d6c 2076 6572 ml........ . xml_set_ │ │ │ -002023c0: 6e73 5f64 6563 6c3c 2f72 6566 656e 7472 ns_decl. xml. . . xml_set_ns_d │ │ │ -00202430: 6563 6c3c 2f72 6566 6e61 6d65 3e0a 2020 ecl. │ │ │ -00202440: 2020 3c72 6566 7075 7270 6f73 653e 5265 Re │ │ │ -00202450: 6769 7374 6572 7320 7468 6520 584d 4c20 gisters the XML │ │ │ -00202460: 4e53 2070 7265 6669 7820 6173 2070 6572 NS prefix as per │ │ │ -00202470: 7369 7374 656e 7420 6f72 206b 6565 7073 sistent or keeps │ │ │ -00202480: 2069 7420 696e 2070 726f 7065 7274 6965 it in propertie │ │ │ -00202490: 7320 6f66 2063 6c69 656e 740a 636f 6e6e s of client.conn │ │ │ -002024a0: 6563 7469 6f6e 2064 6570 656e 6469 6e67 ection depending │ │ │ -002024b0: 206f 6e20 7468 6520 7065 7273 6973 7461 on the persista │ │ │ -002024c0: 6e63 6520 6269 7473 2069 6e70 7574 2076 nce bits input v │ │ │ -002024d0: 616c 7565 2e3c 2f72 6566 7075 7270 6f73 alue.. . . . . │ │ │ -00202580: 786d 6c5f 7365 745f 6e73 5f64 6563 6c3c xml_set_ns_decl< │ │ │ -00202590: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>. in prefix varchar< │ │ │ -002025e0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -002025f0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -00202600: 3c70 6172 616d 6574 6572 3e69 7269 3c2f iri varch │ │ │ -00202620: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -00202630: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -00202640: 696e 203c 7061 7261 6d65 7465 723e 6269 in bi │ │ │ -00202650: 7473 3c2f 7061 7261 6d65 7465 723e 2069 ts i │ │ │ -00202660: 6e74 6567 6572 3c2f 7061 7261 6d64 6566 nteger. . . . │ │ │ -002026b0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Des │ │ │ -002026d0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -002026e0: 0a20 2020 203c 7061 7261 3e52 6567 6973 . Regis │ │ │ -002026f0: 7465 7273 2074 6865 2058 4d4c 204e 5320 ters the XML NS │ │ │ -00202700: 7072 6566 6978 2061 7320 7065 7273 6973 prefix as persis │ │ │ -00202710: 7465 6e74 206f 7220 6b65 6570 7320 6974 tent or keeps it │ │ │ -00202720: 2069 6e20 7072 6f70 6572 7469 6573 206f in properties o │ │ │ -00202730: 6620 636c 6965 6e74 0a63 6f6e 6e65 6374 f client.connect │ │ │ -00202740: 696f 6e20 6465 7065 6e64 696e 6720 6f6e ion depending on │ │ │ -00202750: 2074 6865 2070 6572 7369 7374 616e 6365 the persistance │ │ │ -00202760: 2062 6974 7320 696e 7075 7420 7661 6c75 bits input valu │ │ │ -00202770: 652e 3c2f 7061 7261 3e0a 2020 3c2f 7265 e.. . │ │ │ -002027a0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ -002027b0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. p │ │ │ -002027d0: 7265 6669 783c 2f74 6974 6c65 3e0a 2020 refix. │ │ │ -002027e0: 2020 2020 3c70 6172 613e 6e61 6d65 7370 namesp │ │ │ -002027f0: 6163 6520 7072 6566 6978 3c2f 7061 7261 ace prefix. │ │ │ -00202810: 203c 7265 6673 6563 7432 3e3c 7469 746c iri. │ │ │ -00202830: 2020 2020 3c70 6172 613e 6e61 6d65 7370 namesp │ │ │ -00202840: 6163 6520 4952 493c 2f70 6172 613e 3c2f ace IRI. b │ │ │ -00202870: 6974 733c 2f74 6974 6c65 3e0a 2020 2020 its. │ │ │ -00202880: 2020 3c70 6172 613e 7065 7273 6973 7461 persista │ │ │ -00202890: 6e63 6520 6269 7473 3a20 6269 7420 3120 nce bits: bit 1 │ │ │ -002028a0: 202d 206b 6565 7073 204e 5320 6465 636c - keeps NS decl │ │ │ -002028b0: 2069 6e20 7072 6f70 6572 7469 6573 206f in properties o │ │ │ -002028c0: 6620 636c 6965 6e74 2063 6f6e 6e65 6374 f client connect │ │ │ -002028d0: 696f 6e0a 692e 6520 7374 6f72 6573 2074 ion.i.e stores t │ │ │ -002028e0: 6865 2061 7373 6967 6e6d 656e 7420 696e he assignment in │ │ │ -002028f0: 2063 6f6e 6e65 6374 696f 6e20 7061 7261 connection para │ │ │ -00202900: 6d65 7465 7273 2073 6f20 6f6e 6c79 2074 meters so only t │ │ │ -00202910: 6865 2063 7572 7265 6e74 2063 6f6e 6e65 he current conne │ │ │ -00202920: 6374 696f 6e20 7769 6c6c 0a73 6565 2074 ction will.see t │ │ │ -00202930: 6865 206e 616d 6573 7061 6365 2070 7265 he namespace pre │ │ │ -00202940: 6669 7820 6465 636c 6172 6174 696f 6e3b fix declaration; │ │ │ -00202950: 0a62 6974 2032 202d 206d 616b 6573 204e .bit 2 - makes N │ │ │ -00202960: 5320 6465 636c 2070 6572 7369 7374 656e S decl persisten │ │ │ -00202970: 742c 2069 2e65 2e20 7374 6f72 6573 2074 t, i.e. stores t │ │ │ -00202980: 6865 2064 6563 6c61 7261 7469 6f6e 2069 he declaration i │ │ │ -00202990: 6e20 676c 6f62 616c 2069 6e2d 6d65 6d6f n global in-memo │ │ │ -002029a0: 7279 2068 6173 6874 6162 6c65 0a61 7320 ry hashtable.as │ │ │ -002029b0: 7765 6c6c 2061 7320 696e 2061 2073 7973 well as in a sys │ │ │ -002029c0: 7465 6d20 7461 626c 652c 206c 6f61 6465 tem table, loade │ │ │ -002029d0: 6420 6174 2073 6572 7665 7220 7374 6172 d at server star │ │ │ -002029e0: 7475 7020 7469 6d65 2c20 7669 7369 626c tup time, visibl │ │ │ -002029f0: 6520 6672 6f6d 2061 6c6c 2063 6f6e 6e65 e from all conne │ │ │ -00202a00: 6374 696f 6e73 3c2f 7061 7261 3e3c 2f72 ctions. . Examples │ │ │ -00202a50: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . < │ │ │ -00202a80: 7469 746c 653e 4e6f 7274 6877 696e 643c title>Northwind< │ │ │ -00202a90: 2f74 6974 6c65 3e0a 3c70 726f 6772 616d /title>.< │ │ │ -00202b10: 2f70 726f 6772 616d 6c69 7374 696e 673e /programlisting> │ │ │ -00202b20: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -00202b30: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00202b40: 3c72 6566 7365 6374 3120 6964 3d22 7365 Se │ │ │ -00202b60: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ -00202b70: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_remove_n │ │ │ -00202bb0: 735f 6279 5f70 7265 6669 783c 2f6c 696e s_by_prefix. ......./demo/d │ │ │ -00202bf0: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ -00202c00: 6c5f 7265 6d6f 7665 5f6e 735f 6279 5f70 l_remove_ns_by_p │ │ │ -00202c10: 7265 6669 782e 786d 6cdf 0000 0a34 3c3f refix.xml....4... . xml_remov │ │ │ -00202ff0: 655f 6e73 5f62 795f 7072 6566 6978 3c2f e_ns_by_prefix. │ │ │ -00203010: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ -00203020: 786d 6c3c 2f72 6566 6d69 7363 696e 666f xml. . │ │ │ -00203040: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -00203050: 2020 3c72 6566 6e61 6d65 3e78 6d6c 5f72 xml_r │ │ │ -00203060: 656d 6f76 655f 6e73 5f62 795f 7072 6566 emove_ns_by_pref │ │ │ -00203070: 6978 3c2f 7265 666e 616d 653e 0a20 2020 ix. │ │ │ -00203080: 3c72 6566 7075 7270 6f73 653e 5265 6d6f Remo │ │ │ -00203090: 7665 7320 7468 6520 7265 6769 7374 7261 ves the registra │ │ │ -002030a0: 7469 6f6e 206f 6620 6120 6e61 6d65 7370 tion of a namesp │ │ │ -002030b0: 6163 6520 7072 6566 6978 2e3c 2f72 6566 ace prefix.. . . │ │ │ -002030f0: 3c66 756e 6373 796e 6f70 7369 7320 6964 │ │ │ -00203120: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . │ │ │ -00203160: 2020 203c 6675 6e63 6465 663e 3c66 756e xml_remove │ │ │ -00203180: 5f6e 735f 6279 5f70 7265 6669 783c 2f66 _ns_by_prefix. in prefix varchar

    . │ │ │ -002031f0: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    persist │ │ │ -00203210: 3c2f 7061 7261 6d65 7465 723e 2069 6e74 int │ │ │ -00203220: 6567 6572 3c2f 7061 7261 6d64 6566 3e0a eger. │ │ │ -00203230: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -00203270: 3c72 6566 7365 6374 3120 6964 3d22 6465 Descr │ │ │ -00203290: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ -002032a0: 2020 203c 7061 7261 3e43 616e 6365 6c20 Cancel │ │ │ -002032b0: 7468 6520 7265 6769 7374 7261 7469 6f6e the registration │ │ │ -002032c0: 206f 6620 6120 6e61 6d65 7370 6163 6520 of a namespace │ │ │ -002032d0: 7072 6566 6978 2020 646f 6e65 2077 6974 prefix done wit │ │ │ -002032e0: 680a 3c6c 696e 6b20 6c69 6e6b 656e 643d h.xm │ │ │ -00203300: 6c5f 7365 745f 6e73 5f64 6563 6c28 293c l_set_ns_decl()< │ │ │ -00203310: 2f6c 696e 6b3e 2e3c 2f70 6172 613e 0a20 /link>.. │ │ │ -00203320: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -00203330: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -00203340: 616d 7322 3e3c 7469 746c 653e 5061 7261 ams">Para │ │ │ -00203350: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ -00203360: 2020 203c 7265 6673 6563 7432 3e3c 7469 prefix. n │ │ │ -00203390: 616d 6573 7061 6365 2070 7265 6669 783c amespace prefix< │ │ │ -002033a0: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ -002033c0: 3c74 6974 6c65 3e70 6572 7369 7374 3c2f persist</ │ │ │ -002033d0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -002033e0: 7261 3e70 6572 7369 7374 616e 6365 2062 ra>persistance b │ │ │ -002033f0: 6974 733a 2062 6974 2031 2020 2d20 7265 its: bit 1 - re │ │ │ -00203400: 6d6f 7665 7320 636f 6e6e 6563 7469 6f6e moves connection │ │ │ -00203410: 2d73 7065 6369 6669 6320 6465 636c 6172 -specific declar │ │ │ -00203420: 6174 696f 6e3b 0a62 6974 2032 202d 2072 ation;.bit 2 - r │ │ │ -00203430: 656d 6f76 6573 2067 6c6f 6261 6c20 6f6e emoves global on │ │ │ -00203440: 653b 2062 6974 2033 202d 2062 6f74 682e e; bit 3 - both. │ │ │ -00203450: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 </para></refsect │ │ │ -00203460: 323e 0a20 203c 2f72 6566 7365 6374 313e 2>. </refsect1> │ │ │ -00203470: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ -00203480: 2265 7861 6d70 6c65 7322 3e3c 7469 746c "examples"><titl │ │ │ -00203490: 653e 4578 616d 706c 6573 3c2f 7469 746c e>Examples</titl │ │ │ -002034a0: 653e 0a20 2020 203c 6578 616d 706c 6520 e>. <example │ │ │ -002034b0: 6964 3d22 6578 5f78 6d6c 5f72 656d 6f76 id="ex_xml_remov │ │ │ -002034c0: 655f 6e73 5f6e 6f72 7468 223e 3c74 6974 e_ns_north"><tit │ │ │ -002034d0: 6c65 3e4e 6f72 7468 7769 6e64 3c2f 7469 le>Northwind</ti │ │ │ -002034e0: 746c 653e 0a3c 7072 6f67 7261 6d6c 6973 tle>.<programlis │ │ │ -002034f0: 7469 6e67 3e3c 215b 4344 4154 415b 0a44 ting><![CDATA[.D │ │ │ -00203500: 422e 4442 412e 584d 4c5f 5345 545f 4e53 B.DBA.XML_SET_NS │ │ │ -00203510: 5f44 4543 4c20 2827 6e6f 7274 6877 696e _DECL ('northwin │ │ │ -00203520: 6427 2c20 2768 7474 703a 2f2f 6465 6d6f d', 'http://demo │ │ │ -00203530: 2e6f 7065 6e6c 696e 6b73 772e 636f 6d2f .openlinksw.com/ │ │ │ -00203540: 7363 6865 6d61 732f 6e6f 7274 6877 696e schemas/northwin │ │ │ -00203550: 6423 272c 2032 293b 0a44 422e 4442 412e d#', 2);.DB.DBA. │ │ │ -00203560: 584d 4c5f 5245 4d4f 5645 5f4e 535f 4259 XML_REMOVE_NS_BY │ │ │ -00203570: 5f50 5245 4649 5828 276e 6f72 7468 7769 _PREFIX('northwi │ │ │ -00203580: 6e64 272c 2032 293b 0a5d 5d3e 3c2f 7072 nd', 2);.]]></pr │ │ │ -00203590: 6f67 7261 6d6c 6973 7469 6e67 3e0a 2020 ogramlisting>. │ │ │ -002035a0: 2020 3c2f 6578 616d 706c 653e 0a20 203c </example>. < │ │ │ -002035b0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. <re │ │ │ -002035c0: 6673 6563 7431 2069 643d 2273 6565 616c fsect1 id="seeal │ │ │ -002035d0: 736f 223e 3c74 6974 6c65 3e53 6565 2041 so"><title>See A │ │ │ -002035e0: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -002035f0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xml_set │ │ │ -00203620: 5f6e 735f 6465 636c 3c2f 6c69 6e6b 3e3c _ns_decl< │ │ │ -00203630: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -00203650: 0a0a b600 0000 2664 656d 6f2f 646f 6373 ......&demo/docs │ │ │ -00203660: 7263 2f66 756e 6372 6566 2f78 6d6c 5f70 rc/funcref/xml_p │ │ │ -00203670: 6572 7369 7374 656e 742e 786d 6cdf 0000 ersistent.xml... │ │ │ -00203680: 15d1 3c3f 786d 6c20 7665 7273 696f 6e3d ....< │ │ │ -00203a10: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ -00203a20: 786d 6c5f 7065 7273 6973 7465 6e74 223e xml_persistent"> │ │ │ -00203a30: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -00203a40: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -00203a50: 786d 6c5f 7065 7273 6973 7465 6e74 3c2f xml_persistent. │ │ │ -00203a70: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ -00203a80: 786d 6c3c 2f72 6566 6d69 7363 696e 666f xml. . │ │ │ -00203aa0: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -00203ab0: 2020 3c72 6566 6e61 6d65 3e78 6d6c 5f70 xml_p │ │ │ -00203ac0: 6572 7369 7374 656e 743c 2f72 6566 6e61 ersistent. returns an e │ │ │ -00203af0: 6e74 6974 7920 6f62 6a65 6374 2028 2758 ntity object ('X │ │ │ -00203b00: 5045 5220 656e 7469 7479 2729 2063 7265 PER entity') cre │ │ │ -00203b10: 6174 6564 2066 726f 6d20 6769 7665 6e20 ated from given │ │ │ -00203b20: 584d 4c20 646f 6375 6d65 6e74 3c2f 7265 XML document. . . │ │ │ -00203b60: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . < │ │ │ -00203b90: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -00203ba0: 3d22 6670 726f 746f 5f78 6d6c 5f70 6572 ="fproto_xml_per │ │ │ -00203bb0: 7369 7374 656e 7422 3e0a 2020 2020 2020 sistent">. │ │ │ -00203bc0: 2020 3c66 756e 6364 6566 3e3c 6675 6e63 xml_persist │ │ │ -00203be0: 656e 743c 2f66 756e 6374 696f 6e3e 3c2f ent. │ │ │ -00203c00: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    documen │ │ │ -00203c20: 743c 2f70 6172 616d 6574 6572 3e20 7661 t va │ │ │ -00203c30: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ -00203c40: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in │ │ │ -00203c60: 3c70 6172 616d 6574 6572 3e70 6172 7365 parse │ │ │ -00203c70: 725f 6d6f 6465 3c2f 7061 7261 6d65 7465 r_mode integer │ │ │ -00203ca0: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in │ │ │ -00203cc0: 3c70 6172 616d 6574 6572 3e62 6173 655f base_ │ │ │ -00203cd0: 7572 693c 2f70 6172 616d 6574 6572 3e20 uri │ │ │ -00203ce0: 7661 7263 6861 723c 2f6f 7074 696f 6e61 varchar. │ │ │ -00203d00: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -00203d10: 3c6f 7074 696f 6e61 6c3e 696e 203c 7061 in content_ │ │ │ -00203d30: 656e 636f 6469 6e67 3c2f 7061 7261 6d65 encoding varchar. i │ │ │ -00203d80: 6e20 3c70 6172 616d 6574 6572 3e63 6f6e n con │ │ │ -00203d90: 7465 6e74 5f6c 616e 6775 6167 653c 2f70 tent_language

    varcha │ │ │ -00203db0: 723c 2f6f 7074 696f 6e61 6c3e 3c2f 7061 r. │ │ │ -00203dd0: 3c70 6172 616d 6465 663e 3c6f 7074 696f in dtd_validator_ │ │ │ -00203e00: 636f 6e66 6967 3c2f 7061 7261 6d65 7465 config varchar │ │ │ -00203e30: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ -00203e70: 2020 3c72 6566 7365 6374 3120 6964 3d22 Desc │ │ │ -00203ea0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -00203eb0: 2020 2020 3c70 6172 613e 5468 6973 2070 This p │ │ │ -00203ec0: 6172 7365 7320 7468 6520 6172 6775 6d65 arses the argume │ │ │ -00203ed0: 6e74 2c20 7768 6963 6820 6973 2065 7870 nt, which is exp │ │ │ -00203ee0: 6563 7465 6420 746f 2062 6520 6120 7765 ected to be a we │ │ │ -00203ef0: 6c6c 2066 6f72 6d65 6420 584d 4c20 6672 ll formed XML fr │ │ │ -00203f00: 6167 6d65 6e74 2061 6e64 2072 6574 7572 agment and retur │ │ │ -00203f10: 6e73 2061 2070 6172 7365 2074 7265 6520 ns a parse tree │ │ │ -00203f20: 6173 2061 2073 7065 6369 616c 0a20 2020 as a special. │ │ │ -00203f30: 2009 6f62 6a65 6374 2077 6974 6820 756e .object with un │ │ │ -00203f40: 6465 726c 7969 6e67 2064 6973 6b20 7374 derlying disk st │ │ │ -00203f50: 7275 6374 7572 652c 206e 616d 6564 2022 ructure, named " │ │ │ -00203f60: 7065 7273 6973 7465 6e74 2058 4d4c 2220 persistent XML" │ │ │ -00203f70: 6f72 2022 5850 4552 2220 5768 696c 6520 or "XPER" While │ │ │ -00203f80: 7468 6520 7265 7375 6c74 206f 660a 2020 the result of. │ │ │ -00203f90: 2020 093c 6c69 6e6b 206c 696e 6b65 6e64 .< │ │ │ -00203fb0: 6675 6e63 7469 6f6e 3e78 6d6c 5f74 7265 function>xml_tre │ │ │ -00203fc0: 6528 293c 2f66 756e 6374 696f 6e3e 3c2f e() is a memor │ │ │ -00203fe0: 792d 7265 7369 6465 6e74 2061 7272 6179 y-resident array │ │ │ -00203ff0: 206f 6620 7665 6374 6f72 732c 2074 6865 of vectors, the │ │ │ -00204000: 2058 5045 520a 2020 2020 096f 626a 6563 XPER. .objec │ │ │ -00204010: 7420 636f 6e73 756d 6573 206f 6e6c 7920 t consumes only │ │ │ -00204020: 6120 6c69 7474 6c65 2061 6d6f 756e 7420 a little amount │ │ │ -00204030: 6f66 206d 656d 6f72 792c 2061 6e64 2061 of memory, and a │ │ │ -00204040: 6c6d 6f73 7420 616c 6c20 6461 7461 2069 lmost all data i │ │ │ -00204050: 7320 6469 736b 2d72 6573 6964 656e 742e s disk-resident. │ │ │ -00204060: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . This function │ │ │ -00204080: 6973 2065 7175 6976 616c 656e 7420 746f is equivalent to │ │ │ -00204090: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 xper_doc( │ │ │ -002040c0: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 ), and the onl │ │ │ -002040e0: 790a 6469 6666 6572 656e 6365 2069 7320 y.difference is │ │ │ -002040f0: 696e 2074 6865 206f 7264 6572 206f 6620 in the order of │ │ │ -00204100: 6172 6775 6d65 6e74 733b 2078 7065 725f arguments; xper_ │ │ │ -00204110: 646f 6328 2920 6861 7320 7468 6520 7361 doc() has the sa │ │ │ -00204120: 6d65 206f 7264 6572 206f 6620 6172 6775 me order of argu │ │ │ -00204130: 6d65 6e74 7320 6173 0a20 2020 203c 6c69 ments as.
  • xml_tree(). │ │ │ -00204180: 0a09 3c2f 7061 7261 3e0a 2020 3c2f 7265 ... . < │ │ │ -002041c0: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ -002041d0: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . do │ │ │ -002041f0: 6375 6d65 6e74 203c 2f74 6974 6c65 3e0a cument . │ │ │ -00204200: 2020 2020 2020 3c70 6172 613e 7765 6c6c well │ │ │ -00204210: 2066 6f72 6d65 6420 584d 4c20 6f72 2048 formed XML or H │ │ │ -00204220: 544d 4c20 646f 6375 6d65 6e3c 2f70 6172 TML documen. │ │ │ -00204240: 2020 3c72 6566 7365 6374 323e 3c74 6974 parser_mode. 0, 1 or 2; 0 │ │ │ -00204280: 2d20 584d 4c20 7061 7273 6572 206d 6f64 - XML parser mod │ │ │ -00204290: 652c 2031 202d 2048 544d 4c20 7061 7273 e, 1 - HTML pars │ │ │ -002042a0: 6572 206d 6f64 652c 2032 202d 2027 6469 er mode, 2 - 'di │ │ │ -002042b0: 7274 7920 4854 4d4c 2720 6d6f 6465 2028 rty HTML' mode ( │ │ │ -002042c0: 7769 7468 2071 7569 6574 2072 6563 6f76 with quiet recov │ │ │ -002042d0: 6572 7920 6166 7465 7220 616e 7920 7379 ery after any sy │ │ │ -002042e0: 6e74 6178 0a20 2020 2020 2009 6572 726f ntax. .erro │ │ │ -002042f0: 7229 3c2f 7061 7261 3e3c 2f72 6566 7365 r). base_u │ │ │ -00204320: 7269 3c2f 7469 746c 653e 0a20 2020 2020 ri. │ │ │ -00204330: 203c 7061 7261 3e69 6e20 4854 4d4c 2070 in HTML p │ │ │ -00204340: 6172 7365 7220 6d6f 6465 2063 6861 6e67 arser mode chang │ │ │ -00204350: 6520 616c 6c20 6162 736f 6c75 7465 2072 e all absolute r │ │ │ -00204360: 6566 6572 656e 6365 7320 746f 2072 656c eferences to rel │ │ │ -00204370: 6174 6976 6520 6672 6f6d 2067 6976 656e ative from given │ │ │ -00204380: 2062 6173 655f 7572 690a 2020 2020 2020 base_uri. │ │ │ -00204390: 0928 6874 7470 3a2f 2f26 6c74 3b68 6f73 .(http://<hos │ │ │ -002043a0: 7426 6774 3b3a 266c 743b 706f 7274 2667 t>:<port&g │ │ │ -002043b0: 743b 2f26 6c74 3b70 6174 6826 6774 3b29 t;/<path>) │ │ │ -002043c0: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . content_ │ │ │ -002043f0: 656e 636f 6469 6e67 3c2f 7469 746c 653e encoding │ │ │ -00204400: 0a20 2020 2020 203c 7061 7261 3e73 7472 . str │ │ │ -00204410: 696e 6720 7769 7468 2063 6f6e 7465 6e74 ing with content │ │ │ -00204420: 2065 6e63 6f64 696e 6720 7479 7065 206f encoding type o │ │ │ -00204430: 6620 266c 743b 646f 6375 6d65 6e74 2667 f <document&g │ │ │ -00204440: 743b 3b20 7661 6c69 6420 6172 6520 2741 t;; valid are 'A │ │ │ -00204450: 5343 4949 272c 2027 4953 4f27 2c20 2755 SCII', 'ISO', 'U │ │ │ -00204460: 5446 3827 2c20 2749 534f 3838 3539 2d31 TF8', 'ISO8859-1 │ │ │ -00204470: 272c 2027 4c41 5449 4e2d 3127 0a20 2020 ', 'LATIN-1'. │ │ │ -00204480: 2020 2009 6574 632e 2c20 6465 6661 756c .etc., defaul │ │ │ -00204490: 7473 2061 7265 2027 5554 462d 3827 2066 ts are 'UTF-8' f │ │ │ -002044a0: 6f72 2058 4d4c 206d 6f64 6520 616e 6420 or XML mode and │ │ │ -002044b0: 274c 4154 494e 2d31 2720 666f 7220 4854 'LATIN-1' for HT │ │ │ -002044c0: 4d4c 206d 6f64 653c 2f70 6172 613e 3c2f ML mode. c │ │ │ -002044f0: 6f6e 7465 6e74 5f6c 616e 6775 6167 653c ontent_language< │ │ │ -00204500: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -00204510: 6172 613e 7374 7269 6e67 2077 6974 6820 ara>string with │ │ │ -00204520: 6c61 6e67 7561 6765 2074 6167 206f 6620 language tag of │ │ │ -00204530: 636f 6e74 656e 7420 6f66 2026 6c74 3b64 content of <d │ │ │ -00204540: 6f63 756d 656e 7426 6774 3b3b 2076 616c ocument>; val │ │ │ -00204550: 6964 206e 616d 6573 2061 7265 206c 6973 id names are lis │ │ │ -00204560: 7465 6420 696e 2049 4554 4620 5246 4320 ted in IETF RFC │ │ │ -00204570: 3137 3636 2c20 6465 6661 756c 7420 6973 1766, default is │ │ │ -00204580: 0a20 2020 2020 2009 2778 2d61 6e79 2720 . .'x-any' │ │ │ -00204590: 2869 7420 6d65 616e 7320 276d 6978 206f (it means 'mix o │ │ │ -002045a0: 6620 776f 7264 7320 6672 6f6d 2076 6172 f words from var │ │ │ -002045b0: 696f 7573 2068 756d 616e 206c 616e 6775 ious human langu │ │ │ -002045c0: 6167 6573 293c 2f70 6172 613e 3c2f 7265 ages)</para></re │ │ │ -002045d0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ -002045e0: 7365 6374 323e 3c74 6974 6c65 3e64 7464 sect2><title>dtd │ │ │ -002045f0: 5f76 616c 6964 6174 6f72 5f63 6f6e 6669 _validator_confi │ │ │ -00204600: 673c 2f74 6974 6c65 3e0a 2020 2020 2020 g. │ │ │ -00204610: 3c70 6172 613e 636f 6e66 6967 7572 6174 configurat │ │ │ -00204620: 696f 6e20 7374 7269 6e67 2066 6f72 2074 ion string for t │ │ │ -00204630: 6865 2044 5444 2076 616c 6964 6174 6f72 he DTD validator │ │ │ -00204640: 2c20 6465 6661 756c 7420 6973 2065 6d70 , default is emp │ │ │ -00204650: 7479 2073 7472 696e 6720 6d65 616e 696e ty string meanin │ │ │ -00204660: 6720 7468 6174 2044 5444 2076 616c 6964 g that DTD valid │ │ │ -00204670: 6174 6f72 2073 686f 756c 6420 6265 2066 ator should be f │ │ │ -00204680: 756c 6c79 0a20 2020 2020 2009 6469 7361 ully. .disa │ │ │ -00204690: 626c 6564 2e20 5365 6520 3c6c 696e 6b20 bled. See Configurati │ │ │ -002046c0: 6f6e 204f 7074 696f 6e73 206f 6620 7468 on Options of th │ │ │ -002046d0: 6520 4454 4420 5661 6c69 6461 746f 723c e DTD Validator< │ │ │ -002046e0: 2f6c 696e 6b3e 2066 6f72 2064 6574 6169 /link> for detai │ │ │ -002046f0: 6c73 2e3c 2f70 6172 613e 3c2f 7265 6673 ls.. . R │ │ │ -00204740: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ -00204750: 6c65 3e0a 2020 3c70 6172 613e 5061 7273 le>. <para>Pars │ │ │ -00204760: 6520 7472 6565 2061 7320 6120 7374 7275 e tree as a stru │ │ │ -00204770: 6374 7572 6520 6f66 206e 6573 7465 6420 cture of nested │ │ │ -00204780: 6865 7465 726f 6765 6e65 6f75 7320 7665 heterogeneous ve │ │ │ -00204790: 6374 6f72 732e 3c2f 7061 7261 3e3c 2f72 ctors.</para></r │ │ │ -002047a0: 6566 7365 6374 313e 0a3c 212d 2d0a 2020 efsect1>.<!--. │ │ │ -002047b0: 3c72 6566 7365 6374 3120 6964 3d22 6572 <refsect1 id="er │ │ │ -002047c0: 726f 7273 5f78 6d6c 5f70 6572 7369 7374 rors_xml_persist │ │ │ -002047d0: 656e 7422 3e3c 7469 746c 653e 4572 726f ent"><title>Erro │ │ │ -002047e0: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -002047f0: 7461 626c 653e 3c74 6974 6c65 3e45 7272 table>Err │ │ │ -00204800: 6f72 7320 7369 676e 616c 6c65 6420 6279 ors signalled by │ │ │ -00204810: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00204820: 7467 726f 7570 2063 6f6c 733d 2234 223e tgroup cols="4"> │ │ │ -00204830: 0a20 2020 2020 2020 3c74 6865 6164 3e3c .
  • < │ │ │ -00204840: 726f 773e 3c65 6e74 7279 3e53 514c 5374 row>SQLSt │ │ │ -00204850: 6174 653c 2f65 6e74 7279 3e3c 656e 7472 ateError CodeError │ │ │ -00204880: 2054 6578 743c 2f65 6e74 7279 3e3c 656e TextDescription< │ │ │ -002048a0: 2f65 6e74 7279 3e3c 2f72 6f77 3e3c 2f74 /entry>.... │ │ │ -002048c0: 2020 3c72 6f77 3e0a 0920 2020 203c 656e .. < │ │ │ -002048e0: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode>.. │ │ │ -00204900: 3c65 7272 6f72 636f 6465 3e3c 2f65 7272 . │ │ │ -00204920: 0920 2020 203c 656e 7472 793e 3c65 7272 . .. │ │ │ -00204950: 203c 656e 7472 793e 3c2f 656e 7472 793e │ │ │ -00204960: 0a09 2020 3c2f 726f 773e 0a09 3c2f 7462 .. ... .
    .
    . │ │ │ -002049a0: 2d2d 3e0a 2020 3c72 6566 7365 6374 3120 -->. Examples. │ │ │ -00204a10: 584d 4c5f 5065 7273 6973 7465 6e74 3c2f XML_Persistent</ │ │ │ -00204a20: 7469 746c 653e 0a20 2020 2020 203c 7363 title>. <sc │ │ │ -00204a30: 7265 656e 3e64 6563 6c61 7265 2074 7265 reen>declare tre │ │ │ -00204a40: 6520 616e 793b 0a0a 7472 6565 203a 3d20 e any;..tree := │ │ │ -00204a50: 786d 6c5f 7065 7273 6973 7465 6e74 2028 xml_persistent ( │ │ │ -00204a60: 6669 6c65 5f74 6f5f 7374 7269 6e67 2028 file_to_string ( │ │ │ -00204a70: 2764 6f63 2e68 746d 6c27 292c 2031 2c0a 'doc.html'), 1,. │ │ │ -00204a80: 0909 2768 7474 703a 2f2f 6c6f 6361 6c68 ..'http://localh │ │ │ -00204a90: 6f73 742e 6c6f 6361 6c64 6f6d 6169 6e2f ost.localdomain/ │ │ │ -00204aa0: 272c 2027 4953 4f27 293b 0a2e 2e2e 0a74 ', 'ISO');.....t │ │ │ -00204ab0: 7265 6520 3a3d 2078 6d6c 5f70 6572 7369 ree := xml_persi │ │ │ -00204ac0: 7374 656e 7420 2866 696c 655f 746f 5f73 stent (file_to_s │ │ │ -00204ad0: 7472 696e 6720 2827 646f 632e 786d 6c27 tring ('doc.xml' │ │ │ -00204ae0: 2929 3b0a 3c2f 7363 7265 656e 3e0a 2020 ));.</screen>. │ │ │ -00204af0: 2020 3c2f 6578 616d 706c 653e 0a20 203c </example>. < │ │ │ -00204b00: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. <re │ │ │ -00204b10: 6673 6563 7431 2069 643d 2273 6565 616c fsect1 id="seeal │ │ │ -00204b20: 736f 5f78 6d6c 5f70 6572 7369 7374 656e so_xml_persisten │ │ │ -00204b30: 7422 3e0a 2020 2020 3c74 6974 6c65 3e53 t">. <title>S │ │ │ -00204b40: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ -00204b50: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xml_tree,. xper_doc< │ │ │ -00204bb0: 2f6c 696e 6b3e 2c0a 2020 2020 3c6c 696e /link>,. xml_ │ │ │ -00204be0: 7669 6577 5f64 7464 3c2f 6c69 6e6b 3e2c view_dtd, │ │ │ -00204bf0: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . xml_val │ │ │ -00204c20: 6964 6174 655f 6474 643c 2f6c 696e 6b3e idate_dtd │ │ │ -00204c30: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . .
    ...... demo/doc │ │ │ -00204c60: 7372 632f 6675 6e63 7265 662f 786d 6c5f src/funcref/xml_ │ │ │ -00204c70: 7061 7468 2e78 6d6c df00 000a b83c 3f78 path.xml........ . │ │ │ -00205040: 2020 3c72 6566 656e 7472 7974 6974 6c65 xml_add_system_ │ │ │ -00205060: 7061 7468 3c2f 7265 6665 6e74 7279 7469 path. xml. . . xml_add_system_ │ │ │ -002050d0: 7061 7468 3c2f 7265 666e 616d 653e 0a20 path. │ │ │ -002050e0: 2020 203c 7265 6670 7572 706f 7365 3e41 A │ │ │ -002050f0: 6464 7320 7061 7468 2074 6f20 7468 6520 dds path to the │ │ │ -00205100: 696e 7465 726e 616c 206c 6973 7420 6f66 internal list of │ │ │ -00205110: 2073 7973 7465 6d20 7061 7468 732e 3c2f system paths.. . . │ │ │ -00205150: 2020 203c 6675 6e63 7379 6e6f 7073 6973 │ │ │ -00205180: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . < │ │ │ -002051c0: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>xml_add_system │ │ │ -002051e0: 5f70 6174 683c 2f66 756e 6374 696f 6e3e _path │ │ │ -002051f0: 3c2f 6675 6e63 6465 663e 0a09 3c70 6172 ..in pathvarchar. . │ │ │ -00205250: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . Description. │ │ │ -002052b0: 2057 6865 6e20 7661 6c69 6461 7469 6e67 When validating │ │ │ -002052c0: 2058 4d4c 2070 6172 7365 7220 7472 6965 XML parser trie │ │ │ -002052d0: 7320 746f 2072 6573 6f6c 7665 2073 7973 s to resolve sys │ │ │ -002052e0: 7465 6d20 656e 7469 7469 6573 2069 7420 tem entities it │ │ │ -002052f0: 0a09 7365 6172 6368 6573 2069 6e20 3c6c ..searches in http_ │ │ │ -00205320: 726f 6f74 3c2f 6c69 6e6b 3e20 6469 7265 root dire │ │ │ -00205330: 6374 6f72 792e 0a09 4966 2069 7420 6661 ctory...If it fa │ │ │ -00205340: 696c 7320 7061 7273 6572 2069 7465 7261 ils parser itera │ │ │ -00205350: 7465 7320 696e 7465 726e 616c 206c 6973 tes internal lis │ │ │ -00205360: 7420 6f66 2073 7973 7465 6d20 7061 7468 t of system path │ │ │ -00205370: 7320 616e 6420 7472 6965 7320 746f 0a09 s and tries to.. │ │ │ -00205380: 6669 6e64 2072 6571 7569 7265 6420 6669 find required fi │ │ │ -00205390: 6c65 7320 7468 6572 652e 2054 6865 2066 les there. The f │ │ │ -002053a0: 756e 6374 696f 6e20 6164 6473 206e 6577 unction adds new │ │ │ -002053b0: 2070 6174 6820 696e 2074 6869 7320 6c69 path in this li │ │ │ -002053c0: 7374 2e0a 094c 6973 7420 6f66 2073 7973 st...List of sys │ │ │ -002053d0: 7465 6d20 7061 7468 7320 636f 6e74 6169 tem paths contai │ │ │ -002053e0: 6e73 206f 6e65 2064 6972 6563 746f 7279 ns one directory │ │ │ -002053f0: 2069 7465 6d20 6279 2064 6566 6175 6c74 item by default │ │ │ -00205400: 202d 200a 0922 6669 6c65 3a2f 2f73 7973 - .."file://sys │ │ │ -00205410: 7465 6d2f 222e 0a20 2020 3c2f 7061 7261 tem/".. . NOTE │ │ │ -00205430: 3a20 4c69 7374 206f 6620 7379 7374 656d : List of system │ │ │ -00205440: 2070 6174 6873 2069 7320 6e6f 7420 7065 paths is not pe │ │ │ -00205450: 7273 6973 7465 6e74 2e20 4974 206d 6561 rsistent. It mea │ │ │ -00205460: 6e73 2074 6861 7420 796f 7520 6d75 7374 ns that you must │ │ │ -00205470: 0a09 6164 6420 6465 7369 7265 6420 7061 ..add desired pa │ │ │ -00205480: 7468 2065 6163 6820 7469 6d65 2077 6865 th each time whe │ │ │ -00205490: 6e20 7365 7276 6572 2073 7461 7274 732e n server starts. │ │ │ -002054a0: 2041 6e20 6964 6561 6c20 706c 6163 6520 An ideal place │ │ │ -002054b0: 666f 7220 7468 6973 0a09 6f70 6572 6174 for this..operat │ │ │ -002054c0: 696f 6e20 696e 2022 6175 746f 6578 6563 ion in "autoexec │ │ │ -002054d0: 2e69 7371 6c22 2066 696c 652e 203c 2f70 .isql" file.

    .
    ... │ │ │ -00205500: 3c72 6566 656e 7472 7920 6964 3d22 666e . . xml_get_s │ │ │ -00205550: 7973 7465 6d5f 7061 7468 733c 2f72 6566 ystem_paths. │ │ │ -00205570: 3c72 6566 6d69 7363 696e 666f 3e78 6d6c xml │ │ │ -00205580: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -00205590: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72
    . . < │ │ │ -002055b0: 7265 666e 616d 653e 786d 6c5f 6765 745f refname>xml_get_ │ │ │ -002055c0: 7379 7374 656d 5f70 6174 6873 3c2f 7265 system_paths. Returns v │ │ │ -002055f0: 6563 746f 7220 6f66 2061 6c6c 2073 7973 ector of all sys │ │ │ -00205600: 7465 6d20 7061 7468 732e 3c2f 7265 6670 tem paths.. . . < │ │ │ -00205640: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -00205650: 2266 7379 6e5f 786d 6c5f 6765 745f 7379 "fsyn_xml_get_sy │ │ │ -00205660: 7374 656d 5f70 6174 6873 223e 200a 2020 stem_paths"> . │ │ │ -00205670: 2020 2020 3c66 756e 6370 726f 746f 7479 . │ │ │ -002056c0: 786d 6c5f 6765 745f 7379 7374 656d 5f70 xml_get_system_p │ │ │ -002056d0: 6174 6873 3c2f 6675 6e63 7469 6f6e 3e3c aths< │ │ │ -002056e0: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -002056f0: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -00205700: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . ......+demo/d │ │ │ -00205740: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ -00205750: 6c5f 6e73 6578 7061 6e64 5f69 7269 7374 l_nsexpand_irist │ │ │ -00205760: 722e 786d 6cdf 0000 1212 3c3f 786d 6c20 r.xml........ . │ │ │ -00205b20: 2020 3c72 6566 656e 7472 7974 6974 6c65 __xml_nsexpand_ │ │ │ -00205b40: 6972 6973 7472 3c2f 7265 6665 6e74 7279 iristr. rdf. . . __xml_nsexpan │ │ │ -00205bb0: 645f 6972 6973 7472 3c2f 7265 666e 616d d_iristr. Checks if the │ │ │ -00205be0: 2073 7472 696e 6720 6973 2051 4e61 6d65 string is QName │ │ │ -00205bf0: 2061 6e64 2069 6620 6974 2069 7320 736f and if it is so │ │ │ -00205c00: 2074 6865 6e20 7265 706c 6163 6573 206e then replaces n │ │ │ -00205c10: 616d 6573 7061 6365 2070 7265 6669 7820 amespace prefix │ │ │ -00205c20: 746f 2074 6865 200a 2020 2020 0966 756c to the . .ful │ │ │ -00205c30: 6c20 6e61 6d65 7370 6163 6520 4952 492e l namespace IRI. │ │ │ -00205c40: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ -00205c50: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -00205c60: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ -00205c70: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . . │ │ │ -00205ce0: 2020 2020 3c66 756e 6364 6566 3e0a 2020 . │ │ │ -00205cf0: 2020 2020 2020 093c 6675 6e63 7469 6f6e .__xml_nsexpand_ │ │ │ -00205d10: 6972 6973 7472 3c2f 6675 6e63 7469 6f6e iristr.
    .. in str varchar. . │ │ │ -00205d90: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . . De │ │ │ -00205df0: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. Chec │ │ │ -00205e10: 6b73 2069 6620 7468 6520 7374 7269 6e67 ks if the string │ │ │ -00205e20: 2069 7320 514e 616d 6520 616e 6420 6966 is QName and if │ │ │ -00205e30: 2069 7420 6973 2073 6f20 7468 656e 2072 it is so then r │ │ │ -00205e40: 6570 6c61 6365 7320 6e61 6d65 7370 6163 eplaces namespac │ │ │ -00205e50: 6520 7072 6566 6978 2074 6f20 7468 6520 e prefix to the │ │ │ -00205e60: 0a20 2020 2009 6675 6c6c 206e 616d 6573 . .full names │ │ │ -00205e70: 7061 6365 2049 5249 2e20 4f74 6865 7277 pace IRI. Otherw │ │ │ -00205e80: 6973 6520 7369 676e 616c 7320 6572 726f ise signals erro │ │ │ -00205e90: 7220 6966 2074 6865 2061 7267 756d 656e r if the argumen │ │ │ -00205ea0: 7420 6973 206c 6f63 616c 2049 5249 2077 t is local IRI w │ │ │ -00205eb0: 6974 686f 7574 2061 2070 7265 6669 782e ithout a prefix. │ │ │ -00205ec0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . │ │ │ -00205f10: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -00205f20: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -00205f30: 3e3c 7469 746c 653e 7374 723c 2f74 6974 ><title>str</tit │ │ │ -00205f40: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -00205f50: 514e 616d 652e 2046 6f72 2065 782e 2069 QName. For ex. i │ │ │ -00205f60: 6620 514e 616d 6520 6973 2022 7072 6566 f QName is "pref │ │ │ -00205f70: 6978 3a6c 6f63 616c 222c 2074 6865 6e20 ix:local", then │ │ │ -00205f80: 636f 6e76 656e 6965 6e74 6c79 2069 7320 conveniently is │ │ │ -00205f90: 7265 706c 6163 6564 2022 7072 6566 6978 replaced "prefix │ │ │ -00205fa0: 3a22 2077 6974 6820 0a20 2020 2020 2009 :" with . . │ │ │ -00205fb0: 7468 6520 6e61 6d65 7370 6163 6520 4952 the namespace IR │ │ │ -00205fc0: 493c 2f70 6172 613e 0a20 2020 203c 2f72 I</para>. </r │ │ │ -00205fd0: 6566 7365 6374 323e 0a20 203c 2f72 6566 efsect2>. </ref │ │ │ -00205fe0: 7365 6374 313e 0a20 3c72 6566 7365 6374 sect1>. <refsect │ │ │ -00205ff0: 3120 6964 3d22 6578 616d 706c 6573 5f5f 1 id="examples__ │ │ │ -00206000: 786d 6c5f 6e73 6578 7061 6e64 5f69 7269 xml_nsexpand_iri │ │ │ -00206010: 7374 7222 3e3c 7469 746c 653e 4578 616d str"><title>Exam │ │ │ -00206020: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ -00206030: 203c 6578 616d 706c 6520 6964 3d22 6578 E │ │ │ -00206060: 7861 6d70 6c65 2077 6974 6820 464f 4146 xample with FOAF │ │ │ -00206070: 206e 616d 6573 7061 6365 2070 7265 6669 namespace prefi │ │ │ -00206080: 783c 2f74 6974 6c65 3e0a 3c70 726f 6772 x. SELECT │ │ │ -002060b0: 5f5f 786d 6c5f 6e73 6578 7061 6e64 5f69 __xml_nsexpand_i │ │ │ -002060c0: 7269 7374 7220 2827 666f 6166 3a6b 6e6f ristr ('foaf:kno │ │ │ -002060d0: 7773 2729 3b0a 5f5f 786d 6c5f 6e73 6578 ws');.__xml_nsex │ │ │ -002060e0: 7061 6e64 5f69 7269 7374 720a 5641 5243 pand_iristr.VARC │ │ │ -002060f0: 4841 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f HAR.____________ │ │ │ -00206100: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00206110: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00206120: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00206130: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00206140: 5f5f 5f0a 0a68 7474 703a 2f2f 786d 6c6e ___..http://xmln │ │ │ -00206150: 732e 636f 6d2f 666f 6166 2f30 2e31 2f6b s.com/foaf/0.1/k │ │ │ -00206160: 6e6f 7773 0a0a 3120 526f 7773 2e20 2d2d nows..1 Rows. -- │ │ │ -00206170: 2030 206d 7365 632e 0a5d 5d3e 3c2f 7072 0 msec..]]>. │ │ │ -00206190: 2020 3c2f 6578 616d 706c 653e 0a20 2020 . │ │ │ -002061a0: 203c 6578 616d 706c 6520 6964 3d22 6578 E │ │ │ -002061d0: 7861 6d70 6c65 2077 6974 6820 6e6f 206e xample with no n │ │ │ -002061e0: 616d 6573 7061 6365 2070 7265 6669 783c amespace prefix< │ │ │ -002061f0: 2f74 6974 6c65 3e0a 3c70 726f 6772 616d /title>.<program │ │ │ -00206200: 6c69 7374 696e 673e 3c21 5b43 4441 5441 listing><![CDATA │ │ │ -00206210: 5b0a 5351 4c3e 2053 454c 4543 5420 5f5f [.SQL> SELECT __ │ │ │ -00206220: 786d 6c5f 6e73 6578 7061 6e64 5f69 7269 xml_nsexpand_iri │ │ │ -00206230: 7374 7220 2827 6e6f 2d6e 616d 6573 7061 str ('no-namespa │ │ │ -00206240: 6365 2d70 7265 6669 782d 6972 6927 293b ce-prefix-iri'); │ │ │ -00206250: 0a0a 2a2a 2a20 4572 726f 7220 3232 3032 ..*** Error 2202 │ │ │ -00206260: 333a 205b 5669 7274 756f 736f 2044 7269 3: [Virtuoso Dri │ │ │ -00206270: 7665 725d 5b56 6972 7475 6f73 6f20 5365 ver][Virtuoso Se │ │ │ -00206280: 7276 6572 5d53 5236 3439 3a20 0a4e 6f20 rver]SR649: .No │ │ │ -00206290: 584d 4c20 6e61 6d65 7370 6163 6520 7072 XML namespace pr │ │ │ -002062a0: 6566 6978 2069 6e20 7374 7269 6e67 2022 efix in string " │ │ │ -002062b0: 6e6f 2d6e 616d 6573 7061 6365 2d70 7265 no-namespace-pre │ │ │ -002062c0: 6669 782d 6972 6922 0a69 6e0a 5f5f 786d fix-iri".in.__xm │ │ │ -002062d0: 6c5f 6e73 6578 7061 6e64 5f69 7269 7374 l_nsexpand_irist │ │ │ -002062e0: 723a 2842 4946 292c 0a20 2020 2020 2020 r:(BIF),. │ │ │ -002062f0: 205f 5f30 3120 3d3e 2027 6e6f 2d6e 616d __01 => 'no-nam │ │ │ -00206300: 6573 7061 6365 2d70 7265 6669 782d 6972 espace-prefix-ir │ │ │ -00206310: 6927 2c0a 3c54 6f70 204c 6576 656c 3e0a i',.<Top Level>. │ │ │ -00206320: 6174 206c 696e 6520 3520 6f66 2054 6f70 at line 5 of Top │ │ │ -00206330: 2d4c 6576 656c 3a0a 5345 4c45 4354 205f -Level:.SELECT _ │ │ │ -00206340: 5f78 6d6c 5f6e 7365 7870 616e 645f 6972 _xml_nsexpand_ir │ │ │ -00206350: 6973 7472 2028 276e 6f2d 6e61 6d65 7370 istr ('no-namesp │ │ │ -00206360: 6163 652d 7072 6566 6978 2d69 7269 2729 ace-prefix-iri') │ │ │ -00206370: 0a5d 5d3e 3c2f 7072 6f67 7261 6d6c 6973 .]]></programlis │ │ │ -00206380: 7469 6e67 3e0a 2020 2020 3c2f 6578 616d ting>. </exam │ │ │ -00206390: 706c 653e 2020 0a20 2020 203c 6578 616d ple> . <exam │ │ │ -002063a0: 706c 6520 6964 3d22 6578 5f78 6d6c 5f6e ple id="ex_xml_n │ │ │ -002063b0: 7365 7870 616e 645f 6972 6973 7472 5f33 sexpand_iristr_3 │ │ │ -002063c0: 223e 3c74 6974 6c65 3e45 7861 6d70 6c65 "><title>Example │ │ │ -002063d0: 2077 6974 6820 6e61 6d65 7370 6163 6520 with namespace │ │ │ -002063e0: 7072 6566 6978 2022 6c6f 6361 6c22 3c2f prefix "local"</ │ │ │ -002063f0: 7469 746c 653e 0a3c 7072 6f67 7261 6d6c title>.<programl │ │ │ -00206400: 6973 7469 6e67 3e3c 215b 4344 4154 415b isting><![CDATA[ │ │ │ -00206410: 0a53 514c 3e20 5345 4c45 4354 205f 5f78 .SQL> SELECT __x │ │ │ -00206420: 6d6c 5f6e 7365 7870 616e 645f 6972 6973 ml_nsexpand_iris │ │ │ -00206430: 7472 2028 276e 6f2d 7375 6368 2d70 7265 tr ('no-such-pre │ │ │ -00206440: 6669 783a 6c6f 6361 6c27 293b 0a0a 2a2a fix:local');..** │ │ │ -00206450: 2a20 4572 726f 7220 3232 3032 333a 205b * Error 22023: [ │ │ │ -00206460: 5669 7274 756f 736f 2044 7269 7665 725d Virtuoso Driver] │ │ │ -00206470: 5b56 6972 7475 6f73 6f20 5365 7276 6572 [Virtuoso Server │ │ │ -00206480: 5d53 5236 3438 3a20 0a55 6e6b 6e6f 776e ]SR648: .Unknown │ │ │ -00206490: 2058 4d4c 206e 616d 6573 7061 6365 2070 XML namespace p │ │ │ -002064a0: 7265 6669 7820 696e 2049 5249 2022 6e6f refix in IRI "no │ │ │ -002064b0: 2d73 7563 682d 7072 6566 6978 3a6c 6f63 -such-prefix:loc │ │ │ -002064c0: 616c 220a 696e 0a5f 5f78 6d6c 5f6e 7365 al".in.__xml_nse │ │ │ -002064d0: 7870 616e 645f 6972 6973 7472 3a28 4249 xpand_iristr:(BI │ │ │ -002064e0: 4629 2c0a 2020 2020 2020 2020 5f5f 3031 F),. __01 │ │ │ -002064f0: 203d 3e20 276e 6f2d 7375 6368 2d70 7265 => 'no-such-pre │ │ │ -00206500: 6669 783a 6c6f 6361 6c27 2c0a 3c54 6f70 fix:local',.<Top │ │ │ -00206510: 204c 6576 656c 3e0a 6174 206c 696e 6520 Level>.at line │ │ │ -00206520: 3620 6f66 2054 6f70 2d4c 6576 656c 3a0a 6 of Top-Level:. │ │ │ -00206530: 5345 4c45 4354 205f 5f78 6d6c 5f6e 7365 SELECT __xml_nse │ │ │ -00206540: 7870 616e 645f 6972 6973 7472 2028 276e xpand_iristr ('n │ │ │ -00206550: 6f2d 7375 6368 2d70 7265 6669 783a 6c6f o-such-prefix:lo │ │ │ -00206560: 6361 6c27 290a 5d5d 3e3c 2f70 726f 6772 cal').]]></progr │ │ │ -00206570: 616d 6c69 7374 696e 673e 0a20 2020 203c amlisting>. < │ │ │ -00206580: 2f65 7861 6d70 6c65 3e20 0a20 2020 203c /example> . < │ │ │ -00206590: 6578 616d 706c 6520 6964 3d22 6578 5f78 example id="ex_x │ │ │ -002065a0: 6d6c 5f6e 7365 7870 616e 645f 6972 6973 ml_nsexpand_iris │ │ │ -002065b0: 7472 5f34 223e 3c74 6974 6c65 3e45 7861 tr_4"><title>Exa │ │ │ -002065c0: 6d70 6c65 2077 6974 6820 6e61 6d65 7370 mple with namesp │ │ │ -002065d0: 6163 6520 7072 6566 6978 2022 226e 6f2d ace prefix ""no- │ │ │ -002065e0: 7375 6368 2d70 7265 6669 7822 223c 2f74 such-prefix""</t │ │ │ -002065f0: 6974 6c65 3e0a 3c70 726f 6772 616d 6c69 itle>.<programli │ │ │ -00206600: 7374 696e 673e 3c21 5b43 4441 5441 5b0a sting><![CDATA[. │ │ │ -00206610: 5351 4c3e 2053 454c 4543 5420 5f5f 786d SQL> SELECT __xm │ │ │ -00206620: 6c5f 6e73 5f69 7269 7374 7220 2827 6e6f l_ns_iristr ('no │ │ │ -00206630: 2d73 7563 682d 7072 6566 6978 272c 2027 -such-prefix', ' │ │ │ -00206640: 6b6e 6f77 7327 293b 0a0a 2a2a 2a20 4572 knows');..*** Er │ │ │ -00206650: 726f 7220 3232 3032 333a 205b 5669 7274 ror 22023: [Virt │ │ │ -00206660: 756f 736f 2044 7269 7665 725d 5b56 6972 uoso Driver][Vir │ │ │ -00206670: 7475 6f73 6f20 5365 7276 6572 5d53 5236 tuoso Server]SR6 │ │ │ -00206680: 3438 3a20 556e 6b6e 6f77 6e20 584d 4c20 48: Unknown XML │ │ │ -00206690: 6e61 6d65 7370 6163 6520 7072 6566 6978 namespace prefix │ │ │ -002066a0: 2022 6e6f 2d73 7563 682d 7072 6566 6978 "no-such-prefix │ │ │ -002066b0: 220a 696e 0a5f 5f78 6d6c 5f6e 735f 6972 ".in.__xml_ns_ir │ │ │ -002066c0: 6973 7472 3a28 4249 4629 2c0a 2020 2020 istr:(BIF),. │ │ │ -002066d0: 2020 2020 5f5f 3031 203d 3e20 276e 6f2d __01 => 'no- │ │ │ -002066e0: 7375 6368 2d70 7265 6669 7827 2c0a 2020 such-prefix',. │ │ │ -002066f0: 2020 2020 2020 5f5f 3032 203d 3e20 276b __02 => 'k │ │ │ -00206700: 6e6f 7773 272c 0a3c 546f 7020 4c65 7665 nows',.<Top Leve │ │ │ -00206710: 6c3e 0a61 7420 6c69 6e65 2037 206f 6620 l>.at line 7 of │ │ │ -00206720: 546f 702d 4c65 7665 6c3a 0a53 454c 4543 Top-Level:.SELEC │ │ │ -00206730: 5420 5f5f 786d 6c5f 6e73 5f69 7269 7374 T __xml_ns_irist │ │ │ -00206740: 7220 2827 6e6f 2d73 7563 682d 7072 6566 r ('no-such-pref │ │ │ -00206750: 6978 272c 2027 6b6e 6f77 7327 290a 5d5d ix', 'knows').]] │ │ │ -00206760: 3e3c 2f70 726f 6772 616d 6c69 7374 696e ></programlistin │ │ │ -00206770: 673e 0a20 2020 203c 2f65 7861 6d70 6c65 g>. </example │ │ │ -00206780: 3e20 2020 2020 2020 2020 2020 200a 2020 > . │ │ │ -00206790: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ -002067a0: 6566 7365 6374 3120 6964 3d22 7365 6561 efsect1 id="seea │ │ │ -002067b0: 6c73 6f5f 5f78 6d6c 5f6e 7365 7870 616e lso__xml_nsexpan │ │ │ -002067c0: 645f 6972 6973 7472 223e 3c74 6974 6c65 d_iristr"><title │ │ │ -002067d0: 3e53 6565 2041 6c73 6f3c 2f74 6974 6c65 >See Also. xml_ns_una │ │ │ -00206820: 6d65 2829 3c2f 6675 6e63 7469 6f6e 3e3c me()< │ │ │ -00206830: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00206840: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xml_ns_iristr │ │ │ -00206880: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ -002068a0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xml_get_ns_ │ │ │ -002068e0: 7072 6566 6978 2829 3c2f 6675 6e63 7469 prefix(). xml_get_ │ │ │ -00206940: 6e73 5f75 7269 2829 3c2f 6675 6e63 7469 ns_uri(). . │ │ │ -00206970: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 ..... │ │ │ -00206980: 2464 656d 6f2f 646f 6373 7263 2f66 756e $demo/docsrc/fun │ │ │ -00206990: 6372 6566 2f78 6d6c 5f6e 735f 756e 616d cref/xml_ns_unam │ │ │ -002069a0: 652e 786d 6cdf 0000 0bad 3c3f 786d 6c20 e.xml........ . __xml_ │ │ │ -00206d70: 6e73 5f75 6e61 6d65 3c2f 7265 6665 6e74 ns_uname. rdf. . . __xml_ns_un │ │ │ -00206de0: 616d 653c 2f72 6566 6e61 6d65 3e0a 2020 ame. │ │ │ -00206df0: 2020 3c72 6566 7075 7270 6f73 653e 5265 Re │ │ │ -00206e00: 7475 726e 7320 616e 2055 4e41 4d45 2074 turns an UNAME t │ │ │ -00206e10: 6861 7420 6973 2049 5249 202d 2d2d 2063 hat is IRI --- c │ │ │ -00206e20: 6f6e 6361 7465 6e61 7469 6f6e 206f 6620 oncatenation of │ │ │ -00206e30: 7468 6520 6578 7061 6e64 6564 206e 616d the expanded nam │ │ │ -00206e40: 6573 7061 6365 2049 5249 2061 6e64 2074 espace IRI and t │ │ │ -00206e50: 6865 206c 6f63 616c 2070 6172 742e 3c2f he local part.. . . │ │ │ -00206e90: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . │ │ │ -00206ec0: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ -00206ef0: 2020 2020 3c66 756e 6364 6566 3e0a 2020 . │ │ │ -00206f00: 2020 2020 2020 093c 6675 6e63 7469 6f6e .__xml_ns_uname< │ │ │ -00206f20: 2f66 756e 6374 696f 6e3e 0a20 2020 2020 /function>. │ │ │ -00206f30: 2020 203c 2f66 756e 6364 6566 3e0a 0920 .. │ │ │ -00206f40: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ -00206f50: 6e20 3c70 6172 616d 6574 6572 3e73 7472 n str │ │ │ -00206f60: 313c 2f70 6172 616d 6574 6572 3e20 7661 1 va │ │ │ -00206f70: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ -00206f80: 0a09 2020 2020 2020 3c70 6172 616d 6465 .. in │ │ │ -00206fa0: 7374 7232 3c2f 7061 7261 6d65 7465 723e str2 │ │ │ -00206fb0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar. . │ │ │ -00206fd0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . . │ │ │ -00207030: 2020 2020 3c74 6974 6c65 3e44 6573 6372 Descr │ │ │ -00207040: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ -00207050: 2020 203c 7061 7261 3e52 6574 7572 6e73 Returns │ │ │ -00207060: 2061 6e20 554e 414d 4520 7468 6174 2069 an UNAME that i │ │ │ -00207070: 7320 4952 4920 2d2d 2063 6f6e 6361 7465 s IRI -- concate │ │ │ -00207080: 6e61 7469 6f6e 206f 6620 7468 6520 6578 nation of the ex │ │ │ -00207090: 7061 6e64 6564 206e 616d 6573 7061 6365 panded namespace │ │ │ -002070a0: 2049 5249 2061 6e64 2074 6865 206c 6f63 IRI and the loc │ │ │ -002070b0: 616c 2070 6172 742e 3c2f 7061 7261 3e0a al part.. │ │ │ -002070c0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -002070d0: 3c72 6566 7365 6374 3120 6964 3d22 7061 . Parameters</tit │ │ │ -00207110: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -00207120: 323e 3c74 6974 6c65 3e73 7472 313c 2f74 2><title>str1</t │ │ │ -00207130: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -00207140: 613e 4e61 6d65 7370 6163 6520 7072 6566 a>Namespace pref │ │ │ -00207150: 6978 2e3c 2f70 6172 613e 0a20 2020 203c ix.</para>. < │ │ │ -00207160: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -00207170: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2><title> │ │ │ -00207180: 7374 7232 3c2f 7469 746c 653e 0a20 2020 str2. │ │ │ -00207190: 2020 203c 7061 7261 3e4c 6f63 616c 2070 Local p │ │ │ -002071a0: 6172 7420 2876 6172 6368 6172 292e 3c2f art (varchar).. . . . │ │ │ -00207200: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ -00207210: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -00207220: 6d70 6c65 2069 643d 2265 785f 786d 6c5f mple id="ex_xml_ │ │ │ -00207230: 6e73 5f75 6e61 6d65 5f31 223e 3c74 6974 ns_uname_1"><tit │ │ │ -00207240: 6c65 3e53 696d 706c 6520 4578 616d 706c le>Simple Exampl │ │ │ -00207250: 653c 2f74 6974 6c65 3e0a 3c70 726f 6772 e. SELECT │ │ │ -00207280: 5f5f 786d 6c5f 6e73 5f75 6e61 6d65 2028 __xml_ns_uname ( │ │ │ -00207290: 2766 6f61 6627 2c20 276b 6e6f 7773 2729 'foaf', 'knows') │ │ │ -002072a0: 3b0a 5f5f 786d 6c5f 6e73 5f75 6e61 6d65 ;.__xml_ns_uname │ │ │ -002072b0: 0a56 4152 4348 4152 0a5f 5f5f 5f5f 5f5f .VARCHAR._______ │ │ │ -002072c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002072d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002072e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002072f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00207300: 5f5f 5f5f 5f5f 5f5f 0a0a 6874 7470 3a2f ________..http:/ │ │ │ -00207310: 2f78 6d6c 6e73 2e63 6f6d 2f66 6f61 662f /xmlns.com/foaf/ │ │ │ -00207320: 302e 312f 6b6e 6f77 730a 0a31 2052 6f77 0.1/knows..1 Row │ │ │ -00207330: 732e 202d 2d20 3020 6d73 6563 2e0a 5d5d s. -- 0 msec..]] │ │ │ -00207340: 3e3c 2f70 726f 6772 616d 6c69 7374 696e >. . . │ │ │ -00207370: 2020 3c72 6566 7365 6374 3120 6964 3d22 Se │ │ │ -002073a0: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ -002073b0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_ns_irist │ │ │ -002073f0: 7228 293c 2f66 756e 6374 696f 6e3e 3c2f r(). │ │ │ -00207410: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xml_nsex │ │ │ -00207450: 7061 6e64 5f69 7269 7374 7228 293c 2f66 pand_iristr()< │ │ │ -00207470: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -002074b0: 786d 6c5f 6765 745f 6e73 5f70 7265 6669 xml_get_ns_prefi │ │ │ -002074c0: 7828 293c 2f66 756e 6374 696f 6e3e 3c2f x(). │ │ │ -002074e0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xml_get_ns_ur │ │ │ -00207520: 6928 293c 2f66 756e 6374 696f 6e3e 3c2f i(). < │ │ │ -00207540: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......%demo │ │ │ -00207560: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -00207570: 786d 6c5f 6e73 5f69 7269 7374 722e 786d xml_ns_iristr.xm │ │ │ -00207580: 6cdf 0000 0c14 3c3f 786d 6c20 7665 7273 l........ . __xml_ns_ │ │ │ -00207950: 6972 6973 7472 3c2f 7265 6665 6e74 7279 iristr. rdf. . . __xml_ns_iris │ │ │ -002079c0: 7472 3c2f 7265 666e 616d 653e 0a20 2020 tr. │ │ │ -002079d0: 203c 7265 6670 7572 706f 7365 3e52 6574 Ret │ │ │ -002079e0: 7572 6e73 2061 6e20 7661 7263 6861 7220 urns an varchar │ │ │ -002079f0: 7769 7468 2062 6f78 2066 6c61 6720 7365 with box flag se │ │ │ -00207a00: 7420 746f 2042 465f 4952 492e 3c2f 7265 t to BF_IRI.. . . │ │ │ -00207a40: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . │ │ │ -00207a70: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ -00207aa0: 2020 2020 3c66 756e 6364 6566 3e0a 2020 . │ │ │ -00207ab0: 2020 2020 2020 093c 6675 6e63 7469 6f6e .__xml_ns_iristr │ │ │ -00207ad0: 3c2f 6675 6e63 7469 6f6e 3e0a 2020 2020 . │ │ │ -00207ae0: 2020 2020 3c2f 6675 6e63 6465 663e 0a09 .. │ │ │ -00207af0: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -00207b00: 696e 203c 7061 7261 6d65 7465 723e 7374 in st │ │ │ -00207b10: 7231 3c2f 7061 7261 6d65 7465 723e 2076 r1 v │ │ │ -00207b20: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar.. in str2 varchar. . │ │ │ -00207b80: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . Des │ │ │ -00207bf0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -00207c00: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ -00207c10: 6675 6e63 7469 6f6e 2069 7320 7369 6d69 function is simi │ │ │ -00207c20: 6c61 7220 746f 2074 6865 203c 6c69 6e6b lar to the xml_ns_unam │ │ │ -00207c60: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e
  • function, . │ │ │ -00207c80: 2020 2061 6e64 2069 7420 7265 7475 726e and it return │ │ │ -00207c90: 7320 616e 2076 6172 6368 6172 2077 6974 s an varchar wit │ │ │ -00207ca0: 6820 626f 7820 666c 6167 2073 6574 2074 h box flag set t │ │ │ -00207cb0: 6f20 4246 5f49 5249 2e3c 2f70 6172 613e o BF_IRI. │ │ │ -00207cc0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -00207cd0: 203c 7265 6673 6563 7431 2069 643d 2270 . Parameters. str1< │ │ │ -00207d30: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -00207d40: 6172 613e 4e61 6d65 7370 6163 6520 7072 ara>Namespace pr │ │ │ -00207d50: 6566 6978 3c2f 7061 7261 3e0a 2020 2020 efix</para>. │ │ │ -00207d60: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 </refsect2>. │ │ │ -00207d70: 3c72 6566 7365 6374 323e 3c74 6974 6c65 <refsect2><title │ │ │ -00207d80: 3e73 7472 323c 2f74 6974 6c65 3e0a 2020 >str2. │ │ │ -00207d90: 2020 2020 3c70 6172 613e 4c6f 6361 6c20 Local │ │ │ -00207da0: 7061 7274 2028 7661 7263 6861 7229 3c2f part (varchar). . . │ │ │ -00207e00: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ -00207e10: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -00207e20: 6d70 6c65 2069 643d 2265 785f 786d 6c5f mple id="ex_xml_ │ │ │ -00207e30: 6e73 5f69 7269 7374 725f 3122 3e3c 7469 ns_iristr_1"><ti │ │ │ -00207e40: 746c 653e 5369 6d70 6c65 2045 7861 6d70 tle>Simple Examp │ │ │ -00207e50: 6c65 3c2f 7469 746c 653e 0a20 2020 2020 le. │ │ │ -00207e60: 203c 7061 7261 3e42 6173 6536 342d 656e Base64-en │ │ │ -00207e70: 636f 6465 2061 2073 7472 696e 673c 2f70 code a string

    . SELECT __xml │ │ │ -00207eb0: 5f6e 735f 6972 6973 7472 2028 2766 6f61 _ns_iristr ('foa │ │ │ -00207ec0: 6627 2c20 276b 6e6f 7773 2729 3b0a 5f5f f', 'knows');.__ │ │ │ -00207ed0: 786d 6c5f 6e73 5f69 7269 7374 720a 5641 xml_ns_iristr.VA │ │ │ -00207ee0: 5243 4841 520a 5f5f 5f5f 5f5f 5f5f 5f5f RCHAR.__________ │ │ │ -00207ef0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00207f00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00207f10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00207f20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00207f30: 5f5f 5f5f 5f0a 0a68 7474 703a 2f2f 786d _____..http://xm │ │ │ -00207f40: 6c6e 732e 636f 6d2f 666f 6166 2f30 2e31 lns.com/foaf/0.1 │ │ │ -00207f50: 2f6b 6e6f 7773 0a0a 3120 526f 7773 2e20 /knows..1 Rows. │ │ │ -00207f60: 2d2d 2031 206d 7365 632e 090a 5d5d 3e3c -- 1 msec...]]>< │ │ │ -00207f70: 2f70 726f 6772 616d 6c69 7374 696e 673e /programlisting> │ │ │ -00207f80: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -00207f90: 2020 3c2f 7265 6673 6563 7431 3e0a 2020
    . │ │ │ -00207fa0: 3c72 6566 7365 6374 3120 6964 3d22 7365 See │ │ │ -00207fd0: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -00207fe0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xml_ns_uname │ │ │ -00208030: 3c2f 7061 7261 3e20 2020 2020 2020 2020 │ │ │ -00208040: 2020 2020 2020 2020 200a 2020 2020 3c70 .

    xml_nsexpan │ │ │ -00208090: 645f 6972 6973 7472 3c2f 6675 6e63 7469 d_iristr . │ │ │ -002080c0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xml_get_n │ │ │ -00208100: 735f 7072 6566 6978 3c2f 6675 6e63 7469 s_prefix. xml_get_ │ │ │ -00208160: 6e73 5f75 7269 3c2f 6675 6e63 7469 6f6e ns_uri. │ │ │ -00208180: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......+d │ │ │ -002081a0: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -002081b0: 6566 2f78 6d6c 5f6e 616d 6573 7061 6365 ef/xml_namespace │ │ │ -002081c0: 5f73 636f 7065 2e78 6d6c df00 0014 5e3c _scope.xml....^< │ │ │ -002081d0: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -002081e0: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -002081f0: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . │ │ │ -00208590: 2020 203c 7265 6665 6e74 7279 7469 746c xml_namespace_ │ │ │ -002085b0: 7363 6f70 653c 2f72 6566 656e 7472 7974 scope. xml. . . xml_namespace_ │ │ │ -00208620: 7363 6f70 653c 2f72 6566 6e61 6d65 3e0a scope. │ │ │ -00208630: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -00208640: 5265 7475 726e 7320 6120 7665 6374 6f72 Returns a vector │ │ │ -00208650: 206f 6620 616c 6c20 6e61 6d65 7370 6163 of all namespac │ │ │ -00208660: 6520 6465 636c 6172 6174 696f 6e73 2069 e declarations i │ │ │ -00208670: 6e20 616c 6c20 616e 6365 7374 6f72 7320 n all ancestors │ │ │ -00208680: 6f66 2074 6865 2067 6976 656e 2058 4d4c of the given XML │ │ │ -00208690: 2065 6e74 6974 792e 3c2f 7265 6670 7572 entity.. . . . │ │ │ -00208700: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ -00208730: 2020 2020 2020 2020 3c66 756e 6364 6566 vector xml_namespace_ │ │ │ -00208760: 7363 6f70 653c 2f66 756e 6374 696f 6e3e scope │ │ │ -00208770: 3c2f 6675 6e63 6465 663e 0a09 3c70 6172 ..in ent XML Entity..in use_default_n │ │ │ -002087e0: 733c 2f70 6172 616d 6574 6572 3e20 696e s in │ │ │ -002087f0: 7465 6765 723c 2f70 6172 616d 6465 663e teger │ │ │ -00208800: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ -00208840: 2020 3c72 6566 7365 6374 3120 6964 3d22 . < │ │ │ -00208870: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ -00208880: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    The function │ │ │ -002088a0: 2072 6574 7572 6e73 2061 2076 6563 746f returns a vecto │ │ │ -002088b0: 7220 6f66 2065 7665 6e20 6c65 6e67 7468 r of even length │ │ │ -002088c0: 2074 6861 7420 636f 6e73 6973 7473 206f that consists o │ │ │ -002088d0: 6620 616c 6c20 6465 636c 6172 6564 206e f all declared n │ │ │ -002088e0: 616d 6573 7061 6365 2070 7265 6669 7865 amespace prefixe │ │ │ -002088f0: 7320 616e 6420 6e61 6d65 7370 6163 6520 s and namespace │ │ │ -00208900: 5552 4973 0a20 2020 2009 6672 6f6d 2074 URIs. .from t │ │ │ -00208910: 6865 203c 636f 6465 3e65 6e74 3c2f 636f he ent and all its │ │ │ -00208930: 616e 6365 7374 6f72 732e 2054 6869 7320 ancestors. This │ │ │ -00208940: 696e 666f 726d 6174 696f 6e20 6973 206e information is n │ │ │ -00208950: 6565 6465 6420 666f 7220 7072 6f63 6573 eeded for proces │ │ │ -00208960: 7369 6e67 2058 4d4c 2064 6f63 756d 656e sing XML documen │ │ │ -00208970: 7473 2074 6861 740a 636f 6e74 6169 6e73 ts that.contains │ │ │ -00208980: 2061 206d 6978 206f 6620 6461 7461 2061 a mix of data a │ │ │ -00208990: 6e64 2058 5061 7468 2065 7870 7265 7373 nd XPath express │ │ │ -002089a0: 696f 6e73 2c20 7375 6368 2061 7320 4250 ions, such as BP │ │ │ -002089b0: 454c 2064 6f63 756d 656e 7473 2e3c 2f70 EL documents.

    . . . │ │ │ -00208a00: 2020 2020 3c74 6974 6c65 3e50 6172 616d Param │ │ │ -00208a10: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -00208a20: 2020 3c72 6566 7365 6374 323e 3c74 6974 ent. │ │ │ -00208a40: 2020 2020 203c 7061 7261 3e54 6865 2065 The e │ │ │ -00208a50: 6e74 6974 7920 746f 2070 726f 6365 7373 ntity to process │ │ │ -00208a60: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 ..
    . us │ │ │ -00208a90: 655f 6465 6661 756c 745f 6e73 3c2f 7469 e_default_ns</ti │ │ │ -00208aa0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -00208ab0: 3e46 6c61 6773 2069 6620 7468 6520 7265 >Flags if the re │ │ │ -00208ac0: 7375 6c74 696e 6720 6172 7261 7920 7368 sulting array sh │ │ │ -00208ad0: 6f75 6c64 2063 6f6e 7461 696e 2064 6563 ould contain dec │ │ │ -00208ae0: 6c61 7261 7469 6f6e 7320 6f66 2064 6566 larations of def │ │ │ -00208af0: 6175 6c74 206e 616d 6573 7061 6365 2e20 ault namespace. │ │ │ -00208b00: 4966 2069 7420 6973 207a 6572 6f20 7468 If it is zero th │ │ │ -00208b10: 656e 0a6f 6e6c 7920 6465 636c 6172 6174 en.only declarat │ │ │ -00208b20: 696f 6e73 206f 6620 6e61 6d65 7370 6163 ions of namespac │ │ │ -00208b30: 6520 7072 6566 6978 6573 2061 7265 206c e prefixes are l │ │ │ -00208b40: 6973 7465 643b 2069 6620 6e6f 6e2d 7a65 isted; if non-ze │ │ │ -00208b50: 726f 2074 6865 6e20 616c 6c20 6465 636c ro then all decl │ │ │ -00208b60: 6172 6174 696f 6e73 2061 7265 206c 6973 arations are lis │ │ │ -00208b70: 7465 642e 3c2f 7061 7261 3e0a 2020 2020 ted.</para>. │ │ │ -00208b80: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f </refsect2>. </ │ │ │ -00208b90: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -00208ba0: 7365 6374 3120 6964 3d22 7265 745f 786d sect1 id="ret_xm │ │ │ -00208bb0: 6c5f 6e61 6d65 7370 6163 655f 7363 6f70 l_namespace_scop │ │ │ -00208bc0: 6522 3e3c 7469 746c 653e 5265 7475 726e e"><title>Return │ │ │ -00208bd0: 2054 7970 6573 3c2f 7469 746c 653e 0a20 Types. │ │ │ -00208be0: 2020 203c 7061 7261 3e54 6865 2066 756e The fun │ │ │ -00208bf0: 6374 696f 6e20 7265 7475 726e 7320 6120 ction returns a │ │ │ -00208c00: 7665 6374 6f72 206f 6620 6576 656e 206c vector of even l │ │ │ -00208c10: 656e 6774 6820 7468 6174 2063 6f6e 7461 ength that conta │ │ │ -00208c20: 696e 7320 6e61 7272 6f77 2073 7472 696e ins narrow strin │ │ │ -00208c30: 6773 2069 6e20 5554 462d 3820 656e 636f gs in UTF-8 enco │ │ │ -00208c40: 6469 6e67 2e3c 2f70 6172 613e 0a20 203c ding.. < │ │ │ -00208c50: 2f72 6566 7365 6374 313e 0a3c 212d 2d20 /refsect1>. . . Examples. < │ │ │ -00208d90: 7469 746c 653e 4164 6469 6e67 206e 616d title>Adding nam │ │ │ -00208da0: 6573 7061 6365 2064 6563 6c61 7261 7469 espace declarati │ │ │ -00208db0: 6f6e 7320 746f 2074 6865 2058 5061 7468 ons to the XPath │ │ │ -00208dc0: 2065 7870 7265 7373 696f 6e3c 2f74 6974 expression. │ │ │ -00208de0: 5468 6520 6675 6e63 7469 6f6e 2067 6574 The function get │ │ │ -00208df0: 7320 616e 2065 6e74 6974 7920 7768 6f73 s an entity whos │ │ │ -00208e00: 6520 7374 7269 6e67 2d76 616c 7565 2069 e string-value i │ │ │ -00208e10: 7320 616e 2058 5041 5448 2065 7870 7265 s an XPATH expre │ │ │ -00208e20: 7373 696f 6e20 616e 6420 7265 7475 726e ssion and return │ │ │ -00208e30: 730a 7468 6520 7465 7874 206f 6620 6578 s.the text of ex │ │ │ -00208e40: 7072 6573 7369 6f6e 2077 6974 6820 616c pression with al │ │ │ -00208e50: 6c20 6e61 6d65 7370 6163 6520 6465 636c l namespace decl │ │ │ -00208e60: 6172 6174 696f 6e73 2074 6861 7420 6172 arations that ar │ │ │ -00208e70: 6520 696e 2073 636f 7065 2e20 5468 6520 e in scope. The │ │ │ -00208e80: 7265 7375 6c74 696e 6720 6578 7072 6573 resulting expres │ │ │ -00208e90: 7369 6f6e 2069 730a 636f 6e74 6578 742d sion is.context- │ │ │ -00208ea0: 696e 6465 7065 6e64 656e 742e 2054 6869 independent. Thi │ │ │ -00208eb0: 7320 6973 2075 7365 6675 6c20 666f 7220 s is useful for │ │ │ -00208ec0: 4250 454c 2d6c 696b 6520 6170 706c 6963 BPEL-like applic │ │ │ -00208ed0: 6174 696f 6e73 2061 6e64 2066 6f72 2065 ations and for e │ │ │ -00208ee0: 7874 7261 6374 696e 6720 5850 4154 4820 xtracting XPATH │ │ │ -00208ef0: 6578 7072 6573 7369 6f6e 7320 6672 6f6d expressions from │ │ │ -00208f00: 0a58 4d4c 2053 6368 656d 6120 646f 6375 .XML Schema docu │ │ │ -00208f10: 6d65 6e74 732e 3c2f 7061 7261 3e0a 2020 ments.. │ │ │ -00208f20: 2020 2020 3c73 6372 6565 6e3e 3c21 5b43 0). {. │ │ │ -002090f0: 2020 2069 6620 285f 7363 6f70 655b 5f63 if (_scope[_c │ │ │ -00209100: 7472 2d32 5d20 3d20 2727 290a 2020 2020 tr-2] = ''). │ │ │ -00209110: 2020 2020 6874 7470 2028 7370 7269 6e74 http (sprint │ │ │ -00209120: 6620 2827 2078 6d6c 6e73 3d22 2573 2227 f (' xmlns="%s"' │ │ │ -00209130: 2c20 5f73 636f 7065 5b5f 6374 722d 315d , _scope[_ctr-1] │ │ │ -00209140: 292c 205f 7365 7329 3b0a 2020 2020 2020 ), _ses);. │ │ │ -00209150: 656c 7365 0a20 2020 2020 2020 2068 7474 else. htt │ │ │ -00209160: 7020 2873 7072 696e 7466 2028 2720 786d p (sprintf (' xm │ │ │ -00209170: 6c6e 733a 2573 3d22 2573 2227 2c20 5f73 lns:%s="%s"', _s │ │ │ -00209180: 636f 7065 5b5f 6374 722d 325d 2c20 5f73 cope[_ctr-2], _s │ │ │ -00209190: 636f 7065 5b5f 6374 722d 315d 292c 205f cope[_ctr-1]), _ │ │ │ -002091a0: 7365 7329 3b0a 2020 2020 2020 5f63 7472 ses);. _ctr │ │ │ -002091b0: 203a 3d20 5f63 7472 202d 2032 3b0a 2020 := _ctr - 2;. │ │ │ -002091c0: 2020 7d0a 2020 6874 7470 2028 2720 5d20 }. http (' ] │ │ │ -002091d0: 272c 205f 7365 7329 3b0a 2020 6874 7470 ', _ses);. http │ │ │ -002091e0: 2028 5f65 7870 6e2c 205f 7365 7329 3b0a (_expn, _ses);. │ │ │ -002091f0: 2020 7265 7475 726e 2073 7472 696e 675f return string_ │ │ │ -00209200: 6f75 7470 7574 5f73 7472 696e 6720 285f output_string (_ │ │ │ -00209210: 7365 7329 3b0a 7d0a 0a73 656c 6563 7420 ses);.}..select │ │ │ -00209220: 7870 6174 685f 6164 645f 6e61 6d65 7370 xpath_add_namesp │ │ │ -00209230: 6163 655f 7363 6f70 6520 280a 2020 7871 ace_scope (. xq │ │ │ -00209240: 7565 7279 5f65 7661 6c20 280a 2764 6563 uery_eval (.'dec │ │ │ -00209250: 6c61 7265 206e 616d 6573 7061 6365 2078 lare namespace x │ │ │ -00209260: 7364 3d22 6874 7470 3a2f 2f77 7777 2e77 sd="http://www.w │ │ │ -00209270: 332e 6f72 672f 3230 3031 2f58 4d4c 5363 3.org/2001/XMLSc │ │ │ -00209280: 6865 6d61 223b 0a2f 2f78 7364 3a6b 6579 hema";.//xsd:key │ │ │ -00209290: 7265 665b 406e 616d 653d 2249 5342 4e6e ref[@name="ISBNn │ │ │ -002092a0: 756d 6265 7222 5d2f 7873 643a 6669 656c umber"]/xsd:fiel │ │ │ -002092b0: 642f 4078 7061 7468 272c 0a20 2020 2078 d/@xpath',. x │ │ │ -002092c0: 7472 6565 5f64 6f63 2028 0a27 3c78 7364 tree_doc (.'. . . │ │ │ -002093e0: 2020 3c78 7364 3a73 656c 6563 746f 7220 . │ │ │ -00209400: 2020 3c78 7364 3a66 6965 6c64 2078 7061 . │ │ │ -00209420: 3c2f 7873 643a 6b65 7972 6566 3e0a 2020 . │ │ │ -00209430: 3c2f 7873 643a 656c 656d 656e 743e 0a20 . │ │ │ -00209440: 203c 212d 2d20 5468 6520 7265 7374 206f .')),. 1 );..c │ │ │ -00209490: 616c 6c72 6574 0a56 4152 4348 4152 0a5f allret.VARCHAR._ │ │ │ -002094a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002094b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002094c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002094d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002094e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ -002094f0: 5b20 786d 6c6e 733d 2268 7474 703a 2f2f [ xmlns="http:// │ │ │ -00209500: 7777 772e 7075 626c 6973 6869 6e67 2e6f www.publishing.o │ │ │ -00209510: 7267 2220 786d 6c6e 733a 7873 643d 2268 rg" xmlns:xsd="h │ │ │ -00209520: 7474 703a 2f2f 7777 772e 7733 2e6f 7267 ttp://www.w3.org │ │ │ -00209530: 2f32 3030 312f 584d 4c53 6368 656d 6122 /2001/XMLSchema" │ │ │ -00209540: 205d 2049 5342 4e0a 5d5d 3e0a 3c2f 7363 ] ISBN.]]>.. . . │ │ │ -002095a0: 0a20 2020 203c 7469 746c 653e 5365 6520 . See │ │ │ -002095b0: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ -002095c0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e x │ │ │ -002095f0: 7061 7468 5f65 7661 6c3c 2f66 756e 6374 path_eval. │ │ │ -00209620: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 .
    .... │ │ │ -00209630: 002c 6465 6d6f 2f64 6f63 7372 632f 6675 .,demo/docsrc/fu │ │ │ -00209640: 6e63 7265 662f 786d 6c5f 6c6f 6164 5f73 ncref/xml_load_s │ │ │ -00209650: 6368 656d 615f 6465 636c 2e78 6d6c df00 chema_decl.xml.. │ │ │ -00209660: 0010 0e3c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -00209690: 212d 2d20 0a20 2d20 200a 202d 2020 5468 !-- . - . - Th │ │ │ -002096a0: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ -002096b0: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ -002096c0: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ -002096d0: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ -002096e0: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ -002096f0: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ -00209700: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ -00209710: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ -00209720: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ -00209730: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ -00209740: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ -00209750: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ -00209760: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ -00209770: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ -00209780: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ -00209790: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -002097a0: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ -002097b0: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ -002097c0: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ -002097d0: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ -002097e0: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ -002097f0: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ -00209800: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ -00209810: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ -00209820: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ -00209830: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ -00209840: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ -00209850: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ -00209860: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ -00209870: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ -00209880: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ -00209890: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ -002098a0: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ -002098b0: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ -002098c0: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ -002098d0: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ -002098e0: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ -002098f0: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ -00209900: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ -00209910: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ -00209920: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ -00209930: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ -00209940: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -00209950: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ -00209960: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ -00209970: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ -00209980: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ -00209990: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -002099a0: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ -002099b0: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ -002099c0: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ -002099d0: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ -002099e0: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ -002099f0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . xml_load │ │ │ -00209a40: 5f73 6368 656d 615f 6465 636c 3c2f 7265 _schema_decl. │ │ │ -00209a60: 203c 7265 666d 6973 6369 6e66 6f3e 786d xm │ │ │ -00209a70: 6c3c 2f72 6566 6d69 7363 696e 666f 3e0a l. │ │ │ -00209a80: 2020 3c2f 7265 666d 6574 613e 0a20 203c . < │ │ │ -00209a90: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ -00209aa0: 3c72 6566 6e61 6d65 3e78 6d6c 5f6c 6f61 xml_loa │ │ │ -00209ab0: 645f 7363 6865 6d61 5f64 6563 6c3c 2f72 d_schema_decl. returns │ │ │ -00209ae0: 6120 7374 7269 6e67 2077 6974 6820 6c69 a string with li │ │ │ -00209af0: 7374 206f 6620 6572 726f 7273 2064 6574 st of errors det │ │ │ -00209b00: 6563 7465 6420 6279 2058 4d4c 2053 6368 ected by XML Sch │ │ │ -00209b10: 656d 6120 7072 6f63 6573 736f 7220 6f6e ema processor on │ │ │ -00209b20: 2072 6561 6469 6e67 2067 6976 656e 2058 reading given X │ │ │ -00209b30: 4d4c 2053 6368 656d 610a 2020 2020 0964 ML Schema. .d │ │ │ -00209b40: 6566 696e 6974 696f 6e20 646f 6375 6d65 efinition docume │ │ │ -00209b50: 6e74 2e3c 2f72 6566 7075 7270 6f73 653e nt. │ │ │ -00209b60: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -00209b70: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . │ │ │ -00209bf0: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ -00209c00: 6675 6e63 7469 6f6e 3e78 6d6c 5f6c 6f61 function>xml_loa │ │ │ -00209c10: 645f 7363 6865 6d61 5f64 6563 6c3c 2f66 d_schema_decl
    ..in │ │ │ -00209c40: 203c 7061 7261 6d65 7465 723e 6261 7365 base │ │ │ -00209c50: 5f75 7269 3c2f 7061 7261 6d65 7465 723e _uri │ │ │ -00209c60: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar..i │ │ │ -00209c80: 6e20 3c70 6172 616d 6574 6572 3e64 6f63 n doc │ │ │ -00209c90: 756d 656e 745f 7572 693c 2f70 6172 616d ument_uri varchar

    . │ │ │ -00209cc0: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    content │ │ │ -00209ce0: 5f65 6e63 6f64 696e 673c 2f70 6172 616d _encoding varchar

    . │ │ │ -00209d10: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    content │ │ │ -00209d30: 5f6c 616e 6775 6167 653c 2f70 6172 616d _language varchar

    . < │ │ │ -00209d60: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ -00209d70: 2020 2020 3c2f 6675 6e63 7379 6e6f 7073 . . Descri │ │ │ -00209dd0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 093c ption..< │ │ │ -00209de0: 7061 7261 3e4c 6f61 6473 2067 6976 656e para>Loads given │ │ │ -00209df0: 2066 696c 6520 7573 696e 6720 6261 7365 file using base │ │ │ -00209e00: 5f75 7269 2e20 5472 7920 746f 2070 6172 _uri. Try to par │ │ │ -00209e10: 7365 2066 696c 6520 6f66 2058 4d4c 2053 se file of XML S │ │ │ -00209e20: 6368 656d 6120 6465 6669 6e69 7469 6f6e chema definition │ │ │ -00209e30: 2061 6e64 2063 6865 636b 2069 7420 666f and check it fo │ │ │ -00209e40: 7220 636f 7272 6563 746e 6573 7320 746f r correctness to │ │ │ -00209e50: 2058 4d4c 0a09 0953 6368 656d 6120 7370 XML...Schema sp │ │ │ -00209e60: 6563 6966 6963 6174 696f 6e2e 3c2f 7061 ecification.. . Parameters</tit │ │ │ -00209eb0: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -00209ec0: 323e 3c74 6974 6c65 3e62 6173 655f 7572 2><title>base_ur │ │ │ -00209ed0: 693c 2f74 6974 6c65 3e0a 2020 2020 2020 i. │ │ │ -00209ee0: 3c70 6172 613e 696e 2048 544d 4c20 7061 in HTML pa │ │ │ -00209ef0: 7273 6572 206d 6f64 6520 6368 616e 6765 rser mode change │ │ │ -00209f00: 2061 6c6c 2061 6273 6f6c 7574 6520 7265 all absolute re │ │ │ -00209f10: 6665 7265 6e63 6573 2074 6f20 7265 6c61 ferences to rela │ │ │ -00209f20: 7469 7665 2066 726f 6d20 6769 7665 6e20 tive from given │ │ │ -00209f30: 6261 7365 5f75 7269 2028 6874 7470 3a2f base_uri (http:/ │ │ │ -00209f40: 2f26 6c74 3b68 6f73 7426 6774 3b3a 266c /<host>:&l │ │ │ -00209f50: 743b 706f 7274 2667 743b 2f26 6c74 3b70 t;port>/<p │ │ │ -00209f60: 6174 6826 6774 3b29 3c2f 7061 7261 3e3c ath>)< │ │ │ -00209f70: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -00209f80: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -00209f90: 636f 6e74 656e 745f 656e 636f 6469 6e67 content_encoding │ │ │ -00209fa0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00209fb0: 7061 7261 3e73 7472 696e 6720 7769 7468 para>string with │ │ │ -00209fc0: 2063 6f6e 7465 6e74 2065 6e63 6f64 696e content encodin │ │ │ -00209fd0: 6720 7479 7065 206f 6620 266c 743b 646f g type of <do │ │ │ -00209fe0: 6375 6d65 6e74 2667 743b 3b20 7661 6c69 cument>; vali │ │ │ -00209ff0: 6420 6172 6520 2741 5343 4949 272c 2027 d are 'ASCII', ' │ │ │ -0020a000: 4953 4f27 2c20 2755 5446 3827 2c20 2749 ISO', 'UTF8', 'I │ │ │ -0020a010: 534f 3838 3539 2d31 272c 2027 4c41 5449 SO8859-1', 'LATI │ │ │ -0020a020: 4e2d 3127 2065 7463 2e2c 2064 6566 6175 N-1' etc., defau │ │ │ -0020a030: 6c74 7320 6172 6520 2755 5446 2d38 2720 lts are 'UTF-8' │ │ │ -0020a040: 666f 7220 584d 4c20 6d6f 6465 2061 6e64 for XML mode and │ │ │ -0020a050: 2027 4c41 5449 4e2d 3127 2066 6f72 2048 'LATIN-1' for H │ │ │ -0020a060: 544d 4c20 6d6f 6465 3c2f 7061 7261 3e3c TML mode< │ │ │ -0020a070: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -0020a080: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -0020a090: 636f 6e74 656e 745f 6c61 6e67 7561 6765 content_language │ │ │ -0020a0a0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0020a0b0: 7061 7261 3e73 7472 696e 6720 7769 7468 para>string with │ │ │ -0020a0c0: 206c 616e 6775 6167 6520 7461 6720 6f66 language tag of │ │ │ -0020a0d0: 2063 6f6e 7465 6e74 206f 6620 266c 743b content of < │ │ │ -0020a0e0: 646f 6375 6d65 6e74 2667 743b 3b20 7661 document>; va │ │ │ -0020a0f0: 6c69 6420 6e61 6d65 7320 6172 6520 6c69 lid names are li │ │ │ -0020a100: 7374 6564 2069 6e20 4945 5446 2052 4643 sted in IETF RFC │ │ │ -0020a110: 2031 3736 362c 2064 6566 6175 6c74 2069 1766, default i │ │ │ -0020a120: 7320 2778 2d61 6e79 2720 2869 7420 6d65 s 'x-any' (it me │ │ │ -0020a130: 616e 7320 276d 6978 206f 6620 776f 7264 ans 'mix of word │ │ │ -0020a140: 7320 6672 6f6d 2076 6172 696f 7573 2068 s from various h │ │ │ -0020a150: 756d 616e 206c 616e 6775 6167 6573 293c uman languages)< │ │ │ -0020a160: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ -0020a180: 3c74 6974 6c65 3e64 7464 5f76 616c 6964 dtd_valid │ │ │ -0020a190: 6174 6f72 5f63 6f6e 6669 673c 2f74 6974 ator_config</tit │ │ │ -0020a1a0: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -0020a1b0: 636f 6e66 6967 7572 6174 696f 6e20 7374 configuration st │ │ │ -0020a1c0: 7269 6e67 206f 6620 7468 6520 7661 6c69 ring of the vali │ │ │ -0020a1d0: 6461 746f 722c 2064 6566 6175 6c74 2069 dator, default i │ │ │ -0020a1e0: 7320 656d 7074 7920 7374 7269 6e67 206d s empty string m │ │ │ -0020a1f0: 6561 6e69 6e67 2074 6861 7420 4454 4420 eaning that DTD │ │ │ -0020a200: 7661 6c69 6461 746f 7220 7368 6f75 6c64 validator should │ │ │ -0020a210: 2062 6520 6675 6c6c 7920 6469 7361 626c be fully disabl │ │ │ -0020a220: 6564 2061 6e64 206f 6e6c 7920 6372 6974 ed and only crit │ │ │ -0020a230: 6963 616c 2065 7272 6f72 7320 7368 6f75 ical errors shou │ │ │ -0020a240: 6c64 2062 6520 7265 706f 7274 6564 3c2f ld be reported</ │ │ │ -0020a250: 7061 7261 3e3c 2f72 6566 7365 6374 323e para></refsect2> │ │ │ -0020a260: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ -0020a270: 203c 7265 6673 6563 7431 2069 643d 2272 <refsect1 id="r │ │ │ -0020a280: 6574 223e 3c74 6974 6c65 3e52 6574 7572 et"><title>Retur │ │ │ -0020a290: 6e20 5479 7065 733c 2f74 6974 6c65 3e3c n Types< │ │ │ -0020a2a0: 7061 7261 3e48 756d 616e 2072 6561 6461 para>Human reada │ │ │ -0020a2b0: 626c 6520 6c69 7374 206f 6620 6572 726f ble list of erro │ │ │ -0020a2c0: 7273 2069 6620 6170 706c 6963 6162 6c65 rs if applicable │ │ │ -0020a2d0: 2061 7320 6120 7661 7263 6861 722e 3c2f as a varchar. │ │ │ -0020a2f0: 0a20 203c 7265 6673 6563 7431 2069 643d . Validating XML │ │ │ -0020a320: 2041 6761 696e 7374 2061 2058 4d4c 2053 Against a XML S │ │ │ -0020a330: 6368 656d 613c 2f74 6974 6c65 3e0a 2020 chema. │ │ │ -0020a340: 2020 3c65 7861 6d70 6c65 2069 643d 2265 S │ │ │ -0020a370: 696d 706c 6520 5573 653c 2f74 6974 6c65 imple Use.. . . See Also. < │ │ │ -0020a4d0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0020a4e0: 5f78 6d6c 5f76 616c 6964 6174 655f 7363 _xml_validate_sc │ │ │ -0020a4f0: 6865 6d61 223e 3c66 756e 6374 696f 6e3e hema"> │ │ │ -0020a500: 786d 6c5f 7661 6c69 6461 7465 5f73 6368 xml_validate_sch │ │ │ -0020a510: 656d 6128 293c 2f66 756e 6374 696f 6e3e ema() │ │ │ -0020a520: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -0020a530: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_auto_s │ │ │ -0020a570: 6368 656d 6128 293c 2f66 756e 6374 696f chema() │ │ │ -0020a590: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xml_view │ │ │ -0020a5d0: 5f73 6368 656d 6128 293c 2f66 756e 6374 _schema().
  • xml_v │ │ │ -0020a630: 616c 6964 6174 655f 6474 6428 293c 2f66 alidate_dtd()< │ │ │ -0020a650: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -0020a670: 0ab6 0000 0034 6465 6d6f 2f64 6f63 7372 .....4demo/docsr │ │ │ -0020a680: 632f 6675 6e63 7265 662f 786d 6c5f 6c6f c/funcref/xml_lo │ │ │ -0020a690: 6164 5f6d 6170 7069 6e67 5f73 6368 656d ad_mapping_schem │ │ │ -0020a6a0: 615f 6465 636c 2e78 6d6c df00 0014 583c a_decl.xml....X< │ │ │ -0020a6b0: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -0020a6c0: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -0020a6d0: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d20 -8859-1"?>... < │ │ │ -0020aa70: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. xml_ │ │ │ -0020aa90: 6c6f 6164 5f6d 6170 7069 6e67 5f73 6368 load_mapping_sch │ │ │ -0020aaa0: 656d 615f 6465 636c 3c2f 7265 6665 6e74 ema_decl. xml. . . xml_load_ma │ │ │ -0020ab10: 7070 696e 675f 7363 6865 6d61 5f64 6563 pping_schema_dec │ │ │ -0020ab20: 6c3c 2f72 6566 6e61 6d65 3e0a 2020 2020 l. │ │ │ -0020ab30: 3c72 6566 7075 7270 6f73 653e 6372 6561 crea │ │ │ -0020ab40: 7465 7320 6120 786d 6c20 7669 6577 2066 tes a xml view f │ │ │ -0020ab50: 726f 6d20 6d61 7070 696e 6720 7363 6865 rom mapping sche │ │ │ -0020ab60: 6d61 2e20 0a20 2020 203c 2f72 6566 7075 ma. . . . . . . x │ │ │ -0020ac30: 6d6c 5f6c 6f61 645f 6d61 7070 696e 675f ml_load_mapping_ │ │ │ -0020ac40: 7363 6865 6d61 5f64 6563 6c3c 2f66 756e schema_decl │ │ │ -0020ac60: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -0020ac70: 7061 7261 6d65 7465 723e 6261 7365 5f75 parameter>base_u │ │ │ -0020ac80: 7269 3c2f 7061 7261 6d65 7465 723e 2076 ri v │ │ │ -0020ac90: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar..in │ │ │ -0020acb0: 3c70 6172 616d 6574 6572 3e6d 6170 7069 mappi │ │ │ -0020acc0: 6e67 5f73 6368 656d 615f 6669 6c65 3c2f ng_schema_file varch │ │ │ -0020ace0: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -0020acf0: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -0020ad00: 696e 203c 7061 7261 6d65 7465 723e 636f in co │ │ │ -0020ad10: 6e74 656e 745f 656e 636f 6469 6e67 3c2f ntent_encoding varch │ │ │ -0020ad30: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -0020ad40: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -0020ad50: 696e 203c 7061 7261 6d65 7465 723e 636f in co │ │ │ -0020ad60: 6e74 656e 745f 6c61 6e67 7561 6765 3c2f ntent_language varch │ │ │ -0020ad80: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ -0020ad90: 2020 2020 3c2f 6675 6e63 7072 6f74 6f74 . . . < │ │ │ -0020add0: 7265 6673 6563 7431 2069 643d 2264 6573 refsect1 id="des │ │ │ -0020ade0: 6322 3e3c 7469 746c 653e 4465 7363 7269 c">Descri │ │ │ -0020adf0: 7074 696f 6e3c 2f74 6974 6c65 3e20 3c70 ption

    . xml_load_mapp │ │ │ -0020ae20: 696e 675f 7363 6865 6d61 5f64 6563 6c3c ing_schema_decl< │ │ │ -0020ae30: 2f66 756e 6374 696f 6e3e 2074 616b 6573 /function> takes │ │ │ -0020ae40: 2061 2066 696c 6520 636f 6e74 6169 6e69 a file containi │ │ │ -0020ae50: 6e67 206d 6170 7069 6e67 2073 6368 656d ng mapping schem │ │ │ -0020ae60: 6120 616e 6420 6372 6561 7465 7320 6120 a and creates a │ │ │ -0020ae70: 786d 6c20 7669 6577 2e0a 2020 2020 3c2f xml view.. . . Parameters. base_ │ │ │ -0020aee0: 7572 693c 2f74 6974 6c65 3e0a 2020 2020 uri. │ │ │ -0020aef0: 2020 3c70 6172 613e 696e 2048 544d 4c20 in HTML │ │ │ -0020af00: 7061 7273 6572 206d 6f64 6520 6368 616e parser mode chan │ │ │ -0020af10: 6765 2061 6c6c 2061 6273 6f6c 7574 6520 ge all absolute │ │ │ -0020af20: 7265 6665 7265 6e63 6573 2074 6f20 7265 references to re │ │ │ -0020af30: 6c61 7469 7665 2066 726f 6d20 6769 7665 lative from give │ │ │ -0020af40: 6e20 6261 7365 5f75 7269 2028 6874 7470 n base_uri (http │ │ │ -0020af50: 3a2f 2f26 6c74 3b68 6f73 7426 6774 3b3a ://<host>: │ │ │ -0020af60: 266c 743b 706f 7274 2667 743b 2f26 6c74 <port>/< │ │ │ -0020af70: 3b70 6174 6826 6774 3b29 3c2f 7061 7261 ;path>). │ │ │ -0020af90: 203c 7265 6673 6563 7432 3e3c 7469 746c mapping_schema │ │ │ -0020afb0: 5f66 696c 653c 2f74 6974 6c65 3e0a 2020 _file. │ │ │ -0020afc0: 2020 2020 3c70 6172 613e 7765 6c6c 2066 well f │ │ │ -0020afd0: 6f72 6d65 6420 584d 4c20 646f 6375 6d65 ormed XML docume │ │ │ -0020afe0: 6e74 2063 6f6e 7461 696e 696e 6720 6120 nt containing a │ │ │ -0020aff0: 6d61 7070 696e 6720 7363 6865 6d61 3c2f mapping schema. . conte │ │ │ -0020b030: 6e74 5f65 6e63 6f64 696e 673c 2f74 6974 nt_encoding</tit │ │ │ -0020b040: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -0020b050: 7374 7269 6e67 2077 6974 6820 636f 6e74 string with cont │ │ │ -0020b060: 656e 7420 656e 636f 6469 6e67 2074 7970 ent encoding typ │ │ │ -0020b070: 6520 6f66 2026 6c74 3b64 6f63 756d 656e e of <documen │ │ │ -0020b080: 7426 6774 3b3b 2076 616c 6964 2061 7265 t>; valid are │ │ │ -0020b090: 2027 4153 4349 4927 2c20 2749 534f 272c 'ASCII', 'ISO', │ │ │ -0020b0a0: 2027 5554 4638 272c 2027 4953 4f38 3835 'UTF8', 'ISO885 │ │ │ -0020b0b0: 392d 3127 2c20 274c 4154 494e 2d31 2720 9-1', 'LATIN-1' │ │ │ -0020b0c0: 6574 632e 2c20 6465 6661 756c 7473 2061 etc., defaults a │ │ │ -0020b0d0: 7265 2027 5554 462d 3827 2066 6f72 2058 re 'UTF-8' for X │ │ │ -0020b0e0: 4d4c 206d 6f64 6520 616e 6420 274c 4154 ML mode and 'LAT │ │ │ -0020b0f0: 494e 2d31 2720 666f 7220 4854 4d4c 206d IN-1' for HTML m │ │ │ -0020b100: 6f64 653c 2f70 6172 613e 3c2f 7265 6673 ode</para></refs │ │ │ -0020b110: 6563 7432 3e0a 2020 2020 3c72 6566 7365 ect2>. <refse │ │ │ -0020b120: 6374 323e 3c74 6974 6c65 3e63 6f6e 7465 ct2><title>conte │ │ │ -0020b130: 6e74 5f6c 616e 6775 6167 653c 2f74 6974 nt_language</tit │ │ │ -0020b140: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -0020b150: 7374 7269 6e67 2077 6974 6820 6c61 6e67 string with lang │ │ │ -0020b160: 7561 6765 2074 6167 206f 6620 636f 6e74 uage tag of cont │ │ │ -0020b170: 656e 7420 6f66 2026 6c74 3b64 6f63 756d ent of <docum │ │ │ -0020b180: 656e 7426 6774 3b3b 2076 616c 6964 206e ent>; valid n │ │ │ -0020b190: 616d 6573 2061 7265 206c 6973 7465 6420 ames are listed │ │ │ -0020b1a0: 696e 2049 4554 4620 5246 4320 3137 3636 in IETF RFC 1766 │ │ │ -0020b1b0: 2c20 6465 6661 756c 7420 6973 2027 782d , default is 'x- │ │ │ -0020b1c0: 616e 7927 2028 6974 206d 6561 6e73 2027 any' (it means ' │ │ │ -0020b1d0: 6d69 7820 6f66 2077 6f72 6473 2066 726f mix of words fro │ │ │ -0020b1e0: 6d20 7661 7269 6f75 7320 6875 6d61 6e20 m various human │ │ │ -0020b1f0: 6c61 6e67 7561 6765 7329 3c2f 7061 7261 languages)</para │ │ │ -0020b200: 3e3c 2f72 6566 7365 6374 323e 0a20 203c ></refsect2>. < │ │ │ -0020b210: 2f72 6566 7365 6374 313e 0a0a 2020 3c72 /refsect1>.. <r │ │ │ -0020b220: 6566 7365 6374 3120 6964 3d22 6578 616d efsect1 id="exam │ │ │ -0020b230: 706c 6573 223e 3c74 6974 6c65 3e3c 2f74 ples"><title></t │ │ │ -0020b240: 6974 6c65 3e0a 2020 2020 3c65 7861 6d70 itle>. <examp │ │ │ -0020b250: 6c65 2069 643d 2265 785f 786d 6c5f 6c6f le id="ex_xml_lo │ │ │ -0020b260: 6164 5f6d 6170 7069 6e67 5f73 6368 656d ad_mapping_schem │ │ │ -0020b270: 615f 6465 636c 223e 3c74 6974 6c65 3e43 a_decl"><title>C │ │ │ -0020b280: 7265 6174 696e 6720 6120 786d 6c20 7669 reating a xml vi │ │ │ -0020b290: 6577 2066 726f 6d20 6120 6d61 7070 696e ew from a mappin │ │ │ -0020b2a0: 6720 7363 6865 6d61 3c2f 7469 746c 653e g schema │ │ │ -0020b2b0: 0a3c 7061 7261 3e54 6865 2078 6d6c 2076 .The xml v │ │ │ -0020b2c0: 6965 7720 6372 6561 7465 6420 6279 203c iew created by < │ │ │ -0020b2d0: 2f70 6172 613e 0a3c 7072 6f67 7261 6d6c /para>.. xml_loa │ │ │ -0020b2f0: 645f 6d61 7070 696e 675f 7363 6865 6d61 d_mapping_schema │ │ │ -0020b300: 5f64 6563 6c20 280a 2020 2020 2768 7474 _decl (. 'htt │ │ │ -0020b310: 703a 2f2f 6c6f 6361 6c68 6f73 742e 6c6f p://localhost.lo │ │ │ -0020b320: 6361 6c64 6f6d 6169 6e2f 786d 6c72 6570 caldomain/xmlrep │ │ │ -0020b330: 6f73 6974 6f72 7927 2c0a 2020 2020 2763 ository',. 'c │ │ │ -0020b340: 6174 6d70 2e78 7364 272c 2027 5554 462d atmp.xsd', 'UTF- │ │ │ -0020b350: 3827 2c20 2778 2d61 6e79 2729 3b0a 3c2f 8', 'x-any');.. │ │ │ -0020b370: 203c 7061 7261 3e66 726f 6d20 7468 6520 from the │ │ │ -0020b380: 6669 6c65 2063 6174 6d70 2e78 7364 2063 file catmp.xsd c │ │ │ -0020b390: 6f6e 7461 696e 696e 6720 7468 6520 666f ontaining the fo │ │ │ -0020b3a0: 6c6c 6f77 696e 6720 6d61 7070 696e 6720 llowing mapping │ │ │ -0020b3b0: 7363 6865 6d61 3c2f 7061 7261 3e0a 3c70 schema.

    .. . . ... . . │ │ │ -0020b5e0: 203c 7873 643a 7365 7175 656e 6365 3e0a . │ │ │ -0020b5f0: 2020 2020 2020 2020 3c78 7364 3a65 6c65 . │ │ │ -0020b690: 203c 7873 643a 636f 6d70 6c65 7854 7970 . │ │ │ -0020b6b0: 203c 7873 643a 6174 7472 6962 7574 6520 . │ │ │ -0020b6f0: 2020 203c 2f78 7364 3a63 6f6d 706c 6578 . . │ │ │ -0020b720: 2020 3c2f 7873 643a 7365 7175 656e 6365 . . . │ │ │ -0020b7d0: 3c2f 7873 643a 636f 6d70 6c65 7854 7970 . │ │ │ -0020b7f0: 0a5d 5d3e 3c2f 7072 6f67 7261 6d6c 6973 .]]>. is │ │ │ -0020b810: 6964 656e 7469 6361 6c20 746f 2078 6d6c identical to xml │ │ │ -0020b820: 2076 6965 7720 6372 6561 7465 6420 6279 view created by │ │ │ -0020b830: 203c 2f70 6172 613e 0a3c 7072 6f67 7261 ..create │ │ │ -0020b850: 2078 6d6c 2076 6965 7720 2263 6174 2220 xml view "cat" │ │ │ -0020b860: 6173 0a7b 0a20 2022 4465 6d6f 222e 2264 as.{. "Demo"."d │ │ │ -0020b870: 656d 6f22 2e22 4361 7465 676f 7269 6573 emo"."Categories │ │ │ -0020b880: 2220 2243 2220 6173 2022 6361 7465 676f " "C" as "catego │ │ │ -0020b890: 7279 220a 0928 2243 6174 6567 6f72 7949 ry"..("CategoryI │ │ │ -0020b8a0: 4422 2c20 2244 6573 6372 6970 7469 6f6e D", "Description │ │ │ -0020b8b0: 2220 6173 2022 6465 7363 7269 7074 696f " as "descriptio │ │ │ -0020b8c0: 6e22 290a 2020 2020 7b0a 2020 2020 2020 n"). {. │ │ │ -0020b8d0: 2244 656d 6f22 2e22 6465 6d6f 222e 2250 "Demo"."demo"."P │ │ │ -0020b8e0: 726f 6475 6374 7322 2022 5022 2061 7320 roducts" "P" as │ │ │ -0020b8f0: 2270 726f 6475 6374 2220 2028 2250 726f "product" ("Pro │ │ │ -0020b900: 6475 6374 4e61 6d65 2229 0a09 6f6e 2028 ductName")..on ( │ │ │ -0020b910: 2250 222e 2243 6174 6567 6f72 7949 4422 "P"."CategoryID" │ │ │ -0020b920: 203d 2022 4322 2e22 4361 7465 676f 7279 = "C"."Category │ │ │ -0020b930: 4944 2229 0a20 2020 207d 0a7d 0a3c 2f70 ID"). }.}.

    . │ │ │ -0020b950: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 . │ │ │ -0020b960: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . See │ │ │ -0020b990: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ -0020b9a0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ -0020b9d0: 6675 6e63 7469 6f6e 3e78 6d6c 5f6c 6f61 function>xml_loa │ │ │ -0020b9e0: 645f 7363 6865 6d61 5f64 6563 6c28 293c d_schema_decl()< │ │ │ -0020b9f0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xml_l │ │ │ -0020ba60: 6f61 645f 7363 6865 6d61 5f64 6563 6c28 oad_schema_decl( │ │ │ -0020ba70: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )
  • . < │ │ │ -0020ba90: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xml_view_schem │ │ │ -0020bad0: 6128 293c 2f66 756e 6374 696f 6e3e 3c2f a()
    . < │ │ │ -0020baf0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......&demo │ │ │ -0020bb10: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -0020bb20: 786d 6c5f 6765 745f 6e73 5f75 7269 2e78 xml_get_ns_uri.x │ │ │ -0020bb30: 6d6c df00 000a 3b3c 3f78 6d6c 2076 6572 ml....;... . __xml_g │ │ │ -0020bf00: 6574 5f6e 735f 7572 693c 2f72 6566 656e et_ns_uri. rdf. < │ │ │ -0020bf40: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . __xml_get_ │ │ │ -0020bf70: 6e73 5f75 7269 3c2f 7265 666e 616d 653e ns_uri │ │ │ -0020bf80: 0a20 2020 203c 7265 6670 7572 706f 7365 . Returns URI by │ │ │ -0020bfa0: 6769 7665 6e20 6e61 6d65 7370 6163 6520 given namespace │ │ │ -0020bfb0: 7072 6566 6978 2e3c 2f72 6566 7075 7270 prefix.. . . . . │ │ │ -0020c050: 203c 6675 6e63 6465 663e 3c66 756e 6374 __xml_get_ns │ │ │ -0020c070: 5f75 7269 3c2f 6675 6e63 7469 6f6e 3e3c _uri< │ │ │ -0020c080: 2f66 756e 6364 6566 3e0a 093c 7061 7261 /funcdef>..in str varchar..outf │ │ │ -0020c0e0: 6c61 6773 3c2f 7061 7261 6d65 7465 723e lags │ │ │ -0020c0f0: 2069 6e74 3c2f 7061 7261 6d64 6566 3e0a int. │ │ │ -0020c100: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -0020c140: 203c 7265 6673 6563 7431 2069 643d 2264 . Description. │ │ │ -0020c190: 4966 2073 7472 2069 7320 6120 676c 6f62 If str is a glob │ │ │ -0020c1a0: 616c 6c79 206b 6e6f 776e 206e 616d 6573 ally known names │ │ │ -0020c1b0: 7061 6365 2070 7265 6669 782c 2069 7473 pace prefix, its │ │ │ -0020c1c0: 2055 5249 2069 7320 7265 7475 726e 6564 URI is returned │ │ │ -0020c1d0: 2c20 656c 7365 206e 756c 6c2e 0a46 6c61 , else null..Fla │ │ │ -0020c1e0: 6773 2069 7320 6120 6269 7420 6d61 736b gs is a bit mask │ │ │ -0020c1f0: 2077 6865 7265 2031 206d 6561 6e73 2074 where 1 means t │ │ │ -0020c200: 6f20 6c6f 6f6b 2069 6e20 7468 6520 636f o look in the co │ │ │ -0020c210: 6e6e 6563 7469 6f6e 2c20 3220 696e 2074 nnection, 2 in t │ │ │ -0020c220: 6865 2067 6c6f 6261 6c20 7365 7420 6f66 he global set of │ │ │ -0020c230: 206b 6e6f 776e 2070 7265 6669 7865 732e known prefixes. │ │ │ -0020c240: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . │ │ │ -0020c280: 2020 2020 3c74 6974 6c65 3e50 6172 616d Param │ │ │ -0020c290: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -0020c2a0: 2020 3c72 6566 7365 6374 323e 3c74 6974 str. │ │ │ -0020c2c0: 2020 2020 203c 7061 7261 3e6e 616d 6573 names │ │ │ -0020c2d0: 7061 6365 2070 7265 6669 783c 2f70 6172 pace prefix. . flags</t │ │ │ -0020c310: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -0020c320: 613e 4120 6269 7420 6d61 736b 2077 6865 a>A bit mask whe │ │ │ -0020c330: 7265 2031 206d 6561 6e73 2074 6f20 6c6f re 1 means to lo │ │ │ -0020c340: 6f6b 2069 6e20 7468 6520 636f 6e6e 6563 ok in the connec │ │ │ -0020c350: 7469 6f6e 2c20 3220 696e 2074 6865 2067 tion, 2 in the g │ │ │ -0020c360: 6c6f 6261 6c20 7365 7420 6f66 206b 6e6f lobal set of kno │ │ │ -0020c370: 776e 2070 7265 6669 7865 732e 3c2f 7061 wn prefixes.</pa │ │ │ -0020c380: 7261 3e0a 2020 2020 3c2f 7265 6673 6563 ra>. </refsec │ │ │ -0020c390: 7432 3e0a 2020 3c2f 7265 6673 6563 7431 t2>. </refsect1 │ │ │ -0020c3a0: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ -0020c3b0: 3d22 7365 6561 6c73 6f5f 5f78 6d6c 5f67 ="seealso__xml_g │ │ │ -0020c3c0: 6574 5f6e 735f 7572 6922 3e3c 7469 746c et_ns_uri"><titl │ │ │ -0020c3d0: 653e 5365 6520 416c 736f 3c2f 7469 746c e>See Also</titl │ │ │ -0020c3e0: 653e 0a20 2020 203c 7061 7261 3e0a 2020 e>. <para>. │ │ │ -0020c3f0: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e <link linken │ │ │ -0020c400: 643d 2266 6e5f 786d 6c5f 6765 745f 6e73 d="fn_xml_get_ns │ │ │ -0020c410: 5f70 7265 6669 7822 3e3c 6675 6e63 7469 _prefix"><functi │ │ │ -0020c420: 6f6e 3e78 6d6c 5f67 6574 5f6e 735f 7072 on>xml_get_ns_pr │ │ │ -0020c430: 6566 6978 2829 3c2f 6675 6e63 7469 6f6e efix()</function │ │ │ -0020c440: 3e3c 2f6c 696e 6b3e 0a20 2020 2020 203c ></link>. < │ │ │ -0020c450: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0020c460: 5f78 6d6c 5f6e 735f 756e 616d 6522 3e3c _xml_ns_uname">< │ │ │ -0020c470: 6675 6e63 7469 6f6e 3e78 6d6c 5f6e 735f function>xml_ns_ │ │ │ -0020c480: 756e 616d 6528 293c 2f66 756e 6374 696f uname()</functio │ │ │ -0020c490: 6e3e 3c2f 6c69 6e6b 3e0a 2020 2020 2020 n></link>. │ │ │ -0020c4a0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ -0020c4b0: 6e5f 786d 6c5f 6e73 5f69 7269 7374 7222 n_xml_ns_iristr" │ │ │ -0020c4c0: 3e3c 6675 6e63 7469 6f6e 3e78 6d6c 5f6e ><function>xml_n │ │ │ -0020c4d0: 735f 6972 6973 7472 2829 3c2f 6675 6e63 s_iristr()</func │ │ │ -0020c4e0: 7469 6f6e 3e3c 2f6c 696e 6b3e 0a20 2020 tion></link>. │ │ │ -0020c4f0: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 <link linkend │ │ │ -0020c500: 3d22 666e 5f78 6d6c 5f6e 7365 7870 616e ="fn_xml_nsexpan │ │ │ -0020c510: 645f 6972 6973 7472 223e 3c66 756e 6374 d_iristr"><funct │ │ │ -0020c520: 696f 6e3e 786d 6c5f 6e73 6578 7061 6e64 ion>xml_nsexpand │ │ │ -0020c530: 5f69 7269 7374 7228 293c 2f66 756e 6374 _iristr()</funct │ │ │ -0020c540: 696f 6e3e 3c2f 6c69 6e6b 3e0a 2020 2020 ion></link>. │ │ │ -0020c550: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 </para>. </refs │ │ │ -0020c560: 6563 7431 3e0a 3c2f 7265 6665 6e74 7279 ect1>.</refentry │ │ │ -0020c570: 3e0a b600 0000 2964 656d 6f2f 646f 6373 >.....)demo/docs │ │ │ -0020c580: 7263 2f66 756e 6372 6566 2f78 6d6c 5f67 rc/funcref/xml_g │ │ │ -0020c590: 6574 5f6e 735f 7072 6566 6978 2e78 6d6c et_ns_prefix.xml │ │ │ -0020c5a0: df00 000a 473c 3f78 6d6c 2076 6572 7369 ....G<?xml versi │ │ │ -0020c5b0: 6f6e 3d22 312e 3022 2065 6e63 6f64 696e on="1.0" encodin │ │ │ -0020c5c0: 673d 2249 534f 2d38 3835 392d 3122 3f3e g="ISO-8859-1"?> │ │ │ -0020c5d0: 0a3c 212d 2d0a 202d 0a20 2d20 2054 6869 .<!--. -. - Thi │ │ │ -0020c5e0: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -0020c5f0: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -0020c600: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -0020c610: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -0020c620: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -0020c630: 202d 0a20 2d20 2043 6f70 7972 6967 6874 -. - Copyright │ │ │ -0020c640: 2028 4329 2031 3939 382d 3230 3234 204f (C) 1998-2024 O │ │ │ -0020c650: 7065 6e4c 696e 6b20 536f 6674 7761 7265 penLink Software │ │ │ -0020c660: 0a20 2d0a 202d 2020 5468 6973 2070 726f . -. - This pro │ │ │ -0020c670: 6a65 6374 2069 7320 6672 6565 2073 6f66 ject is free sof │ │ │ -0020c680: 7477 6172 653b 2079 6f75 2063 616e 2072 tware; you can r │ │ │ -0020c690: 6564 6973 7472 6962 7574 6520 6974 2061 edistribute it a │ │ │ -0020c6a0: 6e64 2f6f 7220 6d6f 6469 6679 2069 740a nd/or modify it. │ │ │ -0020c6b0: 202d 2020 756e 6465 7220 7468 6520 7465 - under the te │ │ │ -0020c6c0: 726d 7320 6f66 2074 6865 2047 4e55 2047 rms of the GNU G │ │ │ -0020c6d0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -0020c6e0: 6365 6e73 6520 6173 2070 7562 6c69 7368 cense as publish │ │ │ -0020c6f0: 6564 2062 7920 7468 650a 202d 2020 4672 ed by the. - Fr │ │ │ -0020c700: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ -0020c710: 6461 7469 6f6e 3b20 6f6e 6c79 2076 6572 dation; only ver │ │ │ -0020c720: 7369 6f6e 2032 206f 6620 7468 6520 4c69 sion 2 of the Li │ │ │ -0020c730: 6365 6e73 652c 2064 6174 6564 204a 756e cense, dated Jun │ │ │ -0020c740: 6520 3139 3931 2e0a 202d 0a20 2d20 2054 e 1991.. -. - T │ │ │ -0020c750: 6869 7320 7072 6f67 7261 6d20 6973 2064 his program is d │ │ │ -0020c760: 6973 7472 6962 7574 6564 2069 6e20 7468 istributed in th │ │ │ -0020c770: 6520 686f 7065 2074 6861 7420 6974 2077 e hope that it w │ │ │ -0020c780: 696c 6c20 6265 2075 7365 6675 6c2c 2062 ill be useful, b │ │ │ -0020c790: 7574 0a20 2d20 2057 4954 484f 5554 2041 ut. - WITHOUT A │ │ │ -0020c7a0: 4e59 2057 4152 5241 4e54 593b 2077 6974 NY WARRANTY; wit │ │ │ -0020c7b0: 686f 7574 2065 7665 6e20 7468 6520 696d hout even the im │ │ │ -0020c7c0: 706c 6965 6420 7761 7272 616e 7479 206f plied warranty o │ │ │ -0020c7d0: 660a 202d 2020 4d45 5243 4841 4e54 4142 f. - MERCHANTAB │ │ │ -0020c7e0: 494c 4954 5920 6f72 2046 4954 4e45 5353 ILITY or FITNESS │ │ │ -0020c7f0: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ -0020c800: 5220 5055 5250 4f53 452e 2053 6565 2074 R PURPOSE. See t │ │ │ -0020c810: 6865 2047 4e55 0a20 2d20 2047 656e 6572 he GNU. - Gener │ │ │ -0020c820: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ -0020c830: 6520 666f 7220 6d6f 7265 2064 6574 6169 e for more detai │ │ │ -0020c840: 6c73 2e0a 202d 0a20 2d20 2059 6f75 2073 ls.. -. - You s │ │ │ -0020c850: 686f 756c 6420 6861 7665 2072 6563 6569 hould have recei │ │ │ -0020c860: 7665 6420 6120 636f 7079 206f 6620 7468 ved a copy of th │ │ │ -0020c870: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ -0020c880: 626c 6963 204c 6963 656e 7365 2061 6c6f blic License alo │ │ │ -0020c890: 6e67 0a20 2d20 2077 6974 6820 7468 6973 ng. - with this │ │ │ -0020c8a0: 2070 726f 6772 616d 3b20 6966 206e 6f74 program; if not │ │ │ -0020c8b0: 2c20 7772 6974 6520 746f 2074 6865 2046 , write to the F │ │ │ -0020c8c0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ -0020c8d0: 6e64 6174 696f 6e2c 2049 6e63 2e2c 0a20 ndation, Inc.,. │ │ │ -0020c8e0: 2d20 2035 3120 4672 616e 6b6c 696e 2053 - 51 Franklin S │ │ │ -0020c8f0: 742c 2046 6966 7468 2046 6c6f 6f72 2c20 t, Fifth Floor, │ │ │ -0020c900: 426f 7374 6f6e 2c20 4d41 2030 3231 3130 Boston, MA 02110 │ │ │ -0020c910: 2d31 3330 3120 5553 410a 202d 0a20 2d0a -1301 USA. -. -. │ │ │ -0020c920: 2d2d 3e0a 3c72 6566 656e 7472 7920 6964 -->.<refentry id │ │ │ -0020c930: 3d22 666e 5f5f 5f78 6d6c 5f67 6574 5f6e ="fn___xml_get_n │ │ │ -0020c940: 735f 7072 6566 6978 223e 0a20 203c 7265 s_prefix">. <re │ │ │ -0020c950: 666d 6574 613e 0a20 2020 203c 7265 6665 fmeta>. <refe │ │ │ -0020c960: 6e74 7279 7469 746c 653e 5f5f 786d 6c5f ntrytitle>__xml_ │ │ │ -0020c970: 6765 745f 6e73 5f70 7265 6669 783c 2f72 get_ns_prefix</r │ │ │ -0020c980: 6566 656e 7472 7974 6974 6c65 3e0a 2020 efentrytitle>. │ │ │ -0020c990: 2020 3c72 6566 6d69 7363 696e 666f 3e72 <refmiscinfo>r │ │ │ -0020c9a0: 6466 3c2f 7265 666d 6973 6369 6e66 6f3e df</refmiscinfo> │ │ │ -0020c9b0: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . </refmeta>. │ │ │ -0020c9c0: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 <refnamediv>. │ │ │ -0020c9d0: 203c 7265 666e 616d 653e 5f5f 786d 6c5f <refname>__xml_ │ │ │ -0020c9e0: 6765 745f 6e73 5f70 7265 6669 783c 2f72 get_ns_prefix</r │ │ │ -0020c9f0: 6566 6e61 6d65 3e0a 2020 2020 3c72 6566 efname>. <ref │ │ │ -0020ca00: 7075 7270 6f73 653e 5265 7475 726e 7320 purpose>Returns │ │ │ -0020ca10: 7072 6566 6978 2062 7920 6769 7665 6e20 prefix by given │ │ │ -0020ca20: 5552 492e 3c2f 7265 6670 7572 706f 7365 URI.</refpurpose │ │ │ -0020ca30: 3e0a 2020 3c2f 7265 666e 616d 6564 6976 >. </refnamediv │ │ │ -0020ca40: 3e0a 2020 3c72 6566 7379 6e6f 7073 6973 >. <refsynopsis │ │ │ -0020ca50: 6469 763e 0a20 2020 203c 6675 6e63 7379 div>. <funcsy │ │ │ -0020ca60: 6e6f 7073 6973 2069 643d 2266 7379 6e5f nopsis id="fsyn_ │ │ │ -0020ca70: 5f5f 786d 6c5f 6765 745f 6e73 5f70 7265 __xml_get_ns_pre │ │ │ -0020ca80: 6669 7822 3e0a 2020 2020 2020 3c66 756e fix">. <fun │ │ │ -0020ca90: 6370 726f 746f 7479 7065 2069 643d 2266 cprototype id="f │ │ │ -0020caa0: 7072 6f74 6f5f 5f5f 786d 6c5f 6765 745f proto___xml_get_ │ │ │ -0020cab0: 6e73 5f70 7265 6669 7822 3e0a 2020 2020 ns_prefix">. │ │ │ -0020cac0: 2020 2020 3c66 756e 6364 6566 3e3c 6675 <funcdef><fu │ │ │ -0020cad0: 6e63 7469 6f6e 3e5f 5f78 6d6c 5f67 6574 nction>__xml_get │ │ │ -0020cae0: 5f6e 735f 7072 6566 6978 3c2f 6675 6e63 _ns_prefix</func │ │ │ -0020caf0: 7469 6f6e 3e3c 2f66 756e 6364 6566 3e0a tion></funcdef>. │ │ │ -0020cb00: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .<paramdef>in <p │ │ │ -0020cb10: 6172 616d 6574 6572 3e73 7472 3c2f 7061 arameter>str</pa │ │ │ -0020cb20: 7261 6d65 7465 723e 2076 6172 6368 6172 rameter> varchar │ │ │ -0020cb30: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 </paramdef>..<pa │ │ │ -0020cb40: 7261 6d64 6566 3e6f 7574 3c70 6172 616d ramdef>out<param │ │ │ -0020cb50: 6574 6572 3e66 6c61 6773 3c2f 7061 7261 eter>flags</para │ │ │ -0020cb60: 6d65 7465 723e 2069 6e74 3c2f 7061 7261 meter> int</para │ │ │ -0020cb70: 6d64 6566 3e0a 2020 2020 2020 3c2f 6675 mdef>. </fu │ │ │ -0020cb80: 6e63 7072 6f74 6f74 7970 653e 0a20 2020 ncprototype>. │ │ │ -0020cb90: 203c 2f66 756e 6373 796e 6f70 7369 733e </funcsynopsis> │ │ │ -0020cba0: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . </refsynopsis │ │ │ -0020cbb0: 6469 763e 0a20 203c 7265 6673 6563 7431 div>. <refsect1 │ │ │ -0020cbc0: 2069 643d 2264 6573 635f 5f5f 786d 6c5f id="desc___xml_ │ │ │ -0020cbd0: 6765 745f 6e73 5f70 7265 6669 7822 3e0a get_ns_prefix">. │ │ │ -0020cbe0: 2020 2020 3c74 6974 6c65 3e44 6573 6372 <title>Descr │ │ │ -0020cbf0: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ -0020cc00: 2020 203c 7061 7261 3e49 6620 7374 7220 If str │ │ │ -0020cc10: 6973 2061 2067 6c6f 6261 6c6c 7920 6b6e is a globally kn │ │ │ -0020cc20: 6f77 6e20 6e61 6d65 7370 6163 6520 5552 own namespace UR │ │ │ -0020cc30: 492c 2069 7473 2070 7265 6669 7820 6973 I, its prefix is │ │ │ -0020cc40: 2072 6574 7572 6e65 642c 2065 6c73 6520 returned, else │ │ │ -0020cc50: 6e75 6c6c 2e0a 466c 6167 7320 6973 2061 null..Flags is a │ │ │ -0020cc60: 2062 6974 206d 6173 6b20 7768 6572 6520 bit mask where │ │ │ -0020cc70: 3120 6d65 616e 7320 746f 206c 6f6f 6b20 1 means to look │ │ │ -0020cc80: 696e 2074 6865 2063 6f6e 6e65 6374 696f in the connectio │ │ │ -0020cc90: 6e2c 2032 2069 6e20 7468 6520 676c 6f62 n, 2 in the glob │ │ │ -0020cca0: 616c 2073 6574 206f 6620 6b6e 6f77 6e20 al set of known │ │ │ -0020ccb0: 7072 6566 6978 6573 2e3c 2f70 6172 613e prefixes. │ │ │ -0020ccc0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -0020ccd0: 203c 7265 6673 6563 7431 2069 643d 2270 . │ │ │ -0020cd00: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ -0020cd10: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. s │ │ │ -0020cd30: 7472 3c2f 7469 746c 653e 0a20 2020 2020 tr. │ │ │ -0020cd40: 203c 7061 7261 3e75 7269 3c2f 7061 7261 uri. . │ │ │ -0020cd70: 3c74 6974 6c65 3e66 6c61 6773 3c2f 7469 flags</ti │ │ │ -0020cd80: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -0020cd90: 3e62 6974 6d61 736b 206f 6620 666c 6167 >bitmask of flag │ │ │ -0020cda0: 7320 7468 6174 2070 6572 6d69 7420 736f s that permit so │ │ │ -0020cdb0: 6d65 2073 6f72 7473 206f 6620 7379 6e74 me sorts of synt │ │ │ -0020cdc0: 6178 2065 7272 6f72 7320 696e 2072 6573 ax errors in res │ │ │ -0020cdd0: 6f75 7263 652c 2075 7365 2030 2e3c 2f70 ource, use 0.</p │ │ │ -0020cde0: 6172 613e 0a20 2020 203c 2f72 6566 7365 ara>. </refse │ │ │ -0020cdf0: 6374 323e 0a20 203c 2f72 6566 7365 6374 ct2>. </refsect │ │ │ -0020ce00: 313e 0a20 203c 7265 6673 6563 7431 2069 1>. <refsect1 i │ │ │ -0020ce10: 643d 2273 6565 616c 736f 5f5f 786d 6c5f d="seealso__xml_ │ │ │ -0020ce20: 6765 745f 6e73 5f70 7265 6669 7822 3e3c get_ns_prefix">< │ │ │ -0020ce30: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also</ │ │ │ -0020ce40: 7469 746c 653e 0a20 2020 203c 7061 7261 title>. <para │ │ │ -0020ce50: 3e0a 2020 2020 2020 3c6c 696e 6b20 6c69 >. <link li │ │ │ -0020ce60: 6e6b 656e 643d 2266 6e5f 786d 6c5f 6765 nkend="fn_xml_ge │ │ │ -0020ce70: 745f 6e73 5f75 7269 223e 3c66 756e 6374 t_ns_uri"><funct │ │ │ -0020ce80: 696f 6e3e 786d 6c5f 6765 745f 6e73 5f75 ion>xml_get_ns_u │ │ │ -0020ce90: 7269 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ri</function></l │ │ │ -0020cea0: 696e 6b3e 0a20 2020 2020 203c 6c69 6e6b ink>. <link │ │ │ -0020ceb0: 206c 696e 6b65 6e64 3d22 666e 5f78 6d6c linkend="fn_xml │ │ │ -0020cec0: 5f6e 735f 756e 616d 6522 3e3c 6675 6e63 _ns_uname"><func │ │ │ -0020ced0: 7469 6f6e 3e78 6d6c 5f6e 735f 756e 616d tion>xml_ns_unam │ │ │ -0020cee0: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e</function></li │ │ │ -0020cef0: 6e6b 3e20 2020 2020 2020 2020 2020 2020 nk> │ │ │ -0020cf00: 2020 2020 200a 2020 2020 2020 3c6c 696e . <lin │ │ │ -0020cf10: 6b20 6c69 6e6b 656e 643d 2266 6e5f 786d k linkend="fn_xm │ │ │ -0020cf20: 6c5f 6e73 5f69 7269 7374 7222 3e3c 6675 l_ns_iristr"><fu │ │ │ -0020cf30: 6e63 7469 6f6e 3e78 6d6c 5f6e 735f 6972 nction>xml_ns_ir │ │ │ -0020cf40: 6973 7472 3c2f 6675 6e63 7469 6f6e 3e3c istr</function>< │ │ │ -0020cf50: 2f6c 696e 6b3e 2020 2020 2020 0a20 2020 /link> . │ │ │ -0020cf60: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 <link linkend │ │ │ -0020cf70: 3d22 666e 5f78 6d6c 5f6e 7365 7870 616e ="fn_xml_nsexpan │ │ │ -0020cf80: 645f 6972 6973 7472 223e 3c66 756e 6374 d_iristr"><funct │ │ │ -0020cf90: 696f 6e3e 786d 6c5f 6e73 6578 7061 6e64 ion>xml_nsexpand │ │ │ -0020cfa0: 5f69 7269 7374 723c 2f66 756e 6374 696f _iristr</functio │ │ │ -0020cfb0: 6e3e 3c2f 6c69 6e6b 3e20 2020 2020 2020 n></link> │ │ │ -0020cfc0: 2020 2020 200a 2020 2020 3c2f 7061 7261 . </para │ │ │ -0020cfd0: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ -0020cfe0: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 </refentry>..... │ │ │ -0020cff0: 2d64 656d 6f2f 646f 6373 7263 2f66 756e -demo/docsrc/fun │ │ │ -0020d000: 6372 6566 2f78 6d6c 5f64 6f63 5f6f 7574 cref/xml_doc_out │ │ │ -0020d010: 7075 745f 6f70 7469 6f6e 2e78 6d6c df00 put_option.xml.. │ │ │ -0020d020: 0017 933c 3f78 6d6c 2076 6572 7369 6f6e ...<?xml version │ │ │ -0020d030: 3d22 312e 3022 2065 6e63 6f64 696e 673d ="1.0" encoding= │ │ │ -0020d040: 2249 534f 2d38 3835 392d 3122 3f3e 0a3c "ISO-8859-1"?>.< │ │ │ -0020d050: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ -0020d060: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -0020d070: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -0020d080: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -0020d090: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -0020d0a0: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -0020d0b0: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ -0020d0c0: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -0020d0d0: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -0020d0e0: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ -0020d0f0: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ -0020d100: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ -0020d110: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ -0020d120: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ -0020d130: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ -0020d140: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -0020d150: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -0020d160: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -0020d170: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ -0020d180: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ -0020d190: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ -0020d1a0: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ -0020d1b0: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ -0020d1c0: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ -0020d1d0: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ -0020d1e0: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ -0020d1f0: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ -0020d200: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ -0020d210: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ -0020d220: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ -0020d230: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ -0020d240: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ -0020d250: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ -0020d260: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -0020d270: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -0020d280: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -0020d290: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ -0020d2a0: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -0020d2b0: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ -0020d2c0: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ -0020d2d0: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ -0020d2e0: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -0020d2f0: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -0020d300: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -0020d310: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ -0020d320: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ -0020d330: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ -0020d340: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ -0020d350: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ -0020d360: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ -0020d370: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ -0020d380: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ -0020d390: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ -0020d3a0: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ -0020d3b0: 3c72 6566 656e 7472 7920 6964 3d22 666e <refentry id="fn │ │ │ -0020d3c0: 5f78 6d6c 5f64 6f63 5f6f 7574 7075 745f _xml_doc_output_ │ │ │ -0020d3d0: 6f70 7469 6f6e 223e 0a20 203c 7265 666d option">. <refm │ │ │ -0020d3e0: 6574 613e 0a20 2020 203c 7265 6665 6e74 eta>. <refent │ │ │ -0020d3f0: 7279 7469 746c 653e 786d 6c5f 646f 635f rytitle>xml_doc_ │ │ │ -0020d400: 6f75 7470 7574 5f6f 7074 696f 6e3c 2f72 output_option</r │ │ │ -0020d410: 6566 656e 7472 7974 6974 6c65 3e0a 2020 efentrytitle>. │ │ │ -0020d420: 2020 3c72 6566 6d69 7363 696e 666f 3e78 <refmiscinfo>x │ │ │ -0020d430: 6d6c 3c2f 7265 666d 6973 6369 6e66 6f3e ml</refmiscinfo> │ │ │ -0020d440: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . </refmeta>. │ │ │ -0020d450: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 <refnamediv>. │ │ │ -0020d460: 203c 7265 666e 616d 653e 786d 6c5f 646f <refname>xml_do │ │ │ -0020d470: 635f 6f75 7470 7574 5f6f 7074 696f 6e3c c_output_option< │ │ │ -0020d480: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. <r │ │ │ -0020d490: 6566 7075 7270 6f73 653e 3c2f 7265 6670 efpurpose></refp │ │ │ -0020d4a0: 7572 706f 7365 3e0a 2020 3c2f 7265 666e urpose>. </refn │ │ │ -0020d4b0: 616d 6564 6976 3e0a 2020 3c72 6566 7379 amediv>. <refsy │ │ │ -0020d4c0: 6e6f 7073 6973 6469 763e 0a20 2020 203c nopsisdiv>. < │ │ │ -0020d4d0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -0020d4e0: 2266 7379 6e5f 786d 6c5f 646f 635f 6f75 "fsyn_xml_doc_ou │ │ │ -0020d4f0: 7470 7574 5f6f 7074 696f 6e22 3e0a 2020 tput_option">. │ │ │ -0020d500: 2020 2020 3c66 756e 6370 726f 746f 7479 <funcprototy │ │ │ -0020d510: 7065 2069 643d 2266 7072 6f74 6f5f 786d pe id="fproto_xm │ │ │ -0020d520: 6c5f 646f 635f 6f75 7470 7574 5f6f 7074 l_doc_output_opt │ │ │ -0020d530: 696f 6e22 3e0a 2020 2020 2020 2020 3c66 ion">. <f │ │ │ -0020d540: 756e 6364 6566 3e76 6172 6368 6172 203c uncdef>varchar < │ │ │ -0020d550: 6675 6e63 7469 6f6e 3e78 6d6c 5f64 6f63 function>xml_doc │ │ │ -0020d560: 5f6f 7574 7075 745f 6f70 7469 6f6e 3c2f _output_option</ │ │ │ -0020d570: 6675 6e63 7469 6f6e 3e3c 2f66 756e 6364 function></funcd │ │ │ -0020d580: 6566 3e0a 093c 7061 7261 6d64 6566 3e69 ef>..<paramdef>i │ │ │ -0020d590: 6e20 3c70 6172 616d 6574 6572 3e78 6d6c n <parameter>xml │ │ │ -0020d5a0: 5f65 6e74 6974 793c 2f70 6172 616d 6574 _entity</paramet │ │ │ -0020d5b0: 6572 3e20 616e 793c 2f70 6172 616d 6465 er> any</paramde │ │ │ -0020d5c0: 663e 0a09 3c70 6172 616d 6465 663e 696e f>..<paramdef>in │ │ │ -0020d5d0: 203c 7061 7261 6d65 7465 723e 6f70 7469 <parameter>opti │ │ │ -0020d5e0: 6f6e 5f6e 616d 653c 2f70 6172 616d 6574 on_name</paramet │ │ │ -0020d5f0: 6572 3e20 7661 7263 6861 723c 2f70 6172 er> varchar</par │ │ │ -0020d600: 616d 6465 663e 0a09 3c70 6172 616d 6465 amdef>..<paramde │ │ │ -0020d610: 663e 3c6f 7074 696f 6e61 6c3e 696e 203c f><optional>in < │ │ │ -0020d620: 7061 7261 6d65 7465 723e 6f70 7469 6f6e parameter>option │ │ │ -0020d630: 5f76 616c 7565 3c2f 7061 7261 6d65 7465 _value</paramete │ │ │ -0020d640: 723e 2076 6172 6368 6172 3c2f 6f70 7469 r> varchar</opti │ │ │ -0020d650: 6f6e 616c 3e3c 2f70 6172 616d 6465 663e onal></paramdef> │ │ │ -0020d660: 0a20 2020 2020 203c 2f66 756e 6370 726f . </funcpro │ │ │ -0020d670: 746f 7479 7065 3e0a 2020 2020 3c2f 6675 totype>. </fu │ │ │ -0020d680: 6e63 7379 6e6f 7073 6973 3e0a 2020 3c2f ncsynopsis>. </ │ │ │ -0020d690: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -0020d6a0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -0020d6b0: 6465 7363 5f78 6d6c 5f64 6f63 5f6f 7574 desc_xml_doc_out │ │ │ -0020d6c0: 7075 745f 6f70 7469 6f6e 223e 0a20 2020 put_option">. │ │ │ -0020d6d0: 203c 7469 746c 653e 4465 7363 7269 7074 <title>Descript │ │ │ -0020d6e0: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ -0020d6f0: 3c70 6172 613e 5468 6973 2066 756e 6374 This funct │ │ │ -0020d700: 696f 6e20 7265 6164 7320 6f72 2075 7064 ion reads or upd │ │ │ -0020d710: 6174 6573 2074 6865 2073 7065 6369 6669 ates the specifi │ │ │ -0020d720: 6564 2058 534c 5420 6f75 7470 7574 206f ed XSLT output o │ │ │ -0020d730: 7074 696f 6e20 7661 6c75 650a 2020 2020 ption value. │ │ │ -0020d740: 2020 6f66 2074 6865 2067 6976 656e 203c of the given < │ │ │ -0020d750: 636f 6465 3e78 6d6c 5f65 6e74 6974 793c code>xml_entity< │ │ │ -0020d760: 2f63 6f64 653e 2e3c 2f70 6172 613e 0a20 /code>.. │ │ │ -0020d770: 2020 203c 7061 7261 3e54 6865 2066 756e The fun │ │ │ -0020d780: 6374 696f 6e20 7570 6461 7465 7320 7468 ction updates th │ │ │ -0020d790: 6520 6f70 7469 6f6e 2069 6620 7061 7261 e option if para │ │ │ -0020d7a0: 6d65 7465 7220 3c63 6f64 653e 6f70 7469 meter opti │ │ │ -0020d7b0: 6f6e 5f76 616c 7565 3c2f 636f 6465 3e20 on_value │ │ │ -0020d7c0: 6973 2070 726f 7669 6465 642c 206f 7468 is provided, oth │ │ │ -0020d7d0: 6572 7769 7365 2069 7420 7265 7475 726e erwise it return │ │ │ -0020d7e0: 7320 7468 650a 2020 2020 6375 7272 656e s the. curren │ │ │ -0020d7f0: 7420 7661 6c75 6520 6f66 2074 6865 206f t value of the o │ │ │ -0020d800: 7074 696f 6e20 7769 7468 6f75 7420 616e ption without an │ │ │ -0020d810: 7920 7369 6465 2065 6666 6563 7473 2e3c y side effects.< │ │ │ -0020d820: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. Supported optio │ │ │ -0020d840: 6e73 2061 7265 2022 6d65 7468 6f64 222c ns are "method", │ │ │ -0020d850: 2022 7665 7273 696f 6e22 2c20 2265 6e63 "version", "enc │ │ │ -0020d860: 6f64 696e 6722 2c20 226f 6d69 742d 786d oding", "omit-xm │ │ │ -0020d870: 6c2d 6465 636c 6172 6174 696f 6e22 2c20 l-declaration", │ │ │ -0020d880: 2273 7461 6e64 616c 6f6e 6522 2c20 2264 "standalone", "d │ │ │ -0020d890: 6f63 7479 7065 2d70 7562 6c69 6322 2c0a octype-public",. │ │ │ -0020d8a0: 2020 2020 0922 646f 6374 7970 652d 7379 ."doctype-sy │ │ │ -0020d8b0: 7374 656d 222c 2022 696e 6465 6e74 2220 stem", "indent" │ │ │ -0020d8c0: 616e 6420 226d 6564 6961 2d74 7970 6522 and "media-type" │ │ │ -0020d8d0: 2c20 6275 7420 646f 206e 6f74 2073 7570 , but do not sup │ │ │ -0020d8e0: 706f 7274 2263 6461 7461 2d73 6563 7469 port"cdata-secti │ │ │ -0020d8f0: 6f6e 2d65 6c65 6d65 6e74 7322 2e20 5768 on-elements". Wh │ │ │ -0020d900: 656e 2074 6865 2065 6e74 6974 7920 6973 en the entity is │ │ │ -0020d910: 2073 6572 6961 6c69 7a65 642c 0a20 2020 serialized,. │ │ │ -0020d920: 2009 7468 6520 6566 6665 6374 2069 7320 .the effect is │ │ │ -0020d930: 7665 7279 2073 696d 696c 6172 2074 6f20 very similar to │ │ │ -0020d940: 7468 6520 6566 6665 6374 206f 6620 7468 the effect of th │ │ │ -0020d950: 6520 7361 6d65 206f 7074 696f 6e20 7370 e same option sp │ │ │ -0020d960: 6563 6966 6965 6420 696e 2078 736c 3a6f ecified in xsl:o │ │ │ -0020d970: 7574 7075 7420 656c 656d 656e 7420 6f66 utput element of │ │ │ -0020d980: 2061 6e20 5853 4c54 2074 6861 7420 6372 an XSLT that cr │ │ │ -0020d990: 6561 7465 640a 2020 2020 0974 6865 2065 eated. .the e │ │ │ -0020d9a0: 6e74 6974 792e 3c2f 7061 7261 3e0a 2020 ntity.. │ │ │ -0020d9b0: 2020 3c70 6172 613e 4e6f 7465 2074 6861 Note tha │ │ │ -0020d9c0: 7420 6f75 7470 7574 206f 7074 696f 6e73 t output options │ │ │ -0020d9d0: 2061 7265 2070 726f 7065 7274 6965 7320 are properties │ │ │ -0020d9e0: 6f66 2074 6865 2077 686f 6c65 2064 6f63 of the whole doc │ │ │ -0020d9f0: 756d 656e 742c 206e 6f74 2070 726f 7065 ument, not prope │ │ │ -0020da00: 7274 6965 7320 6f66 2073 6f6d 6520 7061 rties of some pa │ │ │ -0020da10: 7274 6963 756c 6172 206e 6f64 6520 696e rticular node in │ │ │ -0020da20: 2074 6865 0a20 2020 2009 646f 6375 6d65 the. .docume │ │ │ -0020da30: 6e74 2c20 736f 2074 6865 2065 6666 6563 nt, so the effec │ │ │ -0020da40: 7420 6f66 2074 6865 2075 7064 6174 6520 t of the update │ │ │ -0020da50: 6973 2064 6f63 756d 656e 742d 7769 6465 is document-wide │ │ │ -0020da60: 2e20 506c 6561 7365 2061 6c73 6f20 6e6f . Please also no │ │ │ -0020da70: 7465 2074 6861 7420 7468 6520 6566 6665 te that the effe │ │ │ -0020da80: 6374 206f 6620 2770 7265 616d 626c 6527 ct of 'preamble' │ │ │ -0020da90: 206f 7074 696f 6e73 0a20 2020 2009 226f options. ."o │ │ │ -0020daa0: 6d69 742d 786d 6c2d 6465 636c 6172 6174 mit-xml-declarat │ │ │ -0020dab0: 696f 6e22 2c20 2273 7461 6e64 616c 6f6e ion", "standalon │ │ │ -0020dac0: 6522 2c20 2264 6f63 7479 7065 2d70 7562 e", "doctype-pub │ │ │ -0020dad0: 6c69 6322 2061 6e64 2022 646f 6374 7970 lic" and "doctyp │ │ │ -0020dae0: 652d 7379 7374 656d 2220 6973 2076 6973 e-system" is vis │ │ │ -0020daf0: 6962 6c65 206f 6e6c 7920 7768 656e 2074 ible only when t │ │ │ -0020db00: 6865 2072 6f6f 7420 656e 7469 7479 0a20 he root entity. │ │ │ -0020db10: 2020 2009 6f66 2074 6865 2064 6f63 756d .of the docum │ │ │ -0020db20: 656e 7420 6973 2073 6572 6961 6c69 7a65 ent is serialize │ │ │ -0020db30: 642c 206e 6f74 2061 6e79 2064 6573 6365 d, not any desce │ │ │ -0020db40: 6e64 616e 7420 656e 7469 7479 2e20 4576 ndant entity. Ev │ │ │ -0020db50: 656e 2074 6865 2073 6572 6961 6c69 7a61 en the serializa │ │ │ -0020db60: 7469 6f6e 206f 6620 746f 702d 6c65 7665 tion of top-leve │ │ │ -0020db70: 6c20 656c 656d 656e 7420 6f66 2074 6865 l element of the │ │ │ -0020db80: 0a20 2020 2009 646f 6375 6d65 6e74 2069 . .document i │ │ │ -0020db90: 7320 6e6f 7420 6166 6665 6374 6564 2062 s not affected b │ │ │ -0020dba0: 7920 7468 6573 6520 7365 7474 696e 6773 y these settings │ │ │ -0020dbb0: 2e20 5468 6520 584d 4c20 7072 6561 6d62 . The XML preamb │ │ │ -0020dbc0: 6c65 2069 7320 7365 7269 616c 697a 6564 le is serialized │ │ │ -0020dbd0: 206f 6e6c 7920 6966 2074 6865 2064 6f63 only if the doc │ │ │ -0020dbe0: 756d 656e 7420 6973 2063 6f6d 706f 7365 ument is compose │ │ │ -0020dbf0: 6420 6279 0a20 2020 2009 616e 2058 534c d by. .an XSL │ │ │ -0020dc00: 5420 7072 6f63 6573 736f 7220 6f72 2022 T processor or " │ │ │ -0020dc10: 646f 6374 7970 652d 7379 7374 656d 2220 doctype-system" │ │ │ -0020dc20: 6973 2073 6574 206f 7220 6174 206c 6561 is set or at lea │ │ │ -0020dc30: 7374 206f 6e65 206f 6620 7477 6f20 626f st one of two bo │ │ │ -0020dc40: 6f6c 6561 6e20 7072 6f70 6572 7469 6573 olean properties │ │ │ -0020dc50: 2022 6f6d 6974 2d78 6d6c 2d64 6563 6c61 "omit-xml-decla │ │ │ -0020dc60: 7261 7469 6f6e 220a 2020 2020 0961 6e64 ration". .and │ │ │ -0020dc70: 2022 7374 616e 6461 6c6f 6e65 2220 6973 "standalone" is │ │ │ -0020dc80: 2073 6574 2074 6f20 2279 6573 222e 3c2f set to "yes".. │ │ │ -0020dca0: 4163 636f 7264 696e 6720 746f 2074 6865 According to the │ │ │ -0020dcb0: 2044 5444 2072 756c 6573 2c20 2264 6f63 DTD rules, "doc │ │ │ -0020dcc0: 7479 7065 2d70 7562 6c69 6322 2068 6173 type-public" has │ │ │ -0020dcd0: 206e 6f20 6566 6665 6374 206f 6e20 7365 no effect on se │ │ │ -0020dce0: 7269 616c 697a 6174 696f 6e20 6966 2022 rialization if " │ │ │ -0020dcf0: 646f 6374 7970 652d 7379 7374 656d 2220 doctype-system" │ │ │ -0020dd00: 6973 206e 6f74 2073 6574 2e3c 2f70 6172 is not set.. │ │ │ -0020dd20: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ -0020dd50: 2020 2020 3c74 6974 6c65 3e50 6172 616d Param │ │ │ -0020dd60: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -0020dd70: 2020 3c72 6566 7365 6374 323e 3c74 6974 xml_entity. An XML entity │ │ │ -0020ddb0: 7375 6368 2061 7320 7468 6174 2072 6574 such as that ret │ │ │ -0020ddc0: 7572 6e65 6420 6279 2074 6865 2078 736c urned by the xsl │ │ │ -0020ddd0: 7428 2920 6675 6e63 7469 6f6e 2e3c 2f70 t() function.

    .
    . option │ │ │ -0020de10: 5f6e 616d 653c 2f74 6974 6c65 3e0a 2020 _name. │ │ │ -0020de20: 2020 2020 3c70 6172 613e 4120 6e61 6d65 A name │ │ │ -0020de30: 206f 6620 6f75 7470 7574 206f 7074 696f of output optio │ │ │ -0020de40: 6e20 746f 2069 6e20 7175 6573 7469 6f6e n to in question │ │ │ -0020de50: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . op │ │ │ -0020de80: 7469 6f6e 5f76 616c 7565 3c2f 7469 746c tion_value</titl │ │ │ -0020de90: 653e 0a20 2020 2020 203c 7061 7261 3e41 e>. <para>A │ │ │ -0020dea0: 206e 6577 2076 616c 7565 206f 6620 6f75 new value of ou │ │ │ -0020deb0: 7470 7574 206f 7074 696f 6e2e 2054 6869 tput option. Thi │ │ │ -0020dec0: 7320 6973 2061 2073 7472 696e 6720 6f72 s is a string or │ │ │ -0020ded0: 204e 554c 4c20 2874 6861 7420 7265 7365 NULL (that rese │ │ │ -0020dee0: 7420 6f70 7469 6f6e 2074 6f20 6465 6661 t option to defa │ │ │ -0020def0: 756c 7429 2e20 416c 6c6f 7765 6420 7661 ult). Allowed va │ │ │ -0020df00: 6c75 6573 206f 660a 2020 2020 2020 0962 lues of. .b │ │ │ -0020df10: 6f6f 6c65 616e 2070 726f 7065 7274 6965 oolean propertie │ │ │ -0020df20: 7320 226f 6d69 742d 786d 6c2d 6465 636c s "omit-xml-decl │ │ │ -0020df30: 6172 6174 696f 6e22 2061 6e64 2022 7374 aration" and "st │ │ │ -0020df40: 616e 6461 6c6f 6e65 2220 6172 6520 2279 andalone" are "y │ │ │ -0020df50: 6573 2220 616e 6420 226e 6f22 2c20 6173 es" and "no", as │ │ │ -0020df60: 2069 7420 6973 2069 6e20 5853 4c54 2031 it is in XSLT 1 │ │ │ -0020df70: 2e30 2e3c 2f70 6172 613e 0a20 2020 203c .0.</para>. < │ │ │ -0020df80: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ -0020df90: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -0020dfa0: 6563 7431 2069 643d 2272 6574 5f78 6d6c ect1 id="ret_xml │ │ │ -0020dfb0: 5f64 6f63 5f6f 7574 7075 745f 6f70 7469 _doc_output_opti │ │ │ -0020dfc0: 6f6e 223e 3c74 6974 6c65 3e52 6574 7572 on"><title>Retur │ │ │ -0020dfd0: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ -0020dfe0: 2020 2020 3c70 6172 613e 5468 6520 6675 The fu │ │ │ -0020dff0: 6e63 7469 6f6e 2072 6574 7572 6e73 2061 nction returns a │ │ │ -0020e000: 2073 7472 696e 6720 7468 6174 2069 7320 string that is │ │ │ -0020e010: 6120 7661 6c75 6520 6f66 2074 6865 206f a value of the o │ │ │ -0020e020: 7074 696f 6e20 6f72 204e 554c 4c20 6966 ption or NULL if │ │ │ -0020e030: 2074 6865 206f 7074 696f 6e20 6973 206e the option is n │ │ │ -0020e040: 6f74 2073 6574 2e3c 2f70 6172 613e 0a20 ot set.. │ │ │ -0020e050: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -0020e060: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ -0020e070: 6f72 735f 786d 6c5f 646f 635f 6f75 7470 ors_xml_doc_outp │ │ │ -0020e080: 7574 5f6f 7074 696f 6e22 3e0a 2020 2020 ut_option">. │ │ │ -0020e090: 3c74 6974 6c65 3e45 7272 6f72 733c 2f74 Errors</t │ │ │ -0020e0a0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ -0020e0b0: 5468 6973 2066 756e 6374 696f 6e20 6361 This function ca │ │ │ -0020e0c0: 6e20 6765 6e65 7261 7465 2074 6865 2066 n generate the f │ │ │ -0020e0d0: 6f6c 6c6f 7769 6e67 2065 7272 6f72 733a ollowing errors: │ │ │ -0020e0e0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 </para>. <par │ │ │ -0020e0f0: 613e 3c65 7272 6f72 636f 6465 3e32 3230 a><errorcode>220 │ │ │ -0020e100: 3233 3c2f 6572 726f 7263 6f64 653e 203c 23</errorcode> < │ │ │ -0020e110: 6572 726f 7263 6f64 653e 5352 3030 333c errorcode>SR003< │ │ │ -0020e120: 2f65 7272 6f72 636f 6465 3e20 0a20 2020 /errorcode> . │ │ │ -0020e130: 2046 756e 6374 696f 6e20 786d 6c5f 646f Function xml_do │ │ │ -0020e140: 635f 6f75 7470 7574 5f6f 7074 696f 6e20 c_output_option │ │ │ -0020e150: 6e65 6564 7320 616e 2058 4d4c 2065 6e74 needs an XML ent │ │ │ -0020e160: 6974 7920 6173 2061 7267 756d 656e 7420 ity as argument │ │ │ -0020e170: 312c 206e 6f74 2061 6e20 6172 6720 6f66 1, not an arg of │ │ │ -0020e180: 2074 7970 6520 266c 743b 7479 7065 5f6e type <type_n │ │ │ -0020e190: 616d 6526 6774 3b20 2826 6c74 3b74 7970 ame> (<typ │ │ │ -0020e1a0: 6526 6774 3b29 3c2f 7061 7261 3e0a 2020 e>)</para>. │ │ │ -0020e1b0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ -0020e1c0: 6566 7365 6374 3120 6964 3d22 6578 616d efsect1 id="exam │ │ │ -0020e1d0: 706c 6573 5f78 6d6c 5f64 6f63 5f6f 7574 ples_xml_doc_out │ │ │ -0020e1e0: 7075 745f 6f70 7469 6f6e 223e 0a20 2020 put_option">. │ │ │ -0020e1f0: 203c 7469 746c 653e 4578 616d 706c 6573 <title>Examples │ │ │ -0020e200: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Asses │ │ │ -0020e240: 7369 6e67 2074 6865 2053 5953 5445 4d20 sing the SYSTEM │ │ │ -0020e250: 4454 4420 6c6f 6361 7469 6f6e 3c2f 7469 DTD location</ti │ │ │ -0020e260: 746c 653e 0a20 2020 2020 203c 7363 7265 tle>. <scre │ │ │ -0020e270: 656e 3e3c 215b 4344 4154 415b 0a63 7265 en><![CDATA[.cre │ │ │ -0020e280: 6174 6520 6675 6e63 7469 6f6e 2074 6573 ate function tes │ │ │ -0020e290: 745f 6f75 7470 7574 5f6f 7074 696f 6e20 t_output_option │ │ │ -0020e2a0: 280a 2020 696e 2063 6e74 2061 6e79 2c20 (. in cnt any, │ │ │ -0020e2b0: 696e 206f 7074 5f6e 616d 6520 616e 792c in opt_name any, │ │ │ -0020e2c0: 2069 6e20 6f70 745f 7661 6c75 6520 616e in opt_value an │ │ │ -0020e2d0: 7929 0a7b 0a20 2064 6563 6c61 7265 2078 y).{. declare x │ │ │ -0020e2e0: 742c 2073 6573 2061 6e79 3b0a 2020 6465 t, ses any;. de │ │ │ -0020e2f0: 636c 6172 6520 6f6c 6476 616c 2c20 6e65 clare oldval, ne │ │ │ -0020e300: 7776 616c 2076 6172 6368 6172 3b0a 2020 wval varchar;. │ │ │ -0020e310: 7874 203a 3d20 7874 7265 655f 646f 6320 xt := xtree_doc │ │ │ -0020e320: 2863 6e74 2c20 322c 2027 272c 2027 5554 (cnt, 2, '', 'UT │ │ │ -0020e330: 462d 3827 293b 0a20 206f 6c64 7661 6c20 F-8');. oldval │ │ │ -0020e340: 3a3d 2078 6d6c 5f64 6f63 5f6f 7574 7075 := xml_doc_outpu │ │ │ -0020e350: 745f 6f70 7469 6f6e 2028 7874 2c20 6f70 t_option (xt, op │ │ │ -0020e360: 745f 6e61 6d65 293b 0a20 2078 6d6c 5f64 t_name);. xml_d │ │ │ -0020e370: 6f63 5f6f 7574 7075 745f 6f70 7469 6f6e oc_output_option │ │ │ -0020e380: 2028 7874 2c20 6f70 745f 6e61 6d65 2c20 (xt, opt_name, │ │ │ -0020e390: 6f70 745f 7661 6c75 6529 3b0a 2020 6e65 opt_value);. ne │ │ │ -0020e3a0: 7776 616c 203a 3d20 786d 6c5f 646f 635f wval := xml_doc_ │ │ │ -0020e3b0: 6f75 7470 7574 5f6f 7074 696f 6e20 2878 output_option (x │ │ │ -0020e3c0: 742c 206f 7074 5f6e 616d 6529 3b0a 2020 t, opt_name);. │ │ │ -0020e3d0: 7265 7475 726e 2063 6f6e 6361 7420 280a return concat (. │ │ │ -0020e3e0: 2020 2020 7370 7269 6e74 6620 2827 4f6c sprintf ('Ol │ │ │ -0020e3f0: 6420 7661 6c75 6520 6f66 2022 2573 2220 d value of "%s" │ │ │ -0020e400: 6973 2022 2573 225c 6e4e 6577 2076 616c is "%s"\nNew val │ │ │ -0020e410: 7565 2069 7320 2225 7322 5c6e 5468 6520 ue is "%s"\nThe │ │ │ -0020e420: 7265 7375 6c74 3a5c 6e27 2c0a 2020 2020 result:\n',. │ │ │ -0020e430: 2020 206f 7074 5f6e 616d 652c 0a20 2020 opt_name,. │ │ │ -0020e440: 2020 2020 6361 7374 2028 6f6c 6476 616c cast (oldval │ │ │ -0020e450: 2061 7320 7661 7263 6861 7229 2c0a 2020 as varchar),. │ │ │ -0020e460: 2020 2020 2063 6173 7420 286e 6577 7661 cast (newva │ │ │ -0020e470: 6c20 6173 2076 6172 6368 6172 2920 292c l as varchar) ), │ │ │ -0020e480: 0a20 2020 2073 6572 6961 6c69 7a65 5f74 . serialize_t │ │ │ -0020e490: 6f5f 5554 4638 5f78 6d6c 2028 7874 2920 o_UTF8_xml (xt) │ │ │ -0020e4a0: 293b 0a7d 0a0a 7365 6c65 6374 2074 6573 );.}..select tes │ │ │ -0020e4b0: 745f 6f75 7470 7574 5f6f 7074 696f 6e20 t_output_option │ │ │ -0020e4c0: 280a 2020 273c 6469 7620 786d 6c6e 733d (. '<div xmlns= │ │ │ -0020e4d0: 2268 7474 703a 2f2f 7777 772e 7733 2e6f "http://www.w3.o │ │ │ -0020e4e0: 7267 2f31 3939 392f 7868 746d 6c22 3e48 rg/1999/xhtml">H │ │ │ -0020e4f0: 656c 6c6f 3c2f 6469 763e 272c 0a20 2027 ello</div>',. ' │ │ │ -0020e500: 646f 6374 7970 652d 7379 7374 656d 272c doctype-system', │ │ │ -0020e510: 2027 6874 7470 3a2f 2f77 7777 2e65 7861 'http://www.exa │ │ │ -0020e520: 6d70 6c65 2e63 6f6d 2f78 6874 6d6c 2e64 mple.com/xhtml.d │ │ │ -0020e530: 7464 2729 0a63 616c 6c72 6574 0a56 4152 td').callret.VAR │ │ │ -0020e540: 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f CHAR.___________ │ │ │ -0020e550: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0020e560: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0020e570: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0020e580: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0020e590: 5f5f 5f5f 0a0a 4f6c 6420 7661 6c75 6520 ____..Old value │ │ │ -0020e5a0: 6f66 2022 646f 6374 7970 652d 7379 7374 of "doctype-syst │ │ │ -0020e5b0: 656d 2220 6973 2022 284e 554c 4c29 220a em" is "(NULL)". │ │ │ -0020e5c0: 4e65 7720 7661 6c75 6520 6973 2022 6874 New value is "ht │ │ │ -0020e5d0: 7470 3a2f 2f77 7777 2e65 7861 6d70 6c65 tp://www.example │ │ │ -0020e5e0: 2e63 6f6d 2f78 6874 6d6c 2e64 7464 220a .com/xhtml.dtd". │ │ │ -0020e5f0: 5468 6520 7265 7375 6c74 3a0a 3c3f 786d The result:.<?xm │ │ │ -0020e600: 6c20 7665 7273 696f 6e3d 2231 2e30 2220 l version="1.0" │ │ │ -0020e610: 656e 636f 6469 6e67 3d22 5554 462d 3822 encoding="UTF-8" │ │ │ -0020e620: 203f 3e0a 3c21 444f 4354 5950 4520 6874 ?>.<!DOCTYPE ht │ │ │ -0020e630: 7470 3a2f 2f77 7777 2e77 332e 6f72 672f tp://www.w3.org/ │ │ │ -0020e640: 3139 3939 2f78 6874 6d6c 3a64 6976 0a20 1999/xhtml:div. │ │ │ -0020e650: 2053 5953 5445 4d20 2268 7474 703a 2f2f SYSTEM "http:// │ │ │ -0020e660: 7777 772e 6578 616d 706c 652e 636f 6d2f www.example.com/ │ │ │ -0020e670: 7868 746d 6c2e 6474 6422 3e0a 3c6e 303a xhtml.dtd">.<n0: │ │ │ -0020e680: 6469 7620 786d 6c6e 733a 6e30 3d22 6874 div xmlns:n0="ht │ │ │ -0020e690: 7470 3a2f 2f77 7777 2e77 332e 6f72 672f tp://www.w3.org/ │ │ │ -0020e6a0: 3139 3939 2f78 6874 6d6c 223e 4865 6c6c 1999/xhtml">Hell │ │ │ -0020e6b0: 6f3c 2f6e 303a 6469 763e 0a0a 3120 526f o</n0:div>..1 Ro │ │ │ -0020e6c0: 7773 2e20 2d2d 2031 206d 7365 632e 0a5d ws. -- 1 msec..] │ │ │ -0020e6d0: 5d3e 0a3c 2f73 6372 6565 6e3e 0a20 2020 ]>.</screen>. │ │ │ -0020e6e0: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f </example>. </ │ │ │ -0020e6f0: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -0020e700: 7365 6374 3120 6964 3d22 7365 6561 6c73 sect1 id="seeals │ │ │ -0020e710: 6f5f 786d 6c5f 646f 635f 6f75 7470 7574 o_xml_doc_output │ │ │ -0020e720: 5f6f 7074 696f 6e22 3e0a 2020 2020 3c74 _option">. <t │ │ │ -0020e730: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ -0020e740: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ -0020e750: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ -0020e760: 6e5f 7874 7265 655f 646f 6322 3e3c 6675 n_xtree_doc"><fu │ │ │ -0020e770: 6e63 7469 6f6e 3e78 7472 6565 5f64 6f63 nction>xtree_doc │ │ │ -0020e780: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ -0020e790: 696e 6b3e 3c2f 7061 7261 3e0a 2020 3c2f ink></para>. </ │ │ │ -0020e7a0: 7265 6673 6563 7431 3e0a 3c2f 7265 6665 refsect1>.</refe │ │ │ -0020e7b0: 6e74 7279 3e0a b600 0000 1f64 656d 6f2f ntry>......demo/ │ │ │ -0020e7c0: 646f 6373 7263 2f66 756e 6372 6566 2f78 docsrc/funcref/x │ │ │ -0020e7d0: 6d6c 5f63 7574 2e78 6d6c df00 0016 083c ml_cut.xml.....< │ │ │ -0020e7e0: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ -0020e7f0: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ -0020e800: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>.<!--. │ │ │ -0020e810: 202d 2020 0a20 2d20 2054 6869 7320 6669 - . - This fi │ │ │ -0020e820: 6c65 2069 7320 7061 7274 206f 6620 7468 le is part of th │ │ │ -0020e830: 6520 4f70 656e 4c69 6e6b 2053 6f66 7477 e OpenLink Softw │ │ │ -0020e840: 6172 6520 5669 7274 756f 736f 204f 7065 are Virtuoso Ope │ │ │ -0020e850: 6e2d 536f 7572 6365 2028 564f 5329 0a20 n-Source (VOS). │ │ │ -0020e860: 2d20 2070 726f 6a65 6374 2e0a 202d 2020 - project.. - │ │ │ -0020e870: 0a20 2d20 2043 6f70 7972 6967 6874 2028 . - Copyright ( │ │ │ -0020e880: 4329 2031 3939 382d 3230 3234 204f 7065 C) 1998-2024 Ope │ │ │ -0020e890: 6e4c 696e 6b20 536f 6674 7761 7265 0a20 nLink Software. │ │ │ -0020e8a0: 2d20 200a 202d 2020 5468 6973 2070 726f - . - This pro │ │ │ -0020e8b0: 6a65 6374 2069 7320 6672 6565 2073 6f66 ject is free sof │ │ │ -0020e8c0: 7477 6172 653b 2079 6f75 2063 616e 2072 tware; you can r │ │ │ -0020e8d0: 6564 6973 7472 6962 7574 6520 6974 2061 edistribute it a │ │ │ -0020e8e0: 6e64 2f6f 7220 6d6f 6469 6679 2069 740a nd/or modify it. │ │ │ -0020e8f0: 202d 2020 756e 6465 7220 7468 6520 7465 - under the te │ │ │ -0020e900: 726d 7320 6f66 2074 6865 2047 4e55 2047 rms of the GNU G │ │ │ -0020e910: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -0020e920: 6365 6e73 6520 6173 2070 7562 6c69 7368 cense as publish │ │ │ -0020e930: 6564 2062 7920 7468 650a 202d 2020 4672 ed by the. - Fr │ │ │ -0020e940: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ -0020e950: 6461 7469 6f6e 3b20 6f6e 6c79 2076 6572 dation; only ver │ │ │ -0020e960: 7369 6f6e 2032 206f 6620 7468 6520 4c69 sion 2 of the Li │ │ │ -0020e970: 6365 6e73 652c 2064 6174 6564 204a 756e cense, dated Jun │ │ │ -0020e980: 6520 3139 3931 2e0a 202d 2020 0a20 2d20 e 1991.. - . - │ │ │ -0020e990: 2054 6869 7320 7072 6f67 7261 6d20 6973 This program is │ │ │ -0020e9a0: 2064 6973 7472 6962 7574 6564 2069 6e20 distributed in │ │ │ -0020e9b0: 7468 6520 686f 7065 2074 6861 7420 6974 the hope that it │ │ │ -0020e9c0: 2077 696c 6c20 6265 2075 7365 6675 6c2c will be useful, │ │ │ -0020e9d0: 2062 7574 0a20 2d20 2057 4954 484f 5554 but. - WITHOUT │ │ │ -0020e9e0: 2041 4e59 2057 4152 5241 4e54 593b 2077 ANY WARRANTY; w │ │ │ -0020e9f0: 6974 686f 7574 2065 7665 6e20 7468 6520 ithout even the │ │ │ -0020ea00: 696d 706c 6965 6420 7761 7272 616e 7479 implied warranty │ │ │ -0020ea10: 206f 660a 202d 2020 4d45 5243 4841 4e54 of. - MERCHANT │ │ │ -0020ea20: 4142 494c 4954 5920 6f72 2046 4954 4e45 ABILITY or FITNE │ │ │ -0020ea30: 5353 2046 4f52 2041 2050 4152 5449 4355 SS FOR A PARTICU │ │ │ -0020ea40: 4c41 5220 5055 5250 4f53 452e 2053 6565 LAR PURPOSE. See │ │ │ -0020ea50: 2074 6865 2047 4e55 0a20 2d20 2047 656e the GNU. - Gen │ │ │ -0020ea60: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ -0020ea70: 6e73 6520 666f 7220 6d6f 7265 2064 6574 nse for more det │ │ │ -0020ea80: 6169 6c73 2e0a 202d 2020 0a20 2d20 2059 ails.. - . - Y │ │ │ -0020ea90: 6f75 2073 686f 756c 6420 6861 7665 2072 ou should have r │ │ │ -0020eaa0: 6563 6569 7665 6420 6120 636f 7079 206f eceived a copy o │ │ │ -0020eab0: 6620 7468 6520 474e 5520 4765 6e65 7261 f the GNU Genera │ │ │ -0020eac0: 6c20 5075 626c 6963 204c 6963 656e 7365 l Public License │ │ │ -0020ead0: 2061 6c6f 6e67 0a20 2d20 2077 6974 6820 along. - with │ │ │ -0020eae0: 7468 6973 2070 726f 6772 616d 3b20 6966 this program; if │ │ │ -0020eaf0: 206e 6f74 2c20 7772 6974 6520 746f 2074 not, write to t │ │ │ -0020eb00: 6865 2046 7265 6520 536f 6674 7761 7265 he Free Software │ │ │ -0020eb10: 2046 6f75 6e64 6174 696f 6e2c 2049 6e63 Foundation, Inc │ │ │ -0020eb20: 2e2c 0a20 2d20 2035 3120 4672 616e 6b6c .,. - 51 Frankl │ │ │ -0020eb30: 696e 2053 742c 2046 6966 7468 2046 6c6f in St, Fifth Flo │ │ │ -0020eb40: 6f72 2c20 426f 7374 6f6e 2c20 4d41 2030 or, Boston, MA 0 │ │ │ -0020eb50: 3231 3130 2d31 3330 3120 5553 410a 202d 2110-1301 USA. - │ │ │ -0020eb60: 2020 0a20 2d20 200a 2d2d 3e0a 3c72 6566 . - .-->.<ref │ │ │ -0020eb70: 656e 7472 7920 6964 3d22 666e 5f78 6d6c entry id="fn_xml │ │ │ -0020eb80: 5f63 7574 223e 0a20 203c 7265 666d 6574 _cut">. <refmet │ │ │ -0020eb90: 613e 0a20 2020 203c 7265 6665 6e74 7279 a>. <refentry │ │ │ -0020eba0: 7469 746c 653e 786d 6c5f 6375 743c 2f72 title>xml_cut</r │ │ │ -0020ebb0: 6566 656e 7472 7974 6974 6c65 3e0a 2020 efentrytitle>. │ │ │ -0020ebc0: 2020 3c72 6566 6d69 7363 696e 666f 3e78 <refmiscinfo>x │ │ │ -0020ebd0: 6d6c 3c2f 7265 666d 6973 6369 6e66 6f3e ml</refmiscinfo> │ │ │ -0020ebe0: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . </refmeta>. │ │ │ -0020ebf0: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 <refnamediv>. │ │ │ -0020ec00: 203c 7265 666e 616d 653e 786d 6c5f 6375 <refname>xml_cu │ │ │ -0020ec10: 743c 2f72 6566 6e61 6d65 3e0a 2020 2020 t</refname>. │ │ │ -0020ec20: 3c72 6566 7075 7270 6f73 653e 6372 6561 <refpurpose>crea │ │ │ -0020ec30: 7465 7320 6120 6e65 7720 584d 4c20 646f tes a new XML do │ │ │ -0020ec40: 6375 6d65 6e74 2077 6869 6368 2063 6f6e cument which con │ │ │ -0020ec50: 7461 696e 7320 6120 636f 7079 206f 6620 tains a copy of │ │ │ -0020ec60: 6461 7461 2070 6f69 6e74 6564 2062 7920 data pointed by │ │ │ -0020ec70: 6769 7665 6e20 584d 4c20 7472 6565 2d20 given XML tree- │ │ │ -0020ec80: 6f72 2058 5045 522d 2065 6e74 6974 793c or XPER- entity< │ │ │ -0020ec90: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -0020eca0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -0020ecb0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -0020ecc0: 2020 2020 3c66 756e 6373 796e 6f70 7369 <funcsynopsi │ │ │ -0020ecd0: 7320 6964 3d22 6673 796e 5f6d 6c5f 6375 s id="fsyn_ml_cu │ │ │ -0020ece0: 7422 3e0a 2020 2020 2020 3c66 756e 6370 t">. <funcp │ │ │ -0020ecf0: 726f 746f 7479 7065 2069 643d 2266 7072 rototype id="fpr │ │ │ -0020ed00: 6f74 6f5f 786d 6c5f 6375 7422 3e0a 2020 oto_xml_cut">. │ │ │ -0020ed10: 2020 2020 2020 3c66 756e 6364 6566 3e3c <funcdef>< │ │ │ -0020ed20: 6675 6e63 7469 6f6e 3e78 6d6c 5f63 7574 function>xml_cut │ │ │ -0020ed30: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e </function></fun │ │ │ -0020ed40: 6364 6566 3e0a 2020 2020 2020 2020 3c70 cdef>. <p │ │ │ -0020ed50: 6172 616d 6465 663e 696e 203c 7061 7261 aramdef>in <para │ │ │ -0020ed60: 6d65 7465 723e 736f 7572 6365 5f65 6e74 meter>source_ent │ │ │ -0020ed70: 6974 793c 2f70 6172 616d 6574 6572 3e20 ity</parameter> │ │ │ -0020ed80: 616e 7920 2858 4d4c 2065 6e74 6974 7929 any (XML entity) │ │ │ -0020ed90: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ -0020eda0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 </funcprototyp │ │ │ -0020edb0: 653e 0a20 2020 203c 2f66 756e 6373 796e e>. </funcsyn │ │ │ -0020edc0: 6f70 7369 733e 0a20 203c 2f72 6566 7379 opsis>. </refsy │ │ │ -0020edd0: 6e6f 7073 6973 6469 763e 0a20 203c 7265 nopsisdiv>. <re │ │ │ -0020ede0: 6673 6563 7431 2069 643d 2264 6573 6322 fsect1 id="desc" │ │ │ -0020edf0: 3e3c 7469 746c 653e 4465 7363 7269 7074 ><title>Descript │ │ │ -0020ee00: 696f 6e3c 2f74 6974 6c65 3e0a 0909 3c70 ion...

    .In some spe │ │ │ -0020ee20: 6369 616c 2063 6173 6573 2c20 736f 6d65 cial cases, some │ │ │ -0020ee30: 2070 6172 7420 6f66 2058 4d4c 2064 6f63 part of XML doc │ │ │ -0020ee40: 756d 656e 742c 0a62 6569 6e67 2070 6f69 ument,.being poi │ │ │ -0020ee50: 6e74 6564 2062 7920 6120 584d 4c20 656e nted by a XML en │ │ │ -0020ee60: 7469 7479 2c20 7368 6f75 6c64 2062 6520 tity, should be │ │ │ -0020ee70: 636f 7069 6564 2069 6e74 6f20 6120 6e65 copied into a ne │ │ │ -0020ee80: 7720 7365 7061 7261 7465 2064 6f63 756d w separate docum │ │ │ -0020ee90: 656e 740a 7769 7468 206e 6577 2065 6e74 ent.with new ent │ │ │ -0020eea0: 6974 7920 706f 696e 7469 6e67 2074 6f20 ity pointing to │ │ │ -0020eeb0: 7468 6520 746f 702d 6c65 7665 6c20 656c the top-level el │ │ │ -0020eec0: 656d 656e 7420 6f72 2074 6865 2072 6f6f ement or the roo │ │ │ -0020eed0: 7420 6f66 2074 6869 7320 646f 6375 6d65 t of this docume │ │ │ -0020eee0: 6e74 2e0a 4f6e 6520 7265 6173 6f6e 2066 nt..One reason f │ │ │ -0020eef0: 6f72 2064 6f69 6e67 2074 6869 7320 6973 or doing this is │ │ │ -0020ef00: 206f 7074 696d 697a 6174 696f 6e20 6f66 optimization of │ │ │ -0020ef10: 2058 5045 5220 7072 6f63 6573 7369 6e67 XPER processing │ │ │ -0020ef20: 2028 7365 6520 3c6c 696e 6b20 6c69 6e6b (see xper_cut)..Another way │ │ │ -0020ef60: 746f 2075 7365 2074 6869 7320 6675 6e63 to use this func │ │ │ -0020ef70: 7469 6f6e 616c 6974 7920 6973 2070 6173 tionality is pas │ │ │ -0020ef80: 7369 6e67 206f 6620 736f 6d65 2058 4d4c sing of some XML │ │ │ -0020ef90: 2065 6e74 6974 790a 746f 2061 2066 756e entity.to a fun │ │ │ -0020efa0: 6374 696f 6e2c 2077 6865 6e20 6675 6e63 ction, when func │ │ │ -0020efb0: 7469 6f6e 2075 7365 7320 5850 6174 6820 tion uses XPath │ │ │ -0020efc0: 6f70 6572 6174 696f 6e73 2077 6974 6820 operations with │ │ │ -0020efd0: 7265 6665 7265 6e63 6573 2074 6f0a 7468 references to.th │ │ │ -0020efe0: 6520 2671 756f 743b 646f 6375 6d65 6e74 e "document │ │ │ -0020eff0: 2773 2072 6f6f 7426 7175 6f74 3b2e 0a09 's root"... │ │ │ -0020f000: 093c 2f70 6172 613e 0a20 2020 203c 6578 .. A s │ │ │ -0020f030: 616d 706c 6520 6f66 2068 6964 6465 6e20 ample of hidden │ │ │ -0020f040: 6275 673c 2f74 6974 6c65 3e0a 2020 2020 bug. │ │ │ -0020f050: 2020 3c70 6172 613e 3c2f 7061 7261 3e0a . │ │ │ -0020f060: 2020 2020 2020 3c73 6372 6565 6e3e 0a63 .c │ │ │ -0020f070: 7265 6174 6520 7072 6f63 6564 7572 6520 reate procedure │ │ │ -0020f080: 6765 745f 4320 2869 6e6f 7574 2062 2061 get_C (inout b a │ │ │ -0020f090: 6e79 290a 7b0a 2020 7265 7475 726e 2063 ny).{. return c │ │ │ -0020f0a0: 6173 7420 2878 7061 7468 5f65 7661 6c28 ast (xpath_eval( │ │ │ -0020f0b0: 272f 2f43 272c 2062 2920 6173 2076 6172 '//C', b) as var │ │ │ -0020f0c0: 6368 6172 293b 0a7d 0a0a 6372 6561 7465 char);.}..create │ │ │ -0020f0d0: 2070 726f 6365 6475 7265 2068 6964 6465 procedure hidde │ │ │ -0020f0e0: 6e5f 6275 675f 3128 290a 7b0a 2020 6465 n_bug_1().{. de │ │ │ -0020f0f0: 636c 6172 6520 6162 6320 616e 793b 092d clare abc any;.- │ │ │ -0020f100: 2d20 736f 6d65 2058 4d4c 2064 6f63 756d - some XML docum │ │ │ -0020f110: 656e 740a 2020 6465 636c 6172 6520 625f ent. declare b_ │ │ │ -0020f120: 6c69 7374 2061 6e79 3b09 2d2d 2061 2076 list any;.-- a v │ │ │ -0020f130: 6563 746f 7220 6f66 2061 6c6c 2042 2065 ector of all B e │ │ │ -0020f140: 6c65 6d65 6e74 7320 6f66 2074 6865 2064 lements of the d │ │ │ -0020f150: 6f63 0a20 2064 6563 6c61 7265 2063 3120 oc. declare c1 │ │ │ -0020f160: 7661 7263 6861 723b 092d 2d20 6120 6e61 varchar;.-- a na │ │ │ -0020f170: 6d65 206f 6620 6669 7273 7420 7661 7269 me of first vari │ │ │ -0020f180: 6162 6c65 0a20 2064 6563 6c61 7265 2063 able. declare c │ │ │ -0020f190: 3220 7661 7263 6861 723b 092d 2d20 6120 2 varchar;.-- a │ │ │ -0020f1a0: 7469 746c 6520 6f66 2073 6563 6f6e 6420 title of second │ │ │ -0020f1b0: 7661 7269 6162 6c65 0a20 2061 6263 203a variable. abc : │ │ │ -0020f1c0: 3d20 7874 7265 655f 646f 6320 2827 266c = xtree_doc ('&l │ │ │ -0020f1d0: 743b 4126 6774 3b26 6c74 3b42 2069 643d t;A><B id= │ │ │ -0020f1e0: 2231 2226 6774 3b26 6c74 3b43 2667 743b "1"><C> │ │ │ -0020f1f0: 4f6e 6526 6c74 3b2f 4326 6774 3b26 6c74 One</C>< │ │ │ -0020f200: 3b2f 4226 6774 3b26 6c74 3b42 2069 643d ;/B><B id= │ │ │ -0020f210: 2232 2226 6774 3b26 6c74 3b43 2667 743b "2"><C> │ │ │ -0020f220: 5477 6f26 6c74 3b2f 4326 6774 3b26 6c74 Two</C>< │ │ │ -0020f230: 3b2f 4226 6774 3b26 6c74 3b2f 4126 6774 ;/B></A> │ │ │ -0020f240: 3b27 293b 0a20 2062 5f6c 6973 7420 3a3d ;');. b_list := │ │ │ -0020f250: 2078 7061 7468 5f65 7661 6c20 2827 2f2f xpath_eval ('// │ │ │ -0020f260: 4227 2c20 6162 632c 2030 293b 0a20 202d B', abc, 0);. - │ │ │ -0020f270: 2d20 6e6f 7720 625f 6c69 7374 2069 7320 - now b_list is │ │ │ -0020f280: 6120 7665 6374 6f72 206f 6620 7477 6f20 a vector of two │ │ │ -0020f290: 6974 656d 732c 2027 266c 743b 4220 6964 items, '<B id │ │ │ -0020f2a0: 3d22 3122 2667 743b 266c 743b 4326 6774 ="1"><C> │ │ │ -0020f2b0: 3b4f 6e65 266c 743b 2f43 2667 743b 266c ;One</C>&l │ │ │ -0020f2c0: 743b 2f42 2667 743b 2720 616e 6420 2726 t;/B>' and '& │ │ │ -0020f2d0: 6c74 3b42 2069 643d 2232 2226 6774 3b26 lt;B id="2">& │ │ │ -0020f2e0: 6c74 3b43 2667 743b 5477 6f26 6c74 3b2f lt;C>Two</ │ │ │ -0020f2f0: 4326 6774 3b26 6c74 3b2f 4226 6774 3b27 C></B>' │ │ │ -0020f300: 2e0a 2020 6331 203a 3d20 6765 745f 4320 .. c1 := get_C │ │ │ -0020f310: 2820 6172 6566 2028 625f 6c69 7374 2c20 ( aref (b_list, │ │ │ -0020f320: 3029 293b 0a20 202d 2d20 6c6f 6f6b 7320 0));. -- looks │ │ │ -0020f330: 6669 6e65 2c20 6331 2069 7320 2726 6c74 fine, c1 is '< │ │ │ -0020f340: 3b43 2667 743b 4f6e 6526 6c74 3b2f 4326 ;C>One</C& │ │ │ -0020f350: 6774 3b27 0a20 2063 3220 3a3d 2067 6574 gt;'. c2 := get │ │ │ -0020f360: 5f43 2028 2061 7265 6620 2862 5f6c 6973 _C ( aref (b_lis │ │ │ -0020f370: 742c 2031 2929 3b0a 2020 2d2d 206c 6f6f t, 1));. -- loo │ │ │ -0020f380: 6b73 2073 7472 616e 6765 2066 696e 652c ks strange fine, │ │ │ -0020f390: 2063 3220 6973 2027 266c 743b 4326 6774 c2 is '<C> │ │ │ -0020f3a0: 3b4f 6e65 266c 743b 2f43 2667 743b 272c ;One</C>', │ │ │ -0020f3b0: 0a20 202d 2d20 7768 696c 6520 7468 6520 . -- while the │ │ │ -0020f3c0: 6578 7065 6374 6564 2076 616c 7565 2069 expected value i │ │ │ -0020f3d0: 7320 2726 6c74 3b43 2667 743b 5477 6f26 s '<C>Two& │ │ │ -0020f3e0: 6c74 3b2f 4326 6774 3b27 2e0a 7d0a 2020 lt;/C>'..}. │ │ │ -0020f3f0: 2020 2020 3c2f 7363 7265 656e 3e0a 2020 . │ │ │ -0020f400: 2020 2020 3c70 6172 613e 0a54 6865 206f .The o │ │ │ -0020f410: 7269 6769 6e20 6f66 2074 6865 2062 7567 rigin of the bug │ │ │ -0020f420: 2069 7320 272f 2f43 2720 7061 7468 2069 is '//C' path i │ │ │ -0020f430: 6e20 6765 745f 4328 292c 2077 6869 6368 n get_C(), which │ │ │ -0020f440: 2072 6574 7572 6e73 206e 6f74 0a74 6865 returns not.the │ │ │ -0020f450: 2022 4320 656c 656d 656e 7420 696e 7369 "C element insi │ │ │ -0020f460: 6465 2067 6976 656e 2062 2065 6c65 6d65 de given b eleme │ │ │ -0020f470: 6e74 222c 2062 7574 0a22 4320 656c 656d nt", but."C elem │ │ │ -0020f480: 656e 7420 696e 7369 6465 2074 6865 2064 ent inside the d │ │ │ -0020f490: 6f63 756d 656e 7420 7768 6572 6520 6769 ocument where gi │ │ │ -0020f4a0: 7665 6e20 6220 656c 656d 656e 7420 6973 ven b element is │ │ │ -0020f4b0: 206c 6f63 6174 6564 222c 0a74 6875 7320 located",.thus │ │ │ -0020f4c0: 6765 745f 4320 7265 7475 726e 7320 7468 get_C returns th │ │ │ -0020f4d0: 6520 6669 7273 7420 4320 656c 656d 656e e first C elemen │ │ │ -0020f4e0: 7420 696e 2074 6865 2077 686f 6c65 2064 t in the whole d │ │ │ -0020f4f0: 6f63 756d 656e 7420 7769 7468 2061 6e79 ocument with any │ │ │ -0020f500: 206f 660a 7477 6f20 4220 656c 656d 656e of.two B elemen │ │ │ -0020f510: 7473 2067 6976 656e 2e0a 2020 2020 2020 ts given.. │ │ │ -0020f520: 3c2f 7061 7261 3e0a 2020 2020 2020 3c70 .

    .There are t │ │ │ -0020f540: 776f 2077 6179 7320 746f 2066 6978 2074 wo ways to fix t │ │ │ -0020f550: 6869 7320 6275 672e 0a49 7420 6973 2062 his bug..It is b │ │ │ -0020f560: 6574 7465 7220 746f 2063 6f72 7265 6374 etter to correct │ │ │ -0020f570: 2067 6574 5f43 2829 3a0a 2020 2020 2020 get_C():. │ │ │ -0020f580: 3c2f 7061 7261 3e0a 2020 2020 2020 3c73 . .create pr │ │ │ -0020f5a0: 6f63 6564 7572 6520 6765 745f 4320 2869 ocedure get_C (i │ │ │ -0020f5b0: 6e6f 7574 2062 2061 6e79 290a 7b0a 2020 nout b any).{. │ │ │ -0020f5c0: 7265 7475 726e 2063 6173 7420 2878 7061 return cast (xpa │ │ │ -0020f5d0: 7468 5f65 7661 6c28 272e 2f43 272c 2062 th_eval('./C', b │ │ │ -0020f5e0: 2920 6173 2076 6172 6368 6172 293b 0a7d ) as varchar);.} │ │ │ -0020f5f0: 0a20 2020 2020 203c 2f73 6372 6565 6e3e . │ │ │ -0020f600: 0a20 2020 2020 203c 7061 7261 3e0a 4966 . .If │ │ │ -0020f610: 2079 6f75 2063 616e 6e6f 7420 7061 7463 you cannot patc │ │ │ -0020f620: 6820 6765 745f 4328 2920 666f 7220 736f h get_C() for so │ │ │ -0020f630: 6d65 2072 6561 736f 6e2c 2078 6d6c 5f63 me reason, xml_c │ │ │ -0020f640: 7574 2077 696c 6c20 6865 6c70 2c0a 6275 ut will help,.bu │ │ │ -0020f650: 7420 6974 2077 696c 6c20 7761 7374 6520 t it will waste │ │ │ -0020f660: 626f 7468 206d 656d 6f72 7920 616e 6420 both memory and │ │ │ -0020f670: 4350 5520 7469 6d65 2066 6f72 2063 6f70 CPU time for cop │ │ │ -0020f680: 7969 6e67 2061 2062 7261 6e63 6820 6f66 ying a branch of │ │ │ -0020f690: 0a58 4d4c 2074 7265 653a 0a20 2020 2020 .XML tree:. │ │ │ -0020f6a0: 203c 2f70 6172 613e 0a20 2020 2020 203c . < │ │ │ -0020f6b0: 7363 7265 656e 3e0a 6372 6561 7465 2070 screen>.create p │ │ │ -0020f6c0: 726f 6365 6475 7265 2068 6964 6465 6e5f rocedure hidden_ │ │ │ -0020f6d0: 6275 675f 3128 290a 7b0a 2e2e 2e0a 2020 bug_1().{..... │ │ │ -0020f6e0: 6331 203a 3d20 6765 745f 4320 2820 786d c1 := get_C ( xm │ │ │ -0020f6f0: 6c5f 6375 7420 2861 7265 6620 2862 5f6c l_cut (aref (b_l │ │ │ -0020f700: 6973 742c 2030 2929 293b 0a2e 2e2e 0a7d ist, 0)));.....} │ │ │ -0020f710: 0a20 2020 2020 203c 2f73 6372 6565 6e3e . │ │ │ -0020f720: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -0020f730: 2020 2020 2020 3c70 6172 613e 0a54 6865 .The │ │ │ -0020f740: 2063 7572 7265 6e74 206e 6f64 6520 6f66 current node of │ │ │ -0020f750: 2074 6865 2072 6573 756c 7469 6e67 2065 the resulting e │ │ │ -0020f760: 6e74 6974 7920 6973 2074 6865 206e 6f64 ntity is the nod │ │ │ -0020f770: 6520 7468 6174 2069 7320 6120 636f 7079 e that is a copy │ │ │ -0020f780: 0a6f 6620 7468 6520 6375 7272 656e 7420 .of the current │ │ │ -0020f790: 6e6f 6465 206f 6620 7468 6520 736f 7572 node of the sour │ │ │ -0020f7a0: 6365 2065 6e74 6974 792e 2049 6e20 636f ce entity. In co │ │ │ -0020f7b0: 6d6d 6f6e 2c0a 7468 6520 746f 702d 6c65 mmon,.the top-le │ │ │ -0020f7c0: 7665 6c20 6e6f 6465 206f 6620 7468 6520 vel node of the │ │ │ -0020f7d0: 636f 7069 6564 2073 7562 7472 6565 2062 copied subtree b │ │ │ -0020f7e0: 6563 6f6d 6573 2074 6865 2063 7572 7265 ecomes the curre │ │ │ -0020f7f0: 6e74 206e 6f64 6520 6f66 2074 6865 2072 nt node of the r │ │ │ -0020f800: 6573 756c 742e 0a54 6865 7265 2061 7265 esult..There are │ │ │ -0020f810: 2074 776f 2073 7065 6369 616c 2063 6173 two special cas │ │ │ -0020f820: 6573 2c20 686f 7765 7665 722e 2049 6620 es, however. If │ │ │ -0020f830: 7468 6520 736f 7572 6365 2065 6e74 6974 the source entit │ │ │ -0020f840: 7920 6973 2061 6e20 6174 7472 6962 7574 y is an attribut │ │ │ -0020f850: 6520 656e 7469 7479 2c0a 7468 656e 2074 e entity,.then t │ │ │ -0020f860: 6865 2072 6573 756c 7420 6973 2061 6c73 he result is als │ │ │ -0020f870: 6f20 616e 2061 7474 7269 6275 7465 2065 o an attribute e │ │ │ -0020f880: 6e74 6974 7920 616e 6420 7468 6520 6174 ntity and the at │ │ │ -0020f890: 7472 6962 7574 6520 6e61 6d65 2072 656d tribute name rem │ │ │ -0020f8a0: 6169 6e73 2074 6865 2073 616d 652e 0a49 ains the same..I │ │ │ -0020f8b0: 6620 7468 6520 736f 7572 6365 2065 6e74 f the source ent │ │ │ -0020f8c0: 6974 7920 706f 696e 7473 2074 6f20 7468 ity points to th │ │ │ -0020f8d0: 6520 726f 6f74 206f 6620 7468 6520 646f e root of the do │ │ │ -0020f8e0: 6375 6d65 6e74 2c20 7468 6520 7265 7375 cument, the resu │ │ │ -0020f8f0: 6c74 696e 6720 656e 7469 7479 0a61 6c73 lting entity.als │ │ │ -0020f900: 6f20 706f 696e 7473 2074 6f20 7468 6520 o points to the │ │ │ -0020f910: 726f 6f74 206f 6620 7468 6520 636f 7069 root of the copi │ │ │ -0020f920: 6564 2064 6f63 756d 656e 742c 206e 6f74 ed document, not │ │ │ -0020f930: 2074 6f20 6974 7320 746f 702d 6c65 7665 to its top-leve │ │ │ -0020f940: 6c20 6e6f 6465 2e0a 2020 2020 2020 3c2f l node.. . .With XPER ent │ │ │ -0020f970: 6974 7920 6769 7665 6e2c 2078 6d6c 5f63 ity given, xml_c │ │ │ -0020f980: 7574 2829 2077 6f72 6b73 2065 7861 6374 ut() works exact │ │ │ -0020f990: 6c79 2061 7320 7870 6572 5f63 7574 2829 ly as xper_cut() │ │ │ -0020f9a0: 2e0a 2020 2020 2020 3c2f 7061 7261 3e0a .. . │ │ │ -0020f9b0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -0020f9c0: 3c72 6566 7365 6374 3120 6964 3d22 7061 Par │ │ │ -0020f9e0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -0020f9f0: 2020 2020 3c72 6566 7365 6374 323e 3c74 source_xper │ │ │ -0020fa10: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0020fa20: 7061 7261 3e58 4d4c 2045 6e74 6974 7920 para>XML Entity │ │ │ -0020fa30: 746f 2062 6520 636f 6e76 6572 7465 6420 to be converted │ │ │ -0020fa40: 696e 746f 206e 6577 2064 6f63 756d 656e into new documen │ │ │ -0020fa50: 743c 2f70 6172 613e 3c2f 7265 6673 6563 t. .. See Also │ │ │ -0020fd70: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . < │ │ │ -0020fda0: 6675 6e63 7469 6f6e 3e78 7065 725f 6375 function>xper_cu │ │ │ -0020fdb0: 7428 293c 2f66 756e 6374 696f 6e3e 3c2f t(). < │ │ │ -0020fdd0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......Bdemo │ │ │ -0020fdf0: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -0020fe00: 786d 6c5f 6372 6561 7465 5f74 6162 6c65 xml_create_table │ │ │ -0020fe10: 735f 6672 6f6d 5f6d 6170 7069 6e67 5f73 s_from_mapping_s │ │ │ -0020fe20: 6368 656d 615f 6465 636c 2e78 6d6c df00 chema_decl.xml.. │ │ │ -0020fe30: 0017 d73c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -0020fe60: 212d 2d20 0a20 2d20 200a 202d 2020 5468 !-- . - . - Th │ │ │ -0020fe70: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ -0020fe80: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ -0020fe90: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ -0020fea0: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ -0020feb0: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ -0020fec0: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ -0020fed0: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ -0020fee0: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ -0020fef0: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ -0020ff00: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ -0020ff10: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ -0020ff20: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ -0020ff30: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ -0020ff40: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ -0020ff50: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ -0020ff60: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -0020ff70: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ -0020ff80: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ -0020ff90: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ -0020ffa0: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ -0020ffb0: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ -0020ffc0: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ -0020ffd0: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ -0020ffe0: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ -0020fff0: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ -00210000: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ -00210010: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ -00210020: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ -00210030: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ -00210040: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ -00210050: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ -00210060: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ -00210070: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ -00210080: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ -00210090: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ -002100a0: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ -002100b0: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ -002100c0: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ -002100d0: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ -002100e0: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ -002100f0: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ -00210100: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ -00210110: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -00210120: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ -00210130: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ -00210140: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ -00210150: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ -00210160: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -00210170: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ -00210180: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ -00210190: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ -002101a0: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ -002101b0: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ -002101c0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. │ │ │ -00210200: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -00210210: 7265 6665 6e74 7279 7469 746c 653e 786d refentrytitle>xm │ │ │ -00210220: 6c5f 6372 6561 7465 5f74 6162 6c65 735f l_create_tables_ │ │ │ -00210230: 6672 6f6d 5f6d 6170 7069 6e67 5f73 6368 from_mapping_sch │ │ │ -00210240: 656d 615f 6465 636c 3c2f 7265 6665 6e74 ema_decl. xml. . . xml_create_ │ │ │ -002102b0: 7461 626c 6573 5f66 726f 6d5f 6d61 7070 tables_from_mapp │ │ │ -002102c0: 696e 675f 7363 6865 6d61 5f64 6563 6c3c ing_schema_decl< │ │ │ -002102d0: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. retur │ │ │ -002102f0: 6e73 2061 2076 6563 746f 7220 636f 6e74 ns a vector cont │ │ │ -00210300: 6169 6e69 6e67 2073 7472 696e 6773 2e20 aining strings. │ │ │ -00210310: 4561 6368 2073 7472 696e 6720 6973 2061 Each string is a │ │ │ -00210320: 2063 6f6d 6d61 6e64 2074 6f20 6472 6f70 command to drop │ │ │ -00210330: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ -00210340: 2061 2074 6162 6c65 206f 7220 6120 666f a table or a fo │ │ │ -00210350: 7265 6967 6e20 6b65 7920 6f72 2074 6f20 reign key or to │ │ │ -00210360: 6372 6561 7465 2074 6162 6c65 2e20 0a09 create table. .. │ │ │ -00210370: 093c 2f72 6566 7075 7270 6f73 653e 0a20 .. │ │ │ -00210380: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -00210390: 203c 7265 6673 796e 6f70 7369 7364 6976 . . │ │ │ -002103f0: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ -00210440: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 xml_create_ta │ │ │ -00210460: 626c 6573 5f66 726f 6d5f 6d61 7070 696e bles_from_mappin │ │ │ -00210470: 675f 7363 6865 6d61 5f64 6563 6c3c 2f66 g_schema_decl..in │ │ │ -002104a0: 203c 7061 7261 6d65 7465 723e 6261 7365 base │ │ │ -002104b0: 5f75 7269 3c2f 7061 7261 6d65 7465 723e _uri │ │ │ -002104c0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar..i │ │ │ -002104e0: 6e20 3c70 6172 616d 6574 6572 3e6d 6170 n map │ │ │ -002104f0: 7069 6e67 5f73 6368 656d 615f 6669 6c65 ping_schema_file │ │ │ -00210500: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -00210510: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -00210520: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -00210540: 636f 6e74 656e 745f 656e 636f 6469 6e67 content_encoding │ │ │ -00210550: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -00210560: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -00210570: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -00210590: 636f 6e74 656e 745f 6c61 6e67 7561 6765 content_language │ │ │ -002105a0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -002105b0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -002105c0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -00210600: 203c 7265 6673 6563 7431 2069 643d 2264 Desc │ │ │ -00210620: 7269 7074 696f 6e3c 2f74 6974 6c65 3e20 ription │ │ │ -00210630: 3c70 6172 613e 0a09 3c66 756e 6374 696f ..xml_create_tab │ │ │ -00210650: 6c65 735f 6672 6f6d 5f6d 6170 7069 6e67 les_from_mapping │ │ │ -00210660: 5f73 6368 656d 615f 6465 636c 3c2f 6675 _schema_decl takes a │ │ │ -00210680: 6669 6c65 2063 6f6e 7461 696e 696e 6720 file containing │ │ │ -00210690: 6d61 7070 696e 6720 7363 6865 6d61 2061 mapping schema a │ │ │ -002106a0: 6e64 200a 2020 2020 2020 2020 2072 6574 nd . ret │ │ │ -002106b0: 7572 6e73 2061 2076 6563 746f 7220 636f urns a vector co │ │ │ -002106c0: 6e74 6169 6e69 6e67 2073 7472 696e 6773 ntaining strings │ │ │ -002106d0: 2e20 4561 6368 2073 7472 696e 6720 6973 . Each string is │ │ │ -002106e0: 2061 2063 6f6d 6d61 6e64 2074 6f20 6472 a command to dr │ │ │ -002106f0: 6f70 2061 2074 6162 6c65 206f 7220 6120 op a table or a │ │ │ -00210700: 666f 7265 6967 6e20 6b65 7920 6f72 2074 foreign key or t │ │ │ -00210710: 6f20 0a20 2020 2020 2020 2063 7265 6174 o . creat │ │ │ -00210720: 6520 7461 626c 652e 2041 6c6c 2074 6162 e table. All tab │ │ │ -00210730: 6c65 7320 616e 6420 6669 656c 6473 2061 les and fields a │ │ │ -00210740: 7265 206d 656e 7469 6f6e 6564 2069 6e20 re mentioned in │ │ │ -00210750: 7468 6520 6d61 7070 696e 6720 7363 6865 the mapping sche │ │ │ -00210760: 6d61 2e20 4966 2061 2066 6965 6c64 2074 ma. If a field t │ │ │ -00210770: 7970 6520 6973 206e 6f74 2064 6566 696e ype is not defin │ │ │ -00210780: 6564 2069 6e0a 2020 2020 2020 2020 7468 ed in. th │ │ │ -00210790: 6520 6d61 7070 696e 6720 7363 6865 6d61 e mapping schema │ │ │ -002107a0: 2c20 7468 6520 5641 5243 4841 5220 7479 , the VARCHAR ty │ │ │ -002107b0: 7065 2069 7320 7573 6564 2e20 3c2f 7061 pe is used. . . Parameters</tit │ │ │ -00210800: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -00210810: 323e 3c74 6974 6c65 3e62 6173 655f 7572 2><title>base_ur │ │ │ -00210820: 693c 2f74 6974 6c65 3e0a 2020 2020 2020 i. │ │ │ -00210830: 3c70 6172 613e 696e 2048 544d 4c20 7061 in HTML pa │ │ │ -00210840: 7273 6572 206d 6f64 6520 6368 616e 6765 rser mode change │ │ │ -00210850: 2061 6c6c 2061 6273 6f6c 7574 6520 7265 all absolute re │ │ │ -00210860: 6665 7265 6e63 6573 2074 6f20 7265 6c61 ferences to rela │ │ │ -00210870: 7469 7665 2066 726f 6d20 6769 7665 6e20 tive from given │ │ │ -00210880: 6261 7365 5f75 7269 2028 6874 7470 3a2f base_uri (http:/ │ │ │ -00210890: 2f26 6c74 3b68 6f73 7426 6774 3b3a 266c /<host>:&l │ │ │ -002108a0: 743b 706f 7274 2667 743b 2f26 6c74 3b70 t;port>/<p │ │ │ -002108b0: 6174 6826 6774 3b29 3c2f 7061 7261 3e3c ath>)< │ │ │ -002108c0: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -002108d0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -002108e0: 6d61 7070 696e 675f 7363 6865 6d61 5f66 mapping_schema_f │ │ │ -002108f0: 696c 653c 2f74 6974 6c65 3e0a 2020 2020 ile. │ │ │ -00210900: 2020 3c70 6172 613e 7765 6c6c 2066 6f72 well for │ │ │ -00210910: 6d65 6420 584d 4c20 646f 6375 6d65 6e74 med XML document │ │ │ -00210920: 2063 6f6e 7461 696e 696e 6720 6120 6d61 containing a ma │ │ │ -00210930: 7070 696e 6720 7363 6865 6d61 3c2f 7061 pping schema. . content │ │ │ -00210970: 5f65 6e63 6f64 696e 673c 2f74 6974 6c65 _encoding. st │ │ │ -00210990: 7269 6e67 2077 6974 6820 636f 6e74 656e ring with conten │ │ │ -002109a0: 7420 656e 636f 6469 6e67 2074 7970 6520 t encoding type │ │ │ -002109b0: 6f66 2026 6c74 3b64 6f63 756d 656e 7426 of <document& │ │ │ -002109c0: 6774 3b3b 2076 616c 6964 2061 7265 2027 gt;; valid are ' │ │ │ -002109d0: 4153 4349 4927 2c20 2749 534f 272c 2027 ASCII', 'ISO', ' │ │ │ -002109e0: 5554 4638 272c 2027 4953 4f38 3835 392d UTF8', 'ISO8859- │ │ │ -002109f0: 3127 2c20 274c 4154 494e 2d31 2720 6574 1', 'LATIN-1' et │ │ │ -00210a00: 632e 2c20 6465 6661 756c 7473 2061 7265 c., defaults are │ │ │ -00210a10: 2027 5554 462d 3827 2066 6f72 2058 4d4c 'UTF-8' for XML │ │ │ -00210a20: 206d 6f64 6520 616e 6420 274c 4154 494e mode and 'LATIN │ │ │ -00210a30: 2d31 2720 666f 7220 4854 4d4c 206d 6f64 -1' for HTML mod │ │ │ -00210a40: 653c 2f70 6172 613e 3c2f 7265 6673 6563 e. content │ │ │ -00210a70: 5f6c 616e 6775 6167 653c 2f74 6974 6c65 _language. st │ │ │ -00210a90: 7269 6e67 2077 6974 6820 6c61 6e67 7561 ring with langua │ │ │ -00210aa0: 6765 2074 6167 206f 6620 636f 6e74 656e ge tag of conten │ │ │ -00210ab0: 7420 6f66 2026 6c74 3b64 6f63 756d 656e t of <documen │ │ │ -00210ac0: 7426 6774 3b3b 2076 616c 6964 206e 616d t>; valid nam │ │ │ -00210ad0: 6573 2061 7265 206c 6973 7465 6420 696e es are listed in │ │ │ -00210ae0: 2049 4554 4620 5246 4320 3137 3636 2c20 IETF RFC 1766, │ │ │ -00210af0: 6465 6661 756c 7420 6973 2027 782d 616e default is 'x-an │ │ │ -00210b00: 7927 2028 6974 206d 6561 6e73 2027 6d69 y' (it means 'mi │ │ │ -00210b10: 7820 6f66 2077 6f72 6473 2066 726f 6d20 x of words from │ │ │ -00210b20: 7661 7269 6f75 7320 6875 6d61 6e20 6c61 various human la │ │ │ -00210b30: 6e67 7561 6765 7329 3c2f 7061 7261 3e3c nguages)< │ │ │ -00210b40: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. . Return Type │ │ │ -00210b80: 733c 2f74 6974 6c65 3e3c 7061 7261 3e41 sA │ │ │ -00210b90: 2076 6563 746f 7220 636f 6e74 6169 6e69 vector containi │ │ │ -00210ba0: 6e67 2073 7472 696e 6773 3c2f 7061 7261 ng strings.. │ │ │ -00210bc0: 3c72 6566 7365 6374 3120 6964 3d22 6578 < │ │ │ -00210be0: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -00210bf0: 6d70 6c65 2069 643d 2265 785f 786d 6c5f mple id="ex_xml_ │ │ │ -00210c00: 6372 6561 7465 5f74 6162 6c65 735f 6672 create_tables_fr │ │ │ -00210c10: 6f6d 5f6d 6170 7069 6e67 5f73 6368 656d om_mapping_schem │ │ │ -00210c20: 615f 6465 636c 223e 3c74 6974 6c65 3e45 a_decl"><title>E │ │ │ -00210c30: 7874 7261 6374 696e 6720 7461 626c 6573 xtracting tables │ │ │ -00210c40: 2066 726f 6d20 6d61 7070 696e 6720 7363 from mapping sc │ │ │ -00210c50: 6865 6d61 3c2f 7469 746c 653e 0a3c 7061 hema.Let we have t │ │ │ -00210c70: 6865 2066 6f6c 6c6f 7769 6e67 206d 6170 he following map │ │ │ -00210c80: 7069 6e67 2073 6368 656d 6120 696e 2074 ping schema in t │ │ │ -00210c90: 6865 2063 6174 6d70 2e78 7364 2066 696c he catmp.xsd fil │ │ │ -00210ca0: 653c 2f70 6172 613e 0a3c 7072 6f67 7261 e... │ │ │ -00210d50: 203c 7873 643a 6170 7069 6e66 6f3e 0a20 . │ │ │ -00210d60: 2020 203c 7371 6c3a 7265 6c61 7469 6f6e . │ │ │ -00210e20: 203c 2f78 7364 3a61 7070 696e 666f 3e0a . │ │ │ -00210e30: 3c2f 7873 643a 616e 6e6f 7461 7469 6f6e .. . │ │ │ -00210ea0: 3c78 7364 3a63 6f6d 706c 6578 5479 7065 . . │ │ │ -00210ee0: 2020 203c 7873 643a 656c 656d 656e 7420 │ │ │ -00210f70: 0a20 2020 2020 2020 2020 2020 3c78 7364 . . │ │ │ -00210f90: 2020 2020 2020 2020 2020 2020 3c78 7364 . │ │ │ -00210ff0: 0a20 2020 2020 2020 203c 2f78 7364 3a65 . . . │ │ │ -00211020: 2020 2020 203c 7873 643a 6174 7472 6962 . │ │ │ -00211060: 2020 2020 2020 3c78 7364 3a61 7474 7269 . ..]]>< │ │ │ -002110e0: 2f70 726f 6772 616d 6c69 7374 696e 673e /programlisting> │ │ │ -002110f0: 0a3c 7061 7261 3e74 6865 205f 7265 7375 .the _resu │ │ │ -00211100: 6c74 2076 6563 746f 7220 6166 7465 7220 lt vector after │ │ │ -00211110: 7468 6520 6361 6c6c 3c2f 7061 7261 3e0a the call. │ │ │ -00211120: 3c70 726f 6772 616d 6c69 7374 696e 673e │ │ │ -00211130: 2020 0a5f 7265 7375 6c74 203a 3d20 786d ._result := xm │ │ │ -00211140: 6c5f 6372 6561 7465 5f74 6162 6c65 735f l_create_tables_ │ │ │ -00211150: 6672 6f6d 5f6d 6170 7069 6e67 5f73 6368 from_mapping_sch │ │ │ -00211160: 656d 615f 6465 636c 2028 0a20 2027 6874 ema_decl (. 'ht │ │ │ -00211170: 7470 3a2f 2f6c 6f63 616c 686f 7374 2e6c tp://localhost.l │ │ │ -00211180: 6f63 616c 646f 6d61 696e 2f78 6d6c 7265 ocaldomain/xmlre │ │ │ -00211190: 706f 7369 746f 7279 272c 0a20 2027 6361 pository',. 'ca │ │ │ -002111a0: 746d 702e 7873 6427 2c20 2755 5446 2d38 tmp.xsd', 'UTF-8 │ │ │ -002111b0: 272c 2027 782d 616e 7927 293b 0a3c 2f70 ', 'x-any');.

    .< │ │ │ -002111d0: 7061 7261 3e77 696c 6c20 636f 6e74 6169 para>will contai │ │ │ -002111e0: 6e20 7468 6520 666f 6c6c 6f77 696e 6720 n the following │ │ │ -002111f0: 7369 7820 7374 7269 6e67 733c 2f70 6172 six strings..drop table " │ │ │ -00211220: 4465 6d6f 222e 2264 656d 6f22 2e22 4361 Demo"."demo"."Ca │ │ │ -00211230: 7465 676f 7269 6573 222c 0a0a 414c 5445 tegories",..ALTE │ │ │ -00211240: 5220 5441 424c 4520 2244 656d 6f22 2e22 R TABLE "Demo"." │ │ │ -00211250: 6465 6d6f 222e 2250 726f 6475 6374 7322 demo"."Products" │ │ │ -00211260: 2044 524f 5020 434f 4e53 5452 4149 4e54 DROP CONSTRAINT │ │ │ -00211270: 2022 4465 6d6f 2e64 656d 6f2e 5072 6f64 "Demo.demo.Prod │ │ │ -00211280: 7563 7473 5f44 656d 6f2e 6465 6d6f 2e43 ucts_Demo.demo.C │ │ │ -00211290: 6174 6567 6f72 6965 735f 464b 222c 0a0a ategories_FK",.. │ │ │ -002112a0: 6472 6f70 2074 6162 6c65 2022 4465 6d6f drop table "Demo │ │ │ -002112b0: 222e 2264 656d 6f22 2e22 5072 6f64 7563 "."demo"."Produc │ │ │ -002112c0: 7473 222c 0a0a 6372 6561 7465 2074 6162 ts",..create tab │ │ │ -002112d0: 6c65 2022 4465 6d6f 222e 2264 656d 6f22 le "Demo"."demo" │ │ │ -002112e0: 2e22 4361 7465 676f 7269 6573 2220 0a28 ."Categories" .( │ │ │ -002112f0: 2244 6573 6372 6970 7469 6f6e 2220 2056 "Description" V │ │ │ -00211300: 4152 4348 4152 2c20 2243 6174 6567 6f72 ARCHAR, "Categor │ │ │ -00211310: 7949 4422 2049 4e54 4547 4552 2c20 5052 yID" INTEGER, PR │ │ │ -00211320: 494d 4152 5920 4b45 5920 2822 4361 7465 IMARY KEY ("Cate │ │ │ -00211330: 676f 7279 4944 2229 292c 0a0a 6372 6561 goryID")),..crea │ │ │ -00211340: 7465 2074 6162 6c65 2022 4465 6d6f 222e te table "Demo". │ │ │ -00211350: 2264 656d 6f22 2e22 5072 6f64 7563 7473 "demo"."Products │ │ │ -00211360: 2220 2822 4361 7465 676f 7279 4944 2220 " ("CategoryID" │ │ │ -00211370: 2049 4e54 4547 4552 2c20 2250 726f 6475 INTEGER, "Produ │ │ │ -00211380: 6374 4e61 6d65 2220 2056 4152 4348 4152 ctName" VARCHAR │ │ │ -00211390: 292c 0a0a 414c 5445 5220 5441 424c 4520 ),..ALTER TABLE │ │ │ -002113a0: 2244 656d 6f22 2e22 6465 6d6f 222e 2250 "Demo"."demo"."P │ │ │ -002113b0: 726f 6475 6374 7322 2041 4444 2043 4f4e roducts" ADD CON │ │ │ -002113c0: 5354 5241 494e 5420 2244 656d 6f2e 6465 STRAINT "Demo.de │ │ │ -002113d0: 6d6f 2e50 726f 6475 6374 735f 4465 6d6f mo.Products_Demo │ │ │ -002113e0: 2e64 656d 6f2e 4361 7465 676f 7269 6573 .demo.Categories │ │ │ -002113f0: 5f46 4b22 200a 464f 5245 4947 4e20 4b45 _FK" .FOREIGN KE │ │ │ -00211400: 5920 2822 4361 7465 676f 7279 4944 2229 Y ("CategoryID") │ │ │ -00211410: 2052 4546 4552 454e 4345 5320 2244 656d REFERENCES "Dem │ │ │ -00211420: 6f22 2e22 6465 6d6f 222e 2243 6174 6567 o"."demo"."Categ │ │ │ -00211430: 6f72 6965 7322 2028 2243 6174 6567 6f72 ories" ("Categor │ │ │ -00211440: 7949 4422 290a 3c2f 7072 6f67 7261 6d6c yID")... . . < │ │ │ -00211490: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also. xml_l │ │ │ -002114f0: 6f61 645f 6d61 7070 696e 675f 7363 6865 oad_mapping_sche │ │ │ -00211500: 6d61 5f64 6563 6c28 293c 2f66 756e 6374 ma_decl().
  • x │ │ │ -00211560: 6d6c 5f6c 6f61 645f 7363 6865 6d61 5f64 ml_load_schema_d │ │ │ -00211570: 6563 6c28 293c 2f66 756e 6374 696f 6e3e ecl() │ │ │ -00211580: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -00211590: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xml_view_s │ │ │ -002115d0: 6368 656d 6128 293c 2f66 756e 6374 696f chema() │ │ │ -002115f0: 0a20 3c2f 7265 6673 6563 7431 3e0a 3c2f . ......'d │ │ │ -00211610: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -00211620: 6566 2f78 6d6c 5f61 7574 6f5f 7363 6865 ef/xml_auto_sche │ │ │ -00211630: 6d61 2e78 6d6c df00 0014 e83c 3f78 6d6c ma.xml........ . xml_au │ │ │ -00211a10: 746f 5f73 6368 656d 613c 2f72 6566 656e to_schema. xml. < │ │ │ -00211a50: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . xml_auto_s │ │ │ -00211a80: 6368 656d 613c 2f72 6566 6e61 6d65 3e0a chema. │ │ │ -00211a90: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -00211aa0: 7265 7475 726e 7320 616e 2058 4d4c 2073 returns an XML s │ │ │ -00211ab0: 6368 656d 6120 666f 7220 7468 6520 7265 chema for the re │ │ │ -00211ac0: 7375 6c74 206f 6620 616e 2053 514c 2071 sult of an SQL q │ │ │ -00211ad0: 7565 7279 2077 6974 6820 6120 464f 5220 uery with a FOR │ │ │ -00211ae0: 584d 4c20 636c 6175 7365 3c2f 7265 6670 XML clause. . . < │ │ │ -00211b20: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -00211b30: 2266 7379 6e5f 786d 6c5f 6175 746f 5f73 "fsyn_xml_auto_s │ │ │ -00211b40: 6368 656d 6122 3e0a 2020 2020 2020 3c66 chema">. . │ │ │ -00211b80: 2020 3c66 756e 6364 6566 3e76 6172 6368 varch │ │ │ -00211b90: 6172 203c 6675 6e63 7469 6f6e 3e78 6d6c ar xml │ │ │ -00211ba0: 5f61 7574 6f5f 7363 6865 6d61 3c2f 6675 _auto_schema. in query varchar. < │ │ │ -00211c10: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in root_elem │ │ │ -00211c30: 656e 743c 2f70 6172 616d 6574 6572 3e20 ent │ │ │ -00211c40: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar. . . │ │ │ -00211c80: 3c2f 7265 6673 796e 6f70 7369 7364 6976 . D │ │ │ -00211cc0: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ -00211cd0: 653e 0a3c 7061 7261 3e0a 5468 6973 2066 e>.<para>.This f │ │ │ -00211ce0: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ -00211cf0: 616e 2058 4d4c 2073 6368 656d 6120 666f an XML schema fo │ │ │ -00211d00: 7220 7468 6520 7265 7375 6c74 7320 6f66 r the results of │ │ │ -00211d10: 2061 6e20 5351 4c20 7175 6572 790a 7769 an SQL query.wi │ │ │ -00211d20: 7468 2061 2046 4f52 2058 4d4c 2063 6c61 th a FOR XML cla │ │ │ -00211d30: 7573 652e 2020 5468 6520 7265 7475 726e use. The return │ │ │ -00211d40: 6564 2073 6368 656d 6120 7769 6c6c 2061 ed schema will a │ │ │ -00211d50: 7070 6c79 2074 6f20 7468 6520 6f75 7470 pply to the outp │ │ │ -00211d60: 7574 0a67 656e 6572 6174 6564 2062 7920 ut.generated by │ │ │ -00211d70: 3c66 756e 6374 696f 6e3e 786d 6c5f 6175 <function>xml_au │ │ │ -00211d80: 746f 2829 3c2f 6675 6e63 7469 6f6e 3e20 to()</function> │ │ │ -00211d90: 7769 7468 2074 6865 2071 7565 7279 2069 with the query i │ │ │ -00211da0: 6e0a 7175 6573 7469 6f6e 2061 6674 6572 n.question after │ │ │ -00211db0: 2077 7261 7070 696e 6720 6974 2069 6e20 wrapping it in │ │ │ -00211dc0: 7468 6520 7370 6563 6966 6965 6420 726f the specified ro │ │ │ -00211dd0: 6f74 2065 6c65 6d65 6e74 2e0a 3c2f 7061 ot element..</pa │ │ │ -00211de0: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ -00211df0: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ -00211e00: 3d22 7061 7261 6d73 5f78 6d6c 5f61 7574 ="params_xml_aut │ │ │ -00211e10: 6f5f 7363 6865 6d61 223e 3c74 6974 6c65 o_schema"><title │ │ │ -00211e20: 3e50 6172 616d 6574 6572 733c 2f74 6974 >Parameters</tit │ │ │ -00211e30: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -00211e40: 323e 3c74 6974 6c65 3e71 7565 7279 3c2f 2><title>query</ │ │ │ -00211e50: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -00211e60: 7261 3e53 514c 2071 7565 7279 3c2f 7061 ra>SQL query</pa │ │ │ -00211e70: 7261 3e3c 2f72 6566 7365 6374 323e 0a20 ra></refsect2>. │ │ │ -00211e80: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ -00211e90: 746c 653e 726f 6f74 5f65 6c65 6d65 6e74 tle>root_element │ │ │ -00211ea0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00211eb0: 7061 7261 3e6e 616d 6520 6f66 2072 6f6f para>name of roo │ │ │ -00211ec0: 7420 656c 656d 656e 7420 636f 6e74 6169 t element contai │ │ │ -00211ed0: 6e65 723c 2f70 6172 613e 3c2f 7265 6673 ner. . │ │ │ -00211f20: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ -00211f30: 746c 653e 3c70 6172 613e 7661 7263 6861 tle><para>varcha │ │ │ -00211f40: 7220 7265 7375 6c74 2063 6f6e 7461 696e r result contain │ │ │ -00211f50: 696e 6720 7468 650a 7363 6865 6d61 206f ing the.schema o │ │ │ -00211f60: 6620 7468 6520 584d 4c20 646f 6375 6d65 f the XML docume │ │ │ -00211f70: 6e74 2e3c 2f70 6172 613e 3c2f 7265 6673 nt.</para></refs │ │ │ -00211f80: 6563 7431 3e0a 0a20 203c 7265 6673 6563 ect1>.. <refsec │ │ │ -00211f90: 7431 2069 643d 2265 7272 6f72 735f 786d t1 id="errors_xm │ │ │ -00211fa0: 6c5f 6175 746f 5f73 6368 656d 6122 3e3c l_auto_schema">< │ │ │ -00211fb0: 7469 746c 653e 4572 726f 7273 3c2f 7469 title>Errors</ti │ │ │ -00211fc0: 746c 653e 0a09 2020 2020 3c70 6172 613e tle>.. <para> │ │ │ -00211fd0: 4966 2074 6865 203c 7061 7261 6d65 7465 If the <paramete │ │ │ -00211fe0: 723e 7175 6572 793c 2f70 6172 616d 6574 r>query</paramet │ │ │ -00211ff0: 6572 3e20 6172 6775 6d65 6e74 2069 7320 er> argument is │ │ │ -00212000: 6e6f 7420 6120 7661 6c69 6420 5351 4c20 not a valid SQL │ │ │ -00212010: 7374 6174 656d 656e 742c 2069 2e65 2e20 statement, i.e. │ │ │ -00212020: 5351 4c20 636f 6d70 696c 6572 2073 6967 SQL compiler sig │ │ │ -00212030: 6e61 6c73 2061 6e20 6572 726f 7220 6d65 nals an error me │ │ │ -00212040: 7373 6167 652c 200a 2020 2020 2020 2020 ssage, . │ │ │ -00212050: 2020 2020 2020 2020 2020 2074 6865 2066 the f │ │ │ -00212060: 756e 6374 696f 6e20 7265 7369 676e 616c unction resignal │ │ │ -00212070: 7320 7468 6520 6572 726f 722e 0a20 2020 s the error.. │ │ │ -00212080: 2020 2020 2020 2020 203c 2f70 6172 613e </para> │ │ │ -00212090: 0a20 203c 2f72 6566 7365 6374 313e 0a0a . </refsect1>.. │ │ │ -002120a0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -002120b0: 6578 616d 706c 6573 5f78 6d6c 5f61 7574 examples_xml_aut │ │ │ -002120c0: 6f5f 7363 6865 6d61 223e 3c74 6974 6c65 o_schema"><title │ │ │ -002120d0: 3e45 7861 6d70 6c65 733c 2f74 6974 6c65 >Examples. Si │ │ │ -00212110: 6d70 6c65 2053 6368 656d 6120 4765 6e65 mple Schema Gene │ │ │ -00212120: 7261 7469 6f6e 3c2f 7469 746c 653e 0a3c ration.< │ │ │ -00212130: 7072 6f67 7261 6d6c 6973 7469 6e67 3e0a programlisting>. │ │ │ -00212140: 5351 4c26 6774 3b20 7365 6c65 6374 2078 SQL> select x │ │ │ -00212150: 6d6c 5f61 7574 6f5f 7363 6865 6d61 2028 ml_auto_schema ( │ │ │ -00212160: 2720 2073 656c 6563 7420 2671 756f 743b ' select " │ │ │ -00212170: 6361 7465 676f 7279 2671 756f 743b 2e26 category".& │ │ │ -00212180: 7175 6f74 3b43 6174 6567 6f72 7949 4426 quot;CategoryID& │ │ │ -00212190: 7175 6f74 3b2c 2026 7175 6f74 3b43 6174 quot;, "Cat │ │ │ -002121a0: 6567 6f72 794e 616d 6526 7175 6f74 3b2c egoryName", │ │ │ -002121b0: 0a09 0926 7175 6f74 3b50 726f 6475 6374 ..."Product │ │ │ -002121c0: 4e61 6d65 2671 756f 743b 2c20 2671 756f Name", &quo │ │ │ -002121d0: 743b 5072 6f64 7563 7449 4426 7175 6f74 t;ProductID" │ │ │ -002121e0: 3b0a 0966 726f 6d20 2671 756f 743b 4465 ;..from "De │ │ │ -002121f0: 6d6f 2671 756f 743b 2e2e 2671 756f 743b mo".." │ │ │ -00212200: 4361 7465 676f 7269 6573 2671 756f 743b Categories" │ │ │ -00212210: 2026 7175 6f74 3b63 6174 6567 6f72 7926 "category& │ │ │ -00212220: 7175 6f74 3b2c 2026 7175 6f74 3b44 656d quot;, "Dem │ │ │ -00212230: 6f26 7175 6f74 3b2e 2e26 7175 6f74 3b50 o".."P │ │ │ -00212240: 726f 6475 6374 7326 7175 6f74 3b20 6173 roducts" as │ │ │ -00212250: 2026 7175 6f74 3b70 726f 6475 6374 2671 "product&q │ │ │ -00212260: 756f 743b 0a09 7768 6572 6520 2671 756f uot;..where &quo │ │ │ -00212270: 743b 7072 6f64 7563 7426 7175 6f74 3b2e t;product". │ │ │ -00212280: 2671 756f 743b 4361 7465 676f 7279 4944 "CategoryID │ │ │ -00212290: 2671 756f 743b 203d 2026 7175 6f74 3b63 " = "c │ │ │ -002122a0: 6174 6567 6f72 7926 7175 6f74 3b2e 2671 ategory".&q │ │ │ -002122b0: 756f 743b 4361 7465 676f 7279 4944 2671 uot;CategoryID&q │ │ │ -002122c0: 756f 743b 0a09 666f 7220 786d 6c20 6175 uot;..for xml au │ │ │ -002122d0: 746f 2065 6c65 6d65 6e74 272c 2027 726f to element', 'ro │ │ │ -002122e0: 6f74 2729 3b0a 2063 616c 6c72 6574 0a56 ot');. callret.V │ │ │ -002122f0: 4152 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f ARCHAR._________ │ │ │ +001d87b0: 6566 2f73 7461 745f 696d 706f 7274 2e78 ef/stat_import.x │ │ │ +001d87c0: 6d6c df00 0009 2d3c 3f78 6d6c 2076 6572 ml....-... . intern │ │ │ +001d9500: 616c 5f74 7970 655f 6e61 6d65 3c2f 7265 al_type_name. │ │ │ +001d9520: 203c 7265 666d 6973 6369 6e66 6f3e 7479 ty │ │ │ +001d9530: 7065 3c2f 7265 666d 6973 6369 6e66 6f3e pe │ │ │ +001d9540: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ +001d9550: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ +001d9560: 203c 7265 666e 616d 653e 696e 7465 726e intern │ │ │ +001d9570: 616c 5f74 7970 655f 6e61 6d65 3c2f 7265 al_type_name. dv_type_titl │ │ │ +001d95a0: 653c 2f72 6566 6e61 6d65 3e0a 2020 2020 e. │ │ │ +001d95b0: 3c72 6566 7075 7270 6f73 653e 7265 7475 retu │ │ │ +001d95c0: 726e 7320 7468 6520 696e 7465 726e 616c rns the internal │ │ │ +001d95d0: 2074 7970 6520 6e61 6d65 206f 6620 7468 type name of th │ │ │ +001d95e0: 6520 6172 6775 6d65 6e74 3c2f 7265 6670 e argument. . . < │ │ │ +001d9620: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +001d9630: 2266 7379 6e5f 696e 7465 726e 616c 5f74 "fsyn_internal_t │ │ │ +001d9640: 7970 655f 6e61 6d65 223e 0a20 2020 2020 ype_name">. │ │ │ +001d9650: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ +001d9680: 2020 2020 2020 2020 3c66 756e 6364 6566 inter │ │ │ +001d96a0: 6e61 6c5f 7479 7065 5f6e 616d 653c 2f66 nal_type_name. │ │ │ +001d96e0: 696e 7465 726e 616c 5f74 7970 653c 2f70 internal_type

    intege │ │ │ +001d9700: 723c 2f70 6172 616d 6465 663e 0a20 2020 r. │ │ │ +001d9710: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . . dv │ │ │ +001d97b0: 5f74 7970 655f 7469 746c 653c 2f66 756e _type_title
    │ │ │ +001d97d0: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in │ │ │ +001d97f0: 7465 726e 616c 5f74 7970 653c 2f70 6172 ternal_type integer< │ │ │ +001d9810: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +001d9820: 203c 2f66 756e 6370 726f 746f 7479 7065
    . . . │ │ │ +001d9870: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ +001d9880: 6f6e 3c2f 7469 746c 653e 0a3c 7061 7261 on.internal_type_n │ │ │ +001d98a0: 616d 6520 7265 7475 726e 7320 6120 7374 ame returns a st │ │ │ +001d98b0: 7269 6e67 2077 6869 6368 2069 7320 6120 ring which is a │ │ │ +001d98c0: 6875 6d61 6e2d 7265 6164 6162 6c65 206e human-readable n │ │ │ +001d98d0: 616d 6520 666f 7220 616e 0a20 2020 2069 ame for an. i │ │ │ +001d98e0: 6e74 6572 6e61 6c5f 7479 7065 2069 6e74 nternal_type int │ │ │ +001d98f0: 6567 6572 2067 6976 656e 2061 7320 6974 eger given as it │ │ │ +001d9900: 7320 6172 6775 6d65 6e74 2e20 2054 6865 s argument. The │ │ │ +001d9910: 2066 756e 6374 696f 6e0a 2020 2020 3c66 function. dv_type_ │ │ │ +001d9930: 7469 746c 6528 293c 2f66 756e 6374 696f title() is an alias o │ │ │ +001d9950: 660a 2020 2020 3c66 756e 6374 696f 6e3e f. │ │ │ +001d9960: 696e 7465 726e 616c 5f74 7970 655f 6e61 internal_type_na │ │ │ +001d9970: 6d65 2829 3c2f 6675 6e63 7469 6f6e 3e2e me(). │ │ │ +001d9980: 3c2f 7061 7261 3e0a 3c73 6372 6565 6e3e . │ │ │ +001d9990: 0a69 6e74 6572 6e61 6c5f 7479 7065 5f6e .internal_type_n │ │ │ +001d99a0: 616d 6520 2869 6e74 6572 6e61 6c5f 7479 ame (internal_ty │ │ │ +001d99b0: 7065 2028 276b 756d 696b 616c 6127 2929 pe ('kumikala')) │ │ │ +001d99c0: 0a09 092d 2667 743b 2027 5348 4f52 545f ...-> 'SHORT_ │ │ │ +001d99d0: 5354 5249 4e47 270a 7365 6c65 6374 2069 STRING'.select i │ │ │ +001d99e0: 6e74 6572 6e61 6c5f 7479 7065 5f6e 616d nternal_type_nam │ │ │ +001d99f0: 6528 434f 4c5f 4454 5029 2066 726f 6d20 e(COL_DTP) from │ │ │ +001d9a00: 5359 535f 434f 4c53 3b0a 3c2f 7363 7265 SYS_COLS;... │ │ │ +001d9a20: 0a3c 2f72 6566 656e 7472 793e 0a0a 0ab6 ..... │ │ │ +001d9a30: 0000 0021 6465 6d6f 2f64 6f63 7372 632f ...!demo/docsrc/ │ │ │ +001d9a40: 6675 6e63 7265 662f 656e 6473 5f77 6974 funcref/ends_wit │ │ │ +001d9a50: 682e 786d 6cdf 0000 0b37 3c3f 786d 6c20 h.xml....7... . │ │ │ +001d9e10: 2020 2020 3c72 6566 656e 7472 7974 6974 ends_with
    . │ │ │ +001d9e40: 203c 7265 666d 6973 6369 6e66 6f3e 7374 st │ │ │ +001d9e50: 7269 6e67 3c2f 7265 666d 6973 6369 6e66 ring. . │ │ │ +001d9e70: 2020 3c72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +001d9e80: 2020 203c 7265 666e 616d 653e 656e 6473 ends │ │ │ +001d9e90: 5f77 6974 683c 2f72 6566 6e61 6d65 3e0a _with. │ │ │ +001d9ea0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +001d9eb0: 4368 6563 6b73 2077 6865 7468 6572 2073 Checks whether s │ │ │ +001d9ec0: 7472 696e 6720 5820 656e 6473 2077 6974 tring X ends wit │ │ │ +001d9ed0: 6820 593c 2f72 6566 7075 7270 6f73 653e h Y │ │ │ +001d9ee0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ +001d9ef0: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . │ │ │ +001d9f30: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . < │ │ │ +001d9f60: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>ends_with │ │ │ +001d9f90: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in str │ │ │ +001d9fc0: 2073 7472 696e 673c 2f70 6172 616d 6465 string. in sub string. . │ │ │ +001da030: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ +001da040: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . . │ │ │ +001da080: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ +001da090: 6c65 3e0a 2020 2020 3c70 6172 613e 3c66 le>. <para><f │ │ │ +001da0a0: 756e 6374 696f 6e3e 656e 6473 5f77 6974 unction>ends_wit │ │ │ +001da0b0: 683c 2f66 756e 6374 696f 6e3e 2063 6865 h</function> che │ │ │ +001da0c0: 636b 7320 7768 6574 6865 7220 7374 7269 cks whether stri │ │ │ +001da0d0: 6e67 2058 2065 6e64 7320 7769 7468 2059 ng X ends with Y │ │ │ +001da0e0: 2c20 6967 6e6f 7269 6e67 206f 6363 7572 , ignoring occur │ │ │ +001da0f0: 656e 6369 6573 206f 6620 5920 696e 206f encies of Y in o │ │ │ +001da100: 7468 6572 2070 6c61 6365 732e 2052 6574 ther places. Ret │ │ │ +001da110: 7572 6e73 2031 206f 7220 302e 3c2f 7061 urns 1 or 0.</pa │ │ │ +001da120: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ +001da130: 3e20 200a 2020 3c72 6566 7365 6374 3120 > . <refsect1 │ │ │ +001da140: 6964 3d22 7061 7261 6d73 5f65 6e64 735f id="params_ends_ │ │ │ +001da150: 7769 7468 223e 0a20 2020 203c 7469 746c with">. <titl │ │ │ +001da160: 653e 5061 7261 6d65 7465 7273 3c2f 7469 e>Parameters</ti │ │ │ +001da170: 746c 653e 0a20 2020 203c 7265 6673 6563 tle>. <refsec │ │ │ +001da180: 7432 3e3c 7469 746c 653e 7374 723c 2f74 t2><title>str</t │ │ │ +001da190: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +001da1a0: 613e 5374 7269 6e67 2074 6f20 7365 6172 a>String to sear │ │ │ +001da1b0: 6368 2066 726f 6d2e 3c2f 7061 7261 3e0a ch from.</para>. │ │ │ +001da1c0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a </refsect2>. │ │ │ +001da1d0: 2020 2020 3c72 6566 7365 6374 323e 3c74 <refsect2><t │ │ │ +001da1e0: 6974 6c65 3e73 7562 3c2f 7469 746c 653e itle>sub │ │ │ +001da1f0: 0a20 2020 2020 203c 7061 7261 3e53 7562 . Sub │ │ │ +001da200: 7374 7269 6e67 2074 6f20 7365 6172 6368 string to search │ │ │ +001da210: 2066 6f72 2e3c 2f70 6172 613e 0a20 2020 for.. │ │ │ +001da220: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ +001da230: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. . < │ │ │ +001da260: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ +001da270: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ +001da280: 7061 7261 3e31 2069 6620 666f 756e 642c para>1 if found, │ │ │ +001da290: 2030 2069 6620 6e6f 7420 666f 756e 642e 0 if not found. │ │ │ +001da2a0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . < │ │ │ +001da2e0: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. Sim │ │ │ +001da320: 706c 6520 6578 616d 706c 653c 2f74 6974 ple example</tit │ │ │ +001da330: 6c65 3e0a 3c70 726f 6772 616d 6c69 7374 le>.<programlist │ │ │ +001da340: 696e 673e 3c21 5b43 4441 5441 5b0a 5351 ing><![CDATA[.SQ │ │ │ +001da350: 4c3e 2073 656c 6563 7420 656e 6473 5f77 L> select ends_w │ │ │ +001da360: 6974 6828 2741 6272 6163 6164 6162 7241 ith('AbracadabrA │ │ │ +001da370: 272c 2772 4127 293b 0a65 6e64 735f 7769 ','rA');.ends_wi │ │ │ +001da380: 7468 0a49 4e54 4547 4552 0a5f 5f5f 5f5f th.INTEGER._____ │ │ │ +001da390: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001da3a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001da3b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001da3c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001da3d0: 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 310a 0a31 __________..1..1 │ │ │ +001da3e0: 2052 6f77 732e 202d 2d20 3020 6d73 6563 Rows. -- 0 msec │ │ │ +001da3f0: 2e0a 5d5d 3e3c 2f70 726f 6772 616d 6c69 ..]]></programli │ │ │ +001da400: 7374 696e 673e 0a20 2020 203c 2f65 7861 sting>. </exa │ │ │ +001da410: 6d70 6c65 3e0a 2020 3c2f 7265 6673 6563 mple>. </refsec │ │ │ +001da420: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +001da430: 6964 3d22 7365 6561 6c73 6f5f 656e 6473 id="seealso_ends │ │ │ +001da440: 5f77 6974 6822 3e0a 2020 2020 3c74 6974 _with">. <tit │ │ │ +001da450: 6c65 3e53 6565 2041 6c73 6f3c 2f74 6974 le>See Also</tit │ │ │ +001da460: 6c65 3e0a 2020 2020 3c70 6172 613e 3c6c le>. <para><l │ │ │ +001da470: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001da480: 7374 7263 6173 6573 7472 223e 3c66 756e strcasestr"><fun │ │ │ +001da490: 6374 696f 6e3e 7374 7263 6173 6573 7472 ction>strcasestr │ │ │ +001da4a0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e </function></lin │ │ │ +001da4b0: 6b3e 2e3c 2f70 6172 613e 0a20 2020 203c k>.</para>. < │ │ │ +001da4c0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para><link linke │ │ │ +001da4d0: 6e64 3d22 666e 5f73 7472 636f 6e74 6169 nd="fn_strcontai │ │ │ +001da4e0: 6e73 223e 3c66 756e 6374 696f 6e3e 7374 ns"><function>st │ │ │ +001da4f0: 7263 6f6e 7461 696e 733c 2f66 756e 6374 rcontains</funct │ │ │ +001da500: 696f 6e3e 3c2f 6c69 6e6b 3e2e 3c2f 7061 ion></link>.</pa │ │ │ +001da510: 7261 3e0a 2020 2020 3c70 6172 613e 3c6c ra>. <para><l │ │ │ +001da520: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001da530: 7374 6172 7473 5f77 6974 6822 3e3c 6675 starts_with"><fu │ │ │ +001da540: 6e63 7469 6f6e 3e73 7461 7274 735f 7769 nction>starts_wi │ │ │ +001da550: 7468 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c th</function></l │ │ │ +001da560: 696e 6b3e 2e3c 2f70 6172 613e 2020 2020 ink>.</para> │ │ │ +001da570: 2020 2020 0a20 203c 2f72 6566 7365 6374 . </refsect │ │ │ +001da580: 313e 0a3c 2f72 6566 656e 7472 793e 0a0a 1>.</refentry>.. │ │ │ +001da590: 0ab6 0000 0021 6465 6d6f 2f64 6f63 7372 .....!demo/docsr │ │ │ +001da5a0: 632f 6675 6e63 7265 662f 6469 6374 5f73 c/funcref/dict_s │ │ │ +001da5b0: 697a 652e 786d 6cdf 0000 0eae 3c3f 786d ize.xml.....<?xm │ │ │ +001da5c0: 6c20 7665 7273 696f 6e3d 2231 2e30 2220 l version="1.0" │ │ │ +001da5d0: 656e 636f 6469 6e67 3d22 4953 4f2d 3838 encoding="ISO-88 │ │ │ +001da5e0: 3539 2d31 223f 3e0a 3c21 2d2d 0a20 200a 59-1"?>.<!--. . │ │ │ +001da5f0: 2020 5468 6973 2066 696c 6520 6973 2070 This file is p │ │ │ +001da600: 6172 7420 6f66 2074 6865 204f 7065 6e4c art of the OpenL │ │ │ +001da610: 696e 6b20 536f 6674 7761 7265 2056 6972 ink Software Vir │ │ │ +001da620: 7475 6f73 6f20 4f70 656e 2d53 6f75 7263 tuoso Open-Sourc │ │ │ +001da630: 6520 2856 4f53 290a 2020 7072 6f6a 6563 e (VOS). projec │ │ │ +001da640: 742e 0a20 200a 2020 436f 7079 7269 6768 t.. . Copyrigh │ │ │ +001da650: 7420 2843 2920 3139 3938 2d32 3032 3420 t (C) 1998-2024 │ │ │ +001da660: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ +001da670: 650a 2020 0a20 2054 6869 7320 7072 6f6a e. . This proj │ │ │ +001da680: 6563 7420 6973 2066 7265 6520 736f 6674 ect is free soft │ │ │ +001da690: 7761 7265 3b20 796f 7520 6361 6e20 7265 ware; you can re │ │ │ +001da6a0: 6469 7374 7269 6275 7465 2069 7420 616e distribute it an │ │ │ +001da6b0: 642f 6f72 206d 6f64 6966 7920 6974 0a20 d/or modify it. │ │ │ +001da6c0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ +001da6d0: 206f 6620 7468 6520 474e 5520 4765 6e65 of the GNU Gene │ │ │ +001da6e0: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ +001da6f0: 7365 2061 7320 7075 626c 6973 6865 6420 se as published │ │ │ +001da700: 6279 2074 6865 0a20 2046 7265 6520 536f by the. Free So │ │ │ +001da710: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ +001da720: 6e3b 206f 6e6c 7920 7665 7273 696f 6e20 n; only version │ │ │ +001da730: 3220 6f66 2074 6865 204c 6963 656e 7365 2 of the License │ │ │ +001da740: 2c20 6461 7465 6420 4a75 6e65 2031 3939 , dated June 199 │ │ │ +001da750: 312e 0a20 200a 2020 5468 6973 2070 726f 1.. . This pro │ │ │ +001da760: 6772 616d 2069 7320 6469 7374 7269 6275 gram is distribu │ │ │ +001da770: 7465 6420 696e 2074 6865 2068 6f70 6520 ted in the hope │ │ │ +001da780: 7468 6174 2069 7420 7769 6c6c 2062 6520 that it will be │ │ │ +001da790: 7573 6566 756c 2c20 6275 740a 2020 5749 useful, but. WI │ │ │ +001da7a0: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ +001da7b0: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ +001da7c0: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ +001da7d0: 7261 6e74 7920 6f66 0a20 204d 4552 4348 ranty of. MERCH │ │ │ +001da7e0: 414e 5441 4249 4c49 5459 206f 7220 4649 ANTABILITY or FI │ │ │ +001da7f0: 544e 4553 5320 464f 5220 4120 5041 5254 TNESS FOR A PART │ │ │ +001da800: 4943 554c 4152 2050 5552 504f 5345 2e20 ICULAR PURPOSE. │ │ │ +001da810: 5365 6520 7468 6520 474e 550a 2020 4765 See the GNU. Ge │ │ │ +001da820: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ +001da830: 656e 7365 2066 6f72 206d 6f72 6520 6465 ense for more de │ │ │ +001da840: 7461 696c 732e 0a20 200a 2020 596f 7520 tails.. . You │ │ │ +001da850: 7368 6f75 6c64 2068 6176 6520 7265 6365 should have rece │ │ │ +001da860: 6976 6564 2061 2063 6f70 7920 6f66 2074 ived a copy of t │ │ │ +001da870: 6865 2047 4e55 2047 656e 6572 616c 2050 he GNU General P │ │ │ +001da880: 7562 6c69 6320 4c69 6365 6e73 6520 616c ublic License al │ │ │ +001da890: 6f6e 670a 2020 7769 7468 2074 6869 7320 ong. with this │ │ │ +001da8a0: 7072 6f67 7261 6d3b 2069 6620 6e6f 742c program; if not, │ │ │ +001da8b0: 2077 7269 7465 2074 6f20 7468 6520 4672 write to the Fr │ │ │ +001da8c0: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ +001da8d0: 6461 7469 6f6e 2c20 496e 632e 2c0a 2020 dation, Inc.,. │ │ │ +001da8e0: 3531 2046 7261 6e6b 6c69 6e20 5374 2c20 51 Franklin St, │ │ │ +001da8f0: 4669 6674 6820 466c 6f6f 722c 2042 6f73 Fifth Floor, Bos │ │ │ +001da900: 746f 6e2c 204d 4120 3032 3131 302d 3133 ton, MA 02110-13 │ │ │ +001da910: 3031 2055 5341 0a0a 2020 3a20 7465 6d70 01 USA.. : temp │ │ │ +001da920: 6c61 7465 2e73 682c 7620 312e 3620 3230 late.sh,v 1.6 20 │ │ │ +001da930: 3039 2f30 342f 3134 2031 313a 3339 3a32 09/04/14 11:39:2 │ │ │ +001da940: 3620 736f 7572 6365 2045 7870 2024 0a2d 6 source Exp $.- │ │ │ +001da950: 2d3e 0a3c 7265 6665 6e74 7279 2069 643d ->.<refentry id= │ │ │ +001da960: 2266 6e5f 6469 6374 5f73 697a 6522 3e0a "fn_dict_size">. │ │ │ +001da970: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 <refmeta>. │ │ │ +001da980: 3c72 6566 656e 7472 7974 6974 6c65 3e64 <refentrytitle>d │ │ │ +001da990: 6963 745f 7369 7a65 3c2f 7265 6665 6e74 ict_size</refent │ │ │ +001da9a0: 7279 7469 746c 653e 0a20 2020 203c 7265 rytitle>. <re │ │ │ +001da9b0: 666d 6973 6369 6e66 6f3e 6469 6374 3c2f fmiscinfo>dict</ │ │ │ +001da9c0: 7265 666d 6973 6369 6e66 6f3e 0a20 203c refmiscinfo>. < │ │ │ +001da9d0: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. <ref │ │ │ +001da9e0: 6e61 6d65 6469 763e 0a20 2020 203c 7265 namediv>. <re │ │ │ +001da9f0: 666e 616d 653e 6469 6374 5f73 697a 653c fname>dict_size< │ │ │ +001daa00: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. <r │ │ │ +001daa10: 6566 7075 7270 6f73 653e 5265 7475 726e efpurpose>Return │ │ │ +001daa20: 7320 7468 6520 6e75 6d62 6572 206f 6620 s the number of │ │ │ +001daa30: 6974 656d 7320 696e 2074 6865 2067 6976 items in the giv │ │ │ +001daa40: 656e 2064 6963 7469 6f6e 6172 792e 3c2f en dictionary.</ │ │ │ +001daa50: 7265 6670 7572 706f 7365 3e0a 2020 3c2f refpurpose>. </ │ │ │ +001daa60: 7265 666e 616d 6564 6976 3e0a 2020 3c72 refnamediv>. <r │ │ │ +001daa70: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ +001daa80: 2020 203c 6675 6e63 7379 6e6f 7073 6973 <funcsynopsis │ │ │ +001daa90: 2069 643d 2266 7379 6e5f 6469 6374 5f73 id="fsyn_dict_s │ │ │ +001daaa0: 697a 6522 3e0a 2020 2020 2020 3c66 756e ize">. <fun │ │ │ +001daab0: 6370 726f 746f 7479 7065 2069 643d 2266 cprototype id="f │ │ │ +001daac0: 7072 6f74 6f5f 6469 6374 5f73 697a 6522 proto_dict_size" │ │ │ +001daad0: 3e0a 2020 2020 2020 2020 3c66 756e 6364 >. <funcd │ │ │ +001daae0: 6566 3e3c 6675 6e63 7469 6f6e 3e64 6963 ef><function>dic │ │ │ +001daaf0: 745f 7369 7a65 3c2f 6675 6e63 7469 6f6e t_size</function │ │ │ +001dab00: 3e3c 2f66 756e 6364 6566 3e0a 093c 7061 ></funcdef>..<pa │ │ │ +001dab10: 7261 6d64 6566 3e69 6e6f 7574 203c 7061 ramdef>inout <pa │ │ │ +001dab20: 7261 6d65 7465 723e 6469 6374 3c2f 7061 rameter>dict</pa │ │ │ +001dab30: 7261 6d65 7465 723e 2064 6963 7469 6f6e rameter> diction │ │ │ +001dab40: 6172 793c 2f70 6172 616d 6465 663e 0a20 ary</paramdef>. │ │ │ +001dab50: 2020 2020 203c 2f66 756e 6370 726f 746f </funcproto │ │ │ +001dab60: 7479 7065 3e0a 2020 2020 3c2f 6675 6e63 type>. </func │ │ │ +001dab70: 7379 6e6f 7073 6973 3e0a 2020 3c2f 7265 synopsis>. </re │ │ │ +001dab80: 6673 796e 6f70 7369 7364 6976 3e0a 2020 fsynopsisdiv>. │ │ │ +001dab90: 3c72 6566 7365 6374 3120 6964 3d22 6465 <refsect1 id="de │ │ │ +001daba0: 7363 5f64 6963 745f 7369 7a65 223e 0a20 sc_dict_size">. │ │ │ +001dabb0: 2020 203c 7469 746c 653e 4465 7363 7269 <title>Descri │ │ │ +001dabc0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ +001dabd0: 2020 3c70 6172 613e 5468 6520 6675 6e63 The func │ │ │ +001dabe0: 7469 6f6e 2072 6574 7572 6e73 2074 6865 tion returns the │ │ │ +001dabf0: 206e 756d 6265 7220 6f66 2069 7465 6d73 number of items │ │ │ +001dac00: 2069 6e20 7468 6520 3c70 6172 616d 6574 in the dict dictionary.. │ │ │ +001dac30: 466f 7220 4e55 4c4c 2076 616c 7565 206f For NULL value o │ │ │ +001dac40: 6620 3c70 6172 616d 6574 6572 3e64 6963 f dic │ │ │ +001dac50: 743c 2f70 6172 616d 6574 6572 3e2c 207a t, z │ │ │ +001dac60: 6572 6f20 6973 2072 6574 7572 6e65 642e ero is returned. │ │ │ +001dac70: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . Parameters. dict │ │ │ +001dace0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +001dacf0: 7061 7261 3e52 6566 6572 656e 6365 2074 para>Reference t │ │ │ +001dad00: 6f20 7468 6520 6469 6374 696f 6e61 7279 o the dictionary │ │ │ +001dad10: 2069 6e20 7175 6573 7469 6f6e 2e3c 2f70 in question.

    . .
    . Return │ │ │ +001dad70: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ +001dad80: 2020 3c70 6172 613e 5468 6520 6675 6e63 The func │ │ │ +001dad90: 7469 6f6e 2072 6574 7572 6e73 2061 6e20 tion returns an │ │ │ +001dada0: 696e 7465 7267 6572 2e3c 2f70 6172 613e interger. │ │ │ +001dadb0: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ +001dadc0: 212d 2d0a 2020 3c72 6566 7365 6374 3120 !--. . Errors │ │ │ +001dae00: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ +001dae10: 6675 6e63 7469 6f6e 2063 616e 2067 656e function can gen │ │ │ +001dae20: 6572 6174 6520 7468 6520 666f 6c6c 6f77 erate the follow │ │ │ +001dae30: 696e 6720 6572 726f 7273 3a3c 2f70 6172 ing errors:. . │ │ │ +001dae60: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001dae70: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ +001dae80: 6d70 6c65 735f 6469 6374 5f73 697a 6522 mples_dict_size" │ │ │ +001dae90: 3e0a 2020 2020 3c74 6974 6c65 3e45 7861 >. Exa │ │ │ +001daea0: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ +001daeb0: 2020 3c65 7861 6d70 6c65 2069 643d 2265 . │ │ │ +001daee0: 2020 203c 7061 7261 3e3c 2f70 6172 613e │ │ │ +001daef0: 0a20 2020 2020 203c 7363 7265 656e 3e3c . < │ │ │ +001daf00: 215b 4344 4154 415b 0a5d 5d3e 0a3c 2f73 ![CDATA[.]]>.
    . . -->. . │ │ │ +001daf60: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ +001daf70: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ +001daf80: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +001daf90: 2266 6e5f 6469 6374 5f6e 6577 223e 3c66 "fn_dict_new"><f │ │ │ +001dafa0: 756e 6374 696f 6e3e 6469 6374 5f6e 6577 unction>dict_new │ │ │ +001dafb0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001dafc0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001dafd0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001dafe0: 656e 643d 2266 6e5f 6469 6374 5f7a 6170 end="fn_dict_zap │ │ │ +001daff0: 223e 3c66 756e 6374 696f 6e3e 6469 6374 "><function>dict │ │ │ +001db000: 5f7a 6170 2829 3c2f 6675 6e63 7469 6f6e _zap()</function │ │ │ +001db010: 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ></link></para>. │ │ │ +001db020: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 <para><link │ │ │ +001db030: 6c69 6e6b 656e 643d 2266 6e5f 6469 6374 linkend="fn_dict │ │ │ +001db040: 5f70 7574 223e 3c66 756e 6374 696f 6e3e _put"><function> │ │ │ +001db050: 6469 6374 5f70 7574 2829 3c2f 6675 6e63 dict_put()</func │ │ │ +001db060: 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 tion></link></pa │ │ │ +001db070: 7261 3e0a 2020 2020 3c70 6172 613e 3c6c ra>. <para><l │ │ │ +001db080: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001db090: 6469 6374 5f67 6574 223e 3c66 756e 6374 dict_get"><funct │ │ │ +001db0a0: 696f 6e3e 6469 6374 5f67 6574 2829 3c2f ion>dict_get()</ │ │ │ +001db0b0: 6675 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e function></link> │ │ │ +001db0c0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 </para>. <par │ │ │ +001db0d0: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +001db0e0: 2266 6e5f 6469 6374 5f72 656d 6f76 6522 "fn_dict_remove" │ │ │ +001db0f0: 3e3c 6675 6e63 7469 6f6e 3e64 6963 745f ><function>dict_ │ │ │ +001db100: 7265 6d6f 7665 2829 3c2f 6675 6e63 7469 remove()</functi │ │ │ +001db110: 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 on></link></para │ │ │ +001db120: 3e0a 2020 2020 3c70 6172 613e 3c6c 696e >. <para><lin │ │ │ +001db130: 6b20 6c69 6e6b 656e 643d 2266 6e5f 6469 k linkend="fn_di │ │ │ +001db140: 6374 5f69 6e63 5f6f 725f 7075 7422 3e3c ct_inc_or_put">< │ │ │ +001db150: 6675 6e63 7469 6f6e 3e64 6963 745f 696e function>dict_in │ │ │ +001db160: 635f 6f72 5f70 7574 2829 3c2f 6675 6e63 c_or_put()</func │ │ │ +001db170: 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 tion></link></pa │ │ │ +001db180: 7261 3e0a 2020 2020 3c70 6172 613e 3c6c ra>. <para><l │ │ │ +001db190: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001db1a0: 6469 6374 5f64 6563 5f6f 725f 7265 6d6f dict_dec_or_remo │ │ │ +001db1b0: 7665 223e 3c66 756e 6374 696f 6e3e 6469 ve"><function>di │ │ │ +001db1c0: 6374 5f64 6563 5f6f 725f 7265 6d6f 7665 ct_dec_or_remove │ │ │ +001db1d0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001db1e0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001db1f0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001db200: 656e 643d 2266 6e5f 6469 6374 5f64 7570 end="fn_dict_dup │ │ │ +001db210: 6c69 6361 7465 223e 3c66 756e 6374 696f licate"><functio │ │ │ +001db220: 6e3e 6469 6374 5f64 7570 6c69 6361 7465 n>dict_duplicate │ │ │ +001db230: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001db240: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001db250: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001db260: 656e 643d 2266 6e5f 6469 6374 5f74 6f5f end="fn_dict_to_ │ │ │ +001db270: 7665 6374 6f72 223e 3c66 756e 6374 696f vector"><functio │ │ │ +001db280: 6e3e 6469 6374 5f74 6f5f 7665 6374 6f72 n>dict_to_vector │ │ │ +001db290: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001db2a0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001db2b0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001db2c0: 656e 643d 2266 6e5f 6469 6374 5f6c 6973 end="fn_dict_lis │ │ │ +001db2d0: 745f 6b65 7973 223e 3c66 756e 6374 696f t_keys"><functio │ │ │ +001db2e0: 6e3e 6469 6374 5f6c 6973 745f 6b65 7973 n>dict_list_keys │ │ │ +001db2f0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001db300: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001db310: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001db320: 656e 643d 2266 6e5f 6469 6374 5f64 6573 end="fn_dict_des │ │ │ +001db330: 7472 7563 7469 7665 5f6c 6973 745f 726e tructive_list_rn │ │ │ +001db340: 645f 6b65 7973 223e 3c66 756e 6374 696f d_keys"><functio │ │ │ +001db350: 6e3e 6469 6374 5f64 6573 7472 7563 7469 n>dict_destructi │ │ │ +001db360: 7665 5f6c 6973 745f 726e 645f 6b65 7973 ve_list_rnd_keys │ │ │ +001db370: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ +001db380: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +001db390: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +001db3a0: 656e 643d 2266 6e5f 6469 6374 5f69 7465 end="fn_dict_ite │ │ │ +001db3b0: 725f 7265 7769 6e64 223e 3c66 756e 6374 r_rewind"><funct │ │ │ +001db3c0: 696f 6e3e 6469 6374 5f69 7465 725f 7265 ion>dict_iter_re │ │ │ +001db3d0: 7769 6e64 2829 3c2f 6675 6e63 7469 6f6e wind()</function │ │ │ +001db3e0: 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ></link></para>. │ │ │ +001db3f0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 <para><link │ │ │ +001db400: 6c69 6e6b 656e 643d 2266 6e5f 6469 6374 linkend="fn_dict │ │ │ +001db410: 5f69 7465 725f 6e65 7874 223e 3c66 756e _iter_next"><fun │ │ │ +001db420: 6374 696f 6e3e 6469 6374 5f69 7465 725f ction>dict_iter_ │ │ │ +001db430: 6e65 7874 2829 3c2f 6675 6e63 7469 6f6e next()</function │ │ │ +001db440: 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ></link></para>. │ │ │ +001db450: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f </refsect1>.</ │ │ │ +001db460: 7265 6665 6e74 7279 3e0a b600 0000 2564 refentry>.....%d │ │ │ +001db470: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ +001db480: 6566 2f73 6574 5f72 6f77 5f63 6f75 6e74 ef/set_row_count │ │ │ +001db490: 2e78 6d6c df00 0011 f83c 3f78 6d6c 2076 .xml.....<?xml v │ │ │ +001db4a0: 6572 7369 6f6e 3d22 312e 3022 2065 6e63 ersion="1.0" enc │ │ │ +001db4b0: 6f64 696e 673d 2249 534f 2d38 3835 392d oding="ISO-8859- │ │ │ +001db4c0: 3122 3f3e 0a3c 212d 2d0a 202d 2020 0a20 1"?>.<!--. - . │ │ │ +001db4d0: 2d20 2054 6869 7320 6669 6c65 2069 7320 - This file is │ │ │ +001db4e0: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ +001db4f0: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ +001db500: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ +001db510: 6365 2028 564f 5329 0a20 2d20 2070 726f ce (VOS). - pro │ │ │ +001db520: 6a65 6374 2e0a 202d 2020 0a20 2d20 2043 ject.. - . - C │ │ │ +001db530: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ +001db540: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ +001db550: 536f 6674 7761 7265 0a20 2d20 200a 202d Software. - . - │ │ │ +001db560: 2020 5468 6973 2070 726f 6a65 6374 2069 This project i │ │ │ +001db570: 7320 6672 6565 2073 6f66 7477 6172 653b s free software; │ │ │ +001db580: 2079 6f75 2063 616e 2072 6564 6973 7472 you can redistr │ │ │ +001db590: 6962 7574 6520 6974 2061 6e64 2f6f 7220 ibute it and/or │ │ │ +001db5a0: 6d6f 6469 6679 2069 740a 202d 2020 756e modify it. - un │ │ │ +001db5b0: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ +001db5c0: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ +001db5d0: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +001db5e0: 6173 2070 7562 6c69 7368 6564 2062 7920 as published by │ │ │ +001db5f0: 7468 650a 202d 2020 4672 6565 2053 6f66 the. - Free Sof │ │ │ +001db600: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ +001db610: 3b20 6f6e 6c79 2076 6572 7369 6f6e 2032 ; only version 2 │ │ │ +001db620: 206f 6620 7468 6520 4c69 6365 6e73 652c of the License, │ │ │ +001db630: 2064 6174 6564 204a 756e 6520 3139 3931 dated June 1991 │ │ │ +001db640: 2e0a 202d 2020 0a20 2d20 2054 6869 7320 .. - . - This │ │ │ +001db650: 7072 6f67 7261 6d20 6973 2064 6973 7472 program is distr │ │ │ +001db660: 6962 7574 6564 2069 6e20 7468 6520 686f ibuted in the ho │ │ │ +001db670: 7065 2074 6861 7420 6974 2077 696c 6c20 pe that it will │ │ │ +001db680: 6265 2075 7365 6675 6c2c 2062 7574 0a20 be useful, but. │ │ │ +001db690: 2d20 2057 4954 484f 5554 2041 4e59 2057 - WITHOUT ANY W │ │ │ +001db6a0: 4152 5241 4e54 593b 2077 6974 686f 7574 ARRANTY; without │ │ │ +001db6b0: 2065 7665 6e20 7468 6520 696d 706c 6965 even the implie │ │ │ +001db6c0: 6420 7761 7272 616e 7479 206f 660a 202d d warranty of. - │ │ │ +001db6d0: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ +001db6e0: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ +001db6f0: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ +001db700: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ +001db710: 4e55 0a20 2d20 2047 656e 6572 616c 2050 NU. - General P │ │ │ +001db720: 7562 6c69 6320 4c69 6365 6e73 6520 666f ublic License fo │ │ │ +001db730: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ +001db740: 202d 2020 0a20 2d20 2059 6f75 2073 686f - . - You sho │ │ │ +001db750: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ +001db760: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ +001db770: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +001db780: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ +001db790: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ +001db7a0: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ +001db7b0: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ +001db7c0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ +001db7d0: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ +001db7e0: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ +001db7f0: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ +001db800: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ +001db810: 3330 3120 5553 410a 202d 2020 0a20 2d20 301 USA. - . - │ │ │ +001db820: 200a 2d2d 3e0a 3c72 6566 656e 7472 7920 .-->.<refentry │ │ │ +001db830: 6964 3d22 666e 5f73 6574 5f72 6f77 5f63 id="fn_set_row_c │ │ │ +001db840: 6f75 6e74 223e 0a20 203c 7265 666d 6574 ount">. <refmet │ │ │ +001db850: 613e 0a20 2020 203c 7265 6665 6e74 7279 a>. <refentry │ │ │ +001db860: 7469 746c 653e 7365 745f 726f 775f 636f title>set_row_co │ │ │ +001db870: 756e 743c 2f72 6566 656e 7472 7974 6974 unt</refentrytit │ │ │ +001db880: 6c65 3e0a 2020 2020 3c72 6566 6d69 7363 le>. <refmisc │ │ │ +001db890: 696e 666f 3e73 716c 3c2f 7265 666d 6973 info>sql</refmis │ │ │ +001db8a0: 6369 6e66 6f3e 0a20 203c 2f72 6566 6d65 cinfo>. </refme │ │ │ +001db8b0: 7461 3e0a 2020 3c72 6566 6e61 6d65 6469 ta>. <refnamedi │ │ │ +001db8c0: 763e 0a20 2020 203c 7265 666e 616d 653e v>. <refname> │ │ │ +001db8d0: 7365 745f 726f 775f 636f 756e 743c 2f72 set_row_count</r │ │ │ +001db8e0: 6566 6e61 6d65 3e0a 2020 2020 3c72 6566 efname>. <ref │ │ │ +001db8f0: 7075 7270 6f73 653e 7365 7473 2074 6865 purpose>sets the │ │ │ +001db900: 2061 6666 6563 7465 6420 726f 7773 2063 affected rows c │ │ │ +001db910: 6f75 6e74 6572 2069 6e20 7468 6520 6375 ounter in the cu │ │ │ +001db920: 7272 656e 7420 636f 6e74 6578 7420 6f72 rrent context or │ │ │ +001db930: 2069 6e20 7468 6520 636f 6e74 6578 7420 in the context │ │ │ +001db940: 6f66 2074 6865 2063 616c 6c65 723c 2f72 of the caller</r │ │ │ +001db950: 6566 7075 7270 6f73 653e 0a20 203c 2f72 efpurpose>. </r │ │ │ +001db960: 6566 6e61 6d65 6469 763e 0a20 203c 7265 efnamediv>. <re │ │ │ +001db970: 6673 796e 6f70 7369 7364 6976 3e0a 2020 fsynopsisdiv>. │ │ │ +001db980: 2020 3c66 756e 6373 796e 6f70 7369 7320 <funcsynopsis │ │ │ +001db990: 6964 3d22 6673 796e 5f73 6574 5f72 6f77 id="fsyn_set_row │ │ │ +001db9a0: 5f63 6f75 6e74 223e 0a20 2020 2020 203c _count">. < │ │ │ +001db9b0: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ +001db9c0: 3d22 6670 726f 746f 5f73 6574 5f72 6f77 ="fproto_set_row │ │ │ +001db9d0: 5f63 6f75 6e74 223e 0a20 2020 2020 2020 _count">. │ │ │ +001db9e0: 203c 6675 6e63 6465 663e 696e 7465 6765 <funcdef>intege │ │ │ +001db9f0: 7220 3c66 756e 6374 696f 6e3e 7365 745f r <function>set_ │ │ │ +001dba00: 726f 775f 636f 756e 743c 2f66 756e 6374 row_count</funct │ │ │ +001dba10: 696f 6e3e 3c2f 6675 6e63 6465 663e 0a09 ion></funcdef>.. │ │ │ +001dba20: 3c70 6172 616d 6465 663e 696e 203c 7061 <paramdef>in <pa │ │ │ +001dba30: 7261 6d65 7465 723e 696e 6372 656d 656e rameter>incremen │ │ │ +001dba40: 743c 2f70 6172 616d 6574 6572 3e20 696e t</parameter> in │ │ │ +001dba50: 7465 6765 723c 2f70 6172 616d 6465 663e teger</paramdef> │ │ │ +001dba60: 0a09 3c70 6172 616d 6465 663e 3c6f 7074 ..<paramdef><opt │ │ │ +001dba70: 696f 6e61 6c3e 696e 203c 7061 7261 6d65 ional>in <parame │ │ │ +001dba80: 7465 723e 7768 6174 3c2f 7061 7261 6d65 ter>what</parame │ │ │ +001dba90: 7465 723e 2069 6e74 6567 6572 3c2f 6f70 ter> integer</op │ │ │ +001dbaa0: 7469 6f6e 616c 3e3c 2f70 6172 616d 6465 tional></paramde │ │ │ +001dbab0: 663e 0a20 2020 2020 203c 2f66 756e 6370 f>. </funcp │ │ │ +001dbac0: 726f 746f 7479 7065 3e0a 2020 2020 3c2f rototype>. </ │ │ │ +001dbad0: 6675 6e63 7379 6e6f 7073 6973 3e0a 3c2f funcsynopsis>.</ │ │ │ +001dbae0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ +001dbaf0: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +001dbb00: 2264 6573 635f 7365 745f 726f 775f 636f "desc_set_row_co │ │ │ +001dbb10: 756e 7422 3e3c 7469 746c 653e 4465 7363 unt"><title>Desc │ │ │ +001dbb20: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +001dbb30: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ +001dbb40: 6675 6e63 7469 6f6e 2073 6574 5f72 6f77 function set_row │ │ │ +001dbb50: 5f63 6f75 6e74 2028 2920 6973 2075 7365 _count () is use │ │ │ +001dbb60: 6420 746f 2073 6574 2074 6865 2061 6666 d to set the aff │ │ │ +001dbb70: 6563 7465 6420 726f 7773 200a 0920 2063 ected rows .. c │ │ │ +001dbb80: 6f75 6e74 6572 2069 6e20 7468 6520 6375 ounter in the cu │ │ │ +001dbb90: 7272 656e 7420 636f 6e74 6578 7420 6f72 rrent context or │ │ │ +001dbba0: 2069 6e20 7468 6520 636f 6e74 6578 7420 in the context │ │ │ +001dbbb0: 6f66 2074 6865 2063 616c 6c65 722e 200a of the caller. . │ │ │ +001dbbc0: 0920 2054 6865 7265 666f 7265 2069 7420 . Therefore it │ │ │ +001dbbd0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ +001dbbe0: 6574 2074 6865 2061 6666 6563 7465 6420 et the affected │ │ │ +001dbbf0: 726f 7773 2063 6f75 6e74 6572 2028 7265 rows counter (re │ │ │ +001dbc00: 7475 726e 6564 2062 7920 3c66 756e 6374 turned by row_count()< │ │ │ +001dbc20: 2f66 756e 6374 696f 6e3e 2920 0a09 2020 /function>) .. │ │ │ +001dbc30: 696e 2070 6c61 6365 7320 7768 6572 6520 in places where │ │ │ +001dbc40: 616e 2069 6e73 7465 6164 206f 6620 7472 an instead of tr │ │ │ +001dbc50: 6967 6765 7220 6973 2075 7365 642e 0a09 igger is used... │ │ │ +001dbc60: 2020 4966 2072 6573 756c 7420 6f66 2064 If result of d │ │ │ +001dbc70: 6563 7265 6d65 6e74 206f 6620 7468 6520 ecrement of the │ │ │ +001dbc80: 6166 6665 6374 6564 2072 6f77 7320 636f affected rows co │ │ │ +001dbc90: 756e 7465 7220 6973 2061 6e20 6e65 6761 unter is an nega │ │ │ +001dbca0: 7469 7665 2069 6e74 6567 6572 2069 7420 tive integer it │ │ │ +001dbcb0: 7769 6c6c 2062 6520 7365 7420 746f 207a will be set to z │ │ │ +001dbcc0: 6572 6f2e 200a 2020 2020 2020 3c2f 7061 ero. . . . . Parameters. increm │ │ │ +001dbd40: 656e 743c 2f74 6974 6c65 3e0a 093c 7061 ent..An integer to │ │ │ +001dbd60: 2062 6520 6164 6465 6420 746f 2074 6865 be added to the │ │ │ +001dbd70: 2061 6666 6563 7465 6420 726f 7273 2063 affected rors c │ │ │ +001dbd80: 6f75 6e74 6572 2c20 6361 6e20 6265 206e ounter, can be n │ │ │ +001dbd90: 6567 6174 6976 6520 616c 736f 3c2f 7061 egative also. . what</t │ │ │ +001dbdd0: 6974 6c65 3e0a 093c 7061 7261 3e54 6865 itle>..<para>The │ │ │ +001dbde0: 2077 6861 7420 2068 6176 6520 746f 2062 what have to b │ │ │ +001dbdf0: 6520 3020 6f72 2031 2c20 3020 6973 2074 e 0 or 1, 0 is t │ │ │ +001dbe00: 6865 2064 6566 6175 6c74 2e20 3020 2d20 he default. 0 - │ │ │ +001dbe10: 666f 7220 7570 6461 7465 2069 6e20 6375 for update in cu │ │ │ +001dbe20: 7272 656e 7420 636f 6e74 6578 7420 7468 rrent context th │ │ │ +001dbe30: 6520 636f 756e 7465 722c 0a09 3120 2d20 e counter,..1 - │ │ │ +001dbe40: 746f 2075 7064 6174 6520 7468 6520 636f to update the co │ │ │ +001dbe50: 756e 7465 7220 696e 2063 6f6e 7465 7874 unter in context │ │ │ +001dbe60: 206f 6620 7468 6520 6361 6c6c 6572 2e3c of the caller.< │ │ │ +001dbe70: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. </ref │ │ │ +001dbe80: 7365 6374 323e 0a20 203c 2f72 6566 7365 sect2>. </refse │ │ │ +001dbe90: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ +001dbea0: 2069 643d 2272 6574 5f73 6574 5f72 6f77 id="ret_set_row │ │ │ +001dbeb0: 5f63 6f75 6e74 223e 3c74 6974 6c65 3e52 _count"><title>R │ │ │ +001dbec0: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ +001dbed0: 6c65 3e3c 7061 7261 3e0a 0920 2054 6865 le><para>.. The │ │ │ +001dbee0: 2066 756e 6374 696f 6e20 7265 7475 726e function return │ │ │ +001dbef0: 7320 6e65 7720 7661 6c75 6520 6f66 2074 s new value of t │ │ │ +001dbf00: 6865 2061 6666 6563 7465 6420 726f 7773 he affected rows │ │ │ +001dbf10: 202c 206f 7220 2d31 2069 6620 6163 7469 , or -1 if acti │ │ │ +001dbf20: 6f6e 2069 7320 6e6f 7420 6170 706c 6963 on is not applic │ │ │ +001dbf30: 6162 6c65 2e0a 3c2f 7061 7261 3e3c 2f72 able..</para></r │ │ │ +001dbf40: 6566 7365 6374 313e 0a0a 2020 3c21 2d2d efsect1>.. <!-- │ │ │ +001dbf50: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ +001dbf60: 6f72 735f 7365 745f 726f 775f 636f 756e ors_set_row_coun │ │ │ +001dbf70: 7422 3e3c 7469 746c 653e 4572 726f 7273 t"><title>Errors │ │ │ +001dbf80: 3c2f 7469 746c 653e 0a20 2020 203c 7461 . Error │ │ │ +001dbfa0: 7320 7369 676e 616c 6c65 6420 6279 3c2f s signalled by</ │ │ │ +001dbfb0: 7469 746c 653e 0a20 2020 2020 203c 7467 title>. <tg │ │ │ +001dbfc0: 726f 7570 2063 6f6c 733d 2234 223e 0a20 roup cols="4">. │ │ │ +001dbfd0: 2020 2020 2020 3c74 6865 6164 3e3c 726f <thead><ro │ │ │ +001dbfe0: 773e 3c65 6e74 7279 3e53 514c 5374 6174 w><entry>SQLStat │ │ │ +001dbff0: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e</entry><entry> │ │ │ +001dc000: 4572 726f 7220 436f 6465 3c2f 656e 7472 Error Code</entr │ │ │ +001dc010: 793e 3c65 6e74 7279 3e45 7272 6f72 2054 y><entry>Error T │ │ │ +001dc020: 6578 743c 2f65 6e74 7279 3e3c 656e 7472 ext</entry><entr │ │ │ +001dc030: 793e 4465 7363 7269 7074 696f 6e3c 2f65 y>Description</e │ │ │ +001dc040: 6e74 7279 3e3c 2f72 6f77 3e3c 2f74 6865 ntry></row></the │ │ │ +001dc050: 6164 3e0a 093c 7462 6f64 793e 0a09 2020 ad>..<tbody>.. │ │ │ +001dc060: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 <row>.. <entr │ │ │ +001dc070: 793e 3c65 7272 6f72 636f 6465 3e3c 2f65 y><errorcode></e │ │ │ +001dc080: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +001dc090: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +001dc0a0: 7272 6f72 636f 6465 3e3c 2f65 7272 6f72 rrorcode></error │ │ │ +001dc0b0: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ +001dc0c0: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ +001dc0d0: 6e61 6d65 3e3c 2f65 7272 6f72 6e61 6d65 name></errorname │ │ │ +001dc0e0: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ +001dc0f0: 656e 7472 793e 3c2f 656e 7472 793e 0a09 entry></entry>.. │ │ │ +001dc100: 2020 3c2f 726f 773e 0a09 3c2f 7462 6f64 </row>..</tbod │ │ │ +001dc110: 793e 0a20 2020 2020 203c 2f74 6772 6f75 y>. </tgrou │ │ │ +001dc120: 703e 0a20 2020 203c 2f74 6162 6c65 3e0a p>. </table>. │ │ │ +001dc130: 2020 3c2f 7265 6673 6563 7431 2d2d 3e0a </refsect1-->. │ │ │ +001dc140: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +001dc150: 6578 616d 706c 6573 5f73 6574 5f72 6f77 examples_set_row │ │ │ +001dc160: 5f63 6f75 6e74 223e 3c74 6974 6c65 3e45 _count"><title>E │ │ │ +001dc170: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ +001dc180: 2020 2020 2020 3c65 7861 6d70 6c65 2069 Sett │ │ │ +001dc1b0: 696e 6720 7468 6520 6166 6665 6374 6564 ing the affected │ │ │ +001dc1c0: 2072 6f77 7320 636f 756e 7465 7220 696e rows counter in │ │ │ +001dc1d0: 2069 6e73 7465 6164 206f 6620 7472 6967 instead of trig │ │ │ +001dc1e0: 6765 723c 2f74 6974 6c65 3e0a 0920 203c ger.. < │ │ │ +001dc1f0: 7061 7261 3e54 6865 2066 6f6c 6c6f 7769 para>The followi │ │ │ +001dc200: 6e67 2053 514c 2073 6372 6970 7420 7769 ng SQL script wi │ │ │ +001dc210: 6c6c 206d 616b 6520 7477 6f20 696e 7374 ll make two inst │ │ │ +001dc220: 6561 6420 6f66 2074 7269 6767 6572 7320 ead of triggers │ │ │ +001dc230: 6f6e 2061 7461 626c 6520 2268 6964 220a on atable "hid". │ │ │ +001dc240: 0920 2020 2020 2061 6e64 2069 6e73 6964 . and insid │ │ │ +001dc250: 6520 7468 656d 2077 696c 6c20 6172 6520 e them will are │ │ │ +001dc260: 6361 6c6c 6564 2073 6574 5f72 6f77 5f63 called set_row_c │ │ │ +001dc270: 6f75 6e74 2074 6f20 7365 7420 7468 6520 ount to set the │ │ │ +001dc280: 726f 7773 2069 6e73 6572 7465 6420 6f72 rows inserted or │ │ │ +001dc290: 2075 7064 6174 6564 200a 0920 2020 2020 updated .. │ │ │ +001dc2a0: 2069 6e20 7468 6520 7365 636f 6e64 2074 in the second t │ │ │ +001dc2b0: 6162 6c65 2e20 416c 736f 2074 6865 7265 able. Also there │ │ │ +001dc2c0: 2061 7265 2074 776f 2070 726f 6365 6475 are two procedu │ │ │ +001dc2d0: 7265 7320 7768 6963 6820 6172 6520 7573 res which are us │ │ │ +001dc2e0: 6564 2074 6f20 6465 6d6f 6e73 7472 6174 ed to demonstrat │ │ │ +001dc2f0: 6520 7468 6520 0a09 2020 2020 2020 7265 e the .. re │ │ │ +001dc300: 7475 726e 2076 616c 7565 206f 6620 726f turn value of ro │ │ │ +001dc310: 775f 636f 756e 742e 3c2f 7061 7261 3e0a w_count.. │ │ │ +001dc320: 2020 2020 2020 3c70 726f 6772 616d 6c69 . │ │ │ +001dc5c0: 2020 3c2f 6578 616d 706c 653e 0a20 203c . < │ │ │ +001dc5d0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. See Als │ │ │ +001dc610: 6f3c 2f74 6974 6c65 3e0a 2020 2020 3c70 o.

    ..row │ │ │ +001dc650: 5f63 6f75 6e74 2829 3c2f 6675 6e63 7469 _count(). < │ │ │ +001dc670: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ +001dc690: 0ab6 0000 0025 6465 6d6f 2f64 6f63 7372 .....%demo/docsr │ │ │ +001dc6a0: 632f 6675 6e63 7265 662f 7870 665f 6578 c/funcref/xpf_ex │ │ │ +001dc6b0: 7465 6e73 696f 6e2e 786d 6cdf 0000 17a2 tension.xml..... │ │ │ +001dc6c0: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... │ │ │ +001dca70: 203c 7265 666d 6574 613e 200a 2020 2020 . │ │ │ +001dca80: 3c72 6566 656e 7472 7974 6974 6c65 3e78 x │ │ │ +001dca90: 7066 5f65 7874 656e 7369 6f6e 3c2f 7265 pf_extension . │ │ │ +001dcab0: 2020 3c72 6566 6d69 7363 696e 666f 3e78 x │ │ │ +001dcac0: 6d6c 3c2f 7265 666d 6973 6369 6e66 6f3e ml │ │ │ +001dcad0: 0a20 203c 2f72 6566 6d65 7461 3e20 0a20 . . │ │ │ +001dcae0: 203c 7265 666e 616d 6564 6976 3e20 0a20 . │ │ │ +001dcaf0: 2020 203c 7265 666e 616d 653e 7870 665f xpf_ │ │ │ +001dcb00: 6578 7465 6e73 696f 6e3c 2f72 6566 6e61 extension . declare an │ │ │ +001dcb30: 5850 6174 6820 6578 7465 6e73 696f 6e20 XPath extension │ │ │ +001dcb40: 6675 6e63 7469 6f6e 203c 2f72 6566 7075 function . . . │ │ │ +001dcb80: 3c66 756e 6373 796e 6f70 7369 7320 6964 . . < │ │ │ +001dcbe0: 6675 6e63 6465 663e 766f 6964 203c 6675 funcdef>void xpf_exten │ │ │ +001dcc00: 7369 6f6e 3c2f 6675 6e63 7469 6f6e 3e3c sion< │ │ │ +001dcc10: 2f66 756e 6364 6566 3e20 0a09 3c70 6172 /funcdef> ..in fname varchar

    ..in procedure_name │ │ │ +001dcc80: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +001dcc90: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +001dcca0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ +001dcce0: 203c 7265 6673 6563 7431 2069 643d 2264 Descri │ │ │ +001dcd10: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ +001dcd20: 2020 3c70 6172 613e 0a20 2020 2054 6869 . Thi │ │ │ +001dcd30: 7320 6675 6e63 7469 6f6e 2069 7320 7573 s function is us │ │ │ +001dcd40: 6564 2074 6f20 6465 636c 6172 6520 6120 ed to declare a │ │ │ +001dcd50: 6e65 7720 5850 6174 6820 6578 7465 6e73 new XPath extens │ │ │ +001dcd60: 696f 6e20 6675 6e63 7469 6f6e 206f 720a ion function or. │ │ │ +001dcd70: 7265 6465 6669 6e65 2061 6e20 6578 6973 redefine an exis │ │ │ +001dcd80: 7469 6e67 2066 756e 6374 696f 6e2e 2020 ting function. │ │ │ +001dcd90: 4974 2063 616e 2062 6520 7573 6564 2069 It can be used i │ │ │ +001dcda0: 6e20 5850 6174 6820 7175 6572 6965 7320 n XPath queries │ │ │ +001dcdb0: 616e 640a 5853 4c54 2073 7479 6c65 7368 and.XSLT stylesh │ │ │ +001dcdc0: 6565 7473 2e20 2059 6f75 2073 686f 756c eets. You shoul │ │ │ +001dcdd0: 6420 7573 6520 514e 616d 6573 2066 6f72 d use QNames for │ │ │ +001dcde0: 2065 7874 656e 7369 6f6e 2066 756e 6374 extension funct │ │ │ +001dcdf0: 696f 6e73 2e0a 4e6f 7465 2074 6861 7420 ions..Note that │ │ │ +001dce00: 7468 6520 7374 616e 6461 7264 2058 5061 the standard XPa │ │ │ +001dce10: 7468 2066 756e 6374 696f 6e73 2063 616e th functions can │ │ │ +001dce20: 6e6f 7420 6265 2072 6564 6566 696e 6564 not be redefined │ │ │ +001dce30: 2e3c 2f70 6172 613e 0a0a 3c70 6172 613e ... │ │ │ +001dce40: 3c66 756e 6374 696f 6e3e 7870 665f 6578 xpf_ex │ │ │ +001dce50: 7465 6e73 696f 6e28 293c 2f66 756e 6374 tension() stores the │ │ │ +001dce70: 6675 6e63 7469 6f6e 7320 696e 746f 0a74 functions into.t │ │ │ +001dce80: 6865 2053 5953 5f58 5046 5f45 5854 454e he SYS_XPF_EXTEN │ │ │ +001dce90: 5349 4f4e 5320 7379 7374 656d 2074 6162 SIONS system tab │ │ │ +001dcea0: 6c65 2e0a 2020 2020 3c2f 7061 7261 3e0a le.. . │ │ │ +001dceb0: 2020 2020 3c70 726f 6772 616d 6c69 7374 . CREAT │ │ │ +001dced0: 4520 5441 424c 4520 0a20 2020 2020 2020 E TABLE . │ │ │ +001dcee0: 2044 422e 4442 412e 5359 535f 5850 465f DB.DBA.SYS_XPF_ │ │ │ +001dcef0: 4558 5445 4e53 494f 4e53 2028 0a09 2020 EXTENSIONS (.. │ │ │ +001dcf00: 2020 5850 455f 4e41 4d45 2056 4152 4348 XPE_NAME VARCH │ │ │ +001dcf10: 4152 2050 5249 4d41 5259 204b 4559 2c20 AR PRIMARY KEY, │ │ │ +001dcf20: 0a09 2020 2020 5850 455f 504e 414d 4520 .. XPE_PNAME │ │ │ +001dcf30: 5641 5243 4841 520a 0920 2020 2029 0a20 VARCHAR.. ). │ │ │ +001dcf40: 2020 203c 2f70 726f 6772 616d 6c69 7374 .. │ │ │ +001dcf60: 0a20 2020 2054 6865 2069 6e70 7574 2070 . The input p │ │ │ +001dcf70: 6172 616d 6574 6572 7320 7769 6c6c 2062 arameters will b │ │ │ +001dcf80: 6520 7265 7472 6965 7665 6420 6173 2061 e retrieved as a │ │ │ +001dcf90: 2073 7472 696e 6773 2061 6e64 2074 6865 strings and the │ │ │ +001dcfa0: 6e20 7769 6c6c 2062 6520 636f 6e76 6572 n will be conver │ │ │ +001dcfb0: 7465 6420 746f 2074 6865 2064 6174 6174 ted to the datat │ │ │ +001dcfc0: 7970 6520 6f66 200a 2020 2020 7468 6520 ype of . the │ │ │ +001dcfd0: 636f 7272 6573 706f 6e64 696e 6720 6172 corresponding ar │ │ │ +001dcfe0: 6775 6d65 6e74 206f 6620 7468 6520 7374 gument of the st │ │ │ +001dcff0: 6f72 6564 2070 726f 6365 6475 7265 2e20 ored procedure. │ │ │ +001dd000: 0a20 2020 203c 2f70 6172 613e 0a20 2020 . . │ │ │ +001dd010: 200a 2020 3c2f 7265 6673 6563 7431 3e0a . . │ │ │ +001dd020: 2020 3c72 6566 7365 6374 3120 6964 3d22 Par │ │ │ +001dd050: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ +001dd060: 2020 2020 3c72 6566 7365 6374 323e 3c74 fname. T │ │ │ +001dd090: 6865 206e 616d 6520 6f66 2074 6865 2065 he name of the e │ │ │ +001dd0a0: 7874 656e 7369 6f6e 2066 756e 6374 696f xtension functio │ │ │ +001dd0b0: 6e2c 2077 6869 6368 206d 7573 7420 6265 n, which must be │ │ │ +001dd0c0: 2074 6865 2065 7870 616e 6465 6420 514e the expanded QN │ │ │ +001dd0d0: 616d 6520 0a20 2020 2020 206f 6620 7468 ame . of th │ │ │ +001dd0e0: 6520 6578 7465 6e73 696f 6e20 6675 6e63 e extension func │ │ │ +001dd0f0: 7469 6f6e 3c2f 7061 7261 3e3c 2f72 6566 tion. proc │ │ │ +001dd120: 6564 7572 655f 6e61 6d65 3c2f 7469 746c edure_name</titl │ │ │ +001dd130: 653e 0a20 2020 2020 203c 7061 7261 3e54 e>. <para>T │ │ │ +001dd140: 6865 2066 756c 6c79 2071 7561 6c69 6669 he fully qualifi │ │ │ +001dd150: 6564 206e 616d 6520 6f66 2074 6865 2050 ed name of the P │ │ │ +001dd160: 4c20 7072 6f63 6564 7572 6520 7768 6963 L procedure whic │ │ │ +001dd170: 6820 6163 7473 2061 7320 0a20 2020 2020 h acts as . │ │ │ +001dd180: 2074 6865 2065 7874 656e 7369 6f6e 2066 the extension f │ │ │ +001dd190: 756e 6374 696f 6e2e 2054 6865 2070 726f unction. The pro │ │ │ +001dd1a0: 6365 6475 7265 2069 6e20 7175 6573 7469 cedure in questi │ │ │ +001dd1b0: 6f6e 206d 7573 7420 6265 2067 7261 6e74 on must be grant │ │ │ +001dd1c0: 6564 2074 6f20 5055 424c 4943 2c0a 2020 ed to PUBLIC,. │ │ │ +001dd1d0: 2020 2020 6f74 6865 7277 6973 6520 6974 otherwise it │ │ │ +001dd1e0: 2077 696c 6c20 6e6f 7420 6265 2072 6567 will not be reg │ │ │ +001dd1f0: 6973 7465 7265 6420 616e 6420 6572 726f istered and erro │ │ │ +001dd200: 7220 7769 6c6c 2062 6520 7369 676e 616c r will be signal │ │ │ +001dd210: 6c65 642e 200a 2020 2020 2020 3c2f 7061 led. . </pa │ │ │ +001dd220: 7261 3e3c 2f72 6566 7365 6374 323e 0a20 ra></refsect2>. │ │ │ +001dd230: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ +001dd240: 7265 6673 6563 7431 2069 643d 2272 6574 refsect1 id="ret │ │ │ +001dd250: 5f78 7066 5f65 7874 656e 7369 6f6e 223e _xpf_extension"> │ │ │ +001dd260: 3c74 6974 6c65 3e52 6574 7572 6e20 5479 <title>Return Ty │ │ │ +001dd270: 7065 733c 2f74 6974 6c65 3e0a 2020 3c70 pes.

    None (void). │ │ │ +001dd290: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . Errors. │ │ │ +001dd2e0: 2020 2020 3c74 6162 6c65 3e3c 7469 746c Errors signall │ │ │ +001dd300: 6564 2062 793c 2f74 6974 6c65 3e0a 2020 ed by. │ │ │ +001dd310: 2020 2020 3c74 6772 6f75 7020 636f 6c73 .
    │ │ │ +001dd340: 5351 4c53 7461 7465 3c2f 656e 7472 793e SQLState │ │ │ +001dd350: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ +001dd360: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ +001dd370: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ +001dd390: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion.... .. │ │ │ +001dd3c0: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 42001.. │ │ │ +001dd3f0: 2020 203c 656e 7472 793e 3c65 7272 6f72 XPE01.. │ │ │ +001dd420: 2020 2020 3c65 6e74 7279 3e3c 6572 726f The functi │ │ │ +001dd440: 6f6e 2026 6c74 3b70 726f 6365 6475 7265 on <procedure │ │ │ +001dd450: 5f6e 616d 6526 6774 3b20 646f 6573 206e _name> does n │ │ │ +001dd460: 6f74 2065 7869 7374 3c2f 6572 726f 726e ot exist.. │ │ │ +001dd480: 2020 3c65 6e74 7279 3e69 6620 7072 6f63 if proc │ │ │ +001dd490: 6564 7572 6520 746f 2064 6566 696e 6520 edure to define │ │ │ +001dd4a0: 6173 2061 2058 5041 5448 2065 7874 656e as a XPATH exten │ │ │ +001dd4b0: 7369 6f6e 2066 756e 6374 696f 6e20 6973 sion function is │ │ │ +001dd4c0: 206e 6f74 2065 7869 7374 696e 6720 6f6e not existing on │ │ │ +001dd4d0: 652e 3c2f 656e 7472 793e 0a09 2020 3c2f e... .. .. │ │ │ +001dd4f0: 2020 203c 656e 7472 793e 3c65 7272 6f72 42001.. │ │ │ +001dd520: 2020 2020 3c65 6e74 7279 3e3c 6572 726f XPE02. │ │ │ +001dd550: 0920 2020 203c 656e 7472 793e 3c65 7272 . func │ │ │ +001dd590: 7469 6f6e 2022 3c66 756e 6320 6e61 6d65 tion "" cannot be re- │ │ │ +001dd5b0: 6465 6669 6e65 645d 5d3e 3c2f 6572 726f defined]]>.. │ │ │ +001dd5d0: 2020 2020 3c65 6e74 7279 3e69 6620 5850 if XP │ │ │ +001dd5e0: 4154 4820 6f72 2058 5155 4552 5920 6675 ATH or XQUERY fu │ │ │ +001dd5f0: 6e63 7469 6f6e 2074 6f20 6265 2072 6567 nction to be reg │ │ │ +001dd600: 6973 7465 7265 6420 6973 2061 2063 6f72 istered is a cor │ │ │ +001dd610: 6520 6675 6e63 7469 6f6e 2e3c 2f65 6e74 e function... ..< │ │ │ +001dd630: 2f74 626f 6479 3e0a 2020 2020 2020 3c2f /tbody>. . . . Examples. Dec │ │ │ +001dd6d0: 6c61 7269 6e67 2061 204e 6577 2058 534c laring a New XSL │ │ │ +001dd6e0: 5420 4675 6e63 7469 6f6e 3c2f 7469 746c T Function</titl │ │ │ +001dd6f0: 653e 0a0a 3c70 6172 613e 4669 7273 7420 e>..<para>First │ │ │ +001dd700: 6465 6669 6e65 2061 2050 4c20 7072 6f63 define a PL proc │ │ │ +001dd710: 6564 7572 652c 2074 6865 6e20 6465 636c edure, then decl │ │ │ +001dd720: 6172 6520 616e 2058 5061 7468 2065 7874 are an XPath ext │ │ │ +001dd730: 656e 7369 6f6e 0a66 756e 6374 696f 6e20 ension.function │ │ │ +001dd740: 616e 6420 746f 2072 6570 7265 7365 6e74 and to represent │ │ │ +001dd750: 2069 742e 3c2f 7061 7261 3e0a 0a3c 7072 it.</para>..<pr │ │ │ +001dd760: 6f67 7261 6d6c 6973 7469 6e67 3e0a 3c21 ogramlisting>.<! │ │ │ +001dd770: 5b43 4441 5441 5b0a 5351 4c3e 2063 7265 [CDATA[.SQL> cre │ │ │ +001dd780: 6174 6520 7072 6f63 6564 7572 6520 4442 ate procedure DB │ │ │ +001dd790: 2e44 4241 2e73 7472 5f63 6f6e 6361 7420 .DBA.str_concat │ │ │ +001dd7a0: 2869 6e20 6120 7661 7263 6861 722c 2069 (in a varchar, i │ │ │ +001dd7b0: 6e20 6220 7661 7263 6861 7229 0a20 2020 n b varchar). │ │ │ +001dd7c0: 2020 7b0a 2020 2020 2020 2072 6574 7572 {. retur │ │ │ +001dd7d0: 6e20 636f 6e63 6174 2028 612c 2027 3a27 n concat (a, ':' │ │ │ +001dd7e0: 2c20 6229 3b0a 2020 2020 207d 3b0a 0a53 , b);. };..S │ │ │ +001dd7f0: 514c 3e20 7870 665f 6578 7465 6e73 696f QL> xpf_extensio │ │ │ +001dd800: 6e20 2827 6874 7470 3a2f 2f65 7861 6d70 n ('http://examp │ │ │ +001dd810: 6c65 2e63 6f6d 2f76 6972 7475 6f73 6f2f le.com/virtuoso/ │ │ │ +001dd820: 7873 6c74 3a63 6f6e 6361 745f 7374 7269 xslt:concat_stri │ │ │ +001dd830: 6e67 7327 2c20 2744 422e 4442 412e 7374 ngs', 'DB.DBA.st │ │ │ +001dd840: 725f 636f 6e63 6174 2729 3b0a 5d5d 3e0a r_concat');.]]>. │ │ │ +001dd850: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 </programlisting │ │ │ +001dd860: 3e0a 0a3c 7061 7261 3e20 5468 6520 736f >..<para> The so │ │ │ +001dd870: 7572 6365 206f 6620 7468 6520 285b 6874 urce of the ([ht │ │ │ +001dd880: 7470 5f72 6f6f 745d 2f65 7874 2e78 736c tp_root]/ext.xsl │ │ │ +001dd890: 2920 5853 4c54 2073 7479 6c65 7368 6565 ) XSLT styleshee │ │ │ +001dd8a0: 7420 3c2f 7061 7261 3e0a 0a3c 7072 6f67 t </para>..<prog │ │ │ +001dd8b0: 7261 6d6c 6973 7469 6e67 3e0a 3c21 5b43 ramlisting>.<![C │ │ │ +001dd8c0: 4441 5441 5b0a 3c3f 786d 6c20 7665 7273 DATA[.<?xml vers │ │ │ +001dd8d0: 696f 6e3d 2731 2e30 273f 3e0a 3c78 736c ion='1.0'?>.<xsl │ │ │ +001dd8e0: 3a73 7479 6c65 7368 6565 7420 786d 6c6e :stylesheet xmln │ │ │ +001dd8f0: 733a 7873 6c3d 2268 7474 703a 2f2f 7777 s:xsl="http://ww │ │ │ +001dd900: 772e 7733 2e6f 7267 2f54 522f 5744 2d78 w.w3.org/TR/WD-x │ │ │ +001dd910: 736c 2220 0a20 2078 6d6c 6e73 3a76 6972 sl" . xmlns:vir │ │ │ +001dd920: 743d 2268 7474 703a 2f2f 6578 616d 706c t="http://exampl │ │ │ +001dd930: 652e 636f 6d2f 7669 7274 756f 736f 2f78 e.com/virtuoso/x │ │ │ +001dd940: 736c 7422 3e0a 2020 3c78 736c 3a74 656d slt">. <xsl:tem │ │ │ +001dd950: 706c 6174 6520 6d61 7463 683d 222f 646f plate match="/do │ │ │ +001dd960: 6322 3e0a 2020 2020 3c48 544d 4c3e 0a20 c">. <HTML>. │ │ │ +001dd970: 2020 2020 3c42 4f44 593e 0a20 2020 2020 <BODY>. │ │ │ +001dd980: 3c78 736c 3a69 6620 7465 7374 3d22 6675 <xsl:if test="fu │ │ │ +001dd990: 6e63 7469 6f6e 2d61 7661 696c 6162 6c65 nction-available │ │ │ +001dd9a0: 2827 7669 7274 3a63 6f6e 6361 745f 7374 ('virt:concat_st │ │ │ +001dd9b0: 7269 6e67 7327 2922 3e0a 2020 2020 2020 rings')">. │ │ │ +001dd9c0: 3c78 736c 3a76 616c 7565 2d6f 6620 7365 <xsl:value-of se │ │ │ +001dd9d0: 6c65 6374 3d22 7669 7274 3a63 6f6e 6361 lect="virt:conca │ │ │ +001dd9e0: 745f 7374 7269 6e67 7320 2827 666f 6f27 t_strings ('foo' │ │ │ +001dd9f0: 2c20 2762 6172 2729 222f 3e0a 2020 2020 , 'bar')"/>. │ │ │ +001dda00: 203c 2f78 736c 3a69 663e 0a20 2020 2020 </xsl:if>. │ │ │ +001dda10: 3c2f 424f 4459 3e0a 2020 2020 3c2f 4854 </BODY>. </HT │ │ │ +001dda20: 4d4c 3e0a 2020 3c2f 7873 6c3a 7465 6d70 ML>. </xsl:temp │ │ │ +001dda30: 6c61 7465 3e0a 3c2f 7873 6c3a 7374 796c late>.</xsl:styl │ │ │ +001dda40: 6573 6865 6574 3e0a 5d5d 3e0a 3c2f 7072 esheet>.]]>.</pr │ │ │ +001dda50: 6f67 7261 6d6c 6973 7469 6e67 3e0a 0a3c ogramlisting>..< │ │ │ +001dda60: 7061 7261 3e54 6865 2073 6f75 7263 6520 para>The source │ │ │ +001dda70: 6f66 2074 6865 0a3c 7072 6f67 7261 6d6c of the.<programl │ │ │ +001dda80: 6973 7469 6e67 3e28 5b68 7474 705f 726f isting>([http_ro │ │ │ +001dda90: 6f74 5d2f 6578 742e 7673 7029 3c2f 7072 ot]/ext.vsp)</pr │ │ │ +001ddaa0: 6f67 7261 6d6c 6973 7469 6e67 3e20 5653 ogramlisting> VS │ │ │ +001ddab0: 5020 7061 6765 3a0a 3c2f 7061 7261 3e0a P page:.</para>. │ │ │ +001ddac0: 0a3c 7072 6f67 7261 6d6c 6973 7469 6e67 .<programlisting │ │ │ +001ddad0: 3e0a 3c21 5b43 4441 5441 5b0a 3c3f 7673 >.<![CDATA[.<?vs │ │ │ +001ddae0: 700a 2020 6874 7470 5f78 736c 7420 2827 p. http_xslt (' │ │ │ +001ddaf0: 6669 6c65 3a2f 6578 742e 7873 6c27 293b file:/ext.xsl'); │ │ │ +001ddb00: 0a3f 3e0a 3c64 6f63 3e0a 3c61 2f3e 0a3c .?>.<doc>.<a/>.< │ │ │ +001ddb10: 2f64 6f63 3e0a 5d5d 3e0a 3c2f 7072 6f67 /doc>.]]>.</prog │ │ │ +001ddb20: 7261 6d6c 6973 7469 6e67 3e0a 0a3c 7061 ramlisting>..<pa │ │ │ +001ddb30: 7261 3e0a 5468 6973 2077 696c 6c20 7072 ra>.This will pr │ │ │ +001ddb40: 6f64 7563 6520 7468 6520 666f 6c6c 6f77 oduce the follow │ │ │ +001ddb50: 696e 6720 4854 4d4c 2070 6167 653a 0a3c ing HTML page:.< │ │ │ +001ddb60: 2f70 6172 613e 0a0a 3c70 726f 6772 616d /para>..<program │ │ │ +001ddb70: 6c69 7374 696e 673e 0a26 6c74 3b48 544d listing>.<HTM │ │ │ +001ddb80: 4c26 6774 3b26 6c74 3b42 4f44 5926 6774 L><BODY> │ │ │ +001ddb90: 3b66 6f6f 3a62 6172 266c 743b 2f42 4f44 ;foo:bar</BOD │ │ │ +001ddba0: 5926 6774 3b26 6c74 3b2f 4854 4d4c 2667 Y></HTML&g │ │ │ +001ddbb0: 743b 0a3c 2f70 726f 6772 616d 6c69 7374 t;.</programlist │ │ │ +001ddbc0: 696e 673e 0a0a 3c70 6172 613e 5573 696e ing>..<para>Usin │ │ │ +001ddbd0: 6720 7468 6520 6465 6669 6e69 7469 6f6e g the definition │ │ │ +001ddbe0: 206f 6620 7468 6520 5850 6174 6820 6578 of the XPath ex │ │ │ +001ddbf0: 7465 6e73 696f 6e20 6675 6e63 7469 6f6e tension function │ │ │ +001ddc00: 2c20 7765 2063 616e 0a69 6e63 6c75 6465 , we can.include │ │ │ +001ddc10: 2069 7420 696e 2058 5061 7468 2065 7870 it in XPath exp │ │ │ +001ddc20: 7265 7373 696f 6e73 2e3c 2f70 6172 613e ressions.</para> │ │ │ +001ddc30: 0a0a 3c70 726f 6772 616d 6c69 7374 696e ..<programlistin │ │ │ +001ddc40: 673e 0a53 514c 3e20 7365 6c65 6374 2070 g>.SQL> select p │ │ │ +001ddc50: 2066 726f 6d20 7773 2e2e 7379 735f 6461 from ws..sys_da │ │ │ +001ddc60: 765f 7265 730a 7768 6572 6520 7870 6174 v_res.where xpat │ │ │ +001ddc70: 685f 636f 6e74 6169 6e73 2028 5245 535f h_contains (RES_ │ │ │ +001ddc80: 434f 4e54 454e 542c 0a27 5b78 6d6c 6e73 CONTENT,.'[xmlns │ │ │ +001ddc90: 3a76 6972 743d 2727 6874 7470 3a2f 2f65 :virt=''http://e │ │ │ +001ddca0: 7861 6d70 6c65 2e63 6f6d 2f76 6972 7475 xample.com/virtu │ │ │ +001ddcb0: 6f73 6f2f 7873 6c74 2727 5d0a 7669 7274 oso/xslt''].virt │ │ │ +001ddcc0: 3a63 6f6e 6361 745f 7374 7269 6e67 7320 :concat_strings │ │ │ +001ddcd0: 2827 2754 6974 6c65 2027 272c 2073 7472 (''Title '', str │ │ │ +001ddce0: 696e 6728 2f63 6861 7074 6572 2f74 6974 ing(/chapter/tit │ │ │ +001ddcf0: 6c65 2929 272c 2070 293b 0a3c 2f70 726f le))', p);.</pro │ │ │ +001ddd00: 6772 616d 6c69 7374 696e 673e 0a0a 3c70 gramlisting>..<p │ │ │ +001ddd10: 6172 613e 5468 6973 2077 696c 6c20 7265 ara>This will re │ │ │ +001ddd20: 7475 726e 2074 6865 2063 6f6e 7465 6e74 turn the content │ │ │ +001ddd30: 7320 6f66 2061 6e79 2027 2f63 6861 7074 s of any '/chapt │ │ │ +001ddd40: 6572 2f74 6974 6c65 2720 6e6f 6465 732c er/title' nodes, │ │ │ +001ddd50: 2070 7265 6669 7865 640a 7769 7468 2063 prefixed.with c │ │ │ +001ddd60: 6f6e 7374 616e 7420 7374 7269 6e67 2027 onstant string ' │ │ │ +001ddd70: 5469 746c 6527 2e3c 2f70 6172 613e 0a20 Title'.</para>. │ │ │ +001ddd80: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 </example>. │ │ │ +001ddd90: 3c2f 7265 6673 6563 7431 3e0a 0a0a 2020 </refsect1>... │ │ │ +001ddda0: 3c72 6566 7365 6374 3120 6964 3d22 7365 <refsect1 id="se │ │ │ +001dddb0: 6561 6c73 6f5f 7870 665f 6578 7465 6e73 ealso_xpf_extens │ │ │ +001dddc0: 696f 6e22 3e3c 7469 746c 653e 5365 6520 ion"><title>See │ │ │ +001dddd0: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ +001ddde0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ +001dde10: 6675 6e63 7469 6f6e 3e78 7066 5f65 7874 function>xpf_ext │ │ │ +001dde20: 656e 7369 6f6e 5f72 656d 6f76 653c 2f66 ension_remove< │ │ │ +001dde40: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ +001dde60: 0a0a b600 0000 2364 656d 6f2f 646f 6373 ......#demo/docs │ │ │ +001dde70: 7263 2f66 756e 6372 6566 2f64 6963 745f rc/funcref/dict_ │ │ │ +001dde80: 7265 6d6f 7665 2e78 6d6c df00 000f 813c remove.xml.....< │ │ │ +001dde90: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +001ddea0: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +001ddeb0: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . │ │ │ +001de250: 2020 203c 7265 6665 6e74 7279 7469 746c dict_remove. │ │ │ +001de280: 2020 3c72 6566 6d69 7363 696e 666f 3e64 d │ │ │ +001de290: 6963 743c 2f72 6566 6d69 7363 696e 666f ict. . │ │ │ +001de2b0: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001de2c0: 2020 3c72 6566 6e61 6d65 3e64 6963 745f dict_ │ │ │ +001de2d0: 7265 6d6f 7665 3c2f 7265 666e 616d 653e remove │ │ │ +001de2e0: 0a20 2020 203c 7265 6670 7572 706f 7365 . Removes the giv │ │ │ +001de300: 656e 206b 6579 2061 6e64 2061 7373 6f63 en key and assoc │ │ │ +001de310: 6961 7465 6420 6465 7065 6e64 656e 7420 iated dependent │ │ │ +001de320: 7661 6c75 6520 6672 6f6d 2074 6865 2067 value from the g │ │ │ +001de330: 6976 656e 2064 6963 7469 6f6e 6172 792e iven dictionary. │ │ │ +001de340: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ +001de350: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001de360: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ +001de370: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . │ │ │ +001de3a0: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ +001de3d0: 3c66 756e 6364 6566 3e69 6e74 203c 6675 int dict_remo │ │ │ +001de3f0: 7665 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 ve..inout dict dictionary< │ │ │ +001de440: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..inout key any. . │ │ │ +001de4a0: 203c 2f66 756e 6373 796e 6f70 7369 733e │ │ │ +001de4b0: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . . . Description. The function re │ │ │ +001de520: 6d6f 7665 7320 7468 6520 6769 7665 6e20 moves the given │ │ │ +001de530: 6b65 7920 616e 6420 7468 6520 6173 736f key and the asso │ │ │ +001de540: 6369 6174 6564 2064 6570 656e 6465 6e74 ciated dependent │ │ │ +001de550: 2076 616c 7565 2066 726f 6d20 7468 6520 value from the │ │ │ +001de560: 6769 7665 6e20 6469 6374 696f 6e61 7279 given dictionary │ │ │ +001de570: 2e0a 4966 2074 6865 206b 6579 2d76 616c ..If the key-val │ │ │ +001de580: 7565 2070 6169 7220 6973 2066 6f75 6e64 ue pair is found │ │ │ +001de590: 2028 616e 6420 7265 6d6f 7665 6429 2074 (and removed) t │ │ │ +001de5a0: 6865 2066 756e 6374 696f 6e20 7265 7475 he function retu │ │ │ +001de5b0: 726e 7320 312e 0a49 6620 7468 6520 6469 rns 1..If the di │ │ │ +001de5c0: 6374 696f 6e61 7279 2064 6f65 7320 6e6f ctionary does no │ │ │ +001de5d0: 7420 636f 6e74 6169 6e20 6120 6b65 7920 t contain a key │ │ │ +001de5e0: 6571 7569 7661 6c65 6e74 2074 6f20 7468 equivalent to th │ │ │ +001de5f0: 6520 6769 7665 6e20 6f6e 6520 7468 6520 e given one the │ │ │ +001de600: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ +001de610: 207a 6572 6f2e 0a3c 2f70 6172 613e 0a20 zero... │ │ │ +001de620: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001de630: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ +001de640: 616d 735f 6469 6374 5f72 656d 6f76 6522 ams_dict_remove" │ │ │ +001de650: 3e0a 2020 2020 3c74 6974 6c65 3e50 6172 >. Par │ │ │ +001de660: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ +001de670: 2020 2020 3c72 6566 7365 6374 323e 3c74 dict. Di │ │ │ +001de6a0: 6374 696f 6e61 7279 206f 626a 6563 7420 ctionary object │ │ │ +001de6b0: 746f 2070 726f 6365 7373 2e3c 2f70 6172 to process.. . key</tit │ │ │ +001de6f0: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +001de700: 4b65 7920 6f66 2061 206b 6579 2d76 616c Key of a key-val │ │ │ +001de710: 7565 2070 6169 7220 7468 6174 2073 686f ue pair that sho │ │ │ +001de720: 756c 6420 6265 2072 656d 6f76 6564 2066 uld be removed f │ │ │ +001de730: 726f 6d20 7468 6520 6469 6374 696f 6e61 rom the dictiona │ │ │ +001de740: 7279 2e3c 2f70 6172 613e 0a20 2020 203c ry.</para>. < │ │ │ +001de750: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ +001de760: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ +001de770: 6563 7431 2069 643d 2272 6574 5f64 6963 ect1 id="ret_dic │ │ │ +001de780: 745f 7265 6d6f 7665 223e 3c74 6974 6c65 t_remove"><title │ │ │ +001de790: 3e52 6574 7572 6e20 5479 7065 733c 2f74 >Return Types</t │ │ │ +001de7a0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +001de7b0: 496e 7465 6765 7220 666c 6167 2069 6e64 Integer flag ind │ │ │ +001de7c0: 6963 6174 696e 6720 6966 2061 206b 6579 icating if a key │ │ │ +001de7d0: 2d76 616c 7565 2070 6169 7220 6861 7320 -value pair has │ │ │ +001de7e0: 6265 656e 2066 6f75 6e64 2061 6e64 2072 been found and r │ │ │ +001de7f0: 656d 6f76 6564 2e3c 2f70 6172 613e 0a20 emoved.</para>. │ │ │ +001de800: 203c 2f72 6566 7365 6374 313e 0a3c 212d </refsect1>.<!- │ │ │ +001de810: 2d20 203c 7265 6673 6563 7431 2069 643d - <refsect1 id= │ │ │ +001de820: 2265 7861 6d70 6c65 735f 6469 6374 5f72 "examples_dict_r │ │ │ +001de830: 656d 6f76 6522 3e0a 2020 2020 3c74 6974 emove">. <tit │ │ │ +001de840: 6c65 3e45 7861 6d70 6c65 733c 2f74 6974 le>Examples</tit │ │ │ +001de850: 6c65 3e0a 2020 2020 3c65 7861 6d70 6c65 le>. <example │ │ │ +001de860: 2069 643d 2265 785f 6469 6374 5f72 656d id="ex_dict_rem │ │ │ +001de870: 6f76 6522 3e3c 7469 746c 653e 3c2f 7469 ove"><title></ti │ │ │ +001de880: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +001de890: 3e3c 2f70 6172 613e 0a20 2020 2020 203c ></para>. < │ │ │ +001de8a0: 7363 7265 656e 3e3c 215b 4344 4154 415b screen><![CDATA[ │ │ │ +001de8b0: 0a5d 5d3e 0a3c 2f73 6372 6565 6e3e 0a20 .]]>.</screen>. │ │ │ +001de8c0: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 </example>. │ │ │ +001de8d0: 3c2f 7265 6673 6563 7431 3e20 2d2d 3e0a </refsect1> -->. │ │ │ +001de8e0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +001de8f0: 7365 6561 6c73 6f5f 6469 6374 5f72 656d seealso_dict_rem │ │ │ +001de900: 6f76 6522 3e0a 2020 2020 3c74 6974 6c65 ove">. <title │ │ │ +001de910: 3e53 6565 2041 6c73 6f3c 2f74 6974 6c65 >See Also. dict_new(). │ │ │ +001de980: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 dict_zap() │ │ │ +001de9b0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    │ │ │ +001de9f0: 3c66 756e 6374 696f 6e3e 6469 6374 5f70 dict_p │ │ │ +001dea00: 7574 2829 3c2f 6675 6e63 7469 6f6e 3e3c ut()< │ │ │ +001dea10: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +001dea20: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 di │ │ │ +001dea50: 6374 5f67 6574 2829 3c2f 6675 6e63 7469 ct_get(). < │ │ │ +001deaa0: 6675 6e63 7469 6f6e 3e64 6963 745f 696e function>dict_in │ │ │ +001deab0: 635f 6f72 5f70 7574 2829 3c2f 6675 6e63 c_or_put(). di │ │ │ +001deb10: 6374 5f64 6563 5f6f 725f 7265 6d6f 7665 ct_dec_or_remove │ │ │ +001deb20: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ +001deb40: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b dic │ │ │ +001deb70: 745f 7369 7a65 2829 3c2f 6675 6e63 7469 t_size(). dict_dup │ │ │ +001debd0: 6c69 6361 7465 2829 3c2f 6675 6e63 7469 licate(). dict_to_ │ │ │ +001dec30: 7665 6374 6f72 2829 3c2f 6675 6e63 7469 vector(). dict_lis │ │ │ +001dec90: 745f 6b65 7973 2829 3c2f 6675 6e63 7469 t_keys(). dict_des │ │ │ +001ded00: 7472 7563 7469 7665 5f6c 6973 745f 726e tructive_list_rn │ │ │ +001ded10: 645f 6b65 7973 2829 3c2f 6675 6e63 7469 d_keys(). │ │ │ +001ded60: 3c66 756e 6374 696f 6e3e 6469 6374 5f69 dict_i │ │ │ +001ded70: 7465 725f 7265 7769 6e64 2829 3c2f 6675 ter_rewind(). │ │ │ +001deda0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 dict │ │ │ +001dedd0: 5f69 7465 725f 6e65 7874 2829 3c2f 6675 _iter_next(). .. │ │ │ +001dee10: b600 0000 2764 656d 6f2f 646f 6373 7263 ....'demo/docsrc │ │ │ +001dee20: 2f66 756e 6372 6566 2f68 7474 705f 6865 /funcref/http_he │ │ │ +001dee30: 6164 6572 5f67 6574 2e78 6d6c df00 0008 ader_get.xml.... │ │ │ +001dee40: e03c 3f78 6d6c 2076 6572 7369 6f6e 3d22 ... │ │ │ +001df1f0: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ +001df200: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ +001df210: 6874 7470 5f68 6561 6465 725f 6765 743c http_header_get< │ │ │ +001df220: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +001df230: 2020 2020 3c72 6566 6d69 7363 696e 666f ws. . │ │ │ +001df260: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001df270: 2020 3c72 6566 6e61 6d65 3e68 7474 705f http_ │ │ │ +001df280: 6865 6164 6572 5f67 6574 3c2f 7265 666e header_get. returns hea │ │ │ +001df2b0: 6465 7220 6f66 2063 7572 7265 6e74 2048 der of current H │ │ │ +001df2c0: 5454 5020 7265 7175 6573 743c 2f72 6566 TTP request. . . │ │ │ +001df300: 3c66 756e 6373 796e 6f70 7369 7320 6964 . < │ │ │ +001df330: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ +001df340: 3d22 6670 726f 746f 5f68 7474 705f 6865 ="fproto_http_he │ │ │ +001df350: 6164 6572 5f67 6574 223e 0a20 2020 2020 ader_get">. │ │ │ +001df360: 2020 203c 6675 6e63 6465 663e 7661 7263 varc │ │ │ +001df370: 6861 7220 3c66 756e 6374 696f 6e3e 6874 har ht │ │ │ +001df380: 7470 5f68 6561 6465 725f 6765 743c 2f66 tp_header_get. │ │ │ +001df3c0: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ +001df400: 2020 3c72 6566 7365 6374 3120 6964 3d22 Des │ │ │ +001df430: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +001df440: 0a20 2020 203c 7061 7261 3e0a 5265 7475 . .Retu │ │ │ +001df450: 726e 7320 7468 6520 7265 7370 6f6e 7365 rns the response │ │ │ +001df460: 2068 6561 6465 7220 6173 736f 6369 6174 header associat │ │ │ +001df470: 6564 2077 6974 6820 7468 6520 6375 7272 ed with the curr │ │ │ +001df480: 656e 7420 4854 5450 2072 6571 7565 7374 ent HTTP request │ │ │ +001df490: 2e20 2054 6869 7320 7769 6c6c 206e 6f74 . This will not │ │ │ +001df4a0: 2072 6574 7572 6e20 7468 6520 6465 6661 return the defa │ │ │ +001df4b0: 756c 7420 6865 6164 6572 206c 696e 6573 ult header lines │ │ │ +001df4c0: 2c20 6f6e 6c79 2074 686f 7365 2065 7870 , only those exp │ │ │ +001df4d0: 6c69 6369 746c 7920 7365 7420 7769 7468 licitly set with │ │ │ +001df4e0: 2068 7474 705f 6865 6164 6572 2e0a 3c2f http_header... │ │ │ +001df500: 0a54 6869 7320 6973 2075 7365 6675 6c20 .This is useful │ │ │ +001df510: 666f 7220 696e 6372 656d 656e 7461 6c6c for incrementall │ │ │ +001df520: 7920 6d6f 6469 6679 696e 6720 7265 7370 y modifying resp │ │ │ +001df530: 6f6e 7365 2068 6561 6465 7273 2064 7572 onse headers dur │ │ │ +001df540: 696e 6720 7072 6f63 6573 7369 6e67 0a6f ing processing.o │ │ │ +001df550: 6620 6120 5552 4c2e 0a3c 2f70 6172 613e f a URL.. │ │ │ +001df560: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +001df570: 203c 7265 6673 6563 7431 2069 643d 2272 Retur │ │ │ +001df5a0: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ +001df5b0: 2020 2020 3c70 6172 613e 5661 7263 6861 Varcha │ │ │ +001df5c0: 7220 6f66 2074 6865 2063 7572 7265 6e74 r of the current │ │ │ +001df5d0: 2068 6561 6465 7273 3c2f 7061 7261 3e0a headers. │ │ │ +001df5e0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +001df5f0: 3c72 6566 7365 6374 3120 6964 3d22 6578 E │ │ │ +001df620: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ +001df630: 2020 3c65 7861 6d70 6c65 2069 643d 2265 Retrie │ │ │ +001df660: 7669 6e67 2074 6865 2063 7572 7265 6e74 ving the current │ │ │ +001df670: 2068 6561 6465 723c 2f74 6974 6c65 3e0a header. │ │ │ +001df680: 2020 3c70 726f 6772 616d 6c69 7374 696e .<?vsp.http │ │ │ +001df6a0: 5f68 6561 6465 7220 2863 6f6e 6361 7420 _header (concat │ │ │ +001df6b0: 2868 7474 705f 6865 6164 6572 5f67 6574 (http_header_get │ │ │ +001df6c0: 2028 292c 2027 4c6f 6361 7469 6f6e 3a20 (), 'Location: │ │ │ +001df6d0: 6465 6661 756c 742e 6874 6d6c 2729 293b default.html')); │ │ │ +001df6e0: 0a3f 2667 743b 0a3c 2f70 726f 6772 616d .?>.. . .. │ │ │ +001df720: 0ab6 0000 001c 6465 6d6f 2f64 6f63 7372 ......demo/docsr │ │ │ +001df730: 632f 6675 6e63 7265 662f 6578 6563 2e78 c/funcref/exec.x │ │ │ +001df740: 6d6c df00 001b 7c3c 3f78 6d6c 2076 6572 ml....|... . exec< │ │ │ +001dfb10: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +001dfb20: 2020 2020 3c72 6566 6d69 7363 696e 666f sql. . │ │ │ +001dfb50: 2020 3c72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +001dfb60: 2020 203c 7265 666e 616d 653e 6578 6563 exec │ │ │ +001dfb70: 3c2f 7265 666e 616d 653e 0a20 2020 203c . < │ │ │ +001dfb80: 7265 6670 7572 706f 7365 3e64 796e 616d refpurpose>dynam │ │ │ +001dfb90: 6963 2065 7865 6375 7469 6f6e 206f 6620 ic execution of │ │ │ +001dfba0: 5351 4c20 7265 7475 726e 696e 6720 7374 SQL returning st │ │ │ +001dfbb0: 6174 6520 616e 6420 7265 7375 6c74 2073 ate and result s │ │ │ +001dfbc0: 6574 3c2f 7265 6670 7572 706f 7365 3e0a et. │ │ │ +001dfbd0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ +001dfbe0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ +001dfc40: 2020 2020 3c66 756e 6364 6566 3e3c 6675 exec │ │ │ +001dfc70: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in str │ │ │ +001dfca0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar..o │ │ │ +001dfcc0: 7574 203c 7061 7261 6d65 7465 723e 7374 ut st │ │ │ +001dfcd0: 6174 653c 2f70 6172 616d 6574 6572 3e20 ate │ │ │ +001dfce0: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar..ou │ │ │ +001dfd00: 7420 3c70 6172 616d 6574 6572 3e6d 6573 t mes │ │ │ +001dfd10: 7361 6765 3c2f 7061 7261 6d65 7465 723e sage │ │ │ +001dfd20: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar..i │ │ │ +001dfd40: 6e20 3c70 6172 616d 6574 6572 3e70 6172 n par │ │ │ +001dfd50: 616d 733c 2f70 6172 616d 6574 6572 3e20 ams │ │ │ +001dfd60: 616e 793c 2f70 6172 616d 6465 663e 0a09 any.. │ │ │ +001dfd70: 3c70 6172 616d 6465 663e 696e 203c 7061 in maxrows< │ │ │ +001dfd90: 2f70 6172 616d 6574 6572 3e20 696e 7465 /parameter> inte │ │ │ +001dfda0: 6765 723c 2f70 6172 616d 6465 663e 0a09 ger.. │ │ │ +001dfdb0: 3c70 6172 616d 6465 663e 6f75 7420 3c70 out

    metadat │ │ │ +001dfdd0: 613c 2f70 6172 616d 6574 6572 3e20 7665 a ve │ │ │ +001dfde0: 6374 6f72 3c2f 7061 7261 6d64 6566 3e0a ctor. │ │ │ +001dfdf0: 093c 7061 7261 6d64 6566 3e6f 7574 203c .out < │ │ │ +001dfe00: 7061 7261 6d65 7465 723e 726f 7773 3c2f parameter>rows vecto │ │ │ +001dfe20: 723c 2f70 6172 616d 6465 663e 0a20 093c r. .< │ │ │ +001dfe30: 7061 7261 6d64 6566 3e6f 7574 203c 7061 paramdef>out cursor_h │ │ │ +001dfe50: 616e 646c 653c 2f70 6172 616d 6574 6572 andle long. . . < │ │ │ +001dfea0: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ +001dfeb0: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ +001dfed0: 203c 7469 746c 653e 4465 7363 7269 7074 Descript │ │ │ +001dfee0: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ +001dfef0: 3c70 6172 613e 5468 6973 2066 756e 6374 This funct │ │ │ +001dff00: 696f 6e20 7072 6f76 6964 6573 2064 796e ion provides dyn │ │ │ +001dff10: 616d 6963 2053 514c 2063 6170 6162 696c amic SQL capabil │ │ │ +001dff20: 6974 6965 7320 696e 2056 6972 7475 6f73 ities in Virtuos │ │ │ +001dff30: 6f20 504c 2e0a 2020 2020 5468 6520 6669 o PL.. The fi │ │ │ +001dff40: 7273 7420 6172 6775 6d65 6e74 2069 7320 rst argument is │ │ │ +001dff50: 616e 2061 7262 6974 7261 7279 2053 514c an arbitrary SQL │ │ │ +001dff60: 2073 7461 7465 6d65 6e74 2c20 7768 6963 statement, whic │ │ │ +001dff70: 6820 6d61 7920 636f 6e74 6169 6e0a 2020 h may contain. │ │ │ +001dff80: 2020 7061 7261 6d65 7465 7220 706c 6163 parameter plac │ │ │ +001dff90: 6568 6f6c 6465 7273 2e20 5468 6520 6675 eholders. The fu │ │ │ +001dffa0: 6e63 7469 6f6e 2072 6574 7572 6e73 2061 nction returns a │ │ │ +001dffb0: 7320 6f75 7470 7574 2070 6172 616d 6574 s output paramet │ │ │ +001dffc0: 6572 7320 610a 2020 2020 5351 4c20 7374 ers a. SQL st │ │ │ +001dffd0: 6174 652c 2065 7272 6f72 206d 6573 7361 ate, error messa │ │ │ +001dffe0: 6765 2c20 636f 6c75 6d6e 206d 6574 6164 ge, column metad │ │ │ +001dfff0: 6174 6120 616e 6420 7265 7375 6c74 2073 ata and result s │ │ │ +001e0000: 6574 2072 6f77 7320 6966 0a20 2020 2074 et rows if. t │ │ │ +001e0010: 6865 2073 7461 7465 6d65 6e74 2069 7320 he statement is │ │ │ +001e0020: 6120 7365 6c65 6374 2e3c 2f70 6172 613e a select. │ │ │ +001e0030: 0a20 2020 203c 7061 7261 3e41 2073 746f . A sto │ │ │ +001e0040: 7265 6420 7072 6f63 6564 7572 6520 6361 red procedure ca │ │ │ +001e0050: 6e20 6265 2069 6e76 6f6b 6564 2062 7920 n be invoked by │ │ │ +001e0060: 6578 6563 2062 7574 2061 2070 726f 6365 exec but a proce │ │ │ +001e0070: 6475 7265 2773 0a20 2020 2072 6573 756c dure's. resul │ │ │ +001e0080: 7420 7365 7420 7769 6c6c 206e 6f74 2062 t set will not b │ │ │ +001e0090: 6520 7265 6365 6976 6564 2069 6e20 7468 e received in th │ │ │ +001e00a0: 6520 726f 7773 206f 7574 7075 7420 7061 e rows output pa │ │ │ +001e00b0: 7261 6d65 7465 7220 6275 7420 7261 7468 rameter but rath │ │ │ +001e00c0: 6572 0a20 2020 2073 656e 7420 746f 2074 er. sent to t │ │ │ +001e00d0: 6865 2063 6c69 656e 742e 3c2f 7061 7261 he client.. . │ │ │ +001e00f0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Parameters. <par │ │ │ +001e0140: 616d 6574 6572 3e73 7472 3c2f 7061 7261 ameter>str</para │ │ │ +001e0150: 6d65 7465 723e 3c2f 7469 746c 653e 0a20 meter>. │ │ │ +001e0160: 2020 2020 203c 7061 7261 3e41 203c 7479 A varchar containing arb │ │ │ +001e0190: 6974 7261 7279 2053 514c 2075 7369 6e67 itrary SQL using │ │ │ +001e01a0: 203f 2773 2066 6f72 2070 6172 616d 6574 ?'s for paramet │ │ │ +001e01b0: 6572 206d 6172 6b65 7273 2e3c 2f70 6172 er markers.. . state</t │ │ │ +001e01f0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +001e0200: 613e 416e 206f 7574 7075 7420 7061 7261 a>An output para │ │ │ +001e0210: 6d65 7465 7220 6f66 2074 7970 6520 3c74 meter of type <t │ │ │ +001e0220: 7970 653e 7661 7263 6861 723c 2f74 7970 ype>varchar</typ │ │ │ +001e0230: 653e 2073 6574 2074 6f20 7468 6520 3520 e> set to the 5 │ │ │ +001e0240: 6368 6172 6163 7465 7220 5351 4c20 7374 character SQL st │ │ │ +001e0250: 6174 6520 6966 2074 6865 2065 7865 6320 ate if the exec │ │ │ +001e0260: 7265 7375 6c74 6564 2061 6e20 6572 726f resulted an erro │ │ │ +001e0270: 722e 204e 6f74 2073 6574 2069 6620 616e r. Not set if an │ │ │ +001e0280: 2065 7272 6f72 2069 7320 6e6f 7420 7072 error is not pr │ │ │ +001e0290: 6573 656e 742e 3c2f 7061 7261 3e0a 2020 esent.</para>. │ │ │ +001e02a0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 </refsect2>. │ │ │ +001e02b0: 2020 3c72 6566 7365 6374 323e 3c74 6974 <refsect2><tit │ │ │ +001e02c0: 6c65 3e6d 6573 7361 6765 3c2f 7469 746c le>message</titl │ │ │ +001e02d0: 653e 0a20 2020 2020 203c 7061 7261 3e41 e>. <para>A │ │ │ +001e02e0: 6e20 6f75 7470 7574 2070 6172 616d 6574 n output paramet │ │ │ +001e02f0: 6572 206f 6620 7479 7065 203c 7479 7065 er of type <type │ │ │ +001e0300: 3e76 6172 6368 6172 3c2f 7479 7065 3e20 >varchar</type> │ │ │ +001e0310: 7365 7420 746f 2053 514c 2065 7272 6f72 set to SQL error │ │ │ +001e0320: 206d 6573 7361 6765 2061 7373 6f63 6961 message associa │ │ │ +001e0330: 7465 6420 7769 7468 2074 6865 2065 7272 ted with the err │ │ │ +001e0340: 6f72 2e20 4e6f 7420 7365 7420 6966 2061 or. Not set if a │ │ │ +001e0350: 6e20 6572 726f 7220 6973 206e 6f74 2070 n error is not p │ │ │ +001e0360: 7265 7365 6e74 2e3c 2f70 6172 613e 0a20 resent.</para>. │ │ │ +001e0370: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ +001e0380: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ +001e0390: 746c 653e 7061 7261 6d73 3c2f 7469 746c tle>params</titl │ │ │ +001e03a0: 653e 0a20 2020 2020 203c 7061 7261 3e41 e>. <para>A │ │ │ +001e03b0: 203c 7479 7065 3e76 6563 746f 723c 2f74 <type>vector</t │ │ │ +001e03c0: 7970 653e 2063 6f6e 7461 696e 696e 6720 ype> containing │ │ │ +001e03d0: 7468 6520 7061 7261 6d65 7465 7273 2066 the parameters f │ │ │ +001e03e0: 6f72 2074 6865 2053 514c 2062 6569 6e67 or the SQL being │ │ │ +001e03f0: 2065 7865 6375 7465 642e 2045 6c65 6d65 executed. Eleme │ │ │ +001e0400: 6e74 2030 2063 6f72 7265 7370 6f6e 6469 nt 0 correspondi │ │ │ +001e0410: 6e67 2074 6f20 6669 7273 7420 3f2c 2065 ng to first ?, e │ │ │ +001e0420: 7463 2e3c 2f70 6172 613e 0a20 2020 203c tc.</para>. < │ │ │ +001e0430: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ +001e0440: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2><title> │ │ │ +001e0450: 6d61 7872 6f77 733c 2f74 6974 6c65 3e0a maxrows. │ │ │ +001e0460: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ +001e0470: 3c74 7970 653e 696e 7465 6765 723c 2f74 integer maximum num │ │ │ +001e0490: 6265 7220 6f66 2072 6f77 7320 746f 2072 ber of rows to r │ │ │ +001e04a0: 6574 7269 6576 6520 696e 2063 6173 6520 etrieve in case │ │ │ +001e04b0: 6f66 2061 2073 7461 7465 6d65 6e74 2072 of a statement r │ │ │ +001e04c0: 6574 7572 6e69 6e67 2061 2072 6573 756c eturning a resul │ │ │ +001e04d0: 7420 7365 742e 3c2f 7061 7261 3e0a 2020 t set.. │ │ │ +001e04e0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +001e04f0: 2020 3c72 6566 7365 6374 323e 3c74 6974 metadata. │ │ │ +001e0520: 416e 206f 7574 7075 7420 7061 7261 6d65 An output parame │ │ │ +001e0530: 7465 7220 6f66 2074 7970 6520 3c74 7970 ter of type vector │ │ │ +001e0550: 7265 7475 726e 696e 6720 7468 6520 6d65 returning the me │ │ │ +001e0560: 7461 6461 7461 206f 6620 7468 6520 7374 tadata of the st │ │ │ +001e0570: 6174 656d 656e 7420 616e 6420 6974 7320 atement and its │ │ │ +001e0580: 7265 7375 6c74 2e3c 2f70 6172 613e 0a20 result.. │ │ │ +001e0590: 2020 2020 203c 7461 626c 653e 3c74 6974 The stmt_meta │ │ │ +001e05b0: 2061 7272 6179 3c2f 7469 746c 653e 0a20 array. │ │ │ +001e05c0: 2020 2020 2020 203c 7467 726f 7570 2063 .. E │ │ │ +001e05f0: 6c65 6d65 6e74 3c2f 656e 7472 793e 3c65 lementNameDescript │ │ │ +001e0620: 696f 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 ion.. .. . │ │ │ +001e0650: 0920 2020 2020 203c 656e 7472 793e 303c . 0< │ │ │ +001e0660: 2f65 6e74 7279 3e0a 0920 2020 2020 203c /entry>.. < │ │ │ +001e0670: 656e 7472 793e 434f 4c53 3c2f 656e 7472 entry>COLS.. An array contai │ │ │ +001e06a0: 6e69 6e67 2064 6573 6372 6970 7469 6f6e ning description │ │ │ +001e06b0: 206f 6620 6561 6368 2063 6f6c 756d 6e20 of each column │ │ │ +001e06c0: 696e 2074 6865 2072 6573 756c 740a 0920 in the result.. │ │ │ +001e06d0: 2020 2020 2073 6574 2028 7365 6520 7461 set (see ta │ │ │ +001e06e0: 626c 6520 6265 6c6f 7720 666f 7220 636f ble below for co │ │ │ +001e06f0: 6e74 656e 7473 293c 2f65 6e74 7279 3e0a ntents). │ │ │ +001e0700: 0920 2020 203c 2f72 6f77 3e0a 0920 2020 . .. │ │ │ +001e0710: 203c 726f 773e 0a09 2020 2020 2020 3c65 .. 1.. │ │ │ +001e0730: 2020 2020 2020 3c65 6e74 7279 3e53 544d STM │ │ │ +001e0740: 545f 5345 4c45 4354 3c2f 656e 7472 793e T_SELECT │ │ │ +001e0750: 0a09 2020 2020 2020 3c65 6e74 7279 3e41 .. A │ │ │ +001e0760: 6e20 3c74 7970 653e 696e 7465 6765 723c n integer< │ │ │ +001e0770: 2f74 7970 653e 2031 2069 6e64 6963 6174 /type> 1 indicat │ │ │ +001e0780: 6573 2074 6861 7420 7468 6520 7374 6174 es that the stat │ │ │ +001e0790: 656d 656e 7420 6973 2061 0a09 2020 2020 ement is a.. │ │ │ +001e07a0: 2020 7365 6c65 6374 2c20 6f74 6865 7277 select, otherw │ │ │ +001e07b0: 6973 6520 6974 2069 7320 6120 444d 4c20 ise it is a DML │ │ │ +001e07c0: 7374 6174 656d 656e 742e 3c2f 656e 7472 statement... .. │ │ │ +001e07e0: 2020 2020 3c72 6f77 3e0a 0920 2020 2020 .. │ │ │ +001e07f0: 203c 656e 7472 793e 322e 2e3c 2f65 6e74 2.... N/A.. │ │ │ +001e0820: 2020 2020 203c 656e 7472 793e 5472 6169 Trai │ │ │ +001e0830: 6c69 6e67 2065 6c65 6d65 6e74 7320 6d61 ling elements ma │ │ │ +001e0840: 7920 6170 7065 6172 2c20 6275 7420 7468 y appear, but th │ │ │ +001e0850: 6579 2073 686f 756c 6420 6e6f 7420 6265 ey should not be │ │ │ +001e0860: 2075 7365 643c 2f65 6e74 7279 3e0a 0920 used.. │ │ │ +001e0870: 2020 203c 2f72 6f77 3e0a 0920 203c 2f74 .. . . . Colum │ │ │ +001e08c0: 6e73 2061 7272 6179 206f 6620 6d65 7461 ns array of meta │ │ │ +001e08d0: 6461 7461 3c2f 7469 746c 653e 0a20 2020 data. │ │ │ +001e08e0: 2020 2020 203c 7467 726f 7570 2063 6f6c .. Ele │ │ │ +001e0910: 6d65 6e74 3c2f 656e 7472 793e 3c65 6e74 mentName< │ │ │ +001e0930: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ +001e0940: 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e3c n< │ │ │ +001e0950: 2f74 6865 6164 3e0a 0920 203c 7462 6f64 /thead>.. .. .. │ │ │ +001e0970: 2020 2020 203c 656e 7472 793e 303c 2f65 0name │ │ │ +001e0990: 3c2f 656e 7472 793e 3c65 6e74 7279 3e43 C │ │ │ +001e09a0: 6f6c 756d 6e20 6e61 6d65 3c2f 656e 7472 olumn name.. .. │ │ │ +001e09c0: 2020 2020 3c72 6f77 3e0a 0920 2020 2020 .. │ │ │ +001e09d0: 203c 656e 7472 793e 313c 2f65 6e74 7279 1.. │ │ │ +001e09f0: 7479 7065 3c2f 656e 7472 793e 0a09 2020 type.. │ │ │ +001e0a00: 2020 2020 3c65 6e74 7279 3e43 6f6c 756d Colum │ │ │ +001e0a10: 6e20 7479 7065 2061 7320 616e 2069 6e74 n type as an int │ │ │ +001e0a20: 6572 6e61 6c20 7479 7065 2063 6f64 6520 ernal type code │ │ │ +001e0a30: 636f 7272 6573 706f 6e64 696e 672c 0a09 corresponding,.. │ │ │ +001e0a40: 2020 2020 2020 6275 7420 6e6f 7420 6571 but not eq │ │ │ +001e0a50: 7561 6c20 746f 204f 4442 4320 5351 4c20 ual to ODBC SQL │ │ │ +001e0a60: 7479 7065 2063 6f64 6573 2e3c 2f65 6e74 type codes... . │ │ │ +001e0a80: 0920 2020 203c 726f 773e 0a09 2020 2020 . .. │ │ │ +001e0a90: 2020 3c65 6e74 7279 3e32 3c2f 656e 7472 2.. scale.. │ │ │ +001e0ac0: 2020 2020 2020 3c65 6e74 7279 3e63 6f6c col │ │ │ +001e0ad0: 756d 6e20 7363 616c 653c 2f65 6e74 7279 umn scale.. .. │ │ │ +001e0af0: 2020 203c 726f 773e 0a09 2020 2020 2020 .. │ │ │ +001e0b00: 3c65 6e74 7279 3e33 3c2f 656e 7472 793e 3 │ │ │ +001e0b10: 0a09 2020 2020 2020 3c65 6e74 7279 3e70 .. p │ │ │ +001e0b20: 7265 6369 7369 6f6e 3c2f 656e 7472 793e recision │ │ │ +001e0b30: 0a09 2020 2020 2020 3c65 6e74 7279 3e63 .. c │ │ │ +001e0b40: 6f6c 756d 6e20 7072 6563 6973 696f 6e3c olumn precision< │ │ │ +001e0b50: 2f65 6e74 7279 3e0a 0920 2020 203c 2f72 /entry>.. .. .. │ │ │ +001e0b70: 2020 2020 2020 3c65 6e74 7279 3e34 3c2f 4.. nullable.. indicates nu │ │ │ +001e0bc0: 6c6c 6162 6c65 2063 6f6c 756d 6e3c 2f65 llable column.. .. .. │ │ │ +001e0bf0: 2020 2020 3c65 6e74 7279 3e35 3c2f 656e 5.. updatable.. indicates upd │ │ │ +001e0c40: 6174 6162 6c65 2063 6f6c 756d 6e3c 2f65 atable column.. .. .. │ │ │ +001e0c70: 2020 2020 3c65 6e74 7279 3e36 3c2f 656e 6.. searchable.. indicates se │ │ │ +001e0cc0: 6172 6368 6162 6c65 2063 6f6c 756d 6e3c archable column< │ │ │ +001e0cd0: 2f65 6e74 7279 3e0a 0920 2020 203c 2f72 /entry>.. .. . │ │ │ +001e0cf0: 093c 2f74 6772 6f75 703e 0a20 2020 2020 .. │ │ │ +001e0d00: 203c 2f74 6162 6c65 3e0a 2020 2020 3c2f
    . . r │ │ │ +001e0d30: 6f77 733c 2f74 6974 6c65 3e0a 2020 2020 ows. │ │ │ +001e0d40: 2020 3c70 6172 613e 416e 206f 7574 7075 An outpu │ │ │ +001e0d50: 7420 6172 7261 7920 7769 7468 206f 6e65 t array with one │ │ │ +001e0d60: 2065 6c65 6d65 6e74 2070 6572 2072 6573 element per res │ │ │ +001e0d70: 756c 7420 726f 7720 636f 6e74 6169 6e69 ult row containi │ │ │ +001e0d80: 6e67 2061 6e20 6172 7261 7920 7769 7468 ng an array with │ │ │ +001e0d90: 2074 6865 206c 6566 746d 6f73 7420 636f the leftmost co │ │ │ +001e0da0: 6c75 6d6e 2061 7320 656c 656d 656e 7420 lumn as element │ │ │ +001e0db0: 3020 616e 6420 736f 2066 6f72 7468 2e3c 0 and so forth.< │ │ │ +001e0dc0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . curs │ │ │ +001e0df0: 6f72 5f68 616e 646c 653c 2f74 6974 6c65 or_handle. Th │ │ │ +001e0e10: 6520 6375 7273 6f72 2068 616e 646c 6520 e cursor handle │ │ │ +001e0e20: 666f 7220 7573 6520 7769 7468 2072 656c for use with rel │ │ │ +001e0e30: 6174 6564 2066 756e 6374 696f 6e73 2e3c ated functions.< │ │ │ +001e0e40: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . Examp │ │ │ +001e0e90: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ +001e0ea0: 3c65 7861 6d70 6c65 2069 643d 2265 785f Pro │ │ │ +001e0ec0: 6365 6475 7265 2045 7861 6d70 6c65 3c2f cedure Example</ │ │ │ +001e0ed0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ +001e0ee0: 7261 3e54 6869 7320 7374 6f72 6564 2070 ra>This stored p │ │ │ +001e0ef0: 726f 6365 6475 7265 2072 6574 7572 6e73 rocedure returns │ │ │ +001e0f00: 2031 2069 6620 6120 6769 7665 6e20 7461 1 if a given ta │ │ │ +001e0f10: 626c 6520 6973 2065 6d70 7479 2e20 416e ble is empty. An │ │ │ +001e0f20: 2065 7272 6f72 2073 7563 680a 2020 2020 error such. │ │ │ +001e0f30: 2020 6173 2061 2074 696d 656f 7574 206f as a timeout o │ │ │ +001e0f40: 7220 6465 6164 6c6f 636b 2077 6f75 6c64 r deadlock would │ │ │ +001e0f50: 2062 6520 7265 706f 7274 6564 2062 6163 be reported bac │ │ │ +001e0f60: 6b20 746f 2074 6865 2063 616c 6c65 7220 k to the caller │ │ │ +001e0f70: 6173 2061 6e20 6578 6365 7074 696f 6e2e as an exception. │ │ │ +001e0f80: 0a20 2020 2020 2045 7865 6320 616c 7761 . Exec alwa │ │ │ +001e0f90: 7973 2072 6574 7572 6e73 2c20 6e6f 206d ys returns, no m │ │ │ +001e0fa0: 6174 7465 7220 7468 6520 7479 7065 206f atter the type o │ │ │ +001e0fb0: 6620 6578 6365 7074 696f 6e2e 2054 6875 f exception. Thu │ │ │ +001e0fc0: 7320 6974 2069 7320 616c 736f 2075 7365 s it is also use │ │ │ +001e0fd0: 6675 6c0a 2020 2020 2020 6173 2061 2075 ful. as a u │ │ │ +001e0fe0: 6e69 7665 7273 616c 2065 7272 6f72 2063 niversal error c │ │ │ +001e0ff0: 6174 6368 6572 2e3c 2f70 6172 613e 0a20 atcher.</para>. │ │ │ +001e1000: 2020 2020 203c 7363 7265 656e 3e0a 6372 <screen>.cr │ │ │ +001e1010: 6561 7465 2070 726f 6365 6475 7265 2074 eate procedure t │ │ │ +001e1020: 625f 6973 5f65 6d70 7479 2028 696e 2074 b_is_empty (in t │ │ │ +001e1030: 6220 7661 7263 6861 7229 0a7b 0a20 2064 b varchar).{. d │ │ │ +001e1040: 6563 6c61 7265 2073 7461 7465 2c20 6d73 eclare state, ms │ │ │ +001e1050: 672c 2064 6573 6373 2c20 726f 7773 2061 g, descs, rows a │ │ │ +001e1060: 6e79 3b0a 2020 7374 6174 6520 3a3d 2027 ny;. state := ' │ │ │ +001e1070: 3030 3030 3027 3b0a 2020 6578 6563 2028 00000';. exec ( │ │ │ +001e1080: 7370 7269 6e74 6620 2827 7365 6c65 6374 sprintf ('select │ │ │ +001e1090: 2031 2066 726f 6d20 2573 272c 2074 6229 1 from %s', tb) │ │ │ +001e10a0: 2c20 7374 6174 652c 0a20 2020 206d 7367 , state,. msg │ │ │ +001e10b0: 2c20 7665 6374 6f72 2028 292c 2031 2c20 , vector (), 1, │ │ │ +001e10c0: 6465 7363 732c 2072 6f77 7329 3b0a 0a20 descs, rows);.. │ │ │ +001e10d0: 2069 6620 2873 7461 7465 2026 6c74 3b26 if (state <& │ │ │ +001e10e0: 6774 3b20 2730 3030 3030 2729 0a20 2020 gt; '00000'). │ │ │ +001e10f0: 2073 6967 6e61 6c20 2873 7461 7465 2c20 signal (state, │ │ │ +001e1100: 6d73 6729 3b0a 0a20 2069 6620 286c 656e msg);.. if (len │ │ │ +001e1110: 6774 6820 2872 6f77 7329 203d 2030 290a gth (rows) = 0). │ │ │ +001e1120: 2020 2020 7265 7475 726e 2031 3b0a 0a20 return 1;.. │ │ │ +001e1130: 2065 6c73 650a 2020 2020 7265 7475 726e else. return │ │ │ +001e1140: 2030 3b0a 7d0a 3c2f 7363 7265 656e 3e0a 0;.}.</screen>. │ │ │ +001e1150: 2020 2020 3c2f 6578 616d 706c 653e 0a20 </example>. │ │ │ +001e1160: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ +001e1170: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ +001e1180: 616c 736f 5f65 7865 6322 3e3c 7469 746c also_exec"><titl │ │ │ +001e1190: 653e 5365 6520 416c 736f 3c2f 7469 746c e>See Also</titl │ │ │ +001e11a0: 653e 0a20 2020 203c 7061 7261 3e3c 6c69 e>. <para><li │ │ │ +001e11b0: 6e6b 206c 696e 6b65 6e64 3d22 666e 5f72 nk linkend="fn_r │ │ │ +001e11c0: 6578 6563 7574 6522 3e3c 6675 6e63 7469 execute"><functi │ │ │ +001e11d0: 6f6e 3e72 6578 6563 7574 6528 293c 2f66 on>rexecute()</f │ │ │ +001e11e0: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001e11f0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ +001e1200: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +001e1210: 666e 5f65 7865 635f 6e65 7874 223e 3c66 fn_exec_next"><f │ │ │ +001e1220: 756e 6374 696f 6e3e 6578 6563 5f6e 6578 unction>exec_nex │ │ │ +001e1230: 7428 293c 2f66 756e 6374 696f 6e3e 3c2f t()</function></ │ │ │ +001e1240: 6c69 6e6b 3e3c 2f70 6172 613e 0a20 2020 link></para>. │ │ │ +001e1250: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e <para><link lin │ │ │ +001e1260: 6b65 6e64 3d22 666e 5f65 7865 635f 636c kend="fn_exec_cl │ │ │ +001e1270: 6f73 6522 3e3c 6675 6e63 7469 6f6e 3e65 ose"><function>e │ │ │ +001e1280: 7865 635f 636c 6f73 6528 293c 2f66 756e xec_close()</fun │ │ │ +001e1290: 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 ction></link></p │ │ │ +001e12a0: 6172 613e 0a20 2020 203c 2f72 6566 7365 ara>. </refse │ │ │ +001e12b0: 6374 313e 0a3c 2f72 6566 656e 7472 793e ct1>.</refentry> │ │ │ +001e12c0: 0a0a 0ab6 0000 0025 6465 6d6f 2f64 6f63 .......%demo/doc │ │ │ +001e12d0: 7372 632f 6675 6e63 7265 662f 7374 5f69 src/funcref/st_i │ │ │ +001e12e0: 6e74 6572 7365 6374 732e 786d 6cdf 0000 ntersects.xml... │ │ │ +001e12f0: 14df 3c3f 786d 6c20 7665 7273 696f 6e3d ..<?xml version= │ │ │ +001e1300: 2231 2e30 2220 656e 636f 6469 6e67 3d22 "1.0" encoding=" │ │ │ +001e1310: 4953 4f2d 3838 3539 2d31 223f 3e0a 3c21 ISO-8859-1"?>.<! │ │ │ +001e1320: 2d2d 0a20 2d0a 202d 2020 5468 6973 2066 --. -. - This f │ │ │ +001e1330: 696c 6520 6973 2070 6172 7420 6f66 2074 ile is part of t │ │ │ +001e1340: 6865 204f 7065 6e4c 696e 6b20 536f 6674 he OpenLink Soft │ │ │ +001e1350: 7761 7265 2056 6972 7475 6f73 6f20 4f70 ware Virtuoso Op │ │ │ +001e1360: 656e 2d53 6f75 7263 6520 2856 4f53 290a en-Source (VOS). │ │ │ +001e1370: 202d 2020 7072 6f6a 6563 742e 0a20 2d0a - project.. -. │ │ │ +001e1380: 202d 2020 436f 7079 7269 6768 7420 2843 - Copyright (C │ │ │ +001e1390: 2920 3139 3938 2d32 3032 3420 4f70 656e ) 1998-2024 Open │ │ │ +001e13a0: 4c69 6e6b 2053 6f66 7477 6172 650a 202d Link Software. - │ │ │ +001e13b0: 0a20 2d20 2054 6869 7320 7072 6f6a 6563 . - This projec │ │ │ +001e13c0: 7420 6973 2066 7265 6520 736f 6674 7761 t is free softwa │ │ │ +001e13d0: 7265 3b20 796f 7520 6361 6e20 7265 6469 re; you can redi │ │ │ +001e13e0: 7374 7269 6275 7465 2069 7420 616e 642f stribute it and/ │ │ │ +001e13f0: 6f72 206d 6f64 6966 7920 6974 0a20 2d20 or modify it. - │ │ │ +001e1400: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ +001e1410: 206f 6620 7468 6520 474e 5520 4765 6e65 of the GNU Gene │ │ │ +001e1420: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ +001e1430: 7365 2061 7320 7075 626c 6973 6865 6420 se as published │ │ │ +001e1440: 6279 2074 6865 0a20 2d20 2046 7265 6520 by the. - Free │ │ │ +001e1450: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ +001e1460: 696f 6e3b 206f 6e6c 7920 7665 7273 696f ion; only versio │ │ │ +001e1470: 6e20 3220 6f66 2074 6865 204c 6963 656e n 2 of the Licen │ │ │ +001e1480: 7365 2c20 6461 7465 6420 4a75 6e65 2031 se, dated June 1 │ │ │ +001e1490: 3939 312e 0a20 2d0a 202d 2020 5468 6973 991.. -. - This │ │ │ +001e14a0: 2070 726f 6772 616d 2069 7320 6469 7374 program is dist │ │ │ +001e14b0: 7269 6275 7465 6420 696e 2074 6865 2068 ributed in the h │ │ │ +001e14c0: 6f70 6520 7468 6174 2069 7420 7769 6c6c ope that it will │ │ │ +001e14d0: 2062 6520 7573 6566 756c 2c20 6275 740a be useful, but. │ │ │ +001e14e0: 202d 2020 5749 5448 4f55 5420 414e 5920 - WITHOUT ANY │ │ │ +001e14f0: 5741 5252 414e 5459 3b20 7769 7468 6f75 WARRANTY; withou │ │ │ +001e1500: 7420 6576 656e 2074 6865 2069 6d70 6c69 t even the impli │ │ │ +001e1510: 6564 2077 6172 7261 6e74 7920 6f66 0a20 ed warranty of. │ │ │ +001e1520: 2d20 204d 4552 4348 414e 5441 4249 4c49 - MERCHANTABILI │ │ │ +001e1530: 5459 206f 7220 4649 544e 4553 5320 464f TY or FITNESS FO │ │ │ +001e1540: 5220 4120 5041 5254 4943 554c 4152 2050 R A PARTICULAR P │ │ │ +001e1550: 5552 504f 5345 2e20 5365 6520 7468 6520 URPOSE. See the │ │ │ +001e1560: 474e 550a 202d 2020 4765 6e65 7261 6c20 GNU. - General │ │ │ +001e1570: 5075 626c 6963 204c 6963 656e 7365 2066 Public License f │ │ │ +001e1580: 6f72 206d 6f72 6520 6465 7461 696c 732e or more details. │ │ │ +001e1590: 0a20 2d0a 202d 2020 596f 7520 7368 6f75 . -. - You shou │ │ │ +001e15a0: 6c64 2068 6176 6520 7265 6365 6976 6564 ld have received │ │ │ +001e15b0: 2061 2063 6f70 7920 6f66 2074 6865 2047 a copy of the G │ │ │ +001e15c0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ +001e15d0: 6320 4c69 6365 6e73 6520 616c 6f6e 670a c License along. │ │ │ +001e15e0: 202d 2020 7769 7468 2074 6869 7320 7072 - with this pr │ │ │ +001e15f0: 6f67 7261 6d3b 2069 6620 6e6f 742c 2077 ogram; if not, w │ │ │ +001e1600: 7269 7465 2074 6f20 7468 6520 4672 6565 rite to the Free │ │ │ +001e1610: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ +001e1620: 7469 6f6e 2c20 496e 632e 2c0a 202d 2020 tion, Inc.,. - │ │ │ +001e1630: 3531 2046 7261 6e6b 6c69 6e20 5374 2c20 51 Franklin St, │ │ │ +001e1640: 4669 6674 6820 466c 6f6f 722c 2042 6f73 Fifth Floor, Bos │ │ │ +001e1650: 746f 6e2c 204d 4120 3032 3131 302d 3133 ton, MA 02110-13 │ │ │ +001e1660: 3031 2055 5341 0a20 2d0a 2d2d 3e0a 3c72 01 USA. -.-->.<r │ │ │ +001e1670: 6566 656e 7472 7920 6964 3d22 666e 5f73 efentry id="fn_s │ │ │ +001e1680: 745f 696e 7465 7273 6563 7473 223e 0a20 t_intersects">. │ │ │ +001e1690: 203c 7265 666d 6574 613e 0a20 2020 203c <refmeta>. < │ │ │ +001e16a0: 7265 6665 6e74 7279 7469 746c 653e 7374 refentrytitle>st │ │ │ +001e16b0: 5f69 6e74 6572 7365 6374 733c 2f72 6566 _intersects</ref │ │ │ +001e16c0: 656e 7472 7974 6974 6c65 3e0a 2020 2020 entrytitle>. │ │ │ +001e16d0: 3c72 6566 6d69 7363 696e 666f 3e67 656f <refmiscinfo>geo │ │ │ +001e16e0: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 </refmiscinfo>. │ │ │ +001e16f0: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72 </refmeta>. <r │ │ │ +001e1700: 6566 6e61 6d65 6469 763e 0a20 2020 203c efnamediv>. < │ │ │ +001e1710: 7265 666e 616d 653e 7374 5f69 6e74 6572 refname>st_inter │ │ │ +001e1720: 7365 6374 733c 2f72 6566 6e61 6d65 3e0a sects</refname>. │ │ │ +001e1730: 2020 2020 3c72 6566 7075 7270 6f73 653e <refpurpose> │ │ │ +001e1740: 5265 7475 726e 7320 696e 7465 7273 6563 Returns intersec │ │ │ +001e1750: 7473 2062 6574 7765 656e 2074 776f 2067 ts between two g │ │ │ +001e1760: 656f 6d65 7472 6965 732e 3c2f 7265 6670 eometries.</refp │ │ │ +001e1770: 7572 706f 7365 3e0a 2020 3c2f 7265 666e urpose>. </refn │ │ │ +001e1780: 616d 6564 6976 3e0a 2020 3c72 6566 7379 amediv>. <refsy │ │ │ +001e1790: 6e6f 7073 6973 6469 763e 0a20 2020 203c nopsisdiv>. < │ │ │ +001e17a0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +001e17b0: 2266 7379 6e5f 7374 5f69 6e74 6572 7365 "fsyn_st_interse │ │ │ +001e17c0: 6374 7322 3e0a 2020 2020 2020 3c66 756e cts">. <fun │ │ │ +001e17d0: 6370 726f 746f 7479 7065 2069 643d 2266 cprototype id="f │ │ │ +001e17e0: 7072 6f74 6f5f 7374 5f69 6e74 6572 7365 proto_st_interse │ │ │ +001e17f0: 6374 7322 3e0a 2020 2020 2020 2020 3c66 cts">. <f │ │ │ +001e1800: 756e 6364 6566 3e3c 6675 6e63 7469 6f6e uncdef><function │ │ │ +001e1810: 3e73 745f 696e 7465 7273 6563 7473 3c2f >st_intersects</ │ │ │ +001e1820: 6675 6e63 7469 6f6e 3e3c 2f66 756e 6364 function></funcd │ │ │ +001e1830: 6566 3e0a 093c 7061 7261 6d64 6566 3e69 ef>..<paramdef>i │ │ │ +001e1840: 6e20 3c70 6172 616d 6574 6572 3e67 313c n <parameter>g1< │ │ │ +001e1850: 2f70 6172 616d 6574 6572 3e20 616e 793c /parameter> any< │ │ │ +001e1860: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..<par │ │ │ +001e1870: 616d 6465 663e 696e 203c 7061 7261 6d65 amdef>in <parame │ │ │ +001e1880: 7465 723e 6732 3c2f 7061 7261 6d65 7465 ter>g2</paramete │ │ │ +001e1890: 723e 2061 6e79 3c2f 7061 7261 6d64 6566 r> any</paramdef │ │ │ +001e18a0: 3e0a 093c 7061 7261 6d64 6566 3e69 6e20 >..<paramdef>in │ │ │ +001e18b0: 3c70 6172 616d 6574 6572 3e70 7265 633c <parameter>prec< │ │ │ +001e18c0: 2f70 6172 616d 6574 6572 3e20 646f 7562 /parameter> doub │ │ │ +001e18d0: 6c65 2070 7265 6369 7369 6f6e 3c2f 7061 le precision</pa │ │ │ +001e18e0: 7261 6d64 6566 3e0a 2020 2020 2020 3c2f ramdef>. </ │ │ │ +001e18f0: 6675 6e63 7072 6f74 6f74 7970 653e 0a20 funcprototype>. │ │ │ +001e1900: 2020 203c 2f66 756e 6373 796e 6f70 7369 </funcsynopsi │ │ │ +001e1910: 733e 0a20 203c 2f72 6566 7379 6e6f 7073 s>. </refsynops │ │ │ +001e1920: 6973 6469 763e 0a20 203c 7265 6673 6563 isdiv>. <refsec │ │ │ +001e1930: 7431 2069 643d 2264 6573 635f 7374 5f69 t1 id="desc_st_i │ │ │ +001e1940: 6e74 6572 7365 6374 7322 3e0a 2020 2020 ntersects">. │ │ │ +001e1950: 3c74 6974 6c65 3e44 6573 6372 6970 7469 <title>Descripti │ │ │ +001e1960: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001e1970: 7061 7261 3e52 6574 7572 6e73 2069 6e74 para>Returns int │ │ │ +001e1980: 6572 7365 6374 7320 6265 7477 6565 6e20 ersects between │ │ │ +001e1990: 7477 6f20 6765 6f6d 6574 7269 6573 2e20 two geometries. │ │ │ +001e19a0: 4966 2070 7265 6320 6973 2073 7570 706c If prec is suppl │ │ │ +001e19b0: 6965 642c 2074 6869 7320 6973 2061 0a74 ied, this is a.t │ │ │ +001e19c0: 6f6c 6572 616e 6365 2066 6f72 2074 6865 olerance for the │ │ │ +001e19d0: 206d 6174 6368 696e 6720 696e 2075 6e69 matching in uni │ │ │ +001e19e0: 7473 206f 6620 6c69 6e65 6172 2064 6973 ts of linear dis │ │ │ +001e19f0: 7461 6e63 6520 6170 7072 6f70 7269 6174 tance appropriat │ │ │ +001e1a00: 6520 746f 2074 6865 2073 7269 642e 2042 e to the srid. B │ │ │ +001e1a10: 6f74 6820 6765 6f6d 6574 7269 6573 0a73 oth geometries.s │ │ │ +001e1a20: 686f 756c 6420 6861 7665 2074 6865 2073 hould have the s │ │ │ +001e1a30: 616d 6520 7372 6964 2e20 7374 5f69 6e74 ame srid. st_int │ │ │ +001e1a40: 6572 7365 6374 7320 6973 2074 7275 6520 ersects is true │ │ │ +001e1a50: 6966 2074 6865 7265 2069 7320 6174 206c if there is at l │ │ │ +001e1a60: 6561 7374 206f 6e65 2070 6f69 6e74 2069 east one point i │ │ │ +001e1a70: 6e20 636f 6d6d 6f6e 2e0a 3c2f 7061 7261 n common...
    . │ │ │ +001e1a90: 2020 3c72 6566 7365 6374 3120 6964 3d22 . Parameters. g1</ti │ │ │ +001e1af0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +001e1b00: 3e54 6865 2066 6972 7374 2067 656f 6d65 >The first geome │ │ │ +001e1b10: 7472 792e 3c2f 7061 7261 3e0a 2020 2020 try.</para>. │ │ │ +001e1b20: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 </refsect2>. │ │ │ +001e1b30: 3c72 6566 7365 6374 323e 3c74 6974 6c65 <refsect2><title │ │ │ +001e1b40: 3e67 323c 2f74 6974 6c65 3e0a 2020 2020 >g2. │ │ │ +001e1b50: 2020 3c70 6172 613e 5468 6520 7365 636f The seco │ │ │ +001e1b60: 6e64 2067 656f 6d65 7472 792e 3c2f 7061 nd geometry.
    . . prec</t │ │ │ +001e1ba0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +001e1bb0: 613e 4120 746f 6c65 7261 6e63 6520 666f a>A tolerance fo │ │ │ +001e1bc0: 7220 7468 6520 6d61 7463 6869 6e67 2069 r the matching i │ │ │ +001e1bd0: 6e20 756e 6974 7320 6f66 206c 696e 6561 n units of linea │ │ │ +001e1be0: 7220 6469 7374 616e 6365 2061 7070 726f r distance appro │ │ │ +001e1bf0: 7072 6961 7465 2074 6f20 7468 6520 7372 priate to the sr │ │ │ +001e1c00: 6964 2e0a 4465 6661 756c 7420 6973 2030 id..Default is 0 │ │ │ +001e1c10: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .</para>. </r │ │ │ +001e1c20: 6566 7365 6374 323e 0a20 203c 2f72 6566 efsect2>. </ref │ │ │ +001e1c30: 7365 6374 313e 0a20 203c 7265 6673 6563 sect1>. <refsec │ │ │ +001e1c40: 7431 2069 643d 2272 6574 5f73 745f 696e t1 id="ret_st_in │ │ │ +001e1c50: 7465 7273 6563 7473 223e 3c74 6974 6c65 tersects"><title │ │ │ +001e1c60: 3e52 6574 7572 6e20 5479 7065 733c 2f74 >Return Types</t │ │ │ +001e1c70: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +001e1c80: 5265 7475 726e 7320 696e 742e 3c2f 7061 Returns int.</pa │ │ │ +001e1c90: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ +001e1ca0: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ +001e1cb0: 3d22 6578 616d 706c 6573 5f73 745f 696e ="examples_st_in │ │ │ +001e1cc0: 7465 7273 6563 7473 223e 0a20 2020 203c tersects">. < │ │ │ +001e1cd0: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples</ │ │ │ +001e1ce0: 7469 746c 653e 0a20 2020 203c 6578 616d title>. <exam │ │ │ +001e1cf0: 706c 6520 6964 3d22 6578 5f73 745f 696e ple id="ex_st_in │ │ │ +001e1d00: 7465 7273 6563 7473 223e 3c74 6974 6c65 tersects"><title │ │ │ +001e1d10: 3e53 696d 706c 6520 5573 653c 2f74 6974 >Simple Use</tit │ │ │ +001e1d20: 6c65 3e0a 3c70 726f 6772 616d 6c69 7374 le>.<programlist │ │ │ +001e1d30: 696e 673e 3c21 5b43 4441 5441 5b0a 5351 ing><![CDATA[.SQ │ │ │ +001e1d40: 4c3e 5345 4c45 4354 2073 745f 696e 7465 L>SELECT st_inte │ │ │ +001e1d50: 7273 6563 7473 2028 7374 5f70 6f69 6e74 rsects (st_point │ │ │ +001e1d60: 2028 302c 2035 3129 2c20 7374 5f70 6f69 (0, 51), st_poi │ │ │ +001e1d70: 6e74 2028 302c 2035 3229 2c20 3130 3029 nt (0, 52), 100) │ │ │ +001e1d80: 3b0a 6361 6c6c 7265 740a 494e 5445 4745 ;.callret.INTEGE │ │ │ +001e1d90: 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f R.______________ │ │ │ +001e1da0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e1db0: 5f0a 2030 0a4e 6f2e 206f 6620 726f 7773 _. 0.No. of rows │ │ │ +001e1dc0: 2069 6e20 7265 7375 6c74 3a20 310a 0a0a in result: 1... │ │ │ +001e1dd0: 5351 4c3e 5350 4152 514c 0a53 454c 4543 SQL>SPARQL.SELEC │ │ │ +001e1de0: 5420 3f63 2028 6269 663a 7374 5f69 6e74 T ?c (bif:st_int │ │ │ +001e1df0: 6572 7365 6374 7320 283f 6765 6f2c 2062 ersects (?geo, b │ │ │ +001e1e00: 6966 3a73 745f 706f 696e 7420 2830 2c20 if:st_point (0, │ │ │ +001e1e10: 3532 292c 2031 3030 2929 0a57 4845 5245 52), 100)).WHERE │ │ │ +001e1e20: 0a20 2020 7b0a 2020 2020 203f 6d20 6765 . {. ?m ge │ │ │ +001e1e30: 6f3a 6765 6f6d 6574 7279 203f 6765 6f20 o:geometry ?geo │ │ │ +001e1e40: 2e0a 2020 2020 203f 6d20 6120 3f63 202e .. ?m a ?c . │ │ │ +001e1e50: 0a0a 2020 207d 0a47 524f 5550 2042 5920 .. }.GROUP BY │ │ │ +001e1e60: 3f63 203f 6765 6f0a 4f52 4445 5220 4259 ?c ?geo.ORDER BY │ │ │ +001e1e70: 2064 6573 6320 320a 4c49 4d49 5420 3130 desc 2.LIMIT 10 │ │ │ +001e1e80: 3b0a 6320 2020 2020 2020 2020 2020 2020 ;.c │ │ │ +001e1e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e1ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e1eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e1ec0: 2020 2063 616c 6c72 6574 2d31 0a41 4e59 callret-1.ANY │ │ │ +001e1ed0: 2009 2020 2020 2020 2020 2020 2020 2020 . │ │ │ +001e1ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e1ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e1f00: 2020 2020 2020 2020 2020 2041 4e59 0a5f ANY._ │ │ │ +001e1f10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e1f20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e1f30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e1f40: 5f0a 6874 7470 3a2f 2f78 6d6c 6e73 2e63 _.http://xmlns.c │ │ │ +001e1f50: 6f6d 2f66 6f61 662f 302e 312f 5065 7273 om/foaf/0.1/Pers │ │ │ +001e1f60: 6f6e 0920 2020 2020 2020 2020 2020 2020 on. │ │ │ +001e1f70: 2020 2020 2020 2020 2020 2020 310a 6874 1.ht │ │ │ +001e1f80: 7470 3a2f 2f72 6466 2e61 6c63 6865 6d79 tp://rdf.alchemy │ │ │ +001e1f90: 6170 692e 636f 6d2f 7264 662f 7631 2f73 api.com/rdf/v1/s │ │ │ +001e1fa0: 2f61 6170 692d 7363 6865 6d61 2344 6973 /aapi-schema#Dis │ │ │ +001e1fb0: 616d 6269 6775 6174 696f 6e09 2031 0a68 ambiguation. 1.h │ │ │ +001e1fc0: 7474 703a 2f2f 7264 662e 616c 6368 656d ttp://rdf.alchem │ │ │ +001e1fd0: 7961 7069 2e63 6f6d 2f72 6466 2f76 312f yapi.com/rdf/v1/ │ │ │ +001e1fe0: 732f 6161 7069 2d73 6368 656d 6123 4469 s/aapi-schema#Di │ │ │ +001e1ff0: 7361 6d62 6967 7561 7469 6f6e 0920 310a sambiguation. 1. │ │ │ +001e2000: 6874 7470 3a2f 2f77 7777 2e77 332e 6f72 http://www.w3.or │ │ │ +001e2010: 672f 3230 3033 2f31 322f 6578 6966 2f6e g/2003/12/exif/n │ │ │ +001e2020: 732f 4946 4409 2020 2020 2020 2020 2020 s/IFD. │ │ │ +001e2030: 2020 2020 2020 2020 2020 2020 2020 2031 1 │ │ │ +001e2040: 0a68 7474 703a 2f2f 7777 772e 7733 2e6f .http://www.w3.o │ │ │ +001e2050: 7267 2f32 3030 332f 3132 2f65 7869 662f rg/2003/12/exif/ │ │ │ +001e2060: 6e73 2f49 4644 0920 2020 2020 2020 2020 ns/IFD. │ │ │ +001e2070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e2080: 310a 6874 7470 3a2f 2f77 7777 2e77 332e 1.http://www.w3. │ │ │ +001e2090: 6f72 672f 3230 3033 2f31 322f 6578 6966 org/2003/12/exif │ │ │ +001e20a0: 2f6e 732f 4946 4409 2020 2020 2020 2020 /ns/IFD. │ │ │ +001e20b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e20c0: 2031 0a68 7474 703a 2f2f 7777 772e 7733 1.http://www.w3 │ │ │ +001e20d0: 2e6f 7267 2f32 3030 332f 3132 2f65 7869 .org/2003/12/exi │ │ │ +001e20e0: 662f 6e73 2f49 4644 0920 2020 2020 2020 f/ns/IFD. │ │ │ +001e20f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e2100: 2020 310a 6874 7470 3a2f 2f77 7777 2e77 1.http://www.w │ │ │ +001e2110: 332e 6f72 672f 3230 3033 2f31 322f 6578 3.org/2003/12/ex │ │ │ +001e2120: 6966 2f6e 732f 4946 4409 2020 2020 2020 if/ns/IFD. │ │ │ +001e2130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e2140: 2020 2031 0a68 7474 703a 2f2f 6462 7065 1.http://dbpe │ │ │ +001e2150: 6469 612e 6f72 672f 636c 6173 732f 7961 dia.org/class/ya │ │ │ +001e2160: 676f 2f48 6f73 7443 6974 6965 734f 6654 go/HostCitiesOfT │ │ │ +001e2170: 6865 436f 6d6d 6f6e 7765 616c 7468 4761 heCommonwealthGa │ │ │ +001e2180: 6d65 7309 2031 0a68 7474 703a 2f2f 7777 mes. 1.http://ww │ │ │ +001e2190: 772e 7733 2e6f 7267 2f32 3030 332f 3132 w.w3.org/2003/12 │ │ │ +001e21a0: 2f65 7869 662f 6e73 2f49 4644 0920 2020 /exif/ns/IFD. │ │ │ +001e21b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e21c0: 2020 2020 2020 310a 4e6f 2e20 6f66 2072 1.No. of r │ │ │ +001e21d0: 6f77 7320 696e 2072 6573 756c 743a 2031 ows in result: 1 │ │ │ +001e21e0: 300a 5d5d 3e3c 2f70 726f 6772 616d 6c69 0.]]></programli │ │ │ +001e21f0: 7374 696e 673e 0a20 2020 203c 2f65 7861 sting>. </exa │ │ │ +001e2200: 6d70 6c65 3e0a 2020 3c2f 7265 6673 6563 mple>. </refsec │ │ │ +001e2210: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +001e2220: 6964 3d22 7365 6561 6c73 6f5f 7374 5f69 id="seealso_st_i │ │ │ +001e2230: 6e74 6572 7365 6374 7322 3e0a 2020 2020 ntersects">. │ │ │ +001e2240: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c <title>See Also< │ │ │ +001e2250: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ +001e2260: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +001e2270: 2273 716c 7265 6667 656f 7370 6174 6961 "sqlrefgeospatia │ │ │ +001e2280: 6c71 6772 223e 5175 6572 7969 6e67 2047 lqgr">Querying G │ │ │ +001e2290: 656f 6d65 7472 6963 2052 656c 6174 696f eometric Relatio │ │ │ +001e22a0: 6e73 3c2f 6c69 6e6b 3e3c 2f70 6172 613e ns</link></para> │ │ │ +001e22b0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . <para><link │ │ │ +001e22c0: 206c 696e 6b65 6e64 3d22 666e 5f73 745f linkend="fn_st_ │ │ │ +001e22d0: 706f 696e 7422 3e3c 6675 6e63 7469 6f6e point"><function │ │ │ +001e22e0: 3e73 745f 706f 696e 743c 2f66 756e 6374 >st_point</funct │ │ │ +001e22f0: 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 ion></link></par │ │ │ +001e2300: 613e 0a20 2020 203c 7061 7261 3e3c 6c69 a>. <para><li │ │ │ +001e2310: 6e6b 206c 696e 6b65 6e64 3d22 666e 5f73 nk linkend="fn_s │ │ │ +001e2320: 745f 7822 3e3c 6675 6e63 7469 6f6e 3e73 t_x"><function>s │ │ │ +001e2330: 745f 783c 2f66 756e 6374 696f 6e3e 3c2f t_x</function></ │ │ │ +001e2340: 6c69 6e6b 3e3c 2f70 6172 613e 0a20 2020 link></para>. │ │ │ +001e2350: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e <para><link lin │ │ │ +001e2360: 6b65 6e64 3d22 666e 5f73 745f 7922 3e3c kend="fn_st_y">< │ │ │ +001e2370: 6675 6e63 7469 6f6e 3e73 745f 793c 2f66 function>st_y</f │ │ │ +001e2380: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001e2390: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ +001e23a0: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +001e23b0: 666e 5f73 745f 6469 7374 616e 6365 223e fn_st_distance"> │ │ │ +001e23c0: 3c66 756e 6374 696f 6e3e 7374 5f64 6973 <function>st_dis │ │ │ +001e23d0: 7461 6e63 653c 2f66 756e 6374 696f 6e3e tance</function> │ │ │ +001e23e0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ +001e23f0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ +001e2400: 696e 6b65 6e64 3d22 666e 5f53 545f 5352 inkend="fn_ST_SR │ │ │ +001e2410: 4944 223e 3c66 756e 6374 696f 6e3e 7374 ID"><function>st │ │ │ +001e2420: 5f73 7269 643c 2f66 756e 6374 696f 6e3e _srid</function> │ │ │ +001e2430: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ +001e2440: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ +001e2450: 696e 6b65 6e64 3d22 666e 5f53 545f 5365 inkend="fn_ST_Se │ │ │ +001e2460: 7453 5249 4422 3e3c 6675 6e63 7469 6f6e tSRID"><function │ │ │ +001e2470: 3e73 745f 7365 7473 7269 643c 2f66 756e >st_setsrid</fun │ │ │ +001e2480: 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 ction></link></p │ │ │ +001e2490: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ +001e24a0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001e24b0: 5f73 745f 6173 7465 7874 223e 3c66 756e _st_astext"><fun │ │ │ +001e24c0: 6374 696f 6e3e 7374 5f61 7374 6578 743c ction>st_astext< │ │ │ +001e24d0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +001e24e0: 3e3c 2f70 6172 613e 0a20 2020 203c 7061 ></para>. <pa │ │ │ +001e24f0: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001e2500: 3d22 666e 5f73 745f 6765 6f6d 6672 6f6d ="fn_st_geomfrom │ │ │ +001e2510: 7465 7874 223e 3c66 756e 6374 696f 6e3e text"><function> │ │ │ +001e2520: 7374 5f67 656f 6d66 726f 6d74 6578 743c st_geomfromtext< │ │ │ +001e2530: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +001e2540: 3e3c 2f70 6172 613e 0a20 2020 203c 7061 ></para>. <pa │ │ │ +001e2550: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001e2560: 3d22 666e 5f73 745f 636f 6e74 6169 6e73 ="fn_st_contains │ │ │ +001e2570: 223e 3c66 756e 6374 696f 6e3e 7374 5f63 "><function>st_c │ │ │ +001e2580: 6f6e 7461 696e 733c 2f66 756e 6374 696f ontains</functio │ │ │ +001e2590: 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 613e n></link></para> │ │ │ +001e25a0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . <para><link │ │ │ +001e25b0: 206c 696e 6b65 6e64 3d22 666e 5f73 745f linkend="fn_st_ │ │ │ +001e25c0: 7769 7468 696e 223e 3c66 756e 6374 696f within"><functio │ │ │ +001e25d0: 6e3e 7374 5f77 6974 6869 6e3c 2f66 756e n>st_within</fun │ │ │ +001e25e0: 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 ction></link></p │ │ │ +001e25f0: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ +001e2600: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001e2610: 5f69 7367 656f 6d65 7472 7922 3e3c 6675 _isgeometry"><fu │ │ │ +001e2620: 6e63 7469 6f6e 3e69 7367 656f 6d65 7472 nction>isgeometr │ │ │ +001e2630: 793c 2f66 756e 6374 696f 6e3e 3c2f 6c69 y</function></li │ │ │ +001e2640: 6e6b 3e3c 2f70 6172 613e 0a20 2020 203c nk></para>. < │ │ │ +001e2650: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para><link linke │ │ │ +001e2660: 6e64 3d22 666e 5f67 656f 5f69 6e73 6572 nd="fn_geo_inser │ │ │ +001e2670: 7422 3e3c 6675 6e63 7469 6f6e 3e67 656f t"><function>geo │ │ │ +001e2680: 5f69 6e73 6572 743c 2f66 756e 6374 696f _insert</functio │ │ │ +001e2690: 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 613e n></link></para> │ │ │ +001e26a0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . <para><link │ │ │ +001e26b0: 206c 696e 6b65 6e64 3d22 666e 5f67 656f linkend="fn_geo │ │ │ +001e26c0: 5f64 656c 6574 6522 3e3c 6675 6e63 7469 _delete"><functi │ │ │ +001e26d0: 6f6e 3e67 656f 5f64 656c 6574 653c 2f66 on>geo_delete</f │ │ │ +001e26e0: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001e26f0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ +001e2700: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +001e2710: 666e 5f72 6466 5f67 656f 5f61 6464 223e fn_rdf_geo_add"> │ │ │ +001e2720: 3c66 756e 6374 696f 6e3e 4442 2e44 4241 <function>DB.DBA │ │ │ +001e2730: 2e52 4446 5f47 454f 5f41 4444 3c2f 6675 .RDF_GEO_ADD</fu │ │ │ +001e2740: 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f nction></link></ │ │ │ +001e2750: 7061 7261 3e0a 2020 2020 3c70 6172 613e para>. <para> │ │ │ +001e2760: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ +001e2770: 6e5f 7264 665f 6765 6f5f 6669 6c6c 223e n_rdf_geo_fill"> │ │ │ +001e2780: 3c66 756e 6374 696f 6e3e 4442 2e44 4241 <function>DB.DBA │ │ │ +001e2790: 2e52 4446 5f47 454f 5f46 494c 4c3c 2f66 .RDF_GEO_FILL</f │ │ │ +001e27a0: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001e27b0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. </refse │ │ │ +001e27c0: 6374 313e 0a3c 2f72 6566 656e 7472 793e ct1>.</refentry> │ │ │ +001e27d0: 0ab6 0000 0029 6465 6d6f 2f64 6f63 7372 .....)demo/docsr │ │ │ +001e27e0: 632f 6675 6e63 7265 662f 7865 6e63 5f64 c/funcref/xenc_d │ │ │ +001e27f0: 6563 7279 7074 5f73 6f61 702e 786d 6cdf ecrypt_soap.xml. │ │ │ +001e2800: 0000 12a9 3c3f 786d 6c20 7665 7273 696f ....<?xml versio │ │ │ +001e2810: 6e3d 2231 2e30 2220 656e 636f 6469 6e67 n="1.0" encoding │ │ │ +001e2820: 3d22 4953 4f2d 3838 3539 2d31 223f 3e0a ="ISO-8859-1"?>. │ │ │ +001e2830: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 <!--. - . - Th │ │ │ +001e2840: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ +001e2850: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ +001e2860: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ +001e2870: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ +001e2880: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ +001e2890: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ +001e28a0: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ +001e28b0: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ +001e28c0: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ +001e28d0: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ +001e28e0: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ +001e28f0: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ +001e2900: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ +001e2910: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ +001e2920: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ +001e2930: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +001e2940: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ +001e2950: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ +001e2960: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ +001e2970: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ +001e2980: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ +001e2990: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ +001e29a0: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ +001e29b0: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ +001e29c0: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ +001e29d0: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ +001e29e0: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ +001e29f0: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ +001e2a00: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ +001e2a10: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ +001e2a20: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ +001e2a30: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ +001e2a40: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ +001e2a50: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ +001e2a60: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ +001e2a70: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ +001e2a80: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ +001e2a90: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ +001e2aa0: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ +001e2ab0: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ +001e2ac0: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ +001e2ad0: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ +001e2ae0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ +001e2af0: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ +001e2b00: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ +001e2b10: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ +001e2b20: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ +001e2b30: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ +001e2b40: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ +001e2b50: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ +001e2b60: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ +001e2b70: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ +001e2b80: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ +001e2b90: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .<refentry id="f │ │ │ +001e2ba0: 6e5f 7865 6e63 5f64 6563 7279 7074 5f73 n_xenc_decrypt_s │ │ │ +001e2bb0: 6f61 7022 3e0a 2020 3c72 6566 6d65 7461 oap">. <refmeta │ │ │ +001e2bc0: 3e0a 2020 2020 3c72 6566 656e 7472 7974 >. <refentryt │ │ │ +001e2bd0: 6974 6c65 3e78 656e 635f 6465 6372 7970 itle>xenc_decryp │ │ │ +001e2be0: 745f 736f 6170 3c2f 7265 6665 6e74 7279 t_soap</refentry │ │ │ +001e2bf0: 7469 746c 653e 0a20 2020 203c 7265 666d title>. <refm │ │ │ +001e2c00: 6973 6369 6e66 6f3e 6861 7368 3c2f 7265 iscinfo>hash</re │ │ │ +001e2c10: 666d 6973 6369 6e66 6f3e 0a20 203c 2f72 fmiscinfo>. </r │ │ │ +001e2c20: 6566 6d65 7461 3e0a 2020 3c72 6566 6e61 efmeta>. <refna │ │ │ +001e2c30: 6d65 6469 763e 0a20 2020 203c 7265 666e mediv>. <refn │ │ │ +001e2c40: 616d 653e 7865 6e63 5f64 6563 7279 7074 ame>xenc_decrypt │ │ │ +001e2c50: 5f73 6f61 703c 2f72 6566 6e61 6d65 3e0a _soap</refname>. │ │ │ +001e2c60: 2020 2020 3c72 6566 7075 7270 6f73 653e <refpurpose> │ │ │ +001e2c70: 4465 6372 7970 7420 616e 6420 7665 7269 Decrypt and veri │ │ │ +001e2c80: 6679 2061 2053 4f41 5020 6d65 7373 6167 fy a SOAP messag │ │ │ +001e2c90: 653c 2f72 6566 7075 7270 6f73 653e 0a20 e</refpurpose>. │ │ │ +001e2ca0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 </refnamediv>. │ │ │ +001e2cb0: 203c 7265 6673 796e 6f70 7369 7364 6976 <refsynopsisdiv │ │ │ +001e2cc0: 3e0a 2020 2020 3c66 756e 6373 796e 6f70 >. <funcsynop │ │ │ +001e2cd0: 7369 7320 6964 3d22 6673 796e 5f78 656e sis id="fsyn_xen │ │ │ +001e2ce0: 635f 6465 6372 7970 745f 736f 6170 223e c_decrypt_soap"> │ │ │ +001e2cf0: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . <funcprot │ │ │ +001e2d00: 6f74 7970 6520 6964 3d22 6670 726f 746f otype id="fproto │ │ │ +001e2d10: 5f78 656e 635f 6465 6372 7970 745f 736f _xenc_decrypt_so │ │ │ +001e2d20: 6170 223e 0a20 2020 2020 2020 203c 6675 ap">. <fu │ │ │ +001e2d30: 6e63 6465 663e 7661 7263 6861 7220 3c66 ncdef>varchar <f │ │ │ +001e2d40: 756e 6374 696f 6e3e 7865 6e63 5f64 6563 unction>xenc_dec │ │ │ +001e2d50: 7279 7074 5f73 6f61 703c 2f66 756e 6374 rypt_soap</funct │ │ │ +001e2d60: 696f 6e3e 3c2f 6675 6e63 6465 663e 0a09 ion></funcdef>.. │ │ │ +001e2d70: 3c70 6172 616d 6465 663e 696e 203c 7061 <paramdef>in <pa │ │ │ +001e2d80: 7261 6d65 7465 723e 786d 6c5f 7465 7874 rameter>xml_text │ │ │ +001e2d90: 3c2f 7061 7261 6d65 7465 723e 2076 6172 </parameter> var │ │ │ +001e2da0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char</paramdef>. │ │ │ +001e2db0: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .<paramdef>in <p │ │ │ +001e2dc0: 6172 616d 6574 6572 3e73 6f61 705f 7665 arameter>soap_ve │ │ │ +001e2dd0: 7273 696f 6e3c 2f70 6172 616d 6574 6572 rsion</parameter │ │ │ +001e2de0: 3e20 696e 743c 2f70 6172 616d 6465 663e > int</paramdef> │ │ │ +001e2df0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..<paramdef>in < │ │ │ +001e2e00: 7061 7261 6d65 7465 723e 7661 6c69 6461 parameter>valida │ │ │ +001e2e10: 7465 5f66 6c61 673c 2f70 6172 616d 6574 te_flag</paramet │ │ │ +001e2e20: 6572 3e20 696e 743c 2f70 6172 616d 6465 er> int</paramde │ │ │ +001e2e30: 663e 0a09 3c70 6172 616d 6465 663e 696e f>..<paramdef>in │ │ │ +001e2e40: 203c 7061 7261 6d65 7465 723e 656e 636f <parameter>enco │ │ │ +001e2e50: 6469 6e67 3c2f 7061 7261 6d65 7465 723e ding</parameter> │ │ │ +001e2e60: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar</paramd │ │ │ +001e2e70: 6566 3e0a 093c 7061 7261 6d64 6566 3e69 ef>..<paramdef>i │ │ │ +001e2e80: 6e20 3c70 6172 616d 6574 6572 3e6c 616e n <parameter>lan │ │ │ +001e2e90: 673c 2f70 6172 616d 6574 6572 3e20 7661 g</parameter> va │ │ │ +001e2ea0: 7263 6861 723c 2f70 6172 616d 6465 663e rchar</paramdef> │ │ │ +001e2eb0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..<paramdef>in < │ │ │ +001e2ec0: 7061 7261 6d65 7465 723e 6f70 7473 3c2f parameter>opts</ │ │ │ +001e2ed0: 7061 7261 6d65 7465 723e 2061 6e79 3c2f parameter> any</ │ │ │ +001e2ee0: 7061 7261 6d64 6566 3e0a 093c 7061 7261 paramdef>..<para │ │ │ +001e2ef0: 6d64 6566 3e6f 7574 203c 7061 7261 6d65 mdef>out <parame │ │ │ +001e2f00: 7465 723e 6b65 7973 3c2f 7061 7261 6d65 ter>keys</parame │ │ │ +001e2f10: 7465 723e 2061 6e79 3c2f 7061 7261 6d64 ter> any</paramd │ │ │ +001e2f20: 6566 3e0a 2020 2020 2020 3c2f 6675 6e63 ef>. </func │ │ │ +001e2f30: 7072 6f74 6f74 7970 653e 0a20 2020 203c prototype>. < │ │ │ +001e2f40: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ +001e2f50: 203c 2f72 6566 7379 6e6f 7073 6973 6469 </refsynopsisdi │ │ │ +001e2f60: 763e 0a20 203c 7265 6673 6563 7431 2069 v>. <refsect1 i │ │ │ +001e2f70: 643d 2264 6573 635f 7865 6e63 5f64 6563 d="desc_xenc_dec │ │ │ +001e2f80: 7279 7074 5f73 6f61 7022 3e0a 2020 2020 rypt_soap">. │ │ │ +001e2f90: 3c74 6974 6c65 3e44 6573 6372 6970 7469 <title>Descripti │ │ │ +001e2fa0: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001e2fb0: 7061 7261 3e0a 0954 6865 2066 756e 6374 para>..The funct │ │ │ +001e2fc0: 696f 6e20 6973 2075 7365 6420 746f 2064 ion is used to d │ │ │ +001e2fd0: 6563 7279 7074 2061 6e64 206f 7074 696f ecrypt and optio │ │ │ +001e2fe0: 6e61 6c6c 7920 7665 7269 6679 2073 6967 nally verify sig │ │ │ +001e2ff0: 6e61 7475 7265 0a09 2864 6570 656e 6473 nature..(depends │ │ │ +001e3000: 206f 6620 6120 3c70 6172 616d 6574 6572 of a validate_flag param │ │ │ +001e3030: 6574 6572 2920 6f66 2061 2053 4f41 5020 eter) of a SOAP │ │ │ +001e3040: 6d65 7373 6167 652e 0a20 2020 203c 2f70 message..

    . . . │ │ │ +001e3090: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ +001e30a0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +001e30b0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 xml_text. A │ │ │ +001e30e0: 7374 7269 6e67 2063 6f6e 7461 696e 696e string containin │ │ │ +001e30f0: 6720 534f 4150 206d 6573 7361 6765 3c2f g SOAP message. . soap_ │ │ │ +001e3130: 7665 7273 696f 6e3c 2f74 6974 6c65 3e0a version. │ │ │ +001e3140: 093c 7061 7261 3e41 6e20 696e 7465 6765 .An intege │ │ │ +001e3150: 7220 696e 6469 6361 7469 6f6e 2053 4f41 r indication SOA │ │ │ +001e3160: 5020 7665 7273 696f 6e20 2831 3120 666f P version (11 fo │ │ │ +001e3170: 7220 7631 2e31 2c20 3130 2066 6f72 2031 r v1.1, 10 for 1 │ │ │ +001e3180: 2e30 2065 7463 293c 2f70 6172 613e 0a20 .0 etc). │ │ │ +001e3190: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +001e31a0: 2020 203c 7265 6673 6563 7432 3e3c 7469 validate_fla │ │ │ +001e31c0: 673c 2f74 6974 6c65 3e0a 093c 7061 7261 g..Bit mask flag. │ │ │ +001e31e0: 5365 6520 6265 6c6f 7720 666f 7220 6465 See below for de │ │ │ +001e31f0: 7461 696c 732e 3c2f 7061 7261 3e0a 093c tails...< │ │ │ +001e3200: 7369 6d70 6c65 6c69 7374 3e0a 0920 2020 simplelist>.. │ │ │ +001e3210: 203c 6d65 6d62 6572 3e62 6974 2030 2061 bit 0 a │ │ │ +001e3220: 6e64 2031 203a 2030 3020 2d20 646f 206e nd 1 : 00 - do n │ │ │ +001e3230: 6f74 2076 616c 6964 6174 652c 2030 3120 ot validate, 01 │ │ │ +001e3240: 2864 6563 696d 616c 2031 2920 2d20 7661 (decimal 1) - va │ │ │ +001e3250: 6c69 6461 7465 2c20 3130 2028 6465 6369 lidate, 10 (deci │ │ │ +001e3260: 6d61 6c20 3229 202d 2076 616c 6964 6174 mal 2) - validat │ │ │ +001e3270: 6520 6966 2073 6967 6e61 7475 7265 2065 e if signature e │ │ │ +001e3280: 7869 7374 733c 2f6d 656d 6265 723e 0a09 xists.. │ │ │ +001e3290: 2020 2020 3c6d 656d 6265 723e 6269 7420 bit │ │ │ +001e32a0: 3220 3a20 3130 3020 2864 6563 696d 616c 2 : 100 (decimal │ │ │ +001e32b0: 2034 2920 2d20 7472 7920 746f 2064 6563 4) - try to dec │ │ │ +001e32c0: 6f64 652c 2064 6f20 6e6f 7420 7369 676e ode, do not sign │ │ │ +001e32d0: 616c 2065 7272 6f72 2069 6620 5753 2d53 al error if WS-S │ │ │ +001e32e0: 6563 7572 6974 7920 6973 206e 6f74 2073 ecurity is not s │ │ │ +001e32f0: 7570 706c 6965 643c 2f6d 656d 6265 723e upplied │ │ │ +001e3300: 0a09 3c2f 7369 6d70 6c65 6c69 7374 3e0a ... │ │ │ +001e3310: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ +001e3320: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +001e3330: 7469 746c 653e 656e 636f 6469 6e67 3c2f title>encoding..Th │ │ │ +001e3350: 6520 6d65 7373 6167 6520 283c 7061 7261 e message (xml_text) char │ │ │ +001e3380: 6163 7465 7220 656e 636f 6469 6e67 3c2f acter encoding. . lang< │ │ │ +001e33c0: 2f74 6974 6c65 3e0a 093c 7061 7261 3e54 /title>..<para>T │ │ │ +001e33d0: 6865 206d 6573 7361 6765 2028 3c70 6172 he message (<par │ │ │ +001e33e0: 616d 6574 6572 3e78 6d6c 5f74 6578 743c ameter>xml_text< │ │ │ +001e33f0: 2f70 6172 616d 6574 6572 3e29 206c 616e /parameter>) lan │ │ │ +001e3400: 6775 6167 653c 2f70 6172 613e 0a20 2020 guage</para>. │ │ │ +001e3410: 203c 2f72 6566 7365 6374 323e 0a20 2020 </refsect2>. │ │ │ +001e3420: 203c 7265 6673 6563 7432 3e3c 7469 746c <refsect2><titl │ │ │ +001e3430: 653e 6f70 7473 3c2f 7469 746c 653e 0a09 e>opts.. │ │ │ +001e3440: 3c70 6172 613e 4120 7665 6374 6f72 2063 A vector c │ │ │ +001e3450: 6f6e 7461 696e 696e 6720 6f70 7469 6f6e ontaining option │ │ │ +001e3460: 7320 666f 7220 5573 6572 204e 616d 6520 s for User Name │ │ │ +001e3470: 746f 6b65 6e20 7072 6f66 696c 652e 0a09 token profile... │ │ │ +001e3480: 2020 2020 466f 7220 6578 616d 706c 6520 For example │ │ │ +001e3490: 3a20 7665 6374 6f72 2028 2755 7365 726e : vector ('Usern │ │ │ +001e34a0: 616d 6554 6f6b 656e 272c 2076 6563 746f ameToken', vecto │ │ │ +001e34b0: 7220 2827 6c61 6265 6c27 2c20 276c 6162 r ('label', 'lab │ │ │ +001e34c0: 3127 2c20 276b 6579 416c 676f 7269 7468 1', 'keyAlgorith │ │ │ +001e34d0: 6d27 202c 2027 5b33 6465 7320 616c 676f m' , '[3des algo │ │ │ +001e34e0: 2075 7269 5d27 2929 0a09 3c2f 7061 7261 uri]'))... . │ │ │ +001e3510: 3c74 6974 6c65 3e6b 6579 733c 2f74 6974 keys</tit │ │ │ +001e3520: 6c65 3e0a 093c 7061 7261 3e69 6620 7375 le>..<para>if su │ │ │ +001e3530: 7070 6c69 6564 2074 6865 2070 6172 616d pplied the param │ │ │ +001e3540: 6574 6572 2077 696c 6c20 6265 2073 6574 eter will be set │ │ │ +001e3550: 2077 6974 6820 6b65 7973 206e 616d 6573 with keys names │ │ │ +001e3560: 2075 7365 6420 666f 7220 6465 6372 7970 used for decryp │ │ │ +001e3570: 7469 6f6e 2061 6e64 2073 6967 6e61 7475 tion and signatu │ │ │ +001e3580: 7265 2076 6572 6966 6963 6174 696f 6e2e re verification. │ │ │ +001e3590: 0a09 2020 2020 5468 6520 7374 7275 6374 .. The struct │ │ │ +001e35a0: 7572 6520 6973 2061 7320 666f 6c6c 6f77 ure is as follow │ │ │ +001e35b0: 7320 3a20 7665 6374 6f72 2028 7665 6374 s : vector (vect │ │ │ +001e35c0: 6f72 2028 5b65 6e63 2d6b 6579 315d 2c5b or ([enc-key1],[ │ │ │ +001e35d0: 656e 632d 6b65 7932 5d2c 2e2e 2e29 2c20 enc-key2],...), │ │ │ +001e35e0: 7665 6374 6f72 2028 275b 7369 676e 696e vector ('[signin │ │ │ +001e35f0: 6720 746f 6b65 6e20 6e61 6d65 5d27 2c20 g token name]', │ │ │ +001e3600: 275b 6d61 7463 6869 6e67 2074 6f6b 656e '[matching token │ │ │ +001e3610: 5d27 2929 2e20 5768 6572 6520 656e 632d ]')). Where enc- │ │ │ +001e3620: 6b65 7920 6973 2061 206b 6579 2075 7365 key is a key use │ │ │ +001e3630: 6420 746f 2064 6563 7279 7074 2074 6865 d to decrypt the │ │ │ +001e3640: 206d 6573 7361 6765 2066 7261 676d 656e message fragmen │ │ │ +001e3650: 743b 2027 5b73 6967 6e69 6e67 2074 6f6b t; '[signing tok │ │ │ +001e3660: 656e 206e 616d 655d 2720 6973 2074 6865 en name]' is the │ │ │ +001e3670: 2074 656d 706f 7261 7279 206b 6579 2075 temporary key u │ │ │ +001e3680: 7365 6420 746f 2076 616c 6964 6174 6520 sed to validate │ │ │ +001e3690: 7468 6520 7369 676e 6174 7572 6520 616e the signature an │ │ │ +001e36a0: 6420 275b 6d61 7463 6869 6e67 2074 6f6b d '[matching tok │ │ │ +001e36b0: 656e 5d27 2069 7320 7468 6520 746f 6b65 en]' is the toke │ │ │ +001e36c0: 6e20 286b 6579 2920 6672 6f6d 2075 7365 n (key) from use │ │ │ +001e36d0: 7227 7320 7370 6163 6520 7468 6174 206d r's space that m │ │ │ +001e36e0: 6174 6368 6573 2074 6865 2073 6967 6e69 atches the signi │ │ │ +001e36f0: 6e67 2074 6f6b 656e 2e0a 093c 2f70 6172 ng token...</par │ │ │ +001e3700: 613e 0a20 2020 203c 2f72 6566 7365 6374 a>. </refsect │ │ │ +001e3710: 323e 0a20 203c 2f72 6566 7365 6374 313e 2>. </refsect1> │ │ │ +001e3720: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +001e3730: 2272 6574 5f78 656e 635f 6465 6372 7970 "ret_xenc_decryp │ │ │ +001e3740: 745f 736f 6170 223e 3c74 6974 6c65 3e52 t_soap"><title>R │ │ │ +001e3750: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ +001e3760: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +001e3770: 4f6e 2073 7563 6365 7373 2074 6865 2066 On success the f │ │ │ +001e3780: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ +001e3790: 6465 6372 7970 7465 6420 534f 4150 206d decrypted SOAP m │ │ │ +001e37a0: 6573 7361 6765 2e3c 2f70 6172 613e 0a20 essage.</para>. │ │ │ +001e37b0: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ +001e37c0: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ +001e37d0: 6d70 6c65 735f 7865 6e63 5f64 6563 7279 mples_xenc_decry │ │ │ +001e37e0: 7074 5f73 6f61 7022 3e0a 2020 2020 3c74 pt_soap">. <t │ │ │ +001e37f0: 6974 6c65 3e45 7861 6d70 6c65 733c 2f74 itle>Examples</t │ │ │ +001e3800: 6974 6c65 3e0a 2020 2020 3c65 7861 6d70 itle>. <examp │ │ │ +001e3810: 6c65 2069 643d 2265 785f 7865 6e63 5f64 le id="ex_xenc_d │ │ │ +001e3820: 6563 7279 7074 5f73 6f61 7022 3e3c 7469 ecrypt_soap"><ti │ │ │ +001e3830: 746c 653e 4465 6372 7970 7469 6e67 2053 tle>Decrypting S │ │ │ +001e3840: 4f41 5020 6d65 7373 6167 653c 2f74 6974 OAP message</tit │ │ │ +001e3850: 6c65 3e0a 2020 2020 2020 3c73 6372 6565 le>. <scree │ │ │ +001e3860: 6e3e 3c21 5b43 4441 5441 5b0a 0920 2064 n><![CDATA[.. d │ │ │ +001e3870: 6563 6c61 7265 2065 6b65 7973 2c20 6f70 eclare ekeys, op │ │ │ +001e3880: 7473 2c20 6465 636f 6465 6420 616e 793b ts, decoded any; │ │ │ +001e3890: 0a6f 7074 7320 3a3d 2076 6563 746f 7220 .opts := vector │ │ │ +001e38a0: 2827 5573 6572 6e61 6d65 546f 6b65 6e27 ('UsernameToken' │ │ │ +001e38b0: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ +001e38c0: 2020 7665 6374 6f72 2028 276c 6162 656c vector ('label │ │ │ +001e38d0: 272c 0a20 2020 2020 2020 2020 2020 2020 ',. │ │ │ +001e38e0: 2020 2020 2020 2020 2020 2027 4170 706c 'Appl │ │ │ +001e38f0: 6963 6174 696f 6e2d 4c61 6265 6c27 2c0a ication-Label',. │ │ │ +001e3900: 0920 2020 2020 2020 2020 2020 2020 2020 . │ │ │ +001e3910: 2020 2020 2020 2027 6b65 7941 6c67 6f72 'keyAlgor │ │ │ +001e3920: 6974 686d 272c 0a09 2020 2020 2020 2020 ithm',.. │ │ │ +001e3930: 2020 2020 2020 2020 2020 2020 2020 2768 'h │ │ │ +001e3940: 7474 703a 2f2f 7777 772e 7733 2e6f 7267 ttp://www.w3.org │ │ │ +001e3950: 2f32 3030 312f 3034 2f78 6d6c 656e 6323 /2001/04/xmlenc# │ │ │ +001e3960: 7472 6970 6c65 6465 732d 6362 6327 2929 tripledes-cbc')) │ │ │ +001e3970: 3b0a 0920 2064 6563 6f64 6564 203a 3d20 ;.. decoded := │ │ │ +001e3980: 7865 6e63 5f64 6563 7279 7074 5f73 6f61 xenc_decrypt_soa │ │ │ +001e3990: 7020 2862 6f64 795f 7374 722c 2031 312c p (body_str, 11, │ │ │ +001e39a0: 2036 2c20 2755 5446 2d38 272c 2027 782d 6, 'UTF-8', 'x- │ │ │ +001e39b0: 616e 7927 2c20 6f70 7473 2c20 656b 6579 any', opts, ekey │ │ │ +001e39c0: 7329 3b0a 5d5d 3e0a 3c2f 7363 7265 656e s);.]]>.</screen │ │ │ +001e39d0: 3e0a 2020 2020 3c2f 6578 616d 706c 653e >. </example> │ │ │ +001e39e0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ +001e39f0: 203c 7265 6673 6563 7431 2069 643d 2273 <refsect1 id="s │ │ │ +001e3a00: 6565 616c 736f 5f78 656e 635f 6465 6372 eealso_xenc_decr │ │ │ +001e3a10: 7970 745f 736f 6170 223e 0a20 2020 203c ypt_soap">. < │ │ │ +001e3a20: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also</ │ │ │ +001e3a30: 7469 746c 653e 0a20 2020 203c 7061 7261 title>. <para │ │ │ +001e3a40: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +001e3a50: 666e 5f78 656e 635f 656e 6372 7970 7422 fn_xenc_encrypt" │ │ │ +001e3a60: 3e3c 6675 6e63 7469 6f6e 3e78 656e 635f ><function>xenc_ │ │ │ +001e3a70: 656e 6372 7970 7428 293c 2f66 756e 6374 encrypt()</funct │ │ │ +001e3a80: 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 ion></link></par │ │ │ +001e3a90: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +001e3aa0: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 .</refentry>.... │ │ │ +001e3ab0: 0031 6465 6d6f 2f64 6f63 7372 632f 6675 .1demo/docsrc/fu │ │ │ +001e3ac0: 6e63 7265 662f 7374 7269 6e67 5f6f 7574 ncref/string_out │ │ │ +001e3ad0: 7075 745f 677a 5f63 6f6d 7072 6573 732e put_gz_compress. │ │ │ +001e3ae0: 786d 6cdf 0000 116d 3c3f 786d 6c20 7665 xml....m<?xml ve │ │ │ +001e3af0: 7273 696f 6e3d 2231 2e30 2220 656e 636f rsion="1.0" enco │ │ │ +001e3b00: 6469 6e67 3d22 4953 4f2d 3838 3539 2d31 ding="ISO-8859-1 │ │ │ +001e3b10: 223f 3e0a 3c21 2d2d 0a20 2d20 200a 202d "?>.<!--. - . - │ │ │ +001e3b20: 2020 5468 6973 2066 696c 6520 6973 2070 This file is p │ │ │ +001e3b30: 6172 7420 6f66 2074 6865 204f 7065 6e4c art of the OpenL │ │ │ +001e3b40: 696e 6b20 536f 6674 7761 7265 2056 6972 ink Software Vir │ │ │ +001e3b50: 7475 6f73 6f20 4f70 656e 2d53 6f75 7263 tuoso Open-Sourc │ │ │ +001e3b60: 6520 2856 4f53 290a 202d 2020 7072 6f6a e (VOS). - proj │ │ │ +001e3b70: 6563 742e 0a20 2d20 200a 202d 2020 436f ect.. - . - Co │ │ │ +001e3b80: 7079 7269 6768 7420 2843 2920 3139 3938 pyright (C) 1998 │ │ │ +001e3b90: 2d32 3032 3420 4f70 656e 4c69 6e6b 2053 -2024 OpenLink S │ │ │ +001e3ba0: 6f66 7477 6172 650a 202d 2020 0a20 2d20 oftware. - . - │ │ │ +001e3bb0: 2054 6869 7320 7072 6f6a 6563 7420 6973 This project is │ │ │ +001e3bc0: 2066 7265 6520 736f 6674 7761 7265 3b20 free software; │ │ │ +001e3bd0: 796f 7520 6361 6e20 7265 6469 7374 7269 you can redistri │ │ │ +001e3be0: 6275 7465 2069 7420 616e 642f 6f72 206d bute it and/or m │ │ │ +001e3bf0: 6f64 6966 7920 6974 0a20 2d20 2075 6e64 odify it. - und │ │ │ +001e3c00: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ +001e3c10: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ +001e3c20: 5075 626c 6963 204c 6963 656e 7365 2061 Public License a │ │ │ +001e3c30: 7320 7075 626c 6973 6865 6420 6279 2074 s published by t │ │ │ +001e3c40: 6865 0a20 2d20 2046 7265 6520 536f 6674 he. - Free Soft │ │ │ +001e3c50: 7761 7265 2046 6f75 6e64 6174 696f 6e3b ware Foundation; │ │ │ +001e3c60: 206f 6e6c 7920 7665 7273 696f 6e20 3220 only version 2 │ │ │ +001e3c70: 6f66 2074 6865 204c 6963 656e 7365 2c20 of the License, │ │ │ +001e3c80: 6461 7465 6420 4a75 6e65 2031 3939 312e dated June 1991. │ │ │ +001e3c90: 0a20 2d20 200a 202d 2020 5468 6973 2070 . - . - This p │ │ │ +001e3ca0: 726f 6772 616d 2069 7320 6469 7374 7269 rogram is distri │ │ │ +001e3cb0: 6275 7465 6420 696e 2074 6865 2068 6f70 buted in the hop │ │ │ +001e3cc0: 6520 7468 6174 2069 7420 7769 6c6c 2062 e that it will b │ │ │ +001e3cd0: 6520 7573 6566 756c 2c20 6275 740a 202d e useful, but. - │ │ │ +001e3ce0: 2020 5749 5448 4f55 5420 414e 5920 5741 WITHOUT ANY WA │ │ │ +001e3cf0: 5252 414e 5459 3b20 7769 7468 6f75 7420 RRANTY; without │ │ │ +001e3d00: 6576 656e 2074 6865 2069 6d70 6c69 6564 even the implied │ │ │ +001e3d10: 2077 6172 7261 6e74 7920 6f66 0a20 2d20 warranty of. - │ │ │ +001e3d20: 204d 4552 4348 414e 5441 4249 4c49 5459 MERCHANTABILITY │ │ │ +001e3d30: 206f 7220 4649 544e 4553 5320 464f 5220 or FITNESS FOR │ │ │ +001e3d40: 4120 5041 5254 4943 554c 4152 2050 5552 A PARTICULAR PUR │ │ │ +001e3d50: 504f 5345 2e20 5365 6520 7468 6520 474e POSE. See the GN │ │ │ +001e3d60: 550a 202d 2020 4765 6e65 7261 6c20 5075 U. - General Pu │ │ │ +001e3d70: 626c 6963 204c 6963 656e 7365 2066 6f72 blic License for │ │ │ +001e3d80: 206d 6f72 6520 6465 7461 696c 732e 0a20 more details.. │ │ │ +001e3d90: 2d20 200a 202d 2020 596f 7520 7368 6f75 - . - You shou │ │ │ +001e3da0: 6c64 2068 6176 6520 7265 6365 6976 6564 ld have received │ │ │ +001e3db0: 2061 2063 6f70 7920 6f66 2074 6865 2047 a copy of the G │ │ │ +001e3dc0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ +001e3dd0: 6320 4c69 6365 6e73 6520 616c 6f6e 670a c License along. │ │ │ +001e3de0: 202d 2020 7769 7468 2074 6869 7320 7072 - with this pr │ │ │ +001e3df0: 6f67 7261 6d3b 2069 6620 6e6f 742c 2077 ogram; if not, w │ │ │ +001e3e00: 7269 7465 2074 6f20 7468 6520 4672 6565 rite to the Free │ │ │ +001e3e10: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ +001e3e20: 7469 6f6e 2c20 496e 632e 2c0a 202d 2020 tion, Inc.,. - │ │ │ +001e3e30: 3531 2046 7261 6e6b 6c69 6e20 5374 2c20 51 Franklin St, │ │ │ +001e3e40: 4669 6674 6820 466c 6f6f 722c 2042 6f73 Fifth Floor, Bos │ │ │ +001e3e50: 746f 6e2c 204d 4120 3032 3131 302d 3133 ton, MA 02110-13 │ │ │ +001e3e60: 3031 2055 5341 0a20 2d20 200a 202d 2020 01 USA. - . - │ │ │ +001e3e70: 0a2d 2d3e 0a3c 7265 6665 6e74 7279 2069 .-->.<refentry i │ │ │ +001e3e80: 643d 2266 6e5f 7374 7269 6e67 5f6f 7574 d="fn_string_out │ │ │ +001e3e90: 7075 745f 677a 5f63 6f6d 7072 6573 7322 put_gz_compress" │ │ │ +001e3ea0: 3e0a 2020 3c72 6566 6d65 7461 3e0a 2020 >. <refmeta>. │ │ │ +001e3eb0: 2020 3c72 6566 656e 7472 7974 6974 6c65 <refentrytitle │ │ │ +001e3ec0: 3e73 7472 696e 675f 6f75 7470 7574 5f67 >string_output_g │ │ │ +001e3ed0: 7a5f 636f 6d70 7265 7373 3c2f 7265 6665 z_compress</refe │ │ │ +001e3ee0: 6e74 7279 7469 746c 653e 0a20 2020 203c ntrytitle>. < │ │ │ +001e3ef0: 7265 666d 6973 6369 6e66 6f3e 636f 6d70 refmiscinfo>comp │ │ │ +001e3f00: 7265 7373 696f 6e3c 2f72 6566 6d69 7363 ression</refmisc │ │ │ +001e3f10: 696e 666f 3e0a 2020 2020 3c72 6566 6d69 info>. <refmi │ │ │ +001e3f20: 7363 696e 666f 3e73 7472 696e 673c 2f72 scinfo>string</r │ │ │ +001e3f30: 6566 6d69 7363 696e 666f 3e0a 2020 3c2f efmiscinfo>. </ │ │ │ +001e3f40: 7265 666d 6574 613e 0a20 203c 7265 666e refmeta>. <refn │ │ │ +001e3f50: 616d 6564 6976 3e0a 2020 2020 3c72 6566 amediv>. <ref │ │ │ +001e3f60: 6e61 6d65 3e73 7472 696e 675f 6f75 7470 name>string_outp │ │ │ +001e3f70: 7574 5f67 7a5f 636f 6d70 7265 7373 3c2f ut_gz_compress</ │ │ │ +001e3f80: 7265 666e 616d 653e 0a20 2020 203c 7265 refname>. <re │ │ │ +001e3f90: 6670 7572 706f 7365 3e63 6f6d 7072 6573 fpurpose>compres │ │ │ +001e3fa0: 7320 6120 7374 7269 6e67 5f6f 7574 7075 s a string_outpu │ │ │ +001e3fb0: 7420 7769 7468 2067 7a69 7020 616c 676f t with gzip algo │ │ │ +001e3fc0: 7269 7468 6d3c 2f72 6566 7075 7270 6f73 rithm</refpurpos │ │ │ +001e3fd0: 653e 0a20 203c 2f72 6566 6e61 6d65 6469 e>. </refnamedi │ │ │ +001e3fe0: 763e 0a20 203c 7265 6673 796e 6f70 7369 v>. <refsynopsi │ │ │ +001e3ff0: 7364 6976 3e0a 2020 2020 3c66 756e 6373 sdiv>. <funcs │ │ │ +001e4000: 796e 6f70 7369 7320 6964 3d22 6673 796e ynopsis id="fsyn │ │ │ +001e4010: 5f73 7472 696e 675f 6f75 7470 7574 5f67 _string_output_g │ │ │ +001e4020: 7a5f 636f 6d70 7265 7373 223e 0a20 2020 z_compress">. │ │ │ +001e4030: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ +001e4040: 6520 6964 3d22 6670 726f 746f 5f73 7472 e id="fproto_str │ │ │ +001e4050: 696e 675f 6f75 7470 7574 5f67 7a5f 636f ing_output_gz_co │ │ │ +001e4060: 6d70 7265 7373 223e 0a20 2020 2020 2020 mpress">. │ │ │ +001e4070: 203c 6675 6e63 6465 663e 3c66 756e 6374 <funcdef><funct │ │ │ +001e4080: 696f 6e3e 7374 7269 6e67 5f6f 7574 7075 ion>string_outpu │ │ │ +001e4090: 745f 677a 5f63 6f6d 7072 6573 733c 2f66 t_gz_compress</f │ │ │ +001e40a0: 756e 6374 696f 6e3e 3c2f 6675 6e63 6465 unction></funcde │ │ │ +001e40b0: 663e 0a20 2020 2020 2020 203c 7061 7261 f>. <para │ │ │ +001e40c0: 6d64 6566 3e69 6e20 3c70 6172 616d 6574 mdef>in <paramet │ │ │ +001e40d0: 6572 3e73 7472 5f6f 7574 5f69 6e3c 2f70 er>str_out_in</p │ │ │ +001e40e0: 6172 616d 6574 6572 3e20 7374 7269 6e67 arameter> string │ │ │ +001e40f0: 5f73 6573 7369 6f6e 3c2f 7061 7261 6d64 _session</paramd │ │ │ +001e4100: 6566 3e0a 2020 2020 2020 2020 3c70 6172 ef>. <par │ │ │ +001e4110: 616d 6465 663e 6f75 7420 3c70 6172 616d amdef>out <param │ │ │ +001e4120: 6574 6572 3e73 7472 5f6f 7574 5f6f 7574 eter>str_out_out │ │ │ +001e4130: 3c2f 7061 7261 6d65 7465 723e 2073 7472 </parameter> str │ │ │ +001e4140: 696e 675f 7365 7373 696f 6e3c 2f70 6172 ing_session</par │ │ │ +001e4150: 616d 6465 663e 0a20 2020 2020 203c 2f66 amdef>. </f │ │ │ +001e4160: 756e 6370 726f 746f 7479 7065 3e0a 2020 uncprototype>. │ │ │ +001e4170: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 </funcsynopsis │ │ │ +001e4180: 3e0a 2020 3c2f 7265 6673 796e 6f70 7369 >. </refsynopsi │ │ │ +001e4190: 7364 6976 3e0a 2020 3c72 6566 7365 6374 sdiv>. <refsect │ │ │ +001e41a0: 3120 6964 3d22 6465 7363 5f73 7472 696e 1 id="desc_strin │ │ │ +001e41b0: 675f 6f75 7470 7574 5f67 7a5f 636f 6d70 g_output_gz_comp │ │ │ +001e41c0: 7265 7373 223e 3c74 6974 6c65 3e44 6573 ress"><title>Des │ │ │ +001e41d0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +001e41e0: 0a20 2020 203c 7061 7261 3e54 6865 2073 . The s │ │ │ +001e41f0: 7472 696e 675f 6f75 7470 7574 5f67 7a5f tring_output_gz_ │ │ │ +001e4200: 636f 6d70 7265 7373 2063 6f6d 7072 6573 compress compres │ │ │ +001e4210: 7365 7320 6974 7320 7374 7269 6e67 5f6f ses its string_o │ │ │ +001e4220: 7574 7075 7420 6172 6775 6d65 6e74 2075 utput argument u │ │ │ +001e4230: 7369 6e67 2074 6865 2067 7a69 700a 2020 sing the gzip. │ │ │ +001e4240: 2020 616c 676f 7269 7468 6d20 616e 6420 algorithm and │ │ │ +001e4250: 7772 6974 6573 2074 6865 2072 6573 756c writes the resul │ │ │ +001e4260: 7420 746f 2061 6e6f 7468 6572 2073 7472 t to another str │ │ │ +001e4270: 696e 675f 6f75 7470 7574 2067 6976 656e ing_output given │ │ │ +001e4280: 2061 7320 616e 2061 7267 756d 656e 742e as an argument. │ │ │ +001e4290: 0a20 2020 2057 6865 6e20 7375 6363 6573 . When succes │ │ │ +001e42a0: 7366 756c 2c20 7468 6520 6e75 6d62 6572 sful, the number │ │ │ +001e42b0: 206f 6620 6279 7465 7320 7772 6974 7465 of bytes writte │ │ │ +001e42c0: 6e20 746f 203c 7061 7261 6d65 7465 723e n to │ │ │ +001e42d0: 7374 725f 6f75 745f 6f75 743c 2f70 6172 str_out_out. is r │ │ │ +001e42f0: 6574 7572 6e65 642e 3c2f 7061 7261 3e0a eturned.. │ │ │ +001e4300: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +001e4310: 3c72 6566 7365 6374 3120 6964 3d22 7061 │ │ │ +001e4340: 0a20 2020 203c 7469 746c 653e 5061 7261 . Para │ │ │ +001e4350: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ +001e4360: 2020 203c 7265 6673 6563 7432 3e3c 7469 str_out_in. A string sess │ │ │ +001e43a0: 696f 6e20 6173 2072 6574 7572 6e65 6420 ion as returned │ │ │ +001e43b0: 6279 203c 6675 6e63 7469 6f6e 3e73 7472 by str │ │ │ +001e43c0: 696e 675f 6f75 7470 7574 3c2f 6675 6e63 ing_output function.< │ │ │ +001e43e0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . str_ │ │ │ +001e4410: 6f75 745f 6f75 743c 2f74 6974 6c65 3e0a out_out. │ │ │ +001e4420: 2020 2020 2020 3c70 6172 613e 4120 7374 A st │ │ │ +001e4430: 7269 6e67 2073 6573 7369 6f6e 2061 7320 ring session as │ │ │ +001e4440: 7265 7475 726e 6564 2062 7920 3c66 756e returned by string_out │ │ │ +001e4460: 7075 743c 2f66 756e 6374 696f 6e3e 2066 put f │ │ │ +001e4470: 756e 6374 696f 6e2e 3c2f 7061 7261 3e0a unction.
    . │ │ │ +001e4480: 2020 2020 3c2f 7265 6673 6563 7432 3e0a
    . │ │ │ +001e4490: 2020 3c2f 7265 6673 6563 7431 3e0a 2020
    . │ │ │ +001e44a0: 3c72 6566 7365 6374 3120 6964 3d22 7265 Return Types │ │ │ +001e44e0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . INTEGER │ │ │ +001e4500: 3c2f 7479 7065 3e20 6e75 6d62 6572 206f number o │ │ │ +001e4510: 6620 6279 7465 7320 7772 6974 7465 6e20 f bytes written │ │ │ +001e4520: 746f 203c 7061 7261 6d65 7465 723e 7374 to st │ │ │ +001e4530: 725f 6f75 745f 6f75 743c 2f70 6172 616d r_out_out. < │ │ │ +001e4550: 2f72 6566 7365 6374 313e 0a3c 212d 2d20 /refsect1>.. . < │ │ │ +001e47e0: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. G │ │ │ +001e4830: 5a49 5020 7465 7374 3c2f 7469 746c 653e ZIP test │ │ │ +001e4840: 0a20 2020 2020 203c 7061 7261 3e54 6573 . Tes │ │ │ +001e4850: 7420 6966 2074 6865 2067 7a69 7020 696d t if the gzip im │ │ │ +001e4860: 706c 656d 656e 7461 7469 6f6e 2077 6f72 plementation wor │ │ │ +001e4870: 6b73 2e3c 2f70 6172 613e 0a20 2020 2020 ks.. │ │ │ +001e4880: 203c 7363 7265 656e 3e3c 215b 4344 4154 md5 (dta_2 │ │ │ +001e4a60: 2929 0a20 2020 2073 6967 6e61 6c20 2827 )). signal (' │ │ │ +001e4a70: 534e 4146 5527 2c20 2747 5a49 5020 616c SNAFU', 'GZIP al │ │ │ +001e4a80: 676f 7269 7468 6d20 696d 706c 656d 656e gorithm implemen │ │ │ +001e4a90: 7461 7469 6f6e 2069 7320 6661 756c 7479 tation is faulty │ │ │ +001e4aa0: 2e27 293b 0a0a 2020 7265 7375 6c74 2028 .');.. result ( │ │ │ +001e4ab0: 6c65 6e67 7468 2028 6474 6129 293b 0a20 length (dta));. │ │ │ +001e4ac0: 2065 6e64 5f72 6573 756c 7428 293b 0a7d end_result();.} │ │ │ +001e4ad0: 0a3b 0a0a 5351 4c3e 2067 7a5f 7465 7374 .;..SQL> gz_test │ │ │ +001e4ae0: 5f31 2028 2774 6d70 2f74 6573 742e 6461 _1 ('tmp/test.da │ │ │ +001e4af0: 7427 293b 0a6c 656e 0a49 4e54 4547 4552 t');.len.INTEGER │ │ │ +001e4b00: 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ._______________ │ │ │ +001e4b10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e4b20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e4b30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e4b40: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e4b50: 0a0a 3131 3638 390a 3234 3737 0a31 3136 ..11689.2477.116 │ │ │ +001e4b60: 3839 0a0a 3320 526f 7773 2e20 2d2d 2031 89..3 Rows. -- 1 │ │ │ +001e4b70: 3120 6d73 6563 2e0a 5d5d 3e3c 2f73 6372 1 msec..]]>. . . . See Also. str │ │ │ +001e4c20: 696e 675f 6f75 7470 7574 3c2f 6c69 6e6b ing_output. ........(demo/d │ │ │ +001e4c60: 6f63 7372 632f 6675 6e63 7265 662f 5354 ocsrc/funcref/ST │ │ │ +001e4c70: 5f49 6e74 6572 696f 7252 696e 674e 2e78 _InteriorRingN.x │ │ │ +001e4c80: 6d6c df00 0017 cc3c 3f78 6d6c 2076 6572 ml...... │ │ │ +001e4fe0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. │ │ │ +001e5010: 0a20 2020 203c 7265 6665 6e74 7279 7469 . ST_InteriorR │ │ │ +001e5030: 696e 674e 3c2f 7265 6665 6e74 7279 7469 ingN. geo. . . ST_InteriorRing │ │ │ +001e50a0: 4e3c 2f72 6566 6e61 6d65 3e0a 2020 2020 N. │ │ │ +001e50b0: 3c72 6566 7075 7270 6f73 653e 4769 7665 Give │ │ │ +001e50c0: 6e20 6120 312d 6261 7365 6420 696e 6465 n a 1-based inde │ │ │ +001e50d0: 7820 6f66 2061 6e20 696e 7465 7269 6f72 x of an interior │ │ │ +001e50e0: 2072 696e 6720 6f66 2061 2070 6f6c 7967 ring of a polyg │ │ │ +001e50f0: 6f6e 2c20 7265 7475 726e 7320 7468 6520 on, returns the │ │ │ +001e5100: 7269 6e67 2e20 5772 6f6e 6720 696e 6465 ring. Wrong inde │ │ │ +001e5110: 7820 6973 206e 6f74 2072 6570 6f72 7465 x is not reporte │ │ │ +001e5120: 6420 6173 2061 6e20 6572 726f 720a 2020 d as an error. │ │ │ +001e5130: 2020 0961 6e64 204e 554c 4c20 6973 2072 .and NULL is r │ │ │ +001e5140: 6574 7572 6e65 642e 203c 2f72 6566 7075 eturned. . . . . . │ │ │ +001e51e0: 2020 203c 6675 6e63 6465 663e 3c66 756e ST_Interio │ │ │ +001e5200: 7252 696e 674e 3c2f 6675 6e63 7469 6f6e rRingN.. │ │ │ +001e5220: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ +001e5230: 3c70 6172 616d 6574 6572 3e70 6f6c 6967 polig │ │ │ +001e5240: 6f6e 3c2f 7061 7261 6d65 7465 723e 2061 on a │ │ │ +001e5250: 6e79 3c2f 7061 7261 6d64 6566 3e0a 0920 ny.. │ │ │ +001e5260: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ +001e5270: 6e20 3c70 6172 616d 6574 6572 3e69 6478 n idx │ │ │ +001e5280: 3c2f 7061 7261 6d65 7465 723e 2061 6e79 any │ │ │ +001e5290: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001e52a0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . De │ │ │ +001e5310: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. Give │ │ │ +001e5330: 6e20 6120 312d 6261 7365 6420 696e 6465 n a 1-based inde │ │ │ +001e5340: 7820 6f66 2061 6e20 696e 7465 7269 6f72 x of an interior │ │ │ +001e5350: 2072 696e 6720 6f66 2061 2070 6f6c 7967 ring of a polyg │ │ │ +001e5360: 6f6e 2c20 7265 7475 726e 7320 7468 6520 on, returns the │ │ │ +001e5370: 7269 6e67 2e20 5772 6f6e 6720 696e 6465 ring. Wrong inde │ │ │ +001e5380: 7820 6973 206e 6f74 2072 6570 6f72 7465 x is not reporte │ │ │ +001e5390: 6420 6173 2061 6e0a 2020 2020 0965 7272 d as an. .err │ │ │ +001e53a0: 6f72 2061 6e64 204e 554c 4c20 6973 2072 or and NULL is r │ │ │ +001e53b0: 6574 7572 6e65 642e 203c 2f70 6172 613e eturned. │ │ │ +001e53c0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +001e53d0: 203c 7265 6673 6563 7431 2069 643d 2270 . Parameters. poli │ │ │ +001e5430: 676f 6e3c 2f74 6974 6c65 3e3c 7061 7261 gonA given poligon │ │ │ +001e5450: 206f 6620 6120 7479 7065 2073 6861 7065 of a type shape │ │ │ +001e5460: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .. idx</ti │ │ │ +001e5490: 746c 653e 3c70 6172 613e 496e 6465 782e tle><para>Index. │ │ │ +001e54a0: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 </para></refsect │ │ │ +001e54b0: 323e 0a20 203c 2f72 6566 7365 6374 313e 2>. </refsect1> │ │ │ +001e54c0: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +001e54d0: 2272 6574 5f53 545f 496e 7465 7269 6f72 "ret_ST_Interior │ │ │ +001e54e0: 5269 6e67 4e22 3e3c 7469 746c 653e 5265 RingN"><title>Re │ │ │ +001e54f0: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ +001e5500: 653e 0a20 2020 203c 7061 7261 3e52 6574 e>. <para>Ret │ │ │ +001e5510: 7572 6e73 2061 6e79 2e3c 2f70 6172 613e urns any.</para> │ │ │ +001e5520: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ +001e5530: 203c 7265 6673 6563 7431 2069 643d 2265 <refsect1 id="e │ │ │ +001e5540: 7861 6d70 6c65 735f 5354 5f49 6e74 6572 xamples_ST_Inter │ │ │ +001e5550: 696f 7252 696e 674e 223e 0a20 2020 203c iorRingN">. < │ │ │ +001e5560: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples</ │ │ │ +001e5570: 7469 746c 653e 0a20 2020 203c 6578 616d title>. <exam │ │ │ +001e5580: 706c 6520 6964 3d22 6578 5f53 545f 496e ple id="ex_ST_In │ │ │ +001e5590: 7465 7269 6f72 5269 6e67 4e22 3e3c 7469 teriorRingN"><ti │ │ │ +001e55a0: 746c 653e 5369 6d70 6c65 2055 7365 3c2f tle>Simple Use</ │ │ │ +001e55b0: 7469 746c 653e 0a20 2020 2020 203c 7363 title>. <sc │ │ │ +001e55c0: 7265 656e 3e3c 215b 4344 4154 415b 0a53 reen><![CDATA[.S │ │ │ +001e55d0: 514c 3e20 7365 6c65 6374 2053 545f 496e QL> select ST_In │ │ │ +001e55e0: 7465 7269 6f72 5269 6e67 4e20 2873 745f teriorRingN (st_ │ │ │ +001e55f0: 6577 6b74 5f72 6561 6420 2827 504f 4c59 ewkt_read ('POLY │ │ │ +001e5600: 474f 4e28 2831 2033 2c32 2034 2c31 2035 GON((1 3,2 4,1 5 │ │ │ +001e5610: 2c30 2034 2c31 2033 292c 2831 2033 2e35 ,0 4,1 3),(1 3.5 │ │ │ +001e5620: 2c31 2e35 2034 2c31 2034 2e35 2c30 2e35 ,1.5 4,1 4.5,0.5 │ │ │ +001e5630: 2034 2c31 2033 2e35 2929 2729 2c20 3129 4,1 3.5))'), 1) │ │ │ +001e5640: 0a75 6e6e 616d 6564 0a56 4152 4348 4152 .unnamed.VARCHAR │ │ │ +001e5650: 204e 4f54 204e 554c 4c0a 5f5f 5f5f 5f5f NOT NULL.______ │ │ │ +001e5660: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5670: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5680: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5690: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e56a0: 5f5f 5f5f 5f5f 5f5f 5f0a 0a52 494e 4728 _________..RING( │ │ │ +001e56b0: 312e 3020 332e 3530 3030 3030 2c31 2e35 1.0 3.500000,1.5 │ │ │ +001e56c0: 3030 3030 3020 342e 302c 312e 3020 342e 00000 4.0,1.0 4. │ │ │ +001e56d0: 3530 3030 3030 2c30 2e35 3030 3030 3020 500000,0.500000 │ │ │ +001e56e0: 342e 302c 312e 3020 332e 3530 3030 3030 4.0,1.0 3.500000 │ │ │ +001e56f0: 290a 0a53 514c 3e20 4442 2e44 4241 2e54 )..SQL> DB.DBA.T │ │ │ +001e5700: 544c 5020 2827 0a3c 706f 696e 7432 643e TLP ('.<point2d> │ │ │ +001e5710: 2020 2020 2020 203c 7368 6170 653e 2022 <shape> " │ │ │ +001e5720: 504f 494e 5428 3120 3329 225e 5e3c 6874 POINT(1 3)"^^<ht │ │ │ +001e5730: 7470 3a2f 2f77 7777 2e6f 7065 6e6c 696e tp://www.openlin │ │ │ +001e5740: 6b73 772e 636f 6d2f 7363 6865 6d61 732f ksw.com/schemas/ │ │ │ +001e5750: 7669 7274 7264 6623 4765 6f6d 6574 7279 virtrdf#Geometry │ │ │ +001e5760: 3e20 2e0a 3c70 6f69 6e74 3464 3e20 2020 > ..<point4d> │ │ │ +001e5770: 2020 2020 3c73 6861 7065 3e20 2250 4f49 <shape> "POI │ │ │ +001e5780: 4e54 5a4d 2830 2031 2032 2033 2922 5e5e NTZM(0 1 2 3)"^^ │ │ │ +001e5790: 3c68 7474 703a 2f2f 7777 772e 6f70 656e <http://www.open │ │ │ +001e57a0: 6c69 6e6b 7377 2e63 6f6d 2f73 6368 656d linksw.com/schem │ │ │ +001e57b0: 6173 2f76 6972 7472 6466 2347 656f 6d65 as/virtrdf#Geome │ │ │ +001e57c0: 7472 793e 202e 0a3c 626f 7831 3e20 2020 try> ..<box1> │ │ │ +001e57d0: 2020 2020 2020 203c 7368 6170 653e 2022 <shape> " │ │ │ +001e57e0: 424f 5828 3020 302c 2032 2033 2922 5e5e BOX(0 0, 2 3)"^^ │ │ │ +001e57f0: 3c68 7474 703a 2f2f 7777 772e 6f70 656e <http://www.open │ │ │ +001e5800: 6c69 6e6b 7377 2e63 6f6d 2f73 6368 656d linksw.com/schem │ │ │ +001e5810: 6173 2f76 6972 7472 6466 2347 656f 6d65 as/virtrdf#Geome │ │ │ +001e5820: 7472 793e 202e 0a3c 6c69 6e65 7374 7269 try> ..<linestri │ │ │ +001e5830: 6e67 3e20 2020 203c 7368 6170 653e 2022 ng> <shape> " │ │ │ +001e5840: 4c49 4e45 5354 5249 4e47 2831 3020 3231 LINESTRING(10 21 │ │ │ +001e5850: 2c20 3132 2032 332c 2031 3020 3235 2922 , 12 23, 10 25)" │ │ │ +001e5860: 5e5e 3c68 7474 703a 2f2f 7777 772e 6f70 ^^<http://www.op │ │ │ +001e5870: 656e 6c69 6e6b 7377 2e63 6f6d 2f73 6368 enlinksw.com/sch │ │ │ +001e5880: 656d 6173 2f76 6972 7472 6466 2347 656f emas/virtrdf#Geo │ │ │ +001e5890: 6d65 7472 793e 202e 0a3c 706f 6c79 676f metry> ..<polygo │ │ │ +001e58a0: 6e31 3e20 2020 2020 203c 7368 6170 653e n1> <shape> │ │ │ +001e58b0: 2022 504f 4c59 474f 4e28 2831 2033 2c32 "POLYGON((1 3,2 │ │ │ +001e58c0: 2034 2c31 2035 2c30 2034 2c31 2033 2929 4,1 5,0 4,1 3)) │ │ │ +001e58d0: 225e 5e3c 6874 7470 3a2f 2f77 7777 2e6f "^^<http://www.o │ │ │ +001e58e0: 7065 6e6c 696e 6b73 772e 636f 6d2f 7363 penlinksw.com/sc │ │ │ +001e58f0: 6865 6d61 732f 7669 7274 7264 6623 4765 hemas/virtrdf#Ge │ │ │ +001e5900: 6f6d 6574 7279 3e20 2e0a 3c70 6f6c 7967 ometry> ..<polyg │ │ │ +001e5910: 6f6e 323e 2020 2020 2020 3c73 6861 7065 on2> <shape │ │ │ +001e5920: 3e20 2250 4f4c 5947 4f4e 2828 312e 3520 > "POLYGON((1.5 │ │ │ +001e5930: 332e 352c 322e 3520 342e 352c 312e 3520 3.5,2.5 4.5,1.5 │ │ │ +001e5940: 352e 352c 302e 3520 342e 352c 312e 3520 5.5,0.5 4.5,1.5 │ │ │ +001e5950: 332e 3529 2922 5e5e 3c68 7474 703a 2f2f 3.5))"^^<http:// │ │ │ +001e5960: 7777 772e 6f70 656e 6c69 6e6b 7377 2e63 www.openlinksw.c │ │ │ +001e5970: 6f6d 2f73 6368 656d 6173 2f76 6972 7472 om/schemas/virtr │ │ │ +001e5980: 6466 2347 656f 6d65 7472 793e 202e 0a3c df#Geometry> ..< │ │ │ +001e5990: 706f 6c79 676f 6e33 3e20 2020 2020 203c polygon3> < │ │ │ +001e59a0: 7368 6170 653e 2022 504f 4c59 474f 4e28 shape> "POLYGON( │ │ │ +001e59b0: 2831 2033 2c32 2034 2c31 2035 2c30 2034 (1 3,2 4,1 5,0 4 │ │ │ +001e59c0: 2c31 2033 292c 2831 2033 2e35 2c31 2e35 ,1 3),(1 3.5,1.5 │ │ │ +001e59d0: 2034 2c31 2034 2e35 2c30 2e35 2034 2c31 4,1 4.5,0.5 4,1 │ │ │ +001e59e0: 2033 2e35 2929 225e 5e3c 6874 7470 3a2f 3.5))"^^<http:/ │ │ │ +001e59f0: 2f77 7777 2e6f 7065 6e6c 696e 6b73 772e /www.openlinksw. │ │ │ +001e5a00: 636f 6d2f 7363 6865 6d61 732f 7669 7274 com/schemas/virt │ │ │ +001e5a10: 7264 6623 4765 6f6d 6574 7279 3e20 2e0a rdf#Geometry> .. │ │ │ +001e5a20: 3c6d 756c 7469 706f 6c79 676f 6e3e 2020 <multipolygon> │ │ │ +001e5a30: 3c73 6861 7065 3e20 224d 554c 5449 504f <shape> "MULTIPO │ │ │ +001e5a40: 4c59 474f 4e28 2828 3120 332c 3220 342c LYGON(((1 3,2 4, │ │ │ +001e5a50: 3120 352c 3020 342c 3120 3329 292c 2828 1 5,0 4,1 3)),(( │ │ │ +001e5a60: 3120 322c 3220 312c 3120 302c 3020 312c 1 2,2 1,1 0,0 1, │ │ │ +001e5a70: 3120 3229 2929 225e 5e3c 6874 7470 3a2f 1 2)))"^^<http:/ │ │ │ +001e5a80: 2f77 7777 2e6f 7065 6e6c 696e 6b73 772e /www.openlinksw. │ │ │ +001e5a90: 636f 6d2f 7363 6865 6d61 732f 7669 7274 com/schemas/virt │ │ │ +001e5aa0: 7264 6623 4765 6f6d 6574 7279 3e20 2e0a rdf#Geometry> .. │ │ │ +001e5ab0: 3c63 6f6c 6c65 6374 696f 6e3e 2020 2020 <collection> │ │ │ +001e5ac0: 3c73 6861 7065 3e20 2247 454f 4d45 5452 <shape> "GEOMETR │ │ │ +001e5ad0: 5943 4f4c 4c45 4354 494f 4e28 504f 494e YCOLLECTION(POIN │ │ │ +001e5ae0: 5428 3020 3029 2c4d 554c 5449 4c49 4e45 T(0 0),MULTILINE │ │ │ +001e5af0: 5354 5249 4e47 2828 3120 352c 3020 312c STRING((1 5,0 1, │ │ │ +001e5b00: 3420 302c 3520 3429 2c28 3120 352c 3120 4 0,5 4),(1 5,1 │ │ │ +001e5b10: 302c 3420 302c 3420 3529 292c 4d55 4c54 0,4 0,4 5)),MULT │ │ │ +001e5b20: 4950 4f4c 5947 4f4e 2828 2831 2033 2c32 IPOLYGON(((1 3,2 │ │ │ +001e5b30: 2034 2c31 2035 2c30 2034 2c31 2033 2929 4,1 5,0 4,1 3)) │ │ │ +001e5b40: 2c28 2831 2032 2c32 2031 2c31 2030 2c30 ,((1 2,2 1,1 0,0 │ │ │ +001e5b50: 2031 2c31 2032 2929 2929 225e 5e3c 6874 1,1 2))))"^^<ht │ │ │ +001e5b60: 7470 3a2f 2f77 7777 2e6f 7065 6e6c 696e tp://www.openlin │ │ │ +001e5b70: 6b73 772e 636f 6d2f 7363 6865 6d61 732f ksw.com/schemas/ │ │ │ +001e5b80: 7669 7274 7264 6623 4765 6f6d 6574 7279 virtrdf#Geometry │ │ │ +001e5b90: 3e20 2e0a 272c 2027 6874 7470 3a2f 2f67 > ..', 'http://g │ │ │ +001e5ba0: 656f 2d61 7069 2d64 656d 6f2f 272c 2027 eo-api-demo/', ' │ │ │ +001e5bb0: 6874 7470 3a2f 2f67 656f 2d61 7069 2d64 http://geo-api-d │ │ │ +001e5bc0: 656d 6f2f 272c 2030 290a 0a53 514c 3e20 emo/', 0)..SQL> │ │ │ +001e5bd0: 5350 4152 514c 0a53 454c 4543 5420 3f73 SPARQL.SELECT ?s │ │ │ +001e5be0: 2c20 6269 663a 5354 5f49 6e74 6572 696f , bif:ST_Interio │ │ │ +001e5bf0: 7252 696e 674e 2028 3f6f 2c20 6269 663a rRingN (?o, bif: │ │ │ +001e5c00: 5354 5f4e 756d 696e 7465 7269 6f72 5269 ST_NuminteriorRi │ │ │ +001e5c10: 6e67 7320 283f 6f29 290a 4652 4f4d 203c ngs (?o)).FROM < │ │ │ +001e5c20: 6874 7470 3a2f 2f67 656f 2d61 7069 2d64 http://geo-api-d │ │ │ +001e5c30: 656d 6f2f 3e0a 5748 4552 450a 2020 7b0a emo/>.WHERE. {. │ │ │ +001e5c40: 2020 2020 3f73 203f 7020 3f6f 202e 0a20 ?s ?p ?o .. │ │ │ +001e5c50: 2020 2046 494c 5445 5220 2862 6966 3a53 FILTER (bif:S │ │ │ +001e5c60: 545f 4e75 6d49 6e74 6572 696f 7252 696e T_NumInteriorRin │ │ │ +001e5c70: 6773 2028 3f6f 2920 3e20 3029 0a20 207d gs (?o) > 0). } │ │ │ +001e5c80: 0a4f 5244 4552 2042 5920 4153 4328 7374 .ORDER BY ASC(st │ │ │ +001e5c90: 7228 3f73 2929 0a73 2020 2020 2020 2020 r(?s)).s │ │ │ +001e5ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +001e5cb0: 2020 2020 2063 616c 6c72 6574 2d31 0a56 callret-1.V │ │ │ +001e5cc0: 4152 4348 4152 2020 2020 2020 2020 2020 ARCHAR │ │ │ +001e5cd0: 2020 2020 2020 2020 2020 2020 2056 4152 VAR │ │ │ +001e5ce0: 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f CHAR.___________ │ │ │ +001e5cf0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5d00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5d10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5d20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e5d30: 5f5f 5f5f 0a0a 6874 7470 3a2f 2f67 656f ____..http://geo │ │ │ +001e5d40: 2d61 7069 2d64 656d 6f2f 706f 6c79 676f -api-demo/polygo │ │ │ +001e5d50: 6e33 2020 5249 4e47 2831 2e30 2033 2e35 n3 RING(1.0 3.5 │ │ │ +001e5d60: 3030 3030 302c 312e 3530 3030 3030 2034 00000,1.500000 4 │ │ │ +001e5d70: 2e30 2c31 2e30 2034 2e35 3030 3030 302c .0,1.0 4.500000, │ │ │ +001e5d80: 302e 3530 3030 3030 2034 2e30 2c31 2e30 0.500000 4.0,1.0 │ │ │ +001e5d90: 2033 2e35 3030 3030 3029 0a5d 5d3e 0a3c 3.500000).]]>.< │ │ │ +001e5da0: 2f73 6372 6565 6e3e 0a20 2020 203c 2f65 /screen>. </e │ │ │ +001e5db0: 7861 6d70 6c65 3e0a 2020 3c2f 7265 6673 xample>. </refs │ │ │ +001e5dc0: 6563 7431 3e0a 2020 3c72 6566 7365 6374 ect1>. <refsect │ │ │ +001e5dd0: 3120 6964 3d22 7365 6561 6c73 6f5f 5354 1 id="seealso_ST │ │ │ +001e5de0: 5f49 6e74 6572 696f 7252 696e 674e 223e _InteriorRingN"> │ │ │ +001e5df0: 0a20 2020 203c 7469 746c 653e 5365 6520 . <title>See │ │ │ +001e5e00: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ +001e5e10: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e ST_ExteriorR │ │ │ +001e5e50: 696e 6728 293c 2f66 756e 6374 696f 6e3e ing() │ │ │ +001e5e60: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e5e70: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c │ │ │ +001e5ea0: 3c66 756e 6374 696f 6e3e 5354 5f4e 756d ST_Num │ │ │ +001e5eb0: 496e 7465 7269 6f72 5269 6e67 7328 293c InteriorRings()< │ │ │ +001e5ec0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. │ │ │ +001e5ee0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e st_ │ │ │ +001e5f10: 706f 696e 743c 2f66 756e 6374 696f 6e3e point │ │ │ +001e5f20: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e5f30: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c st_x< │ │ │ +001e5f60: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. st_y.
  • S │ │ │ +001e5ff0: 545f 5a3c 2f66 756e 6374 696f 6e3e 3c2f T_Z. │ │ │ +001e6010: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e │ │ │ +001e6040: 7374 5f64 6973 7461 6e63 653c 2f66 756e st_distance

    . < │ │ │ +001e6070: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001e6080: 5f53 545f 5365 7453 5249 4422 3e3c 6675 _ST_SetSRID">ST_SetSRI │ │ │ +001e60a0: 443c 2f66 756e 6374 696f 6e3e 3c2f 6c69 D
  • . < │ │ │ +001e60c0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>st_a │ │ │ +001e60f0: 7374 6578 743c 2f66 756e 6374 696f 6e3e stext │ │ │ +001e6100: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e6110: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c st_geomfro │ │ │ +001e6150: 6d74 6578 743c 2f66 756e 6374 696f 6e3e mtext │ │ │ +001e6160: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e6170: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c st_intersect │ │ │ +001e61b0: 733c 2f66 756e 6374 696f 6e3e 3c2f 6c69 s. < │ │ │ +001e61d0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>st │ │ │ +001e6200: 5f63 6f6e 7461 696e 733c 2f66 756e 6374 _contains.
  • st_within< │ │ │ +001e6270: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. < │ │ │ +001e62a0: 6675 6e63 7469 6f6e 3e69 7367 656f 6d65 function>isgeome │ │ │ +001e62b0: 7472 793c 2f66 756e 6374 696f 6e3e 3c2f try. │ │ │ +001e62d0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e g │ │ │ +001e6300: 656f 5f69 6e73 6572 743c 2f66 756e 6374 eo_insert.
  • geo_delete< │ │ │ +001e6360: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. DB.D │ │ │ +001e63b0: 4241 2e52 4446 5f47 454f 5f41 4444 3c2f BA.RDF_GEO_ADD │ │ │ +001e63d0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . DB.D │ │ │ +001e6410: 4241 2e52 4446 5f47 454f 5f46 494c 4c3c BA.RDF_GEO_FILL< │ │ │ +001e6420: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. .......demo/doc │ │ │ +001e6460: 7372 632f 6675 6e63 7265 662f 6365 696c src/funcref/ceil │ │ │ +001e6470: 696e 672e 786d 6cdf 0000 0a0d 3c3f 786d ing.xml........ . │ │ │ +001e6830: 2020 2020 3c72 6566 656e 7472 7974 6974 ceiling. < │ │ │ +001e6860: 7265 666d 6973 6369 6e66 6f3e 6e75 6d62 refmiscinfo>numb │ │ │ +001e6870: 6572 3c2f 7265 666d 6973 6369 6e66 6f3e er │ │ │ +001e6880: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ +001e6890: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ +001e68a0: 203c 7265 666e 616d 653e 6365 696c 696e ceilin │ │ │ +001e68b0: 673c 2f72 6566 6e61 6d65 3e0a 2020 2020 g. │ │ │ +001e68c0: 3c72 6566 7075 7270 6f73 653e 526f 756e Roun │ │ │ +001e68d0: 6420 6120 6e75 6d62 6572 2074 6f20 706f d a number to po │ │ │ +001e68e0: 7369 7469 7665 2069 6e66 696e 6974 792e sitive infinity. │ │ │ +001e68f0: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ +001e6900: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001e6910: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ +001e6920: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . . │ │ │ +001e6970: 2020 2020 2020 2020 203c 6675 6e63 6465 ceil │ │ │ +001e6990: 696e 673c 2f66 756e 6374 696f 6e3e 3c2f ing. │ │ │ +001e69b0: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ +001e69c0: 7061 7261 6d65 7465 723e 783c 2f70 6172 parameter>x double p │ │ │ +001e69e0: 7265 6369 7369 6f6e 3c2f 7061 7261 6d64 recision. . < │ │ │ +001e6a10: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ +001e6a20: 203c 2f72 6566 7379 6e6f 7073 6973 6469 . Descript │ │ │ +001e6a60: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ +001e6a70: 3c70 6172 613e 3c66 756e 6374 696f 6e3e │ │ │ +001e6a80: 6365 696c 696e 673c 2f66 756e 6374 696f ceiling calculates th │ │ │ +001e6aa0: 6520 736d 616c 6c65 7374 2069 6e74 6567 e smallest integ │ │ │ +001e6ab0: 6572 2067 7265 6174 6572 2074 6861 6e20 er greater than │ │ │ +001e6ac0: 6f72 2065 7175 616c 2074 6f20 3c70 6172 or equal to x.. < │ │ │ +001e6af0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Parameters. x</tit │ │ │ +001e6b50: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +001e6b60: 3c74 7970 653e 646f 7562 6c65 2070 7265 <type>double pre │ │ │ +001e6b70: 6369 7369 6f6e 3c2f 7479 7065 3e3c 2f70 cision</type></p │ │ │ +001e6b80: 6172 613e 0a20 2020 203c 2f72 6566 7365 ara>. </refse │ │ │ +001e6b90: 6374 323e 0a20 203c 2f72 6566 7365 6374 ct2>. </refsect │ │ │ +001e6ba0: 313e 0a20 203c 7265 6673 6563 7431 2069 1>. <refsect1 i │ │ │ +001e6bb0: 643d 2272 6574 5f63 6569 6c69 6e67 223e d="ret_ceiling"> │ │ │ +001e6bc0: 3c74 6974 6c65 3e52 6574 7572 6e20 5661 <title>Return Va │ │ │ +001e6bd0: 6c75 6573 3c2f 7469 746c 653e 0a20 2020 lues. │ │ │ +001e6be0: 203c 7061 7261 3e3c 6675 6e63 7469 6f6e ceiling returns a 32 │ │ │ +001e6c10: 2d62 6974 0a20 2020 203c 7479 7065 3e69 -bit. i │ │ │ +001e6c20: 6e74 6567 6572 3c2f 7479 7065 3e2e 3c2f nteger.. . Exa │ │ │ +001e6c70: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ +001e6c80: 2020 3c65 7861 6d70 6c65 2069 643d 2265 Simple Example │ │ │ +001e6cb0: 733c 2f74 6974 6c65 3e0a 2020 2020 2020 s. │ │ │ +001e6cc0: 3c73 6372 6565 6e3e 0a53 514c 3e20 7365 .SQL> se │ │ │ +001e6cd0: 6c65 6374 2063 6569 6c69 6e67 2028 3132 lect ceiling (12 │ │ │ +001e6ce0: 2e33 3435 3629 2c20 6365 696c 696e 6720 .3456), ceiling │ │ │ +001e6cf0: 282d 3132 2e33 3435 3629 2c20 6365 696c (-12.3456), ceil │ │ │ +001e6d00: 696e 6720 2830 2e35 3133 3531 3329 3b0a ing (0.513513);. │ │ │ +001e6d10: 6361 6c6c 7265 7420 2020 6361 6c6c 7265 callret callre │ │ │ +001e6d20: 7420 2020 6361 6c6c 7265 740a 494e 5445 t callret.INTE │ │ │ +001e6d30: 4745 5220 2020 494e 5445 4745 5220 2020 GER INTEGER │ │ │ +001e6d40: 494e 5445 4745 520a 5f5f 5f5f 5f5f 5f5f INTEGER.________ │ │ │ +001e6d50: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e6d60: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e6d70: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e6d80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e6d90: 5f5f 5f5f 5f5f 5f0a 0a31 3320 2020 2020 _______..13 │ │ │ +001e6da0: 2020 202d 3132 2020 2020 2020 2031 0a0a -12 1.. │ │ │ +001e6db0: 3120 526f 7773 2e20 2d2d 2034 206d 7365 1 Rows. -- 4 mse │ │ │ +001e6dc0: 632e 0a3c 2f73 6372 6565 6e3e 0a20 2020 c... │ │ │ +001e6dd0: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f . . See Also.
  • │ │ │ +001e6e50: 666c 6f6f 723c 2f66 756e 6374 696f 6e3e floor │ │ │ +001e6e60: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e6e70: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 ......-de │ │ │ +001e6e90: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ +001e6ea0: 662f 7365 7269 616c 697a 655f 746f 5f55 f/serialize_to_U │ │ │ +001e6eb0: 5446 385f 786d 6c2e 786d 6cdf 0000 0f69 TF8_xml.xml....i │ │ │ +001e6ec0: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... . serialize_t │ │ │ +001e72a0: 6f5f 5554 4638 5f78 6d6c 3c2f 7265 6665 o_UTF8_xml. < │ │ │ +001e72c0: 7265 666d 6973 6369 6e66 6f3e 786d 6c3c refmiscinfo>xml< │ │ │ +001e72d0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +001e72e0: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . serialize │ │ │ +001e7310: 5f74 6f5f 5554 4638 5f78 6d6c 3c2f 7265 _to_UTF8_xml. Converts │ │ │ +001e7340: 6172 6775 6d65 6e74 2074 6f20 6974 7320 argument to its │ │ │ +001e7350: 5554 462d 3820 7374 7269 6e67 2072 6570 UTF-8 string rep │ │ │ +001e7360: 7265 7365 6e74 6174 696f 6e2e 3c2f 7265 resentation.. . . │ │ │ +001e73a0: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . │ │ │ +001e73d0: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +001e7410: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 serialize_to_ │ │ │ +001e7430: 5554 4638 5f78 6d6c 3c2f 6675 6e63 7469 UTF8_xml..< │ │ │ +001e7450: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in value any. . │ │ │ +001e74a0: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . . D │ │ │ +001e7500: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ +001e7510: 653e 0a20 2020 203c 7061 7261 3e54 6865 e>. <para>The │ │ │ +001e7520: 2066 756e 6374 696f 6e20 636f 6e76 6572 function conver │ │ │ +001e7530: 7473 2069 7473 2061 7267 756d 656e 7420 ts its argument │ │ │ +001e7540: 746f 2061 206e 6172 726f 7720 7374 7269 to a narrow stri │ │ │ +001e7550: 6e67 2069 6e0a 5554 462d 3820 656e 636f ng in.UTF-8 enco │ │ │ +001e7560: 6469 6e67 2e20 5468 6520 7761 7920 636f ding. The way co │ │ │ +001e7570: 6e76 6572 7369 6f6e 2069 7320 646f 6e65 nversion is done │ │ │ +001e7580: 2064 6570 656e 6473 206f 6e20 7468 6520 depends on the │ │ │ +001e7590: 7479 7065 206f 660a 7468 6520 6172 6775 type of.the argu │ │ │ +001e75a0: 6d65 6e74 2e3c 2f70 6172 613e 0a20 2020 ment.</para>. │ │ │ +001e75b0: 203c 7061 7261 3e49 6620 3c70 6172 616d <para>If <param │ │ │ +001e75c0: 6574 6572 3e76 616c 7565 3c2f 7061 7261 eter>value</para │ │ │ +001e75d0: 6d65 7465 723e 2069 7320 6120 7769 6465 meter> is a wide │ │ │ +001e75e0: 2028 6e61 7469 6f6e 616c 2920 7374 7269 (national) stri │ │ │ +001e75f0: 6e67 0a6f 7220 6120 4c4f 4e47 204e 5641 ng.or a LONG NVA │ │ │ +001e7600: 5243 4841 5220 7468 656e 2069 7420 6973 RCHAR then it is │ │ │ +001e7610: 2064 6972 6563 746c 7920 636f 6e76 6572 directly conver │ │ │ +001e7620: 7465 6420 746f 2055 5446 2d38 2073 7472 ted to UTF-8 str │ │ │ +001e7630: 696e 672e 3c2f 7061 7261 3e0a 2020 2020 ing.</para>. │ │ │ +001e7640: 3c70 6172 613e 4966 203c 7061 7261 6d65 <para>If <parame │ │ │ +001e7650: 7465 723e 7661 6c75 653c 2f70 6172 616d ter>value</param │ │ │ +001e7660: 6574 6572 3e20 6973 2061 2073 7472 696e eter> is a strin │ │ │ +001e7670: 6720 6f72 2061 204c 4f4e 4720 5641 5243 g or a LONG VARC │ │ │ +001e7680: 4841 520a 7468 656e 2069 7420 6973 2063 HAR.then it is c │ │ │ +001e7690: 6f6e 7665 7274 6564 2066 726f 6d20 6375 onverted from cu │ │ │ +001e76a0: 7272 656e 7420 6368 6172 7365 7420 6f66 rrent charset of │ │ │ +001e76b0: 2063 6c69 656e 7420 636f 6e6e 6563 7469 client connecti │ │ │ +001e76c0: 6f6e 2074 6f20 7468 6520 5554 462d 382e on to the UTF-8. │ │ │ +001e76d0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 </para>. <par │ │ │ +001e76e0: 613e 4966 203c 7061 7261 6d65 7465 723e a>If <parameter> │ │ │ +001e76f0: 7661 6c75 653c 2f70 6172 616d 6574 6572 value</parameter │ │ │ +001e7700: 3e20 6973 2061 6e20 584d 4c20 656e 7469 > is an XML enti │ │ │ +001e7710: 7479 2074 6865 6e20 6974 2069 730a 636f ty then it is.co │ │ │ +001e7720: 6e76 6572 7465 6420 746f 2069 7473 2058 nverted to its X │ │ │ +001e7730: 4d4c 2074 6578 7420 7265 7072 6573 656e ML text represen │ │ │ +001e7740: 7461 7469 6f6e 2069 6e20 5554 462d 3820 tation in UTF-8 │ │ │ +001e7750: 656e 636f 6469 6e67 2e20 5468 6520 7265 encoding. The re │ │ │ +001e7760: 7375 6c74 696e 670a 7374 7269 6e67 2069 sulting.string i │ │ │ +001e7770: 7320 6120 7765 6c6c 2d66 6f72 6d65 6420 s a well-formed │ │ │ +001e7780: 584d 4c20 646f 6375 6d65 6e74 2069 6620 XML document if │ │ │ +001e7790: 7468 6520 6769 7665 6e20 656e 7469 7479 the given entity │ │ │ +001e77a0: 2069 7320 616e 2065 6c65 6d65 6e74 2065 is an element e │ │ │ +001e77b0: 6e74 6974 792c 0a6f 7468 6572 7769 7365 ntity,.otherwise │ │ │ +001e77c0: 2069 7420 6d61 7920 6265 2077 656c 6c2d it may be well- │ │ │ +001e77d0: 666f 726d 6564 2067 656e 6572 6963 2065 formed generic e │ │ │ +001e77e0: 6e74 6974 792c 2069 2e65 2e20 6974 2063 ntity, i.e. it c │ │ │ +001e77f0: 616e 2062 6520 7061 7273 6564 2062 790a an be parsed by. │ │ │ +001e7800: 616e 2058 4d4c 2070 6172 7365 7220 6f6e an XML parser on │ │ │ +001e7810: 6c79 2061 7320 6120 7061 7274 206f 6620 ly as a part of │ │ │ +001e7820: 736f 6d65 206f 7468 6572 2058 4d4c 2064 some other XML d │ │ │ +001e7830: 6f63 756d 656e 742e 3c2f 7061 7261 3e0a ocument.</para>. │ │ │ +001e7840: 2020 2020 3c70 6172 613e 4966 203c 7061 <para>If <pa │ │ │ +001e7850: 7261 6d65 7465 723e 7661 6c75 653c 2f70 rameter>value</p │ │ │ +001e7860: 6172 616d 6574 6572 3e20 6973 204e 554c arameter> is NUL │ │ │ +001e7870: 4c2c 2074 6865 204e 554c 4c20 6973 2072 L, the NULL is r │ │ │ +001e7880: 6574 7572 6e65 642e 3c2f 7061 7261 3e0a eturned.</para>. │ │ │ +001e7890: 2020 2020 3c70 6172 613e 5661 6c75 6573 <para>Values │ │ │ +001e78a0: 206f 6620 6f74 6865 7220 7479 7065 7320 of other types │ │ │ +001e78b0: 6172 6520 6669 7273 7420 636f 6e76 6572 are first conver │ │ │ +001e78c0: 7465 6420 746f 2056 4152 4348 4152 2c20 ted to VARCHAR, │ │ │ +001e78d0: 7468 6973 0a69 6e74 6572 6d65 6469 6174 this.intermediat │ │ │ +001e78e0: 6520 5641 5243 4841 5220 6973 2063 6f6e e VARCHAR is con │ │ │ +001e78f0: 7665 7274 6564 2066 726f 6d20 6375 7272 verted from curr │ │ │ +001e7900: 656e 7420 6368 6172 7365 7420 6f66 2063 ent charset of c │ │ │ +001e7910: 6c69 656e 7420 636f 6e6e 6563 7469 6f6e lient connection │ │ │ +001e7920: 0a74 6f20 7468 6520 5554 462d 3820 616e .to the UTF-8 an │ │ │ +001e7930: 6420 6973 2072 6574 7572 6e65 642e 3c2f d is returned.</ │ │ │ +001e7940: 7061 7261 3e0a 2020 3c2f 7265 6673 6563 para>. </refsec │ │ │ +001e7950: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +001e7960: 6964 3d22 7061 7261 6d73 5f73 6572 6961 id="params_seria │ │ │ +001e7970: 6c69 7a65 5f74 6f5f 5554 4638 5f78 6d6c lize_to_UTF8_xml │ │ │ +001e7980: 223e 0a20 2020 203c 7469 746c 653e 5061 ">. <title>Pa │ │ │ +001e7990: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ +001e79a0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +001e79b0: 7469 746c 653e 7661 6c75 653c 2f74 6974 title>value. │ │ │ +001e79d0: 5468 6520 7661 6c75 6520 6f66 2061 7262 The value of arb │ │ │ +001e79e0: 6974 7261 7279 2074 7970 6520 746f 2062 itrary type to b │ │ │ +001e79f0: 6520 636f 6e76 6572 7465 6420 696e 746f e converted into │ │ │ +001e7a00: 2069 7473 2055 5446 2d38 2073 7472 696e its UTF-8 strin │ │ │ +001e7a10: 6720 7265 7072 6573 656e 7461 7469 6f6e g representation │ │ │ +001e7a20: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . Return │ │ │ +001e7a80: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ +001e7a90: 2020 3c70 6172 613e 5554 462d 3820 7374 UTF-8 st │ │ │ +001e7aa0: 7269 6e67 206f 7220 4e55 4c4c 2e3c 2f70 ring or NULL.

    . . . E │ │ │ +001e7b00: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ +001e7b10: 2020 2020 3c65 7861 6d70 6c65 2069 643d UTF-8 encoding │ │ │ +001e7b50: 206f 6620 6e6f 6e2d 4153 4349 4920 6368 of non-ASCII ch │ │ │ +001e7b60: 6172 6163 7465 7273 3c2f 7469 746c 653e aracters │ │ │ +001e7b70: 0a20 2020 2020 203c 7061 7261 3e41 2073 . A s │ │ │ +001e7b80: 616d 706c 6520 646f 6375 6d65 6e74 2069 ample document i │ │ │ +001e7b90: 7320 7061 7273 6564 2061 6e64 2074 6865 s parsed and the │ │ │ +001e7ba0: 2072 6573 756c 7469 6e67 2065 6e74 6974 resulting entit │ │ │ +001e7bb0: 7920 6973 2073 6572 6961 6c69 7a65 6420 y is serialized │ │ │ +001e7bc0: 746f 2055 5446 2d38 2073 7472 696e 672e to UTF-8 string. │ │ │ +001e7bd0: 3c2f 7061 7261 3e0a 2020 2020 2020 3c73 . 0- │ │ │ +001e7c20: 3920 612d 7a20 412d 5a20 2623 3132 383b 9 a-z A-Z € │ │ │ +001e7c30: 2d26 2332 3535 3b20 2623 3235 363b 2d26 -ÿ Ā-& │ │ │ +001e7c40: 2335 3131 3b20 2623 3130 3234 3b2d 2623 #511; Ѐ-&# │ │ │ +001e7c50: 3831 3931 3b3c 2f74 6578 743e 2729 293b 8191;')); │ │ │ +001e7c60: 0a63 616c 6c72 6574 0a56 4152 4348 4152 .callret.VARCHAR │ │ │ +001e7c70: 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ._______________ │ │ │ +001e7c80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e7c90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e7ca0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e7cb0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001e7cc0: 0a5d 5d3e 0a26 6c74 3b74 6578 7426 6774 .]]>.<text> │ │ │ +001e7cd0: 3b30 2d39 2061 2d7a 2041 2d5a 2026 2378 ;0-9 a-z A-Z &#x │ │ │ +001e7ce0: 4332 3b26 2378 3830 3b2d 2623 7843 333b C2;€-à │ │ │ +001e7cf0: 2623 7842 463b 2026 2378 4334 3b26 2378 ¿ Ä&#x │ │ │ +001e7d00: 3830 3b2d 2623 7843 373b 2623 7842 463b 80;-Ç¿ │ │ │ +001e7d10: 2026 2378 4430 3b26 2378 3830 3b2d 2623 Ѐ-&# │ │ │ +001e7d20: 7845 313b 2623 7842 463b 2623 7842 463b xE1;¿¿ │ │ │ +001e7d30: 266c 743b 2f74 6578 7426 6774 3b0a 3c2f </text>.. . . . │ │ │ +001e7da0: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ +001e7db0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . charset_r │ │ │ +001e7df0: 6563 6f64 653c 2f66 756e 6374 696f 6e3e ecode │ │ │ +001e7e00: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +001e7e10: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 .......de │ │ │ +001e7e30: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ +001e7e40: 662f 7370 7269 6e74 662e 786d 6cdf 0000 f/sprintf.xml... │ │ │ +001e7e50: 1142 3c3f 786d 6c20 7665 7273 696f 6e3d .B..< │ │ │ +001e81e0: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ +001e81f0: 7370 7269 6e74 6622 3e0a 2020 3c72 6566 sprintf">. . sprintf │ │ │ +001e8220: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ +001e8230: 0a20 2020 203c 7265 666d 6973 6369 6e66 . string. . . │ │ │ +001e8280: 7370 7269 6e74 663c 2f72 6566 6e61 6d65 sprintf. returns a form │ │ │ +001e82b0: 6174 7465 6420 7374 7269 6e67 3c2f 7265 atted string. . . │ │ │ +001e82f0: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . . │ │ │ +001e8340: 2020 2020 3c66 756e 6364 6566 3e3c 6675 sprintf. format string
    .

    arg_1 any. ... │ │ │ +001e8420: 203c 2f70 6172 616d 6465 663e 0a20 2020 . │ │ │ +001e8430: 2020 2020 203c 7061 7261 6d64 6566 3e3c < │ │ │ +001e8440: 7061 7261 6d65 7465 723e 6172 675f 783c parameter>arg_x< │ │ │ +001e8450: 2f70 6172 616d 6574 6572 3e20 616e 793c /parameter> any< │ │ │ +001e8460: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +001e8470: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . │ │ │ +001e84c0: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ +001e84d0: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001e84e0: 7061 7261 3e73 7072 696e 7466 2072 6574 para>sprintf ret │ │ │ +001e84f0: 7572 6e73 2061 206e 6577 2073 7472 696e urns a new strin │ │ │ +001e8500: 6720 666f 726d 6564 2062 7920 2270 7269 g formed by "pri │ │ │ +001e8510: 6e74 696e 6722 2061 2076 6172 6961 626c nting" a variabl │ │ │ +001e8520: 6520 6e75 6d62 6572 0a20 2020 206f 6620 e number. of │ │ │ +001e8530: 6172 6775 6d65 6e74 7320 6172 675f 3120 arguments arg_1 │ │ │ +001e8540: 2d20 6172 675f 7820 6163 636f 7264 696e - arg_x accordin │ │ │ +001e8550: 6720 746f 2074 6865 2066 6f72 6d61 7420 g to the format │ │ │ +001e8560: 7374 7269 6e67 2066 6f72 6d61 742c 0a20 string format,. │ │ │ +001e8570: 2020 2074 6861 7420 6973 2c20 6578 6163 that is, exac │ │ │ +001e8580: 746c 7920 7468 6520 7361 6d65 2077 6179 tly the same way │ │ │ +001e8590: 2061 7320 7769 7468 2074 6865 2073 7072 as with the spr │ │ │ +001e85a0: 696e 7466 2066 756e 6374 696f 6e20 6f66 intf function of │ │ │ +001e85b0: 2043 206c 616e 6775 6167 652e 0a20 2020 C language.. │ │ │ +001e85c0: 2048 6f77 6576 6572 2074 6865 2073 7072 However the spr │ │ │ +001e85d0: 696e 7466 2066 756e 6374 696f 6e20 656e intf function en │ │ │ +001e85e0: 666f 7263 6573 2073 6f6d 6520 6164 6469 forces some addi │ │ │ +001e85f0: 7469 6f6e 616c 206c 696d 6974 6174 696f tional limitatio │ │ │ +001e8600: 6e73 206f 7665 7220 7468 6520 7370 7269 ns over the spri │ │ │ +001e8610: 6e74 6620 4320 6675 6e63 7469 6f6e 2e0a ntf C function.. │ │ │ +001e8620: 2020 2020 4974 2064 6f65 7320 6e6f 7420 It does not │ │ │ +001e8630: 616c 6c6f 7720 666f 7220 7369 6e67 6c65 allow for single │ │ │ +001e8640: 2076 616c 7565 206f 7574 7075 7420 746f value output to │ │ │ +001e8650: 2074 616b 6520 6d6f 7265 2074 6861 6e20 take more than │ │ │ +001e8660: 3230 3030 2063 6861 7261 6374 6572 732e 2000 characters. │ │ │ +001e8670: 0a20 2020 2049 7420 646f 6573 2073 7570 . It does sup │ │ │ +001e8680: 706f 7274 2074 6865 2066 6f6c 6c6f 7769 port the followi │ │ │ +001e8690: 6e67 2061 6464 6974 696f 6e61 6c20 666f ng additional fo │ │ │ +001e86a0: 726d 6174 2063 6861 7261 6374 6572 733a rmat characters: │ │ │ +001e86b0: 0a3c 2f70 6172 613e 0a3c 7061 7261 3e0a ... │ │ │ +001e86c0: 2020 2020 6469 6f75 7858 6545 6667 6373 diouxXeEfgcs │ │ │ +001e86d0: 202d 2061 7320 696e 2074 6865 2043 206c - as in the C l │ │ │ +001e86e0: 616e 6775 6167 6520 7072 696e 7466 0a3c anguage printf.< │ │ │ +001e86f0: 2f70 6172 613e 0a3c 7061 7261 3e0a 2020 /para>.. │ │ │ +001e8700: 2020 5320 2d20 6173 2027 7327 2062 7574 S - as 's' but │ │ │ +001e8710: 2065 7363 6170 6573 2074 6865 2073 696e escapes the sin │ │ │ +001e8720: 676c 6520 7175 6f74 6573 2062 7920 646f gle quotes by do │ │ │ +001e8730: 7562 6c69 6e67 2074 6865 6d20 2861 7320 ubling them (as │ │ │ +001e8740: 7065 7220 5351 4c2f 3932 292e 2054 6869 per SQL/92). Thi │ │ │ +001e8750: 7320 6973 2073 7569 7461 626c 6520 666f s is suitable fo │ │ │ +001e8760: 720a 2020 2020 636f 6e73 7472 7563 7469 r. constructi │ │ │ +001e8770: 6e67 2064 796e 616d 6963 2053 514c 2073 ng dynamic SQL s │ │ │ +001e8780: 7461 7465 6d65 6e74 7320 7769 7468 2073 tatements with s │ │ │ +001e8790: 7472 696e 6720 6c69 7465 7261 6c73 2069 tring literals i │ │ │ +001e87a0: 6e6c 696e 652e 0a3c 2f70 6172 613e 0a3c nline...< │ │ │ +001e87b0: 7363 7265 656e 3e0a 2020 2020 7370 7269 screen>. spri │ │ │ +001e87c0: 6e74 6620 2827 696e 7365 7274 2069 6e74 ntf ('insert int │ │ │ +001e87d0: 6f20 7465 7374 6974 2028 6461 7461 2920 o testit (data) │ │ │ +001e87e0: 7661 6c75 6573 2028 2725 5327 2927 2c20 values ('%S')', │ │ │ +001e87f0: 2754 6573 7420 2727 5265 616c 2727 2064 'Test ''Real'' d │ │ │ +001e8800: 6174 6127 290a 092d 2667 743b 2069 6e73 ata')..-> ins │ │ │ +001e8810: 6572 7420 696e 746f 2074 6573 7469 7420 ert into testit │ │ │ +001e8820: 2864 6174 6129 2076 616c 7565 7320 2827 (data) values (' │ │ │ +001e8830: 5465 7374 2027 2752 6561 6c27 2720 6461 Test ''Real'' da │ │ │ +001e8840: 7461 2729 0a3c 2f73 6372 6565 6e3e 0a3c ta')..< │ │ │ +001e8850: 7061 7261 3e0a 2020 2020 4920 2d20 6173 para>. I - as │ │ │ +001e8860: 2027 7327 2062 7574 2065 7363 6170 6573 's' but escapes │ │ │ +001e8870: 2074 6865 2073 7472 696e 6720 7661 6c75 the string valu │ │ │ +001e8880: 6520 746f 2066 6f72 6d20 6120 7661 6c69 e to form a vali │ │ │ +001e8890: 6420 6964 656e 7469 6669 6572 206e 616d d identifier nam │ │ │ +001e88a0: 6520 2877 696c 6c20 646f 7562 6c65 2074 e (will double t │ │ │ +001e88b0: 6865 2064 6f75 626c 650a 2020 2020 2020 he double. │ │ │ +001e88c0: 7175 6f74 6573 292e 2020 5468 6973 2069 quotes). This i │ │ │ +001e88d0: 7320 7375 6974 6162 6c65 2066 6f72 2063 s suitable for c │ │ │ +001e88e0: 6f6e 7374 7275 6374 696e 6720 6479 6e61 onstructing dyna │ │ │ +001e88f0: 6d69 6320 5351 4c20 7374 6174 656d 656e mic SQL statemen │ │ │ +001e8900: 7473 2077 6974 6820 6964 656e 7469 6669 ts with identifi │ │ │ +001e8910: 6572 7320 696e 6c69 6e65 2e0a 3c2f 7061 ers inline.... │ │ │ +001e8930: 2073 7072 696e 7466 2028 2773 656c 6563 sprintf ('selec │ │ │ +001e8940: 7420 2a20 6672 6f6d 2022 2549 2227 2c20 t * from "%I"', │ │ │ +001e8950: 2742 6967 2022 5461 626c 6522 204e 616d 'Big "Table" Nam │ │ │ +001e8960: 6527 290a 092d 2667 743b 2073 656c 6563 e')..-> selec │ │ │ +001e8970: 7420 2a20 6672 6f6d 2022 4269 6720 2222 t * from "Big "" │ │ │ +001e8980: 5461 626c 6522 2220 4e61 6d65 220a 3c2f Table"" Name"... │ │ │ +001e89a0: 2020 2055 202d 2061 7320 2773 2720 6275 U - as 's' bu │ │ │ +001e89b0: 7420 6573 6361 7065 7320 7468 6520 7374 t escapes the st │ │ │ +001e89c0: 7269 6e67 2076 616c 7565 2061 7320 616e ring value as an │ │ │ +001e89d0: 2048 5454 5020 5552 4c20 2873 616d 6520 HTTP URL (same │ │ │ +001e89e0: 6173 2068 7474 705f 7572 6c28 2920 6675 as http_url() fu │ │ │ +001e89f0: 6e63 7469 6f6e 292e 2055 7365 6675 6c20 nction). Useful │ │ │ +001e8a00: 666f 7220 6d61 6b69 6e67 0a20 2020 2020 for making. │ │ │ +001e8a10: 2064 796e 616d 6963 2056 5350 2063 6f6e dynamic VSP con │ │ │ +001e8a20: 7465 6e74 0a3c 2f70 6172 613e 0a3c 7363 tent... sprint │ │ │ +001e8a40: 6620 2827 266c 743b 6120 6872 6566 3d22 f ('<a href=" │ │ │ +001e8a50: 2555 2226 6774 3b27 2c20 2764 6179 2026 %U">', 'day & │ │ │ +001e8a60: 616d 703b 206e 6967 6874 2729 0a09 2d26 amp; night')..-& │ │ │ +001e8a70: 6774 3b20 266c 743b 6120 6872 6566 3d22 gt; <a href=" │ │ │ +001e8a80: 6461 792b 2532 362b 6e69 6768 7422 2667 day+%26+night"&g │ │ │ +001e8a90: 743b 0a3c 2f73 6372 6565 6e3e 0a3c 7061 t;... R - use │ │ │ +001e8ab0: 746f 2072 6570 6c61 6365 206c 6561 6469 to replace leadi │ │ │ +001e8ac0: 6e67 2073 7061 6365 733a 2074 6865 206d ng spaces: the m │ │ │ +001e8ad0: 6f64 6966 6965 7273 2061 7265 206f 6e65 odifiers are one │ │ │ +001e8ae0: 206f 6620 2b20 2d20 2320 3020 616e 6420 of + - # 0 and │ │ │ +001e8af0: 7370 6163 652e 0a3c 2f70 6172 613e 0a3c space...< │ │ │ +001e8b00: 7363 7265 656e 3e0a 2020 2020 7370 7269 screen>. spri │ │ │ +001e8b10: 6e74 6620 2827 252d 5227 2c20 2720 3132 ntf ('%-R', ' 12 │ │ │ +001e8b20: 3327 290a 2020 2020 2d31 3233 0a20 2020 3'). -123. │ │ │ +001e8b30: 2073 7072 696e 7466 2028 2725 2d52 272c sprintf ('%-R', │ │ │ +001e8b40: 2027 2020 3132 3327 290a 2020 2020 2d2d ' 123'). -- │ │ │ +001e8b50: 3132 330a 3c2f 7363 7265 656e 3e0a 3c70 123..

    . V - as │ │ │ +001e8b70: 2773 2720 6275 7420 6573 6361 7065 7320 's' but escapes │ │ │ +001e8b80: 7468 6520 7374 7269 6e67 2076 616c 7565 the string value │ │ │ +001e8b90: 2061 7320 616e 2048 5454 5020 5661 6c75 as an HTTP Valu │ │ │ +001e8ba0: 6520 2873 616d 6520 6173 2068 7474 705f e (same as http_ │ │ │ +001e8bb0: 7661 6c75 6529 2e20 5573 6566 756c 2066 value). Useful f │ │ │ +001e8bc0: 6f72 206d 616b 696e 670a 2020 2020 2020 or making. │ │ │ +001e8bd0: 6479 6e61 6d69 6320 5653 5020 636f 6e74 dynamic VSP cont │ │ │ +001e8be0: 656e 740a 3c2f 7061 7261 3e0a 3c73 6372 ent... sprintf │ │ │ +001e8c00: 2028 2726 6c74 3b49 4e50 5554 206e 616d ('<INPUT nam │ │ │ +001e8c10: 653d 2274 6573 7422 2076 616c 7565 3d22 e="test" value=" │ │ │ +001e8c20: 2556 2226 6774 3b27 2c20 2764 6179 2026 %V">', 'day & │ │ │ +001e8c30: 616d 703b 206e 6967 6874 2729 0a09 2d26 amp; night')..-& │ │ │ +001e8c40: 6774 3b20 266c 743b 494e 5055 5420 6e61 gt; <INPUT na │ │ │ +001e8c50: 6d65 3d22 7465 7374 2220 7661 6c75 653d me="test" value= │ │ │ +001e8c60: 2264 6179 2026 616d 703b 616d 703b 206e "day &amp; n │ │ │ +001e8c70: 6967 6874 2226 6774 3b0a 3c2f 7363 7265 ight">... N │ │ │ +001e8c90: 6f74 6520 7468 6174 2074 6865 2073 7072 ote that the spr │ │ │ +001e8ca0: 696e 7466 2066 6f72 6d61 7420 6c65 6e67 intf format leng │ │ │ +001e8cb0: 7468 2061 6e64 2070 7265 6369 7369 6f6e th and precision │ │ │ +001e8cc0: 206d 6f64 6966 6965 7273 2064 6f20 6e6f modifiers do no │ │ │ +001e8cd0: 7420 6170 706c 7920 746f 2074 6865 2065 t apply to the e │ │ │ +001e8ce0: 7874 656e 7369 6f6e 2066 6f72 6d61 7420 xtension format │ │ │ +001e8cf0: 6368 6172 6163 7465 7273 0a3c 2f70 6172 characters.....sp │ │ │ +001e8d10: 7269 6e74 6628 2749 6e74 3d25 642f 256f rintf('Int=%d/%o │ │ │ +001e8d20: 2f25 782c 2053 7472 696e 673d 2573 2c20 /%x, String=%s, │ │ │ +001e8d30: 4368 6172 6163 7465 723d 2563 272c 0a20 Character=%c',. │ │ │ +001e8d40: 2020 2034 3237 3938 2c34 3237 3938 2c34 42798,42798,4 │ │ │ +001e8d50: 3237 3938 2c27 6c61 2063 6164 656e 6127 2798,'la cadena' │ │ │ +001e8d60: 2c36 3529 0a20 2d26 6774 3b20 2749 6e74 ,65). -> 'Int │ │ │ +001e8d70: 3d34 3237 3938 2f31 3233 3435 362f 6137 =42798/123456/a7 │ │ │ +001e8d80: 3265 2c20 5374 7269 6e67 3d6c 6120 6361 2e, String=la ca │ │ │ +001e8d90: 6465 6e61 2c20 4368 6172 6163 7465 723d dena, Character= │ │ │ +001e8da0: 4127 0a3c 2f73 6372 6565 6e3e 0a3c 7061 A'..In addition, │ │ │ +001e8dc0: 3c65 6d70 6861 7369 733e 257b 7661 726e %{varn │ │ │ +001e8dd0: 616d 657d 553c 2f65 6d70 6861 7369 733e ame}U │ │ │ +001e8de0: 2073 796e 7461 7820 6578 7465 6e73 696f syntax extensio │ │ │ +001e8df0: 6e20 6973 2073 7570 706f 7274 6564 2c20 n is supported, │ │ │ +001e8e00: 6d6f 7374 6c79 2066 6f72 203c 6c69 6e6b mostly for uing connecti │ │ │ +001e8e40: 6f6e 2076 6172 6961 626c 6573 2069 6e20 on variables in │ │ │ +001e8e50: 5244 4620 4952 4920 636c 6173 7365 733c RDF IRI classes< │ │ │ +001e8e60: 2f6c 696e 6b3e 2e20 5468 6174 2073 796e /link>. That syn │ │ │ +001e8e70: 7461 7820 6973 2074 6f20 7072 696e 7420 tax is to print │ │ │ +001e8e80: 7468 6520 7661 6c75 6520 6f66 2063 6c69 the value of cli │ │ │ +001e8e90: 656e 7420 636f 6e6e 6563 7469 6f6e 2076 ent connection v │ │ │ +001e8ea0: 6172 6961 626c 6520 3c65 6d70 6861 7369 ariable varname using print │ │ │ +001e8ed0: 2066 6f72 6d61 7420 3c65 6d70 6861 7369 format %U. │ │ │ +001e8ef0: 204f 7468 6572 2066 6f72 6d61 7420 6368 Other format ch │ │ │ +001e8f00: 6172 6163 7465 7273 2061 7265 206e 6f74 aracters are not │ │ │ +001e8f10: 2073 7570 706f 7274 6564 2066 6f72 2074 supported for t │ │ │ +001e8f20: 6861 7420 6665 6174 7572 6520 696e 2063 hat feature in c │ │ │ +001e8f30: 7572 7265 6e74 2076 6572 7369 6f6e 206f urrent version o │ │ │ +001e8f40: 6620 5669 7274 756f 736f 2062 7574 206d f Virtuoso but m │ │ │ +001e8f50: 6967 6874 2062 6520 7375 7070 6f72 7465 ight be supporte │ │ │ +001e8f60: 6420 696e 2074 6865 2066 7574 7572 652e d in the future. │ │ │ +001e8f70: 3c2f 7061 7261 3e0a 093c 2f72 6566 7365 ... │ │ │ +001e8f90: 0a0a 0a0a b600 0000 2264 656d 6f2f 646f ........"demo/do │ │ │ +001e8fa0: 6373 7263 2f66 756e 6372 6566 2f65 7865 csrc/funcref/exe │ │ │ +001e8fb0: 635f 7363 6f72 652e 786d 6cdf 0000 0fa0 c_score.xml..... │ │ │ +001e8fc0: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... . exec_sc │ │ │ +001e9360: 6f72 653c 2f72 6566 656e 7472 7974 6974 ore. sql. . . │ │ │ +001e93c0: 6578 6563 5f73 636f 7265 3c2f 7265 666e exec_score. Compiles a │ │ │ +001e93f0: 5351 4c20 7374 6174 656d 656e 7420 616e SQL statement an │ │ │ +001e9400: 6420 7265 7475 726e 7320 7468 6520 6573 d returns the es │ │ │ +001e9410: 7469 6d61 7465 2074 696d 6520 636f 7374 timate time cost │ │ │ +001e9420: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ +001e9430: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001e9440: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ +001e9450: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . < │ │ │ +001e9480: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ +001e9490: 3d22 6670 726f 746f 5f65 7865 635f 7363 ="fproto_exec_sc │ │ │ +001e94a0: 6f72 6522 3e0a 2020 2020 2020 2020 3c66 ore">. exec_score │ │ │ +001e94e0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ +001e94f0: 7061 7261 6d65 7465 723e 7374 723c 2f70 parameter>str

    varcha │ │ │ +001e9510: 723c 2f70 6172 616d 6465 663e 0a09 3c70 r..

    out state varchar │ │ │ +001e9550: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..out message

    varcha │ │ │ +001e9590: 723c 2f70 6172 616d 6465 663e 0a20 2020 r. │ │ │ +001e95a0: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . . │ │ │ +001e9600: 2020 3c74 6974 6c65 3e44 6573 6372 6970 Descrip │ │ │ +001e9610: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ +001e9620: 203c 7061 7261 3e54 6869 7320 6675 6e63 This func │ │ │ +001e9630: 7469 6f6e 2070 726f 7669 6465 7320 6479 tion provides dy │ │ │ +001e9640: 6e61 6d69 6320 5351 4c20 6361 7061 6269 namic SQL capabi │ │ │ +001e9650: 6c69 7469 6573 2069 6e20 5669 7274 756f lities in Virtuo │ │ │ +001e9660: 736f 2050 4c2e 0a20 2020 2054 6865 2066 so PL.. The f │ │ │ +001e9670: 6972 7374 2061 7267 756d 656e 7420 6973 irst argument is │ │ │ +001e9680: 2061 6e20 6172 6269 7472 6172 7920 5351 an arbitrary SQ │ │ │ +001e9690: 4c20 7374 6174 656d 656e 742c 2077 6869 L statement, whi │ │ │ +001e96a0: 6368 206d 6179 2063 6f6e 7461 696e 0a20 ch may contain. │ │ │ +001e96b0: 2020 2070 6172 616d 6574 6572 2070 6c61 parameter pla │ │ │ +001e96c0: 6365 686f 6c64 6572 732e 2054 6865 2066 ceholders. The f │ │ │ +001e96d0: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ +001e96e0: 6173 206f 7574 7075 7420 7061 7261 6d65 as output parame │ │ │ +001e96f0: 7465 7273 2061 0a20 2020 2053 514c 2073 ters a. SQL s │ │ │ +001e9700: 7461 7465 2c20 6572 726f 7220 6d65 7373 tate, error mess │ │ │ +001e9710: 6167 6520 616e 6420 7265 7475 726e 7320 age and returns │ │ │ +001e9720: 7468 6520 6573 7469 6d61 7465 2074 696d the estimate tim │ │ │ +001e9730: 6520 636f 7374 2069 6e20 6d69 6c6c 6973 e cost in millis │ │ │ +001e9740: 6563 6f6e 6473 2e3c 2f70 6172 613e 0a20 econds.. │ │ │ +001e9750: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001e9760: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ +001e9770: 616d 735f 6578 6563 5f73 636f 7265 223e ams_exec_score"> │ │ │ +001e9780: 0a20 2020 203c 7469 746c 653e 5061 7261 . Para │ │ │ +001e9790: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ +001e97a0: 2020 203c 7265 6673 6563 7432 3e3c 7469 s │ │ │ +001e97c0: 7472 3c2f 7061 7261 6d65 7465 723e 3c2f tr. A varch │ │ │ +001e97f0: 6172 3c2f 7479 7065 3e20 636f 6e74 6169 ar contai │ │ │ +001e9800: 6e69 6e67 2061 7262 6974 7261 7279 2053 ning arbitrary S │ │ │ +001e9810: 514c 2075 7369 6e67 203f 2773 2066 6f72 QL using ?'s for │ │ │ +001e9820: 2070 6172 616d 6574 6572 206d 6172 6b65 parameter marke │ │ │ +001e9830: 7273 2e3c 2f70 6172 613e 0a20 2020 203c rs.. < │ │ │ +001e9840: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ +001e9850: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ +001e9860: 7374 6174 653c 2f74 6974 6c65 3e0a 2020 state. │ │ │ +001e9870: 2020 2020 3c70 6172 613e 416e 206f 7574 An out │ │ │ +001e9880: 7075 7420 7061 7261 6d65 7465 7220 6f66 put parameter of │ │ │ +001e9890: 2074 7970 6520 3c74 7970 653e 7661 7263 type varc │ │ │ +001e98a0: 6861 723c 2f74 7970 653e 2073 6574 2074 har set t │ │ │ +001e98b0: 6f20 7468 6520 3520 6368 6172 6163 7465 o the 5 characte │ │ │ +001e98c0: 7220 5351 4c20 7374 6174 6520 6966 2074 r SQL state if t │ │ │ +001e98d0: 6865 2065 7865 6320 7265 7375 6c74 6564 he exec resulted │ │ │ +001e98e0: 2061 6e20 6572 726f 722e 204e 6f74 2073 an error. Not s │ │ │ +001e98f0: 6574 2069 6620 616e 2065 7272 6f72 2069 et if an error i │ │ │ +001e9900: 7320 6e6f 7420 7072 6573 656e 742e 3c2f s not present.. . messa │ │ │ +001e9940: 6765 3c2f 7469 746c 653e 0a20 2020 2020 ge. │ │ │ +001e9950: 203c 7061 7261 3e41 6e20 6f75 7470 7574 An output │ │ │ +001e9960: 2070 6172 616d 6574 6572 206f 6620 7479 parameter of ty │ │ │ +001e9970: 7065 203c 7479 7065 3e76 6172 6368 6172 pe varchar │ │ │ +001e9980: 3c2f 7479 7065 3e20 7365 7420 746f 2053 set to S │ │ │ +001e9990: 514c 2065 7272 6f72 206d 6573 7361 6765 QL error message │ │ │ +001e99a0: 2061 7373 6f63 6961 7465 6420 7769 7468 associated with │ │ │ +001e99b0: 2074 6865 2065 7272 6f72 2e20 4e6f 7420 the error. Not │ │ │ +001e99c0: 7365 7420 6966 2061 6e20 6572 726f 7220 set if an error │ │ │ +001e99d0: 6973 206e 6f74 2070 7265 7365 6e74 2e3c is not present.< │ │ │ +001e99e0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . Retu │ │ │ +001e9a30: 726e 2054 7970 6573 3c2f 7469 746c 653e rn Types │ │ │ +001e9a40: 0a20 2020 203c 7061 7261 3e54 6865 2066 . The f │ │ │ +001e9a50: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ +001e9a60: 6120 666c 6f61 7420 6e75 6d62 6572 2077 a float number w │ │ │ +001e9a70: 6869 6368 2069 7320 7468 6520 6361 6c63 hich is the calc │ │ │ +001e9a80: 756c 6174 6564 2065 7374 696d 6174 6520 ulated estimate │ │ │ +001e9a90: 7469 6d65 2063 6f73 7420 666f 7220 7468 time cost for th │ │ │ +001e9aa0: 6520 7175 6572 7920 6578 6563 7574 696f e query executio │ │ │ +001e9ab0: 6e2e 3c2f 7061 7261 3e0a 2020 3c2f 7265 n.. . .Errors..The fun │ │ │ +001e9b10: 6374 696f 6e20 7769 6c6c 2067 656e 6572 ction will gener │ │ │ +001e9b20: 6174 6520 6120 5351 4c20 3232 3032 3320 ate a SQL 22023 │ │ │ +001e9b30: 6572 726f 7220 7661 6c75 6520 6966 2061 error value if a │ │ │ +001e9b40: 2073 7570 706c 6965 6420 7061 7261 6d65 supplied parame │ │ │ +001e9b50: 7465 7220 6973 206e 6f74 206f 6620 7468 ter is not of th │ │ │ +001e9b60: 6520 7479 7065 2065 7870 6563 7465 642e e type expected. │ │ │ +001e9b70: 0a3c 2f70 6172 613e 0a3c 7469 703e 0a3c ...< │ │ │ +001e9b80: 7469 746c 653e 5365 6520 416c 736f 3a3c title>See Also:< │ │ │ +001e9b90: 2f74 6974 6c65 3e0a 3c70 6172 613e 0a3c /title>..< │ │ │ +001e9ba0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 6572 link linkend="er │ │ │ +001e9bb0: 726f 7273 223e 4c69 7374 206f 6620 5351 rors">List of SQ │ │ │ +001e9bc0: 4c20 3232 3032 3320 6572 726f 7273 2e3c L 22023 errors.< │ │ │ +001e9bd0: 2f6c 696e 6b3e 0a3c 2f70 6172 613e 0a3c /link>..< │ │ │ +001e9be0: 2f74 6970 3e0a 3c21 2d2d 2049 6e20 6361 /tip>.. │ │ │ +001e9cb0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001e9cc0: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ +001e9cd0: 6d70 6c65 735f 6578 6563 5f73 636f 7265 mples_exec_score │ │ │ +001e9ce0: 223e 0a20 2020 203c 7469 746c 653e 4578 ">. Ex │ │ │ +001e9cf0: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ +001e9d00: 2020 203c 6578 616d 706c 6520 6964 3d22 < │ │ │ +001e9d20: 7469 746c 653e 5369 6d70 6c65 2055 7365 title>Simple Use │ │ │ +001e9d30: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +001e9d40: 7363 7265 656e 3e3c 215b 4344 4154 415b screen> select exe │ │ │ +001e9d60: 635f 7363 6f72 6520 2827 7365 6c65 6374 c_score ('select │ │ │ +001e9d70: 202a 2066 726f 6d20 5431 2729 3b20 0920 * from T1'); . │ │ │ +001e9d80: 200a 5d5d 3e0a 3c2f 7363 7265 656e 3e0a .]]>.. │ │ │ +001e9d90: 2020 2020 3c2f 6578 616d 706c 653e 0a20 . │ │ │ +001e9da0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001e9db0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ +001e9dc0: 616c 736f 5f65 7865 635f 7363 6f72 6522 also_exec_score" │ │ │ +001e9dd0: 3e0a 2020 2020 3c74 6974 6c65 3e53 6565 >. See │ │ │ +001e9de0: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ +001e9df0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ +001e9e10: 3c66 756e 6374 696f 6e3e 6578 6563 2829 exec() │ │ │ +001e9e20: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    e │ │ │ +001e9e70: 7865 635f 6d65 7461 6461 7461 2829 3c2f xec_metadata() │ │ │ +001e9e90: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . < │ │ │ +001e9ec0: 6675 6e63 7469 6f6e 3e65 7865 635f 6e65 function>exec_ne │ │ │ +001e9ed0: 7874 2829 3c2f 6675 6e63 7469 6f6e 3e3c xt()< │ │ │ +001e9ee0: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +001e9ef0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ +001e9f20: 6578 6563 5f63 6c6f 7365 2829 3c2f 6675 exec_close(). .. │ │ │ +001e9f60: b600 0000 1f64 656d 6f2f 646f 6373 7263 .....demo/docsrc │ │ │ +001e9f70: 2f66 756e 6372 6566 2f75 6474 5f73 6574 /funcref/udt_set │ │ │ +001e9f80: 2e78 6d6c df00 000d 923c 3f78 6d6c 2076 .xml....... │ │ │ +001ea330: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ +001ea340: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ +001ea350: 7564 745f 7365 743c 2f72 6566 656e 7472 udt_set. type. . . udt_set. . . . . │ │ │ +001ea430: 2020 203c 6675 6e63 7072 6f74 6f74 7970 . < │ │ │ +001ea460: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>udt_set.. │ │ │ +001ea490: 3c70 6172 616d 6465 663e 696e 203c 7061 in udt_inst │ │ │ +001ea4b0: 3c2f 7061 7261 6d65 7465 723e 2061 6e79 any │ │ │ +001ea4c0: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..in member_name │ │ │ +001ea4f0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +001ea500: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +001ea510: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .in

    new_val │ │ │ +001ea530: 7565 3c2f 7061 7261 6d65 7465 723e 2061 ue a │ │ │ +001ea540: 6e79 3c2f 7061 7261 6d64 6566 3e0a 2020 ny. │ │ │ +001ea550: 2020 2020 3c2f 6675 6e63 7072 6f74 6f74 . . . < │ │ │ +001ea590: 7265 6673 6563 7431 2069 643d 2264 6573 refsect1 id="des │ │ │ +001ea5a0: 635f 7564 745f 7365 7422 3e0a 2020 2020 c_udt_set">. │ │ │ +001ea5b0: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ +001ea5c0: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001ea5d0: 7061 7261 3e54 6869 7320 636f 7069 6573 para>This copies │ │ │ +001ea5e0: 2074 6865 2069 6e73 7461 6e63 6520 7564 the instance ud │ │ │ +001ea5f0: 745f 696e 7374 2c20 7365 7473 206e 6577 t_inst, sets new │ │ │ +001ea600: 5f76 616c 7565 2074 6f20 7468 6520 6d65 _value to the me │ │ │ +001ea610: 6d62 6572 2077 6974 6820 0a20 2020 2061 mber with . a │ │ │ +001ea620: 206e 616d 6520 6571 7561 6c20 746f 2074 name equal to t │ │ │ +001ea630: 6865 2076 616c 7565 206f 6620 6d65 6d62 he value of memb │ │ │ +001ea640: 6572 5f6e 616d 6520 2869 6620 616e 7929 er_name (if any) │ │ │ +001ea650: 2061 6e64 2072 6574 7572 6e73 2074 6865 and returns the │ │ │ +001ea660: 206d 6f64 6966 6965 6420 0a20 2020 2069 modified . i │ │ │ +001ea670: 6e73 7461 6e63 6520 636f 7079 2e20 2054 nstance copy. T │ │ │ +001ea680: 6869 7320 6973 2020 6120 6675 6e63 7469 his is a functi │ │ │ +001ea690: 6f6e 616c 2065 7175 6976 616c 656e 7420 onal equivalent │ │ │ +001ea6a0: 6f66 2061 206d 656d 6265 7220 6d75 7461 of a member muta │ │ │ +001ea6b0: 746f 722e 3c2f 7061 7261 3e0a 2020 3c2f tor.. . . < │ │ │ +001ea6f0: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ +001ea700: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . ud │ │ │ +001ea720: 745f 696e 7374 3c2f 7469 746c 653e 0a20 t_inst. │ │ │ +001ea730: 2020 2020 203c 7061 7261 3e41 2075 7365 A use │ │ │ +001ea740: 7220 6465 6669 6e65 6420 7479 7065 2069 r defined type i │ │ │ +001ea750: 6e73 7461 6e63 653c 2f70 6172 613e 0a20 nstance. │ │ │ +001ea760: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +001ea770: 2020 203c 7265 6673 6563 7432 3e3c 7469 member_name< │ │ │ +001ea790: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    The name of │ │ │ +001ea7b0: 7468 6520 7265 7175 6573 7465 6420 6d65 the requested me │ │ │ +001ea7c0: 6d62 6572 3c2f 7061 7261 3e0a 2020 2020 mber. │ │ │ +001ea7d0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ +001ea7e0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 new_value</titl │ │ │ +001ea800: 653e 0a20 2020 2020 203c 7061 7261 3e54 e>. <para>T │ │ │ +001ea810: 6865 206e 6577 2076 616c 7565 2074 6f20 he new value to │ │ │ +001ea820: 6265 2073 6574 3c2f 7061 7261 3e0a 2020 be set</para>. │ │ │ +001ea830: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 </refsect2>. │ │ │ +001ea840: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ +001ea850: 6566 7365 6374 3120 6964 3d22 7265 745f efsect1 id="ret_ │ │ │ +001ea860: 7564 745f 7365 7422 3e3c 7469 746c 653e udt_set"><title> │ │ │ +001ea870: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ +001ea880: 746c 653e 0a20 2020 203c 7061 7261 3e41 tle>. <para>A │ │ │ +001ea890: 206d 6f64 6966 6965 6420 636f 7079 206f modified copy o │ │ │ +001ea8a0: 6620 7564 745f 696e 7374 2077 6974 6820 f udt_inst with │ │ │ +001ea8b0: 7468 655f 7661 6c75 6520 7365 7420 666f the_value set fo │ │ │ +001ea8c0: 7220 6d65 6d62 6572 5f6e 616d 652e 3c2f r member_name.</ │ │ │ +001ea8d0: 7061 7261 3e0a 2020 3c2f 7265 6673 6563 para>. </refsec │ │ │ +001ea8e0: 7431 3e0a 2020 3c21 2d2d 0a20 203c 7265 t1>. <!--. <re │ │ │ +001ea8f0: 6673 6563 7431 2069 643d 2265 7272 6f72 fsect1 id="error │ │ │ +001ea900: 735f 7564 745f 7365 7422 3e0a 2020 2020 s_udt_set">. │ │ │ +001ea910: 3c74 6974 6c65 3e45 7272 6f72 733c 2f74 <title>Errors</t │ │ │ +001ea920: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +001ea930: 5468 6973 2066 756e 6374 696f 6e20 6361 This function ca │ │ │ +001ea940: 6e20 6765 6e65 7261 7465 2074 6865 2066 n generate the f │ │ │ +001ea950: 6f6c 6c6f 7769 6e67 2065 7272 6f72 733a ollowing errors: │ │ │ +001ea960: 3c2f 7061 7261 3e0a 2020 2020 3c65 7272 </para>. <err │ │ │ +001ea970: 6f72 636f 6465 3e3c 2f65 7272 6f72 636f orcode></errorco │ │ │ +001ea980: 6465 3e0a 2020 3c2f 7265 6673 6563 7431 de>. </refsect1 │ │ │ +001ea990: 3e0a 2020 2d2d 3e0a 2020 3c72 6566 7365 >. -->. <refse │ │ │ +001ea9a0: 6374 3120 6964 3d22 6578 616d 706c 6573 ct1 id="examples │ │ │ +001ea9b0: 5f75 6474 5f73 6574 223e 0a20 2020 203c _udt_set">. < │ │ │ +001ea9c0: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples</ │ │ │ +001ea9d0: 7469 746c 653e 0a20 2020 203c 6578 616d title>. <exam │ │ │ +001ea9e0: 706c 6520 6964 3d22 6578 5f75 6474 5f73 ple id="ex_udt_s │ │ │ +001ea9f0: 6574 223e 3c74 6974 6c65 3e53 6574 7469 et"><title>Setti │ │ │ +001eaa00: 6e67 2075 7365 7220 6465 6669 6e65 6420 ng user defined │ │ │ +001eaa10: 7479 7065 206d 656d 6265 7220 7661 6c75 type member valu │ │ │ +001eaa20: 6573 3c2f 7469 746c 653e 0a20 2020 2020 es. │ │ │ +001eaa30: 203c 7061 7261 3e54 6869 7320 7361 6d70 This samp │ │ │ +001eaa40: 6c65 2063 6f64 6520 626c 6f63 6b20 7368 le code block sh │ │ │ +001eaa50: 6f77 7320 6120 7573 6572 2064 6566 696e ows a user defin │ │ │ +001eaa60: 6564 2074 7970 6520 6d65 6d62 6572 2773 ed type member's │ │ │ +001eaa70: 2076 616c 7565 200a 2020 2020 2020 6265 value . be │ │ │ +001eaa80: 696e 6720 7365 742e 3c2f 7061 7261 3e0a ing set.. │ │ │ +001eaa90: 2020 2020 2020 3c73 6372 6565 6e3e 3c21 . │ │ │ +001eab20: 2020 3c2f 6578 616d 706c 653e 0a20 203c . < │ │ │ +001eab30: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. . │ │ │ +001eab60: 203c 7469 746c 653e 5365 6520 416c 736f See Also │ │ │ +001eab70: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . udt_get( │ │ │ +001eabb0: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )

  • . < │ │ │ +001eabd0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>udt_defines_ │ │ │ +001eac10: 6669 656c 6428 293c 2f66 756e 6374 696f field() │ │ │ +001eac30: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . udt_inst │ │ │ +001eac70: 616e 6365 5f6f 6628 293c 2f66 756e 6374 ance_of().
  • │ │ │ +001eacd0: 7564 745f 696d 706c 656d 656e 7473 5f6d udt_implements_m │ │ │ +001eace0: 6574 686f 6428 293c 2f66 756e 6374 696f ethod() │ │ │ +001ead00: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ +001ead10: 2f72 6566 656e 7472 793e 0ab6 0000 0032 /refentry>.....2 │ │ │ +001ead20: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ +001ead30: 7265 662f 7370 6172 716c 5f72 6462 3272 ref/sparql_rdb2r │ │ │ +001ead40: 6466 5f6c 6973 745f 7461 626c 6573 2e78 df_list_tables.x │ │ │ +001ead50: 6d6c df00 000c 493c 3f78 6d6c 2076 6572 ml....I.. . │ │ │ +001eb8a0: 203c 7469 746c 653e 5365 6520 416c 736f See Also │ │ │ +001eb8b0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . RDB2RDF Trigg │ │ │ +001eb8f0: 6572 733c 2f6c 696e 6b3e 3c2f 7061 7261 ers . │ │ │ +001eb910: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c DB. │ │ │ +001eb950: 4442 412e 5350 4152 514c 5f52 4442 3252 DBA.SPARQL_RDB2R │ │ │ +001eb960: 4446 5f43 4f44 4547 454e 2829 3c2f 6675 DF_CODEGEN(). .. │ │ │ +001eb9a0: b600 0000 2064 656d 6f2f 646f 6373 7263 .... demo/docsrc │ │ │ +001eb9b0: 2f66 756e 6372 6566 2f68 7474 705f 6765 /funcref/http_ge │ │ │ +001eb9c0: 742e 786d 6cdf 0000 1630 3c3f 786d 6c20 t.xml....0... . │ │ │ +001ebd80: 2020 203c 7265 6665 6e74 7279 7469 746c http_get. < │ │ │ +001ebdb0: 7265 666d 6973 6369 6e66 6f3e 7773 3c2f refmiscinfo>ws. < │ │ │ +001ebdd0: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . http_get. returns │ │ │ +001ebe20: 2061 2076 6172 6368 6172 2063 6f6e 7461 a varchar conta │ │ │ +001ebe30: 696e 696e 6720 7468 6520 626f 6479 206f ining the body o │ │ │ +001ebe40: 6620 7468 6520 7265 7175 6573 7420 7572 f the request ur │ │ │ +001ebe50: 693c 2f72 6566 7075 7270 6f73 653e 0a20 i. │ │ │ +001ebe60: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +001ebe70: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . varchar http_get. in target_uri

    varcha │ │ │ +001ebf50: 723c 2f70 6172 616d 6465 663e 0a20 2020 r. │ │ │ +001ebf60: 2020 2020 203c 7061 7261 6d64 6566 3e3c < │ │ │ +001ebf70: 6f70 7469 6f6e 616c 3e6f 7574 203c 7061 optional>out return_h │ │ │ +001ebf90: 6561 6465 723c 2f70 6172 616d 6574 6572 eader any │ │ │ +001ebfb0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001ebfc0: 2020 2020 3c70 6172 616d 6465 663e 3c6f in http_metho │ │ │ +001ebff0: 643c 2f70 6172 616d 6574 6572 3e20 7661 d va │ │ │ +001ec000: 7263 6861 723c 2f6f 7074 696f 6e61 6c3e rchar │ │ │ +001ec010: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001ec020: 2020 2020 3c70 6172 616d 6465 663e 3c6f in request_he │ │ │ +001ec050: 6164 6572 3c2f 7061 7261 6d65 7465 723e ader │ │ │ +001ec060: 2076 6172 6368 6172 3c2f 6f70 7469 6f6e varchar. │ │ │ +001ec080: 2020 2020 2020 203c 7061 7261 6d64 6566 in

    request │ │ │ +001ec0b0: 5f62 6f64 793c 2f70 6172 616d 6574 6572 _body varchar. │ │ │ +001ec0e0: 2020 2020 2020 2020 3c70 6172 616d 6465 in < │ │ │ +001ec100: 7061 7261 6d65 7465 723e 7072 6f78 793c parameter>proxy< │ │ │ +001ec110: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ +001ec120: 6861 723c 2f6f 7074 696f 6e61 6c3e 3c2f har. │ │ │ +001ec140: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ +001ec150: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . D │ │ │ +001ec1a0: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ +001ec1b0: 653e 0a3c 7061 7261 3e68 7474 705f 6765 e>.<para>http_ge │ │ │ +001ec1c0: 7420 7265 7475 726e 7320 6120 7661 7263 t returns a varc │ │ │ +001ec1d0: 6861 7220 636f 6e74 6169 6e69 6e67 2074 har containing t │ │ │ +001ec1e0: 6865 2062 6f64 7920 6f66 2074 6865 0a72 he body of the.r │ │ │ +001ec1f0: 6571 7565 7374 6564 2074 6172 6765 745f equested target_ │ │ │ +001ec200: 7572 6920 6f72 204e 554c 4c20 6966 2074 uri or NULL if t │ │ │ +001ec210: 6865 2062 6f64 7920 6973 206e 6f74 2072 he body is not r │ │ │ +001ec220: 6563 6569 7665 642e 3c2f 7061 7261 3e0a eceived.</para>. │ │ │ +001ec230: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ +001ec240: 3c72 6566 7365 6374 3120 6964 3d22 7061 <refsect1 id="pa │ │ │ +001ec250: 7261 6d73 5f68 7474 705f 6765 7422 3e3c rams_http_get">< │ │ │ +001ec260: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ +001ec270: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . ta │ │ │ +001ec290: 7267 6574 5f75 7269 3c2f 7469 746c 653e rget_uri │ │ │ +001ec2a0: 0a3c 7061 7261 3e48 5454 5020 7461 7267 .HTTP targ │ │ │ +001ec2b0: 6574 2069 6e20 666f 726d 2068 7474 703a et in form http: │ │ │ +001ec2c0: 2f2f 266c 743b 7461 7267 6574 5f68 6f73 //<target_hos │ │ │ +001ec2d0: 7426 6774 3b3a 266c 743b 7461 7267 6574 t>:<target │ │ │ +001ec2e0: 5f70 6f72 7426 6774 3b2f 266c 743b 7061 _port>/<pa │ │ │ +001ec2f0: 7468 2667 743b 0a28 6966 2026 6c74 3b74 th>.(if <t │ │ │ +001ec300: 6172 6765 745f 706f 7274 2667 743b 2069 arget_port> i │ │ │ +001ec310: 7320 6e6f 7420 6769 7665 6e20 7468 656e s not given then │ │ │ +001ec320: 2038 3020 7769 6c6c 2062 6520 7573 6564 80 will be used │ │ │ +001ec330: 2062 7920 6465 6661 756c 7429 3c2f 7061 by default). │ │ │ +001ec350: 2020 203c 7265 6673 6563 7432 3e3c 7469 return_heade │ │ │ +001ec370: 723c 2f74 6974 6c65 3e0a 3c70 6172 613e r. │ │ │ +001ec380: 5468 6973 206f 7574 7075 7420 7061 7261 This output para │ │ │ +001ec390: 6d65 7465 7220 6973 2073 6574 2074 6f20 meter is set to │ │ │ +001ec3a0: 7468 6520 6172 7261 7920 6f66 2048 5454 the array of HTT │ │ │ +001ec3b0: 500a 7265 7370 6f6e 7365 2068 6561 6465 P.response heade │ │ │ +001ec3c0: 7220 6c69 6e65 7320 6672 6f6d 2074 6865 r lines from the │ │ │ +001ec3d0: 2074 6172 6765 7420 7365 7276 6572 2c20 target server, │ │ │ +001ec3e0: 6966 2074 6865 2070 6172 616d 6574 6572 if the parameter │ │ │ +001ec3f0: 2069 7320 6120 2063 6f6e 7374 616e 7420 is a constant │ │ │ +001ec400: 6974 2077 696c 6c20 6265 2069 676e 6f72 it will be ignor │ │ │ +001ec410: 6564 2e3c 2f70 6172 613e 3c2f 7265 6673 ed.. http_ │ │ │ +001ec440: 6d65 7468 6f64 3c2f 7469 746c 653e 0a3c method.< │ │ │ +001ec450: 7061 7261 3e54 6869 7320 7061 7261 6d65 para>This parame │ │ │ +001ec460: 7465 7220 7769 6c6c 2062 6520 7573 6564 ter will be used │ │ │ +001ec470: 2074 6f20 7370 6563 6966 7920 7468 6520 to specify the │ │ │ +001ec480: 4854 5450 2072 6571 7565 7374 206d 6574 HTTP request met │ │ │ +001ec490: 686f 642e 0a50 6f73 7369 626c 6520 7661 hod..Possible va │ │ │ +001ec4a0: 6c75 6573 2061 7265 3a20 4745 542c 2050 lues are: GET, P │ │ │ +001ec4b0: 4f53 542c 2050 5554 2c20 4f50 5449 4f4e OST, PUT, OPTION │ │ │ +001ec4c0: 5320 6f72 2073 6565 2052 4643 3236 3136 S or see RFC2616 │ │ │ +001ec4d0: 5b35 2e31 2e31 5d20 666f 720a 6465 7461 [5.1.1] for.deta │ │ │ +001ec4e0: 696c 732e 203c 2f70 6172 613e 3c2f 7265 ils. . req │ │ │ +001ec510: 7565 7374 5f68 6561 6465 723c 2f74 6974 uest_header</tit │ │ │ +001ec520: 6c65 3e0a 3c70 6172 613e 5468 6973 2073 le>.<para>This s │ │ │ +001ec530: 7472 696e 6720 7769 6c6c 2062 6520 7365 tring will be se │ │ │ +001ec540: 6e74 2074 6f20 7468 6520 7461 7267 6574 nt to the target │ │ │ +001ec550: 2073 6572 7665 7220 746f 6765 7468 6572 server together │ │ │ +001ec560: 2077 6974 6820 6f74 6865 720a 6865 6164 with other.head │ │ │ +001ec570: 6572 2066 6965 6c64 732e 2049 6620 6d6f er fields. If mo │ │ │ +001ec580: 7265 2074 6861 6e20 6f6e 6520 6865 6164 re than one head │ │ │ +001ec590: 6572 2066 6965 6c64 2073 686f 756c 6420 er field should │ │ │ +001ec5a0: 6265 2073 656e 7420 7468 656e 2068 6561 be sent then hea │ │ │ +001ec5b0: 6465 7220 6669 656c 6473 206d 7573 7420 der fields must │ │ │ +001ec5c0: 6265 2073 6570 6172 6174 6564 0a77 6974 be separated.wit │ │ │ +001ec5d0: 6820 4352 2f4c 4620 7061 6972 2e20 2857 h CR/LF pair. (W │ │ │ +001ec5e0: 6172 6e69 6e67 3a20 7468 6973 2073 7472 arning: this str │ │ │ +001ec5f0: 696e 6720 6d75 7374 206e 6f74 2062 6520 ing must not be │ │ │ +001ec600: 7465 726d 696e 6174 6564 2077 6974 6820 terminated with │ │ │ +001ec610: 4352 2f4c 4620 7061 6972 2129 2e3c 2f70 CR/LF pair!).</p │ │ │ +001ec620: 6172 613e 3c2f 7265 6673 6563 7432 3e0a ara></refsect2>. │ │ │ +001ec630: 2020 2020 3c72 6566 7365 6374 323e 3c74 <refsect2><t │ │ │ +001ec640: 6974 6c65 3e72 6571 7565 7374 5f62 6f64 itle>request_bod │ │ │ +001ec650: 793c 2f74 6974 6c65 3e0a 3c70 6172 613e y. │ │ │ +001ec660: 5468 6973 2073 7472 696e 6720 7769 6c6c This string will │ │ │ +001ec670: 2062 6520 7365 6e74 2074 6f20 7468 6520 be sent to the │ │ │ +001ec680: 7461 7267 6574 2073 6572 7665 7220 6173 target server as │ │ │ +001ec690: 2074 6865 2072 6571 7565 7374 2062 6f64 the request bod │ │ │ +001ec6a0: 792e 0a54 6865 2020 2671 756f 743b 436f y..The "Co │ │ │ +001ec6b0: 6e74 656e 742d 4c65 6e67 7468 2671 756f ntent-Length&quo │ │ │ +001ec6c0: 743b 2068 6561 6465 7220 6669 656c 6420 t; header field │ │ │ +001ec6d0: 6973 2073 6574 2074 6f20 7468 6520 6c65 is set to the le │ │ │ +001ec6e0: 6e67 7468 206f 6620 7468 6973 2073 7472 ngth of this str │ │ │ +001ec6f0: 696e 672e 3c2f 7061 7261 3e3c 2f72 6566 ing.. prox │ │ │ +001ec720: 793c 2f74 6974 6c65 3e0a 3c70 6172 613e y. │ │ │ +001ec730: 4966 2074 6869 7320 7061 7261 6d65 7465 If this paramete │ │ │ +001ec740: 7220 6973 2073 7570 706c 6965 6420 2074 r is supplied t │ │ │ +001ec750: 6865 2072 6571 7565 7374 2077 696c 6c20 he request will │ │ │ +001ec760: 6265 2070 6173 7365 6420 7468 726f 7567 be passed throug │ │ │ +001ec770: 6820 7468 6973 2048 5454 5020 7072 6f78 h this HTTP prox │ │ │ +001ec780: 792e 2054 6865 2066 6f72 6d61 7420 6973 y. The format is │ │ │ +001ec790: 2020 266c 743b 7072 6f78 795f 686f 7374 <proxy_host │ │ │ +001ec7a0: 2667 743b 3a26 6c74 3b70 726f 7879 5f70 >:<proxy_p │ │ │ +001ec7b0: 6f72 7426 6774 3b20 2e3c 2f70 6172 613e ort> . │ │ │ +001ec7c0: 0a20 2020 2020 203c 7061 7261 3e53 7570 . Sup │ │ │ +001ec7d0: 706f 7274 733a 3c2f 7061 7261 3e0a 3c70 ports:.

    ..

    .. In the INI file │ │ │ +001ec9a0: 2c20 696e 2073 6563 7469 6f6e 2048 5454 , in section HTT │ │ │ +001ec9b0: 5053 6572 7665 7220 7368 6f75 6c64 2062 PServer should b │ │ │ +001ec9c0: 6520 7365 743a 3c2f 7061 7261 3e0a 3c70 e set:.

    . │ │ │ +001eca60: 203c 7061 7261 3e45 7863 6570 7469 6f6e Exception │ │ │ +001eca70: 2063 6f75 6c64 2062 6520 616c 736f 2031 could be also 1 │ │ │ +001eca80: 3237 2e30 2e30 2e2a 2069 2e65 2e20 7468 27.0.0.* i.e. th │ │ │ +001eca90: 6572 6520 636f 756c 6420 6861 7665 2061 ere could have a │ │ │ +001ecaa0: 6c73 6f20 7769 6c64 6361 7264 2e3c 2f70 lso wildcard.

    ... . │ │ │ +001ecad0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Errors</ │ │ │ +001ecb00: 7469 746c 653e 0a20 2020 203c 7461 626c title>. <tabl │ │ │ +001ecb10: 653e 3c74 6974 6c65 3e45 7272 6f72 7320 e><title>Errors │ │ │ +001ecb20: 7369 676e 616c 6c65 6420 6279 3c2f 7469 signalled by</ti │ │ │ +001ecb30: 746c 653e 0a20 2020 2020 203c 7467 726f tle>. <tgro │ │ │ +001ecb40: 7570 2063 6f6c 733d 2234 223e 0a20 2020 up cols="4">. │ │ │ +001ecb50: 2020 2020 3c74 6865 6164 3e3c 726f 773e <thead><row> │ │ │ +001ecb60: 3c65 6e74 7279 3e53 514c 5374 6174 653c <entry>SQLState< │ │ │ +001ecb70: 2f65 6e74 7279 3e3c 656e 7472 793e 4572 /entry><entry>Er │ │ │ +001ecb80: 726f 7220 436f 6465 3c2f 656e 7472 793e ror Code</entry> │ │ │ +001ecb90: 3c65 6e74 7279 3e45 7272 6f72 2054 6578 <entry>Error Tex │ │ │ +001ecba0: 743c 2f65 6e74 7279 3e3c 656e 7472 793e t</entry><entry> │ │ │ +001ecbb0: 4465 7363 7269 7074 696f 6e3c 2f65 6e74 Description</ent │ │ │ +001ecbc0: 7279 3e3c 2f72 6f77 3e3c 2f74 6865 6164 ry></row></thead │ │ │ +001ecbd0: 3e0a 093c 7462 6f64 793e 0a09 2020 3c72 >..<tbody>.. <r │ │ │ +001ecbe0: 6f77 3e0a 0920 2020 203c 656e 7472 793e ow>.. <entry> │ │ │ +001ecbf0: 3c65 7272 6f72 636f 6465 3e3c 2f65 7272 <errorcode></err │ │ │ +001ecc00: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ +001ecc10: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ +001ecc20: 6f72 636f 6465 3e48 5430 3031 203c 2f65 orcode>HT001 </e │ │ │ +001ecc30: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +001ecc40: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +001ecc50: 7272 6f72 6e61 6d65 3e4e 6f74 2076 616c rrorname>Not val │ │ │ +001ecc60: 6964 2068 6f73 7420 6e61 6d65 206f 7220 id host name or │ │ │ +001ecc70: 686f 7374 2049 5020 6164 6472 6573 733c host IP address< │ │ │ +001ecc80: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ +001ecc90: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ +001ecca0: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f </entry>.. </ro │ │ │ +001eccb0: 773e 0a09 2020 3c72 6f77 3e0a 0920 2020 w>.. <row>.. │ │ │ +001eccc0: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ +001eccd0: 6465 3e3c 2f65 7272 6f72 636f 6465 3e3c de></errorcode>< │ │ │ +001ecce0: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ +001eccf0: 7472 793e 3c65 7272 6f72 636f 6465 3e48 try><errorcode>H │ │ │ +001ecd00: 5430 3032 203c 2f65 7272 6f72 636f 6465 T002 </errorcode │ │ │ +001ecd10: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ +001ecd20: 656e 7472 793e 3c65 7272 6f72 6e61 6d65 entry><errorname │ │ │ +001ecd30: 3e54 6172 6765 7420 686f 7374 2069 7320 >Target host is │ │ │ +001ecd40: 756e 7265 6163 6861 626c 653c 2f65 7272 unreachable</err │ │ │ +001ecd50: 6f72 6e61 6d65 3e3c 2f65 6e74 7279 3e0a orname></entry>. │ │ │ +001ecd60: 0920 2020 203c 656e 7472 793e 3c2f 656e . <entry></en │ │ │ +001ecd70: 7472 793e 0a09 2020 3c2f 726f 773e 0a09 try>.. </row>.. │ │ │ +001ecd80: 3c2f 7462 6f64 793e 0a20 2020 2020 203c </tbody>. < │ │ │ +001ecd90: 2f74 6772 6f75 703e 0a20 2020 203c 2f74 /tgroup>. </t │ │ │ +001ecda0: 6162 6c65 3e0a 2020 3c2f 7265 6673 6563 able>. </refsec │ │ │ +001ecdb0: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +001ecdc0: 6964 3d22 6578 616d 706c 6573 5f68 7474 id="examples_htt │ │ │ +001ecdd0: 705f 6765 7422 3e3c 7469 746c 653e 4578 p_get"><title>Ex │ │ │ +001ecde0: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ +001ecdf0: 203c 6578 616d 706c 6520 6964 3d22 6578 Using http_get │ │ │ +001ece20: 2829 3c2f 7469 746c 653e 0a3c 7072 6f67 ()..decl │ │ │ +001ece40: 6172 6520 6865 6164 6572 2061 6e79 3b0a are header any;. │ │ │ +001ece50: 7061 6765 203a 3d20 6874 7470 5f67 6574 page := http_get │ │ │ +001ece60: 2028 2768 7474 703a 2f2f 7777 772e 6f70 ('http://www.op │ │ │ +001ece70: 656e 6c69 6e6b 7377 2e63 6f6d 2f27 293b enlinksw.com/'); │ │ │ +001ece80: 0a2e 2e2e 0a70 6167 6520 3a3d 2068 7474 .....page := htt │ │ │ +001ece90: 705f 6765 7420 2827 6874 7470 3a2f 2f77 p_get ('http://w │ │ │ +001ecea0: 7777 2e6f 7065 6e6c 696e 6b73 772e 636f ww.openlinksw.co │ │ │ +001eceb0: 6d2f 272c 0a09 0968 6561 6465 722c 2027 m/',...header, ' │ │ │ +001ecec0: 4745 5427 2c20 2749 662d 4d6f 6469 6669 GET', 'If-Modifi │ │ │ +001eced0: 6564 2d53 696e 6365 3a20 4672 692c 2032 ed-Since: Fri, 2 │ │ │ +001ecee0: 3120 4a75 6c20 3230 3030 2031 313a 3139 1 Jul 2000 11:19 │ │ │ +001ecef0: 3a34 3520 474d 5427 293b 0a2e 2e2e 0a70 :45 GMT');.....p │ │ │ +001ecf00: 6167 6520 3a3d 2068 7474 705f 6765 7420 age := http_get │ │ │ +001ecf10: 2827 6874 7470 3a2f 2f65 7861 6d70 6c65 ('http://example │ │ │ +001ecf20: 2e63 6f6d 2f73 6f6d 655f 6c69 6e6b 2e68 .com/some_link.h │ │ │ +001ecf30: 746d 6c27 2c0a 0909 6865 6164 6572 2c20 tml',...header, │ │ │ +001ecf40: 2750 4f53 5427 2c20 2727 2c20 2761 3d31 'POST', '', 'a=1 │ │ │ +001ecf50: 2661 6d70 3b62 3d32 2729 3b0a 2e2e 2e0a &b=2');..... │ │ │ +001ecf60: 7061 6765 203a 3d20 6874 7470 5f67 6574 page := http_get │ │ │ +001ecf70: 2028 2768 7474 703a 2f2f 7777 772e 6f70 ('http://www.op │ │ │ +001ecf80: 656e 6c69 6e6b 7377 2e63 6f6d 2f27 2c0a enlinksw.com/',. │ │ │ +001ecf90: 0909 4e55 4c4c 2c20 2747 4554 272c 2027 ..NULL, 'GET', ' │ │ │ +001ecfa0: 272c 2027 272c 2027 7072 6f78 792e 7365 ', '', 'proxy.se │ │ │ +001ecfb0: 7276 6572 2e63 6f6d 3a38 3038 3027 293b rver.com:8080'); │ │ │ +001ecfc0: 0a3c 2f70 726f 6772 616d 6c69 7374 696e ... │ │ │ +001ecfe0: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 .
    .......)d │ │ │ +001ed000: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ +001ed010: 6566 2f63 6667 5f73 6563 7469 6f6e 5f63 ef/cfg_section_c │ │ │ +001ed020: 6f75 6e74 2e78 6d6c df00 000b ce3c 3f78 ount.xml........ │ │ │ +001ed3e0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ +001ed3f0: 3c72 6566 656e 7472 7974 6974 6c65 3e63 c │ │ │ +001ed400: 6667 5f73 6563 7469 6f6e 5f63 6f75 6e74 fg_section_count │ │ │ +001ed410: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ +001ed420: 0a20 2020 203c 7265 666d 6973 6369 6e66 . admin. . . c │ │ │ +001ed470: 6667 5f73 6563 7469 6f6e 5f63 6f75 6e74 fg_section_count │ │ │ +001ed480: 3c2f 7265 666e 616d 653e 0a20 2020 203c . < │ │ │ +001ed490: 7265 6670 7572 706f 7365 3e67 6574 206e refpurpose>get n │ │ │ +001ed4a0: 756d 6265 7220 6f66 2073 6563 7469 6f6e umber of section │ │ │ +001ed4b0: 7320 696e 2061 6e20 494e 4920 6669 6c65 s in an INI file │ │ │ +001ed4c0: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ +001ed4d0: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +001ed4e0: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ +001ed4f0: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . │ │ │ +001ed520: 2020 2020 2020 3c66 756e 6370 726f 746f . c │ │ │ +001ed570: 6667 5f73 6563 7469 6f6e 5f63 6f75 6e74 fg_section_count │ │ │ +001ed580: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e .

    in path varchar. │ │ │ +001ed5e0: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ +001ed5f0: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . Description< │ │ │ +001ed650: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. Returns the nu │ │ │ +001ed670: 6d62 6572 206f 6620 7365 6374 696f 6e73 mber of sections │ │ │ +001ed680: 2069 6e20 616e 2049 4e49 2066 696c 652e in an INI file. │ │ │ +001ed690: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . Parameters. path< │ │ │ +001ed700: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +001ed710: 6172 613e 4e61 6d65 206f 6620 7468 6520 ara>Name of the │ │ │ +001ed720: 494e 4920 6669 6c65 2e3c 2f70 6172 613e INI file.</para> │ │ │ +001ed730: 0a20 2020 203c 2f72 6566 7365 6374 323e . </refsect2> │ │ │ +001ed740: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ +001ed750: 203c 7265 6673 6563 7431 2069 643d 2272 <refsect1 id="r │ │ │ +001ed760: 6574 5f73 6563 7469 6f6e 5f63 6f75 6e74 et_section_count │ │ │ +001ed770: 223e 3c74 6974 6c65 3e52 6574 7572 6e20 "><title>Return │ │ │ +001ed780: 5661 6c75 6573 3c2f 7469 746c 653e 0a20 Values. │ │ │ +001ed790: 2020 203c 7061 7261 3e41 6e20 3c74 7970 An integer │ │ │ +001ed7b0: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ +001ed7c0: 6e75 6d62 6572 206f 6620 7365 6374 696f number of sectio │ │ │ +001ed7d0: 6e73 0a20 2020 2069 6e20 7468 6520 494e ns. in the IN │ │ │ +001ed7e0: 4920 6669 6c65 2e3c 2f70 6172 613e 0a20 I file.. │ │ │ +001ed7f0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001ed800: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ +001ed810: 6d70 6c65 735f 7365 6374 696f 6e5f 636f mples_section_co │ │ │ +001ed820: 756e 7422 3e3c 7469 746c 653e 4578 616d unt">Exam │ │ │ +001ed830: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ +001ed840: 203c 6578 616d 706c 6520 6964 3d22 6578 Simpl │ │ │ +001ed870: 6520 6578 616d 706c 6573 3c2f 7469 746c e examples</titl │ │ │ +001ed880: 653e 0a20 2020 2020 203c 7061 7261 3e46 e>. <para>F │ │ │ +001ed890: 696e 6420 6f75 7420 686f 7720 6d61 6e79 ind out how many │ │ │ +001ed8a0: 2073 6563 7469 6f6e 7320 6172 6520 696e sections are in │ │ │ +001ed8b0: 2074 6865 2063 7572 7265 6e74 2076 6972 the current vir │ │ │ +001ed8c0: 7475 6f73 6f2e 696e 6920 6669 6c65 2e3c tuoso.ini file.< │ │ │ +001ed8d0: 2f70 6172 613e 0a20 2020 2020 203c 7363 /para>. <sc │ │ │ +001ed8e0: 7265 656e 3e0a 5351 4c3e 2073 656c 6563 reen>.SQL> selec │ │ │ +001ed8f0: 7420 6366 675f 7365 6374 696f 6e5f 636f t cfg_section_co │ │ │ +001ed900: 756e 7428 7669 7274 756f 736f 5f69 6e69 unt(virtuoso_ini │ │ │ +001ed910: 5f70 6174 6828 2929 3b0a 6361 6c6c 7265 _path());.callre │ │ │ +001ed920: 740a 494e 5445 4745 520a 5f5f 5f5f 5f5f t.INTEGER.______ │ │ │ +001ed930: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001ed940: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001ed950: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ +001ed960: 373c 2f73 6372 6565 6e3e 0a20 2020 203c 7</screen>. < │ │ │ +001ed970: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. </re │ │ │ +001ed980: 6673 6563 7431 3e0a 2020 3c72 6566 7365 fsect1>. <refse │ │ │ +001ed990: 6374 3120 6964 3d22 7365 6561 6c73 6f5f ct1 id="seealso_ │ │ │ +001ed9a0: 7365 6374 696f 6e5f 636f 756e 7422 3e3c section_count">< │ │ │ +001ed9b0: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also</ │ │ │ +001ed9c0: 7469 746c 653e 0a20 2020 203c 7061 7261 title>. <para │ │ │ +001ed9d0: 3e0a 2020 2020 2020 3c6c 696e 6b20 6c69 >. <link li │ │ │ +001ed9e0: 6e6b 656e 643d 2266 6e5f 7669 7274 756f nkend="fn_virtuo │ │ │ +001ed9f0: 736f 5f69 6e69 5f70 6174 6822 3e3c 6675 so_ini_path"><fu │ │ │ +001eda00: 6e63 7469 6f6e 3e76 6972 7475 6f73 6f5f nction>virtuoso_ │ │ │ +001eda10: 696e 695f 7061 7468 3c2f 6675 6e63 7469 ini_path</functi │ │ │ +001eda20: 6f6e 3e3c 2f6c 696e 6b3e 2020 200a 2020 on></link> . │ │ │ +001eda30: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e <link linken │ │ │ +001eda40: 643d 2266 6e5f 6366 675f 7365 6374 696f d="fn_cfg_sectio │ │ │ +001eda50: 6e5f 6e61 6d65 223e 3c66 756e 6374 696f n_name"><functio │ │ │ +001eda60: 6e3e 6366 675f 7365 6374 696f 6e5f 6e61 n>cfg_section_na │ │ │ +001eda70: 6d65 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c me</function></l │ │ │ +001eda80: 696e 6b3e 2020 200a 2020 2020 2020 3c6c ink> . <l │ │ │ +001eda90: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001edaa0: 6366 675f 6974 656d 5f63 6f75 6e74 223e cfg_item_count"> │ │ │ +001edab0: 3c66 756e 6374 696f 6e3e 6366 675f 6974 <function>cfg_it │ │ │ +001edac0: 656d 5f63 6f75 6e74 3c2f 6675 6e63 7469 em_count</functi │ │ │ +001edad0: 6f6e 3e3c 2f6c 696e 6b3e 2020 200a 2020 on></link> . │ │ │ +001edae0: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e <link linken │ │ │ +001edaf0: 643d 2266 6e5f 6366 675f 6974 656d 5f6e d="fn_cfg_item_n │ │ │ +001edb00: 616d 6522 3e3c 6675 6e63 7469 6f6e 3e63 ame"><function>c │ │ │ +001edb10: 6667 5f69 7465 6d5f 6e61 6d65 3c2f 6675 fg_item_name</fu │ │ │ +001edb20: 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e 2020 nction></link> │ │ │ +001edb30: 200a 2020 2020 2020 3c6c 696e 6b20 6c69 . <link li │ │ │ +001edb40: 6e6b 656e 643d 2266 6e5f 6366 675f 6974 nkend="fn_cfg_it │ │ │ +001edb50: 656d 5f76 616c 7565 223e 3c66 756e 6374 em_value"><funct │ │ │ +001edb60: 696f 6e3e 6366 675f 6974 656d 5f76 616c ion>cfg_item_val │ │ │ +001edb70: 7565 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ue</function></l │ │ │ +001edb80: 696e 6b3e 2020 200a 2020 2020 2020 3c6c ink> . <l │ │ │ +001edb90: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001edba0: 6366 675f 7772 6974 6522 3e3c 6675 6e63 cfg_write"><func │ │ │ +001edbb0: 7469 6f6e 3e63 6667 5f77 7269 7465 3c2f tion>cfg_write</ │ │ │ +001edbc0: 6675 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e function></link> │ │ │ +001edbd0: 2020 200a 2020 2020 3c2f 7061 7261 3e0a . </para>. │ │ │ +001edbe0: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f </refsect1>.</ │ │ │ +001edbf0: 7265 6665 6e74 7279 3e0a 0ab6 0000 0020 refentry>...... │ │ │ +001edc00: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ +001edc10: 7265 662f 6f73 5f63 686d 6f64 2e78 6d6c ref/os_chmod.xml │ │ │ +001edc20: df00 0011 ab3c 3f78 6d6c 2076 6572 7369 .....<?xml versi │ │ │ +001edc30: 6f6e 3d22 312e 3022 2065 6e63 6f64 696e on="1.0" encodin │ │ │ +001edc40: 673d 2249 534f 2d38 3835 392d 3122 3f3e g="ISO-8859-1"?> │ │ │ +001edc50: 0a3c 212d 2d0a 202d 2020 0a20 2d20 2054 .<!--. - . - T │ │ │ +001edc60: 6869 7320 6669 6c65 2069 7320 7061 7274 his file is part │ │ │ +001edc70: 206f 6620 7468 6520 4f70 656e 4c69 6e6b of the OpenLink │ │ │ +001edc80: 2053 6f66 7477 6172 6520 5669 7274 756f Software Virtuo │ │ │ +001edc90: 736f 204f 7065 6e2d 536f 7572 6365 2028 so Open-Source ( │ │ │ +001edca0: 564f 5329 0a20 2d20 2070 726f 6a65 6374 VOS). - project │ │ │ +001edcb0: 2e0a 202d 2020 0a20 2d20 2043 6f70 7972 .. - . - Copyr │ │ │ +001edcc0: 6967 6874 2028 4329 2031 3939 382d 3230 ight (C) 1998-20 │ │ │ +001edcd0: 3234 204f 7065 6e4c 696e 6b20 536f 6674 24 OpenLink Soft │ │ │ +001edce0: 7761 7265 0a20 2d20 200a 202d 2020 5468 ware. - . - Th │ │ │ +001edcf0: 6973 2070 726f 6a65 6374 2069 7320 6672 is project is fr │ │ │ +001edd00: 6565 2073 6f66 7477 6172 653b 2079 6f75 ee software; you │ │ │ +001edd10: 2063 616e 2072 6564 6973 7472 6962 7574 can redistribut │ │ │ +001edd20: 6520 6974 2061 6e64 2f6f 7220 6d6f 6469 e it and/or modi │ │ │ +001edd30: 6679 2069 740a 202d 2020 756e 6465 7220 fy it. - under │ │ │ +001edd40: 7468 6520 7465 726d 7320 6f66 2074 6865 the terms of the │ │ │ +001edd50: 2047 4e55 2047 656e 6572 616c 2050 7562 GNU General Pub │ │ │ +001edd60: 6c69 6320 4c69 6365 6e73 6520 6173 2070 lic License as p │ │ │ +001edd70: 7562 6c69 7368 6564 2062 7920 7468 650a ublished by the. │ │ │ +001edd80: 202d 2020 4672 6565 2053 6f66 7477 6172 - Free Softwar │ │ │ +001edd90: 6520 466f 756e 6461 7469 6f6e 3b20 6f6e e Foundation; on │ │ │ +001edda0: 6c79 2076 6572 7369 6f6e 2032 206f 6620 ly version 2 of │ │ │ +001eddb0: 7468 6520 4c69 6365 6e73 652c 2064 6174 the License, dat │ │ │ +001eddc0: 6564 204a 756e 6520 3139 3931 2e0a 202d ed June 1991.. - │ │ │ +001eddd0: 2020 0a20 2d20 2054 6869 7320 7072 6f67 . - This prog │ │ │ +001edde0: 7261 6d20 6973 2064 6973 7472 6962 7574 ram is distribut │ │ │ +001eddf0: 6564 2069 6e20 7468 6520 686f 7065 2074 ed in the hope t │ │ │ +001ede00: 6861 7420 6974 2077 696c 6c20 6265 2075 hat it will be u │ │ │ +001ede10: 7365 6675 6c2c 2062 7574 0a20 2d20 2057 seful, but. - W │ │ │ +001ede20: 4954 484f 5554 2041 4e59 2057 4152 5241 ITHOUT ANY WARRA │ │ │ +001ede30: 4e54 593b 2077 6974 686f 7574 2065 7665 NTY; without eve │ │ │ +001ede40: 6e20 7468 6520 696d 706c 6965 6420 7761 n the implied wa │ │ │ +001ede50: 7272 616e 7479 206f 660a 202d 2020 4d45 rranty of. - ME │ │ │ +001ede60: 5243 4841 4e54 4142 494c 4954 5920 6f72 RCHANTABILITY or │ │ │ +001ede70: 2046 4954 4e45 5353 2046 4f52 2041 2050 FITNESS FOR A P │ │ │ +001ede80: 4152 5449 4355 4c41 5220 5055 5250 4f53 ARTICULAR PURPOS │ │ │ +001ede90: 452e 2053 6565 2074 6865 2047 4e55 0a20 E. See the GNU. │ │ │ +001edea0: 2d20 2047 656e 6572 616c 2050 7562 6c69 - General Publi │ │ │ +001edeb0: 6320 4c69 6365 6e73 6520 666f 7220 6d6f c License for mo │ │ │ +001edec0: 7265 2064 6574 6169 6c73 2e0a 202d 2020 re details.. - │ │ │ +001eded0: 0a20 2d20 2059 6f75 2073 686f 756c 6420 . - You should │ │ │ +001edee0: 6861 7665 2072 6563 6569 7665 6420 6120 have received a │ │ │ +001edef0: 636f 7079 206f 6620 7468 6520 474e 5520 copy of the GNU │ │ │ +001edf00: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ +001edf10: 6963 656e 7365 2061 6c6f 6e67 0a20 2d20 icense along. - │ │ │ +001edf20: 2077 6974 6820 7468 6973 2070 726f 6772 with this progr │ │ │ +001edf30: 616d 3b20 6966 206e 6f74 2c20 7772 6974 am; if not, writ │ │ │ +001edf40: 6520 746f 2074 6865 2046 7265 6520 536f e to the Free So │ │ │ +001edf50: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ +001edf60: 6e2c 2049 6e63 2e2c 0a20 2d20 2035 3120 n, Inc.,. - 51 │ │ │ +001edf70: 4672 616e 6b6c 696e 2053 742c 2046 6966 Franklin St, Fif │ │ │ +001edf80: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e th Floor, Boston │ │ │ +001edf90: 2c20 4d41 2030 3231 3130 2d31 3330 3120 , MA 02110-1301 │ │ │ +001edfa0: 5553 410a 202d 2020 0a20 2d20 200a 2d2d USA. - . - .-- │ │ │ +001edfb0: 3e0a 3c72 6566 656e 7472 7920 6964 3d22 >.<refentry id=" │ │ │ +001edfc0: 666e 5f6f 735f 6368 6d6f 6422 3e0a 2020 fn_os_chmod">. │ │ │ +001edfd0: 2020 3c72 6566 6d65 7461 3e0a 093c 7265 <refmeta>..<re │ │ │ +001edfe0: 6665 6e74 7279 7469 746c 653e 6f73 5f63 fentrytitle>os_c │ │ │ +001edff0: 686d 6f64 3c2f 7265 6665 6e74 7279 7469 hmod</refentryti │ │ │ +001ee000: 746c 653e 0a09 3c72 6566 6d69 7363 696e tle>..<refmiscin │ │ │ +001ee010: 666f 3e66 696c 653c 2f72 6566 6d69 7363 fo>file</refmisc │ │ │ +001ee020: 696e 666f 3e0a 2020 2020 3c2f 7265 666d info>. </refm │ │ │ +001ee030: 6574 613e 0a20 2020 203c 7265 666e 616d eta>. <refnam │ │ │ +001ee040: 6564 6976 3e0a 093c 7265 666e 616d 653e ediv>..<refname> │ │ │ +001ee050: 6f73 5f63 686d 6f64 3c2f 7265 666e 616d os_chmod</refnam │ │ │ +001ee060: 653e 0a09 3c72 6566 7075 7270 6f73 653e e>..<refpurpose> │ │ │ +001ee070: 6368 616e 6765 7320 7468 6520 6669 6c65 changes the file │ │ │ +001ee080: 2061 6363 6573 7320 6d6f 6465 206f 6620 access mode of │ │ │ +001ee090: 6120 6669 6c65 3c2f 7265 6670 7572 706f a file</refpurpo │ │ │ +001ee0a0: 7365 3e0a 2020 2020 3c2f 7265 666e 616d se>. </refnam │ │ │ +001ee0b0: 6564 6976 3e0a 2020 2020 3c72 6566 7379 ediv>. <refsy │ │ │ +001ee0c0: 6e6f 7073 6973 6469 763e 0a09 3c66 756e nopsisdiv>..<fun │ │ │ +001ee0d0: 6373 796e 6f70 7369 7320 6964 3d22 6673 csynopsis id="fs │ │ │ +001ee0e0: 796e 5f6f 735f 6368 6d6f 6422 3e0a 0920 yn_os_chmod">.. │ │ │ +001ee0f0: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ +001ee100: 6520 6964 3d22 6670 726f 746f 5f6f 735f e id="fproto_os_ │ │ │ +001ee110: 6368 6d6f 6422 3e0a 0909 3c66 756e 6364 chmod">...<funcd │ │ │ +001ee120: 6566 3e3c 6675 6e63 7469 6f6e 3e6f 735f ef><function>os_ │ │ │ +001ee130: 6368 6d6f 643c 2f66 756e 6374 696f 6e3e chmod</function> │ │ │ +001ee140: 3c2f 6675 6e63 6465 663e 0a09 093c 7061 </funcdef>...<pa │ │ │ +001ee150: 7261 6d64 6566 3e69 6e20 3c70 6172 616d ramdef>in <param │ │ │ +001ee160: 6574 6572 3e70 6174 683c 2f70 6172 616d eter>path</param │ │ │ +001ee170: 6574 6572 3e20 7661 7263 6861 723c 2f70 eter> varchar</p │ │ │ +001ee180: 6172 616d 6465 663e 0a09 093c 7061 7261 aramdef>...<para │ │ │ +001ee190: 6d64 6566 3e69 6e20 3c70 6172 616d 6574 mdef>in <paramet │ │ │ +001ee1a0: 6572 3e6e 6577 5f6d 6f64 3c2f 7061 7261 er>new_mod</para │ │ │ +001ee1b0: 6d65 7465 723e 2069 6e74 6567 6572 3c2f meter> integer</ │ │ │ +001ee1c0: 7061 7261 6d64 6566 3e0a 0920 2020 203c paramdef>.. < │ │ │ +001ee1d0: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ +001ee1e0: 093c 2f66 756e 6373 796e 6f70 7369 733e .</funcsynopsis> │ │ │ +001ee1f0: 0a20 2020 203c 2f72 6566 7379 6e6f 7073 . </refsynops │ │ │ +001ee200: 6973 6469 763e 0a20 2020 203c 7265 6673 isdiv>. <refs │ │ │ +001ee210: 6563 7431 2069 643d 2264 6573 6322 3e3c ect1 id="desc">< │ │ │ +001ee220: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ +001ee230: 6e3c 2f74 6974 6c65 3e0a 093c 7061 7261 n..os_ch │ │ │ +001ee250: 6d6f 643c 2f66 756e 6374 696f 6e3e 2073 mod s │ │ │ +001ee260: 6574 2074 6865 2066 696c 6520 6d6f 6465 et the file mode │ │ │ +001ee270: 2062 6974 730a 0920 2020 2062 7920 6361 bits.. by ca │ │ │ +001ee280: 6c6c 696e 6720 7468 6520 7379 7374 656d lling the system │ │ │ +001ee290: 2066 756e 6374 696f 6e20 6368 6d6f 6428 function chmod( │ │ │ +001ee2a0: 2920 7769 7468 2074 6865 2061 7267 756d ) with the argum │ │ │ +001ee2b0: 656e 7473 2073 7570 706c 6965 642e 3c2f ents supplied...Not │ │ │ +001ee2d0: 2061 6c6c 2074 6865 2068 6f73 7420 4f53 all the host OS │ │ │ +001ee2e0: 6573 2073 7570 706f 7274 2061 6c6c 2074 es support all t │ │ │ +001ee2f0: 6865 2066 696c 6520 6d6f 6465 732e 2054 he file modes. T │ │ │ +001ee300: 6861 7427 7320 7768 7920 7468 6520 6675 hat's why the fu │ │ │ +001ee310: 6e63 7469 6f6e 0a09 2020 2020 7769 6c6c nction.. will │ │ │ +001ee320: 206e 6f74 2074 6872 6f77 2061 6e20 5351 not throw an SQ │ │ │ +001ee330: 4c20 6572 726f 7220 6966 2074 6865 2066 L error if the f │ │ │ +001ee340: 756e 6374 696f 6e20 6661 696c 732e 3c2f unction fails...It │ │ │ +001ee360: 7769 6c6c 2072 6574 7572 6e20 4442 204e will return DB N │ │ │ +001ee370: 554c 4c20 7661 6c75 6520 7768 656e 2074 ULL value when t │ │ │ +001ee380: 6865 2066 756e 6374 696f 6e20 7761 7320 he function was │ │ │ +001ee390: 6361 6c6c 6564 2073 7563 6365 7373 6675 called successfu │ │ │ +001ee3a0: 6c6c 790a 0920 2020 2061 6e64 2074 6865 lly.. and the │ │ │ +001ee3b0: 2065 7272 6f72 206d 6573 7361 6765 2061 error message a │ │ │ +001ee3c0: 7320 6120 7374 7269 6e67 2069 6620 6974 s a string if it │ │ │ +001ee3d0: 2066 6169 6c65 642e 3c2f 7061 7261 3e0a failed.. │ │ │ +001ee3e0: 093c 7061 7261 3e49 6e20 6d6f 7374 204f .In most O │ │ │ +001ee3f0: 5365 7320 7468 6520 6d6f 6465 2069 7320 Ses the mode is │ │ │ +001ee400: 6120 6269 746d 6173 6b2c 2073 6f20 6f6e a bitmask, so on │ │ │ +001ee410: 6520 776f 756c 6420 7573 7561 6c6c 7920 e would usually │ │ │ +001ee420: 7573 6520 7468 650a 0920 2020 203c 6675 use the.. file_stat │ │ │ +001ee440: 3c2f 6675 6e63 7469 6f6e 3e20 746f 2067 to g │ │ │ +001ee450: 6574 2074 6865 2063 7572 7265 6e74 206d et the current m │ │ │ +001ee460: 6f64 6520 616e 640a 0920 2020 203c 6675 ode and.. bit_or/bit_xor to make th │ │ │ +001ee4b0: 6520 6e65 770a 0920 2020 206d 6f64 652e e new.. mode. │ │ │ +001ee4c0: 3c2f 7061 7261 3e0a 093c 7061 7261 3e54 ..T │ │ │ +001ee4d0: 7970 6963 616c 2062 6974 206c 6179 6f75 ypical bit layou │ │ │ +001ee4e0: 7420 2866 726f 6d20 4c69 6e75 7820 276d t (from Linux 'm │ │ │ +001ee4f0: 616e 2032 2063 686d 6f64 2729 2069 7320 an 2 chmod') is │ │ │ +001ee500: 3a0a 2020 2020 2020 2020 3c73 696d 706c :. .. bit 0 (mask │ │ │ +001ee530: 3129 202d 2065 7865 6375 7465 2f73 6561 1) - execute/sea │ │ │ +001ee540: 7263 6820 6279 206f 7468 6572 7320 3c2f rch by others .. bit 1 (mask │ │ │ +001ee570: 2032 2920 2d20 7772 6974 6520 6279 206f 2) - write by o │ │ │ +001ee580: 7468 6572 7320 3c2f 6d65 6d62 6572 3e0a thers . │ │ │ +001ee590: 0920 2020 203c 6d65 6d62 6572 3e62 6974 . bit │ │ │ +001ee5a0: 2032 2028 6d61 736b 2034 2920 2d20 7265 2 (mask 4) - re │ │ │ +001ee5b0: 6164 2062 7920 6f74 6865 7273 203c 2f6d ad by others .. bit 3 (mask │ │ │ +001ee5e0: 3829 202d 2065 7865 6375 7465 2f73 6561 8) - execute/sea │ │ │ +001ee5f0: 7263 6820 6279 2067 726f 7570 203c 2f6d rch by group .. bit 4 (mask │ │ │ +001ee620: 3136 2920 2d20 7772 6974 6520 6279 2067 16) - write by g │ │ │ +001ee630: 726f 7570 203c 2f6d 656d 6265 723e 0a09 roup .. │ │ │ +001ee640: 2020 2020 3c6d 656d 6265 723e 6269 7420 bit │ │ │ +001ee650: 3520 286d 6173 6b20 3332 2920 2d20 7265 5 (mask 32) - re │ │ │ +001ee660: 6164 2062 7920 6772 6f75 7020 3c2f 6d65 ad by group .. bit 6 (mask 6 │ │ │ +001ee690: 3429 202d 2065 7865 6375 7465 2f73 6561 4) - execute/sea │ │ │ +001ee6a0: 7263 6820 6279 206f 776e 6572 203c 2f6d rch by owner .. bit 7 (mask │ │ │ +001ee6d0: 3132 3829 202d 2077 7269 7465 2062 7920 128) - write by │ │ │ +001ee6e0: 6f77 6e65 7220 3c2f 6d65 6d62 6572 3e0a owner . │ │ │ +001ee6f0: 0920 2020 203c 6d65 6d62 6572 3e62 6974 . bit │ │ │ +001ee700: 2038 2028 6d61 736b 2032 3536 2920 2d20 8 (mask 256) - │ │ │ +001ee710: 7265 6164 2062 7920 6f77 6e65 7220 3c2f read by owner .. bit 9 (mask │ │ │ +001ee740: 2035 3132 2920 2d20 7374 6963 6b79 2062 512) - sticky b │ │ │ +001ee750: 6974 203c 2f6d 656d 6265 723e 0a09 2020 it .. │ │ │ +001ee760: 2020 3c6d 656d 6265 723e 6269 7420 3130 bit 10 │ │ │ +001ee770: 2028 6d61 736b 2031 3032 3429 202d 2073 (mask 1024) - s │ │ │ +001ee780: 6574 2067 726f 7570 2049 4420 6f6e 2065 et group ID on e │ │ │ +001ee790: 7865 6375 7469 6f6e 203c 2f6d 656d 6265 xecution .. │ │ │ +001ee7b0: 6269 7420 3132 2028 6d61 736b 2032 3034 bit 12 (mask 204 │ │ │ +001ee7c0: 3829 202d 2073 6574 2075 7365 7220 4944 8) - set user ID │ │ │ +001ee7d0: 206f 6e20 6578 6563 7574 696f 6e20 3c2f on execution ..... │ │ │ +001ee800: 0a09 3c70 6172 613e 5468 6520 4469 7273 ..The Dirs │ │ │ +001ee810: 416c 6c6f 7765 6420 616e 6420 4469 7273 Allowed and Dirs │ │ │ +001ee820: 4465 6e69 6564 206c 6973 7473 2069 6e20 Denied lists in │ │ │ +001ee830: 5061 7261 6d65 7465 7273 2073 6563 7469 Parameters secti │ │ │ +001ee840: 6f6e 206f 6620 7468 650a 0920 2020 2076 on of the.. v │ │ │ +001ee850: 6972 7475 6f73 6f20 636f 6e66 6967 7572 irtuoso configur │ │ │ +001ee860: 6174 696f 6e20 6669 6c65 2028 7669 7274 ation file (virt │ │ │ +001ee870: 756f 736f 2e69 6e69 2062 7920 6465 6661 uoso.ini by defa │ │ │ +001ee880: 756c 7429 2061 7265 2075 7365 6420 746f ult) are used to │ │ │ +001ee890: 2063 6f6e 7472 6f6c 0a09 2020 2020 6469 control.. di │ │ │ +001ee8a0: 736b 2061 6363 6573 732e 203c 2f70 6172 sk access. . . Parameters..path</t │ │ │ +001ee910: 6974 6c65 3e0a 0920 2020 203c 7061 7261 itle>.. <para │ │ │ +001ee920: 3e3c 7479 7065 3e76 6172 6368 6172 3c2f ><type>varchar</ │ │ │ +001ee930: 7479 7065 3e20 7265 6c61 7469 7665 2070 type> relative p │ │ │ +001ee940: 6174 682e 3c2f 7061 7261 3e0a 093c 2f72 ath.</para>..</r │ │ │ +001ee950: 6566 7365 6374 323e 0a09 3c72 6566 7365 efsect2>..<refse │ │ │ +001ee960: 6374 323e 3c74 6974 6c65 3e6e 6577 5f6d ct2><title>new_m │ │ │ +001ee970: 6f64 3c2f 7469 746c 653e 0a09 2020 2020 od.. │ │ │ +001ee980: 3c70 6172 613e 3c74 7970 653e 696e 7465 inte │ │ │ +001ee990: 6765 723c 2f74 7970 653e 206e 6577 206d ger new m │ │ │ +001ee9a0: 6f64 6520 666f 7220 7468 6520 6669 6c65 ode for the file │ │ │ +001ee9b0: 2e3c 2f70 6172 613e 0a09 3c2f 7265 6673 .... . Example │ │ │ +001eea00: 733c 2f74 6974 6c65 3e0a 093c 6578 616d s..Simp │ │ │ +001eea30: 6c65 2065 7861 6d70 6c65 3c2f 7469 746c le example</titl │ │ │ +001eea40: 653e 0a09 2020 2020 3c70 6172 613e 4d61 e>.. <para>Ma │ │ │ +001eea50: 6b65 2074 6865 2076 6972 7475 6f73 6f20 ke the virtuoso │ │ │ +001eea60: 494e 4920 6669 6c65 2072 6561 6461 626c INI file readabl │ │ │ +001eea70: 6520 6279 2074 6865 206f 7468 6572 733c e by the others< │ │ │ +001eea80: 2f70 6172 613e 0a09 2020 2020 3c73 6372 /para>.. <scr │ │ │ +001eea90: 6565 6e3e 0a53 514c 3e73 656c 6563 7420 een>.SQL>select │ │ │ +001eeaa0: 6f73 5f63 686d 6f64 2028 7669 7274 756f os_chmod (virtuo │ │ │ +001eeab0: 736f 5f69 6e69 5f70 6174 6828 292c 2062 so_ini_path(), b │ │ │ +001eeac0: 6974 5f6f 7220 2863 6173 7420 2866 696c it_or (cast (fil │ │ │ +001eead0: 655f 7374 6174 2028 7669 7274 756f 736f e_stat (virtuoso │ │ │ +001eeae0: 5f69 6e69 5f70 6174 6828 292c 2032 2920 _ini_path(), 2) │ │ │ +001eeaf0: 6173 2069 6e74 6567 6572 292c 2034 2929 as integer), 4)) │ │ │ +001eeb00: 3b0a 6361 6c6c 7265 740a 5641 5243 4841 ;.callret.VARCHA │ │ │ +001eeb10: 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f R.______________ │ │ │ +001eeb20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001eeb30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001eeb40: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001eeb50: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001eeb60: 5f0a 0a4e 554c 4c0a 0920 2020 203c 2f73 _..NULL.. </s │ │ │ +001eeb70: 6372 6565 6e3e 0a09 3c2f 6578 616d 706c creen>..</exampl │ │ │ +001eeb80: 653e 0a20 2020 203c 2f72 6566 7365 6374 e>. </refsect │ │ │ +001eeb90: 313e 0a20 2020 203c 7265 6673 6563 7431 1>. <refsect1 │ │ │ +001eeba0: 2069 643d 2273 6565 616c 736f 223e 3c74 id="seealso"><t │ │ │ +001eebb0: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ +001eebc0: 6974 6c65 3e0a 093c 7061 7261 3e3c 6c69 itle>..<para><li │ │ │ +001eebd0: 6e6b 206c 696e 6b65 6e64 3d22 666e 5f66 nk linkend="fn_f │ │ │ +001eebe0: 696c 655f 6465 6c65 7465 223e 3c66 756e ile_delete"><fun │ │ │ +001eebf0: 6374 696f 6e3e 6669 6c65 5f64 656c 6574 ction>file_delet │ │ │ +001eec00: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e</function></li │ │ │ +001eec10: 6e6b 3e3c 2f70 6172 613e 0a09 3c70 6172 nk></para>..<par │ │ │ +001eec20: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +001eec30: 2266 6e5f 6669 6c65 5f73 7461 7422 3e3c "fn_file_stat">< │ │ │ +001eec40: 6675 6e63 7469 6f6e 3e66 696c 655f 7374 function>file_st │ │ │ +001eec50: 6174 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c at</function></l │ │ │ +001eec60: 696e 6b3e 3c2f 7061 7261 3e0a 093c 7061 ink></para>..<pa │ │ │ +001eec70: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001eec80: 3d22 666e 5f6f 735f 6368 6f77 6e22 3e3c ="fn_os_chown">< │ │ │ +001eec90: 6675 6e63 7469 6f6e 3e6f 735f 6368 6f77 function>os_chow │ │ │ +001eeca0: 6e3c 2f66 756e 6374 696f 6e3e 3c2f 6c69 n</function></li │ │ │ +001eecb0: 6e6b 3e3c 2f70 6172 613e 0a09 3c70 6172 nk></para>..<par │ │ │ +001eecc0: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +001eecd0: 2266 6e5f 7669 7274 756f 736f 5f69 6e69 "fn_virtuoso_ini │ │ │ +001eece0: 5f70 6174 6822 3e3c 6675 6e63 7469 6f6e _path"><function │ │ │ +001eecf0: 3e76 6972 7475 6f73 6f5f 696e 695f 7061 >virtuoso_ini_pa │ │ │ +001eed00: 7468 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c th</function></l │ │ │ +001eed10: 696e 6b3e 3c2f 7061 7261 3e0a 093c 7061 ink></para>..<pa │ │ │ +001eed20: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001eed30: 3d22 666e 5f62 6974 5f6f 7222 3e3c 6675 ="fn_bit_or"><fu │ │ │ +001eed40: 6e63 7469 6f6e 3e62 6974 5f6f 723c 2f66 nction>bit_or</f │ │ │ +001eed50: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001eed60: 2f70 6172 613e 0a09 3c70 6172 613e 3c6c /para>..<para><l │ │ │ +001eed70: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +001eed80: 6269 745f 786f 7222 3e3c 6675 6e63 7469 bit_xor"><functi │ │ │ +001eed90: 6f6e 3e62 6974 5f78 6f72 3c2f 6675 6e63 on>bit_xor</func │ │ │ +001eeda0: 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 tion></link></pa │ │ │ +001eedb0: 7261 3e0a 2020 2020 3c2f 7265 6673 6563 ra>. </refsec │ │ │ +001eedc0: 7431 3e0a 3c2f 7265 6665 6e74 7279 3e0a t1>.</refentry>. │ │ │ +001eedd0: b600 0000 2364 656d 6f2f 646f 6373 7263 ....#demo/docsrc │ │ │ +001eede0: 2f66 756e 6372 6566 2f72 6570 6c5f 7374 /funcref/repl_st │ │ │ +001eedf0: 6174 7573 2e78 6d6c df00 001f 3e3c 3f78 atus.xml....><?x │ │ │ +001eee00: 6d6c 2076 6572 7369 6f6e 3d22 312e 3022 ml version="1.0" │ │ │ +001eee10: 2065 6e63 6f64 696e 673d 2249 534f 2d38 encoding="ISO-8 │ │ │ +001eee20: 3835 392d 3122 3f3e 0a3c 212d 2d0a 202d 859-1"?>.<!--. - │ │ │ +001eee30: 2020 0a20 2d20 2054 6869 7320 6669 6c65 . - This file │ │ │ +001eee40: 2069 7320 7061 7274 206f 6620 7468 6520 is part of the │ │ │ +001eee50: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ +001eee60: 6520 5669 7274 756f 736f 204f 7065 6e2d e Virtuoso Open- │ │ │ +001eee70: 536f 7572 6365 2028 564f 5329 0a20 2d20 Source (VOS). - │ │ │ +001eee80: 2070 726f 6a65 6374 2e0a 202d 2020 0a20 project.. - . │ │ │ +001eee90: 2d20 2043 6f70 7972 6967 6874 2028 4329 - Copyright (C) │ │ │ +001eeea0: 2031 3939 382d 3230 3234 204f 7065 6e4c 1998-2024 OpenL │ │ │ +001eeeb0: 696e 6b20 536f 6674 7761 7265 0a20 2d20 ink Software. - │ │ │ +001eeec0: 200a 202d 2020 5468 6973 2070 726f 6a65 . - This proje │ │ │ +001eeed0: 6374 2069 7320 6672 6565 2073 6f66 7477 ct is free softw │ │ │ +001eeee0: 6172 653b 2079 6f75 2063 616e 2072 6564 are; you can red │ │ │ +001eeef0: 6973 7472 6962 7574 6520 6974 2061 6e64 istribute it and │ │ │ +001eef00: 2f6f 7220 6d6f 6469 6679 2069 740a 202d /or modify it. - │ │ │ +001eef10: 2020 756e 6465 7220 7468 6520 7465 726d under the term │ │ │ +001eef20: 7320 6f66 2074 6865 2047 4e55 2047 656e s of the GNU Gen │ │ │ +001eef30: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ +001eef40: 6e73 6520 6173 2070 7562 6c69 7368 6564 nse as published │ │ │ +001eef50: 2062 7920 7468 650a 202d 2020 4672 6565 by the. - Free │ │ │ +001eef60: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ +001eef70: 7469 6f6e 3b20 6f6e 6c79 2076 6572 7369 tion; only versi │ │ │ +001eef80: 6f6e 2032 206f 6620 7468 6520 4c69 6365 on 2 of the Lice │ │ │ +001eef90: 6e73 652c 2064 6174 6564 204a 756e 6520 nse, dated June │ │ │ +001eefa0: 3139 3931 2e0a 202d 2020 0a20 2d20 2054 1991.. - . - T │ │ │ +001eefb0: 6869 7320 7072 6f67 7261 6d20 6973 2064 his program is d │ │ │ +001eefc0: 6973 7472 6962 7574 6564 2069 6e20 7468 istributed in th │ │ │ +001eefd0: 6520 686f 7065 2074 6861 7420 6974 2077 e hope that it w │ │ │ +001eefe0: 696c 6c20 6265 2075 7365 6675 6c2c 2062 ill be useful, b │ │ │ +001eeff0: 7574 0a20 2d20 2057 4954 484f 5554 2041 ut. - WITHOUT A │ │ │ +001ef000: 4e59 2057 4152 5241 4e54 593b 2077 6974 NY WARRANTY; wit │ │ │ +001ef010: 686f 7574 2065 7665 6e20 7468 6520 696d hout even the im │ │ │ +001ef020: 706c 6965 6420 7761 7272 616e 7479 206f plied warranty o │ │ │ +001ef030: 660a 202d 2020 4d45 5243 4841 4e54 4142 f. - MERCHANTAB │ │ │ +001ef040: 494c 4954 5920 6f72 2046 4954 4e45 5353 ILITY or FITNESS │ │ │ +001ef050: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ +001ef060: 5220 5055 5250 4f53 452e 2053 6565 2074 R PURPOSE. See t │ │ │ +001ef070: 6865 2047 4e55 0a20 2d20 2047 656e 6572 he GNU. - Gener │ │ │ +001ef080: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ +001ef090: 6520 666f 7220 6d6f 7265 2064 6574 6169 e for more detai │ │ │ +001ef0a0: 6c73 2e0a 202d 2020 0a20 2d20 2059 6f75 ls.. - . - You │ │ │ +001ef0b0: 2073 686f 756c 6420 6861 7665 2072 6563 should have rec │ │ │ +001ef0c0: 6569 7665 6420 6120 636f 7079 206f 6620 eived a copy of │ │ │ +001ef0d0: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ +001ef0e0: 5075 626c 6963 204c 6963 656e 7365 2061 Public License a │ │ │ +001ef0f0: 6c6f 6e67 0a20 2d20 2077 6974 6820 7468 long. - with th │ │ │ +001ef100: 6973 2070 726f 6772 616d 3b20 6966 206e is program; if n │ │ │ +001ef110: 6f74 2c20 7772 6974 6520 746f 2074 6865 ot, write to the │ │ │ +001ef120: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ +001ef130: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e2c oundation, Inc., │ │ │ +001ef140: 0a20 2d20 2035 3120 4672 616e 6b6c 696e . - 51 Franklin │ │ │ +001ef150: 2053 742c 2046 6966 7468 2046 6c6f 6f72 St, Fifth Floor │ │ │ +001ef160: 2c20 426f 7374 6f6e 2c20 4d41 2030 3231 , Boston, MA 021 │ │ │ +001ef170: 3130 2d31 3330 3120 5553 410a 202d 2020 10-1301 USA. - │ │ │ +001ef180: 0a20 2d20 200a 2d2d 3e0a 3c72 6566 656e . - .-->.<refen │ │ │ +001ef190: 7472 7920 6964 3d22 666e 5f72 6570 6c5f try id="fn_repl_ │ │ │ +001ef1a0: 7374 6174 7573 223e 0a20 203c 7265 666d status">. <refm │ │ │ +001ef1b0: 6574 613e 0a20 2020 203c 7265 6665 6e74 eta>. <refent │ │ │ +001ef1c0: 7279 7469 746c 653e 7265 706c 5f73 7461 rytitle>repl_sta │ │ │ +001ef1d0: 7475 733c 2f72 6566 656e 7472 7974 6974 tus</refentrytit │ │ │ +001ef1e0: 6c65 3e0a 2020 2020 3c72 6566 6d69 7363 le>. <refmisc │ │ │ +001ef1f0: 696e 666f 3e72 6570 6c3c 2f72 6566 6d69 info>repl</refmi │ │ │ +001ef200: 7363 696e 666f 3e0a 2020 3c2f 7265 666d scinfo>. </refm │ │ │ +001ef210: 6574 613e 0a20 203c 7265 666e 616d 6564 eta>. <refnamed │ │ │ +001ef220: 6976 3e0a 2020 2020 3c72 6566 6e61 6d65 iv>. <refname │ │ │ +001ef230: 3e72 6570 6c5f 7374 6174 7573 3c2f 7265 >repl_status</re │ │ │ +001ef240: 666e 616d 653e 0a20 2020 203c 7265 6670 fname>. <refp │ │ │ +001ef250: 7572 706f 7365 3e72 6574 7572 6e73 2073 urpose>returns s │ │ │ +001ef260: 7461 7475 7320 6f66 2061 2070 7562 6c69 tatus of a publi │ │ │ +001ef270: 7368 6564 206f 7220 7375 6273 6372 6962 shed or subscrib │ │ │ +001ef280: 6564 2070 7562 6c69 6361 7469 6f6e 3c2f ed publication</ │ │ │ +001ef290: 7265 6670 7572 706f 7365 3e0a 2020 3c2f refpurpose>. </ │ │ │ +001ef2a0: 7265 666e 616d 6564 6976 3e0a 2020 3c72 refnamediv>. <r │ │ │ +001ef2b0: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ +001ef2c0: 2020 203c 6675 6e63 7379 6e6f 7073 6973 <funcsynopsis │ │ │ +001ef2d0: 2069 643d 2266 7379 6e5f 7265 706c 5f73 id="fsyn_repl_s │ │ │ +001ef2e0: 7461 7475 7322 3e0a 2020 2020 2020 3c66 tatus">. <f │ │ │ +001ef2f0: 756e 6370 726f 746f 7479 7065 2069 643d uncprototype id= │ │ │ +001ef300: 2266 7072 6f74 6f5f 7265 706c 5f73 7461 "fproto_repl_sta │ │ │ +001ef310: 7475 7322 3e0a 2020 2020 2020 2020 3c66 tus">. <f │ │ │ +001ef320: 756e 6364 6566 3e3c 6675 6e63 7469 6f6e uncdef><function │ │ │ +001ef330: 3e72 6570 6c5f 7374 6174 7573 3c2f 6675 >repl_status</fu │ │ │ +001ef340: 6e63 7469 6f6e 3e3c 2f66 756e 6364 6566 nction></funcdef │ │ │ +001ef350: 3e0a 2020 2020 2020 2020 3c70 6172 616d >. <param │ │ │ +001ef360: 6465 663e 696e 203c 7061 7261 6d65 7465 def>in <paramete │ │ │ +001ef370: 723e 7075 626c 6973 6865 723c 2f70 6172 r>publisher</par │ │ │ +001ef380: 616d 6574 6572 3e20 7661 7263 6861 723c ameter> varchar< │ │ │ +001ef390: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +001ef3a0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 <paramdef>in │ │ │ +001ef3b0: 3c70 6172 616d 6574 6572 3e70 7562 6c69 <parameter>publi │ │ │ +001ef3c0: 6361 7469 6f6e 3c2f 7061 7261 6d65 7465 cation</paramete │ │ │ +001ef3d0: 723e 2076 6172 6368 6172 3c2f 7061 7261 r> varchar</para │ │ │ +001ef3e0: 6d64 6566 3e0a 2020 2020 2020 2020 3c70 mdef>. <p │ │ │ +001ef3f0: 6172 616d 6465 663e 6f75 7420 3c70 6172 aramdef>out <par │ │ │ +001ef400: 616d 6574 6572 3e6c 6576 656c 3c2f 7061 ameter>level</pa │ │ │ +001ef410: 7261 6d65 7465 723e 2069 6e74 6567 6572 rameter> integer │ │ │ +001ef420: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ +001ef430: 2020 2020 3c70 6172 616d 6465 663e 6f75 <paramdef>ou │ │ │ +001ef440: 7420 3c70 6172 616d 6574 6572 3e73 7461 t <parameter>sta │ │ │ +001ef450: 743c 2f70 6172 616d 6574 6572 3e20 696e t</parameter> in │ │ │ +001ef460: 7465 6765 723c 2f70 6172 616d 6465 663e teger</paramdef> │ │ │ +001ef470: 0a20 2020 2020 203c 2f66 756e 6370 726f . </funcpro │ │ │ +001ef480: 746f 7479 7065 3e0a 2020 2020 3c2f 6675 totype>. </fu │ │ │ +001ef490: 6e63 7379 6e6f 7073 6973 3e0a 2020 3c2f ncsynopsis>. </ │ │ │ +001ef4a0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ +001ef4b0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +001ef4c0: 6465 7363 5f72 6570 6c5f 7374 6174 7573 desc_repl_status │ │ │ +001ef4d0: 223e 3c74 6974 6c65 3e44 6573 6372 6970 "><title>Descrip │ │ │ +001ef4e0: 7469 6f6e 3c2f 7469 746c 653e 0a09 0909 tion.... │ │ │ +001ef4f0: 3c70 6172 613e 4769 7665 6e20 6120 7075 Given a pu │ │ │ +001ef500: 626c 6973 6865 7220 616e 6420 7075 626c blisher and publ │ │ │ +001ef510: 6963 6174 696f 6e20 6e61 6d65 2074 6869 ication name thi │ │ │ +001ef520: 7320 7265 7475 726e 7320 7468 6520 0a20 s returns the . │ │ │ +001ef530: 2020 2020 2073 7461 7475 7320 6f66 2074 status of t │ │ │ +001ef540: 6865 2070 7562 6c69 6361 7469 6f6e 206f he publication o │ │ │ +001ef550: 6e20 7468 6520 6c6f 6361 6c20 7365 7276 n the local serv │ │ │ +001ef560: 6572 2e3c 2f70 6172 613e 0a20 203c 2f72 er.. . Parameters. publ │ │ │ +001ef5d0: 6973 6865 723c 2f74 6974 6c65 3e0a 2020 isher. │ │ │ +001ef5e0: 2020 2020 3c70 6172 613e 4e61 6d65 206f Name o │ │ │ +001ef5f0: 6620 7468 6520 7075 626c 6973 6865 722e f the publisher. │ │ │ +001ef600: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . pub │ │ │ +001ef630: 6c69 6361 7469 6f6e 3c2f 7469 746c 653e lication │ │ │ +001ef640: 0a20 2020 2020 203c 7061 7261 3e4e 616d . Nam │ │ │ +001ef650: 6520 6f66 2074 6865 2070 7562 6c69 6361 e of the publica │ │ │ +001ef660: 7469 6f6e 2e3c 2f70 6172 613e 0a20 2020 tion.. │ │ │ +001ef670: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ +001ef680: 203c 7265 6673 6563 7432 3e3c 7469 746c level. │ │ │ +001ef6a0: 2020 2020 2020 3c70 6172 613e 4966 2074 If t │ │ │ +001ef6b0: 6865 2070 7562 6c69 7368 6572 2069 7320 he publisher is │ │ │ +001ef6c0: 7468 6520 6e61 6d65 206f 6620 7468 6520 the name of the │ │ │ +001ef6d0: 6c6f 6361 6c20 7365 7276 6572 2074 6869 local server thi │ │ │ +001ef6e0: 7320 7265 7475 726e 7320 7468 6520 0a09 s returns the .. │ │ │ +001ef6f0: 2020 6e65 7874 2074 7261 6e73 6163 7469 next transacti │ │ │ +001ef700: 6f6e 206e 756d 6265 7220 746f 2062 6520 on number to be │ │ │ +001ef710: 6173 7369 676e 6564 2074 6f20 6120 7472 assigned to a tr │ │ │ +001ef720: 616e 7361 6374 696f 6e20 6173 2074 6865 ansaction as the │ │ │ +001ef730: 206c 6576 656c 200a 0920 206f 7574 7075 level .. outpu │ │ │ +001ef740: 7420 7061 7261 6d65 7465 722e 3c2f 7061 t parameter.. │ │ │ +001ef760: 4966 2074 6865 2070 7562 6c69 7368 6572 If the publisher │ │ │ +001ef770: 2069 7320 6f74 6865 7220 7468 616e 2074 is other than t │ │ │ +001ef780: 6865 206c 6f63 616c 2073 6572 7665 7220 he local server │ │ │ +001ef790: 7468 6973 2072 6574 7572 6e73 2074 6865 this returns the │ │ │ +001ef7a0: 200a 2020 2020 2020 7472 616e 7361 6374 . transact │ │ │ +001ef7b0: 696f 6e20 6e75 6d62 6572 206f 6620 7468 ion number of th │ │ │ +001ef7c0: 6520 6c61 7374 2074 7261 6e73 6163 7469 e last transacti │ │ │ +001ef7d0: 6f6e 206f 6620 7468 6174 2070 7562 6c69 on of that publi │ │ │ +001ef7e0: 6361 7469 6f6e 2074 6861 7420 6861 7320 cation that has │ │ │ +001ef7f0: 0a20 2020 2020 2073 7563 6365 7373 6675 . successfu │ │ │ +001ef800: 6c6c 7920 6265 656e 2072 6570 6c69 6361 lly been replica │ │ │ +001ef810: 7465 6420 746f 2074 6865 206c 6f63 616c ted to the local │ │ │ +001ef820: 2064 6174 6162 6173 6520 6173 2074 6865 database as the │ │ │ +001ef830: 206c 6576 656c 206f 7574 7075 7420 0a20 level output . │ │ │ +001ef840: 2020 2020 2070 6172 616d 6574 6572 2e3c parameter.< │ │ │ +001ef850: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . stat │ │ │ +001ef880: 3c2f 7469 746c 653e 0a20 2020 2020 3c70 .

    The stat out │ │ │ +001ef8a0: 7075 7420 7061 7261 6d65 7465 7220 7265 put parameter re │ │ │ +001ef8b0: 666c 6563 7473 2074 6865 2063 7572 7265 flects the curre │ │ │ +001ef8c0: 6e74 2073 7461 7465 206f 6620 7468 6520 nt state of the │ │ │ +001ef8d0: 0a20 2020 2020 7375 6273 6372 6970 7469 . subscripti │ │ │ +001ef8e0: 6f6e 2e20 2049 6620 7468 6520 7075 626c on. If the publ │ │ │ +001ef8f0: 6973 6865 7220 6973 2074 6865 206c 6f63 isher is the loc │ │ │ +001ef900: 616c 2073 6572 7665 7220 7468 6520 7374 al server the st │ │ │ +001ef910: 6174 2069 7320 616c 7761 7973 2030 2e20 at is always 0. │ │ │ +001ef920: 200a 2020 2020 204f 7468 6572 7769 7365 . Otherwise │ │ │ +001ef930: 2069 7420 6861 7320 7468 6520 666f 6c6c it has the foll │ │ │ +001ef940: 6f77 696e 6720 706f 7373 6962 6c65 2076 owing possible v │ │ │ +001ef950: 616c 7565 733a 3c2f 7061 7261 3e0a 2020 alues:. │ │ │ +001ef960: 2020 203c 7369 6d70 6c65 6c69 7374 3e0a . │ │ │ +001ef970: 2020 2020 2020 203c 6d65 6d62 6572 3e3c < │ │ │ +001ef980: 656d 7068 6173 6973 3e30 202d 206f 6666 emphasis>0 - off │ │ │ +001ef990: 3c2f 656d 7068 6173 6973 3e20 2054 6865 The │ │ │ +001ef9a0: 2073 7562 7363 7269 7074 696f 6e20 6578 subscription ex │ │ │ +001ef9b0: 6973 7473 2062 7574 2074 6865 7265 2069 ists but there i │ │ │ +001ef9c0: 7320 6e6f 2070 7265 7365 6e74 206f 7220 s no present or │ │ │ +001ef9d0: 7061 7374 2061 6374 6976 6974 792e 2e3c past activity..< │ │ │ +001ef9e0: 2f6d 656d 6265 723e 0a20 2020 2020 2020 /member>. │ │ │ +001ef9f0: 3c6d 656d 6265 723e 3c65 6d70 6861 7369 1 - syncing - A syn │ │ │ +001efa20: 6320 6861 7320 7375 6363 6573 7366 756c c has successful │ │ │ +001efa30: 6c79 2062 6565 6e20 7265 7175 6573 7465 ly been requeste │ │ │ +001efa40: 6420 616e 6420 0a20 2020 2020 2020 7472 d and . tr │ │ │ +001efa50: 616e 7361 6374 696f 6e73 2061 7265 2063 ansactions are c │ │ │ +001efa60: 6f6d 696e 6720 6672 6f6d 2074 6865 2070 oming from the p │ │ │ +001efa70: 7562 6c69 7368 6572 2061 7420 7468 6520 ublisher at the │ │ │ +001efa80: 7072 6573 656e 7420 7469 6d65 2e3c 2f6d present time.. │ │ │ +001efab0: 3220 2d20 696e 2073 796e 633c 2f65 6d70 2 - in sync - The s │ │ │ +001efad0: 796e 6369 6e67 2070 6861 7365 2068 6173 yncing phase has │ │ │ +001efae0: 2074 6572 6d69 6e61 7465 6420 616e 6420 terminated and │ │ │ +001efaf0: 616e 6420 7468 6973 200a 2020 2020 2020 and this . │ │ │ +001efb00: 2073 6572 7665 7220 6973 2069 6e20 7379 server is in sy │ │ │ +001efb10: 6e63 2077 6974 6820 7468 6520 7075 626c nc with the publ │ │ │ +001efb20: 6973 6865 722e 2020 5468 6973 2064 6f65 isher. This doe │ │ │ +001efb30: 7320 6e6f 7420 6d65 616e 2061 6c6c 2074 s not mean all t │ │ │ +001efb40: 6865 2070 7562 6c69 7368 6572 2773 200a he publisher's . │ │ │ +001efb50: 2020 2020 2020 2070 7562 6c69 7368 6564 published │ │ │ +001efb60: 2074 7261 6e73 6163 7469 6f6e 7320 6861 transactions ha │ │ │ +001efb70: 7665 2061 7420 616c 6c20 7469 6d65 7320 ve at all times │ │ │ +001efb80: 6265 656e 2072 6570 6c61 7965 6420 6275 been replayed bu │ │ │ +001efb90: 7420 7468 6973 2064 6f65 7320 6d65 616e t this does mean │ │ │ +001efba0: 200a 2020 2020 2020 2074 6861 7420 7468 . that th │ │ │ +001efbb0: 6520 7379 6e63 2072 6571 7565 7374 2072 e sync request r │ │ │ +001efbc0: 6561 6368 6564 2074 6865 2065 6e64 206f eached the end o │ │ │ +001efbd0: 6620 7468 6520 7265 706c 6963 6174 696f f the replicatio │ │ │ +001efbe0: 6e20 7472 616e 7361 6374 696f 6e20 6c6f n transaction lo │ │ │ +001efbf0: 6720 0a20 2020 2020 2020 616e 6420 7468 g . and th │ │ │ +001efc00: 6174 2074 6865 2073 6572 7665 7273 2077 at the servers w │ │ │ +001efc10: 6572 6520 696e 2073 796e 6320 6174 2074 ere in sync at t │ │ │ +001efc20: 6861 7420 6d6f 6d65 6e74 2e3c 2f6d 656d hat moment.. 3 │ │ │ +001efc50: 2d20 6469 7363 6f6e 6e65 6374 6564 2062 - disconnected b │ │ │ +001efc60: 7920 7265 6d6f 7465 3c2f 656d 7068 6173 y remote - The remot │ │ │ +001efc80: 6520 6861 7320 6469 7363 6f6e 6e65 6374 e has disconnect │ │ │ +001efc90: 6564 200a 2020 2020 2020 2074 6869 7320 ed . this │ │ │ +001efca0: 7375 6273 6372 6962 6572 2e20 2054 6869 subscriber. Thi │ │ │ +001efcb0: 7320 6d61 7920 6265 2066 6f72 2076 6172 s may be for var │ │ │ +001efcc0: 696f 7573 2072 6561 736f 6e73 2c20 696e ious reasons, in │ │ │ +001efcd0: 636c 7564 696e 6720 7468 6174 2074 6869 cluding that thi │ │ │ +001efce0: 7320 0a20 2020 2020 2020 7375 6273 6372 s . subscr │ │ │ +001efcf0: 6962 6572 2068 6173 2066 616c 6c65 6e20 iber has fallen │ │ │ +001efd00: 746f 6f20 6661 7220 6265 6869 6e64 2069 too far behind i │ │ │ +001efd10: 6e20 7265 706c 6179 696e 6720 7468 6520 n replaying the │ │ │ +001efd20: 7075 626c 6973 6865 6420 7472 616e 7361 published transa │ │ │ +001efd30: 6374 696f 6e20 0a20 2020 2020 2020 616e ction . an │ │ │ +001efd40: 6420 6861 7320 7468 7573 2066 616c 6c65 d has thus falle │ │ │ +001efd50: 6e20 6f75 7420 6f66 2073 796e 632e 2020 n out of sync. │ │ │ +001efd60: 5468 6973 2073 7461 7465 206d 6561 6e73 This state means │ │ │ +001efd70: 2074 6861 7420 6120 7265 7379 6e63 2063 that a resync c │ │ │ +001efd80: 616e 2062 6520 0a20 2020 2020 2020 7265 an be . re │ │ │ +001efd90: 7472 6965 6420 7769 7468 2074 6865 203c tried with the < │ │ │ +001efda0: 6675 6e63 7469 6f6e 3e72 6570 6c5f 7379 function>repl_sy │ │ │ +001efdb0: 6e63 2829 3c2f 6675 6e63 7469 6f6e 3e20 nc() │ │ │ +001efdc0: 6675 6e63 7469 6f6e 2e3c 2f6d 656d 6265 function.. 4 - │ │ │ +001efdf0: 6469 7363 6f6e 6e65 6374 6564 206c 6f63 disconnected loc │ │ │ +001efe00: 616c 6c79 3c2f 656d 7068 6173 6973 3e20 ally │ │ │ +001efe10: 2d20 5468 6973 2073 7461 7465 2069 7320 - This state is │ │ │ +001efe20: 7365 7420 666f 7220 666f 7277 6172 6420 set for forward │ │ │ +001efe30: 0a09 2020 2028 7075 626c 6973 6865 7220 .. (publisher │ │ │ +001efe40: 746f 2073 7562 7363 7269 6265 7229 2061 to subscriber) a │ │ │ +001efe50: 6363 6f75 6e74 7320 7768 656e 2074 6865 ccounts when the │ │ │ +001efe60: 2063 6f72 7265 7370 6f6e 6469 6e67 2070 corresponding p │ │ │ +001efe70: 7573 6862 6163 6b20 0a09 2020 2061 6363 ushback .. acc │ │ │ +001efe80: 6f75 6e74 2069 7320 6469 7363 6f6e 6e65 ount is disconne │ │ │ +001efe90: 6374 6564 2062 6563 6175 7365 206f 6620 cted because of │ │ │ +001efea0: 7265 706c 6963 6174 696f 6e20 7175 6575 replication queu │ │ │ +001efeb0: 6520 6f76 6572 666c 6f77 2e20 5468 6973 e overflow. This │ │ │ +001efec0: 200a 0920 2020 7374 6174 6520 6d65 616e .. state mean │ │ │ +001efed0: 7320 7468 6174 2061 2072 6573 796e 6320 s that a resync │ │ │ +001efee0: 6361 6e20 6265 2072 6574 7269 6564 2077 can be retried w │ │ │ +001efef0: 6974 6820 7468 6520 0a09 2020 203c 6675 ith the .. repl_sync │ │ │ +001eff10: 2829 3c2f 6675 6e63 7469 6f6e 3e20 6675 () fu │ │ │ +001eff20: 6e63 7469 6f6e 2e3c 2f6d 656d 6265 723e nction. │ │ │ +001eff30: 0a20 2020 2020 2020 3c6d 656d 6265 723e . │ │ │ +001eff40: 3c65 6d70 6861 7369 733e 3520 2d20 7761 5 - wa │ │ │ +001eff50: 6974 696e 6720 666f 7220 6c6f 6361 6c20 iting for local │ │ │ +001eff60: 6469 7363 6f6e 6e65 6374 3c2f 656d 7068 disconnect - Local di │ │ │ +001eff80: 7363 6f6e 6e65 6374 0a20 2020 2020 2020 sconnect. │ │ │ +001eff90: 6973 2061 626f 7574 2074 6f20 6861 7070 is about to happ │ │ │ +001effa0: 656e 2066 6f72 2074 6869 7320 6163 636f en for this acco │ │ │ +001effb0: 756e 742e 2020 5468 6973 2073 7461 7465 unt. This state │ │ │ +001effc0: 2069 7320 7365 7420 666f 7220 666f 7277 is set for forw │ │ │ +001effd0: 6172 640a 2020 2020 2020 2028 7075 626c ard. (publ │ │ │ +001effe0: 6973 6865 7220 746f 2073 7562 7363 7269 isher to subscri │ │ │ +001efff0: 6265 7229 2061 6363 6f75 6e74 7320 7768 ber) accounts wh │ │ │ +001f0000: 656e 2063 6f72 7265 7370 6f6e 6469 6e67 en corresponding │ │ │ +001f0010: 2070 7573 6862 6163 6b20 6163 636f 756e pushback accoun │ │ │ +001f0020: 7420 6973 0a20 2020 2020 2020 6469 7363 t is. disc │ │ │ +001f0030: 6f6e 6e65 6374 6564 2062 6563 6175 7365 onnected because │ │ │ +001f0040: 206f 6620 7265 706c 6963 6174 696f 6e20 of replication │ │ │ +001f0050: 7175 6575 6520 6f76 6572 666c 6f77 2e0a queue overflow.. │ │ │ +001f0060: 2020 2020 2020 2054 6869 7320 7374 6174 This stat │ │ │ +001f0070: 6520 6d65 616e 7320 7468 6174 2022 6469 e means that "di │ │ │ +001f0080: 7363 6f6e 6e65 6374 6564 206c 6f63 616c sconnected local │ │ │ +001f0090: 6c79 2220 7374 6174 6520 7769 6c6c 2062 ly" state will b │ │ │ +001f00a0: 6520 7365 7420 666f 720a 2020 2020 2020 e set for. │ │ │ +001f00b0: 2074 6869 7320 6163 636f 756e 7420 7768 this account wh │ │ │ +001f00c0: 656e 206e 6578 7420 7265 706c 6963 6174 en next replicat │ │ │ +001f00d0: 696f 6e20 6d65 7373 6167 6520 666f 7220 ion message for │ │ │ +001f00e0: 7468 6973 2061 6363 6f75 6e74 2061 7272 this account arr │ │ │ +001f00f0: 6976 6573 2e0a 2020 2020 2020 2054 6869 ives.. Thi │ │ │ +001f0100: 7320 7374 6174 6520 6d65 616e 7320 7468 s state means th │ │ │ +001f0110: 6174 2061 2072 6573 796e 6320 6361 6e20 at a resync can │ │ │ +001f0120: 6265 2072 6574 7269 6564 2077 6974 6820 be retried with │ │ │ +001f0130: 7468 6520 0a09 2020 203c 6675 6e63 7469 the .. repl_sync() functi │ │ │ +001f0160: 6f6e 2e3c 2f6d 656d 6265 723e 0a20 2020 on.. │ │ │ +001f0170: 2020 3c2f 7369 6d70 6c65 6c69 7374 3e0a . │ │ │ +001f0180: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ +001f0190: 2020 3c2f 7265 6673 6563 7431 3e0a 0a20 .. │ │ │ +001f01a0: 203c 212d 2d20 3330 3139 0a20 2054 6869 .. │ │ │ +001f1120: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ +001f1130: 3c72 6566 656e 7472 7974 6974 6c65 3e75 u │ │ │ +001f1140: 6474 5f64 6566 696e 6573 5f66 6965 6c64 dt_defines_field │ │ │ +001f1150: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ +001f1160: 0a20 2020 203c 7265 666d 6973 6369 6e66 . type. . │ │ │ +001f11a0: 0a20 2020 203c 7265 666e 616d 653e 7564 . ud │ │ │ +001f11b0: 745f 6465 6669 6e65 735f 6669 656c 643c t_defines_field< │ │ │ +001f11c0: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Determ │ │ │ +001f11e0: 696e 6573 2077 6865 7468 6572 2061 2075 ines whether a u │ │ │ +001f11f0: 7365 7220 6465 6669 6e65 6420 7479 7065 ser defined type │ │ │ +001f1200: 2063 6f6e 7461 696e 7320 6120 7370 6563 contains a spec │ │ │ +001f1210: 6966 6965 6420 6d65 6d62 6572 2e3c 2f72 ified member.. . . │ │ │ +001f1250: 2020 3c66 756e 6373 796e 6f70 7369 7320 . │ │ │ +001f1280: 2020 203c 6675 6e63 7072 6f74 6f74 7970 │ │ │ +001f12b0: 0a20 2020 2020 2020 203c 6675 6e63 6465 . integer udt_defines_ │ │ │ +001f12e0: 6669 656c 643c 2f66 756e 6374 696f 6e3e field │ │ │ +001f12f0: 3c2f 6675 6e63 6465 663e 0a09 3c70 6172 ..in udt any..in │ │ │ +001f1340: 203c 7061 7261 6d65 7465 723e 6d65 6d62 memb │ │ │ +001f1350: 6572 5f6e 616d 653c 2f70 6172 616d 6574 er_name varchar. . │ │ │ +001f1390: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . . │ │ │ +001f13e0: 2020 203c 7469 746c 653e 4465 7363 7269 Descri │ │ │ +001f13f0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ +001f1400: 2020 3c70 6172 613e 5468 6973 2066 756e This fun │ │ │ +001f1410: 6374 696f 6e20 6973 2075 7365 6420 746f ction is used to │ │ │ +001f1420: 2064 6574 6572 6d69 6e65 2077 6865 7468 determine wheth │ │ │ +001f1430: 6572 2074 6865 2073 7570 706c 6965 6420 er the supplied │ │ │ +001f1440: 6d65 6d62 6572 5f6e 616d 6520 0a20 2020 member_name . │ │ │ +001f1450: 2069 7320 6120 6d65 6d62 6572 2063 6f6e is a member con │ │ │ +001f1460: 7461 696e 6564 2062 7920 7468 6520 7375 tained by the su │ │ │ +001f1470: 7070 6c69 6564 2075 6474 2e3c 2f70 6172 pplied udt.. │ │ │ +001f1490: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ +001f14c0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ +001f14d0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. u │ │ │ +001f14f0: 6474 3c2f 7469 746c 653e 0a20 2020 2020 dt. │ │ │ +001f1500: 203c 7061 7261 3e41 2075 7365 7220 6465 A user de │ │ │ +001f1510: 6669 6e65 6420 7479 7065 206e 616d 6520 fined type name │ │ │ +001f1520: 6173 2076 6172 6368 6172 206f 7220 7479 as varchar or ty │ │ │ +001f1530: 7065 2069 6e73 7461 6e63 652e 3c2f 7061 pe instance.. . member_ │ │ │ +001f1570: 6e61 6d65 3c2f 7469 746c 653e 0a20 2020 name. │ │ │ +001f1580: 2020 203c 7061 7261 3e54 6865 2072 6571 The req │ │ │ +001f1590: 7565 7374 6564 206d 656d 6265 7220 6e61 uested member na │ │ │ +001f15a0: 6d65 2e3c 2f70 6172 613e 0a20 2020 203c me.. < │ │ │ +001f15b0: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. . │ │ │ +001f15f0: 3c74 6974 6c65 3e52 6574 7572 6e20 5479 Return Ty │ │ │ +001f1600: 7065 733c 2f74 6974 6c65 3e0a 2020 2020 pes. │ │ │ +001f1610: 3c70 6172 613e 5468 6973 2066 756e 6374 This funct │ │ │ +001f1620: 696f 6e20 7265 7475 726e 7320 6569 7468 ion returns eith │ │ │ +001f1630: 6572 2031 2028 7472 7565 2920 6f72 2030 er 1 (true) or 0 │ │ │ +001f1640: 2028 6661 6c73 6529 2e20 2031 2028 7472 (false). 1 (tr │ │ │ +001f1650: 7565 2920 6973 200a 2020 2020 7265 7475 ue) is . retu │ │ │ +001f1660: 726e 6564 2069 6620 7468 6520 7564 7420 rned if the udt │ │ │ +001f1670: 636f 6e74 6169 6e73 2061 206d 656d 6265 contains a membe │ │ │ +001f1680: 7220 7768 6f73 6520 6e61 6d65 2069 7320 r whose name is │ │ │ +001f1690: 6571 7561 6c20 746f 2074 6865 200a 2020 equal to the . │ │ │ +001f16a0: 2020 7661 6c75 6520 6f66 206d 656d 6265 value of membe │ │ │ +001f16b0: 725f 6e61 6d65 2c20 6f72 2030 206f 7468 r_name, or 0 oth │ │ │ +001f16c0: 6572 7769 7365 2e3c 2f70 6172 613e 0a20 erwise.. │ │ │ +001f16d0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001f16e0: 212d 2d0a 2020 3c72 6566 7365 6374 3120 !--. . │ │ │ +001f1710: 2020 203c 7469 746c 653e 4572 726f 7273 Errors │ │ │ +001f1720: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This function │ │ │ +001f1740: 2063 616e 2067 656e 6572 6174 6520 7468 can generate th │ │ │ +001f1750: 6520 666f 6c6c 6f77 696e 6720 6572 726f e following erro │ │ │ +001f1760: 7273 3a3c 2f70 6172 613e 0a20 2020 203c rs:. < │ │ │ +001f1770: 6572 726f 7263 6f64 653e 3c2f 6572 726f errorcode>. . -->. . Examples. Simple Use. < │ │ │ +001f1870: 2f73 6372 6565 6e3e 0a3c 7061 7261 3e72 /screen>.r │ │ │ +001f1880: 6574 7572 6e73 2031 3c2f 7061 7261 3e0a eturns 1. │ │ │ +001f1890: 2020 2020 2020 3c73 6372 6565 6e3e 3c21 .re │ │ │ +001f18f0: 7475 726e 7320 313c 2f70 6172 613e 0a20 turns 1. │ │ │ +001f1900: 2020 2020 203c 7363 7265 656e 3e3c 215b .returns │ │ │ +001f1960: 2030 3b3c 2f70 6172 613e 0a20 2020 203c 0;. < │ │ │ +001f1970: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. . . S │ │ │ +001f19c0: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ +001f19d0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 u │ │ │ +001f1a00: 6474 5f67 6574 2829 3c2f 6675 6e63 7469 dt_get(). u │ │ │ +001f1a60: 6474 5f69 6d70 6c65 6d65 6e74 735f 6d65 dt_implements_me │ │ │ +001f1a70: 7468 6f64 2829 3c2f 6675 6e63 7469 6f6e thod(). │ │ │ +001f1a90: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 udt_insta │ │ │ +001f1ad0: 6e63 655f 6f66 2829 3c2f 6675 6e63 7469 nce_of(). udt_set(). .... │ │ │ +001f1b60: 0000 2a64 656d 6f2f 646f 6373 7263 2f66 ..*demo/docsrc/f │ │ │ +001f1b70: 756e 6372 6566 2f73 6f61 705f 626f 785f uncref/soap_box_ │ │ │ +001f1b80: 7374 7275 6374 7572 652e 786d 6cdf 0000 structure.xml... │ │ │ +001f1b90: 0d71 3c3f 786d 6c20 7665 7273 696f 6e3d .q..< │ │ │ +001f1f20: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ +001f1f30: 736f 6170 5f62 6f78 5f73 7472 7563 7475 soap_box_structu │ │ │ +001f1f40: 7265 223e 0a20 203c 7265 666d 6574 613e re">. │ │ │ +001f1f50: 0a20 2020 203c 7265 6665 6e74 7279 7469 . soap_box_str │ │ │ +001f1f70: 7563 7475 7265 3c2f 7265 6665 6e74 7279 ucture. soap. . . soap_box_str │ │ │ +001f1fe0: 7563 7475 7265 3c2f 7265 666e 616d 653e ucture │ │ │ +001f1ff0: 0a20 2020 203c 7265 6670 7572 706f 7365 . . │ │ │ +001f2010: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +001f2020: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . < │ │ │ +001f20a0: 6675 6e63 6465 663e 616e 7920 3c66 756e funcdef>any soap_box_s │ │ │ +001f20c0: 7472 7563 7475 7265 3c2f 6675 6e63 7469 tructure..< │ │ │ +001f20e0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in elem1 varchar │ │ │ +001f2110: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..in value1 any..in │ │ │ +001f2170: 2e2e 2e3c 2f70 6172 616d 6574 6572 3e20 ... │ │ │ +001f2180: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..in elem1 varchar..in value1 any. . │ │ │ +001f2220: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ +001f2230: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . Description< │ │ │ +001f2280: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    .. This fun │ │ │ +001f22a0: 6374 696f 6e20 7072 6f76 6964 6573 2061 ction provides a │ │ │ +001f22b0: 2077 6179 2074 6f20 656e 6361 7073 756c way to encapsul │ │ │ +001f22c0: 6174 6520 6120 7374 7275 6374 7572 6520 ate a structure │ │ │ +001f22d0: 7375 6974 6162 6c65 2066 6f72 200a 0920 suitable for .. │ │ │ +001f22e0: 2073 6f61 7020 7365 7269 616c 697a 6174 soap serializat │ │ │ +001f22f0: 696f 6e2e 2049 7420 6163 6365 7074 7320 ion. It accepts │ │ │ +001f2300: 6120 6e61 6d65 2f76 616c 7565 2070 6169 a name/value pai │ │ │ +001f2310: 7273 2077 6869 6368 2072 6570 7265 7365 rs which represe │ │ │ +001f2320: 6e74 7320 6e61 6d65 2061 6e64 0a09 2020 nts name and.. │ │ │ +001f2330: 7661 6c75 6520 6f66 2065 6c65 6d65 6e74 value of element │ │ │ +001f2340: 7320 6f66 2061 2073 7472 7563 7475 7265 s of a structure │ │ │ +001f2350: 2e20 0a20 2020 2020 203c 2f70 6172 613e . . │ │ │ +001f2360: 0a0a 2020 2020 2020 3c70 6172 613e 466f .. Fo │ │ │ +001f2370: 7220 6578 616d 706c 6520 7374 7275 6374 r example struct │ │ │ +001f2380: 7572 6520 3a3c 2f70 6172 613e 0a09 2020 ure :.. │ │ │ +001f2390: 3c70 726f 6772 616d 6c69 7374 696e 673e │ │ │ +001f23a0: 3c21 5b43 4441 5441 5b0a 0920 207b 0a09 .. .. will b │ │ │ +001f2410: 6520 7265 7072 6573 656e 7465 6420 6173 e represented as │ │ │ +001f2420: 2073 6f61 705f 626f 785f 7374 7275 6374 soap_box_struct │ │ │ +001f2430: 7572 6520 2827 7661 7253 7472 696e 6727 ure ('varString' │ │ │ +001f2440: 2c20 2768 656c 6c6f 272c 2027 7661 7249 , 'hello', 'varI │ │ │ +001f2450: 6e74 272c 2031 3233 3429 3b0a 0a09 2020 nt', 1234);... │ │ │ +001f2460: 2020 2020 6675 7274 6865 726d 6f72 6520 furthermore │ │ │ +001f2470: 7661 6c75 6520 7265 7475 726e 6564 2066 value returned f │ │ │ +001f2480: 726f 6d20 736f 6170 5f62 6f78 5f73 7472 rom soap_box_str │ │ │ +001f2490: 7563 7475 7265 2070 6173 7365 6420 6173 ucture passed as │ │ │ +001f24a0: 2061 6e20 6f75 7470 7574 2070 6172 616d an output param │ │ │ +001f24b0: 6574 6572 200a 0920 2020 2020 2074 6f20 eter .. to │ │ │ +001f24c0: 7468 6520 7072 6f63 6564 7572 6520 286e the procedure (n │ │ │ +001f24d0: 616d 6564 2073 7472 7563 746e 616d 6529 amed structname) │ │ │ +001f24e0: 2077 6f72 6b69 6e67 2061 7320 534f 4150 working as SOAP │ │ │ +001f24f0: 206d 6574 686f 6420 7769 6c6c 2072 6574 method will ret │ │ │ +001f2500: 7572 6e20 3a0a 0a09 2020 3c2f 7061 7261 urn :... .. ... hello... │ │ │ +001f2570: 3132 3334 3c2f 7661 7249 6e74 3e20 0a09 1234 .. │ │ │ +001f2580: 2020 3c2f 7374 7275 6374 4e61 6d65 3e20 │ │ │ +001f2590: 5d5d 3e3c 2f70 726f 6772 616d 6c69 7374 ]]>.. .. │ │ │ +001f25b0: 2020 2020 2020 506c 6561 7365 206e 6f74 Please not │ │ │ +001f25c0: 6520 7468 6174 2074 6869 7320 6973 2061 e that this is a │ │ │ +001f25d0: 206f 6e65 206f 6620 706f 7373 6962 696c one of possibil │ │ │ +001f25e0: 6974 6965 7320 746f 2065 7870 7265 7373 ities to express │ │ │ +001f25f0: 2073 7472 7563 7475 7265 7320 0a09 2020 structures .. │ │ │ +001f2600: 2020 2020 666f 7220 534f 4150 2072 6571 for SOAP req │ │ │ +001f2610: 7565 7374 2f72 6573 706f 6e73 6520 696e uest/response in │ │ │ +001f2620: 2056 6972 7475 6f73 6f2f 504c 2e20 5468 Virtuoso/PL. Th │ │ │ +001f2630: 6520 6f74 6865 7220 7761 7920 746f 2065 e other way to e │ │ │ +001f2640: 7870 7265 7373 2073 7472 7563 7475 7265 xpress structure │ │ │ +001f2650: 2069 7320 746f 2075 7365 200a 0920 2020 is to use .. │ │ │ +001f2660: 2020 2055 7365 7220 4465 6669 6e65 6420 User Defined │ │ │ +001f2670: 5479 7065 7320 2873 6565 2053 4f41 5020 Types (see SOAP │ │ │ +001f2680: 2661 6d70 3b20 5753 444c 2073 6563 7469 & WSDL secti │ │ │ +001f2690: 6f6e 206f 6620 7468 6520 646f 6375 6d65 on of the docume │ │ │ +001f26a0: 6e74 6174 696f 6e29 2e20 2020 0a09 2020 ntation). .. │ │ │ +001f26b0: 3c2f 7061 7261 3e0a 3c2f 7265 6673 6563 ... │ │ │ +001f26f0: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ +001f2700: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +001f2710: 3c72 6566 7365 6374 323e 0a09 3c74 6974 ..elem. │ │ │ +001f2730: 093c 7061 7261 3e6e 616d 6520 7768 6963 .name whic │ │ │ +001f2740: 6820 7265 7072 6573 656e 7473 206e 616d h represents nam │ │ │ +001f2750: 6520 0a09 2020 2020 6f66 2074 6865 206d e .. of the m │ │ │ +001f2760: 656d 6265 7220 6f66 2061 2073 7472 7563 ember of a struc │ │ │ +001f2770: 7475 7265 0a09 3c2f 7061 7261 3e0a 2020 ture... │ │ │ +001f2780: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +001f2790: 2020 3c72 6566 7365 6374 323e 0a09 3c74 ..value..value │ │ │ +001f27c0: 7768 6963 6820 7265 7072 6573 656e 7473 which represents │ │ │ +001f27d0: 2076 616c 7565 200a 0920 2020 206f 6620 value .. of │ │ │ +001f27e0: 7468 6520 6d65 6d62 6572 206f 6620 6120 the member of a │ │ │ +001f27f0: 7374 7275 6374 7572 650a 093c 2f70 6172 structure... . │ │ │ +001f2820: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ +001f2850: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ +001f2860: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +001f2870: 3e54 6865 2072 6574 7572 6e20 7479 7065 >The return type │ │ │ +001f2880: 206f 6620 3c66 756e 6374 696f 6e3e 736f of <function>so │ │ │ +001f2890: 6170 5f62 6f78 5f73 7472 7563 7475 7265 ap_box_structure │ │ │ +001f28a0: 2829 3c2f 6675 6e63 7469 6f6e 3e20 6973 ()</function> is │ │ │ +001f28b0: 2061 6e20 6172 7261 7920 0a09 2020 7265 an array .. re │ │ │ +001f28c0: 7072 6573 656e 7469 6e67 2061 2073 7472 presenting a str │ │ │ +001f28d0: 7563 7475 7265 2e0a 2020 2020 2020 3c2f ucture.. </ │ │ │ +001f28e0: 7061 7261 3e0a 2020 3c2f 7265 6673 6563 para>. </refsec │ │ │ +001f28f0: 7431 3e0a 3c2f 7265 6665 6e74 7279 3e0a t1>.</refentry>. │ │ │ +001f2900: 0a0a 0ab6 0000 002c 6465 6d6f 2f64 6f63 .......,demo/doc │ │ │ +001f2910: 7372 632f 6675 6e63 7265 662f 7673 705f src/funcref/vsp_ │ │ │ +001f2920: 6361 6c63 756c 6174 655f 6469 6765 7374 calculate_digest │ │ │ +001f2930: 2e78 6d6c df00 0019 113c 3f78 6d6c 2076 .xml.....<?xml v │ │ │ +001f2940: 6572 7369 6f6e 3d22 312e 3022 2065 6e63 ersion="1.0" enc │ │ │ +001f2950: 6f64 696e 673d 2249 534f 2d38 3835 392d oding="ISO-8859- │ │ │ +001f2960: 3122 3f3e 0a3c 212d 2d0a 202d 2020 0a20 1"?>.<!--. - . │ │ │ +001f2970: 2d20 2054 6869 7320 6669 6c65 2069 7320 - This file is │ │ │ +001f2980: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ +001f2990: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ +001f29a0: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ +001f29b0: 6365 2028 564f 5329 0a20 2d20 2070 726f ce (VOS). - pro │ │ │ +001f29c0: 6a65 6374 2e0a 202d 2020 0a20 2d20 2043 ject.. - . - C │ │ │ +001f29d0: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ +001f29e0: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ +001f29f0: 536f 6674 7761 7265 0a20 2d20 200a 202d Software. - . - │ │ │ +001f2a00: 2020 5468 6973 2070 726f 6a65 6374 2069 This project i │ │ │ +001f2a10: 7320 6672 6565 2073 6f66 7477 6172 653b s free software; │ │ │ +001f2a20: 2079 6f75 2063 616e 2072 6564 6973 7472 you can redistr │ │ │ +001f2a30: 6962 7574 6520 6974 2061 6e64 2f6f 7220 ibute it and/or │ │ │ +001f2a40: 6d6f 6469 6679 2069 740a 202d 2020 756e modify it. - un │ │ │ +001f2a50: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ +001f2a60: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ +001f2a70: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +001f2a80: 6173 2070 7562 6c69 7368 6564 2062 7920 as published by │ │ │ +001f2a90: 7468 650a 202d 2020 4672 6565 2053 6f66 the. - Free Sof │ │ │ +001f2aa0: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ +001f2ab0: 3b20 6f6e 6c79 2076 6572 7369 6f6e 2032 ; only version 2 │ │ │ +001f2ac0: 206f 6620 7468 6520 4c69 6365 6e73 652c of the License, │ │ │ +001f2ad0: 2064 6174 6564 204a 756e 6520 3139 3931 dated June 1991 │ │ │ +001f2ae0: 2e0a 202d 2020 0a20 2d20 2054 6869 7320 .. - . - This │ │ │ +001f2af0: 7072 6f67 7261 6d20 6973 2064 6973 7472 program is distr │ │ │ +001f2b00: 6962 7574 6564 2069 6e20 7468 6520 686f ibuted in the ho │ │ │ +001f2b10: 7065 2074 6861 7420 6974 2077 696c 6c20 pe that it will │ │ │ +001f2b20: 6265 2075 7365 6675 6c2c 2062 7574 0a20 be useful, but. │ │ │ +001f2b30: 2d20 2057 4954 484f 5554 2041 4e59 2057 - WITHOUT ANY W │ │ │ +001f2b40: 4152 5241 4e54 593b 2077 6974 686f 7574 ARRANTY; without │ │ │ +001f2b50: 2065 7665 6e20 7468 6520 696d 706c 6965 even the implie │ │ │ +001f2b60: 6420 7761 7272 616e 7479 206f 660a 202d d warranty of. - │ │ │ +001f2b70: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ +001f2b80: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ +001f2b90: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ +001f2ba0: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ +001f2bb0: 4e55 0a20 2d20 2047 656e 6572 616c 2050 NU. - General P │ │ │ +001f2bc0: 7562 6c69 6320 4c69 6365 6e73 6520 666f ublic License fo │ │ │ +001f2bd0: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ +001f2be0: 202d 2020 0a20 2d20 2059 6f75 2073 686f - . - You sho │ │ │ +001f2bf0: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ +001f2c00: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ +001f2c10: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +001f2c20: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ +001f2c30: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ +001f2c40: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ +001f2c50: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ +001f2c60: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ +001f2c70: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ +001f2c80: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ +001f2c90: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ +001f2ca0: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ +001f2cb0: 3330 3120 5553 410a 202d 2020 0a20 2d20 301 USA. - . - │ │ │ +001f2cc0: 200a 2d2d 3e0a 3c72 6566 656e 7472 7920 .-->.<refentry │ │ │ +001f2cd0: 6964 3d22 666e 5f76 7370 5f63 616c 6375 id="fn_vsp_calcu │ │ │ +001f2ce0: 6c61 7465 5f64 6967 6573 7422 3e0a 2020 late_digest">. │ │ │ +001f2cf0: 3c72 6566 6d65 7461 3e0a 2020 2020 3c72 <refmeta>. <r │ │ │ +001f2d00: 6566 656e 7472 7974 6974 6c65 3e76 7370 efentrytitle>vsp │ │ │ +001f2d10: 5f63 616c 6375 6c61 7465 5f64 6967 6573 _calculate_diges │ │ │ +001f2d20: 743c 2f72 6566 656e 7472 7974 6974 6c65 t</refentrytitle │ │ │ +001f2d30: 3e0a 2020 2020 3c72 6566 6d69 7363 696e >. <refmiscin │ │ │ +001f2d40: 666f 3e77 733c 2f72 6566 6d69 7363 696e fo>ws</refmiscin │ │ │ +001f2d50: 666f 3e0a 2020 3c2f 7265 666d 6574 613e fo>. </refmeta> │ │ │ +001f2d60: 0a20 203c 7265 666e 616d 6564 6976 3e0a . <refnamediv>. │ │ │ +001f2d70: 2020 2020 3c72 6566 6e61 6d65 3e76 7370 <refname>vsp │ │ │ +001f2d80: 5f63 616c 6375 6c61 7465 5f64 6967 6573 _calculate_diges │ │ │ +001f2d90: 743c 2f72 6566 6e61 6d65 3e0a 2020 2020 t</refname>. │ │ │ +001f2da0: 3c72 6566 7075 7270 6f73 653e 6361 6c63 <refpurpose>calc │ │ │ +001f2db0: 756c 6174 6520 6f6e 2073 6572 7665 722d ulate on server- │ │ │ +001f2dc0: 7369 6465 2061 2064 6967 6573 7420 746f side a digest to │ │ │ +001f2dd0: 2070 6572 666f 726d 2061 2048 5454 5020 perform a HTTP │ │ │ +001f2de0: 6469 6765 7374 2061 7574 6865 6e74 6963 digest authentic │ │ │ +001f2df0: 6174 696f 6e3c 2f72 6566 7075 7270 6f73 ation</refpurpos │ │ │ +001f2e00: 653e 0a20 203c 2f72 6566 6e61 6d65 6469 e>. </refnamedi │ │ │ +001f2e10: 763e 0a20 203c 7265 6673 796e 6f70 7369 v>. <refsynopsi │ │ │ +001f2e20: 7364 6976 3e0a 2020 2020 3c66 756e 6373 sdiv>. <funcs │ │ │ +001f2e30: 796e 6f70 7369 7320 6964 3d22 6673 796e ynopsis id="fsyn │ │ │ +001f2e40: 5f76 7370 5f63 616c 6375 6c61 7465 5f64 _vsp_calculate_d │ │ │ +001f2e50: 6967 6573 7422 3e0a 2020 2020 2020 3c66 igest">. <f │ │ │ +001f2e60: 756e 6370 726f 746f 7479 7065 2069 643d uncprototype id= │ │ │ +001f2e70: 2266 7072 6f74 6f5f 7673 705f 6361 6c63 "fproto_vsp_calc │ │ │ +001f2e80: 756c 6174 655f 6469 6765 7374 223e 0a20 ulate_digest">. │ │ │ +001f2e90: 2020 2020 2020 203c 6675 6e63 6465 663e <funcdef> │ │ │ +001f2ea0: 3c66 756e 6374 696f 6e3e 7673 705f 6361 <function>vsp_ca │ │ │ +001f2eb0: 6c63 756c 6174 655f 6469 6765 7374 3c2f lculate_digest</ │ │ │ +001f2ec0: 6675 6e63 7469 6f6e 3e3c 2f66 756e 6364 function></funcd │ │ │ +001f2ed0: 6566 3e0a 093c 7061 7261 6d64 6566 3e69 ef>..<paramdef>i │ │ │ +001f2ee0: 6e20 3c70 6172 616d 6574 6572 3e75 7365 n <parameter>use │ │ │ +001f2ef0: 726e 616d 653c 2f70 6172 616d 6574 6572 rname</parameter │ │ │ +001f2f00: 3e20 7661 7263 6861 723c 2f70 6172 616d > varchar</param │ │ │ +001f2f10: 6465 663e 0a09 3c70 6172 616d 6465 663e def>..<paramdef> │ │ │ +001f2f20: 696e 203c 7061 7261 6d65 7465 723e 7061 in <parameter>pa │ │ │ +001f2f30: 7373 776f 7264 3c2f 7061 7261 6d65 7465 ssword</paramete │ │ │ +001f2f40: 723e 2076 6172 6368 6172 3c2f 7061 7261 r> varchar</para │ │ │ +001f2f50: 6d64 6566 3e0a 093c 7061 7261 6d64 6566 mdef>..<paramdef │ │ │ +001f2f60: 3e69 6e20 3c70 6172 616d 6574 6572 3e63 >in <parameter>c │ │ │ +001f2f70: 7265 6465 6e74 6961 6c73 3c2f 7061 7261 redentials</para │ │ │ +001f2f80: 6d65 7465 723e 2061 6e79 3c2f 7061 7261 meter> any</para │ │ │ +001f2f90: 6d64 6566 3e0a 2020 2020 2020 3c2f 6675 mdef>. </fu │ │ │ +001f2fa0: 6e63 7072 6f74 6f74 7970 653e 0a20 2020 ncprototype>. │ │ │ +001f2fb0: 203c 2f66 756e 6373 796e 6f70 7369 733e </funcsynopsis> │ │ │ +001f2fc0: 0a3c 2f72 6566 7379 6e6f 7073 6973 6469 .</refsynopsisdi │ │ │ +001f2fd0: 763e 0a0a 2020 3c72 6566 7365 6374 3120 v>.. <refsect1 │ │ │ +001f2fe0: 6964 3d22 6465 7363 5f76 7370 5f63 616c id="desc_vsp_cal │ │ │ +001f2ff0: 6375 6c61 7465 5f64 6967 6573 7422 3e3c culate_digest">< │ │ │ +001f3000: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ +001f3010: 6e3c 2f74 6974 6c65 3e0a 2020 2020 2020 n. │ │ │ +001f3020: 3c70 6172 613e 5468 6520 7673 705f 6361 The vsp_ca │ │ │ +001f3030: 6c63 756c 6174 655f 6469 6765 7374 2829 lculate_digest() │ │ │ +001f3040: 2066 756e 6374 696f 6e20 6973 2075 7365 function is use │ │ │ +001f3050: 6420 746f 2063 616c 6375 6c61 7465 206f d to calculate o │ │ │ +001f3060: 6e20 7365 7276 6572 2d73 6964 6520 6120 n server-side a │ │ │ +001f3070: 6469 6765 7374 2074 6f20 7065 7266 6f72 digest to perfor │ │ │ +001f3080: 6d20 610a 4854 5450 2064 6967 6573 7420 m a.HTTP digest │ │ │ +001f3090: 6175 7468 656e 7469 6361 7469 6f6e 2e20 authentication. │ │ │ +001f30a0: 5768 656e 2074 6865 2061 7574 6865 6e74 When the authent │ │ │ +001f30b0: 6963 6174 696f 6e20 7479 7065 2069 7320 ication type is │ │ │ +001f30c0: 2764 6967 6573 7427 2074 6865 2066 756e 'digest' the fun │ │ │ +001f30d0: 6374 696f 6e20 7769 6c6c 2072 6574 7572 ction will retur │ │ │ +001f30e0: 6e20 6120 6d64 350a 6368 6563 6b73 756d n a md5.checksum │ │ │ +001f30f0: 2062 6173 6564 206f 6e20 6372 6564 656e based on creden │ │ │ +001f3100: 7469 616c 732c 2075 7365 7220 6e61 6d65 tials, user name │ │ │ +001f3110: 2061 6e64 2070 6173 7377 6f72 642e 2054 and password. T │ │ │ +001f3120: 6865 2063 6865 636b 7375 6d20 6361 6c63 he checksum calc │ │ │ +001f3130: 756c 6174 696f 6e20 7769 6c6c 2062 6520 ulation will be │ │ │ +001f3140: 6d61 6465 2061 7320 7265 7175 6972 6564 made as required │ │ │ +001f3150: 0a66 6f72 2048 5454 5020 4469 6765 7374 .for HTTP Digest │ │ │ +001f3160: 2061 7574 6865 6e74 6963 6174 696f 6e20 authentication │ │ │ +001f3170: 746f 2063 6f6d 7061 7265 2061 6761 696e to compare again │ │ │ +001f3180: 7374 2027 7265 7370 6f6e 7365 2720 656c st 'response' el │ │ │ +001f3190: 656d 656e 7420 6f66 2063 7265 6465 6e74 ement of credent │ │ │ +001f31a0: 6961 6c73 2e20 4966 2074 6865 2061 7574 ials. If the aut │ │ │ +001f31b0: 6865 6e74 6963 6174 696f 6e0a 6973 2062 hentication.is b │ │ │ +001f31c0: 6173 6963 2061 204e 554c 4c20 7769 6c6c asic a NULL will │ │ │ +001f31d0: 2062 6520 7265 7475 726e 6564 2e0a 2020 be returned.. │ │ │ +001f31e0: 2020 2020 3c2f 7061 7261 3e0a 2020 3c2f . . . < │ │ │ +001f3200: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ +001f3210: 616d 735f 7673 705f 6361 6c63 756c 6174 ams_vsp_calculat │ │ │ +001f3220: 655f 6469 6765 7374 223e 3c74 6974 6c65 e_digest">Parameters</tit │ │ │ +001f3240: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ +001f3250: 323e 3c74 6974 6c65 3e75 7365 726e 616d 2><title>usernam │ │ │ +001f3260: 653c 2f74 6974 6c65 3e0a 093c 7061 7261 e..A string with n │ │ │ +001f3280: 616d 6520 6f66 2074 6865 2075 7365 7220 ame of the user │ │ │ +001f3290: 6163 636f 756e 7420 6e61 6d65 0a09 3c2f account name... . passw │ │ │ +001f32d0: 6f72 643c 2f74 6974 6c65 3e0a 093c 7061 ord..A string with │ │ │ +001f32f0: 2061 2070 6c61 696e 2074 6578 7420 7061 a plain text pa │ │ │ +001f3300: 7373 776f 7264 2066 726f 6d20 7468 6520 ssword from the │ │ │ +001f3310: 7573 6572 7320 7461 626c 6520 2863 616e users table (can │ │ │ +001f3320: 2062 6520 6672 6f6d 2065 7874 6572 6e61 be from externa │ │ │ +001f3330: 6c20 4c44 4150 2073 6572 7665 7220 6574 l LDAP server et │ │ │ +001f3340: 632e 290a 093c 2f70 6172 613e 0a20 2020 c.)... │ │ │ +001f3350: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ +001f3360: 203c 7265 6673 6563 7432 3e3c 7469 746c credentials.... │ │ │ +001f3390: 2020 2041 2076 6563 746f 7220 6f66 206e A vector of n │ │ │ +001f33a0: 616d 652f 7661 6c75 6520 7061 6972 7320 ame/value pairs │ │ │ +001f33b0: 2874 6865 206b 6579 776f 7264 2061 6e64 (the keyword and │ │ │ +001f33c0: 2076 616c 7565 2061 7265 2073 7472 696e value are strin │ │ │ +001f33d0: 6773 2920 6f66 3a0a 093c 2f70 6172 613e gs) of:.. │ │ │ +001f33e0: 0a09 3c74 6162 6c65 3e3c 7469 746c 653e .. │ │ │ +001f33f0: 5661 6c69 6420 7661 6c75 6573 3c2f 7469 Valid values</ti │ │ │ +001f3400: 746c 653e 0a20 2020 2020 203c 7467 726f tle>. <tgro │ │ │ +001f3410: 7570 2063 6f6c 733d 2232 223e 0a09 2020 up cols="2">.. │ │ │ +001f3420: 3c74 6865 6164 3e3c 726f 773e 3c65 6e74 <thead><row><ent │ │ │ +001f3430: 7279 3e4e 616d 653c 2f65 6e74 7279 3e3c ry>Name</entry>< │ │ │ +001f3440: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ +001f3450: 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e3c n</entry></row>< │ │ │ +001f3460: 2f74 6865 6164 3e0a 093c 7462 6f64 793e /thead>..<tbody> │ │ │ +001f3470: 0a09 2020 3c72 6f77 3e20 3c65 6e74 7279 .. <row> <entry │ │ │ +001f3480: 3e61 7574 6874 7970 653c 2f65 6e74 7279 >authtype</entry │ │ │ +001f3490: 3e09 3c65 6e74 7279 3e27 6469 6765 7374 >.<entry>'digest │ │ │ +001f34a0: 2720 6f72 2027 6261 7369 6327 3c2f 656e ' or 'basic'</en │ │ │ +001f34b0: 7472 793e 203c 2f72 6f77 3e0a 0920 203c try> </row>.. < │ │ │ +001f34c0: 726f 773e 203c 656e 7472 793e 7265 616c row> <entry>real │ │ │ +001f34d0: 6d3c 2f65 6e74 7279 3e20 093c 656e 7472 m</entry> .<entr │ │ │ +001f34e0: 793e 6672 6f6d 2048 5454 5020 4175 7468 y>from HTTP Auth │ │ │ +001f34f0: 6f72 697a 6174 696f 6e20 7265 7175 6573 orization reques │ │ │ +001f3500: 7420 6865 6164 6572 3c2f 656e 7472 793e t header</entry> │ │ │ +001f3510: 203c 2f72 6f77 3e0a 0920 203c 726f 773e </row>.. <row> │ │ │ +001f3520: 203c 656e 7472 793e 6d65 7468 6f64 3c2f <entry>method</ │ │ │ +001f3530: 656e 7472 793e 2009 3c65 6e74 7279 3e66 entry> .<entry>f │ │ │ +001f3540: 726f 6d20 4854 5450 2072 6571 7565 7374 rom HTTP request │ │ │ +001f3550: 206c 696e 653c 2f65 6e74 7279 3e20 3c2f line</entry> </ │ │ │ +001f3560: 726f 773e 0a09 2020 3c72 6f77 3e20 3c65 row>.. <row> <e │ │ │ +001f3570: 6e74 7279 3e75 7269 3c2f 656e 7472 793e ntry>uri</entry> │ │ │ +001f3580: 2009 3c65 6e74 7279 3e66 726f 6d20 4854 .<entry>from HT │ │ │ +001f3590: 5450 2041 7574 686f 7269 7a61 7469 6f6e TP Authorization │ │ │ +001f35a0: 2072 6571 7565 7374 2068 6561 6465 723c request header< │ │ │ +001f35b0: 2f65 6e74 7279 3e20 3c2f 726f 773e 0a09 /entry> </row>.. │ │ │ +001f35c0: 2020 3c72 6f77 3e20 3c65 6e74 7279 3e6e <row> <entry>n │ │ │ +001f35d0: 6f6e 6365 3c2f 656e 7472 793e 2009 3c65 once</entry> .<e │ │ │ +001f35e0: 6e74 7279 3e66 726f 6d20 4854 5450 2041 ntry>from HTTP A │ │ │ +001f35f0: 7574 686f 7269 7a61 7469 6f6e 2072 6571 uthorization req │ │ │ +001f3600: 7565 7374 2068 6561 6465 723c 2f65 6e74 uest header</ent │ │ │ +001f3610: 7279 3e20 3c2f 726f 773e 0a09 2020 3c72 ry> </row>.. <r │ │ │ +001f3620: 6f77 3e20 3c65 6e74 7279 3e6e 633c 2f65 ow> <entry>nc</e │ │ │ +001f3630: 6e74 7279 3e20 093c 656e 7472 793e 6672 ntry> .<entry>fr │ │ │ +001f3640: 6f6d 2048 5454 5020 4175 7468 6f72 697a om HTTP Authoriz │ │ │ +001f3650: 6174 696f 6e20 7265 7175 6573 7420 6865 ation request he │ │ │ +001f3660: 6164 6572 3c2f 656e 7472 793e 203c 2f72 ader</entry> </r │ │ │ +001f3670: 6f77 3e0a 0920 203c 726f 773e 203c 656e ow>.. <row> <en │ │ │ +001f3680: 7472 793e 636e 6f6e 6365 3c2f 656e 7472 try>cnonce</entr │ │ │ +001f3690: 793e 2009 3c65 6e74 7279 3e66 726f 6d20 y> .<entry>from │ │ │ +001f36a0: 4854 5450 2041 7574 686f 7269 7a61 7469 HTTP Authorizati │ │ │ +001f36b0: 6f6e 2072 6571 7565 7374 2068 6561 6465 on request heade │ │ │ +001f36c0: 723c 2f65 6e74 7279 3e20 3c2f 726f 773e r</entry> </row> │ │ │ +001f36d0: 0a09 2020 3c72 6f77 3e20 3c65 6e74 7279 .. <row> <entry │ │ │ +001f36e0: 3e71 6f70 3c2f 656e 7472 793e 2009 3c65 >qop</entry> .<e │ │ │ +001f36f0: 6e74 7279 3e66 726f 6d20 4854 5450 2041 ntry>from HTTP A │ │ │ +001f3700: 7574 686f 7269 7a61 7469 6f6e 2072 6571 uthorization req │ │ │ +001f3710: 7565 7374 2068 6561 6465 723c 2f65 6e74 uest header</ent │ │ │ +001f3720: 7279 3e20 3c2f 726f 773e 0a09 2020 3c72 ry> </row>.. <r │ │ │ +001f3730: 6f77 3e20 3c65 6e74 7279 3e72 6573 706f ow> <entry>respo │ │ │ +001f3740: 6e73 653c 2f65 6e74 7279 3e20 3c65 6e74 nse</entry> <ent │ │ │ +001f3750: 7279 3e74 6865 2063 6c69 656e 742d 7369 ry>the client-si │ │ │ +001f3760: 6465 2063 616c 6375 6c61 7465 6420 6469 de calculated di │ │ │ +001f3770: 6765 7374 3c2f 656e 7472 793e 203c 2f72 gest</entry> </r │ │ │ +001f3780: 6f77 3e0a 093c 2f74 626f 6479 3e0a 2020 ow>..</tbody>. │ │ │ +001f3790: 2020 2020 3c2f 7467 726f 7570 3e0a 2020 </tgroup>. │ │ │ +001f37a0: 2020 3c2f 7461 626c 653e 0a20 2020 203c </table>. < │ │ │ +001f37b0: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ +001f37c0: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ +001f37d0: 6563 7431 2069 643d 2272 6574 5f76 7370 ect1 id="ret_vsp │ │ │ +001f37e0: 5f63 616c 6375 6c61 7465 5f64 6967 6573 _calculate_diges │ │ │ +001f37f0: 7422 3e3c 7469 746c 653e 5265 7475 726e t"><title>Return │ │ │ +001f3800: 2054 7970 6573 3c2f 7469 746c 653e 3c70 Types

    ..A string c │ │ │ +001f3820: 6f6e 7461 696e 696e 6720 6d64 3520 6469 ontaining md5 di │ │ │ +001f3830: 6765 7374 2c20 6966 2027 6175 7468 7479 gest, if 'authty │ │ │ +001f3840: 7065 2720 6f70 7469 6f6e 2069 7320 2764 pe' option is 'd │ │ │ +001f3850: 6967 6573 7427 2e20 4f74 6865 7277 6973 igest'. Otherwis │ │ │ +001f3860: 6520 7265 7475 726e 7320 6e75 6c6c 2e0a e returns null.. │ │ │ +001f3870: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 .. │ │ │ +001f3a80: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ +001f3ab0: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ +001f3ac0: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ +001f3ad0: 6d70 6c65 2069 643d 2265 785f 7673 705f mple id="ex_vsp_ │ │ │ +001f3ae0: 6361 6c63 756c 6174 655f 6469 6765 7374 calculate_digest │ │ │ +001f3af0: 223e 3c74 6974 6c65 3e41 2056 5350 2070 "><title>A VSP p │ │ │ +001f3b00: 6167 6520 7065 7266 6f72 6d69 6e67 2064 age performing d │ │ │ +001f3b10: 6967 6573 7420 6175 7468 656e 7469 6361 igest authentica │ │ │ +001f3b20: 7469 6f6e 3c2f 7469 746c 653e 0a09 3c70 tion..

    The followin │ │ │ +001f3b40: 6720 7061 6765 2063 6865 636b 2066 6f72 g page check for │ │ │ +001f3b50: 2064 6967 6573 7420 6175 7468 656e 7469 digest authenti │ │ │ +001f3b60: 6361 7469 6f6e 2061 6e64 2072 6574 7572 cation and retur │ │ │ +001f3b70: 6e73 204f 4b20 6966 2061 7574 6865 6e74 ns OK if authent │ │ │ +001f3b80: 6963 6174 696f 6e20 7375 6363 6565 6473 ication succeeds │ │ │ +001f3b90: 2c0a 0920 2020 206f 7468 6572 7769 7365 ,.. otherwise │ │ │ +001f3ba0: 2069 7420 6173 6b73 2066 6f72 2061 7574 it asks for aut │ │ │ +001f3bb0: 6865 6e74 6963 6174 696f 6e20 6167 6169 hentication agai │ │ │ +001f3bc0: 6e2e 200a 093c 2f70 6172 613e 0a20 2020 n. ... │ │ │ +001f3bd0: 2020 203c 7072 6f67 7261 6d6c 6973 7469 .. -- │ │ │ +001f3d30: 6d61 6b69 6e67 2074 6865 2048 5454 5020 making the HTTP │ │ │ +001f3d40: 4469 6765 7374 2061 7574 6865 6e74 6963 Digest authentic │ │ │ +001f3d50: 6174 696f 6e20 6865 6164 6572 200a 2020 ation header . │ │ │ +001f3d60: 2020 2020 6372 6561 7465 2070 726f 6365 create proce │ │ │ +001f3d70: 6475 7265 2061 7070 5f67 6574 5f61 7574 dure app_get_aut │ │ │ +001f3d80: 6820 2829 0a20 2020 2020 2020 7b0a 2020 h (). {. │ │ │ +001f3d90: 2020 2020 2020 2068 7474 705f 7265 7175 http_requ │ │ │ +001f3da0: 6573 745f 7374 6174 7573 2028 2748 5454 est_status ('HTT │ │ │ +001f3db0: 502f 312e 3120 3430 3120 556e 6175 7468 P/1.1 401 Unauth │ │ │ +001f3dc0: 6f72 697a 6564 2729 3b0a 0920 6874 7470 orized');.. http │ │ │ +001f3dd0: 5f68 6561 6465 7220 2873 7072 696e 7466 _header (sprintf │ │ │ +001f3de0: 2028 2757 5757 2d41 7574 6865 6e74 6963 ('WWW-Authentic │ │ │ +001f3df0: 6174 653a 2044 6967 6573 7420 7265 616c ate: Digest real │ │ │ +001f3e00: 6d3d 2225 7322 2c20 646f 6d61 696e 3d22 m="%s", domain=" │ │ │ +001f3e10: 2573 222c 206e 6f6e 6365 3d22 2573 222c %s", nonce="%s", │ │ │ +001f3e20: 206f 7061 7175 653d 2225 7322 2c20 7374 opaque="%s", st │ │ │ +001f3e30: 616c 653d 2225 7322 2c20 716f 703d 2261 ale="%s", qop="a │ │ │ +001f3e40: 7574 6822 2c20 616c 676f 7269 7468 6d3d uth", algorithm= │ │ │ +001f3e50: 224d 4435 225c 725c 6e27 2c20 276d 795f "MD5"\r\n', 'my_ │ │ │ +001f3e60: 7265 616c 6d27 2c20 6874 7470 5f70 6174 realm', http_pat │ │ │ +001f3e70: 6828 292c 206d 6435 2028 6461 7465 7374 h(), md5 (datest │ │ │ +001f3e80: 7269 6e67 2028 6e6f 7720 2829 2929 2c20 ring (now ())), │ │ │ +001f3e90: 6d64 3520 2827 736f 6d65 2073 7472 696e md5 ('some strin │ │ │ +001f3ea0: 6720 666f 7220 6861 7368 2729 2c20 2766 g for hash'), 'f │ │ │ +001f3eb0: 616c 7365 2729 293b 0a20 2020 2020 2020 alse'));. │ │ │ +001f3ec0: 7d3b 200a 0a20 2020 2020 202d 2d20 7265 }; .. -- re │ │ │ +001f3ed0: 7475 726e 7320 616e 2061 7272 6179 2073 turns an array s │ │ │ +001f3ee0: 7569 7461 626c 6520 666f 7220 7673 705f uitable for vsp_ │ │ │ +001f3ef0: 6361 6c63 756c 6174 655f 6469 6765 7374 calculate_digest │ │ │ +001f3f00: 2020 0a20 2020 2020 2063 7265 6174 6520 . create │ │ │ +001f3f10: 7072 6f63 6564 7572 6520 6170 705f 6175 procedure app_au │ │ │ +001f3f20: 7468 5f76 6563 2028 696e 206c 696e 6573 th_vec (in lines │ │ │ +001f3f30: 2061 6e79 290a 2020 2020 2020 207b 0a09 any). {.. │ │ │ +001f3f40: 2020 6465 636c 6172 6520 6168 6472 2c20 declare ahdr, │ │ │ +001f3f50: 6172 722c 2061 7574 6876 6563 2061 6e79 arr, authvec any │ │ │ +001f3f60: 3b0a 0920 2061 6864 7220 3a3d 2068 7474 ;.. ahdr := htt │ │ │ +001f3f70: 705f 7265 7175 6573 745f 6865 6164 6572 p_request_header │ │ │ +001f3f80: 2028 6c69 6e65 732c 2027 4175 7468 6f72 (lines, 'Author │ │ │ +001f3f90: 697a 6174 696f 6e27 293b 0a09 2020 6966 ization');.. if │ │ │ +001f3fa0: 2028 6973 7374 7269 6e67 2028 6168 6472 (isstring (ahdr │ │ │ +001f3fb0: 2920 616e 6420 6168 6472 206c 696b 6520 ) and ahdr like │ │ │ +001f3fc0: 2744 6967 6573 7425 2729 0a09 2020 2020 'Digest%').. │ │ │ +001f3fd0: 7b0a 0920 2020 2020 2061 6864 7220 3a3d {.. ahdr := │ │ │ +001f3fe0: 2073 7562 7365 7120 2861 6864 722c 2036 subseq (ahdr, 6 │ │ │ +001f3ff0: 2c20 6c65 6e67 7468 2028 6168 6472 2929 , length (ahdr)) │ │ │ +001f4000: 3b0a 0920 2020 2020 2061 7272 203a 3d20 ;.. arr := │ │ │ +001f4010: 7370 6c69 745f 616e 645f 6465 636f 6465 split_and_decode │ │ │ +001f4020: 2028 6168 6472 2c20 302c 2027 5c30 5c30 (ahdr, 0, '\0\0 │ │ │ +001f4030: 2c3d 2729 3b0a 0920 2020 2020 2061 7574 ,=');.. aut │ │ │ +001f4040: 6876 6563 203a 3d20 7665 6374 6f72 2028 hvec := vector ( │ │ │ +001f4050: 2761 7574 6874 7970 6527 2c20 2744 6967 'authtype', 'Dig │ │ │ +001f4060: 6573 7427 2c20 276d 6574 686f 6427 2c20 est', 'method', │ │ │ +001f4070: 6874 7470 5f72 6571 7565 7374 5f67 6574 http_request_get │ │ │ +001f4080: 2028 2752 4551 5545 5354 5f4d 4554 484f ('REQUEST_METHO │ │ │ +001f4090: 4427 2929 3b0a 0920 2020 2020 2066 6f72 D'));.. for │ │ │ +001f40a0: 6561 6368 2028 7661 7263 6861 7220 656c each (varchar el │ │ │ +001f40b0: 6d20 696e 2061 7272 2920 646f 0a09 097b m in arr) do...{ │ │ │ +001f40c0: 0a09 0920 2064 6563 6c61 7265 2065 6c6d ... declare elm │ │ │ +001f40d0: 3120 7661 7263 6861 723b 0a09 0920 2065 1 varchar;... e │ │ │ +001f40e0: 6c6d 3120 3a3d 2074 7269 6d20 2865 6c6d lm1 := trim (elm │ │ │ +001f40f0: 2c20 2722 2027 293b 0a09 0920 2061 7574 , '" ');... aut │ │ │ +001f4100: 6876 6563 203a 3d20 7665 6374 6f72 5f63 hvec := vector_c │ │ │ +001f4110: 6f6e 6361 7420 2861 7574 6876 6563 2c20 oncat (authvec, │ │ │ +001f4120: 7665 6374 6f72 2028 656c 6d31 2929 3b0a vector (elm1));. │ │ │ +001f4130: 0909 7d0a 2020 2020 0920 2020 2020 7d0a ..}. . }. │ │ │ +001f4140: 0920 2020 7265 7475 726e 2061 7574 6876 . return authv │ │ │ +001f4150: 6563 3b09 0a20 2020 2020 2020 7d20 2020 ec;.. } │ │ │ +001f4160: 2020 200a 0920 205d 5d3e 3c2f 7072 6f67 .. ]]>. │ │ │ +001f4180: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . Se │ │ │ +001f41d0: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ +001f41e0: 2020 203c 7061 7261 3e0a 2020 2020 2020 . │ │ │ +001f41f0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 │ │ │ +001f4210: 7668 6f73 745f 6465 6669 6e65 3c2f 6c69 vhost_define. . │ │ │ +001f4230: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......,d │ │ │ +001f4250: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ +001f4260: 6566 2f76 6464 5f6d 6561 7375 7265 5f72 ef/vdd_measure_r │ │ │ +001f4270: 7063 5f74 696d 652e 786d 6cdf 0000 0b85 pc_time.xml..... │ │ │ +001f4280: 3c3f 786d 6c20 7665 7273 696f 6e3d 2231 ... │ │ │ +001f4640: 0a20 2020 203c 7265 6665 6e74 7279 7469 . vdd_measure_ │ │ │ +001f4660: 7270 635f 7469 6d65 3c2f 7265 6665 6e74 rpc_time. rmt. . . vdd_measure │ │ │ +001f46d0: 5f72 7063 5f74 696d 653c 2f72 6566 6e61 _rpc_time. Estimate VDB │ │ │ +001f4700: 2052 5043 2072 6f75 6e64 2d74 7269 7020 RPC round-trip │ │ │ +001f4710: 666f 7220 6120 6769 7665 6e20 4453 4e20 for a given DSN │ │ │ +001f4720: 696e 206d 696c 6c69 7365 636f 6e64 733c in milliseconds< │ │ │ +001f4730: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ +001f4740: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ +001f4750: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ +001f4760: 2020 2020 3c66 756e 6373 796e 6f70 7369 . . │ │ │ +001f47d0: 203c 6675 6e63 6465 663e 666c 6f61 7420 float │ │ │ +001f47e0: 3c66 756e 6374 696f 6e3e 7664 645f 6d65 vdd_me │ │ │ +001f47f0: 6173 7572 655f 7270 635f 7469 6d65 3c2f asure_rpc_time..i │ │ │ +001f4820: 6e20 3c70 6172 616d 6574 6572 3e5f 6473 n _ds │ │ │ +001f4830: 6e3c 2f70 6172 616d 6574 6572 3e20 7661 n va │ │ │ +001f4840: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +001f4850: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ +001f4890: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ +001f48c0: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ +001f48d0: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001f48e0: 7061 7261 3e54 6869 7320 6675 6e63 7469 para>This functi │ │ │ +001f48f0: 6f6e 2077 696c 6c20 7265 7475 726e 2074 on will return t │ │ │ +001f4900: 6865 2065 7374 696d 6174 6564 206e 756d he estimated num │ │ │ +001f4910: 6265 7220 6f66 206d 696c 6c69 7365 636f ber of milliseco │ │ │ +001f4920: 6e64 7320 746f 200a 0970 6572 666f 726d nds to ..perform │ │ │ +001f4930: 2061 6e20 5250 4320 726f 756e 6420 7472 an RPC round tr │ │ │ +001f4940: 6970 206f 6e20 7468 6520 4453 4e20 7375 ip on the DSN su │ │ │ +001f4950: 7070 6c69 6564 2e3c 2f70 6172 613e 0a20 pplied.. │ │ │ +001f4960: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001f4970: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ +001f4980: 616d 735f 7664 645f 6d65 6173 7572 655f ams_vdd_measure_ │ │ │ +001f4990: 7270 635f 7469 6d65 223e 0a20 2020 203c rpc_time">. < │ │ │ +001f49a0: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ +001f49b0: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . _d │ │ │ +001f49d0: 736e 3c2f 7469 746c 653e 0a20 2020 2020 sn. │ │ │ +001f49e0: 203c 7061 7261 3e54 6865 206e 616d 6520 The name │ │ │ +001f49f0: 6f66 2074 6865 2064 6174 6120 736f 7572 of the data sour │ │ │ +001f4a00: 6365 2074 6f20 6573 7469 6d61 7465 2072 ce to estimate r │ │ │ +001f4a10: 6f75 6e64 2d74 7269 7020 7469 6d65 2066 ound-trip time f │ │ │ +001f4a20: 6f72 2e3c 2f70 6172 613e 0a20 2020 203c or.. < │ │ │ +001f4a30: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. . Return │ │ │ +001f4a80: 2054 7970 6573 3c2f 7469 746c 653e 0a20 Types. │ │ │ +001f4a90: 2020 203c 7061 7261 3e54 6865 206c 656e The len │ │ │ +001f4aa0: 6774 6820 6f66 2074 696d 6520 7461 6b65 gth of time take │ │ │ +001f4ab0: 6e20 696e 206d 696c 6c69 7365 636f 6e64 n in millisecond │ │ │ +001f4ac0: 7320 6173 2061 2066 6c6f 6174 2074 7970 s as a float typ │ │ │ +001f4ad0: 652e 3c2f 7061 7261 3e0a 2020 3c2f 7265 e.. ... │ │ │ +001f51f0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ +001f5200: 3c72 6566 656e 7472 7974 6974 6c65 3e52 R │ │ │ +001f5210: 4550 4c5f 4144 445f 534e 4150 5348 4f54 EPL_ADD_SNAPSHOT │ │ │ +001f5220: 5f43 523c 2f72 6566 656e 7472 7974 6974 _CR. repl. . . REPL_ADD_SNAPSH │ │ │ +001f5290: 4f54 5f43 523c 2f72 6566 6e61 6d65 3e0a OT_CR. │ │ │ +001f52a0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +001f52b0: 4372 6561 7465 7320 636f 6e66 6c69 6374 Creates conflict │ │ │ +001f52c0: 2072 6573 6f6c 7665 7220 666f 7220 6269 resolver for bi │ │ │ +001f52d0: 2d64 6972 6563 7469 6f6e 616c 2072 6570 -directional rep │ │ │ +001f52e0: 6c69 6361 7469 6f6e 3c2f 7265 6670 7572 lication. . . . │ │ │ +001f5350: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . None REPL_ADD_SNAPS │ │ │ +001f53b0: 484f 545f 4352 3c2f 6675 6e63 7469 6f6e HOT_CR. │ │ │ +001f53d0: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ +001f53e0: 203c 7061 7261 6d65 7465 723e 7462 6c3c tbl< │ │ │ +001f53f0: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ +001f5400: 6861 723c 2f70 6172 616d 6465 663e 0a20 har. │ │ │ +001f5410: 2020 2020 2020 203c 7061 7261 6d64 6566 in n │ │ │ +001f5430: 616d 655f 7375 6666 6978 3c2f 7061 7261 ame_suffix varchar. │ │ │ +001f5460: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ +001f5470: 7061 7261 6d65 7465 723e 7479 7065 3c2f parameter>type char< │ │ │ +001f5490: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +001f54a0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ +001f54b0: 3c70 6172 616d 6574 6572 3e6f 7264 6572 order │ │ │ +001f54c0: 3c2f 7061 7261 6d65 7465 723e 2069 6e74 int │ │ │ +001f54d0: 6567 6572 3c2f 7061 7261 6d64 6566 3e0a eger. │ │ │ +001f54e0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +001f5500: 636c 6173 733c 2f70 6172 616d 6574 6572 class varchar. in col varchar. . │ │ │ +001f5580: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . . De │ │ │ +001f55e0: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. Simp │ │ │ +001f5600: 6c65 2063 6f6e 666c 6963 7420 7265 736f le conflict reso │ │ │ +001f5610: 6c76 6572 7320 6361 6e20 6265 2067 656e lvers can be gen │ │ │ +001f5620: 6572 6174 6564 2062 7920 6361 6c6c 696e erated by callin │ │ │ +001f5630: 6720 7468 6973 2066 756e 6374 696f 6e2e g this function. │ │ │ +001f5640: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . Parame │ │ │ +001f5690: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ +001f56a0: 203c 7265 6673 6563 7432 3e3c 7469 746c tbl. │ │ │ +001f56c0: 2020 2020 3c70 6172 613e 4e61 6d65 206f Name o │ │ │ +001f56d0: 6620 7461 626c 6520 666f 7220 7768 6963 f table for whic │ │ │ +001f56e0: 6820 636f 6e66 6c69 6374 2072 6573 6f6c h conflict resol │ │ │ +001f56f0: 7665 6420 6973 2072 6571 7569 7265 642e ved is required. │ │ │ +001f5700: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . name_suf │ │ │ +001f5730: 6669 783c 2f74 6974 6c65 3e0a 2020 2020 fix. │ │ │ +001f5740: 2020 3c70 6172 613e 436f 6e66 6c69 6374 Conflict │ │ │ +001f5750: 2072 6573 6f6c 7665 7220 6e61 6d65 2073 resolver name s │ │ │ +001f5760: 7566 6669 782e 3c2f 7061 7261 3e3c 2f72 uffix.. ty │ │ │ +001f5790: 7065 3c2f 7469 746c 653e 0a20 2020 2020 pe. │ │ │ +001f57a0: 203c 7061 7261 3e54 6865 2072 6573 6f6c The resol │ │ │ +001f57b0: 7665 6420 7479 7065 2c20 6f6e 6520 6f66 ved type, one of │ │ │ +001f57c0: 3a20 2826 2333 393b 4926 2333 393b 2c20 : ('I', │ │ │ +001f57d0: 2623 3339 3b55 2623 3339 3b20 4f52 2026 'U' OR & │ │ │ +001f57e0: 2333 393b 4426 2333 393b 292e 3c2f 7061 #39;D').. │ │ │ +001f5800: 2020 203c 7265 6673 6563 7432 3e3c 7469 order. Re │ │ │ +001f5830: 736f 6c76 6572 206f 7264 6572 206e 756d solver order num │ │ │ +001f5840: 6265 722e 3c2f 7061 7261 3e3c 2f72 6566 ber.. clas │ │ │ +001f5870: 733c 2f74 6974 6c65 3e0a 2020 2020 2020 s. │ │ │ +001f5880: 3c70 6172 613e 5468 6520 6b69 6e64 206f The kind o │ │ │ +001f5890: 6620 7265 736f 6c76 6572 2e20 2043 6c61 f resolver. Cla │ │ │ +001f58a0: 7373 2063 616e 2062 6520 6f6e 6520 6f66 ss can be one of │ │ │ +001f58b0: 2074 6865 2066 6f6c 6c6f 7769 6e67 3a3c the following:< │ │ │ +001f58c0: 2f70 6172 613e 200a 3c73 696d 706c 656c /para> .. < │ │ │ +001f58e0: 656d 7068 6173 6973 3e26 2333 393b 6d61 emphasis>'ma │ │ │ +001f58f0: 7826 2333 393b 3c2f 656d 7068 6173 6973 x'. row with max │ │ │ +001f5910: 696d 756d 2076 616c 7565 206f 6620 7370 imum value of sp │ │ │ +001f5920: 6563 6966 6965 6420 636f 6c75 6d6e 2077 ecified column w │ │ │ +001f5930: 696e 733c 2f6d 656d 6265 723e 0a20 203c ins. < │ │ │ +001f5940: 6d65 6d62 6572 3e3c 656d 7068 6173 6973 member>'min'. row │ │ │ +001f5970: 7769 7468 206d 696e 696d 756d 2076 616c with minimum val │ │ │ +001f5980: 7565 206f 6620 7370 6563 6966 6965 6420 ue of specified │ │ │ +001f5990: 636f 6c75 6d6e 2077 696e 733c 2f6d 656d column wins. < │ │ │ +001f59b0: 656d 7068 6173 6973 3e26 2333 393b 6176 emphasis>'av │ │ │ +001f59c0: 6526 2333 393b 3c2f 656d 7068 6173 6973 e'. new value of │ │ │ +001f59e0: 2073 7065 6369 6669 6564 2063 6f6c 756d specified colum │ │ │ +001f59f0: 6e20 6973 2063 616c 6375 6c61 7465 6420 n is calculated │ │ │ +001f5a00: 6173 3a20 0a3c 636f 6d70 7574 6572 6f75 as: .current_val │ │ │ +001f5a20: 203d 2028 6375 7272 656e 745f 7661 6c20 = (current_val │ │ │ +001f5a30: 2b20 6e65 775f 7661 6c29 202f 2032 3c2f + new_val) / 2< │ │ │ +001f5a50: 2f6d 656d 6265 723e 0a20 203c 6d65 6d62 /member>.  │ │ │ +001f5a70: 393b 7075 625f 7769 6e73 2623 3339 3b3c 9;pub_wins'< │ │ │ +001f5a80: 2f65 6d70 6861 7369 733e 3c2f 6d65 6d62 /emphasis>. 'cus │ │ │ +001f5ab0: 746f 6d26 2333 393b 3c2f 656d 7068 6173 tom'. publisher │ │ │ +001f5ad0: 616c 7761 7973 2077 696e 733c 2f6d 656d always wins. < │ │ │ +001f5af0: 656d 7068 6173 6973 3e26 2333 393b 7375 emphasis>'su │ │ │ +001f5b00: 625f 7769 6e73 2623 3339 3b3c 2f65 6d70 b_wins'. subscri │ │ │ +001f5b20: 6265 7220 616c 7761 7973 2077 696e 733c ber always wins< │ │ │ +001f5b30: 2f6d 656d 6265 723e 0a3c 2f73 696d 706c /member>... col</tit │ │ │ +001f5b70: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +001f5b80: 5468 6973 2073 686f 756c 6420 7370 6563 This should spec │ │ │ +001f5b90: 6966 7920 7468 6520 636f 6c75 6d6e 206e ify the column n │ │ │ +001f5ba0: 616d 6520 6966 203c 636f 6d70 7574 6572 ame if <computer │ │ │ +001f5bb0: 6f75 7470 7574 3e63 6c61 7373 3c2f 636f output>class</co │ │ │ +001f5bc0: 6d70 7574 6572 6f75 7470 7574 3e20 6973 mputeroutput> is │ │ │ +001f5bd0: 206e 6f74 206f 6e65 206f 6620 2623 3339 not one of ' │ │ │ +001f5be0: 3b70 7562 5f77 696e 7326 2333 393b 2c20 ;pub_wins', │ │ │ +001f5bf0: 2623 3339 3b73 7562 5f77 696e 7326 2333 'sub_wins │ │ │ +001f5c00: 393b 206f 7220 2623 3339 3b63 7573 746f 9; or 'custo │ │ │ +001f5c10: 6d26 2333 393b 2e3c 2f70 6172 613e 3c2f m'.</para></ │ │ │ +001f5c20: 7265 6673 6563 7432 3e0a 2020 3c2f 7265 refsect2>. </re │ │ │ +001f5c30: 6673 6563 7431 3e0a 2020 3c72 6566 7365 fsect1>. <refse │ │ │ +001f5c40: 6374 3120 6964 3d22 7265 745f 5245 504c ct1 id="ret_REPL │ │ │ +001f5c50: 5f41 4444 5f53 4e41 5053 484f 545f 4352 _ADD_SNAPSHOT_CR │ │ │ +001f5c60: 223e 3c74 6974 6c65 3e52 6574 7572 6e20 "><title>Return │ │ │ +001f5c70: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ +001f5c80: 2020 3c70 6172 613e 4e6f 6e65 2e3c 2f70 None.

    .. . │ │ │ +001f5d60: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ +001f5d90: 0a20 2020 203c 7469 746c 653e 4578 616d . Exam │ │ │ +001f5da0: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ +001f5db0: 203c 6578 616d 706c 6520 6964 3d22 6578 Co │ │ │ +001f5de0: 6e66 6c69 6374 2052 6573 6f6c 7665 723c nflict Resolver< │ │ │ +001f5df0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +001f5e00: 6172 613e 5375 7070 6f73 6520 7765 2068 ara>Suppose we h │ │ │ +001f5e10: 6176 6520 7468 6520 666f 6c6c 6f77 696e ave the followin │ │ │ +001f5e20: 6720 7461 626c 653a 3c2f 7061 7261 3e0a g table:</para>. │ │ │ +001f5e30: 2020 2020 2020 3c73 6372 6565 6e3e 0a63 <screen>.c │ │ │ +001f5e40: 7265 6174 6520 7461 626c 6520 6974 656d reate table item │ │ │ +001f5e50: 7328 0a20 2069 7465 6d5f 6964 2069 6e74 s(. item_id int │ │ │ +001f5e60: 6567 6572 2070 7269 6d61 7279 206b 6579 eger primary key │ │ │ +001f5e70: 2c0a 0a20 206e 616d 6520 7661 7263 6861 ,.. name varcha │ │ │ +001f5e80: 722c 0a20 2070 7269 6365 2064 6563 696d r,. price decim │ │ │ +001f5e90: 616c 0a29 3b0a 3c2f 7363 7265 656e 3e0a al.);.</screen>. │ │ │ +001f5ea0: 0a3c 7061 7261 3e41 2026 2333 393b 5526 .<para>A 'U& │ │ │ +001f5eb0: 2333 393b 2063 6f6e 666c 6963 7420 7265 #39; conflict re │ │ │ +001f5ec0: 736f 6c76 6572 2074 6861 7420 6176 6572 solver that aver │ │ │ +001f5ed0: 6167 6573 2069 7465 6d73 2e70 7269 6365 ages items.price │ │ │ +001f5ee0: 2069 6e20 7075 626c 6973 6865 7220 7461 in publisher ta │ │ │ +001f5ef0: 626c 650a 6361 6e20 6265 2064 6566 696e ble.can be defin │ │ │ +001f5f00: 6564 2077 6974 6820 7468 6520 666f 6c6c ed with the foll │ │ │ +001f5f10: 6f77 696e 6720 7374 6174 656d 656e 743a owing statement: │ │ │ +001f5f20: 3c2f 7061 7261 3e0a 0a20 2020 2020 203c </para>.. < │ │ │ +001f5f30: 7363 7265 656e 3e0a 5245 504c 5f41 4444 screen>.REPL_ADD │ │ │ +001f5f40: 5f53 4e41 5053 484f 545f 4352 2826 2333 _SNAPSHOT_CR( │ │ │ +001f5f50: 393b 4442 2e44 4241 2e69 7465 6d73 2623 9;DB.DBA.items&# │ │ │ +001f5f60: 3339 3b2c 2026 2333 393b 636f 756e 7426 39;, 'count& │ │ │ +001f5f70: 2333 393b 2c20 2623 3339 3b55 2623 3339 #39;, 'U' │ │ │ +001f5f80: 3b2c 2031 302c 2026 2333 393b 6176 6526 ;, 10, 'ave& │ │ │ +001f5f90: 2333 393b 2c20 2623 3339 3b70 7269 6365 #39;, 'price │ │ │ +001f5fa0: 2623 3339 3b29 3b0a 3c2f 7363 7265 656e ');.</screen │ │ │ +001f5fb0: 3e0a 2020 2020 3c2f 6578 616d 706c 653e >. </example> │ │ │ +001f5fc0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ +001f5fd0: 203c 7265 6673 6563 7431 2069 643d 2273 <refsect1 id="s │ │ │ +001f5fe0: 6565 616c 736f 5f52 4550 4c5f 4144 445f eealso_REPL_ADD_ │ │ │ +001f5ff0: 534e 4150 5348 4f54 5f43 5222 3e0a 2020 SNAPSHOT_CR">. │ │ │ +001f6000: 2020 3c74 6974 6c65 3e53 6565 2041 6c73 <title>See Als │ │ │ +001f6010: 6f3c 2f74 6974 6c65 3e0a 2020 2020 2020 o. │ │ │ +001f6020: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b REPL_ADD_DAV_ │ │ │ +001f6060: 4352 2829 3c2f 6675 6e63 7469 6f6e 3e3c CR()< │ │ │ +001f6070: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +001f6080: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 .. ..... │ │ │ +001f60a0: 2d64 656d 6f2f 646f 6373 7263 2f66 756e -demo/docsrc/fun │ │ │ +001f60b0: 6372 6566 2f66 6b5f 6368 6563 6b5f 696e cref/fk_check_in │ │ │ +001f60c0: 7075 745f 7661 6c75 6573 2e78 6d6c df00 put_values.xml.. │ │ │ +001f60d0: 0008 623c 3f78 6d6c 2076 6572 7369 6f6e ..b.< │ │ │ +001f6100: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ +001f6110: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ +001f6120: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ +001f6130: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ +001f6140: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ +001f6150: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ +001f6160: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ +001f6170: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ +001f6180: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ +001f6190: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ +001f61a0: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ +001f61b0: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ +001f61c0: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ +001f61d0: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ +001f61e0: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ +001f61f0: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ +001f6200: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ +001f6210: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ +001f6220: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ +001f6230: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ +001f6240: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ +001f6250: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ +001f6260: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ +001f6270: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ +001f6280: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ +001f6290: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ +001f62a0: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ +001f62b0: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ +001f62c0: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ +001f62d0: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ +001f62e0: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ +001f62f0: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ +001f6300: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ +001f6310: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ +001f6320: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ +001f6330: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ +001f6340: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ +001f6350: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ +001f6360: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ +001f6370: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ +001f6380: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ +001f6390: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ +001f63a0: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ +001f63b0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ +001f63c0: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ +001f63d0: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ +001f63e0: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ +001f63f0: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ +001f6400: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ +001f6410: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ +001f6420: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ +001f6430: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ +001f6440: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ +001f6450: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ +001f6460: 3c21 2d2d 2066 6b5f 656e 666f 7263 6520 .. < │ │ │ +001f64a0: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. fk_c │ │ │ +001f64c0: 6865 636b 5f69 6e70 7574 5f76 616c 7565 heck_input_value │ │ │ +001f64d0: 733c 2f72 6566 656e 7472 7974 6974 6c65 s. admin. . . │ │ │ +001f6530: 666b 5f63 6865 636b 5f69 6e70 7574 5f76 fk_check_input_v │ │ │ +001f6540: 616c 7565 733c 2f72 6566 6e61 6d65 3e0a alues. │ │ │ +001f6550: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +001f6560: 616c 7465 7220 6465 6661 756c 7420 666f alter default fo │ │ │ +001f6570: 7265 6967 6e20 6b65 7920 6368 6563 6b69 reign key checki │ │ │ +001f6580: 6e67 2062 6568 6176 696f 723c 2f72 6566 ng behavior. . . │ │ │ +001f65c0: 3c66 756e 6373 796e 6f70 7369 7320 6964 . │ │ │ +001f65f0: 2020 2020 203c 6675 6e63 7072 6f74 6f74 . < │ │ │ +001f6630: 6675 6e63 6465 663e 4442 2e44 4241 2e3c funcdef>DB.DBA.< │ │ │ +001f6640: 6675 6e63 7469 6f6e 3e66 6b5f 6368 6563 function>fk_chec │ │ │ +001f6650: 6b5f 696e 7075 745f 7661 6c75 6573 3c2f k_input_values. in mode integer. . │ │ │ +001f66d0: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Descri │ │ │ +001f6730: 7074 696f 6e3c 2f74 6974 6c65 3e0a 3c73 ption...mode = 1 - o │ │ │ +001f6760: 6e3c 2f6d 656d 6265 723e 0a09 3c6d 656d n..mode = 0 - o │ │ │ +001f6780: 6666 3c2f 6d65 6d62 6572 3e0a 3c2f 7369 ff....Enforcing fore │ │ │ +001f67b0: 6967 6e20 6b65 7920 636f 6e73 7472 6169 ign key constrai │ │ │ +001f67c0: 6e74 7320 6973 2065 6e61 626c 6564 2062 nts is enabled b │ │ │ +001f67d0: 7920 6465 6661 756c 742e 0a54 6869 7320 y default..This │ │ │ +001f67e0: 6675 6e63 7469 6f6e 2061 6c6c 6f77 7320 function allows │ │ │ +001f67f0: 676c 6f62 616c 6c79 2064 6973 6162 6c69 globally disabli │ │ │ +001f6800: 6e67 2069 7420 7769 7468 6f75 7420 686f ng it without ho │ │ │ +001f6810: 7765 7665 7220 6469 7361 626c 696e 6720 wever disabling │ │ │ +001f6820: 616c 6c20 7472 6967 6765 7273 2e0a 5468 all triggers..Th │ │ │ +001f6830: 6973 206d 6179 2062 6520 7573 6566 756c is may be useful │ │ │ +001f6840: 2066 6f72 206c 6172 6765 2064 6174 6120 for large data │ │ │ +001f6850: 696d 706f 7274 7320 6f72 206f 7468 6572 imports or other │ │ │ +001f6860: 2073 7065 6369 616c 2063 6972 6375 6d73 special circums │ │ │ +001f6870: 7461 6e63 6573 2e0a 5468 6520 7265 7475 tances..The retu │ │ │ +001f6880: 726e 2076 616c 7565 2069 7320 7468 6520 rn value is the │ │ │ +001f6890: 7072 6576 696f 7573 2073 7461 7465 206f previous state o │ │ │ +001f68a0: 6620 7468 6973 2073 6574 7469 6e67 2c20 f this setting, │ │ │ +001f68b0: 3020 666f 7220 6f66 662c 2031 2c20 666f 0 for off, 1, fo │ │ │ +001f68c0: 7220 6f6e 2e20 2054 6865 2065 6666 6563 r on. The effec │ │ │ +001f68d0: 7420 6f66 2074 6869 7320 6675 6e63 7469 t of this functi │ │ │ +001f68e0: 6f6e 2069 7320 7065 7273 6973 7465 6e74 on is persistent │ │ │ +001f68f0: 2061 6e64 2073 7572 7669 7665 7320 7365 and survives se │ │ │ +001f6900: 7276 6572 2072 6573 7461 7274 2e0a 3c2f rver restart....... │ │ │ +001f6930: 0a0a 0a0a 0ab6 0000 0027 6465 6d6f 2f64 .........'demo/d │ │ │ +001f6940: 6f63 7372 632f 6675 6e63 7265 662f 6973 ocsrc/funcref/is │ │ │ +001f6950: 5f74 696d 657a 6f6e 656c 6573 732e 786d _timezoneless.xm │ │ │ +001f6960: 6cdf 0000 0d08 3c3f 786d 6c20 7665 7273 l........ . is_timezo │ │ │ +001f6d30: 6e65 6c65 7373 3c2f 7265 6665 6e74 7279 neless. time. . . is_timezonel │ │ │ +001f6da0: 6573 733c 2f72 6566 6e61 6d65 3e0a 2020 ess. │ │ │ +001f6db0: 2020 3c72 6566 7075 7270 6f73 653e 7265 re │ │ │ +001f6dc0: 7475 726e 7320 3120 666f 7220 7469 6d65 turns 1 for time │ │ │ +001f6dd0: 7a6f 6e65 6c65 7373 2061 7267 756d 656e zoneless argumen │ │ │ +001f6de0: 7473 2c20 7a65 726f 2066 6f72 2074 696d ts, zero for tim │ │ │ +001f6df0: 657a 6f6e 6564 3c2f 7265 6670 7572 706f ezoned. . . . . datetime │ │ │ +001f6ea0: 3c66 756e 6374 696f 6e3e 6973 5f74 696d is_tim │ │ │ +001f6eb0: 657a 6f6e 656c 6573 733c 2f66 756e 6374 ezoneless. │ │ │ +001f6ed0: 2020 2020 2020 203c 7061 7261 6d64 6566 in d │ │ │ +001f6ef0: 743c 2f70 6172 616d 6574 6572 3e20 6461 t da │ │ │ +001f6f00: 7465 7469 6d65 3c2f 7061 7261 6d64 6566 tetime. . . < │ │ │ +001f6f40: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ +001f6f50: 0a20 203c 7265 6673 6563 7431 2069 643d . De │ │ │ +001f6f80: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. The │ │ │ +001f6fa0: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ +001f6fb0: 2031 2066 6f72 2074 696d 657a 6f6e 656c 1 for timezonel │ │ │ +001f6fc0: 6573 7320 6172 6775 6d65 6e74 732c 207a ess arguments, z │ │ │ +001f6fd0: 6572 6f20 666f 7220 7469 6d65 7a6f 6e65 ero for timezone │ │ │ +001f6fe0: 642e 3c2f 7061 7261 3e0a 2020 3c2f 7265 d.. . │ │ │ +001f7020: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ +001f7030: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. . < │ │ │ +001f7050: 7469 746c 653e 6474 3c2f 7469 746c 653e title>dt │ │ │ +001f7060: 0a20 2020 2020 203c 7061 7261 3e44 6174 . Dat │ │ │ +001f7070: 6574 696d 6520 7661 6c75 652e 3c2f 7061 etime value.. . . Examples. │ │ │ +001f7110: 5369 6d70 6c65 2065 7861 6d70 6c65 3c2f Simple example</ │ │ │ +001f7120: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ +001f7130: 7261 3e3c 2f70 6172 613e 0a3c 7363 7265 ra></para>.<scre │ │ │ +001f7140: 656e 3e0a 5351 4c3e 2073 656c 6563 7420 en>.SQL> select │ │ │ +001f7150: 6973 5f74 696d 657a 6f6e 656c 6573 7320 is_timezoneless │ │ │ +001f7160: 2863 6173 7420 2827 3139 3939 2d31 322d (cast ('1999-12- │ │ │ +001f7170: 3331 2031 313a 3539 2720 6173 2064 6174 31 11:59' as dat │ │ │ +001f7180: 6574 696d 6529 293b 0a49 4e54 4547 4552 etime));.INTEGER │ │ │ +001f7190: 0a20 300a 4e6f 2e20 6f66 2072 6f77 7320 . 0.No. of rows │ │ │ +001f71a0: 696e 2072 6573 756c 743a 2031 0a3c 2f73 in result: 1.</s │ │ │ +001f71b0: 6372 6565 6e3e 0a20 2020 203c 2f65 7861 creen>. </exa │ │ │ +001f71c0: 6d70 6c65 3e0a 2020 3c2f 7265 6673 6563 mple>. </refsec │ │ │ +001f71d0: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +001f71e0: 6964 3d22 7365 6561 6c73 6f5f 6973 5f74 id="seealso_is_t │ │ │ +001f71f0: 696d 657a 6f6e 656c 6573 7322 3e3c 7469 imezoneless"><ti │ │ │ +001f7200: 746c 653e 5365 6520 416c 736f 3c2f 7469 tle>See Also</ti │ │ │ +001f7210: 746c 653e 0a20 2020 203c 7061 7261 3e3c tle>. <para>< │ │ │ +001f7220: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f7230: 5f6e 6f77 223e 3c66 756e 6374 696f 6e3e _now"><function> │ │ │ +001f7240: 6e6f 773c 2f66 756e 6374 696f 6e3e 3c2f now</function></ │ │ │ +001f7250: 6c69 6e6b 3e3c 2f70 6172 613e 0a20 2020 link></para>. │ │ │ +001f7260: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e <para><link lin │ │ │ +001f7270: 6b65 6e64 3d22 666e 5f74 696d 657a 6f6e kend="fn_timezon │ │ │ +001f7280: 6522 3e3c 6675 6e63 7469 6f6e 3e74 696d e"><function>tim │ │ │ +001f7290: 657a 6f6e 653c 2f66 756e 6374 696f 6e3e ezone</function> │ │ │ +001f72a0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ +001f72b0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ +001f72c0: 696e 6b65 6e64 3d22 666e 5f66 6f72 6765 inkend="fn_forge │ │ │ +001f72d0: 745f 7469 6d65 7a6f 6e65 223e 3c66 756e t_timezone"><fun │ │ │ +001f72e0: 6374 696f 6e3e 666f 7267 6574 5f74 696d ction>forget_tim │ │ │ +001f72f0: 657a 6f6e 653c 2f66 756e 6374 696f 6e3e ezone</function> │ │ │ +001f7300: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ +001f7310: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ +001f7320: 696e 6b65 6e64 3d22 666e 5f61 646a 7573 inkend="fn_adjus │ │ │ +001f7330: 745f 7469 6d65 7a6f 6e65 223e 3c66 756e t_timezone"><fun │ │ │ +001f7340: 6374 696f 6e3e 6164 6a75 7374 5f74 696d ction>adjust_tim │ │ │ +001f7350: 657a 6f6e 653c 2f66 756e 6374 696f 6e3e ezone</function> │ │ │ +001f7360: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 </link></para>. │ │ │ +001f7370: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c <para><link l │ │ │ +001f7380: 696e 6b65 6e64 3d22 666e 5f72 6466 5f6e inkend="fn_rdf_n │ │ │ +001f7390: 6f77 5f69 6d70 6c22 3e3c 6675 6e63 7469 ow_impl"><functi │ │ │ +001f73a0: 6f6e 3e72 6466 5f6e 6f77 5f69 6d70 6c3c on>rdf_now_impl< │ │ │ +001f73b0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +001f73c0: 3e3c 2f70 6172 613e 0a20 2020 203c 7061 ></para>. <pa │ │ │ +001f73d0: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001f73e0: 3d22 666e 5f63 7572 7265 6e74 5f74 696d ="fn_current_tim │ │ │ +001f73f0: 6573 7461 6d70 223e 3c66 756e 6374 696f estamp"><functio │ │ │ +001f7400: 6e3e 6375 7272 656e 745f 7469 6d65 7374 n>current_timest │ │ │ +001f7410: 616d 703c 2f66 756e 6374 696f 6e3e 3c2f amp</function></ │ │ │ +001f7420: 6c69 6e6b 3e3c 2f70 6172 613e 0a20 2020 link></para>. │ │ │ +001f7430: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e <para><link lin │ │ │ +001f7440: 6b65 6e64 3d22 666e 5f63 7572 6461 7465 kend="fn_curdate │ │ │ +001f7450: 7469 6d65 223e 3c66 756e 6374 696f 6e3e time"><function> │ │ │ +001f7460: 6375 7264 6174 6574 696d 653c 2f66 756e curdatetime</fun │ │ │ +001f7470: 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 ction></link></p │ │ │ +001f7480: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ +001f7490: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f74a0: 5f63 7572 6461 7465 7469 6d65 6f66 6673 _curdatetimeoffs │ │ │ +001f74b0: 6574 223e 3c66 756e 6374 696f 6e3e 6375 et"><function>cu │ │ │ +001f74c0: 7264 6174 6574 696d 656f 6666 7365 743c rdatetimeoffset< │ │ │ +001f74d0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +001f74e0: 3e3c 2f70 6172 613e 0a20 2020 203c 7061 ></para>. <pa │ │ │ +001f74f0: 7261 3e3c 6c69 6e6b 206c 696e 6b65 6e64 ra><link linkend │ │ │ +001f7500: 3d22 666e 5f63 7572 7574 6364 6174 6574 ="fn_curutcdatet │ │ │ +001f7510: 696d 6522 3e3c 6675 6e63 7469 6f6e 3e63 ime"><function>c │ │ │ +001f7520: 7572 7574 6364 6174 6574 696d 653c 2f66 urutcdatetime</f │ │ │ +001f7530: 756e 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c unction></link>< │ │ │ +001f7540: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ +001f7550: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +001f7560: 666e 5f73 7973 7574 6364 6174 6574 696d fn_sysutcdatetim │ │ │ +001f7570: 6522 3e3c 6675 6e63 7469 6f6e 3e73 7973 e"><function>sys │ │ │ +001f7580: 7574 6364 6174 6574 696d 653c 2f66 756e utcdatetime</fun │ │ │ +001f7590: 6374 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 ction></link></p │ │ │ +001f75a0: 6172 613e 0a20 2020 203c 7061 7261 3e3c ara>. <para>< │ │ │ +001f75b0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f75c0: 5f73 7472 696e 6764 6174 6522 3e3c 6675 _stringdate"><fu │ │ │ +001f75d0: 6e63 7469 6f6e 3e73 7472 696e 6764 6174 nction>stringdat │ │ │ +001f75e0: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e</function></li │ │ │ +001f75f0: 6e6b 3e3c 2f70 6172 613e 0a20 2020 203c nk></para>. < │ │ │ +001f7600: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para><link linke │ │ │ +001f7610: 6e64 3d22 666e 5f64 6174 6573 7472 696e nd="fn_datestrin │ │ │ +001f7620: 6722 3e3c 6675 6e63 7469 6f6e 3e64 6174 g"><function>dat │ │ │ +001f7630: 6573 7472 696e 673c 2f66 756e 6374 696f estring</functio │ │ │ +001f7640: 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 613e n></link></para> │ │ │ +001f7650: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . </refsect1>.< │ │ │ +001f7660: 2f72 6566 656e 7472 793e 0a0a 0a0a b600 /refentry>...... │ │ │ +001f7670: 0000 2b64 656d 6f2f 646f 6373 7263 2f66 ..+demo/docsrc/f │ │ │ +001f7680: 756e 6372 6566 2f78 6d6c 5f6e 7365 7870 uncref/xml_nsexp │ │ │ +001f7690: 616e 645f 6972 6973 7472 2e78 6d6c df00 and_iristr.xml.. │ │ │ +001f76a0: 0012 123c 3f78 6d6c 2076 6572 7369 6f6e ...<?xml version │ │ │ +001f76b0: 3d22 312e 3022 2065 6e63 6f64 696e 673d ="1.0" encoding= │ │ │ +001f76c0: 2249 534f 2d38 3835 392d 3122 3f3e 0a3c "ISO-8859-1"?>.< │ │ │ +001f76d0: 212d 2d0a 202d 0a20 2d20 2054 6869 7320 !--. -. - This │ │ │ +001f76e0: 6669 6c65 2069 7320 7061 7274 206f 6620 file is part of │ │ │ +001f76f0: 7468 6520 4f70 656e 4c69 6e6b 2053 6f66 the OpenLink Sof │ │ │ +001f7700: 7477 6172 6520 5669 7274 756f 736f 204f tware Virtuoso O │ │ │ +001f7710: 7065 6e2d 536f 7572 6365 2028 564f 5329 pen-Source (VOS) │ │ │ +001f7720: 0a20 2d20 2070 726f 6a65 6374 2e0a 202d . - project.. - │ │ │ +001f7730: 0a20 2d20 2043 6f70 7972 6967 6874 2028 . - Copyright ( │ │ │ +001f7740: 4329 2031 3939 382d 3230 3234 204f 7065 C) 1998-2024 Ope │ │ │ +001f7750: 6e4c 696e 6b20 536f 6674 7761 7265 0a20 nLink Software. │ │ │ +001f7760: 2d0a 202d 2020 5468 6973 2070 726f 6a65 -. - This proje │ │ │ +001f7770: 6374 2069 7320 6672 6565 2073 6f66 7477 ct is free softw │ │ │ +001f7780: 6172 653b 2079 6f75 2063 616e 2072 6564 are; you can red │ │ │ +001f7790: 6973 7472 6962 7574 6520 6974 2061 6e64 istribute it and │ │ │ +001f77a0: 2f6f 7220 6d6f 6469 6679 2069 740a 202d /or modify it. - │ │ │ +001f77b0: 2020 756e 6465 7220 7468 6520 7465 726d under the term │ │ │ +001f77c0: 7320 6f66 2074 6865 2047 4e55 2047 656e s of the GNU Gen │ │ │ +001f77d0: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ +001f77e0: 6e73 6520 6173 2070 7562 6c69 7368 6564 nse as published │ │ │ +001f77f0: 2062 7920 7468 650a 202d 2020 4672 6565 by the. - Free │ │ │ +001f7800: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ +001f7810: 7469 6f6e 3b20 6f6e 6c79 2076 6572 7369 tion; only versi │ │ │ +001f7820: 6f6e 2032 206f 6620 7468 6520 4c69 6365 on 2 of the Lice │ │ │ +001f7830: 6e73 652c 2064 6174 6564 204a 756e 6520 nse, dated June │ │ │ +001f7840: 3139 3931 2e0a 202d 0a20 2d20 2054 6869 1991.. -. - Thi │ │ │ +001f7850: 7320 7072 6f67 7261 6d20 6973 2064 6973 s program is dis │ │ │ +001f7860: 7472 6962 7574 6564 2069 6e20 7468 6520 tributed in the │ │ │ +001f7870: 686f 7065 2074 6861 7420 6974 2077 696c hope that it wil │ │ │ +001f7880: 6c20 6265 2075 7365 6675 6c2c 2062 7574 l be useful, but │ │ │ +001f7890: 0a20 2d20 2057 4954 484f 5554 2041 4e59 . - WITHOUT ANY │ │ │ +001f78a0: 2057 4152 5241 4e54 593b 2077 6974 686f WARRANTY; witho │ │ │ +001f78b0: 7574 2065 7665 6e20 7468 6520 696d 706c ut even the impl │ │ │ +001f78c0: 6965 6420 7761 7272 616e 7479 206f 660a ied warranty of. │ │ │ +001f78d0: 202d 2020 4d45 5243 4841 4e54 4142 494c - MERCHANTABIL │ │ │ +001f78e0: 4954 5920 6f72 2046 4954 4e45 5353 2046 ITY or FITNESS F │ │ │ +001f78f0: 4f52 2041 2050 4152 5449 4355 4c41 5220 OR A PARTICULAR │ │ │ +001f7900: 5055 5250 4f53 452e 2053 6565 2074 6865 PURPOSE. See the │ │ │ +001f7910: 2047 4e55 0a20 2d20 2047 656e 6572 616c GNU. - General │ │ │ +001f7920: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +001f7930: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ +001f7940: 2e0a 202d 0a20 2d20 2059 6f75 2073 686f .. -. - You sho │ │ │ +001f7950: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ +001f7960: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ +001f7970: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +001f7980: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ +001f7990: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ +001f79a0: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ +001f79b0: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ +001f79c0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ +001f79d0: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ +001f79e0: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ +001f79f0: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ +001f7a00: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ +001f7a10: 3330 3120 5553 410a 202d 0a20 2d0a 2d2d 301 USA. -. -.-- │ │ │ +001f7a20: 3e0a 3c72 6566 656e 7472 7920 6964 3d22 >.<refentry id=" │ │ │ +001f7a30: 666e 5f5f 5f78 6d6c 5f6e 7365 7870 616e fn___xml_nsexpan │ │ │ +001f7a40: 645f 6972 6973 7472 223e 0a20 203c 7265 d_iristr">. <re │ │ │ +001f7a50: 666d 6574 613e 0a20 2020 203c 7265 6665 fmeta>. <refe │ │ │ +001f7a60: 6e74 7279 7469 746c 653e 5f5f 786d 6c5f ntrytitle>__xml_ │ │ │ +001f7a70: 6e73 6578 7061 6e64 5f69 7269 7374 723c nsexpand_iristr< │ │ │ +001f7a80: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +001f7a90: 2020 2020 3c72 6566 6d69 7363 696e 666f <refmiscinfo │ │ │ +001f7aa0: 3e72 6466 3c2f 7265 666d 6973 6369 6e66 >rdf</refmiscinf │ │ │ +001f7ab0: 6f3e 0a20 203c 2f72 6566 6d65 7461 3e0a o>. </refmeta>. │ │ │ +001f7ac0: 2020 3c72 6566 6e61 6d65 6469 763e 0a20 <refnamediv>. │ │ │ +001f7ad0: 2020 203c 7265 666e 616d 653e 5f5f 786d <refname>__xm │ │ │ +001f7ae0: 6c5f 6e73 6578 7061 6e64 5f69 7269 7374 l_nsexpand_irist │ │ │ +001f7af0: 723c 2f72 6566 6e61 6d65 3e0a 2020 2020 r</refname>. │ │ │ +001f7b00: 3c72 6566 7075 7270 6f73 653e 4368 6563 <refpurpose>Chec │ │ │ +001f7b10: 6b73 2069 6620 7468 6520 7374 7269 6e67 ks if the string │ │ │ +001f7b20: 2069 7320 514e 616d 6520 616e 6420 6966 is QName and if │ │ │ +001f7b30: 2069 7420 6973 2073 6f20 7468 656e 2072 it is so then r │ │ │ +001f7b40: 6570 6c61 6365 7320 6e61 6d65 7370 6163 eplaces namespac │ │ │ +001f7b50: 6520 7072 6566 6978 2074 6f20 7468 6520 e prefix to the │ │ │ +001f7b60: 0a20 2020 2009 6675 6c6c 206e 616d 6573 . .full names │ │ │ +001f7b70: 7061 6365 2049 5249 2e3c 2f72 6566 7075 pace IRI.</refpu │ │ │ +001f7b80: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ +001f7b90: 6d65 6469 763e 0a20 203c 7265 6673 796e mediv>. <refsyn │ │ │ +001f7ba0: 6f70 7369 7364 6976 3e0a 2020 2020 3c66 opsisdiv>. <f │ │ │ +001f7bb0: 756e 6373 796e 6f70 7369 7320 6964 3d22 uncsynopsis id=" │ │ │ +001f7bc0: 6673 796e 5f5f 5f78 6d6c 5f6e 7365 7870 fsyn___xml_nsexp │ │ │ +001f7bd0: 616e 645f 6972 6973 7472 223e 0a20 2020 and_iristr">. │ │ │ +001f7be0: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ +001f7bf0: 6520 6964 3d22 6670 726f 746f 5f5f 5f78 e id="fproto___x │ │ │ +001f7c00: 6d6c 5f6e 7365 7870 616e 645f 6972 6973 ml_nsexpand_iris │ │ │ +001f7c10: 7472 223e 0a20 2020 2020 2020 203c 6675 tr">. <fu │ │ │ +001f7c20: 6e63 6465 663e 0a20 2020 2020 2020 2009 ncdef>. . │ │ │ +001f7c30: 3c66 756e 6374 696f 6e3e 5f5f 786d 6c5f <function>__xml_ │ │ │ +001f7c40: 6e73 6578 7061 6e64 5f69 7269 7374 723c nsexpand_iristr< │ │ │ +001f7c50: 2f66 756e 6374 696f 6e3e 0a20 2020 2020 /function>. │ │ │ +001f7c60: 2020 203c 2f66 756e 6364 6566 3e0a 0920 </funcdef>.. │ │ │ +001f7c70: 2020 2020 203c 7061 7261 6d64 6566 3e69 <paramdef>i │ │ │ +001f7c80: 6e20 3c70 6172 616d 6574 6572 3e73 7472 n <parameter>str │ │ │ +001f7c90: 3c2f 7061 7261 6d65 7465 723e 2076 6172 </parameter> var │ │ │ +001f7ca0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char</paramdef>. │ │ │ +001f7cb0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 </funcprot │ │ │ +001f7cc0: 6f74 7970 653e 0a20 2020 203c 2f66 756e otype>. </fun │ │ │ +001f7cd0: 6373 796e 6f70 7369 733e 0a20 203c 2f72 csynopsis>. </r │ │ │ +001f7ce0: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ +001f7cf0: 203c 7265 6673 6563 7431 2069 643d 2264 <refsect1 id="d │ │ │ +001f7d00: 6573 635f 5f5f 786d 6c5f 6e73 6578 7061 esc___xml_nsexpa │ │ │ +001f7d10: 6e64 5f69 7269 7374 7222 3e0a 2020 2020 nd_iristr">. │ │ │ +001f7d20: 3c74 6974 6c65 3e44 6573 6372 6970 7469 <title>Descripti │ │ │ +001f7d30: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ +001f7d40: 7061 7261 3e43 6865 636b 7320 6966 2074 para>Checks if t │ │ │ +001f7d50: 6865 2073 7472 696e 6720 6973 2051 4e61 he string is QNa │ │ │ +001f7d60: 6d65 2061 6e64 2069 6620 6974 2069 7320 me and if it is │ │ │ +001f7d70: 736f 2074 6865 6e20 7265 706c 6163 6573 so then replaces │ │ │ +001f7d80: 206e 616d 6573 7061 6365 2070 7265 6669 namespace prefi │ │ │ +001f7d90: 7820 746f 2074 6865 200a 2020 2020 0966 x to the . .f │ │ │ +001f7da0: 756c 6c20 6e61 6d65 7370 6163 6520 4952 ull namespace IR │ │ │ +001f7db0: 492e 204f 7468 6572 7769 7365 2073 6967 I. Otherwise sig │ │ │ +001f7dc0: 6e61 6c73 2065 7272 6f72 2069 6620 7468 nals error if th │ │ │ +001f7dd0: 6520 6172 6775 6d65 6e74 2069 7320 6c6f e argument is lo │ │ │ +001f7de0: 6361 6c20 4952 4920 7769 7468 6f75 7420 cal IRI without │ │ │ +001f7df0: 6120 7072 6566 6978 2e3c 2f70 6172 613e a prefix. │ │ │ +001f7e00: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +001f7e10: 203c 7265 6673 6563 7431 2069 643d 2270 . │ │ │ +001f7e40: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ +001f7e50: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +001f7e60: 3c72 6566 7365 6374 323e 3c74 6974 6c65 str. │ │ │ +001f7e80: 2020 203c 7061 7261 3e51 4e61 6d65 2e20 QName. │ │ │ +001f7e90: 466f 7220 6578 2e20 6966 2051 4e61 6d65 For ex. if QName │ │ │ +001f7ea0: 2069 7320 2270 7265 6669 783a 6c6f 6361 is "prefix:loca │ │ │ +001f7eb0: 6c22 2c20 7468 656e 2063 6f6e 7665 6e69 l", then conveni │ │ │ +001f7ec0: 656e 746c 7920 6973 2072 6570 6c61 6365 ently is replace │ │ │ +001f7ed0: 6420 2270 7265 6669 783a 2220 7769 7468 d "prefix:" with │ │ │ +001f7ee0: 200a 2020 2020 2020 0974 6865 206e 616d . .the nam │ │ │ +001f7ef0: 6573 7061 6365 2049 5249 3c2f 7061 7261 espace IRI. . . │ │ │ +001f7f20: 203c 7265 6673 6563 7431 2069 643d 2265 Examples. Example │ │ │ +001f7fa0: 7769 7468 2046 4f41 4620 6e61 6d65 7370 with FOAF namesp │ │ │ +001f7fb0: 6163 6520 7072 6566 6978 3c2f 7469 746c ace prefix</titl │ │ │ +001f7fc0: 653e 0a3c 7072 6f67 7261 6d6c 6973 7469 e>.<programlisti │ │ │ +001f7fd0: 6e67 3e3c 215b 4344 4154 415b 0a53 514c ng><![CDATA[.SQL │ │ │ +001f7fe0: 3e20 5345 4c45 4354 205f 5f78 6d6c 5f6e > SELECT __xml_n │ │ │ +001f7ff0: 7365 7870 616e 645f 6972 6973 7472 2028 sexpand_iristr ( │ │ │ +001f8000: 2766 6f61 663a 6b6e 6f77 7327 293b 0a5f 'foaf:knows');._ │ │ │ +001f8010: 5f78 6d6c 5f6e 7365 7870 616e 645f 6972 _xml_nsexpand_ir │ │ │ +001f8020: 6973 7472 0a56 4152 4348 4152 0a5f 5f5f istr.VARCHAR.___ │ │ │ +001f8030: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001f8040: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001f8050: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001f8060: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +001f8070: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 6874 ____________..ht │ │ │ +001f8080: 7470 3a2f 2f78 6d6c 6e73 2e63 6f6d 2f66 tp://xmlns.com/f │ │ │ +001f8090: 6f61 662f 302e 312f 6b6e 6f77 730a 0a31 oaf/0.1/knows..1 │ │ │ +001f80a0: 2052 6f77 732e 202d 2d20 3020 6d73 6563 Rows. -- 0 msec │ │ │ +001f80b0: 2e0a 5d5d 3e3c 2f70 726f 6772 616d 6c69 ..]]></programli │ │ │ +001f80c0: 7374 696e 673e 0a20 2020 203c 2f65 7861 sting>. </exa │ │ │ +001f80d0: 6d70 6c65 3e0a 2020 2020 3c65 7861 6d70 mple>. <examp │ │ │ +001f80e0: 6c65 2069 643d 2265 785f 786d 6c5f 6e73 le id="ex_xml_ns │ │ │ +001f80f0: 6578 7061 6e64 5f69 7269 7374 725f 3222 expand_iristr_2" │ │ │ +001f8100: 3e3c 7469 746c 653e 4578 616d 706c 6520 ><title>Example │ │ │ +001f8110: 7769 7468 206e 6f20 6e61 6d65 7370 6163 with no namespac │ │ │ +001f8120: 6520 7072 6566 6978 3c2f 7469 746c 653e e prefix │ │ │ +001f8130: 0a3c 7072 6f67 7261 6d6c 6973 7469 6e67 . │ │ │ +001f8150: 5345 4c45 4354 205f 5f78 6d6c 5f6e 7365 SELECT __xml_nse │ │ │ +001f8160: 7870 616e 645f 6972 6973 7472 2028 276e xpand_iristr ('n │ │ │ +001f8170: 6f2d 6e61 6d65 7370 6163 652d 7072 6566 o-namespace-pref │ │ │ +001f8180: 6978 2d69 7269 2729 3b0a 0a2a 2a2a 2045 ix-iri');..*** E │ │ │ +001f8190: 7272 6f72 2032 3230 3233 3a20 5b56 6972 rror 22023: [Vir │ │ │ +001f81a0: 7475 6f73 6f20 4472 6976 6572 5d5b 5669 tuoso Driver][Vi │ │ │ +001f81b0: 7274 756f 736f 2053 6572 7665 725d 5352 rtuoso Server]SR │ │ │ +001f81c0: 3634 393a 200a 4e6f 2058 4d4c 206e 616d 649: .No XML nam │ │ │ +001f81d0: 6573 7061 6365 2070 7265 6669 7820 696e espace prefix in │ │ │ +001f81e0: 2073 7472 696e 6720 226e 6f2d 6e61 6d65 string "no-name │ │ │ +001f81f0: 7370 6163 652d 7072 6566 6978 2d69 7269 space-prefix-iri │ │ │ +001f8200: 220a 696e 0a5f 5f78 6d6c 5f6e 7365 7870 ".in.__xml_nsexp │ │ │ +001f8210: 616e 645f 6972 6973 7472 3a28 4249 4629 and_iristr:(BIF) │ │ │ +001f8220: 2c0a 2020 2020 2020 2020 5f5f 3031 203d ,. __01 = │ │ │ +001f8230: 3e20 276e 6f2d 6e61 6d65 7370 6163 652d > 'no-namespace- │ │ │ +001f8240: 7072 6566 6978 2d69 7269 272c 0a3c 546f prefix-iri',..at line │ │ │ +001f8260: 2035 206f 6620 546f 702d 4c65 7665 6c3a 5 of Top-Level: │ │ │ +001f8270: 0a53 454c 4543 5420 5f5f 786d 6c5f 6e73 .SELECT __xml_ns │ │ │ +001f8280: 6578 7061 6e64 5f69 7269 7374 7220 2827 expand_iristr (' │ │ │ +001f8290: 6e6f 2d6e 616d 6573 7061 6365 2d70 7265 no-namespace-pre │ │ │ +001f82a0: 6669 782d 6972 6927 290a 5d5d 3e3c 2f70 fix-iri').]]>

    . │ │ │ +001f82c0: 2020 203c 2f65 7861 6d70 6c65 3e20 200a . │ │ │ +001f82d0: 2020 2020 3c65 7861 6d70 6c65 2069 643d Example with n │ │ │ +001f8310: 616d 6573 7061 6365 2070 7265 6669 7820 amespace prefix │ │ │ +001f8320: 226c 6f63 616c 223c 2f74 6974 6c65 3e0a "local". │ │ │ +001f8330: 3c70 726f 6772 616d 6c69 7374 696e 673e │ │ │ +001f8340: 3c21 5b43 4441 5441 5b0a 5351 4c3e 2053 S │ │ │ +001f8350: 454c 4543 5420 5f5f 786d 6c5f 6e73 6578 ELECT __xml_nsex │ │ │ +001f8360: 7061 6e64 5f69 7269 7374 7220 2827 6e6f pand_iristr ('no │ │ │ +001f8370: 2d73 7563 682d 7072 6566 6978 3a6c 6f63 -such-prefix:loc │ │ │ +001f8380: 616c 2729 3b0a 0a2a 2a2a 2045 7272 6f72 al');..*** Error │ │ │ +001f8390: 2032 3230 3233 3a20 5b56 6972 7475 6f73 22023: [Virtuos │ │ │ +001f83a0: 6f20 4472 6976 6572 5d5b 5669 7274 756f o Driver][Virtuo │ │ │ +001f83b0: 736f 2053 6572 7665 725d 5352 3634 383a so Server]SR648: │ │ │ +001f83c0: 200a 556e 6b6e 6f77 6e20 584d 4c20 6e61 .Unknown XML na │ │ │ +001f83d0: 6d65 7370 6163 6520 7072 6566 6978 2069 mespace prefix i │ │ │ +001f83e0: 6e20 4952 4920 226e 6f2d 7375 6368 2d70 n IRI "no-such-p │ │ │ +001f83f0: 7265 6669 783a 6c6f 6361 6c22 0a69 6e0a refix:local".in. │ │ │ +001f8400: 5f5f 786d 6c5f 6e73 6578 7061 6e64 5f69 __xml_nsexpand_i │ │ │ +001f8410: 7269 7374 723a 2842 4946 292c 0a20 2020 ristr:(BIF),. │ │ │ +001f8420: 2020 2020 205f 5f30 3120 3d3e 2027 6e6f __01 => 'no │ │ │ +001f8430: 2d73 7563 682d 7072 6566 6978 3a6c 6f63 -such-prefix:loc │ │ │ +001f8440: 616c 272c 0a3c 546f 7020 4c65 7665 6c3e al',. │ │ │ +001f8450: 0a61 7420 6c69 6e65 2036 206f 6620 546f .at line 6 of To │ │ │ +001f8460: 702d 4c65 7665 6c3a 0a53 454c 4543 5420 p-Level:.SELECT │ │ │ +001f8470: 5f5f 786d 6c5f 6e73 6578 7061 6e64 5f69 __xml_nsexpand_i │ │ │ +001f8480: 7269 7374 7220 2827 6e6f 2d73 7563 682d ristr ('no-such- │ │ │ +001f8490: 7072 6566 6978 3a6c 6f63 616c 2729 0a5d prefix:local').] │ │ │ +001f84a0: 5d3e 3c2f 7072 6f67 7261 6d6c 6973 7469 ]>. . < │ │ │ +001f84f0: 7469 746c 653e 4578 616d 706c 6520 7769 title>Example wi │ │ │ +001f8500: 7468 206e 616d 6573 7061 6365 2070 7265 th namespace pre │ │ │ +001f8510: 6669 7820 2222 6e6f 2d73 7563 682d 7072 fix ""no-such-pr │ │ │ +001f8520: 6566 6978 2222 3c2f 7469 746c 653e 0a3c efix"".< │ │ │ +001f8530: 7072 6f67 7261 6d6c 6973 7469 6e67 3e3c programlisting>< │ │ │ +001f8540: 215b 4344 4154 415b 0a53 514c 3e20 5345 ![CDATA[.SQL> SE │ │ │ +001f8550: 4c45 4354 205f 5f78 6d6c 5f6e 735f 6972 LECT __xml_ns_ir │ │ │ +001f8560: 6973 7472 2028 276e 6f2d 7375 6368 2d70 istr ('no-such-p │ │ │ +001f8570: 7265 6669 7827 2c20 276b 6e6f 7773 2729 refix', 'knows') │ │ │ +001f8580: 3b0a 0a2a 2a2a 2045 7272 6f72 2032 3230 ;..*** Error 220 │ │ │ +001f8590: 3233 3a20 5b56 6972 7475 6f73 6f20 4472 23: [Virtuoso Dr │ │ │ +001f85a0: 6976 6572 5d5b 5669 7274 756f 736f 2053 iver][Virtuoso S │ │ │ +001f85b0: 6572 7665 725d 5352 3634 383a 2055 6e6b erver]SR648: Unk │ │ │ +001f85c0: 6e6f 776e 2058 4d4c 206e 616d 6573 7061 nown XML namespa │ │ │ +001f85d0: 6365 2070 7265 6669 7820 226e 6f2d 7375 ce prefix "no-su │ │ │ +001f85e0: 6368 2d70 7265 6669 7822 0a69 6e0a 5f5f ch-prefix".in.__ │ │ │ +001f85f0: 786d 6c5f 6e73 5f69 7269 7374 723a 2842 xml_ns_iristr:(B │ │ │ +001f8600: 4946 292c 0a20 2020 2020 2020 205f 5f30 IF),. __0 │ │ │ +001f8610: 3120 3d3e 2027 6e6f 2d73 7563 682d 7072 1 => 'no-such-pr │ │ │ +001f8620: 6566 6978 272c 0a20 2020 2020 2020 205f efix',. _ │ │ │ +001f8630: 5f30 3220 3d3e 2027 6b6e 6f77 7327 2c0a _02 => 'knows',. │ │ │ +001f8640: 3c54 6f70 204c 6576 656c 3e0a 6174 206c .at l │ │ │ +001f8650: 696e 6520 3720 6f66 2054 6f70 2d4c 6576 ine 7 of Top-Lev │ │ │ +001f8660: 656c 3a0a 5345 4c45 4354 205f 5f78 6d6c el:.SELECT __xml │ │ │ +001f8670: 5f6e 735f 6972 6973 7472 2028 276e 6f2d _ns_iristr ('no- │ │ │ +001f8680: 7375 6368 2d70 7265 6669 7827 2c20 276b such-prefix', 'k │ │ │ +001f8690: 6e6f 7773 2729 0a5d 5d3e 3c2f 7072 6f67 nows').]]>. │ │ │ +001f86b0: 3c2f 6578 616d 706c 653e 2020 2020 2020 │ │ │ +001f86c0: 2020 2020 2020 0a20 203c 2f72 6566 7365 . . See Al │ │ │ +001f8710: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ +001f8720: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>x │ │ │ +001f8750: 6d6c 5f6e 735f 756e 616d 6528 293c 2f66 ml_ns_uname()< │ │ │ +001f8770: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xml_ │ │ │ +001f87b0: 6e73 5f69 7269 7374 7228 293c 2f66 756e ns_iristr()

    . < │ │ │ +001f87e0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f87f0: 5f78 6d6c 5f67 6574 5f6e 735f 7072 6566 _xml_get_ns_pref │ │ │ +001f8800: 6978 223e 3c66 756e 6374 696f 6e3e 786d ix">xm │ │ │ +001f8810: 6c5f 6765 745f 6e73 5f70 7265 6669 7828 l_get_ns_prefix( │ │ │ +001f8820: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 ). < │ │ │ +001f8840: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xml_get_ns_uri( │ │ │ +001f8880: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )
    . ......"demo/d │ │ │ +001f88c0: 6f63 7372 632f 6675 6e63 7265 662f 6765 ocsrc/funcref/ge │ │ │ +001f88d0: 6f5f 6465 6c65 7465 2e78 6d6c df00 000f o_delete.xml.... │ │ │ +001f88e0: 643c 3f78 6d6c 2076 6572 7369 6f6e 3d22 d... . geo_de │ │ │ +001f8ca0: 6c65 7465 3c2f 7265 6665 6e74 7279 7469 lete. geo.
    . . geo_delete. Deletes a │ │ │ +001f8d30: 6765 6f6d 6574 7279 2066 726f 6d20 616e geometry from an │ │ │ +001f8d40: 2052 2074 7265 6520 696e 6465 782e 3c2f R tree index.. . . │ │ │ +001f8d80: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . . g │ │ │ +001f8df0: 656f 5f64 656c 6574 653c 2f66 756e 6374 eo_delete.. │ │ │ +001f8e10: 3c70 6172 616d 6465 663e 696e 203c 7061 in tb any..in g │ │ │ +001f8e60: 656f 3c2f 7061 7261 6d65 7465 723e 2061 eo a │ │ │ +001f8e70: 6e79 3c2f 7061 7261 6d64 6566 3e0a 093c ny..< │ │ │ +001f8e80: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in id int. . │ │ │ +001f8ed0: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ +001f8ee0: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . . Description</ti │ │ │ +001f8f30: 746c 653e 0a20 2020 203c 7061 7261 3e44 tle>. <para>D │ │ │ +001f8f40: 656c 6574 6573 2061 2067 656f 6d65 7472 eletes a geometr │ │ │ +001f8f50: 7920 6672 6f6d 2061 6e20 5220 7472 6565 y from an R tree │ │ │ +001f8f60: 2069 6e64 6578 2e20 5468 6520 7462 206d index. The tb m │ │ │ +001f8f70: 7573 7420 6265 2061 0a66 756c 6c79 2071 ust be a.fully q │ │ │ +001f8f80: 7561 6c69 6669 6564 206e 616d 6520 6f66 ualified name of │ │ │ +001f8f90: 2061 6e20 5220 7472 6565 2074 6162 6c65 an R tree table │ │ │ +001f8fa0: 2e20 5468 6973 2066 756e 6374 696f 6e20 . This function │ │ │ +001f8fb0: 6973 2074 7970 6963 616c 6c79 2075 7365 is typically use │ │ │ +001f8fc0: 6420 6672 6f6d 2074 7269 6767 6572 730a d from triggers. │ │ │ +001f8fd0: 6f6e 2061 2067 656f 6d65 7472 7920 636f on a geometry co │ │ │ +001f8fe0: 6c75 6d6e 2e20 5468 6520 6675 6e63 7469 lumn. The functi │ │ │ +001f8ff0: 6f6e 2069 7320 7472 616e 7361 6374 696f on is transactio │ │ │ +001f9000: 6e61 6c20 616e 6420 6d61 6b65 7320 6120 nal and makes a │ │ │ +001f9010: 7472 616e 7361 6374 696f 6e20 6c6f 6720 transaction log │ │ │ +001f9020: 7265 636f 7264 206f 6620 7468 6520 6163 record of the ac │ │ │ +001f9030: 7469 6f6e 2e0a 3c2f 7061 7261 3e0a 2020 tion..</para>. │ │ │ +001f9040: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ +001f9050: 6566 7365 6374 3120 6964 3d22 7061 7261 efsect1 id="para │ │ │ +001f9060: 6d73 5f67 656f 5f64 656c 6574 6522 3e0a ms_geo_delete">. │ │ │ +001f9070: 2020 2020 3c74 6974 6c65 3e50 6172 616d <title>Param │ │ │ +001f9080: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ +001f9090: 2020 3c72 6566 7365 6374 323e 3c74 6974 tb. │ │ │ +001f90b0: 2020 2020 3c70 6172 613e 4120 6675 6c6c A full │ │ │ +001f90c0: 7920 7175 616c 6966 6965 6420 6e61 6d65 y qualified name │ │ │ +001f90d0: 206f 6620 616e 2052 2074 7265 6520 7461 of an R tree ta │ │ │ +001f90e0: 626c 652e 3c2f 7061 7261 3e0a 2020 2020 ble.. │ │ │ +001f90f0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ +001f9100: 3c72 6566 7365 6374 323e 3c74 6974 6c65 geo. │ │ │ +001f9120: 2020 203c 7061 7261 3e41 2067 656f 6d65 A geome │ │ │ +001f9130: 7472 792e 3c2f 7061 7261 3e0a 2020 2020 try.. │ │ │ +001f9140: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ +001f9150: 3c72 6566 7365 6374 323e 3c74 6974 6c65 id. │ │ │ +001f9170: 2020 3c70 6172 613e 4765 6f6d 6574 7279 Geometry │ │ │ +001f9180: 2069 642e 3c2f 7061 7261 3e0a 2020 2020 id.. │ │ │ +001f9190: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f . . Return Types</t │ │ │ +001f91e0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +001f91f0: 5265 7475 726e 7320 696e 742e 3c2f 7061 Returns int.</pa │ │ │ +001f9200: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ +001f9210: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ +001f9220: 3d22 6578 616d 706c 6573 5f67 656f 5f64 ="examples_geo_d │ │ │ +001f9230: 656c 6574 6522 3e0a 2020 2020 3c74 6974 elete">. <tit │ │ │ +001f9240: 6c65 3e45 7861 6d70 6c65 733c 2f74 6974 le>Examples</tit │ │ │ +001f9250: 6c65 3e0a 2020 2020 3c65 7861 6d70 6c65 le>. <example │ │ │ +001f9260: 2069 643d 2265 785f 6765 6f5f 6465 6c65 id="ex_geo_dele │ │ │ +001f9270: 7465 223e 3c74 6974 6c65 3e53 696d 706c te"><title>Simpl │ │ │ +001f9280: 6520 6578 616d 706c 653c 2f74 6974 6c65 e example.< │ │ │ +001f92b0: 2f70 726f 6772 616d 6c69 7374 696e 673e /programlisting> │ │ │ +001f92c0: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ +001f92d0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +001f92e0: 3c72 6566 7365 6374 3120 6964 3d22 7365 . Se │ │ │ +001f9310: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ +001f9320: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c s │ │ │ +001f9350: 745f 706f 696e 743c 2f66 756e 6374 696f t_point │ │ │ +001f9370: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . st_ │ │ │ +001f93a0: 783c 2f66 756e 6374 696f 6e3e 3c2f 6c69 x. < │ │ │ +001f93c0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>st_y

    . < │ │ │ +001f9410: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f9420: 5f73 745f 6469 7374 616e 6365 223e 3c66 _st_distance">st_dista │ │ │ +001f9440: 6e63 653c 2f66 756e 6374 696f 6e3e 3c2f nce. │ │ │ +001f9460: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e st_s │ │ │ +001f9490: 7269 643c 2f66 756e 6374 696f 6e3e 3c2f rid. │ │ │ +001f94b0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e s │ │ │ +001f94e0: 745f 7365 7473 7269 643c 2f66 756e 6374 t_setsrid.
  • st_astext< │ │ │ +001f9550: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. st │ │ │ +001f9590: 5f67 656f 6d66 726f 6d74 6578 743c 2f66 _geomfromtext< │ │ │ +001f95b0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. st_i │ │ │ +001f95f0: 6e74 6572 7365 6374 733c 2f66 756e 6374 ntersects.
  • st_contain │ │ │ +001f9650: 733c 2f66 756e 6374 696f 6e3e 3c2f 6c69 s
  • . < │ │ │ +001f9670: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>st_w │ │ │ +001f96a0: 6974 6869 6e3c 2f66 756e 6374 696f 6e3e ithin │ │ │ +001f96b0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20
    . │ │ │ +001f96c0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c isgeometry

    . < │ │ │ +001f9720: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +001f9730: 5f67 656f 5f69 6e73 6572 7422 3e3c 6675 _geo_insert">geo_inser │ │ │ +001f9750: 743c 2f66 756e 6374 696f 6e3e 3c2f 6c69 t
    . < │ │ │ +001f9770: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>DB │ │ │ +001f97a0: 2e44 4241 2e52 4446 5f47 454f 5f41 4444 .DBA.RDF_GEO_ADD │ │ │ +001f97b0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    DB │ │ │ +001f9800: 2e44 4241 2e52 4446 5f47 454f 5f46 494c .DBA.RDF_GEO_FIL │ │ │ +001f9810: 4c3c 2f66 756e 6374 696f 6e3e 3c2f 6c69 L. ...... demo/d │ │ │ +001f9850: 6f63 7372 632f 6675 6e63 7265 662f 7575 ocsrc/funcref/uu │ │ │ +001f9860: 6465 636f 6465 2e78 6d6c df00 0020 493c decode.xml... I< │ │ │ +001f9870: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +001f9880: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +001f9890: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . uudecode< │ │ │ +001f9c40: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +001f9c50: 2020 2020 3c72 6566 6d69 7363 696e 666f encoding. . . uudecode. Decodes a st │ │ │ +001f9cd0: 7269 6e67 2070 7265 7669 6f75 736c 7920 ring previously │ │ │ +001f9ce0: 656e 636f 6465 6420 6279 2075 7565 6e63 encoded by uuenc │ │ │ +001f9cf0: 6f64 653c 2f72 6566 7075 7270 6f73 653e ode │ │ │ +001f9d00: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ +001f9d10: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . │ │ │ +001f9d50: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ +001f9d90: 7575 6465 636f 6465 3c2f 6675 6e63 7469 uudecode..< │ │ │ +001f9db0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in input string< │ │ │ +001f9de0: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..in mode integer. . │ │ │ +001f9e40: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Des │ │ │ +001f9e90: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +001f9ea0: 0a20 2020 203c 7061 7261 3e0a 5575 6465 . .Uude │ │ │ +001f9eb0: 636f 6465 2074 7261 6e73 666f 726d 7320 code transforms │ │ │ +001f9ec0: 7575 656e 636f 6465 6420 6461 7461 2069 uuencoded data i │ │ │ +001f9ed0: 6e74 6f20 6f72 6967 696e 616c 2066 6f72 nto original for │ │ │ +001f9ee0: 6d2e 0a55 7565 6e63 6f64 6520 6d61 7920 m..Uuencode may │ │ │ +001f9ef0: 7265 7475 726e 2061 206e 756d 6265 7220 return a number │ │ │ +001f9f00: 6f66 2073 6563 7469 6f6e 7320 6173 2061 of sections as a │ │ │ +001f9f10: 2076 6563 746f 7220 6f66 2074 6865 6d2c vector of them, │ │ │ +001f9f20: 0a65 6163 6820 6f66 2074 6865 7365 2073 .each of these s │ │ │ +001f9f30: 6563 7469 6f6e 7320 7368 6f75 6c64 2062 ections should b │ │ │ +001f9f40: 6520 6465 636f 6465 6420 6279 2073 6570 e decoded by sep │ │ │ +001f9f50: 6172 6174 6520 6361 6c6c 2061 6e64 2072 arate call and r │ │ │ +001f9f60: 6573 756c 7473 0a73 686f 756c 6420 6265 esults.should be │ │ │ +001f9f70: 2063 6f6e 6361 7465 6e61 7465 6420 696e concatenated in │ │ │ +001f9f80: 206f 7264 6572 2074 6f20 636f 6d70 6f73 order to compos │ │ │ +001f9f90: 6520 6f72 6967 696e 616c 2074 6578 742e e original text. │ │ │ +001f9fa0: 0a54 6865 206d 6f64 6520 6f66 2064 6563 .The mode of dec │ │ │ +001f9fb0: 6f64 696e 6720 7368 6f75 6c64 206d 6174 oding should mat │ │ │ +001f9fc0: 6368 2074 6f20 7468 6520 6d6f 6465 2075 ch to the mode u │ │ │ +001f9fd0: 7365 6420 666f 7220 656e 636f 6469 6e67 sed for encoding │ │ │ +001f9fe0: 2c20 6f66 2063 6f75 7273 652e 0a20 2020 , of course.. │ │ │ +001f9ff0: 203c 2f70 6172 613e 0a20 2020 203c 7061 . .RFC 2045,.(N │ │ │ +001fa010: 2e20 426f 7265 6e73 7465 696e 2c20 4e2e . Borenstein, N. │ │ │ +001fa020: 2046 7265 6564 2e0a 4d49 4d45 2028 4d75 Freed..MIME (Mu │ │ │ +001fa030: 6c74 6970 7572 706f 7365 2049 6e74 6572 ltipurpose Inter │ │ │ +001fa040: 6e65 7420 4d61 696c 2045 7874 656e 7369 net Mail Extensi │ │ │ +001fa050: 6f6e 7329 2050 6172 7420 4f6e 653a 0a54 ons) Part One:.T │ │ │ +001fa060: 6865 2046 6f72 6d61 7420 6f66 2049 6e74 he Format of Int │ │ │ +001fa070: 6572 6e65 7420 4d65 7373 6167 6520 426f ernet Message Bo │ │ │ +001fa080: 6469 6573 292c 0a63 6f6e 7461 696e 7320 dies),.contains │ │ │ +001fa090: 6465 7461 696c 6564 2064 6573 6372 6970 detailed descrip │ │ │ +001fa0a0: 7469 6f6e 206f 6620 6d6f 7374 2069 6d70 tion of most imp │ │ │ +001fa0b0: 6f72 7461 6e74 2065 6e63 6f64 696e 6773 ortant encodings │ │ │ +001fa0c0: 2075 7365 6420 6279 206d 6169 6c0a 7379 used by mail.sy │ │ │ +001fa0d0: 7374 656d 732e 0a4f 6c64 6572 2052 4643 stems..Older RFC │ │ │ +001fa0e0: 2031 3532 3120 6973 206e 6f77 206f 6273 1521 is now obs │ │ │ +001fa0f0: 6f6c 6574 6564 2e0a 2020 2020 3c2f 7061 oleted.. . .C │ │ │ +001fa110: 7572 7265 6e74 6c79 2c20 6569 6768 7420 urrently, eight │ │ │ +001fa120: 636f 6e76 656e 7469 6f6e 7320 6172 6520 conventions are │ │ │ +001fa130: 7573 6564 2066 6f72 206d 6169 6c20 6174 used for mail at │ │ │ +001fa140: 7461 6368 6d65 6e74 732e 0a49 6e20 5669 tachments..In Vi │ │ │ +001fa150: 7274 756f 736f 2c20 7468 6579 2061 7265 rtuoso, they are │ │ │ +001fa160: 2065 6e75 6d65 7261 7465 6420 6279 2069 enumerated by i │ │ │ +001fa170: 6e74 6567 6572 2049 4473 2e0a 2020 2020 nteger IDs.. │ │ │ +001fa180: 3c2f 7061 7261 3e0a 2020 2020 3c74 6162 . Unicod │ │ │ +001fa1a0: 652d 6c69 6b65 2073 7461 6e64 6172 6473 e-like standards │ │ │ +001fa1b0: 2c20 7375 7070 6f72 7465 6420 6279 2056 , supported by V │ │ │ +001fa1c0: 6972 7475 6f73 6f3c 2f74 6974 6c65 3e0a irtuoso. │ │ │ +001fa1d0: 2020 2020 2020 3c74 6772 6f75 7020 636f . < │ │ │ +001fa1f0: 7468 6561 643e 3c72 6f77 3e3c 656e 7472 thead>IDStandardDescri │ │ │ +001fa230: 7074 696f 6e3c 2f65 6e74 7279 3e3c 2f72 ption.... .. │ │ │ +001fa260: 2020 203c 656e 7472 793e 313c 2f65 6e74 1"Nativ │ │ │ +001fa280: 6522 2055 5565 6e63 6f64 653c 2f65 6e74 e" UUencode.. │ │ │ +001fa2a0: 0a4f 7074 696f 6e61 6c20 6865 6164 6572 .Optional header │ │ │ +001fa2b0: 2069 7320 6f6e 6520 6c69 6e65 2073 7461 is one line sta │ │ │ +001fa2c0: 7274 6564 2062 7920 2262 6567 696e 2022 rted by "begin " │ │ │ +001fa2d0: 206f 7220 2226 6c74 3b70 7265 2667 743b or "<pre> │ │ │ +001fa2e0: 6265 6769 6e20 2220 6b65 7977 6f72 642c begin " keyword, │ │ │ +001fa2f0: 2077 6974 6820 736f 6d65 2073 7973 7465 with some syste │ │ │ +001fa300: 6d2d 7370 6563 6966 6963 2064 6174 6120 m-specific data │ │ │ +001fa310: 6166 7465 7220 6974 2e0a 4f70 7469 6f6e after it..Option │ │ │ +001fa320: 616c 2066 6f6f 7465 7220 6973 206f 6e65 al footer is one │ │ │ +001fa330: 206c 696e 6520 7374 6172 7465 6420 6279 line started by │ │ │ +001fa340: 2022 656e 6422 206b 6579 776f 7264 2e0a "end" keyword.. │ │ │ +001fa350: 0920 2020 203c 2f65 6e74 7279 3e0a 0920 . .. │ │ │ +001fa360: 203c 2f72 6f77 3e0a 0920 203c 726f 773e .. │ │ │ +001fa370: 0a09 2020 2020 3c65 6e74 7279 3e32 3c2f .. 2Bas │ │ │ +001fa390: 652d 3634 2c20 554e 4958 2076 6572 7369 e-64, UNIX versi │ │ │ +001fa3a0: 6f6e 3c2f 656e 7472 793e 0a09 2020 2020 on.. │ │ │ +001fa3b0: 3c65 6e74 7279 3e0a 5468 6572 6520 6172 .There ar │ │ │ +001fa3c0: 6520 6e6f 2061 6772 6565 6d65 6e74 7320 e no agreements │ │ │ +001fa3d0: 6162 6f75 7420 6865 6164 6572 7320 6f72 about headers or │ │ │ +001fa3e0: 2066 6f6f 7465 7273 2e0a 0920 2020 203c footers... < │ │ │ +001fa3f0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ +001fa410: 3c65 6e74 7279 3e33 3c2f 656e 7472 793e 3 │ │ │ +001fa420: 3c65 6e74 7279 3e42 6173 652d 3634 2c20 Base-64, │ │ │ +001fa430: 4d49 4d45 2076 6572 7369 6f6e 3c2f 656e MIME version.. .This standard │ │ │ +001fa460: 6973 2076 6572 7920 7369 6d69 6c61 7220 is very similar │ │ │ +001fa470: 746f 2022 4261 7365 2d36 342c 2055 4e49 to "Base-64, UNI │ │ │ +001fa480: 5820 7665 7273 696f 6e22 2e0a 5669 7274 X version"..Virt │ │ │ +001fa490: 756f 736f 2c20 6c69 6b65 2061 6c6c 206d uoso, like all m │ │ │ +001fa4a0: 6f64 6572 6e20 6d61 696c 2063 6c69 656e odern mail clien │ │ │ +001fa4b0: 7473 2c0a 6665 656c 206e 6f20 6469 6666 ts,.feel no diff │ │ │ +001fa4c0: 6572 656e 6365 2062 6574 7765 656e 2074 erence between t │ │ │ +001fa4d0: 6865 6d20 7768 656e 2064 6563 6f64 6520 hem when decode │ │ │ +001fa4e0: 7365 6374 696f 6e73 2c20 6265 6361 7573 sections, becaus │ │ │ +001fa4f0: 650a 7468 6520 6f6e 6c79 2064 6966 6665 e.the only diffe │ │ │ +001fa500: 7265 6e63 6520 6973 2069 6e20 7468 6520 rence is in the │ │ │ +001fa510: 6e75 6d62 6572 206f 6620 6461 7461 2062 number of data b │ │ │ +001fa520: 7974 6573 2070 6572 206c 696e 652e 0a09 ytes per line... │ │ │ +001fa530: 2020 2020 3c2f 656e 7472 793e 0a09 2020 .. │ │ │ +001fa540: 3c2f 726f 773e 0a09 2020 3c72 6f77 3e0a .. . │ │ │ +001fa550: 0920 2020 203c 656e 7472 793e 343c 2f65 . 4XXen │ │ │ +001fa570: 636f 6465 3c2f 656e 7472 793e 0a09 2020 code.. │ │ │ +001fa580: 2020 3c65 6e74 7279 3e0a 5468 6973 2073 .This s │ │ │ +001fa590: 7461 6e64 6172 6420 6973 2061 6e20 6f62 tandard is an ob │ │ │ +001fa5a0: 736f 6c65 7465 2073 7461 6e64 6172 642c solete standard, │ │ │ +001fa5b0: 2073 696d 696c 6172 2074 6f20 556e 6963 similar to Unic │ │ │ +001fa5c0: 6f64 652c 0a62 7574 206e 6f74 2063 6f6d ode,.but not com │ │ │ +001fa5d0: 7061 7469 626c 652e 0a54 6865 7265 2061 patible..There a │ │ │ +001fa5e0: 7265 206e 6f20 6167 7265 656d 656e 7473 re no agreements │ │ │ +001fa5f0: 2061 626f 7574 2068 6561 6465 7273 206f about headers o │ │ │ +001fa600: 7220 666f 6f74 6572 732e 0a09 2020 2020 r footers... │ │ │ +001fa610: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f .. .. .. │ │ │ +001fa630: 203c 656e 7472 793e 353c 2f65 6e74 7279 5BinHex.. .There are no │ │ │ +001fa670: 2068 6561 6465 7220 6f72 2066 6f6f 7465 header or foote │ │ │ +001fa680: 7220 6c69 6e65 732c 2062 7574 2066 6972 r lines, but fir │ │ │ +001fa690: 7374 206c 696e 6520 6f66 2065 7665 7279 st line of every │ │ │ +001fa6a0: 0a73 6563 7469 6f6e 2073 686f 756c 6420 .section should │ │ │ +001fa6b0: 6265 2070 7265 6669 7865 6420 6279 2063 be prefixed by c │ │ │ +001fa6c0: 6f6c 6f6e 2028 273a 2729 2063 6861 7261 olon (':') chara │ │ │ +001fa6d0: 6374 6572 2e0a 0920 2020 203c 2f65 6e74 cter... .. .. │ │ │ +001fa6f0: 203c 726f 773e 0a09 2020 2020 3c65 6e74 .. 6-9reserved.. .More standard │ │ │ +001fa740: 7320 6d61 7920 6265 2075 7365 6420 696e s may be used in │ │ │ +001fa750: 2074 6865 2066 7574 7572 652e 2049 7420 the future. It │ │ │ +001fa760: 6973 2075 6e73 6166 6520 746f 0a61 7373 is unsafe to.ass │ │ │ +001fa770: 756d 6520 7468 6174 2061 6c6c 2065 7869 ume that all exi │ │ │ +001fa780: 7374 696e 6720 7374 616e 6461 7264 7320 sting standards │ │ │ +001fa790: 6172 6520 6c69 7374 6564 2068 6572 652e are listed here. │ │ │ +001fa7a0: 0a52 6561 6c20 6170 706c 6963 6174 696f .Real applicatio │ │ │ +001fa7b0: 6e20 7769 6c6c 206f 6674 656e 2072 6563 n will often rec │ │ │ +001fa7c0: 6569 7665 206d 6573 7361 6765 7320 7769 eive messages wi │ │ │ +001fa7d0: 7468 2075 6e6b 6e6f 776e 206f 720a 6d69 th unknown or.mi │ │ │ +001fa7e0: 7373 7065 6c6c 6564 2065 6e63 6f64 696e sspelled encodin │ │ │ +001fa7f0: 6773 2720 6e61 6d65 732c 2073 796e 7461 gs' names, synta │ │ │ +001fa800: 7820 6572 726f 7273 2069 6e20 6461 7461 x errors in data │ │ │ +001fa810: 2065 7463 2e0a 0920 2020 203c 2f65 6e74 etc... .. .. │ │ │ +001fa830: 203c 726f 773e 0a09 2020 2020 3c65 6e74 .. 10MIME Plain-T │ │ │ +001fa860: 6578 743c 2f65 6e74 7279 3e0a 0920 2020 ext.. │ │ │ +001fa870: 203c 656e 7472 793e 0a54 6869 7320 2265 .This "e │ │ │ +001fa880: 6e63 6f64 696e 6722 2069 7320 7375 6974 ncoding" is suit │ │ │ +001fa890: 6162 6c65 206f 6e6c 7920 666f 7220 7465 able only for te │ │ │ +001fa8a0: 7874 732e 0a54 6865 7920 6172 6520 7374 xts..They are st │ │ │ +001fa8b0: 6f72 6564 2022 6173 2069 7322 2c20 6275 ored "as is", bu │ │ │ +001fa8c0: 7420 6c69 6e65 2065 6e64 7320 7769 6c6c t line ends will │ │ │ +001fa8d0: 206e 6f74 2062 6520 7072 6573 6572 7665 not be preserve │ │ │ +001fa8e0: 642e 0a09 2020 2020 3c2f 656e 7472 793e d... │ │ │ +001fa8f0: 0a09 2020 3c2f 726f 773e 0a09 2020 3c72 .. .. .. │ │ │ +001fa910: 3131 3c2f 656e 7472 793e 3c65 6e74 7279 11MIME Quoted-Pri │ │ │ +001fa930: 6e74 6162 6c65 2028 666f 7220 7465 7874 ntable (for text │ │ │ +001fa940: 7329 3c2f 656e 7472 793e 0a09 2020 2020 s).. │ │ │ +001fa950: 3c65 6e74 7279 3e0a 5468 6973 2065 6e63 .This enc │ │ │ +001fa960: 6f64 696e 6720 6973 2073 7569 7461 626c oding is suitabl │ │ │ +001fa970: 6520 666f 7220 616e 7920 736f 7274 206f e for any sort o │ │ │ +001fa980: 6620 7465 7874 7561 6c20 6461 7461 2c0a f textual data,. │ │ │ +001fa990: 6265 6361 7573 6520 4153 4349 4920 7072 because ASCII pr │ │ │ +001fa9a0: 696e 7461 626c 6520 6368 6172 6163 7465 intable characte │ │ │ +001fa9b0: 7273 2061 7265 2073 746f 7265 640a 2261 rs are stored."a │ │ │ +001fa9c0: 7320 6973 2220 616e 6420 6f6e 6c79 206e s is" and only n │ │ │ +001fa9d0: 6f6e 7072 696e 7461 626c 6520 6368 6172 onprintable char │ │ │ +001fa9e0: 6163 7465 7273 2061 7265 2065 6e63 6f64 acters are encod │ │ │ +001fa9f0: 6564 2e0a 554e 4958 206c 696e 6566 6565 ed..UNIX linefee │ │ │ +001faa00: 6473 2028 4c46 2063 6861 7273 2920 7769 ds (LF chars) wi │ │ │ +001faa10: 6c6c 2062 6520 656e 636f 6465 6420 6173 ll be encoded as │ │ │ +001faa20: 2022 6861 7264 2062 7265 616b 7322 2c20 "hard breaks", │ │ │ +001faa30: 736f 2064 6563 6f64 696e 670a 7369 6465 so decoding.side │ │ │ +001faa40: 206d 6179 2063 6f6e 7665 7274 2074 6865 may convert the │ │ │ +001faa50: 6d20 696e 746f 2069 7473 206f 776e 2073 m into its own s │ │ │ +001faa60: 7973 7465 6d2d 7370 6563 6966 6963 2022 ystem-specific " │ │ │ +001faa70: 6c69 6e65 2065 6e64 2220 6368 6172 732c line end" chars, │ │ │ +001faa80: 2065 2e67 2e0a 696e 2043 524c 4620 7365 e.g..in CRLF se │ │ │ +001faa90: 7175 656e 6365 2e0a 0920 2020 203c 2f65 quence... .. . │ │ │ +001faab0: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. 12< │ │ │ +001faad0: 656e 7472 793e 4d49 4d45 2051 756f 7465 entry>MIME Quote │ │ │ +001faae0: 642d 5072 696e 7461 626c 6520 2866 6f72 d-Printable (for │ │ │ +001faaf0: 2062 696e 6172 6965 7329 3c2f 656e 7472 binaries).. . │ │ │ +001fab10: 5468 6973 2065 6e63 6f64 696e 6720 6973 This encoding is │ │ │ +001fab20: 2073 7569 7461 626c 6520 666f 7220 616e suitable for an │ │ │ +001fab30: 7920 736f 7274 206f 6620 6461 7461 2062 y sort of data b │ │ │ +001fab40: 7574 2069 7420 6973 2065 7370 6563 6961 ut it is especia │ │ │ +001fab50: 6c6c 790a 7573 6566 756c 2066 6f72 2074 lly.useful for t │ │ │ +001fab60: 6578 7475 616c 2064 6174 612c 2062 6563 extual data, bec │ │ │ +001fab70: 6175 7365 2041 5343 4949 2070 7269 6e74 ause ASCII print │ │ │ +001fab80: 6162 6c65 2063 6861 7261 6374 6572 7320 able characters │ │ │ +001fab90: 6172 6520 7374 6f72 6564 0a22 6173 2069 are stored."as i │ │ │ +001faba0: 7322 2061 6e64 206f 6e6c 7920 6e6f 6e70 s" and only nonp │ │ │ +001fabb0: 7269 6e74 6162 6c65 2063 6861 7261 6374 rintable charact │ │ │ +001fabc0: 6572 7320 6172 6520 656e 636f 6465 642e ers are encoded. │ │ │ +001fabd0: 0a4e 6f20 2268 6172 6420 6272 6561 6b73 .No "hard breaks │ │ │ +001fabe0: 2220 7769 6c6c 2062 6520 7573 6564 2066 " will be used f │ │ │ +001fabf0: 6f72 2055 4e49 5820 6c69 6e65 6665 6564 or UNIX linefeed │ │ │ +001fac00: 7320 284c 4620 6368 6172 7329 206f 6620 s (LF chars) of │ │ │ +001fac10: 736f 7572 6365 2066 696c 652c 0a73 6f20 source file,.so │ │ │ +001fac20: 7468 6520 6669 6c65 2077 696c 6c20 6265 the file will be │ │ │ +001fac30: 2064 6563 6f64 6564 2065 7861 6374 6c79 decoded exactly │ │ │ +001fac40: 2061 7320 6974 2077 6173 2065 6e63 6f64 as it was encod │ │ │ +001fac50: 6564 2c20 6e6f 206d 6174 7465 7220 7768 ed, no matter wh │ │ │ +001fac60: 6963 680a 6368 6172 6163 7465 7220 7365 ich.character se │ │ │ +001fac70: 7175 656e 6365 2069 7320 7573 6564 2066 quence is used f │ │ │ +001fac80: 6f72 2022 6c69 6e65 2065 6e64 2220 696e or "line end" in │ │ │ +001fac90: 2074 6865 2064 6563 6f64 6572 2773 204f the decoder's O │ │ │ +001faca0: 532e 0a57 6865 6e20 696e 2074 726f 7562 S..When in troub │ │ │ +001facb0: 6c65 2c20 7768 6574 6865 7220 7468 6520 le, whether the │ │ │ +001facc0: 6461 7461 2065 6e63 6f64 6564 2061 7265 data encoded are │ │ │ +001facd0: 2074 6578 7420 6f72 2062 696e 6172 792c text or binary, │ │ │ +001face0: 2075 7365 0a74 6869 7320 7661 7269 616e use.this varian │ │ │ +001facf0: 7420 2822 666f 7220 6269 6e61 7269 6573 t ("for binaries │ │ │ +001fad00: 2229 3a20 7465 7874 206d 6179 2062 6520 "): text may be │ │ │ +001fad10: 6561 7369 6c79 2072 6563 6f76 6572 6564 easily recovered │ │ │ +001fad20: 2062 7920 7265 6369 7069 656e 740a 6966 by recipient.if │ │ │ +001fad30: 206c 696e 6566 6565 6473 2061 7265 2077 linefeeds are w │ │ │ +001fad40: 726f 6e67 2077 6865 7265 6173 2062 696e rong whereas bin │ │ │ +001fad50: 6172 7920 6461 7461 2077 696c 6c20 6265 ary data will be │ │ │ +001fad60: 636f 6d65 2075 6e75 7361 626c 6520 6966 come unusable if │ │ │ +001fad70: 2065 6e63 6f64 6564 2061 7320 7465 7874 encoded as text │ │ │ +001fad80: 2e0a 0920 2020 203c 2f65 6e74 7279 3e0a ... . │ │ │ +001fad90: 0920 203c 2f72 6f77 3e0a 093c 2f74 626f . ... .

    │ │ │ +001fadc0: 0a20 2020 203c 7061 7261 3e0a 4966 2074 . .If t │ │ │ +001fadd0: 6865 7265 2773 206e 6f20 696e 666f 726d here's no inform │ │ │ +001fade0: 6174 696f 6e20 6162 6f75 7420 7468 6520 ation about the │ │ │ +001fadf0: 656e 636f 6469 6e67 2075 7365 6420 696e encoding used in │ │ │ +001fae00: 2074 6865 206d 6573 7361 6765 2c0a 7a65 the message,.ze │ │ │ +001fae10: 726f 206d 6179 2062 6520 7061 7373 6564 ro may be passed │ │ │ +001fae20: 2074 6f20 7468 6520 7575 6465 636f 6465 to the uudecode │ │ │ +001fae30: 2829 2066 756e 6374 696f 6e20 696e 7374 () function inst │ │ │ +001fae40: 6561 6420 6f66 2070 726f 7065 7220 4944 ead of proper ID │ │ │ +001fae50: 2e0a 7575 6465 636f 6465 2829 2077 696c ..uudecode() wil │ │ │ +001fae60: 6c20 7472 7920 746f 2067 7565 7373 2074 l try to guess t │ │ │ +001fae70: 6865 2070 726f 7065 7220 616c 676f 7269 he proper algori │ │ │ +001fae80: 7468 6d2e 0a49 6e20 616e 7920 6361 7365 thm..In any case │ │ │ +001fae90: 2c20 6465 636f 6465 7220 6665 656c 7320 , decoder feels │ │ │ +001faea0: 6e6f 2064 6966 6665 7265 6e63 6520 6265 no difference be │ │ │ +001faeb0: 7477 6565 6e20 6d6f 6465 7320 3220 616e tween modes 2 an │ │ │ +001faec0: 6420 330a 2874 776f 2073 6c69 6768 746c d 3.(two slightl │ │ │ +001faed0: 7920 6469 6666 6572 656e 7420 2242 6173 y different "Bas │ │ │ +001faee0: 6536 3422 2065 6e63 6f64 696e 6773 2920 e64" encodings) │ │ │ +001faef0: 616e 6420 6265 7477 6565 6e20 6d6f 6465 and between mode │ │ │ +001faf00: 730a 3131 2061 6e64 2031 3220 2874 776f s.11 and 12 (two │ │ │ +001faf10: 2022 5175 6f74 6564 2d50 7269 6e74 6162 "Quoted-Printab │ │ │ +001faf20: 6c65 2220 6d65 7468 6f64 7320 7768 6963 le" methods whic │ │ │ +001faf30: 6820 6172 6520 6469 6666 6572 656e 740a h are different. │ │ │ +001faf40: 6f6e 6c79 2065 6e63 6f64 696e 6720 7369 only encoding si │ │ │ +001faf50: 6465 292e 0a41 7070 6c69 6361 7469 6f6e de)..Application │ │ │ +001faf60: 206d 6179 2074 7279 2061 6c6c 206d 6574 may try all met │ │ │ +001faf70: 686f 6473 2069 6e20 7475 726e 2069 6620 hods in turn if │ │ │ +001faf80: 6175 746f 6d61 7469 6320 6775 6573 7320 automatic guess │ │ │ +001faf90: 7769 6c6c 2066 6169 6c2e 0a20 2020 203c will fail.. < │ │ │ +001fafa0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . Par │ │ │ +001fafe0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ +001faff0: 2020 2020 3c72 6566 7365 6374 323e 3c74 input
    . S │ │ │ +001fb020: 7472 696e 6720 6f72 2073 7472 696e 672d tring or string- │ │ │ +001fb030: 6f75 7470 7574 2073 6573 7369 6f6e 2077 output session w │ │ │ +001fb040: 6974 6820 6461 7461 2074 6f20 6265 2065 ith data to be e │ │ │ +001fb050: 6e63 6f64 6564 2e3c 2f70 6172 613e 3c2f ncoded.. m │ │ │ +001fb080: 6f64 653c 2f74 6974 6c65 3e0a 2020 2020 ode. │ │ │ +001fb090: 2020 3c70 6172 613e 496e 7465 6765 7220 Integer │ │ │ +001fb0a0: 4944 206f 6620 656e 636f 6469 6e67 2074 ID of encoding t │ │ │ +001fb0b0: 6f20 6265 2075 7365 642e 3c2f 7061 7261 o be used.
    . < │ │ │ +001fb0d0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. │ │ │ +001fb100: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ +001fb110: 746c 653e 3c70 6172 613e 0a56 6563 746f tle><para>.Vecto │ │ │ +001fb120: 7220 6f66 2073 7472 696e 6773 2c20 7768 r of strings, wh │ │ │ +001fb130: 6572 6520 6576 6572 7920 7374 7269 6e67 ere every string │ │ │ +001fb140: 2063 6f6e 7461 696e 7320 616c 6c20 6461 contains all da │ │ │ +001fb150: 7461 206c 696e 6573 206f 6620 6120 7365 ta lines of a se │ │ │ +001fb160: 6374 696f 6e2e 0a3c 2f70 6172 613e 3c2f ction..</para></ │ │ │ +001fb170: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ +001fb180: 7365 6374 3120 6964 3d22 6572 726f 7273 sect1 id="errors │ │ │ +001fb190: 5f75 7565 6e63 6f64 6522 3e3c 7469 746c _uuencode"><titl │ │ │ +001fb1a0: 653e 4572 726f 7273 3c2f 7469 746c 653e e>Errors │ │ │ +001fb1b0: 0a20 2020 203c 7461 626c 653e 3c74 6974 . Errors signal │ │ │ +001fb1d0: 6c65 6420 6279 3c2f 7469 746c 653e 0a20 led by. │ │ │ +001fb1e0: 2020 2020 203c 7467 726f 7570 2063 6f6c . SQLStateError Co │ │ │ +001fb230: 6465 3c2f 656e 7472 793e 3c65 6e74 7279 deError TextDescri │ │ │ +001fb260: 7074 696f 6e3c 2f65 6e74 7279 3e3c 2f72 ption.... .. │ │ │ +001fb290: 2020 203c 656e 7472 793e 3c65 7272 6f72 22003.. │ │ │ +001fb2c0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f UUD01. │ │ │ +001fb2f0: 0920 2020 203c 656e 7472 793e 3c65 7272 . Unsupport │ │ │ +001fb310: 6564 2074 7970 6520 6f66 2055 552d 656e ed type of UU-en │ │ │ +001fb320: 636f 6469 6e67 2028 2e2e 2e29 3c2f 6572 coding (...) │ │ │ +001fb340: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ +001fb360: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ +001fb380: 3232 3030 333c 2f65 7272 6f72 636f 6465 22003.. < │ │ │ +001fb3a0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>UUD02.. │ │ │ +001fb3d0: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Data string co │ │ │ +001fb3f0: 6e74 6169 6e73 2065 7272 6f72 7320 5b2e ntains errors [. │ │ │ +001fb400: 2e2e 5d3c 2f65 7272 6f72 6e61 6d65 3e3c ..]< │ │ │ +001fb410: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. .. │ │ │ +001fb430: 3c2f 726f 773e 0a09 2020 3c72 6f77 3e0a .. . │ │ │ +001fb440: 0920 2020 203c 656e 7472 793e 3c65 7272 . 22003 │ │ │ +001fb470: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. UUD03.. Encoded │ │ │ +001fb4c0: 2064 6174 6120 656e 6465 6420 7072 656d data ended prem │ │ │ +001fb4d0: 6174 7572 656c 793c 2f65 7272 6f72 6e61 aturely.. │ │ │ +001fb4f0: 203c 656e 7472 793e 3c2f 656e 7472 793e │ │ │ +001fb500: 0a09 2020 3c2f 726f 773e 0a09 2020 3c72 .. .. .. │ │ │ +001fb520: 3c65 7272 6f72 636f 6465 3e32 3230 3033 22003 │ │ │ +001fb530: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. UUD0 │ │ │ +001fb560: 343c 2f65 7272 6f72 636f 6465 3e3c 2f65 4.. No │ │ │ +001fb590: 6461 7461 2066 6f75 6e64 2074 6f20 6265 data found to be │ │ │ +001fb5a0: 2064 6563 6f64 6564 3c2f 6572 726f 726e decoded.. │ │ │ +001fb5c0: 2020 3c65 6e74 7279 3e3c 2f65 6e74 7279 .. ... . . │ │ │ +001fb610: 0a20 203c 7265 6673 6563 7431 2069 643d . Examp │ │ │ +001fb640: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ +001fb650: 3c65 7861 6d70 6c65 2069 643d 2265 785f Encoding with a │ │ │ +001fb680: 7574 6f2d 6465 7465 6374 696f 6e20 6f66 uto-detection of │ │ │ +001fb690: 2074 6865 2065 6e63 6f64 696e 6720 7479 the encoding ty │ │ │ +001fb6a0: 7065 3c2f 7469 746c 653e 0a20 2020 2020 pe. │ │ │ +001fb6b0: 203c 7061 7261 3e54 6865 2066 756e 6374 The funct │ │ │ +001fb6c0: 696f 6e20 6765 7473 2061 2073 7472 696e ion gets a strin │ │ │ +001fb6d0: 6720 2661 706f 733b 4865 6c6c 6f26 6170 g 'Hello&ap │ │ │ +001fb6e0: 6f73 3b20 696e 2042 696e 4865 7820 656e os; in BinHex en │ │ │ +001fb6f0: 636f 6469 6e67 2061 6e64 207a 6572 6f20 coding and zero │ │ │ +001fb700: 746f 206c 6574 2069 7420 6775 6573 7320 to let it guess │ │ │ +001fb710: 7468 6174 2074 6865 2065 6e63 6f64 696e that the encodin │ │ │ +001fb720: 6720 6973 2042 696e 4865 782e 2054 6865 g is BinHex. The │ │ │ +001fb730: 2063 616c 6c20 7265 7475 726e 7320 2748 call returns 'H │ │ │ +001fb740: 656c 6c6f 272e 3c2f 7061 7261 3e0a 2020 ello'.. │ │ │ +001fb750: 2020 2020 3c73 6372 6565 6e3e 0a2d 2d20 .-- │ │ │ +001fb760: 6e6f 7465 2064 6f75 626c 6564 2073 696e note doubled sin │ │ │ +001fb770: 676c 6520 7175 6f74 6573 2069 6e73 6964 gle quotes insid │ │ │ +001fb780: 6520 7374 7269 6e67 206c 6974 6572 616c e string literal │ │ │ +001fb790: 0a73 656c 6563 7420 7575 6465 636f 6465 .select uudecode │ │ │ +001fb7a0: 2028 273a 3527 2739 5845 2727 6d3a 272c (':5''9XE''m:', │ │ │ +001fb7b0: 2030 293b 0a48 656c 6c6f 0a3c 2f73 6372 0);.Hello.. . . See A │ │ │ +001fb810: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ +001fb820: 3c70 6172 613e 0a20 2020 2020 203c 6c69 .
  • uuenc │ │ │ +001fb850: 6f64 653c 2f6c 696e 6b3e 2c0a 2020 2020 ode,. │ │ │ +001fb860: 2020 3c6c 696e 6b20 6c69 6e6b 656e 643d │ │ │ +001fb880: 7575 7661 6c69 6461 7465 3c2f 6c69 6e6b uuvalidate. . │ │ │ +001fb8a0: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 ......-dem │ │ │ +001fb8c0: 6f2f 646f 6373 7263 2f66 756e 6372 6566 o/docsrc/funcref │ │ │ +001fb8d0: 2f66 696c 655f 746f 5f73 7472 696e 675f /file_to_string_ │ │ │ +001fb8e0: 6f75 7470 7574 2e78 6d6c df00 0011 663c output.xml....f< │ │ │ +001fb8f0: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +001fb900: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +001fb910: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... │ │ │ +001fbcb0: 0a20 2020 203c 7265 6665 6e74 7279 7469 . file_to_stri │ │ │ +001fbcd0: 6e67 5f6f 7574 7075 743c 2f72 6566 656e ng_output. file< │ │ │ +001fbd00: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +001fbd10: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . file_to_s │ │ │ +001fbd40: 7472 696e 675f 6f75 7470 7574 3c2f 7265 tring_output. get conte │ │ │ +001fbd70: 6e74 7320 6f66 2061 2066 696c 6520 6173 nts of a file as │ │ │ +001fbd80: 2061 2073 7472 696e 6720 6f75 7470 7574 a string output │ │ │ +001fbd90: 2073 7472 6561 6d3c 2f72 6566 7075 7270 stream. . . . │ │ │ +001fbe00: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . fi │ │ │ +001fbe50: 6c65 5f74 6f5f 7374 7269 6e67 5f6f 7574 le_to_string_out │ │ │ +001fbe60: 7075 743c 2f66 756e 6374 696f 6e3e 3c2f put. │ │ │ +001fbe80: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    file

    varcha │ │ │ +001fbeb0: 723c 2f70 6172 616d 6465 663e 0a20 2020 r
    . │ │ │ +001fbec0: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ +001fbed0: 6e20 3c70 6172 616d 6574 6572 3e66 726f n fro │ │ │ +001fbee0: 6d3c 2f70 6172 616d 6574 6572 3e20 696e m in │ │ │ +001fbef0: 7465 6765 723c 2f70 6172 616d 6465 663e teger │ │ │ +001fbf00: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in to │ │ │ +001fbf30: 696e 7465 6765 723c 2f70 6172 616d 6465 integer. . . │ │ │ +001fbf70: 3c2f 7265 6673 796e 6f70 7369 7364 6976 . Description │ │ │ +001fbfc0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This function │ │ │ +001fbfe0: 2072 6571 7569 7265 7320 6462 6120 7072 requires dba pr │ │ │ +001fbff0: 6976 696c 6567 6573 2e3c 2f70 6172 613e ivileges. │ │ │ +001fc000: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ +001fc010: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ +001fc020: 2061 2020 2073 7472 696e 6720 6f75 7470 a string outp │ │ │ +001fc030: 7574 2073 7472 6561 6d0a 2020 2020 696e ut stream. in │ │ │ +001fc040: 6974 6961 6c69 7a65 6420 746f 2063 6f6e itialized to con │ │ │ +001fc050: 7461 696e 2074 6865 2074 6578 7420 6f66 tain the text of │ │ │ +001fc060: 2074 6865 2066 696c 6520 6f72 2069 7473 the file or its │ │ │ +001fc070: 2073 6567 6d65 6e74 2c20 6f6e 206c 6f63 segment, on loc │ │ │ +001fc080: 616c 2066 696c 6520 7379 7374 656d 2070 al file system p │ │ │ +001fc090: 6174 680a 2020 2020 7265 6c61 7469 7665 ath. relative │ │ │ +001fc0a0: 2074 6f20 7468 6520 7365 7276 6572 2773 to the server's │ │ │ +001fc0b0: 2077 6f72 6b69 6e67 2064 6972 6563 746f working directo │ │ │ +001fc0c0: 7279 2e3c 2f70 6172 613e 0a20 2020 203c ry.. < │ │ │ +001fc0d0: 7061 7261 3e3c 6675 6e63 7469 6f6e 3e66 para>f │ │ │ +001fc0e0: 696c 655f 746f 5f73 7472 696e 675f 6f75 ile_to_string_ou │ │ │ +001fc0f0: 7470 7574 3c2f 6675 6e63 7469 6f6e 3e20 tput │ │ │ +001fc100: 6361 6e20 6861 6e64 6c65 206c 6f6e 6765 can handle longe │ │ │ +001fc110: 720a 2020 2020 6669 6c65 7320 7468 616e r. files than │ │ │ +001fc120: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . file_to_string< │ │ │ +001fc160: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. and the re │ │ │ +001fc180: 7375 6c74 696e 6720 7374 7269 6e67 206f sulting string o │ │ │ +001fc190: 7574 7075 742c 2069 6620 746f 6f20 6c6f utput, if too lo │ │ │ +001fc1a0: 6e67 2074 6f20 6265 2063 6f6e 7665 7274 ng to be convert │ │ │ +001fc1b0: 6564 2069 6e74 6f0a 2020 2020 6120 7661 ed into. a va │ │ │ +001fc1c0: 7263 6861 722c 2063 616e 2062 6520 7374 rchar, can be st │ │ │ +001fc1d0: 6f72 6564 2069 6e73 6964 6520 6120 626c ored inside a bl │ │ │ +001fc1e0: 6f62 2e3c 2f70 6172 613e 0a20 2020 203c ob.. < │ │ │ +001fc1f0: 7061 7261 3e41 6363 6573 7320 636f 6e74 para>Access cont │ │ │ +001fc200: 726f 6c73 2069 6e20 7468 6520 7365 7276 rols in the serv │ │ │ +001fc210: 6572 2063 6f6e 6669 6775 7261 7469 6f6e er configuration │ │ │ +001fc220: 2066 696c 6520 6170 706c 792e 2041 6e20 file apply. An │ │ │ +001fc230: 6174 7465 6d70 740a 2020 2020 746f 2061 attempt. to a │ │ │ +001fc240: 6363 6573 7320 6120 6669 6c65 2069 6e20 ccess a file in │ │ │ +001fc250: 6120 6469 7265 6374 6f72 7920 7768 6572 a directory wher │ │ │ +001fc260: 6520 6163 6365 7373 2069 7320 6e6f 7420 e access is not │ │ │ +001fc270: 6578 706c 6963 6974 6c79 2061 6c6c 6f77 explicitly allow │ │ │ +001fc280: 6564 2077 696c 6c20 7369 676e 616c 2061 ed will signal a │ │ │ +001fc290: 6e20 6572 726f 722e 3c2f 7061 7261 3e0a n error.. │ │ │ +001fc2a0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +001fc2b0: 3c72 6566 7365 6374 3120 6964 3d22 7061 Parameters. file< │ │ │ +001fc310: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +001fc320: 6172 613e 6120 3c74 7970 653e 7661 7263 ara>a <type>varc │ │ │ +001fc330: 6861 723c 2f74 7970 653e 2070 6174 6820 har</type> path │ │ │ +001fc340: 7265 6c61 7469 7665 2074 6f20 7365 7276 relative to serv │ │ │ +001fc350: 6572 2773 2077 6f72 6b69 6e67 2064 6972 er's working dir │ │ │ +001fc360: 6563 746f 7279 2e3c 2f70 6172 613e 0a20 ectory.</para>. │ │ │ +001fc370: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ +001fc380: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ +001fc390: 746c 653e 6672 6f6d 3c2f 7469 746c 653e tle>from │ │ │ +001fc3a0: 0a20 2020 2020 203c 7061 7261 3e61 6e20 . an │ │ │ +001fc3b0: 6f70 7469 6f6e 616c 203c 7479 7065 3e69 optional i │ │ │ +001fc3c0: 6e74 6567 6572 3c2f 7479 7065 3e20 6279 nteger by │ │ │ +001fc3d0: 7465 206f 6666 7365 7420 6f66 2074 6865 te offset of the │ │ │ +001fc3e0: 2073 7461 7274 206f 6620 7468 6520 7365 start of the se │ │ │ +001fc3f0: 676d 656e 7420 746f 0a20 2020 2020 2065 gment to. e │ │ │ +001fc400: 7874 7261 6374 2e20 4465 6661 756c 7473 xtract. Defaults │ │ │ +001fc410: 2074 6f20 302e 3c2f 7061 7261 3e0a 2020 to 0.. │ │ │ +001fc420: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +001fc430: 2020 3c72 6566 7365 6374 323e 3c74 6974 to. │ │ │ +001fc450: 2020 2020 3c70 6172 613e 616e 206f 7074 an opt │ │ │ +001fc460: 696f 6e61 6c20 3c74 7970 653e 696e 7465 ional inte │ │ │ +001fc470: 6765 723c 2f74 7970 653e 2062 7974 6520 ger byte │ │ │ +001fc480: 6f66 6673 6574 206f 6620 7468 6520 656e offset of the en │ │ │ +001fc490: 6420 6f66 2074 6865 2072 6571 7565 7374 d of the request │ │ │ +001fc4a0: 6564 2073 6567 6d65 6e74 2e0a 2020 2020 ed segment.. │ │ │ +001fc4b0: 2020 4465 6661 756c 7473 2074 6f20 6669 Defaults to fi │ │ │ +001fc4c0: 6c65 206c 656e 6774 682e 3c2f 7061 7261 le length.. . . │ │ │ +001fc4f0: 2020 3c72 6566 7365 6374 3120 6964 3d22 │ │ │ +001fc520: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ +001fc530: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ +001fc540: 6d70 6c65 2069 643d 2265 785f 6669 6c65 mple id="ex_file │ │ │ +001fc550: 5f74 6f5f 7374 7269 6e67 5f6f 7574 7075 _to_string_outpu │ │ │ +001fc560: 7422 3e3c 7469 746c 653e 496e 7365 7274 t"><title>Insert │ │ │ +001fc570: 2066 696c 6520 636f 6e74 656e 7473 2069 file contents i │ │ │ +001fc580: 6e74 6f20 6120 7461 626c 653c 2f74 6974 nto a table</tit │ │ │ +001fc590: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +001fc5a0: 5468 6973 2065 7861 6d70 6c65 2073 686f This example sho │ │ │ +001fc5b0: 7773 2068 6f77 2074 6f20 696e 7365 7274 ws how to insert │ │ │ +001fc5c0: 2066 696c 6520 636f 6e74 656e 7473 2069 file contents i │ │ │ +001fc5d0: 6e74 6f0a 2020 2020 2020 6120 7461 626c nto. a tabl │ │ │ +001fc5e0: 6520 3c63 6f6d 7075 7465 726f 7574 7075 e <computeroutpu │ │ │ +001fc5f0: 743e 6669 6c65 5f74 6162 6c65 3c2f 636f t>file_table</co │ │ │ +001fc600: 6d70 7574 6572 6f75 7470 7574 3e20 7769 mputeroutput> wi │ │ │ +001fc610: 7468 0a20 2020 2020 2074 776f 2063 6f6c th. two col │ │ │ +001fc620: 756d 6e73 2e3c 2f70 6172 613e 0a20 2020 umns.</para>. │ │ │ +001fc630: 2020 203c 7363 7265 656e 3e0a 6372 6561 <screen>.crea │ │ │ +001fc640: 7465 2074 6162 6c65 0a66 696c 655f 7461 te table.file_ta │ │ │ +001fc650: 626c 6520 280a 2020 6674 5f6e 616d 6520 ble (. ft_name │ │ │ +001fc660: 7661 7263 6861 722c 0a20 2066 745f 636f varchar,. ft_co │ │ │ +001fc670: 6e74 206c 6f6e 6720 7661 7262 696e 6172 nt long varbinar │ │ │ +001fc680: 792c 0a20 2070 7269 6d61 7279 206b 6579 y,. primary key │ │ │ +001fc690: 2028 6674 5f6e 616d 6529 293b 0a0a 6372 (ft_name));..cr │ │ │ +001fc6a0: 6561 7465 2070 726f 6365 6475 7265 0a69 eate procedure.i │ │ │ +001fc6b0: 6e73 6572 745f 6669 6c65 7320 2869 6e20 nsert_files (in │ │ │ +001fc6c0: 666e 616d 6520 7661 7263 6861 7229 0a7b fname varchar).{ │ │ │ +001fc6d0: 0a20 2064 6563 6c61 7265 2073 7472 6f75 . declare strou │ │ │ +001fc6e0: 745f 6861 6e64 6c65 2061 6e79 3b0a 0a20 t_handle any;.. │ │ │ +001fc6f0: 2073 7472 6f75 745f 6861 6e64 6c65 203a strout_handle : │ │ │ +001fc700: 3d20 6669 6c65 5f74 6f5f 7374 7269 6e67 = file_to_string │ │ │ +001fc710: 5f6f 7574 7075 7420 2866 6e61 6d65 293b _output (fname); │ │ │ +001fc720: 0a20 2069 6e73 6572 7420 696e 746f 2066 . insert into f │ │ │ +001fc730: 696c 655f 7461 626c 6520 2866 745f 6e61 ile_table (ft_na │ │ │ +001fc740: 6d65 2c20 6674 5f63 6f6e 7429 0a20 2020 me, ft_cont). │ │ │ +001fc750: 2076 616c 7565 7320 2866 6e61 6d65 2c20 values (fname, │ │ │ +001fc760: 7374 726f 7574 5f68 616e 646c 6529 3b0a strout_handle);. │ │ │ +001fc770: 0a20 2073 7472 6f75 745f 6861 6e64 6c65 . strout_handle │ │ │ +001fc780: 203a 3d20 6669 6c65 5f74 6f5f 7374 7269 := file_to_stri │ │ │ +001fc790: 6e67 5f6f 7574 7075 7420 2866 6e61 6d65 ng_output (fname │ │ │ +001fc7a0: 2c20 3130 293b 0a20 2069 6e73 6572 7420 , 10);. insert │ │ │ +001fc7b0: 696e 746f 2066 696c 655f 7461 626c 6520 into file_table │ │ │ +001fc7c0: 2863 6f6e 6361 7420 2866 745f 6e61 6d65 (concat (ft_name │ │ │ +001fc7d0: 2c20 275f 3127 292c 2066 745f 636f 6e74 , '_1'), ft_cont │ │ │ +001fc7e0: 290a 2020 2020 7661 6c75 6573 2028 666e ). values (fn │ │ │ +001fc7f0: 616d 652c 2073 7472 6f75 745f 6861 6e64 ame, strout_hand │ │ │ +001fc800: 6c65 293b 0a0a 2020 7374 726f 7574 5f68 le);.. strout_h │ │ │ +001fc810: 616e 646c 6520 3a3d 2066 696c 655f 746f andle := file_to │ │ │ +001fc820: 5f73 7472 696e 675f 6f75 7470 7574 2028 _string_output ( │ │ │ +001fc830: 666e 616d 652c 2031 302c 2032 3029 3b0a fname, 10, 20);. │ │ │ +001fc840: 2020 696e 7365 7274 2069 6e74 6f20 6669 insert into fi │ │ │ +001fc850: 6c65 5f74 6162 6c65 2028 636f 6e63 6174 le_table (concat │ │ │ +001fc860: 2028 6674 5f6e 616d 652c 2027 5f32 2729 (ft_name, '_2') │ │ │ +001fc870: 2c20 6674 5f63 6f6e 7429 0a20 2020 2076 , ft_cont). v │ │ │ +001fc880: 616c 7565 7320 2866 6e61 6d65 2c20 7374 alues (fname, st │ │ │ +001fc890: 726f 7574 5f68 616e 646c 6529 3b0a 7d3b rout_handle);.}; │ │ │ +001fc8a0: 0a0a 696e 7365 7274 5f66 696c 6520 2827 ..insert_file (' │ │ │ +001fc8b0: 666f 6f2e 6461 7427 293b 0a20 2020 2020 foo.dat');. │ │ │ +001fc8c0: 203c 2f73 6372 6565 6e3e 0a20 2020 203c </screen>. < │ │ │ +001fc8d0: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. </re │ │ │ +001fc8e0: 6673 6563 7431 3e0a 2020 3c72 6566 7365 fsect1>. <refse │ │ │ +001fc8f0: 6374 3120 6964 3d22 7365 6561 6c73 6f5f ct1 id="seealso_ │ │ │ +001fc900: 6669 6c65 5f74 6f5f 7374 7269 6e67 5f6f file_to_string_o │ │ │ +001fc910: 7574 7075 7422 3e3c 7469 746c 653e 5365 utput"><title>Se │ │ │ +001fc920: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ +001fc930: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c file_to_str │ │ │ +001fc970: 696e 673c 2f66 756e 6374 696f 6e3e 0a20 ing. │ │ │ +001fc980: 2020 203c 2f6c 696e 6b3e 2c0a 2020 2020 ,. │ │ │ +001fc990: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 stri │ │ │ +001fc9c0: 6e67 5f74 6f5f 6669 6c65 3c2f 6675 6e63 ng_to_file. ,. string_output< │ │ │ +001fca20: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>.
    ........'demo/d │ │ │ +001fca60: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ +001fca70: 7470 5f61 636c 5f72 656d 6f76 652e 786d tp_acl_remove.xm │ │ │ +001fca80: 6cdf 0000 0c93 3c3f 786d 6c20 7665 7273 l........ . http_acl_ │ │ │ +001fce50: 7265 6d6f 7665 3c2f 7265 6665 6e74 7279 remove. ws. . . http_acl_remov │ │ │ +001fcec0: 653c 2f72 6566 6e61 6d65 3e0a 2020 2020 e. │ │ │ +001fced0: 3c72 6566 7075 7270 6f73 653e 5265 6d6f Remo │ │ │ +001fcee0: 7665 7320 636f 6e64 6974 696f 6e73 2061 ves conditions a │ │ │ +001fcef0: 6761 696e 7374 2077 6562 2073 6572 7665 gainst web serve │ │ │ +001fcf00: 7220 4143 4c27 733c 2f72 6566 7075 7270 r ACL's. . . . . < │ │ │ +001fcfa0: 6675 6e63 6465 663e 696e 7465 6765 7220 funcdef>integer │ │ │ +001fcfb0: 3c66 756e 6374 696f 6e3e 6874 7470 5f61 http_a │ │ │ +001fcfc0: 636c 5f72 656d 6f76 653c 2f66 756e 6374 cl_remove. │ │ │ +001fcfe0: 2020 2020 2020 203c 7061 7261 6d64 6566 in l │ │ │ +001fd000: 6973 745f 6e61 6d65 3c2f 7061 7261 6d65 ist_name varchar..in order integer..in c │ │ │ +001fd080: 6c69 656e 745f 6970 3c2f 7061 7261 6d65 lient_ip varchar. │ │ │ +001fd0b0: 3c70 6172 616d 6465 663e 696e 203c 7061 in flag integer │ │ │ +001fd0e0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001fd0f0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . Desc │ │ │ +001fd160: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +001fd170: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ +001fd180: 756e 6374 696f 6e20 6361 6e20 6265 2075 unction can be u │ │ │ +001fd190: 7365 6420 7769 7468 696e 2061 7070 6c69 sed within appli │ │ │ +001fd1a0: 6361 7469 6f6e 206c 6f67 6963 2074 6f20 cation logic to │ │ │ +001fd1b0: 7265 6d6f 7665 2041 434c 7320 7275 6c65 remove ACLs rule │ │ │ +001fd1c0: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .. . . │ │ │ +001fd200: 2020 2020 3c74 6974 6c65 3e50 6172 616d Param │ │ │ +001fd210: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ +001fd220: 2020 3c72 6566 7365 6374 323e 3c74 6974 list_name. a string design │ │ │ +001fd260: 6174 696e 6720 7768 6963 6820 6c69 7374 ating which list │ │ │ +001fd270: 2074 6f20 6265 2075 7365 643c 2f70 6172 to be used. │ │ │ +001fd290: 2020 3c72 6566 7365 6374 323e 3c74 6974 order │ │ │ +001fd2b0: 0a20 2020 2020 203c 7061 7261 3e61 2073 . a s │ │ │ +001fd2c0: 7472 696e 6720 6465 7369 676e 6174 696e tring designatin │ │ │ +001fd2d0: 6720 6f72 6465 723c 2f70 6172 613e 3c2f g order. c │ │ │ +001fd300: 6c69 656e 745f 6970 3c2f 7469 746c 653e lient_ip │ │ │ +001fd310: 0a20 2020 2020 203c 7061 7261 3e61 2073 . a s │ │ │ +001fd320: 7472 696e 6720 636f 6e74 6169 6e69 6e67 tring containing │ │ │ +001fd330: 2074 6865 2049 5020 6e75 6d62 6572 206f the IP number o │ │ │ +001fd340: 6620 636c 6965 6e74 2074 6f20 7265 6d6f f client to remo │ │ │ +001fd350: 7665 2072 756c 6573 3c2f 7061 7261 3e3c ve rules< │ │ │ +001fd360: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ +001fd370: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ +001fd380: 666c 6167 3c2f 7469 746c 653e 0a20 2020 flag. │ │ │ +001fd390: 2020 203c 7061 7261 3e30 202d 2061 6c6c 0 - all │ │ │ +001fd3a0: 6f77 2c20 3120 2d20 6465 6e79 3c2f 7061 ow, 1 - deny. │ │ │ +001fd3c0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001fd3d0: 7265 6673 6563 7431 2069 643d 2272 6574 refsect1 id="ret │ │ │ +001fd3e0: 5f68 7474 705f 6163 6c5f 7265 6d6f 7665 _http_acl_remove │ │ │ +001fd3f0: 223e 3c74 6974 6c65 3e52 6574 7572 6e20 ">Return │ │ │ +001fd400: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ +001fd410: 2020 3c70 6172 613e 5468 6520 6675 6e63 The func │ │ │ +001fd420: 7469 6f6e 2072 6574 7572 6e73 2074 6865 tion returns the │ │ │ +001fd430: 2076 616c 7565 206f 6620 7468 6520 4841 value of the HA │ │ │ +001fd440: 5f46 4c41 4720 6f66 2074 6865 2066 6972 _FLAG of the fir │ │ │ +001fd450: 7374 206d 6174 6368 696e 670a 2020 2020 st matching. │ │ │ +001fd460: 7275 6c65 2e20 4966 206e 6f20 7275 6c65 rule. If no rule │ │ │ +001fd470: 206d 6174 6368 6573 2069 7420 7265 7475 matches it retu │ │ │ +001fd480: 726e 7320 2d31 2e3c 2f70 6172 613e 0a20 rns -1.. │ │ │ +001fd490: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +001fd4a0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ +001fd4b0: 616c 736f 5f68 7474 705f 6163 6c5f 7265 also_http_acl_re │ │ │ +001fd4c0: 6d6f 7665 223e 0a20 2020 203c 7469 746c move">. See Also. . │ │ │ +001fd4f0: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e http,. │ │ │ +001fd530: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e ht │ │ │ +001fd560: 7470 5f61 636c 5f67 6574 3c2f 6675 6e63 tp_acl_get,. │ │ │ +001fd580: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e ht │ │ │ +001fd5b0: 7470 5f61 636c 5f73 6574 3c2f 6675 6e63 tp_acl_set,. │ │ │ +001fd5d0: 2020 2020 3c6c 696e 6b20 6c69 6e6b 656e │ │ │ +001fd5f0: 3c66 756e 6374 696f 6e3e 6874 7470 5f75 http_u │ │ │ +001fd600: 726c 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c rl,. string_ou │ │ │ +001fd650: 7470 7574 3c2f 6675 6e63 7469 6f6e 3e3c tput< │ │ │ +001fd660: 2f6c 696e 6b3e 2c0a 2020 2020 2020 3c6c /link>,. http_rew │ │ │ +001fd6a0: 7269 7465 3c2f 6675 6e63 7469 6f6e 3e3c rite< │ │ │ +001fd6b0: 2f6c 696e 6b3e 2c0a 2020 2020 2020 3c6c /link>,. Ge │ │ │ +001fd6e0: 6e65 7261 6c20 4143 4c73 3c2f 6c69 6e6b neral ACLs.. . │ │ │ +001fd700: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 ......%de │ │ │ +001fd720: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ +001fd730: 662f 5354 5f54 7261 6e73 5363 616c 652e f/ST_TransScale. │ │ │ +001fd740: 786d 6cdf 0000 1a6c 3c3f 786d 6c20 7665 xml....l..< │ │ │ +001ff220: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ +001ff230: 6461 765f 6170 695f 6c6f 636b 223e 0a20 dav_api_lock">. │ │ │ +001ff240: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ +001ff250: 7265 6665 6e74 7279 7469 746c 653e 4441 refentrytitle>DA │ │ │ +001ff260: 5620 6c6f 636b 206d 616e 6970 756c 6174 V lock manipulat │ │ │ +001ff270: 696f 6e20 6675 6e63 7469 6f6e 733c 2f72 ion functions. │ │ │ +001ff290: 2020 3c72 6566 6d69 7363 696e 666f 3e77 w │ │ │ +001ff2a0: 733c 2f72 6566 6d69 7363 696e 666f 3e0a s. │ │ │ +001ff2b0: 2020 3c2f 7265 666d 6574 613e 0a20 203c . < │ │ │ +001ff2c0: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ +001ff2d0: 3c72 6566 6e61 6d65 3e44 4156 5f4c 4f43 DAV_LOC │ │ │ +001ff2e0: 4b3c 2f72 6566 6e61 6d65 3e0a 2020 2020 K. │ │ │ +001ff2f0: 3c72 6566 6e61 6d65 3e44 4156 5f55 4e4c DAV_UNL │ │ │ +001ff300: 4f43 4b3c 2f72 6566 6e61 6d65 3e0a 2020 OCK. │ │ │ +001ff310: 2020 3c72 6566 6e61 6d65 3e44 4156 5f49 DAV_I │ │ │ +001ff320: 535f 4c4f 434b 4544 3c2f 7265 666e 616d S_LOCKED. │ │ │ +001ff340: 4441 565f 4c49 5354 5f4c 4f43 4b53 3c2f DAV_LIST_LOCKS. Operati │ │ │ +001ff370: 6f6e 7320 6f6e 206c 6f63 6b73 206f 6620 ons on locks of │ │ │ +001ff380: 4441 5620 636f 6c6c 6563 7469 6f6e 7320 DAV collections │ │ │ +001ff390: 616e 6420 7265 736f 7572 6365 733c 2f72 and resources. . . │ │ │ +001ff3d0: 2020 3c66 756e 6373 796e 6f70 7369 7320 . . │ │ │ +001ff420: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ +001ff430: 696e 7465 6765 7220 3c66 756e 6374 696f integer DAV_LOCK. │ │ │ +001ff460: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +001ff480: 7061 7468 3c2f 7061 7261 6d65 7465 723e path │ │ │ +001ff490: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar. in locktype varchar │ │ │ +001ff4e0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001ff4f0: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ +001ff500: 203c 7061 7261 6d65 7465 723e 7363 6f70 scop │ │ │ +001ff510: 653c 2f70 6172 616d 6574 6572 3e20 7661 e va │ │ │ +001ff520: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +001ff530: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in token varchar.

    in owner_name │ │ │ +001ff5a0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +001ff5b0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +001ff5c0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +001ff5e0: 6f77 6e65 645f 746f 6b65 6e73 3c2f 7061 owned_tokens varchar │ │ │ +001ff600: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001ff610: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ +001ff620: 203c 7061 7261 6d65 7465 723e 6465 7074 dept │ │ │ +001ff630: 683c 2f70 6172 616d 6574 6572 3e20 7661 h va │ │ │ +001ff640: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +001ff650: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in timeout_sec integer │ │ │ +001ff690: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +001ff6a0: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ +001ff6b0: 203c 7061 7261 6d65 7465 723e 6175 7468 auth │ │ │ +001ff6c0: 5f75 6e61 6d65 3c2f 7061 7261 6d65 7465 _uname varchar.

    in auth_pwd varch │ │ │ +001ff720: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar. │ │ │ +001ff730: 2020 2020 3c2f 6675 6e63 7072 6f74 6f74 . . │ │ │ +001ff780: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . │ │ │ +001ff7b0: 2020 2020 2020 3c66 756e 6364 6566 3e61 a │ │ │ +001ff7c0: 6e79 203c 6675 6e63 7469 6f6e 3e44 4156 ny DAV │ │ │ +001ff7d0: 5f55 4e4c 4f43 4b3c 2f66 756e 6374 696f _UNLOCK. │ │ │ +001ff7f0: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ +001ff800: 6e20 3c70 6172 616d 6574 6572 3e70 6174 n pat │ │ │ +001ff810: 683c 2f70 6172 616d 6574 6572 3e20 7661 h va │ │ │ +001ff820: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +001ff830: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in token varchar.

    in auth_uname │ │ │ +001ff8a0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +001ff8b0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +001ff8c0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +001ff8e0: 6175 7468 5f70 7764 3c2f 7061 7261 6d65 auth_pwd varchar. . │ │ │ +001ff920: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . │ │ │ +001ff960: 2020 2020 3c66 756e 6370 726f 746f 7479 . │ │ │ +001ff990: 2020 2020 2020 3c66 756e 6364 6566 3e69 i │ │ │ +001ff9a0: 6e74 6567 6572 203c 6675 6e63 7469 6f6e nteger DAV_IS_LOCKED. in id any. in type char(1).

    in owned_toke │ │ │ +001ffa80: 6e73 3c2f 7061 7261 6d65 7465 723e 2061 ns a │ │ │ +001ffa90: 6e79 203a 3d20 313c 2f70 6172 616d 6465 ny := 1. . . │ │ │ +001ffad0: 2020 3c66 756e 6373 796e 6f70 7369 7320 . │ │ │ +001ffb00: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ +001ffb30: 2020 203c 6675 6e63 6465 663e 696e 7465 inte │ │ │ +001ffb40: 6765 7220 3c66 756e 6374 696f 6e3e 4441 ger DA │ │ │ +001ffb50: 565f 4c49 5354 5f4c 4f43 4b53 3c2f 6675 V_LIST_LOCKS. in id │ │ │ +001ffba0: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any. │ │ │ +001ffbb0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +001ffbd0: 7479 7065 3c2f 7061 7261 6d65 7465 723e type │ │ │ +001ffbe0: 2063 6861 7228 3129 3c2f 7061 7261 6d64 char(1). . < │ │ │ +001ffc10: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ +001ffc20: 203c 2f72 6566 7379 6e6f 7073 6973 6469 . Des │ │ │ +001ffc60: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +001ffc70: 0a20 2020 203c 7061 7261 3e3c 6675 6e63 . DAV_LOCK sets a │ │ │ +001ffca0: 6e65 7720 6c6f 636b 206f 7220 7265 6672 new lock or refr │ │ │ +001ffcb0: 6573 6820 616e 2065 7869 7374 696e 6720 esh an existing │ │ │ +001ffcc0: 6c6f 636b 206f 7220 6372 6561 7465 7320 lock or creates │ │ │ +001ffcd0: 6120 6c6f 636b 206f 626a 6563 742e 3c2f a lock object.. │ │ │ +001ffcf0: 3c66 756e 6374 696f 6e3e 4441 565f 554e DAV_UN │ │ │ +001ffd00: 4c4f 434b 3c2f 6675 6e63 7469 6f6e 3e20 LOCK │ │ │ +001ffd10: 7265 6c65 6173 6573 2061 206c 6f63 6b2e releases a lock. │ │ │ +001ffd20: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . DAV_ │ │ │ +001ffd40: 4953 5f4c 4f43 4b45 443c 2f66 756e 6374 IS_LOCKED reports whe │ │ │ +001ffd60: 7468 6572 2074 6865 2072 6573 6f75 7263 ther the resourc │ │ │ +001ffd70: 6520 6f72 2063 6f6c 6c65 6374 696f 6e20 e or collection │ │ │ +001ffd80: 6973 206c 6f63 6b65 642e 3c2f 7061 7261 is locked.. DAV_LIST_L │ │ │ +001ffdb0: 4f43 4b53 3c2f 6675 6e63 7469 6f6e 3e20 OCKS │ │ │ +001ffdc0: 7265 7475 726e 7320 6120 6675 6c6c 206c returns a full l │ │ │ +001ffdd0: 6973 7420 6f66 2061 6c6c 206c 6f63 6b73 ist of all locks │ │ │ +001ffde0: 206f 6e20 6120 7265 736f 7572 6365 206f on a resource o │ │ │ +001ffdf0: 7220 636f 6c6c 6563 7469 6f6e 2e3c 2f70 r collection.

    . I │ │ │ +001ffe10: 7420 6973 2073 7472 6f6e 676c 7920 7265 t is strongly re │ │ │ +001ffe20: 636f 6d6d 656e 6465 6420 746f 2063 6172 commended to car │ │ │ +001ffe30: 6566 756c 6c79 2073 7475 6479 2044 4156 efully study DAV │ │ │ +001ffe40: 2073 7461 6e64 6172 6473 2062 6566 6f72 standards befor │ │ │ +001ffe50: 6520 7573 696e 6720 7468 6573 6520 6675 e using these fu │ │ │ +001ffe60: 6e63 7469 6f6e 7320 696e 2061 7070 6c69 nctions in appli │ │ │ +001ffe70: 6361 7469 6f6e 732e 0a49 6d70 726f 7065 cations..Imprope │ │ │ +001ffe80: 7220 7573 6520 6f66 2044 4156 206c 6f63 r use of DAV loc │ │ │ +001ffe90: 6b73 206d 6179 2072 6573 756c 7420 696e ks may result in │ │ │ +001ffea0: 2073 7562 746c 6520 6170 706c 6963 6174 subtle applicat │ │ │ +001ffeb0: 696f 6e20 6572 726f 7273 2074 6861 7420 ion errors that │ │ │ +001ffec0: 6172 6520 6861 7264 2074 6f20 6465 6275 are hard to debu │ │ │ +001ffed0: 672e 3c2f 7061 7261 3e0a 2020 3c2f 7265 g..
    . Parameters. path │ │ │ +001fff40: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +001fff50: 7061 7261 3e52 6573 6f75 7263 6520 6f72 para>Resource or │ │ │ +001fff60: 2063 6f6c 6c65 6374 696f 6e20 7061 7468 collection path │ │ │ +001fff70: 2e0a 4173 2075 7375 616c 2c20 636f 6c6c ..As usual, coll │ │ │ +001fff80: 6563 7469 6f6e 206e 616d 6573 206d 7573 ection names mus │ │ │ +001fff90: 7420 656e 6420 7769 7468 2027 2f27 2061 t end with '/' a │ │ │ +001fffa0: 6e64 2062 6f74 6820 736f 7274 7320 6f66 nd both sorts of │ │ │ +001fffb0: 2070 6174 6820 7374 7269 6e67 7320 7368 path strings sh │ │ │ +001fffc0: 6f75 6c64 2062 6567 696e 2077 6974 6820 ould begin with │ │ │ +001fffd0: 272f 272e 0a49 6620 7468 6520 7061 7468 '/'..If the path │ │ │ +001fffe0: 2073 7065 6369 6669 6573 2061 206e 6f6e specifies a non │ │ │ +001ffff0: 2d65 7869 7374 696e 6720 7265 736f 7572 -existing resour │ │ │ +00200000: 6365 2069 6e20 616e 2065 7869 7374 696e ce in an existin │ │ │ +00200010: 6720 636f 6c6c 6563 7469 6f6e 2074 6865 g collection the │ │ │ +00200020: 6e20 6120 6c6f 636b 206f 626a 6563 7420 n a lock object │ │ │ +00200030: 6973 2063 7265 6174 6564 2061 6e64 206f is created and o │ │ │ +00200040: 6e6c 7920 6c6f 636b 206f 776e 6572 2063 nly lock owner c │ │ │ +00200050: 616e 2063 7265 6174 6520 6120 7265 736f an create a reso │ │ │ +00200060: 7572 6365 2077 6974 6820 7468 6973 206e urce with this n │ │ │ +00200070: 616d 6520 696e 2066 7574 7572 652e 0a3c ame in future..< │ │ │ +00200080: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . lock │ │ │ +002000b0: 7479 7065 3c2f 7469 746c 653e 0a20 2020 type. │ │ │ +002000c0: 2020 203c 7061 7261 3e54 6865 2074 7970 The typ │ │ │ +002000d0: 6520 6f66 206c 6f63 6b2e 2043 7572 7265 e of lock. Curre │ │ │ +002000e0: 6e74 2073 6574 206f 6620 4441 5620 7374 nt set of DAV st │ │ │ +002000f0: 616e 6461 7264 7320 7370 6563 6966 6965 andards specifie │ │ │ +00200100: 7320 6f6e 6c79 206f 6e65 2074 7970 6520 s only one type │ │ │ +00200110: 6f66 206c 6f63 6b73 2c20 6361 6c6c 6564 of locks, called │ │ │ +00200120: 2027 443a 7772 6974 6527 3b20 7468 6520 'D:write'; the │ │ │ +00200130: 7061 7261 6d65 7465 7220 7661 6c75 6520 parameter value │ │ │ +00200140: 6973 2073 746f 7265 6420 2761 7320 6973 is stored 'as is │ │ │ +00200150: 2720 616e 6420 6e65 7665 7220 7573 6564 ' and never used │ │ │ +00200160: 2c20 736f 2074 6865 2072 6563 6f6d 6d65 , so the recomme │ │ │ +00200170: 6e64 6564 2076 616c 7565 2069 7320 616e nded value is an │ │ │ +00200180: 2065 6d70 7479 2073 7472 696e 672e 3c2f empty string.. . scope │ │ │ +002001c0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +002001d0: 7061 7261 3e54 6865 2073 636f 7065 206f para>The scope o │ │ │ +002001e0: 6620 6c6f 636b 2061 7320 6120 7369 6e67 f lock as a sing │ │ │ +002001f0: 6c65 2d63 6861 7220 7374 7269 6e67 3a20 le-char string: │ │ │ +00200200: 2753 2720 666f 7220 7368 6172 6564 206c 'S' for shared l │ │ │ +00200210: 6f63 6b2c 2027 5827 2066 6f72 2065 7863 ock, 'X' for exc │ │ │ +00200220: 6c75 7369 7665 2e3c 2f70 6172 613e 0a20 lusive.. │ │ │ +00200230: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +00200240: 2020 203c 7265 6673 6563 7432 3e3c 7469 token. Th │ │ │ +00200270: 6520 746f 6b65 6e20 746f 2075 7064 6174 e token to updat │ │ │ +00200280: 652e 2045 6d70 7479 2073 7472 696e 6720 e. Empty string │ │ │ +00200290: 6f72 204e 554c 4c20 6d65 616e 7320 6372 or NULL means cr │ │ │ +002002a0: 6561 7469 6f6e 206f 6620 6120 6e65 7720 eation of a new │ │ │ +002002b0: 6c6f 636b 2c20 6e6f 7420 616e 2075 7064 lock, not an upd │ │ │ +002002c0: 6174 6520 6f66 2074 6865 2065 7869 7374 ate of the exist │ │ │ +002002d0: 696e 6720 6f6e 652e 3c2f 7061 7261 3e0a ing one.. │ │ │ +002002e0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ +002002f0: 2020 2020 3c72 6566 7365 6374 323e 3c74 owner_name< │ │ │ +00200310: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    Lock owner n │ │ │ +00200330: 616d 6520 6173 2069 7420 7769 6c6c 2062 ame as it will b │ │ │ +00200340: 6520 6469 7370 6c61 7965 6420 746f 206f e displayed to o │ │ │ +00200350: 7468 6572 2075 7365 7273 2074 6861 7420 ther users that │ │ │ +00200360: 7769 6c6c 2071 7565 7279 2066 6f72 2065 will query for e │ │ │ +00200370: 7869 7374 696e 6720 6c6f 636b 732e 2049 xisting locks. I │ │ │ +00200380: 7420 6973 2073 7472 6f6e 676c 7920 7265 t is strongly re │ │ │ +00200390: 636f 6d6d 656e 6465 6420 746f 2070 726f commended to pro │ │ │ +002003a0: 7669 6465 2063 6f6d 6d6f 6e6c 7920 7573 vide commonly us │ │ │ +002003b0: 6564 206e 616d 6573 2073 7563 6820 6173 ed names such as │ │ │ +002003c0: 2065 2d6d 6169 6c73 2074 6f20 6c65 7420 e-mails to let │ │ │ +002003d0: 7573 6572 7320 6173 6b20 6561 6368 206f users ask each o │ │ │ +002003e0: 7468 6572 2074 6f20 7265 6d6f 7665 2066 ther to remove f │ │ │ +002003f0: 6f72 676f 7474 656e 206c 6f63 6b73 2e3c orgotten locks.< │ │ │ +00200400: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . owne │ │ │ +00200430: 645f 746f 6b65 6e73 3c2f 7469 746c 653e d_tokens │ │ │ +00200440: 0a20 2020 2020 203c 7061 7261 3e53 7472 . Str │ │ │ +00200450: 696e 6720 6f66 2074 6f6b 656e 7320 6f77 ing of tokens ow │ │ │ +00200460: 6e65 6420 6279 2061 2075 7365 722c 2074 ned by a user, t │ │ │ +00200470: 6f20 6c65 7420 7573 6572 2069 676e 6f72 o let user ignor │ │ │ +00200480: 6520 6869 7320 6f77 6e20 746f 6b65 6e73 e his own tokens │ │ │ +00200490: 2e20 5468 6520 7374 7269 6e67 2073 686f . The string sho │ │ │ +002004a0: 756c 6420 6d61 7463 6820 7379 6e74 6178 uld match syntax │ │ │ +002004b0: 206f 6620 4441 5620 4854 5450 2027 4966 of DAV HTTP 'If │ │ │ +002004c0: 2720 7061 7261 6d65 7465 722e 0a54 6869 ' parameter..Thi │ │ │ +002004d0: 7320 6361 6e20 6265 2061 6c73 6f20 616e s can be also an │ │ │ +002004e0: 2069 6e74 6567 6572 2c20 7468 6973 2077 integer, this w │ │ │ +002004f0: 696c 6c20 776f 726b 2061 7320 656d 7074 ill work as empt │ │ │ +00200500: 7920 6c69 7374 206f 6620 746f 6b65 6e73 y list of tokens │ │ │ +00200510: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . de │ │ │ +00200540: 7074 683c 2f74 6974 6c65 3e0a 2020 2020 pth. │ │ │ +00200550: 2020 3c70 6172 613e 5468 6973 2073 7065 This spe │ │ │ +00200560: 6369 6669 6573 2074 6865 2072 6563 7572 cifies the recur │ │ │ +00200570: 7369 7665 2064 6570 7468 206f 6620 7468 sive depth of th │ │ │ +00200580: 6520 6c6f 636b 2e0a 5468 6520 7374 7269 e lock..The stri │ │ │ +00200590: 6e67 2063 616e 2062 6520 2730 2720 746f ng can be '0' to │ │ │ +002005a0: 206c 6f63 6b20 7468 6520 7370 6563 6966 lock the specif │ │ │ +002005b0: 6965 6420 636f 6c6c 6563 7469 6f6e 206f ied collection o │ │ │ +002005c0: 6e6c 792c 2027 3127 2074 6f20 6c6f 636b nly, '1' to lock │ │ │ +002005d0: 2074 6865 2063 6f6c 6c65 6374 696f 6e20 the collection │ │ │ +002005e0: 616e 6420 6974 7320 7375 6263 6f6c 6c65 and its subcolle │ │ │ +002005f0: 6374 696f 6e73 2c20 2769 6e66 696e 6974 ctions, 'infinit │ │ │ +00200600: 7927 2074 6f20 6c6f 636b 2074 6865 2077 y' to lock the w │ │ │ +00200610: 686f 6c65 2073 7562 7472 6565 2e0a 5768 hole subtree..Wh │ │ │ +00200620: 656e 2074 6865 206c 6f63 6b20 6973 2061 en the lock is a │ │ │ +00200630: 6464 6564 2074 6f20 6120 7265 736f 7572 dded to a resour │ │ │ +00200640: 6365 2c20 7468 6520 7661 6c75 6520 2730 ce, the value '0 │ │ │ +00200650: 2720 6973 2075 7365 642c 2066 6f72 206f ' is used, for o │ │ │ +00200660: 6276 696f 7573 2072 6561 736f 6e2e 0a49 bvious reason..I │ │ │ +00200670: 6620 4e55 4c4c 2069 7320 7061 7373 6564 f NULL is passed │ │ │ +00200680: 2074 6f20 7468 6520 6675 6e63 7469 6f6e to the function │ │ │ +00200690: 2074 6865 6e20 7468 6520 6566 6665 6374 then the effect │ │ │ +002006a0: 6976 6520 7661 6c75 6520 6973 2027 696e ive value is 'in │ │ │ +002006b0: 6669 6e69 7479 2720 666f 7220 636f 6c6c finity' for coll │ │ │ +002006c0: 6563 7469 6f6e 206c 6f63 6b20 6f72 2027 ection lock or ' │ │ │ +002006d0: 3027 2066 6f72 2072 6573 6f75 7263 6520 0' for resource │ │ │ +002006e0: 6c6f 636b 2e3c 2f70 6172 613e 0a20 2020 lock.. │ │ │ +002006f0: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ +00200700: 203c 7265 6673 6563 7432 3e3c 7469 746c timeout_sec. Expiration int │ │ │ +00200740: 6572 7661 6c20 666f 7220 7468 6520 6c6f erval for the lo │ │ │ +00200750: 636b 2c20 696e 2073 6563 6f6e 6473 2e20 ck, in seconds. │ │ │ +00200760: 4966 2030 206f 7220 4e55 4c4c 2069 7320 If 0 or NULL is │ │ │ +00200770: 7061 7373 6564 2074 6865 6e20 4854 5450 passed then HTTP │ │ │ +00200780: 2044 4156 2064 6566 6175 6c74 2069 7320 DAV default is │ │ │ +00200790: 7573 6564 2074 6861 7420 6973 2065 7175 used that is equ │ │ │ +002007a0: 616c 2074 6f20 3630 3438 3030 2073 6563 al to 604800 sec │ │ │ +002007b0: 6f6e 6473 2028 6f6e 6520 7765 656b 292e onds (one week). │ │ │ +002007c0: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . aut │ │ │ +002007f0: 685f 756e 616d 653c 2f74 6974 6c65 3e0a h_uname. │ │ │ +00200800: 2020 2020 2020 3c70 6172 613e 4441 5620 DAV │ │ │ +00200810: 7573 6572 206e 616d 6520 746f 2061 7574 user name to aut │ │ │ +00200820: 6865 6e74 6963 6174 6520 6163 6365 7373 henticate access │ │ │ +00200830: 2e20 4c6f 636b 2c20 4c6f 636b 2072 6566 . Lock, Lock ref │ │ │ +00200840: 7265 7368 2061 6e64 2075 6e6c 6f63 6b20 resh and unlock │ │ │ +00200850: 6f70 6572 6174 696f 6e73 206f 6e20 6578 operations on ex │ │ │ +00200860: 6973 7469 6e67 2072 6573 6f75 7263 6520 isting resource │ │ │ +00200870: 6f72 2063 6f6c 6c65 6374 696f 6e20 7265 or collection re │ │ │ +00200880: 7175 6972 6520 7772 6974 6520 7065 726d quire write perm │ │ │ +00200890: 6973 7369 6f6e 2e0a 546f 2063 7265 6174 ission..To creat │ │ │ +002008a0: 6520 6120 6c6f 636b 206f 626a 6563 7420 e a lock object │ │ │ +002008b0: 696e 2061 2063 6f6c 6c65 6374 696f 6e2c in a collection, │ │ │ +002008c0: 2075 7365 7220 7368 6f75 6c64 2068 6176 user should hav │ │ │ +002008d0: 6520 7772 6974 6520 7065 726d 6973 7369 e write permissi │ │ │ +002008e0: 6f6e 206f 6e20 7468 6174 2063 6f6c 6c65 on on that colle │ │ │ +002008f0: 6374 696f 6e2e 0a54 6869 7320 6d61 7920 ction..This may │ │ │ +00200900: 6361 7573 6520 7072 6f62 6c65 6d20 7768 cause problem wh │ │ │ +00200910: 656e 2075 7365 7220 6669 7273 7420 6c6f en user first lo │ │ │ +00200920: 636b 7320 6120 7265 736f 7572 6365 2061 cks a resource a │ │ │ +00200930: 6e64 2074 6865 6e20 6c6f 6f73 6520 7772 nd then loose wr │ │ │ +00200940: 6974 6520 7065 726d 6973 7369 6f6e 2066 ite permission f │ │ │ +00200950: 6f72 2073 6f6d 6520 7265 6173 6f6e 3a20 or some reason: │ │ │ +00200960: 7468 6520 7573 6572 2069 7320 756e 6162 the user is unab │ │ │ +00200970: 6c65 2074 6f20 7265 6d6f 7665 2068 6973 le to remove his │ │ │ +00200980: 206f 776e 206c 6f63 6b2e 0a44 6566 6175 own lock..Defau │ │ │ +00200990: 6c74 2069 7320 4e55 4c4c 2074 6861 7420 lt is NULL that │ │ │ +002009a0: 6d65 616e 7320 7075 626c 6963 2061 6363 means public acc │ │ │ +002009b0: 6573 732e 0a3c 2f70 6172 613e 0a20 2020 ess... │ │ │ +002009c0: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ +002009d0: 203c 7265 6673 6563 7432 3e3c 7469 746c auth_pwd. U │ │ │ +00200a00: 7365 7220 7061 7373 776f 7264 2e20 4465 ser password. De │ │ │ +00200a10: 6661 756c 7420 6973 204e 554c 4c2e 3c2f fault is NULL.. . id</t │ │ │ +00200a50: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +00200a60: 613e 496e 7465 726e 616c 2069 6465 6e74 a>Internal ident │ │ │ +00200a70: 6966 6965 7220 6f66 2061 2072 6573 6f75 ifier of a resou │ │ │ +00200a80: 7263 6520 6f72 2063 6f6c 6c65 6374 696f rce or collectio │ │ │ +00200a90: 6e20 6173 2072 6574 7572 6e65 6420 6279 n as returned by │ │ │ +00200aa0: 2044 4156 5f53 4541 5243 485f 4944 2829 DAV_SEARCH_ID() │ │ │ +00200ab0: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .</para>. </r │ │ │ +00200ac0: 6566 7365 6374 323e 0a20 203c 2f72 6566 efsect2>. </ref │ │ │ +00200ad0: 7365 6374 313e 0a0a 3c72 6566 7365 6374 sect1>..<refsect │ │ │ +00200ae0: 3120 6964 3d22 6578 616d 706c 6573 5f64 1 id="examples_d │ │ │ +00200af0: 6176 5f61 7069 5f6c 6f63 6b22 3e3c 7469 av_api_lock"><ti │ │ │ +00200b00: 746c 653e 4578 616d 706c 6573 3c2f 7469 tle>Examples</ti │ │ │ +00200b10: 746c 653e 0a20 2020 203c 6578 616d 706c tle>. <exampl │ │ │ +00200b20: 6520 6964 3d22 6578 5f64 6176 5f61 7069 e id="ex_dav_api │ │ │ +00200b30: 5f6c 6f63 6b5f 3122 3e3c 7469 746c 653e _lock_1"><title> │ │ │ +00200b40: 5477 6f20 636f 6e63 7572 7265 6e74 2075 Two concurrent u │ │ │ +00200b50: 7365 7273 3c2f 7469 746c 653e 0a20 2020 sers. │ │ │ +00200b60: 2020 203c 7061 7261 3e54 6865 2066 6f6c The fol │ │ │ +00200b70: 6c6f 7769 6e67 2065 7861 6d70 6c65 2073 lowing example s │ │ │ +00200b80: 686f 7773 2068 6f77 2074 776f 2075 7365 hows how two use │ │ │ +00200b90: 7273 2063 616e 2070 7265 7665 6e74 2065 rs can prevent e │ │ │ +00200ba0: 6163 6820 6f74 6865 7220 6672 6f6d 2075 ach other from u │ │ │ +00200bb0: 6e64 6573 6972 6564 206f 7065 7261 7469 ndesired operati │ │ │ +00200bc0: 6f6e 732e 3c2f 7061 7261 3e0a 2020 2020 ons.. │ │ │ +00200bd0: 2020 3c70 6172 613e 5468 6520 7361 6d70 The samp │ │ │ +00200be0: 6c65 2066 756e 6374 696f 6e20 4441 565f le function DAV_ │ │ │ +00200bf0: 4c4f 434b 5f44 454d 4f28 2920 7573 6573 LOCK_DEMO() uses │ │ │ +00200c00: 2061 2066 756e 6374 696f 6e20 4455 4d50 a function DUMP │ │ │ +00200c10: 5f56 4543 2829 2074 6861 7420 7072 696e _VEC() that prin │ │ │ +00200c20: 7420 7468 6520 636f 6e74 656e 7420 6f66 t the content of │ │ │ +00200c30: 2076 6563 746f 7220 696e 2056 6972 7475 vector in Virtu │ │ │ +00200c40: 6f73 6f2f 504c 2073 796e 7461 782e 0a59 oso/PL syntax..Y │ │ │ +00200c50: 6f6e 2063 616e 2066 696e 6420 7468 6520 on can find the │ │ │ +00200c60: 696d 706c 656d 656e 7461 7469 6f6e 206f implementation o │ │ │ +00200c70: 6620 7468 6973 2066 756e 6374 696f 6e20 f this function │ │ │ +00200c80: 6173 206f 6e65 206f 6620 6578 616d 706c as one of exampl │ │ │ +00200c90: 6573 2066 6f72 203c 6c69 6e6b 206c 696e es for vecto │ │ │ +00200cc0: 7228 293c 2f66 756e 6374 696f 6e3e 3c2f r() Virtuoso/P │ │ │ +00200ce0: 4c20 6675 6e63 7469 6f6e 2e3c 2f70 6172 L function.. This │ │ │ +002010b0: 2069 7320 2f44 4156 2f6c 6f63 6b5f 6465 is /DAV/lock_de │ │ │ +002010c0: 6d6f 2f73 616d 706c 652e 6874 6d3c 2f62 mo/sample.htm', 't │ │ │ +002010e0: 6578 742f 706c 6169 6e27 2c20 2731 3130 ext/plain', '110 │ │ │ +002010f0: 3131 3030 3030 5227 2c20 276c 6f63 6b5f 110000R', 'lock_ │ │ │ +00201100: 7531 272c 2027 6c6f 636b 5f64 656d 6f5f u1', 'lock_demo_ │ │ │ +00201110: 6772 7027 2c20 276c 6f63 6b5f 7531 272c grp', 'lock_u1', │ │ │ +00201120: 2027 6c6f 636b 5f75 315f 7077 6427 2920 'lock_u1_pwd') │ │ │ +00201130: 293b 0a20 2074 6f6b 656e 5f73 3120 3a3d );. token_s1 := │ │ │ +00201140: 2044 4156 5f4c 4f43 4b20 2827 2f44 4156 DAV_LOCK ('/DAV │ │ │ +00201150: 2f6c 6f63 6b5f 6465 6d6f 2f73 616d 706c /lock_demo/sampl │ │ │ +00201160: 652e 6874 6d27 2c20 2727 2c20 2753 272c e.htm', '', 'S', │ │ │ +00201170: 204e 554c 4c2c 2027 7573 6572 3140 6578 NULL, 'user1@ex │ │ │ +00201180: 616d 706c 652e 636f 6d27 2c20 2727 2c20 ample.com', '', │ │ │ +00201190: 2730 272c 204e 554c 4c2c 2027 6c6f 636b '0', NULL, 'lock │ │ │ +002011a0: 5f75 3127 2c20 276c 6f63 6b5f 7531 5f70 _u1', 'lock_u1_p │ │ │ +002011b0: 7764 2729 3b0a 2020 7265 7375 6c74 2028 wd');. result ( │ │ │ +002011c0: 2746 6972 7374 2075 7365 7220 7365 7420 'First user set │ │ │ +002011d0: 6120 7368 6172 6564 206c 6f63 6b3a 272c a shared lock:', │ │ │ +002011e0: 2074 6f6b 656e 5f73 3129 3b0a 2020 746f token_s1);. to │ │ │ +002011f0: 6b65 6e5f 7332 203a 3d20 4441 565f 4c4f ken_s2 := DAV_LO │ │ │ +00201200: 434b 2028 272f 4441 562f 6c6f 636b 5f64 CK ('/DAV/lock_d │ │ │ +00201210: 656d 6f2f 7361 6d70 6c65 2e68 746d 272c emo/sample.htm', │ │ │ +00201220: 2027 272c 2027 5327 2c20 4e55 4c4c 2c20 '', 'S', NULL, │ │ │ +00201230: 2775 7365 7232 4065 7861 6d70 6c65 2e63 'user2@example.c │ │ │ +00201240: 6f6d 272c 2027 272c 2027 3027 2c20 4e55 om', '', '0', NU │ │ │ +00201250: 4c4c 2c20 276c 6f63 6b5f 7532 272c 2027 LL, 'lock_u2', ' │ │ │ +00201260: 6c6f 636b 5f75 325f 7077 6427 293b 0a20 lock_u2_pwd');. │ │ │ +00201270: 2072 6573 756c 7420 2827 5365 636f 6e64 result ('Second │ │ │ +00201280: 2075 7365 7220 7365 7420 6120 7368 6172 user set a shar │ │ │ +00201290: 6564 206c 6f63 6b3a 272c 2074 6f6b 656e ed lock:', token │ │ │ +002012a0: 5f73 3229 3b0a 2020 746f 6b65 6e5f 7820 _s2);. token_x │ │ │ +002012b0: 3a3d 2044 4156 5f4c 4f43 4b20 2827 2f44 := DAV_LOCK ('/D │ │ │ +002012c0: 4156 2f6c 6f63 6b5f 6465 6d6f 2f73 616d AV/lock_demo/sam │ │ │ +002012d0: 706c 652e 6874 6d27 2c20 2727 2c20 2758 ple.htm', '', 'X │ │ │ +002012e0: 272c 204e 554c 4c2c 2027 7573 6572 3140 ', NULL, 'user1@ │ │ │ +002012f0: 6578 616d 706c 652e 636f 6d27 2c20 746f example.com', to │ │ │ +00201300: 6b65 6e5f 7331 2c20 2730 272c 204e 554c ken_s1, '0', NUL │ │ │ +00201310: 4c2c 2027 6c6f 636b 5f75 3127 2c20 276c L, 'lock_u1', 'l │ │ │ +00201320: 6f63 6b5f 7531 5f70 7764 2729 3b0a 2020 ock_u1_pwd');. │ │ │ +00201330: 7265 7375 6c74 2028 274c 6f63 6b20 6475 result ('Lock du │ │ │ +00201340: 6d70 272c 0a20 2020 2044 554d 505f 5645 mp',. DUMP_VE │ │ │ +00201350: 4320 2844 4156 5f4c 4953 545f 4c4f 434b C (DAV_LIST_LOCK │ │ │ +00201360: 5320 2844 4156 5f53 4541 5243 485f 4944 S (DAV_SEARCH_ID │ │ │ +00201370: 2028 272f 4441 562f 6c6f 636b 5f64 656d ('/DAV/lock_dem │ │ │ +00201380: 6f2f 7361 6d70 6c65 2e68 746d 272c 2027 o/sample.htm', ' │ │ │ +00201390: 5227 292c 2027 5227 2929 2029 3b0a 2020 R'), 'R')) );. │ │ │ +002013a0: 7265 7375 6c74 2028 2746 6972 7374 2075 result ('First u │ │ │ +002013b0: 7365 7220 7472 6965 7320 746f 2073 6574 ser tries to set │ │ │ +002013c0: 2061 6e20 6578 636c 7573 6976 6520 6c6f an exclusive lo │ │ │ +002013d0: 636b 3a27 2c20 746f 6b65 6e5f 7829 3b0a ck:', token_x);. │ │ │ +002013e0: 2020 7265 7375 6c74 2028 2753 6563 6f6e result ('Secon │ │ │ +002013f0: 6420 7573 6572 2072 656c 6561 7365 7320 d user releases │ │ │ +00201400: 6869 7320 6c6f 636b 3a27 2c0a 2020 2020 his lock:',. │ │ │ +00201410: 4441 565f 554e 4c4f 434b 2028 272f 4441 DAV_UNLOCK ('/DA │ │ │ +00201420: 562f 6c6f 636b 5f64 656d 6f2f 7361 6d70 V/lock_demo/samp │ │ │ +00201430: 6c65 2e68 746d 272c 2074 6f6b 656e 5f73 le.htm', token_s │ │ │ +00201440: 322c 2027 6c6f 636b 5f75 3227 2c20 276c 2, 'lock_u2', 'l │ │ │ +00201450: 6f63 6b5f 7532 5f70 7764 2729 2029 3b0a ock_u2_pwd') );. │ │ │ +00201460: 2020 746f 6b65 6e5f 7820 3a3d 2044 4156 token_x := DAV │ │ │ +00201470: 5f4c 4f43 4b20 2827 2f44 4156 2f6c 6f63 _LOCK ('/DAV/loc │ │ │ +00201480: 6b5f 6465 6d6f 2f73 616d 706c 652e 6874 k_demo/sample.ht │ │ │ +00201490: 6d27 2c20 2727 2c20 2758 272c 204e 554c m', '', 'X', NUL │ │ │ +002014a0: 4c2c 2027 7573 6572 3140 6578 616d 706c L, 'user1@exampl │ │ │ +002014b0: 652e 636f 6d27 2c20 746f 6b65 6e5f 7331 e.com', token_s1 │ │ │ +002014c0: 2c20 2730 272c 204e 554c 4c2c 2027 6c6f , '0', NULL, 'lo │ │ │ +002014d0: 636b 5f75 3127 2c20 276c 6f63 6b5f 7531 ck_u1', 'lock_u1 │ │ │ +002014e0: 5f70 7764 2729 3b0a 2020 7265 7375 6c74 _pwd');. result │ │ │ +002014f0: 2028 2746 6972 7374 2075 7365 7220 7365 ('First user se │ │ │ +00201500: 7473 2061 6e20 6578 636c 7573 6976 6520 ts an exclusive │ │ │ +00201510: 6c6f 636b 3a27 2c20 746f 6b65 6e5f 7829 lock:', token_x) │ │ │ +00201520: 3b0a 2020 7265 7375 6c74 2028 2746 6972 ;. result ('Fir │ │ │ +00201530: 7374 2075 7365 7220 7265 6c65 6173 6573 st user releases │ │ │ +00201540: 2068 6973 206c 6f63 6b3a 272c 0a20 2020 his lock:',. │ │ │ +00201550: 2044 4156 5f55 4e4c 4f43 4b20 2827 2f44 DAV_UNLOCK ('/D │ │ │ +00201560: 4156 2f6c 6f63 6b5f 6465 6d6f 2f73 616d AV/lock_demo/sam │ │ │ +00201570: 706c 652e 6874 6d27 2c20 746f 6b65 6e5f ple.htm', token_ │ │ │ +00201580: 7331 2c20 276c 6f63 6b5f 7531 272c 2027 s1, 'lock_u1', ' │ │ │ +00201590: 6c6f 636b 5f75 315f 7077 6427 2920 293b lock_u1_pwd') ); │ │ │ +002015a0: 0a20 2074 6f6b 656e 5f78 203a 3d20 4441 . token_x := DA │ │ │ +002015b0: 565f 4c4f 434b 2028 272f 4441 562f 6c6f V_LOCK ('/DAV/lo │ │ │ +002015c0: 636b 5f64 656d 6f2f 7361 6d70 6c65 2e68 ck_demo/sample.h │ │ │ +002015d0: 746d 272c 2027 272c 2027 5827 2c20 4e55 tm', '', 'X', NU │ │ │ +002015e0: 4c4c 2c20 2775 7365 7231 4065 7861 6d70 LL, 'user1@examp │ │ │ +002015f0: 6c65 2e63 6f6d 272c 2074 6f6b 656e 5f73 le.com', token_s │ │ │ +00201600: 312c 2027 3027 2c20 4e55 4c4c 2c20 276c 1, '0', NULL, 'l │ │ │ +00201610: 6f63 6b5f 7531 272c 2027 6c6f 636b 5f75 ock_u1', 'lock_u │ │ │ +00201620: 315f 7077 6427 293b 0a20 2072 6573 756c 1_pwd');. resul │ │ │ +00201630: 7420 2827 4669 7273 7420 7573 6572 2073 t ('First user s │ │ │ +00201640: 6574 7320 616e 2065 7863 6c75 7369 7665 ets an exclusive │ │ │ +00201650: 206c 6f63 6b3a 272c 2074 6f6b 656e 5f78 lock:', token_x │ │ │ +00201660: 293b 0a20 2072 6573 756c 7420 2827 5365 );. result ('Se │ │ │ +00201670: 636f 6e64 2075 7365 7220 7472 6965 7320 cond user tries │ │ │ +00201680: 746f 2061 6464 2061 2070 726f 7065 7274 to add a propert │ │ │ +00201690: 7920 746f 2074 6865 2072 6573 6f75 7263 y to the resourc │ │ │ +002016a0: 653a 272c 0a20 2020 2044 4156 5f50 524f e:',. DAV_PRO │ │ │ +002016b0: 505f 5345 5420 2827 2f44 4156 2f6c 6f63 P_SET ('/DAV/loc │ │ │ +002016c0: 6b5f 6465 6d6f 2f73 616d 706c 652e 6874 k_demo/sample.ht │ │ │ +002016d0: 6d27 2c20 2773 616d 706c 655f 7072 6f70 m', 'sample_prop │ │ │ +002016e0: 272c 2027 7361 6d70 6c65 2076 616c 7565 ', 'sample value │ │ │ +002016f0: 272c 2027 6c6f 636b 5f75 3227 2c20 276c ', 'lock_u2', 'l │ │ │ +00201700: 6f63 6b5f 7532 5f70 7764 2729 2029 3b0a ock_u2_pwd') );. │ │ │ +00201710: 2020 7265 7375 6c74 2028 2746 6972 7374 result ('First │ │ │ +00201720: 2075 7365 7220 7265 6c65 6173 6573 2068 user releases h │ │ │ +00201730: 6973 2073 6861 7265 643a 272c 0a20 2020 is shared:',. │ │ │ +00201740: 2044 4156 5f55 4e4c 4f43 4b20 2827 2f44 DAV_UNLOCK ('/D │ │ │ +00201750: 4156 2f6c 6f63 6b5f 6465 6d6f 2f73 616d AV/lock_demo/sam │ │ │ +00201760: 706c 652e 6874 6d27 2c20 746f 6b65 6e5f ple.htm', token_ │ │ │ +00201770: 782c 2027 6c6f 636b 5f75 3127 2c20 276c x, 'lock_u1', 'l │ │ │ +00201780: 6f63 6b5f 7531 5f70 7764 2729 2029 3b0a ock_u1_pwd') );. │ │ │ +00201790: 2020 7265 7375 6c74 2028 2753 6563 6f6e result ('Secon │ │ │ +002017a0: 6420 7573 6572 2061 6464 7320 6120 7072 d user adds a pr │ │ │ +002017b0: 6f70 6572 7479 2074 6f20 7468 6520 7265 operty to the re │ │ │ +002017c0: 736f 7572 6365 3a27 2c0a 2020 2020 4441 source:',. DA │ │ │ +002017d0: 565f 5052 4f50 5f53 4554 2028 272f 4441 V_PROP_SET ('/DA │ │ │ +002017e0: 562f 6c6f 636b 5f64 656d 6f2f 7361 6d70 V/lock_demo/samp │ │ │ +002017f0: 6c65 2e68 746d 272c 2027 7361 6d70 6c65 le.htm', 'sample │ │ │ +00201800: 5f70 726f 7027 2c20 2773 616d 706c 6520 _prop', 'sample │ │ │ +00201810: 7661 6c75 6527 2c20 276c 6f63 6b5f 7532 value', 'lock_u2 │ │ │ +00201820: 272c 2027 6c6f 636b 5f75 325f 7077 6427 ', 'lock_u2_pwd' │ │ │ +00201830: 2920 293b 0a7d 0a0a 4441 565f 4c4f 434b ) );.}..DAV_LOCK │ │ │ +00201840: 5f44 454d 4f20 2829 3b0a 4143 5449 4f4e _DEMO ();.ACTION │ │ │ +00201850: 2020 2052 4554 5641 4c0a 5641 5243 4841 RETVAL.VARCHA │ │ │ +00201860: 5220 2056 4152 4348 4152 0a5f 5f5f 5f5f R VARCHAR._____ │ │ │ +00201870: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00201880: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00201890: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002018a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002018b0: 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 4164 6469 __________..Addi │ │ │ +002018c0: 6e67 2067 726f 7570 206c 6f63 6b5f 6465 ng group lock_de │ │ │ +002018d0: 6d6f 5f67 7270 3a20 2031 3037 0a41 6464 mo_grp: 107.Add │ │ │ +002018e0: 696e 6720 7573 6572 206c 6f63 6b5f 7531 ing user lock_u1 │ │ │ +002018f0: 3a20 2031 3038 0a41 6464 696e 6720 7573 : 108.Adding us │ │ │ +00201900: 6572 206c 6f63 6b5f 7532 3a20 2031 3039 er lock_u2: 109 │ │ │ +00201910: 0a41 6464 696e 6720 6120 636f 6c6c 6563 .Adding a collec │ │ │ +00201920: 7469 6f6e 3a20 2031 3731 0a55 706c 6f61 tion: 171.Uploa │ │ │ +00201930: 6469 6e67 202f 4441 562f 6c6f 636b 5f64 ding /DAV/lock_d │ │ │ +00201940: 656d 6f2f 7361 6d70 6c65 2e68 746d 3a20 emo/sample.htm: │ │ │ +00201950: 2031 3130 330a 4669 7273 7420 7573 6572 1103.First user │ │ │ +00201960: 2073 6574 2061 2073 6861 7265 6420 6c6f set a shared lo │ │ │ +00201970: 636b 3a20 2031 3534 3563 6535 342d 3335 ck: 1545ce54-35 │ │ │ +00201980: 3939 2d31 3164 612d 3836 3937 2d38 6633 99-11da-8697-8f3 │ │ │ +00201990: 6566 6264 3836 6566 320a 5365 636f 6e64 efbd86ef2.Second │ │ │ +002019a0: 2075 7365 7220 7365 7420 6120 7368 6172 user set a shar │ │ │ +002019b0: 6564 206c 6f63 6b3a 2020 3135 3436 3035 ed lock: 154605 │ │ │ +002019c0: 3930 2d33 3539 392d 3131 6461 2d38 3639 90-3599-11da-869 │ │ │ +002019d0: 372d 3866 3365 6662 6438 3665 6632 0a4c 7-8f3efbd86ef2.L │ │ │ +002019e0: 6f63 6b20 6475 6d70 2020 0a76 6563 746f ock dump .vecto │ │ │ +002019f0: 7220 280a 7665 6374 6f72 2028 2727 2c20 r (.vector ('', │ │ │ +00201a00: 2753 272c 2027 3135 3435 6365 3534 2d33 'S', '1545ce54-3 │ │ │ +00201a10: 3539 392d 3131 6461 2d38 3639 372d 3866 599-11da-8697-8f │ │ │ +00201a20: 3365 6662 6438 3665 6632 272c 2036 3034 3efbd86ef2', 604 │ │ │ +00201a30: 3830 302c 2031 3038 2c20 2775 7365 7231 800, 108, 'user1 │ │ │ +00201a40: 4065 7861 6d70 6c65 2e63 6f6d 2729 2c20 @example.com'), │ │ │ +00201a50: 0a76 6563 746f 7220 2827 272c 2027 5327 .vector ('', 'S' │ │ │ +00201a60: 2c20 2731 3534 3630 3539 302d 3335 3939 , '15460590-3599 │ │ │ +00201a70: 2d31 3164 612d 3836 3937 2d38 6633 6566 -11da-8697-8f3ef │ │ │ +00201a80: 6264 3836 6566 3227 2c20 3630 3438 3030 bd86ef2', 604800 │ │ │ +00201a90: 2c20 3130 392c 2027 7573 6572 3240 6578 , 109, 'user2@ex │ │ │ +00201aa0: 616d 706c 652e 636f 6d27 2929 0a46 6972 ample.com')).Fir │ │ │ +00201ab0: 7374 2075 7365 7220 7472 6965 7320 746f st user tries to │ │ │ +00201ac0: 2073 6574 2061 6e20 6578 636c 7573 6976 set an exclusiv │ │ │ +00201ad0: 6520 6c6f 636b 3a20 202d 380a 5365 636f e lock: -8.Seco │ │ │ +00201ae0: 6e64 2075 7365 7220 7265 6c65 6173 6573 nd user releases │ │ │ +00201af0: 2068 6973 206c 6f63 6b3a 2020 3135 3436 his lock: 1546 │ │ │ +00201b00: 3035 3930 2d33 3539 392d 3131 6461 2d38 0590-3599-11da-8 │ │ │ +00201b10: 3639 372d 3866 3365 6662 6438 3665 6632 697-8f3efbd86ef2 │ │ │ +00201b20: 0a46 6972 7374 2075 7365 7220 7365 7473 .First user sets │ │ │ +00201b30: 2061 6e20 6578 636c 7573 6976 6520 6c6f an exclusive lo │ │ │ +00201b40: 636b 3a20 202d 380a 4669 7273 7420 7573 ck: -8.First us │ │ │ +00201b50: 6572 2072 656c 6561 7365 7320 6869 7320 er releases his │ │ │ +00201b60: 6c6f 636b 3a20 2031 3534 3563 6535 342d lock: 1545ce54- │ │ │ +00201b70: 3335 3939 2d31 3164 612d 3836 3937 2d38 3599-11da-8697-8 │ │ │ +00201b80: 6633 6566 6264 3836 6566 320a 4669 7273 f3efbd86ef2.Firs │ │ │ +00201b90: 7420 7573 6572 2073 6574 7320 616e 2065 t user sets an e │ │ │ +00201ba0: 7863 6c75 7369 7665 206c 6f63 6b3a 2020 xclusive lock: │ │ │ +00201bb0: 3135 3437 3235 3161 2d33 3539 392d 3131 1547251a-3599-11 │ │ │ +00201bc0: 6461 2d38 3639 372d 3866 3365 6662 6438 da-8697-8f3efbd8 │ │ │ +00201bd0: 3665 6632 0a53 6563 6f6e 6420 7573 6572 6ef2.Second user │ │ │ +00201be0: 2074 7269 6573 2074 6f20 6164 6420 6120 tries to add a │ │ │ +00201bf0: 7072 6f70 6572 7479 2074 6f20 7468 6520 property to the │ │ │ +00201c00: 7265 736f 7572 6365 3a20 202d 380a 4669 resource: -8.Fi │ │ │ +00201c10: 7273 7420 7573 6572 2072 656c 6561 7365 rst user release │ │ │ +00201c20: 7320 6869 7320 7368 6172 6564 3a20 2031 s his shared: 1 │ │ │ +00201c30: 3534 3732 3531 612d 3335 3939 2d31 3164 547251a-3599-11d │ │ │ +00201c40: 612d 3836 3937 2d38 6633 6566 6264 3836 a-8697-8f3efbd86 │ │ │ +00201c50: 6566 320a 5365 636f 6e64 2075 7365 7220 ef2.Second user │ │ │ +00201c60: 6164 6473 2061 2070 726f 7065 7274 7920 adds a property │ │ │ +00201c70: 746f 2074 6865 2072 6573 6f75 7263 653a to the resource: │ │ │ +00201c80: 2020 3133 3231 0a5d 5d3e 0a20 2020 2020 1321.]]>. │ │ │ +00201c90: 203c 2f73 6372 6565 6e3e 0a20 2020 203c . < │ │ │ +00201ca0: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. . . See Also │ │ │ +00201cf0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . DAV content ad │ │ │ +00201d30: 642f 7570 6461 7465 2f64 656c 6574 6520 d/update/delete │ │ │ +00201d40: 6675 6e63 7469 6f6e 733c 2f6c 696e 6b3e functions │ │ │ +00201d50: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . DAV content │ │ │ +00201d90: 6d61 6e69 7075 6c61 7469 6f6e 2066 756e manipulation fun │ │ │ +00201da0: 6374 696f 6e73 3c2f 6c69 6e6b 3e3c 2f70 ctions

    . < │ │ │ +00201dc0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00201dd0: 5f64 6176 5f61 7069 5f73 6561 7263 6822 _dav_api_search" │ │ │ +00201de0: 3e44 4156 2073 6561 7263 6820 6675 6e63 >DAV search func │ │ │ +00201df0: 7469 6f6e 733c 2f6c 696e 6b3e 3c2f 7061 tions. DA │ │ │ +00201e30: 5620 7573 6572 206d 616e 6167 656d 656e V user managemen │ │ │ +00201e40: 7420 6675 6e63 7469 6f6e 733c 2f6c 696e t functions.
    .......#demo/d │ │ │ +00201e80: 6f63 7372 632f 6675 6e63 7265 662f 7573 ocsrc/funcref/us │ │ │ +00201e90: 6572 5f63 7265 6174 652e 786d 6cdf 0000 er_create.xml... │ │ │ +00201ea0: 0f9b 3c3f 786d 6c20 7665 7273 696f 6e3d ....< │ │ │ +00202230: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ +00202240: 5553 4552 5f43 5245 4154 4522 3e0a 2020 USER_CREATE">. │ │ │ +00202250: 3c72 6566 6d65 7461 3e0a 2020 2020 3c72 . USE │ │ │ +00202270: 525f 4352 4541 5445 3c2f 7265 6665 6e74 R_CREATE. admin< │ │ │ +002022a0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +002022b0: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . USER_CREA │ │ │ +002022e0: 5445 3c2f 7265 666e 616d 653e 0a20 2020 TE
    . │ │ │ +002022f0: 203c 7265 6670 7572 706f 7365 3e63 7265 cre │ │ │ +00202300: 6174 6520 6120 6e65 7720 7573 6572 2061 ate a new user a │ │ │ +00202310: 6363 6f75 6e74 3c2f 7265 6670 7572 706f ccount. . . . │ │ │ +00202370: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +002023a0: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ +002023b0: 6675 6e63 7469 6f6e 3e55 5345 525f 4352 function>USER_CR │ │ │ +002023c0: 4541 5445 3c2f 6675 6e63 7469 6f6e 3e3c EATE< │ │ │ +002023d0: 2f66 756e 6364 6566 3e0a 093c 7061 7261 /funcdef>..in name varchar..in │ │ │ +00202430: 7061 7373 776f 7264 3c2f 7061 7261 6d65 password varchar..in options vector. . │ │ │ +002024b0: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . . Description< │ │ │ +00202510: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. This function │ │ │ +00202530: 6372 6561 7465 7320 6120 6e65 7720 7573 creates a new us │ │ │ +00202540: 6572 2061 6363 6f75 6e74 2e20 5468 6520 er account. The │ │ │ +00202550: 6163 636f 756e 7420 6973 2076 616c 6964 account is valid │ │ │ +00202560: 2066 6f72 2053 514c 2061 6e64 2f6f 7220 for SQL and/or │ │ │ +00202570: 4441 562c 0a64 6570 656e 6469 6e67 206e DAV,.depending n │ │ │ +00202580: 206f 7074 696f 6e73 2e3c 2f70 6172 613e options. │ │ │ +00202590: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +002025a0: 203c 7265 6673 6563 7431 2069 643d 2270 . P │ │ │ +002025d0: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ +002025f0: 3c74 6974 6c65 3e6e 616d 653c 2f74 6974 name</tit │ │ │ +00202600: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +00202610: 5468 6520 6e61 6d65 206f 6620 7468 6520 The name of the │ │ │ +00202620: 7573 6572 2061 6363 6f75 6e74 2061 7320 user account as │ │ │ +00202630: 6120 7374 7269 6e67 2e3c 2f70 6172 613e a string.</para> │ │ │ +00202640: 0a20 2020 203c 2f72 6566 7365 6374 323e . </refsect2> │ │ │ +00202650: 0a20 2020 203c 7265 6673 6563 7432 3e3c . <refsect2>< │ │ │ +00202660: 7469 746c 653e 7061 7373 776f 7264 3c2f title>password</ │ │ │ +00202670: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ +00202680: 7261 3e54 6865 2063 6c65 6172 2074 6578 ra>The clear tex │ │ │ +00202690: 7420 7061 7373 776f 7264 2066 6f72 2074 t password for t │ │ │ +002026a0: 6865 2075 7365 7220 6163 636f 756e 742e he user account. │ │ │ +002026b0: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 </para>. </re │ │ │ +002026c0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ +002026d0: 7365 6374 323e 3c74 6974 6c65 3e6f 7074 sect2><title>opt │ │ │ +002026e0: 696f 6e73 3c2f 7469 746c 653e 0a20 2020 ions. │ │ │ +002026f0: 2020 203c 7061 7261 3e41 2076 6563 746f A vecto │ │ │ +00202700: 7220 6f66 206e 616d 652d 7661 6c75 6520 r of name-value │ │ │ +00202710: 7061 6972 7320 666f 7220 7573 6572 2020 pairs for user │ │ │ +00202720: 6f70 7469 6f6e 732c 2065 7665 6e20 656c options, even el │ │ │ +00202730: 656d 656e 7473 2066 6f72 206f 7074 696f ements for optio │ │ │ +00202740: 6e20 6e61 6d65 732c 206f 6464 206f 6e65 n names, odd one │ │ │ +00202750: 730a 666f 7220 7661 6c75 6573 2e20 4172 s.for values. Ar │ │ │ +00202760: 6269 7472 6172 7920 6f70 7469 6f6e 7320 bitrary options │ │ │ +00202770: 6361 6e20 6265 2073 7570 706c 6965 642e can be supplied. │ │ │ +00202780: 2054 6865 2056 6972 7475 6f73 6f20 7265 The Virtuoso re │ │ │ +00202790: 7365 7276 6564 206f 7074 696f 6e73 2063 served options c │ │ │ +002027a0: 616e 2062 6520 666f 756e 6420 696e 2074 an be found in t │ │ │ +002027b0: 6865 0a3c 6c69 6e6b 206c 696e 6b65 6e64 he.User Options sub-sectio │ │ │ +002027f0: 6e20 6f66 2074 6865 2055 7365 7220 4164 n of the User Ad │ │ │ +00202800: 6d69 6e69 7374 7261 7469 6f6e 2053 6563 ministration Sec │ │ │ +00202810: 7469 6f6e 2e3c 2f70 6172 613e 0a20 2020 tion.. │ │ │ +00202820: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ +00202830: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Return Types< │ │ │ +00202870: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. None. │ │ │ +00202890: 3c2f 7265 6673 6563 7431 3e0a 3c21 2d2d .. │ │ │ +00202a40: 0a20 2020 203c 7469 746c 653e 5365 6520 . See │ │ │ +00202a50: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ +00202a60: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e User Optio │ │ │ +00202a90: 6e73 2053 6563 7469 6f6e 3c2f 6c69 6e6b ns Section. USER_ROLE_CREAT │ │ │ +00202af0: 4528 293c 2f66 756e 6374 696f 6e3e 3c2f E(). │ │ │ +00202b10: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e US │ │ │ +00202b40: 4552 5f44 524f 5028 293c 2f66 756e 6374 ER_DROP().
  • < │ │ │ +00202b90: 6675 6e63 7469 6f6e 3e55 5345 525f 524f function>USER_RO │ │ │ +00202ba0: 4c45 5f44 524f 5028 293c 2f66 756e 6374 LE_DROP().
  • U │ │ │ +00202c00: 5345 525f 4348 414e 4745 5f50 4153 5357 SER_CHANGE_PASSW │ │ │ +00202c10: 4f52 4428 293c 2f66 756e 6374 696f 6e3e ORD() │ │ │ +00202c20: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +00202c30: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c < │ │ │ +00202c60: 6675 6e63 7469 6f6e 3e55 5345 525f 5345 function>USER_SE │ │ │ +00202c70: 545f 5155 414c 4946 4945 5228 293c 2f66 T_QUALIFIER()< │ │ │ +00202c90: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. US │ │ │ +00202cd0: 4552 5f47 5241 4e54 5f52 4f4c 4528 293c ER_GRANT_ROLE()< │ │ │ +00202ce0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. USER_REVOKE_ROL │ │ │ +00202d40: 4528 293c 2f66 756e 6374 696f 6e3e 3c2f E(). │ │ │ +00202d60: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e USER_SET_OPT │ │ │ +00202da0: 494f 4e53 2829 3c2f 6675 6e63 7469 6f6e IONS(). │ │ │ +00202dc0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 USER_GET_ │ │ │ +00202e00: 4f50 5449 4f4e 5328 293c 2f66 756e 6374 OPTIONS(). │ │ │ +00202e30: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 ..... │ │ │ +00202e40: 0027 6465 6d6f 2f64 6f63 7372 632f 6675 .'demo/docsrc/fu │ │ │ +00202e50: 6e63 7265 662f 7870 6572 5f6e 6176 6967 ncref/xper_navig │ │ │ +00202e60: 6174 696f 6e2e 786d 6cdf 0000 287e 3c3f ation.xml...(~.. │ │ │ +00203220: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ +00203230: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ +00203240: 5850 4552 206e 6176 6967 6174 696f 6e3c XPER navigation< │ │ │ +00203250: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +00203260: 2020 2020 3c72 6566 6d69 7363 696e 666f xml. . │ │ │ +00203290: 2020 3c72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +002032a0: 2020 203c 7265 666e 616d 653e 7870 6572 xper │ │ │ +002032b0: 5f72 6967 6874 5f73 6962 6c69 6e67 3c2f _right_sibling. xper_left_ │ │ │ +002032e0: 7369 626c 696e 673c 2f72 6566 6e61 6d65 sibling. x │ │ │ +00203300: 7065 725f 7061 7265 6e74 3c2f 7265 666e per_parent. xper_root_enti │ │ │ +00203330: 7479 3c2f 7265 666e 616d 653e 0a20 2020 ty. │ │ │ +00203340: 203c 7265 666e 616d 653e 7870 6572 5f74 xper_t │ │ │ +00203350: 656c 6c3c 2f72 6566 6e61 6d65 3e0a 2020 ell. │ │ │ +00203360: 2020 3c72 6566 6e61 6d65 3e78 7065 725f xper_ │ │ │ +00203370: 6c65 6e67 7468 3c2f 7265 666e 616d 653e length │ │ │ +00203380: 0a20 2020 203c 7265 6670 7572 706f 7365 . low-level navig │ │ │ +002033a0: 6174 696f 6e20 6675 6e63 7469 6f6e 7320 ation functions │ │ │ +002033b0: 666f 7220 7065 7273 6973 7465 6e74 2058 for persistent X │ │ │ +002033c0: 4d4c 732c 2075 7365 6675 6c20 666f 7220 MLs, useful for │ │ │ +002033d0: 696d 706f 7274 206f 6620 6875 6765 2061 import of huge a │ │ │ +002033e0: 6d6f 756e 7473 206f 6620 584d 4c20 6461 mounts of XML da │ │ │ +002033f0: 7461 3c2f 7265 6670 7572 706f 7365 3e0a ta. │ │ │ +00203400: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ +00203410: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ +00203490: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 xper_right_si │ │ │ +002034b0: 626c 696e 673c 2f66 756e 6374 696f 6e3e bling │ │ │ +002034c0: 3c2f 6675 6e63 6465 663e 0a20 2020 2020 . │ │ │ +002034d0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ +002034e0: 3c70 6172 616d 6574 6572 3e78 7065 725f xper_ │ │ │ +002034f0: 656e 7469 7479 3c2f 7061 7261 6d65 7465 entityXML_entity. . │ │ │ +00203530: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . . xper_left_sibli │ │ │ +002035d0: 6e67 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 ng. │ │ │ +002035f0: 3c70 6172 616d 6465 663e 696e 203c 7061 in xper_ent │ │ │ +00203610: 6974 793c 2f70 6172 616d 6574 6572 3e58 ityX │ │ │ +00203620: 4d4c 5f65 6e74 6974 793c 2f70 6172 616d ML_entity. . │ │ │ +00203650: 203c 2f66 756e 6373 796e 6f70 7369 733e │ │ │ +00203660: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . │ │ │ +00203690: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ +002036c0: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 xper_parent. in xper_entity< │ │ │ +00203720: 2f70 6172 616d 6574 6572 3e58 4d4c 5f65 /parameter>XML_e │ │ │ +00203730: 6e74 6974 793c 2f70 6172 616d 6465 663e ntity │ │ │ +00203740: 0a20 2020 2020 2020 3c2f 6675 6e63 7072 . . . │ │ │ +00203770: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . │ │ │ +002037a0: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ +002037d0: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ +002037e0: 6675 6e63 7469 6f6e 3e78 7065 725f 726f function>xper_ro │ │ │ +002037f0: 6f74 5f65 6e74 6974 793c 2f66 756e 6374 ot_entity. │ │ │ +00203810: 2020 2020 2020 203c 7061 7261 6d64 6566 in x │ │ │ +00203830: 7065 725f 656e 7469 7479 3c2f 7061 7261 per_entityXML_entity │ │ │ +00203850: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +00203860: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . │ │ │ +002038b0: 2020 2020 203c 6675 6e63 7072 6f74 6f74 . │ │ │ +002038e0: 2020 203c 6675 6e63 6465 663e 3c66 756e xper_tell< │ │ │ +00203900: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>. in xper_entity │ │ │ +00203940: 3c2f 7061 7261 6d65 7465 723e 584d 4c5f XML_ │ │ │ +00203950: 656e 7469 7479 3c2f 7061 7261 6d64 6566 entity. . . │ │ │ +00203990: 2020 3c66 756e 6373 796e 6f70 7369 7320 . . │ │ │ +00203a00: 7870 6572 5f6c 656e 6774 683c 2f66 756e xper_length │ │ │ +00203a20: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in xper_entityXML_enti │ │ │ +00203a60: 7479 3c2f 7061 7261 6d64 6566 3e0a 2020 ty. │ │ │ +00203a70: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ +00203ab0: 3c72 6566 7365 6374 3120 6964 3d22 6465 Descr │ │ │ +00203ad0: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ +00203ae0: 2020 203c 7061 7261 3e0a 416c 6c20 7468 .All th │ │ │ +00203af0: 6573 6520 6675 6e63 7469 6f6e 7320 776f ese functions wo │ │ │ +00203b00: 726b 2077 6974 6820 2671 756f 743b 7065 rk with "pe │ │ │ +00203b10: 7273 6973 7465 6e74 2058 4d4c 2671 756f rsistent XML&quo │ │ │ +00203b20: 743b 2028 5850 4552 2920 656e 7469 7469 t; (XPER) entiti │ │ │ +00203b30: 6573 206f 6e6c 792c 2073 6967 6e61 6c6c es only, signall │ │ │ +00203b40: 696e 6720 6572 726f 7273 2069 660a 6769 ing errors if.gi │ │ │ +00203b50: 7665 6e20 656e 7469 7479 2070 6f69 6e74 ven entity point │ │ │ +00203b60: 7320 746f 2026 7175 6f74 3b58 4d4c 2074 s to "XML t │ │ │ +00203b70: 7265 6526 7175 6f74 3b2e 2020 5468 6579 ree". They │ │ │ +00203b80: 2061 7265 2075 7365 6675 6c20 7768 656e are useful when │ │ │ +00203b90: 2061 7070 6c69 6361 7469 6f6e 7320 6e65 applications ne │ │ │ +00203ba0: 6564 2074 6f20 7265 6164 2061 0a68 7567 ed to read a.hug │ │ │ +00203bb0: 6520 584d 4c20 646f 6375 6d65 6e74 2c20 e XML document, │ │ │ +00203bc0: 6573 7065 6369 616c 6c79 2073 6f6d 6574 especially somet │ │ │ +00203bd0: 6869 6e67 206c 696b 6520 6120 6461 7461 hing like a data │ │ │ +00203be0: 7368 6565 7420 6475 6d70 206f 7220 6576 sheet dump or ev │ │ │ +00203bf0: 656e 7420 6c6f 6720 7769 7468 2061 206c ent log with a l │ │ │ +00203c00: 6172 6765 206e 756d 6265 720a 6f66 2075 arge number.of u │ │ │ +00203c10: 6e69 666f 726d 2072 6563 6f72 6473 2c20 niform records, │ │ │ +00203c20: 616e 6420 6973 2072 6571 7569 7265 6420 and is required │ │ │ +00203c30: 746f 2070 726f 6365 7373 2061 6c6c 2072 to process all r │ │ │ +00203c40: 6563 6f72 6473 206f 6620 7468 6520 646f ecords of the do │ │ │ +00203c50: 6375 6d65 6e74 2c20 652e 672e 2069 6d70 cument, e.g. imp │ │ │ +00203c60: 6f72 7420 7468 656d 2069 6e74 6f0a 7468 ort them into.th │ │ │ +00203c70: 6520 6461 7461 6261 7365 2e0a 3c2f 7061 e database... .Con │ │ │ +00203c90: 7369 6465 7220 6120 7265 616c 2073 616d sider a real sam │ │ │ +00203ca0: 706c 6520 6f66 2069 6d70 6f72 7420 616c ple of import al │ │ │ +00203cb0: 6c20 6461 7461 2066 726f 6d20 4f44 5027 l data from ODP' │ │ │ +00203cc0: 7320 636f 6e74 656e 742e 786d 6c20 6475 s content.xml du │ │ │ +00203cd0: 6d70 2077 6869 6368 2063 6f6e 7461 696e mp which contain │ │ │ +00203ce0: 7320 6d6f 7265 2074 6861 6e0a 322c 3030 s more than.2,00 │ │ │ +00203cf0: 302c 3030 3020 6465 7363 7269 7074 696f 0,000 descriptio │ │ │ +00203d00: 6e73 206f 6620 7661 7269 6f75 7320 5765 ns of various We │ │ │ +00203d10: 622d 7369 7465 732c 2061 6e64 2074 6865 b-sites, and the │ │ │ +00203d20: 206c 656e 6774 6820 6f66 2074 6865 2066 length of the f │ │ │ +00203d30: 696c 6520 6973 206d 6f72 6520 7468 616e ile is more than │ │ │ +00203d40: 2036 3030 4d62 2e20 2054 6865 0a66 696c 600Mb. The.fil │ │ │ +00203d50: 6520 6861 7320 726f 6f74 2065 6c65 6d65 e has root eleme │ │ │ +00203d60: 6e74 206e 616d 6564 2027 5244 4627 2061 nt named 'RDF' a │ │ │ +00203d70: 6e64 2061 6c6c 2064 6573 6372 6970 7469 nd all descripti │ │ │ +00203d80: 6f6e 7320 6172 6520 7468 6569 7220 6368 ons are their ch │ │ │ +00203d90: 696c 6472 656e 206e 616d 6564 2065 6974 ildren named eit │ │ │ +00203da0: 6865 7220 2754 6f70 6963 2720 6f72 0a27 her 'Topic' or.' │ │ │ +00203db0: 4578 7465 726e 616c 5061 6765 272e 2054 ExternalPage'. T │ │ │ +00203dc0: 6869 7320 636f 6465 206c 6f6f 6b73 2073 his code looks s │ │ │ +00203dd0: 7569 7461 626c 6520 666f 7220 696d 706f uitable for impo │ │ │ +00203de0: 7274 696e 6720 7468 6573 6520 6368 696c rting these chil │ │ │ +00203df0: 6472 656e 3a3c 2f70 6172 613e 0a20 203c dren:. < │ │ │ +00203e00: 7072 6f67 7261 6d6c 6973 7469 6e67 3e0a programlisting>. │ │ │ +00203e10: 6372 6561 7465 2070 726f 6365 6475 7265 create procedure │ │ │ +00203e20: 0a20 2069 6d70 6f72 745f 636f 6e74 656e . import_conten │ │ │ +00203e30: 745f 786d 6c20 2829 0a20 207b 0a20 2020 t_xml (). {. │ │ │ +00203e40: 2066 6f72 2073 656c 6563 7420 5f66 7261 for select _fra │ │ │ +00203e50: 672c 2078 7061 7468 5f65 7661 6c28 276c g, xpath_eval('l │ │ │ +00203e60: 6f63 616c 5f6e 616d 6528 2927 2c20 5f66 ocal_name()', _f │ │ │ +00203e70: 7261 6729 2061 7320 5f74 6167 2066 726f rag) as _tag fro │ │ │ +00203e80: 6d20 534f 5552 4345 5f58 4d4c 0a20 2020 m SOURCE_XML. │ │ │ +00203e90: 2020 2077 6865 7265 204e 414d 453d 2763 where NAME='c │ │ │ +00203ea0: 6f6e 7465 6e74 2e78 6d6c 2720 616e 6420 ontent.xml' and │ │ │ +00203eb0: 7870 6174 685f 636f 6e74 6169 6e73 2858 xpath_contains(X │ │ │ +00203ec0: 5045 522c 272f 5244 462f 2a27 2c5f 6672 PER,'/RDF/*',_fr │ │ │ +00203ed0: 6167 290a 2020 2020 646f 0a20 2020 207b ag). do. { │ │ │ +00203ee0: 0a20 2020 2020 2069 6620 285f 7461 673d . if (_tag= │ │ │ +00203ef0: 2754 6f70 6963 2729 2069 6d70 6f72 745f 'Topic') import_ │ │ │ +00203f00: 746f 7069 6320 285f 6672 6167 293b 0a20 topic (_frag);. │ │ │ +00203f10: 2020 2020 2065 6c73 650a 2020 2020 2020 else. │ │ │ +00203f20: 7b0a 2020 2020 2020 2020 6966 2028 5f74 {. if (_t │ │ │ +00203f30: 6167 3d27 4578 7465 726e 616c 5061 6765 ag='ExternalPage │ │ │ +00203f40: 2729 2069 6d70 6f72 745f 6578 7465 726e ') import_extern │ │ │ +00203f50: 616c 2028 5f66 7261 6729 3b0a 2020 2020 al (_frag);. │ │ │ +00203f60: 2020 2020 656c 7365 206c 6f67 5f69 6d70 else log_imp │ │ │ +00203f70: 6f72 745f 6572 726f 7220 285f 6672 6167 ort_error (_frag │ │ │ +00203f80: 2c20 2671 756f 743b 556e 6b6e 6f77 6e20 , "Unknown │ │ │ +00203f90: 7479 7065 206f 6620 7265 636f 7264 2671 type of record&q │ │ │ +00203fa0: 756f 743b 293b 0a20 2020 2020 207d 0a20 uot;);. }. │ │ │ +00203fb0: 2020 207d 0a20 207d 3b0a 2020 2d2d 2054 }. };. -- T │ │ │ +00203fc0: 6869 7320 7368 6f75 6c64 206c 6f61 6420 his should load │ │ │ +00203fd0: 6669 6c65 7320 6c69 6b65 2063 6f6e 7465 files like conte │ │ │ +00203fe0: 6e74 2e78 6d6c 2c20 616e 6420 706c 6163 nt.xml, and plac │ │ │ +00203ff0: 6520 5850 4552 7320 696e 746f 2053 4f55 e XPERs into SOU │ │ │ +00204000: 5243 455f 584d 4c20 7461 626c 650a 0a72 RCE_XML table..r │ │ │ +00204010: 6561 645f 736f 7572 6365 5f78 6d6c 7328 ead_source_xmls( │ │ │ +00204020: 293b 0a20 202d 2d20 4e6f 7720 534f 5552 );. -- Now SOUR │ │ │ +00204030: 4345 5f58 4d4c 2069 7320 6669 6c6c 6564 CE_XML is filled │ │ │ +00204040: 2061 6e64 2064 6174 6120 7368 6f75 6c64 and data should │ │ │ +00204050: 2062 6520 696d 706f 7274 6564 2e0a 0a69 be imported...i │ │ │ +00204060: 6d70 6f72 745f 636f 6e74 656e 745f 786d mport_content_xm │ │ │ +00204070: 6c28 293b 0a69 6d70 6f72 745f 7374 7275 l();.import_stru │ │ │ +00204080: 6374 7572 655f 786d 6c28 293b 0a69 6d70 cture_xml();.imp │ │ │ +00204090: 6f72 745f 7072 6f66 696c 6573 5f78 6d6c ort_profiles_xml │ │ │ +002040a0: 2829 3b0a 202e 2e2e 0a3c 2f70 726f 6772 ();. ......

    .It looks fi │ │ │ +002040d0: 6e65 2061 6e64 2069 7420 7061 7373 6573 ne and it passes │ │ │ +002040e0: 2073 6d61 6c6c 2074 6573 7473 2062 7574 small tests but │ │ │ +002040f0: 2069 7420 7769 6c6c 206e 6f74 2077 6f72 it will not wor │ │ │ +00204100: 6b20 6f6e 2072 6561 6c20 6461 7461 213c k on real data!< │ │ │ +00204110: 2f70 6172 613e 0a20 203c 7061 7261 3e0a /para>. . │ │ │ +00204120: 4669 7273 7420 7072 6f62 6c65 6d20 6973 First problem is │ │ │ +00204130: 2072 6567 756c 6172 2063 6865 636b 706f regular checkpo │ │ │ +00204140: 696e 7473 2028 6576 6572 7920 3120 686f ints (every 1 ho │ │ │ +00204150: 7572 2062 7920 6465 6661 756c 7429 2c0a ur by default),. │ │ │ +00204160: 736f 2069 6d70 6f72 745f 636f 6e74 656e so import_conten │ │ │ +00204170: 745f 786d 6c20 6861 7320 6e6f 2063 6861 t_xml has no cha │ │ │ +00204180: 6e63 6520 746f 2062 6520 636f 6d70 6c65 nce to be comple │ │ │ +00204190: 7465 6420 6966 2069 7420 7461 6b65 7320 ted if it takes │ │ │ +002041a0: 312e 3520 686f 7572 7320 6f66 2043 5055 1.5 hours of CPU │ │ │ +002041b0: 2074 696d 653b 0a74 6865 2066 756e 6374 time;.the funct │ │ │ +002041c0: 696f 6e20 6368 6563 6b70 6f69 6e74 5f69 ion checkpoint_i │ │ │ +002041d0: 6e74 6572 7661 6c20 7368 6f75 6c64 2062 nterval should b │ │ │ +002041e0: 6520 7573 6564 2074 6f20 7465 6d70 6f72 e used to tempor │ │ │ +002041f0: 6172 696c 7920 6469 7361 626c 6520 7468 arily disable th │ │ │ +00204200: 6573 6520 6368 6563 6b70 6f69 6e74 732e ese checkpoints. │ │ │ +00204210: 0a54 6865 6e2c 2074 6865 206c 656e 6774 .Then, the lengt │ │ │ +00204220: 6820 6f66 2074 7261 6e73 6163 7469 6f6e h of transaction │ │ │ +00204230: 206c 6f67 2062 6563 6f6d 6520 6578 7472 log become extr │ │ │ +00204240: 656d 656c 7920 6c61 7267 6520 6166 7465 emely large afte │ │ │ +00204250: 7220 7377 6974 6368 696e 6720 6368 6563 r switching chec │ │ │ +00204260: 6b70 6f69 6e74 7320 6f66 662c 0a61 6e64 kpoints off,.and │ │ │ +00204270: 2069 7420 6973 2062 6574 7465 7220 746f it is better to │ │ │ +00204280: 2069 6e73 6572 7420 6578 706c 6963 6974 insert explicit │ │ │ +00204290: 2063 6865 636b 706f 696e 7473 2062 6574 checkpoints bet │ │ │ +002042a0: 7765 656e 2063 616c 6c73 206f 6620 7468 ween calls of th │ │ │ +002042b0: 6573 6520 6675 6e63 7469 6f6e 732e 0a46 ese functions..F │ │ │ +002042c0: 696e 616c 6c79 2c20 696d 706f 7274 5f63 inally, import_c │ │ │ +002042d0: 6f6e 7465 6e74 5f78 6d6c 2077 696c 6c20 ontent_xml will │ │ │ +002042e0: 6368 616e 6765 206d 6f72 6520 7468 616e change more than │ │ │ +002042f0: 2034 2067 6967 6162 7974 6573 206f 6620 4 gigabytes of │ │ │ +00204300: 6461 7461 2069 6e20 6f6e 6520 7472 616e data in one tran │ │ │ +00204310: 7361 6374 696f 6e2e 0a54 6869 7320 776f saction..This wo │ │ │ +00204320: 756c 6420 6265 2069 6d70 6f73 7369 626c uld be impossibl │ │ │ +00204330: 6520 6f6e 2061 6e79 2033 322d 6269 7420 e on any 32-bit │ │ │ +00204340: 706c 6174 666f 726d 2c20 6265 6361 7573 platform, becaus │ │ │ +00204350: 6520 626f 7468 206d 656d 6f72 7920 6176 e both memory av │ │ │ +00204360: 6169 6c61 626c 6520 616e 6420 6164 6472 ailable and addr │ │ │ +00204370: 6573 7320 7370 6163 650a 6265 636f 6d65 ess space.become │ │ │ +00204380: 2069 6e73 7566 6669 6369 656e 742e 2020 insufficient. │ │ │ +00204390: 4164 6469 6e67 2069 6e74 6572 6d65 6469 Adding intermedi │ │ │ +002043a0: 6174 6520 2763 6f6d 6d69 7420 776f 726b ate 'commit work │ │ │ +002043b0: 2720 7374 6174 656d 656e 7473 2069 6e73 ' statements ins │ │ │ +002043c0: 6964 6520 7468 6520 6c6f 6f70 2773 2062 ide the loop's b │ │ │ +002043d0: 6f64 790a 7769 6c6c 206e 6f74 2068 656c ody.will not hel │ │ │ +002043e0: 7020 6265 6361 7573 6520 626f 7468 2027 p because both ' │ │ │ +002043f0: 636f 6d6d 6974 2077 6f72 6b27 2061 6e64 commit work' and │ │ │ +00204400: 2027 726f 6c6c 6261 636b 2077 6f72 6b27 'rollback work' │ │ │ +00204410: 2073 7461 7465 6d65 6e74 7320 7769 6c6c statements will │ │ │ +00204420: 2063 6c6f 7365 2061 6c6c 206f 7065 6e65 close all opene │ │ │ +00204430: 6420 6375 7273 6f72 732e 0a4c 6f6f 7020 d cursors..Loop │ │ │ +00204440: 2766 6f72 2073 656c 6563 7420 2e2e 2e20 'for select ... │ │ │ +00204450: 6672 6f6d 202e 2e2e 2064 6f27 2075 7365 from ... do' use │ │ │ +00204460: 7320 616e 2069 6d70 6c69 6369 7420 6375 s an implicit cu │ │ │ +00204470: 7273 6f72 2074 6f20 6974 6572 6174 6520 rsor to iterate │ │ │ +00204480: 7468 6520 7265 7375 6c74 7365 742c 2062 the resultset, b │ │ │ +00204490: 7574 2074 6865 0a27 636f 6d6d 6974 2077 ut the.'commit w │ │ │ +002044a0: 6f72 6b27 206f 7065 7261 746f 7220 7769 ork' operator wi │ │ │ +002044b0: 6c6c 2063 6c6f 7365 2074 6869 7320 6375 ll close this cu │ │ │ +002044c0: 7273 6f72 2061 6e64 2061 626f 7274 2074 rsor and abort t │ │ │ +002044d0: 6865 206c 6f6f 702e 3c2f 7061 7261 3e0a he loop.. │ │ │ +002044e0: 2020 3c70 6172 613e 0a46 756e 6374 696f .Functio │ │ │ +002044f0: 6e20 7870 6572 5f72 6967 6874 5f73 6962 n xper_right_sib │ │ │ +00204500: 6c69 6e67 2069 7320 6465 7369 676e 6564 ling is designed │ │ │ +00204510: 2073 7065 6369 616c 6c79 2074 6f20 736f specially to so │ │ │ +00204520: 6c76 6520 7468 6520 6c61 7374 2070 726f lve the last pro │ │ │ +00204530: 626c 656d 2e20 2049 7420 616c 6c6f 7773 blem. It allows │ │ │ +00204540: 2079 6f75 0a74 6f20 6974 6572 6174 6520 you.to iterate │ │ │ +00204550: 6368 696c 6472 656e 206f 6620 736f 6d65 children of some │ │ │ +00204560: 2065 6c65 6d65 6e74 2077 6974 686f 7574 element without │ │ │ +00204570: 2075 7369 6e67 2061 6e79 2063 7572 736f using any curso │ │ │ +00204580: 7220 6174 2061 6c6c 2e0a 4974 2072 6574 r at all..It ret │ │ │ +00204590: 7572 6e73 2074 6865 2072 6967 6874 2063 urns the right c │ │ │ +002045a0: 6869 6c64 206f 6620 7468 6520 656e 7469 hild of the enti │ │ │ +002045b0: 7479 2070 6173 7365 6420 6173 2069 7473 ty passed as its │ │ │ +002045c0: 2061 7267 756d 656e 742e 2020 4966 2074 argument. If t │ │ │ +002045d0: 6865 2067 6976 656e 2065 6e74 6974 790a he given entity. │ │ │ +002045e0: 6973 2074 6865 206c 6173 7420 6368 696c is the last chil │ │ │ +002045f0: 6420 6f66 2069 7473 2070 6172 656e 742c d of its parent, │ │ │ +00204600: 2074 6865 2066 756e 6374 696f 6e20 7769 the function wi │ │ │ +00204610: 6c6c 2072 6574 7572 6e20 4e55 4c4c 2e20 ll return NULL. │ │ │ +00204620: 2053 696d 696c 6172 6c79 2c20 7870 6572 Similarly, xper │ │ │ +00204630: 5f6c 6566 745f 7369 626c 696e 6720 7769 _left_sibling wi │ │ │ +00204640: 6c6c 0a72 6574 7572 6e20 7468 6520 7072 ll.return the pr │ │ │ +00204650: 6576 696f 7573 2063 6869 6c64 206f 7220 evious child or │ │ │ +00204660: 4e55 4c4c 2066 6f72 2074 6865 2066 6972 NULL for the fir │ │ │ +00204670: 7374 2063 6869 6c64 2c20 7870 6572 5f70 st child, xper_p │ │ │ +00204680: 6172 656e 7420 7769 6c6c 2072 6574 7572 arent will retur │ │ │ +00204690: 6e20 7061 7265 6e74 206f 660a 656e 7469 n parent of.enti │ │ │ +002046a0: 7479 206f 7220 4e55 4c4c 2066 6f72 2074 ty or NULL for t │ │ │ +002046b0: 6865 2064 6f63 756d 656e 7427 7320 726f he document's ro │ │ │ +002046c0: 6f74 2061 6e64 2078 7065 725f 726f 6f74 ot and xper_root │ │ │ +002046d0: 5f65 6e74 6974 7920 7769 6c6c 2072 6574 _entity will ret │ │ │ +002046e0: 7572 6e20 7468 6520 726f 6f74 2066 6f72 urn the root for │ │ │ +002046f0: 2061 6e79 0a65 6e74 6974 792e 2020 5573 any.entity. Us │ │ │ +00204700: 696e 6720 7468 6573 6520 6675 6e63 7469 ing these functi │ │ │ +00204710: 6f6e 732c 2069 7420 6973 2070 6f73 7369 ons, it is possi │ │ │ +00204720: 626c 6520 746f 2073 6361 6e20 7468 6520 ble to scan the │ │ │ +00204730: 646f 6375 6d65 6e74 2066 6f72 7761 7264 document forward │ │ │ +00204740: 2028 6672 6f6d 206c 6566 740a 746f 2072 (from left.to r │ │ │ +00204750: 6967 6874 292c 2062 6163 6b77 6172 6420 ight), backward │ │ │ +00204760: 616e 6420 746f 2026 7175 6f74 3b63 6c69 and to "cli │ │ │ +00204770: 6d62 2075 7026 7175 6f74 3b20 746f 7761 mb up" towa │ │ │ +00204780: 7264 2074 6865 2072 6f6f 7420 6f66 2074 rd the root of t │ │ │ +00204790: 6865 2065 6c65 6d65 6e74 7327 2074 7265 he elements' tre │ │ │ +002047a0: 652e 2020 5468 6573 650a 6675 6e63 7469 e. These.functi │ │ │ +002047b0: 6f6e 7320 6172 6520 6361 6c6c 6564 203c ons are called < │ │ │ +002047c0: 656d 7068 6173 6973 3e58 4d4c 204e 6176 emphasis>XML Nav │ │ │ +002047d0: 6967 6174 696f 6e20 4675 6e63 7469 6f6e igation Function │ │ │ +002047e0: 733c 2f65 6d70 6861 7369 733e 2062 6563 s bec │ │ │ +002047f0: 6175 7365 2074 6865 7920 6172 6520 6c69 ause they are li │ │ │ +00204800: 6b65 0a74 6865 2073 7461 7465 6d65 6e74 ke.the statement │ │ │ +00204810: 7320 2671 756f 743b 6e65 7874 2072 6563 s "next rec │ │ │ +00204820: 6f72 6426 7175 6f74 3b2c 2026 7175 6f74 ord", " │ │ │ +00204830: 3b70 7265 7620 7265 636f 7264 2671 756f ;prev record&quo │ │ │ +00204840: 743b 2065 7463 2e2c 2075 7365 6420 696e t; etc., used in │ │ │ +00204850: 2063 7572 736f 720a 6c69 6b65 206e 6176 cursor.like nav │ │ │ +00204860: 6967 6174 696f 6e20 6f66 2064 6174 6162 igation of datab │ │ │ +00204870: 6173 6573 2e3c 2f70 6172 613e 0a20 203c ases.. < │ │ │ +00204880: 7061 7261 3e0a 5468 6572 6520 6172 6520 para>.There are │ │ │ +00204890: 6e6f 2073 7065 6369 616c 2066 756e 6374 no special funct │ │ │ +002048a0: 696f 6e73 2074 6f20 2671 756f 743b 676f ions to "go │ │ │ +002048b0: 2064 6f77 6e26 7175 6f74 3b2c 2065 2e67 down", e.g │ │ │ +002048c0: 2e20 746f 2066 696e 6420 6669 7273 7420 . to find first │ │ │ +002048d0: 6368 696c 6472 656e 206f 660a 6769 7665 children of.give │ │ │ +002048e0: 6e20 656c 656d 656e 742c 2062 6563 6175 n element, becau │ │ │ +002048f0: 7365 2078 7061 7468 5f65 7661 6c20 6361 se xpath_eval ca │ │ │ +00204900: 6e20 646f 2061 6e79 2073 7563 6820 6d6f n do any such mo │ │ │ +00204910: 7665 6d65 6e74 2076 6572 7920 7175 6963 vement very quic │ │ │ +00204920: 6b6c 792e 3c2f 7061 7261 3e0a 2020 3c70 kly..

    .Sometimes d │ │ │ +00204940: 6174 6120 696d 706f 7274 2069 7320 636f ata import is co │ │ │ +00204950: 6e74 726f 6c6c 6564 2066 726f 6d20 736f ntrolled from so │ │ │ +00204960: 6d65 2063 6c69 656e 7420 6170 706c 6963 me client applic │ │ │ +00204970: 6174 696f 6e2e 2020 4966 206f 6e65 206f ation. If one o │ │ │ +00204980: 7065 7261 7469 6f6e 2074 616b 6573 0a68 peration takes.h │ │ │ +00204990: 6f75 7273 2c20 736f 6d65 2073 6f72 7420 ours, some sort │ │ │ +002049a0: 6f66 2026 7175 6f74 3b70 726f 6772 6573 of "progres │ │ │ +002049b0: 7320 6261 7226 7175 6f74 3b20 6265 636f s bar" beco │ │ │ +002049c0: 6d65 7320 7665 7279 2075 7365 6675 6c2c mes very useful, │ │ │ +002049d0: 2061 7420 6c65 6173 7420 746f 2073 6565 at least to see │ │ │ +002049e0: 2077 6865 7468 6572 0a61 7070 6c69 6361 whether.applica │ │ │ +002049f0: 7469 6f6e 2077 6f72 6b73 206f 7220 6861 tion works or ha │ │ │ +00204a00: 6e67 732e 2078 7065 725f 6c65 6e67 7468 ngs. xper_length │ │ │ +00204a10: 2074 616b 6573 2061 6e20 5850 4552 2065 takes an XPER e │ │ │ +00204a20: 6e74 6974 7920 616e 6420 7265 7475 726e ntity and return │ │ │ +00204a30: 7320 7768 6f6c 6520 6c65 6e67 7468 206f s whole length o │ │ │ +00204a40: 660a 5850 4552 2064 6973 6b20 696d 6167 f.XPER disk imag │ │ │ +00204a50: 6520 696e 2062 7974 6573 2e20 7870 6572 e in bytes. xper │ │ │ +00204a60: 5f74 656c 6c20 7461 6b65 7320 616e 2058 _tell takes an X │ │ │ +00204a70: 5045 5220 656e 7469 7479 2061 6e64 2072 PER entity and r │ │ │ +00204a80: 6574 7572 6e73 2073 6f6d 6574 6869 6e67 eturns something │ │ │ +00204a90: 206c 696b 6520 656e 7469 7479 2773 206f like entity's o │ │ │ +00204aa0: 6666 7365 740a 696e 7369 6465 2074 6865 ffset.inside the │ │ │ +00204ab0: 2064 6f63 756d 656e 742e 2020 5468 6569 document. Thei │ │ │ +00204ac0: 7220 7265 7375 6c74 7320 6d61 7920 6265 r results may be │ │ │ +00204ad0: 2075 7365 6420 6279 2074 6865 2063 6c69 used by the cli │ │ │ +00204ae0: 656e 7420 6170 706c 6963 6174 696f 6e20 ent application │ │ │ +00204af0: 746f 206d 6f6e 6974 6f72 2074 6865 2070 to monitor the p │ │ │ +00204b00: 726f 6772 6573 730a 616e 6420 6573 7469 rogress.and esti │ │ │ +00204b10: 6d61 7465 2074 6865 2074 696d 6520 756e mate the time un │ │ │ +00204b20: 7469 6c20 636f 6d70 6c65 7469 6f6e 2e20 til completion. │ │ │ +00204b30: 2054 6865 7920 6d61 7920 6265 2065 7370 They may be esp │ │ │ +00204b40: 6563 6961 6c6c 7920 7573 6566 756c 2066 ecially useful f │ │ │ +00204b50: 6f72 2064 6562 7567 6769 6e67 2070 7572 or debugging pur │ │ │ +00204b60: 706f 7365 732c 0a65 2e67 2e20 746f 2072 poses,.e.g. to r │ │ │ +00204b70: 6570 6f72 7420 706f 7369 7469 6f6e 206f eport position o │ │ │ +00204b80: 6620 6572 726f 722e 2020 556e 666f 7274 f error. Unfort │ │ │ +00204b90: 756e 6174 656c 7920 2671 756f 743b 7870 unately "xp │ │ │ +00204ba0: 6572 5f73 6565 6b26 7175 6f74 3b20 6973 er_seek" is │ │ │ +00204bb0: 206e 6f74 2070 6f73 7369 626c 6520 666f not possible fo │ │ │ +00204bc0: 720a 5850 4552 732c 2075 6e6c 696b 6520 r.XPERs, unlike │ │ │ +00204bd0: 7479 7069 6361 6c20 7261 6e64 6f6d 2061 typical random a │ │ │ +00204be0: 6363 6573 7320 746f 2066 696c 6573 2e3c ccess to files.< │ │ │ +00204bf0: 2f70 6172 613e 0a20 203c 7061 7261 3e0a /para>. . │ │ │ +00204c00: 556c 7469 6d61 7465 6c79 2c20 7468 6520 Ultimately, the │ │ │ +00204c10: 776f 726b 696e 6720 7665 7273 696f 6e20 working version │ │ │ +00204c20: 6f66 2074 6865 2070 726f 6365 6475 7265 of the procedure │ │ │ +00204c30: 2064 6573 6372 6962 6564 2061 626f 7665 described above │ │ │ +00204c40: 2077 696c 6c20 6c6f 6f6b 206c 696b 6520 will look like │ │ │ +00204c50: 7468 6973 3a3c 2f70 6172 613e 0a0a 2020 this:.. │ │ │ +00204c60: 3c70 726f 6772 616d 6c69 7374 696e 673e │ │ │ +00204c70: 0a63 7265 6174 6520 7072 6f63 6564 7572 .create procedur │ │ │ +00204c80: 650a 2020 696d 706f 7274 5f63 6f6e 7465 e. import_conte │ │ │ +00204c90: 6e74 5f78 6d6c 2028 290a 2020 7b0a 2020 nt_xml (). {. │ │ │ +00204ca0: 2020 6465 636c 6172 6520 5f66 7261 6720 declare _frag │ │ │ +00204cb0: 616e 793b 0a20 2020 2064 6563 6c61 7265 any;. declare │ │ │ +00204cc0: 205f 7461 6720 616e 793b 0a20 2020 2064 _tag any;. d │ │ │ +00204cd0: 6563 6c61 7265 205f 6e6f 6465 6964 2061 eclare _nodeid a │ │ │ +00204ce0: 6e79 3b0a 2020 2020 6465 636c 6172 6520 ny;. declare │ │ │ +00204cf0: 5f72 5f69 6420 7661 7263 6861 723b 0a20 _r_id varchar;. │ │ │ +00204d00: 2020 2064 6563 6c61 7265 205f 6162 6f75 declare _abou │ │ │ +00204d10: 742c 205f 7469 746c 652c 205f 6465 7363 t, _title, _desc │ │ │ +00204d20: 7269 7074 696f 6e20 7661 7263 6861 723b ription varchar; │ │ │ +00204d30: 0a20 2020 2064 6563 6c61 7265 2043 7572 . declare Cur │ │ │ +00204d40: 5469 6d65 2076 6172 6368 6172 3b0a 2020 Time varchar;. │ │ │ +00204d50: 2020 6465 636c 6172 6520 4672 6167 732c declare Frags, │ │ │ +00204d60: 2049 6e73 6572 7473 2c20 506f 732c 204c Inserts, Pos, L │ │ │ +00204d70: 656e 6774 6820 696e 7465 6765 723b 0a0a ength integer;.. │ │ │ +00204d80: 2020 2020 7365 6c65 6374 205f 6672 6167 select _frag │ │ │ +00204d90: 3120 696e 746f 205f 6672 6167 2066 726f 1 into _frag fro │ │ │ +00204da0: 6d20 534f 5552 4345 5f58 4d4c 0a20 2020 m SOURCE_XML. │ │ │ +00204db0: 2020 2077 6865 7265 204e 414d 4520 3d20 where NAME = │ │ │ +00204dc0: 2763 6f6e 7465 6e74 2e78 6d6c 2720 616e 'content.xml' an │ │ │ +00204dd0: 6420 7870 6174 685f 636f 6e74 6169 6e73 d xpath_contains │ │ │ +00204de0: 2028 5850 4552 2c20 272f 5244 462f 2a27 (XPER, '/RDF/*' │ │ │ +00204df0: 2c20 5f66 7261 6731 293b 0a0a 2020 2020 , _frag1);.. │ │ │ +00204e00: 6966 2028 6e6f 7420 6973 656e 7469 7479 if (not isentity │ │ │ +00204e10: 285f 6672 6167 2929 2073 6967 6e61 6c28 (_frag)) signal( │ │ │ +00204e20: 2734 324f 4450 272c 2027 584d 4c20 736f '42ODP', 'XML so │ │ │ +00204e30: 7572 6365 2022 436f 6e74 656e 7422 2069 urce "Content" i │ │ │ +00204e40: 7320 656d 7074 7927 293b 0a0a 2020 2020 s empty');.. │ │ │ +00204e50: 4672 6167 7320 3a3d 2030 3b0a 2020 2020 Frags := 0;. │ │ │ +00204e60: 496e 7365 7274 7320 3a3d 2030 3b0a 2020 Inserts := 0;. │ │ │ +00204e70: 2020 4c65 6e67 7468 203a 3d20 7870 6572 Length := xper │ │ │ +00204e80: 5f6c 656e 6774 6828 5f66 7261 6729 3b0a _length(_frag);. │ │ │ +00204e90: 2020 2020 7265 7375 6c74 5f6e 616d 6573 result_names │ │ │ +00204ea0: 2028 4375 7254 696d 652c 2046 7261 6773 (CurTime, Frags │ │ │ +00204eb0: 2c20 506f 732c 204c 656e 6774 6829 3b0a , Pos, Length);. │ │ │ +00204ec0: 2020 2020 2d2d 2049 7427 7320 6e6f 7420 -- It's not │ │ │ +00204ed0: 7468 6520 6265 7374 2077 6179 2074 6f20 the best way to │ │ │ +00204ee0: 7072 6f63 6573 7320 6465 6164 6c6f 636b process deadlock │ │ │ +00204ef0: 732c 2062 7574 2069 7420 6d61 7920 6265 s, but it may be │ │ │ +00204f00: 2062 6574 7465 7220 7468 616e 206e 6f74 better than not │ │ │ +00204f10: 6869 6e67 2e0a 0a20 2020 2077 6865 6e65 hing... whene │ │ │ +00204f20: 7665 7220 7371 6c73 7461 7465 2027 3430 ver sqlstate '40 │ │ │ +00204f30: 3030 3127 2067 6f74 6f20 6e65 7874 5f66 001' goto next_f │ │ │ +00204f40: 7261 673b 0a0a 2020 2020 6e65 7874 5f66 rag;.. next_f │ │ │ +00204f50: 7261 673a 0a0a 2020 2020 2d2d 2053 6572 rag:.. -- Ser │ │ │ +00204f60: 7665 7220 7769 6c6c 2069 6e66 6f72 6d20 ver will inform │ │ │ +00204f70: 636c 6965 6e74 2061 7070 6c69 6361 7469 client applicati │ │ │ +00204f80: 6f6e 2061 626f 7574 2070 726f 6772 6573 on about progres │ │ │ +00204f90: 7320 6166 7465 7220 6576 6572 7920 3130 s after every 10 │ │ │ +00204fa0: 3030 3020 7265 636f 7264 732e 0a20 2020 000 records.. │ │ │ +00204fb0: 2069 6620 286d 6f64 2846 7261 6773 2c31 if (mod(Frags,1 │ │ │ +00204fc0: 3030 3030 2920 3d20 3029 0a20 2020 207b 0000) = 0). { │ │ │ +00204fd0: 0a20 2020 2020 202d 2d20 4e6f 7465 2074 . -- Note t │ │ │ +00204fe0: 6861 7420 6966 2069 7420 6e65 6564 7320 hat if it needs │ │ │ +00204ff0: 746f 2065 7374 696d 6174 6520 7468 6520 to estimate the │ │ │ +00205000: 7469 6d65 2074 6f20 636f 6d70 6c65 7469 time to completi │ │ │ +00205010: 6f6e 2c20 7469 6d65 2073 686f 756c 6420 on, time should │ │ │ +00205020: 6265 206d 6561 7375 7265 640a 2020 2020 be measured. │ │ │ +00205030: 2020 2d2d 206f 6e20 7365 7276 6572 2073 -- on server s │ │ │ +00205040: 6964 652c 2062 6563 6175 7365 2072 6573 ide, because res │ │ │ +00205050: 756c 7473 206d 6179 2062 6520 7265 7475 ults may be retu │ │ │ +00205060: 726e 6564 206f 6e20 6261 7463 6865 7320 rned on batches │ │ │ +00205070: 746f 2072 6564 7563 6520 6e65 7477 6f72 to reduce networ │ │ │ +00205080: 6b0a 2020 2020 2020 2d2d 2074 7261 6666 k. -- traff │ │ │ +00205090: 6963 2c20 616e 6420 6974 206d 6179 2062 ic, and it may b │ │ │ +002050a0: 6520 6120 7369 676e 6966 6963 616e 7420 e a significant │ │ │ +002050b0: 6465 6c61 7920 6265 7477 6565 6e20 6361 delay between ca │ │ │ +002050c0: 6c6c 206f 6620 7265 7375 6c74 2066 756e ll of result fun │ │ │ +002050d0: 6374 696f 6e20 6f6e 0a20 2020 2020 202d ction on. - │ │ │ +002050e0: 2d20 7365 7276 6572 2061 6e64 2066 6574 - server and fet │ │ │ +002050f0: 6368 206f 6e20 636c 6965 6e74 2073 6964 ch on client sid │ │ │ +00205100: 652e 0a20 2020 2020 2043 7572 5469 6d65 e.. CurTime │ │ │ +00205110: 203a 3d20 6361 7374 286e 6f77 2829 2061 := cast(now() a │ │ │ +00205120: 7320 7661 7263 6861 7229 3b0a 2020 2020 s varchar);. │ │ │ +00205130: 2020 506f 7320 3a3d 2078 7065 725f 7465 Pos := xper_te │ │ │ +00205140: 6c6c 285f 6672 6167 293b 0a20 2020 2020 ll(_frag);. │ │ │ +00205150: 2072 6573 756c 7420 2843 7572 5469 6d65 result (CurTime │ │ │ +00205160: 2c20 4672 6167 732c 2049 6e73 6572 7473 , Frags, Inserts │ │ │ +00205170: 2c20 506f 732c 204c 656e 6774 6829 3b0a , Pos, Length);. │ │ │ +00205180: 2020 2020 7d0a 2020 2020 5f74 6167 203a }. _tag : │ │ │ +00205190: 3d20 7870 6174 685f 6576 616c 2827 6c6f = xpath_eval('lo │ │ │ +002051a0: 6361 6c2d 6e61 6d65 2829 272c 205f 6672 cal-name()', _fr │ │ │ +002051b0: 6167 293b 0a20 2020 2069 6620 285f 7461 ag);. if (_ta │ │ │ +002051c0: 6720 3d20 2754 6f70 6963 2729 0a20 2020 g = 'Topic'). │ │ │ +002051d0: 207b 0a20 2020 2020 2069 6d70 6f72 745f {. import_ │ │ │ +002051e0: 746f 7069 6328 5f66 7261 6729 3b0a 2020 topic(_frag);. │ │ │ +002051f0: 2020 2020 676f 746f 2061 6476 616e 6365 goto advance │ │ │ +00205200: 3b0a 2020 2020 7d0a 2020 2020 6966 2028 ;. }. if ( │ │ │ +00205210: 5f74 6167 203d 2027 4578 7465 726e 616c _tag = 'External │ │ │ +00205220: 5061 6765 2729 0a20 2020 207b 0a20 2020 Page'). {. │ │ │ +00205230: 2020 2069 6d70 6f72 745f 6578 7465 726e import_extern │ │ │ +00205240: 616c 285f 6672 6167 293b 0a20 2020 2020 al(_frag);. │ │ │ +00205250: 2067 6f74 6f20 6164 7661 6e63 653b 0a20 goto advance;. │ │ │ +00205260: 2020 207d 0a20 2020 206c 6f67 5f69 6d70 }. log_imp │ │ │ +00205270: 6f72 745f 6572 726f 7220 285f 6672 6167 ort_error (_frag │ │ │ +00205280: 2c20 2671 756f 743b 556e 6b6e 6f77 6e20 , "Unknown │ │ │ +00205290: 7479 7065 206f 6620 7265 636f 7264 2671 type of record&q │ │ │ +002052a0: 756f 743b 293b 0a20 2020 2067 6f74 6f20 uot;);. goto │ │ │ +002052b0: 6e6f 636f 6d6d 6974 5f61 6476 616e 6365 nocommit_advance │ │ │ +002052c0: 3b0a 0a20 2020 2061 6476 616e 6365 3a0a ;.. advance:. │ │ │ +002052d0: 2020 2020 496e 7365 7274 7320 3a3d 2049 Inserts := I │ │ │ +002052e0: 6e73 6572 7473 202b 2031 3b0a 2020 2020 nserts + 1;. │ │ │ +002052f0: 2d2d 204e 6f74 6520 7468 6174 2069 7420 -- Note that it │ │ │ +00205300: 6d61 7920 6265 2066 6173 7465 7220 746f may be faster to │ │ │ +00205310: 2068 6176 6520 3120 636f 6d6d 6974 2070 have 1 commit p │ │ │ +00205320: 6572 2031 3030 206f 7220 3130 3030 2072 er 100 or 1000 r │ │ │ +00205330: 6563 6f72 6473 2069 6e20 736f 6d65 2063 ecords in some c │ │ │ +00205340: 6173 6573 2e0a 0a20 2020 2063 6f6d 6d69 ases... commi │ │ │ +00205350: 7420 776f 726b 3b0a 0a20 2020 206e 6f63 t work;.. noc │ │ │ +00205360: 6f6d 6d69 745f 6164 7661 6e63 653a 0a20 ommit_advance:. │ │ │ +00205370: 2020 2046 7261 6773 203a 3d20 4672 6167 Frags := Frag │ │ │ +00205380: 7320 2b20 313b 0a0a 2020 2020 5f66 7261 s + 1;.. _fra │ │ │ +00205390: 6720 3a3d 2078 7065 725f 7269 6768 745f g := xper_right_ │ │ │ +002053a0: 7369 626c 696e 6728 5f66 7261 6729 3b0a sibling(_frag);. │ │ │ +002053b0: 2020 2020 6966 2028 6973 656e 7469 7479 if (isentity │ │ │ +002053c0: 285f 6672 6167 2929 2067 6f74 6f20 6e65 (_frag)) goto ne │ │ │ +002053d0: 7874 5f66 7261 673b 202d 2d20 4966 205f xt_frag; -- If _ │ │ │ +002053e0: 6672 6167 2069 7320 4e55 4c4c 2c20 7765 frag is NULL, we │ │ │ +002053f0: 2776 6520 636f 6d70 6c65 7465 6420 7468 've completed th │ │ │ +00205400: 6520 696d 706f 7274 2e0a 0a20 2020 2043 e import... C │ │ │ +00205410: 7572 5469 6d65 203a 3d20 6361 7374 286e urTime := cast(n │ │ │ +00205420: 6f77 2829 2061 7320 7661 7263 6861 7229 ow() as varchar) │ │ │ +00205430: 3b0a 2020 2020 7265 7375 6c74 2028 4375 ;. result (Cu │ │ │ +00205440: 7254 696d 652c 2046 7261 6773 2c20 496e rTime, Frags, In │ │ │ +00205450: 7365 7274 732c 204c 656e 6774 682c 204c serts, Length, L │ │ │ +00205460: 656e 6774 6829 3b0a 2020 7d3b 0a0a 2020 ength);. };.. │ │ │ +00205470: 6368 6563 6b70 6f69 6e74 5f69 6e74 6572 checkpoint_inter │ │ │ +00205480: 7661 6c28 3029 3b0a 2020 6368 6563 6b70 val(0);. checkp │ │ │ +00205490: 6f69 6e74 3b0a 0a20 2072 6561 645f 736f oint;.. read_so │ │ │ +002054a0: 7572 6365 5f78 6d6c 7328 293b 0a20 2063 urce_xmls();. c │ │ │ +002054b0: 6865 636b 706f 696e 743b 0a0a 2020 696d heckpoint;.. im │ │ │ +002054c0: 706f 7274 5f63 6f6e 7465 6e74 5f78 6d6c port_content_xml │ │ │ +002054d0: 2829 3b0a 2020 6368 6563 6b70 6f69 6e74 ();. checkpoint │ │ │ +002054e0: 3b0a 0a20 2069 6d70 6f72 745f 7374 7275 ;.. import_stru │ │ │ +002054f0: 6374 7572 655f 786d 6c28 293b 0a20 2063 cture_xml();. c │ │ │ +00205500: 6865 636b 706f 696e 743b 0a0a 2020 696d heckpoint;.. im │ │ │ +00205510: 706f 7274 5f70 726f 6669 6c65 735f 786d port_profiles_xm │ │ │ +00205520: 6c28 293b 0a20 2063 6865 636b 706f 696e l();. checkpoin │ │ │ +00205530: 743b 0a20 202e 2e2e 0a0a 2020 6368 6563 t;. ..... chec │ │ │ +00205540: 6b70 6f69 6e74 5f69 6e74 6572 7661 6c28 kpoint_interval( │ │ │ +00205550: 3630 293b 0a20 203c 2f70 726f 6772 616d 60);. . . < │ │ │ +00205590: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ +002055a0: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . xp │ │ │ +002055c0: 6572 5f65 6e74 6974 793c 2f74 6974 6c65 er_entity. Pe │ │ │ +002055e0: 7273 6973 7465 6e74 2058 4d4c 2065 6e74 rsistent XML ent │ │ │ +002055f0: 6974 7920 746f 206f 7065 7261 7465 206f ity to operate o │ │ │ +00205600: 6e2e 3c2f 7061 7261 3e3c 2f72 6566 7365 n.. . See Also. xper_d │ │ │ +00205680: 6f63 2829 3c2f 6c69 6e6b 3e3c 2f70 6172 oc().

  • xper_cu │ │ │ +002056c0: 7428 293c 2f6c 696e 6b3e 3c2f 7061 7261 t(). . │ │ │ +002056e0: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 ..... │ │ │ +002056f0: 2b64 656d 6f2f 646f 6373 7263 2f66 756e +demo/docsrc/fun │ │ │ +00205700: 6372 6566 2f73 696e 765f 6372 6561 7465 cref/sinv_create │ │ │ +00205710: 5f69 6e76 6572 7365 2e78 6d6c df00 000b _inverse.xml.... │ │ │ +00205720: f13c 3f78 6d6c 2076 6572 7369 6f6e 3d22 .... │ │ │ +00205ae0: 0a20 2020 203c 7265 6665 6e74 7279 7469 . sinv_create_ │ │ │ +00205b00: 696e 7665 7273 653c 2f72 6566 656e 7472 inverse. sql. . . sinv_create_ │ │ │ +00205b70: 696e 7665 7273 653c 2f72 6566 6e61 6d65 inverse. Creates invers │ │ │ +00205ba0: 6520 6d61 7070 696e 6720 666f 7220 7468 e mapping for th │ │ │ +00205bb0: 6520 6d65 6e74 696f 6e65 6420 6675 6e63 e mentioned func │ │ │ +00205bc0: 7469 6f6e 732e 3c2f 7265 6670 7572 706f tions.. . . . . │ │ │ +00205c60: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ +00205c70: 6675 6e63 7469 6f6e 3e73 696e 765f 6372 function>sinv_cr │ │ │ +00205c80: 6561 7465 5f69 6e76 6572 7365 3c2f 6675 eate_inverse..in │ │ │ +00205cb0: 3c70 6172 616d 6574 6572 3e5f 5349 4e56 _SINV │ │ │ +00205cc0: 4d5f 4e41 4d45 5f49 4e3c 2f70 6172 616d M_NAME_IN varchar

    ..in _SINV_INVERSE< │ │ │ +00205d10: 2f70 6172 616d 6574 6572 3e20 616e 793c /parameter> any< │ │ │ +00205d20: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..in _SINVM_FLAGS │ │ │ +00205d50: 3c2f 7061 7261 6d65 7465 723e 2069 6e74
    int │ │ │ +00205d60: 6567 6572 3c2f 7061 7261 6d64 6566 3e0a eger
    . │ │ │ +00205d70: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ +00205db0: 203c 7265 6673 6563 7431 2069 643d 2264 │ │ │ +00205de0: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ +00205df0: 6c65 3e0a 2020 2020 3c70 6172 613e 4372 le>. <para>Cr │ │ │ +00205e00: 6561 7465 7320 696e 7665 7273 6520 6d61 eates inverse ma │ │ │ +00205e10: 7070 696e 6720 666f 7220 7468 6520 6d65 pping for the me │ │ │ +00205e20: 6e74 696f 6e65 6420 6675 6e63 7469 6f6e ntioned function │ │ │ +00205e30: 7320 2861 7320 6465 7363 7269 6265 6420 s (as described │ │ │ +00205e40: 696e 2074 6865 2064 6f63 2073 6563 7469 in the doc secti │ │ │ +00205e50: 6f6e 0a3c 6c69 6e6b 206c 696e 6b65 6e64 on.<link linkend │ │ │ +00205e60: 3d22 7371 6c69 6e76 6572 7365 223e 5351 ="sqlinverse">SQ │ │ │ +00205e70: 4c20 496e 7665 7273 6520 4675 6e63 7469 L Inverse Functi │ │ │ +00205e80: 6f6e 733c 2f6c 696e 6b3e 293c 2f70 6172 ons</link>)</par │ │ │ +00205e90: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +00205ea0: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +00205eb0: 2270 6172 616d 735f 7369 6e76 5f63 7265 "params_sinv_cre │ │ │ +00205ec0: 6174 655f 696e 7665 7273 6522 3e0a 2020 ate_inverse">. │ │ │ +00205ed0: 2020 3c74 6974 6c65 3e50 6172 616d 6574 <title>Paramet │ │ │ +00205ee0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +00205ef0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 _SINVM_NAME_IN< │ │ │ +00205f10: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +00205f20: 6172 613e 7468 6520 6e61 6d65 206f 6620 ara>the name of │ │ │ +00205f30: 7468 6520 666f 7277 6172 6420 6675 6e63 the forward func │ │ │ +00205f40: 7469 6f6e 3c2f 7061 7261 3e3c 2f72 6566 tion</para></ref │ │ │ +00205f50: 7365 6374 323e 0a20 2020 203c 7265 6673 sect2>. <refs │ │ │ +00205f60: 6563 7432 3e3c 7469 746c 653e 5f53 494e ect2><title>_SIN │ │ │ +00205f70: 565f 494e 5645 5253 453c 2f74 6974 6c65 V_INVERSE. an │ │ │ +00205f90: 2061 7272 6179 206f 6620 7468 6520 6e61 array of the na │ │ │ +00205fa0: 6d65 7320 6f66 2074 6865 2069 6e76 6572 mes of the inver │ │ │ +00205fb0: 7365 2066 756e 6374 696f 6e73 2028 666f se functions (fo │ │ │ +00205fc0: 7220 6561 6368 2070 6172 7429 2e3c 2f70 r each part).

    . │ │ │ +00205fe0: 2020 2020 3c72 6566 7365 6374 323e 3c74 _SINVM_FLAG │ │ │ +00206000: 533c 2f74 6974 6c65 3e0a 2020 2020 2020 S. │ │ │ +00206010: 3c70 6172 613e 6269 7420 6d61 736b 2077 bit mask w │ │ │ +00206020: 6974 683a 3c2f 7061 7261 3e0a 2020 2020 ith:. │ │ │ +00206030: 2020 3c70 6172 613e 3c21 5b43 4441 5441 y <-> f(x) │ │ │ +00206060: 3e20 6620 2879 2929 2020 5468 6973 2069 > f (y)) This i │ │ │ +00206070: 7320 7472 7565 206f 6620 756e 6974 2063 s true of unit c │ │ │ +00206080: 6f6e 7665 7273 696f 6e73 2069 6e0a 2020 onversions in. │ │ │ +00206090: 2020 2020 6765 6e65 7261 6c20 6275 7420 general but │ │ │ +002060a0: 6e6f 7420 7472 7565 206f 6620 6861 7368 not true of hash │ │ │ +002060b0: 2066 756e 6374 696f 6e73 206f 7220 6172 functions or ar │ │ │ +002060c0: 6269 7472 6172 7920 6964 206d 6170 7069 bitrary id mappi │ │ │ +002060d0: 6e67 732e 2020 4966 2074 6865 2062 6974 ngs. If the bit │ │ │ +002060e0: 0a20 2020 2020 2069 7320 7365 7420 7468 . is set th │ │ │ +002060f0: 6520 6675 6e63 7469 6f6e 2063 616c 6c20 e function call │ │ │ +00206100: 6d61 7920 6265 206f 7074 696d 697a 6564 may be optimized │ │ │ +00206110: 2061 7761 7920 6966 2062 6f74 6820 6f70 away if both op │ │ │ +00206120: 6572 616e 6473 206f 6620 610a 2020 2020 erands of a. │ │ │ +00206130: 2020 636f 6d70 6172 6973 6f6e 2061 7265 comparison are │ │ │ +00206140: 2063 616c 6c73 2074 6f20 7468 6973 2066 calls to this f │ │ │ +00206150: 756e 6374 696f 6e2e 2020 4966 2074 6869 unction. If thi │ │ │ +00206160: 7320 6973 206e 6f74 2020 7365 742c 2074 s is not set, t │ │ │ +00206170: 6865 2066 756e 6374 696f 6e0a 2020 2020 he function. │ │ │ +00206180: 2020 6361 6c6c 7320 6d61 7920 6f6e 6c79 calls may only │ │ │ +00206190: 2062 6520 7265 6d6f 7665 6420 696e 2074 be removed in t │ │ │ +002061a0: 6865 2063 6173 6520 6f66 2065 7175 616c he case of equal │ │ │ +002061b0: 6974 792e 5d5d 3e3c 2f70 6172 613e 0a20 ity.]]>. │ │ │ +002061c0: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +002061d0: 203c 2f72 6566 7365 6374 313e 0a20 203c
    . < │ │ │ +002061e0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ +002061f0: 616c 736f 5f73 696e 765f 6372 6561 7465 also_sinv_create │ │ │ +00206200: 5f69 6e76 6572 7365 223e 3c74 6974 6c65 _inverse">See Also. . │ │ │ +00206230: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 sinv_cre │ │ │ +00206270: 6174 655f 6b65 795f 6d61 7070 696e 673c ate_key_mapping< │ │ │ +00206280: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. sinv_dro │ │ │ +002062d0: 705f 696e 7665 7273 653c 2f66 756e 6374 p_inverse. │ │ │ +002062f0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . ......+demo/docs │ │ │ +00206320: 7263 2f66 756e 6372 6566 2f63 6f6e 6e65 rc/funcref/conne │ │ │ +00206330: 6374 696f 6e5f 7661 7273 5f73 6574 2e78 ction_vars_set.x │ │ │ +00206340: 6d6c df00 000e b63c 3f78 6d6c 2076 6572 ml........ . connec │ │ │ +00206720: 7469 6f6e 5f76 6172 735f 7365 743c 2f72 tion_vars_set. │ │ │ +00206740: 2020 3c72 6566 6d69 7363 696e 666f 3e77 w │ │ │ +00206750: 733c 2f72 6566 6d69 7363 696e 666f 3e0a s. │ │ │ +00206760: 2020 3c2f 7265 666d 6574 613e 0a20 203c . < │ │ │ +00206770: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ +00206780: 3c72 6566 6e61 6d65 3e63 6f6e 6e65 6374 connect │ │ │ +00206790: 696f 6e5f 7661 7273 5f73 6574 3c2f 7265 ion_vars_set. set all c │ │ │ +002067c0: 6f6e 6e65 6374 696f 6e20 7661 7269 6162 onnection variab │ │ │ +002067d0: 6c65 733c 2f72 6566 7075 7270 6f73 653e les │ │ │ +002067e0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ +002067f0: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . │ │ │ +00206870: 2020 203c 6675 6e63 6465 663e 3c66 756e connection │ │ │ +00206890: 5f76 6172 735f 7365 743c 2f66 756e 6374 _vars_set.. │ │ │ +002068b0: 3c70 6172 616d 6465 663e 696e 203c 7061 in var_arra │ │ │ +002068d0: 793c 2f70 6172 616d 6574 6572 3e20 616e y an │ │ │ +002068e0: 793c 2f70 6172 616d 6465 663e 0a20 2020 y. │ │ │ +002068f0: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . Des │ │ │ +00206960: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +00206970: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ +00206980: 6675 6e63 7469 6f6e 2063 6c65 6172 7320 function clears │ │ │ +00206990: 616c 6c20 636f 6e6e 6563 7469 6f6e 2076 all connection v │ │ │ +002069a0: 6172 6961 626c 6573 2066 6f72 2063 7572 ariables for cur │ │ │ +002069b0: 7265 6e74 0a20 2020 2073 6573 7369 6f6e rent. session │ │ │ +002069c0: 2061 6e64 2073 6574 7320 6e65 7720 6f6e and sets new on │ │ │ +002069d0: 6573 2064 6566 696e 6564 2069 6e20 7468 es defined in th │ │ │ +002069e0: 6520 6172 7261 7920 7061 7373 6564 2061 e array passed a │ │ │ +002069f0: 7320 7061 7261 6d65 7465 722e 0a20 2020 s parameter.. │ │ │ +00206a00: 203c 2f70 6172 613e 0a20 2020 203c 7061 . Connection va │ │ │ +00206a20: 7269 6162 6c65 7320 646f 206e 6f74 2070 riables do not p │ │ │ +00206a30: 6572 7369 7374 2061 6372 6f73 7320 7365 ersist across se │ │ │ +00206a40: 7373 696f 6e73 2c20 6f6e 650a 2020 2020 ssions, one. │ │ │ +00206a50: 6d61 7920 6d61 696e 7461 696e 2070 6572 may maintain per │ │ │ +00206a60: 7369 7374 656e 6365 206f 6620 7661 7269 sistence of vari │ │ │ +00206a70: 6162 6c65 7320 6279 2073 746f 7269 6e67 ables by storing │ │ │ +00206a80: 2074 6865 6d20 696e 2061 2064 6174 6162 them in a datab │ │ │ +00206a90: 6173 650a 2020 2020 7461 626c 652c 2061 ase. table, a │ │ │ +00206aa0: 7320 6469 7363 7573 7365 6420 696e 203c s discussed in < │ │ │ +00206ab0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 7773 link linkend="ws │ │ │ +00206ac0: 7365 7373 6d61 6e22 3e53 6573 7369 6f6e sessman">Session │ │ │ +00206ad0: 2056 6172 6961 626c 6573 3c2f 6c69 6e6b Variables. -section.< │ │ │ +00206af0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . Paramete │ │ │ +00206b40: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ +00206b50: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ +00206b60: 7661 725f 6172 7261 793c 2f74 6974 6c65 var_array. An │ │ │ +00206b80: 203c 7479 7065 3e61 7272 6179 3c2f 7479 array of even numb │ │ │ +00206ba0: 6572 206f 6620 656c 656d 656e 7473 2c20 er of elements, │ │ │ +00206bb0: 636f 6e74 6169 6e69 6e67 0a20 2020 2020 containing. │ │ │ +00206bc0: 206e 616d 652d 7661 6c75 6520 7061 6972 name-value pair │ │ │ +00206bd0: 732e 204e 554c 4c2c 2077 696c 6c20 6361 s. NULL, will ca │ │ │ +00206be0: 7573 6520 616c 6c20 636f 6e6e 6563 7469 use all connecti │ │ │ +00206bf0: 6f6e 2076 6172 6961 626c 6573 2066 6f72 on variables for │ │ │ +00206c00: 2063 7572 7265 6e74 0a20 2020 2020 2063 current. c │ │ │ +00206c10: 6f6e 6e65 6374 696f 6e20 746f 2062 6520 onnection to be │ │ │ +00206c20: 6572 6173 6564 2e3c 2f70 6172 613e 0a20 erased.. │ │ │ +00206c30: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +00206c40: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +00206c50: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ +00206c60: 6d70 6c65 735f 636f 6e6e 6563 7469 6f6e mples_connection │ │ │ +00206c70: 5f76 6172 735f 7365 7422 3e3c 7469 746c _vars_set">Examples. Usage │ │ │ +00206cd0: 0a20 2020 2020 203c 7363 7265 656e 3e0a . . │ │ │ +00206ce0: 2020 266c 743b 3f76 7370 0a20 2020 2063 <?vsp. c │ │ │ +00206cf0: 6f6e 6e65 6374 696f 6e5f 7661 7273 5f73 onnection_vars_s │ │ │ +00206d00: 6574 2028 7665 6374 6f72 2028 2749 4427 et (vector ('ID' │ │ │ +00206d10: 2c20 3132 2929 3b0a 2020 3f26 6774 3b0a , 12));. ?>. │ │ │ +00206d20: 3c2f 7363 7265 656e 3e0a 2020 2020 3c2f . . Settin │ │ │ +00206d70: 6720 616e 6420 5265 7472 6965 7669 6e67 g and Retrieving │ │ │ +00206d80: 2043 6f6e 6e65 6374 696f 6e20 5661 7269 Connection Vari │ │ │ +00206d90: 6162 6c65 733c 2f74 6974 6c65 3e0a 3c73 ables..SQL>conne │ │ │ +00206db0: 6374 696f 6e5f 7661 7273 5f73 6574 2876 ction_vars_set(v │ │ │ +00206dc0: 6563 746f 7228 2776 3127 2c20 2761 272c ector('v1', 'a', │ │ │ +00206dd0: 2027 7632 272c 2031 2929 3b0a 0a44 6f6e 'v2', 1));..Don │ │ │ +00206de0: 652e 202d 2d20 3020 6d73 6563 2e0a 5351 e. -- 0 msec..SQ │ │ │ +00206df0: 4c3e 2073 656c 6563 7420 636f 6e6e 6563 L> select connec │ │ │ +00206e00: 7469 6f6e 5f76 6172 7328 293b 0a63 616c tion_vars();.cal │ │ │ +00206e10: 6c72 6574 0a56 4152 4348 4152 0a5f 5f5f lret.VARCHAR.___ │ │ │ +00206e20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00206e30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00206e40: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00206e50: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00206e60: 5f5f 5f5f 5f5f 5f5f 0a0a 7665 6374 6f72 ________..vector │ │ │ +00206e70: 2830 7830 3034 6534 3139 632c 3078 3030 (0x004e419c,0x00 │ │ │ +00206e80: 3465 3430 6334 2c30 7830 3034 6465 6339 4e40c4,0x004dec9 │ │ │ +00206e90: 632c 3129 0a0a 3120 526f 7773 2e20 2d2d c,1)..1 Rows. -- │ │ │ +00206ea0: 2037 3020 6d73 6563 2e0a 5351 4c3e 7365 70 msec..SQL>se │ │ │ +00206eb0: 6c65 6374 2061 7265 6628 636f 6e6e 6563 lect aref(connec │ │ │ +00206ec0: 7469 6f6e 5f76 6172 7328 292c 3029 2c0a tion_vars(),0),. │ │ │ +00206ed0: 2020 2020 2020 6172 6566 2863 6f6e 6e65 aref(conne │ │ │ +00206ee0: 6374 696f 6e5f 7661 7273 2829 2c20 3129 ction_vars(), 1) │ │ │ +00206ef0: 2c0a 2020 2020 2020 6172 6566 2863 6f6e ,. aref(con │ │ │ +00206f00: 6e65 6374 696f 6e5f 7661 7273 2829 2c20 nection_vars(), │ │ │ +00206f10: 3229 2c0a 2020 2020 2020 6172 6566 2863 2),. aref(c │ │ │ +00206f20: 6f6e 6e65 6374 696f 6e5f 7661 7273 2829 onnection_vars() │ │ │ +00206f30: 2c20 3329 3b0a 0a63 616c 6c72 6574 2020 , 3);..callret │ │ │ +00206f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00206f50: 2063 616c 6c72 6574 2020 2020 2020 2020 callret │ │ │ +00206f60: 2020 2020 2020 2020 2020 2063 616c 6c72 callr │ │ │ +00206f70: 6574 2020 2020 2020 2020 2020 2020 2020 et │ │ │ +00206f80: 2020 2020 2063 616c 6c72 6574 0a56 4152 callret.VAR │ │ │ +00206f90: 4348 4152 2020 2020 2020 2020 2020 2020 CHAR │ │ │ +00206fa0: 2020 2020 2020 2056 4152 4348 4152 2020 VARCHAR │ │ │ +00206fb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00206fc0: 2056 4152 4348 4152 2020 2020 2020 2020 VARCHAR │ │ │ +00206fd0: 2020 2020 2020 2020 2020 2056 4152 4348 VARCH │ │ │ +00206fe0: 4152 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f AR._____________ │ │ │ +00206ff0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00207000: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00207010: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00207020: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00207030: 5f5f 0a0a 7631 2020 2020 2020 2020 2020 __..v1 │ │ │ +00207040: 2020 2020 2020 2020 2020 2020 2020 6120 a │ │ │ +00207050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00207060: 2020 2020 2020 2020 7632 2020 2020 2020 v2 │ │ │ +00207070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00207080: 2020 310a 0a31 2052 6f77 732e 202d 2d20 1..1 Rows. -- │ │ │ +00207090: 3830 206d 7365 632e 0a3c 2f73 6372 6565 80 msec... . . │ │ │ +002070c0: 2020 3c72 6566 7365 6374 3120 6964 3d22 See Also. < │ │ │ +00207110: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00207120: 5f63 6f6e 6e65 6374 696f 6e5f 6765 7422 _connection_get" │ │ │ +00207130: 3e63 6f6e 6e65 6374 696f 6e5f 6765 743c >connection_get< │ │ │ +00207140: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00207150: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 connec │ │ │ +00207180: 7469 6f6e 5f73 6574 3c2f 6c69 6e6b 3e3c tion_set< │ │ │ +00207190: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. connection_v │ │ │ +002071d0: 6172 733c 2f6c 696e 6b3e 3c2f 7061 7261 ars. . │ │ │ +002071f0: 3c2f 7265 6665 6e74 7279 3e0a 0ab6 0000 ..... │ │ │ +00207200: 0023 6465 6d6f 2f64 6f63 7372 632f 6675 .#demo/docsrc/fu │ │ │ +00207210: 6e63 7265 662f 7265 706c 5f72 6576 6f6b ncref/repl_revok │ │ │ +00207220: 652e 786d 6cdf 0000 13f9 3c3f 786d 6c20 e.xml........ . REPL_REVOKE │ │ │ +00207600: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ +00207610: 0a20 2020 203c 7265 666d 6973 6369 6e66 . repl. . │ │ │ +00207650: 0a20 2020 203c 7265 666e 616d 653e 5245 . RE │ │ │ +00207660: 504c 5f52 4556 4f4b 453c 2f72 6566 6e61 PL_REVOKE
    . revoke privi │ │ │ +00207690: 6c65 6765 7320 666f 7220 7375 6273 6372 leges for subscr │ │ │ +002076a0: 6970 7469 6f6e 3c2f 7265 6670 7572 706f iption. . . . │ │ │ +00207700: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +00207730: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ +00207740: 6675 6e63 7469 6f6e 3e52 4550 4c5f 5245 function>REPL_RE │ │ │ +00207750: 564f 4b45 3c2f 6675 6e63 7469 6f6e 3e3c VOKE< │ │ │ +00207760: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ +00207770: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ +00207780: 7061 7261 6d65 7465 723e 7075 626c 6963 parameter>public │ │ │ +00207790: 6174 696f 6e3c 2f70 6172 616d 6574 6572 ation varchar. in grantee varchar │ │ │ +002077f0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +00207800: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . Description< │ │ │ +00207870: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. Revokes Privil │ │ │ +00207890: 6567 6573 2066 6f72 2053 7562 7363 7269 eges for Subscri │ │ │ +002078a0: 7074 696f 6e2e 2020 5468 6973 2069 7320 ption. This is │ │ │ +002078b0: 6361 6c6c 6564 206f 6e20 7468 6520 7075 called on the pu │ │ │ +002078c0: 626c 6973 6865 7220 746f 200a 0972 6576 blisher to ..rev │ │ │ +002078d0: 6f6b 6520 6163 6365 7373 2074 6f20 7468 oke access to th │ │ │ +002078e0: 6520 7075 626c 6963 6174 696f 6e20 6672 e publication fr │ │ │ +002078f0: 6f6d 2074 6865 2075 7365 7220 6163 636f om the user acco │ │ │ +00207900: 756e 7420 6f6e 2074 6865 2070 7562 6c69 unt on the publi │ │ │ +00207910: 7368 6572 2e20 200a 0954 6865 2073 7562 sher. ..The sub │ │ │ +00207920: 7363 7269 6265 7220 7769 6c6c 206e 6f20 scriber will no │ │ │ +00207930: 6c6f 6e67 6572 2067 6169 6e20 6163 6365 longer gain acce │ │ │ +00207940: 7373 2074 6f20 7468 6520 7075 626c 6963 ss to the public │ │ │ +00207950: 6174 696f 6e20 7769 7468 2074 6869 7320 ation with this │ │ │ +00207960: 6163 636f 756e 742e 3c2f 7061 7261 3e0a account.. │ │ │ +00207970: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +00207980: 3c72 6566 7365 6374 3120 6964 3d22 7061 Paramet │ │ │ +002079b0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +002079c0: 3c72 6566 7365 6374 323e 0a20 2020 2020 . │ │ │ +002079d0: 203c 7469 746c 653e 7075 626c 6963 6174 publicat │ │ │ +002079e0: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ +002079f0: 2020 3c70 6172 613e 5468 6520 7075 626c The publ │ │ │ +00207a00: 6963 6174 696f 6e20 6e61 6d65 2e3c 2f70 ication name.

    . . . grantee │ │ │ +00207a50: 0a20 2020 2020 203c 7061 7261 3e41 2076 . A v │ │ │ +00207a60: 616c 6964 2044 4220 6163 636f 756e 7420 alid DB account │ │ │ +00207a70: 6e61 6d65 2074 6f20 6265 2072 6566 7573 name to be refus │ │ │ +00207a80: 6564 2073 7562 7363 7269 7074 696f 6e20 ed subscription │ │ │ +00207a90: 7269 6768 7473 2e3c 2f70 6172 613e 0a20 rights.. │ │ │ +00207aa0: 2020 2020 203c 6e6f 7465 3e3c 7469 746c Note:. │ │ │ +00207ac0: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ +00207ad0: 4442 4120 6163 636f 756e 7420 6973 2067 DBA account is g │ │ │ +00207ae0: 7261 6e74 6564 2073 7562 7363 7269 7074 ranted subscript │ │ │ +00207af0: 696f 6e20 7269 6768 7473 2062 7920 6465 ion rights by de │ │ │ +00207b00: 6661 756c 742c 0a20 2020 2020 2077 6869 fault,. whi │ │ │ +00207b10: 6368 2063 616e 6e6f 7420 6265 2072 6576 ch cannot be rev │ │ │ +00207b20: 6f6b 6564 2e3c 2f70 6172 613e 0a20 2020 oked.. │ │ │ +00207b30: 2020 203c 2f6e 6f74 653e 0a20 2020 203c . < │ │ │ +00207b40: 2f72 6566 7365 6374 323e 0a3c 2f72 6566 /refsect2>... │ │ │ +00207c50: 3c72 6566 7365 6374 3120 6964 3d22 6578 Examp │ │ │ +00207c80: 6c65 3c2f 7469 746c 653e 0a20 2020 203c le. < │ │ │ +00207c90: 6578 616d 706c 6520 6964 3d22 6578 5f72 example id="ex_r │ │ │ +00207ca0: 6570 6c5f 7265 766f 6b65 5f31 223e 3c74 epl_revoke_1">Access to ' │ │ │ +00207cc0: 7461 626c 655f 7075 626c 6963 6174 696f table_publicatio │ │ │ +00207cd0: 6e27 2072 656d 6f76 616c 2066 6f72 2053 n' removal for S │ │ │ +00207ce0: 514c 2075 7365 7220 6163 636f 756e 7420 QL user account │ │ │ +00207cf0: 2764 656d 6f27 2e3c 2f74 6974 6c65 3e0a 'demo'.. │ │ │ +00207d00: 2020 2020 203c 7061 7261 3e54 6869 7320 This │ │ │ +00207d10: 6973 2074 6f20 7265 6d6f 7665 2070 6572 is to remove per │ │ │ +00207d20: 6d69 7373 696f 6e73 2074 6f20 7375 6273 missions to subs │ │ │ +00207d30: 6372 6962 6520 6672 6f6d 2053 514c 2075 cribe from SQL u │ │ │ +00207d40: 7365 7220 6163 636f 756e 7420 2764 656d ser account 'dem │ │ │ +00207d50: 6f27 2066 6f72 2074 6162 6c65 5f70 7562 o' for table_pub │ │ │ +00207d60: 6c69 6361 7469 6f6e 2070 7562 6c69 6361 lication publica │ │ │ +00207d70: 7469 6f6e 2061 6363 6f75 6e74 2e3c 2f70 tion account.

    . .SQL> DB.DBA. │ │ │ +00207da0: 5245 504c 5f52 4556 4f4b 4520 2827 7461 REPL_REVOKE ('ta │ │ │ +00207db0: 626c 655f 7075 626c 6963 6174 696f 6e27 ble_publication' │ │ │ +00207dc0: 2c20 2764 656d 6f27 293b 0a20 2020 2020 , 'demo');. │ │ │ +00207dd0: 203c 2f73 6372 6565 6e3e 0a20 2020 203c . < │ │ │ +00207de0: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>.
    .. See Also. sub_s │ │ │ +00207e70: 6368 6564 756c 6528 293c 2f66 756e 6374 chedule(). repl_ │ │ │ +00207ed0: 6469 7363 6f6e 6e65 6374 2829 3c2f 6675 disconnect(). < │ │ │ +00207f20: 6675 6e63 7469 6f6e 3e72 6570 6c5f 6772 function>repl_gr │ │ │ +00207f30: 616e 7428 293c 2f66 756e 6374 696f 6e3e ant() │ │ │ +00207f40: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +00207f50: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 repl_init_ │ │ │ +00207f90: 636f 7079 2829 3c2f 6675 6e63 7469 6f6e copy(). │ │ │ +00207fb0: 2020 2020 203c 7061 7261 3e3c 6c69 6e6b repl_new_lo │ │ │ +00207ff0: 6728 293c 2f66 756e 6374 696f 6e3e 3c2f g(). │ │ │ +00208010: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 repl_pub_add() │ │ │ +00208050: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e . < │ │ │ +00208070: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>repl_pub_i │ │ │ +002080b0: 6e69 745f 696d 6167 6528 293c 2f66 756e nit_image()

    . │ │ │ +002080e0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 rep │ │ │ +00208110: 6c5f 7075 625f 7265 6d6f 7665 2829 3c2f l_pub_remove() │ │ │ +00208130: 3c2f 7061 7261 3e0a 2020 2020 203c 7061 . rep │ │ │ +00208170: 6c5f 7075 626c 6973 6828 293c 2f66 756e l_publish()

    . │ │ │ +002081a0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 rep │ │ │ +002081d0: 6c5f 7363 6865 645f 696e 6974 2829 3c2f l_sched_init() │ │ │ +002081f0: 3c2f 7061 7261 3e0a 2020 2020 203c 7061 . repl │ │ │ +00208230: 5f73 6572 7665 7228 293c 2f66 756e 6374 _server(). re │ │ │ +00208290: 706c 5f73 6572 7665 725f 7265 6e61 6d65 pl_server_rename │ │ │ +002082a0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ +002082c0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e re │ │ │ +002082f0: 706c 5f73 7461 7428 293c 2f66 756e 6374 pl_stat(). repl_stat │ │ │ +00208350: 7573 2829 3c2f 6675 6e63 7469 6f6e 3e3c us()< │ │ │ +00208360: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00208370: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c repl_subscr │ │ │ +002083b0: 6962 6528 293c 2f66 756e 6374 696f 6e3e ibe() │ │ │ +002083c0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +002083d0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 repl_sync(). repl │ │ │ +00208460: 5f73 796e 635f 616c 6c28 293c 2f66 756e _sync_all()

    . │ │ │ +00208490: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 repl_text │ │ │ +002084c0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()
    . │ │ │ +002084e0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e repl_this_s │ │ │ +00208520: 6572 7665 7228 293c 2f66 756e 6374 696f erver() │ │ │ +00208540: 0a20 2020 2020 3c70 6172 613e 3c6c 696e . repl_unp │ │ │ +00208580: 7562 6c69 7368 2829 3c2f 6675 6e63 7469 ublish().
  • repl_ │ │ │ +002085e0: 756e 7375 6273 6372 6962 6528 293c 2f66 unsubscribe()< │ │ │ +00208600: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ +00208620: 0a0a 0ab6 0000 002a 6465 6d6f 2f64 6f63 .......*demo/doc │ │ │ +00208630: 7372 632f 6675 6e63 7265 662f 7370 6f74 src/funcref/spot │ │ │ +00208640: 6c69 6768 745f 6d65 7461 6461 7461 2e78 light_metadata.x │ │ │ +00208650: 6d6c df00 000c 9f3c 3f78 6d6c 2076 6572 ml........ . spotlig │ │ │ +00208a30: 6874 5f6d 6574 6164 6174 613c 2f72 6566 ht_metadata. │ │ │ +00208a50: 3c72 6566 6d69 7363 696e 666f 3e73 7472 str │ │ │ +00208a60: 696e 673c 2f72 6566 6d69 7363 696e 666f ing. . │ │ │ +00208a80: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +00208a90: 2020 3c72 6566 6e61 6d65 3e73 706f 746c spotl │ │ │ +00208aa0: 6967 6874 5f6d 6574 6164 6174 613c 2f72 ight_metadata. collect │ │ │ +00208ad0: 4d41 4320 4f53 2058 2073 706f 746c 6967 MAC OS X spotlig │ │ │ +00208ae0: 6874 206d 6574 6164 6174 613c 2f72 6566 ht metadata. . . │ │ │ +00208b20: 3c66 756e 6373 796e 6f70 7369 7320 6964 . │ │ │ +00208b50: 2020 3c66 756e 6370 726f 746f 7479 7065 │ │ │ +00208b80: 0a20 2020 2020 2020 203c 6675 6e63 6465 . spot │ │ │ +00208ba0: 6c69 6768 745f 6d65 7461 6461 7461 3c2f light_metadata. in path varchar. . │ │ │ +00208c20: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Description< │ │ │ +00208c70: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. This function │ │ │ +00208c90: 7265 7472 6965 7665 7320 6120 6669 6c65 retrieves a file │ │ │ +00208ca0: 2773 206d 6574 6164 6174 6120 7573 696e 's metadata usin │ │ │ +00208cb0: 6720 7468 6520 4170 706c 6520 4d61 6320 g the Apple Mac │ │ │ +00208cc0: 4f53 5820 3130 2e34 2053 706f 746c 6967 OSX 10.4 Spotlig │ │ │ +00208cd0: 6874 2066 6561 7475 7265 2e0a 5468 6520 ht feature..The │ │ │ +00208ce0: 7061 7468 206d 7573 7420 6265 2077 6974 path must be wit │ │ │ +00208cf0: 6869 6e20 7468 6520 7061 7468 7320 616c hin the paths al │ │ │ +00208d00: 6c6f 7765 6420 6279 2074 6865 2044 6972 lowed by the Dir │ │ │ +00208d10: 7341 6c6c 6f77 6564 2069 6e69 2073 6574 sAllowed ini set │ │ │ +00208d20: 7469 6e67 2061 6e64 2074 6865 2063 616c ting and the cal │ │ │ +00208d30: 6c69 6e67 2075 7365 7220 6d75 7374 0a68 ling user must.h │ │ │ +00208d40: 6176 6520 6462 6120 7072 6976 696c 6567 ave dba privileg │ │ │ +00208d50: 6573 2e20 5468 6973 2066 756e 6374 696f es. This functio │ │ │ +00208d60: 6e20 6973 206f 6e6c 7920 6176 6169 6c61 n is only availa │ │ │ +00208d70: 626c 6520 6f6e 2065 7865 6375 7461 626c ble on executabl │ │ │ +00208d80: 6573 2062 7569 6c74 206f 6e20 4d61 6320 es built on Mac │ │ │ +00208d90: 4f53 2073 7973 7465 6d73 2073 7570 706f OS systems suppo │ │ │ +00208da0: 7274 696e 670a 5370 6f74 6c69 6768 742e rting.Spotlight. │ │ │ +00208db0: 0a3c 2f70 6172 613e 0a20 2020 203c 7061 .. spo │ │ │ +00208dd0: 746c 6967 6874 5f6d 6574 6164 6174 613c tlight_metadata< │ │ │ +00208de0: 2f66 756e 6374 696f 6e3e 5468 6520 7265 /function>The re │ │ │ +00208df0: 7475 726e 2076 616c 7565 2069 7320 6120 turn value is a │ │ │ +00208e00: 7665 6374 6f72 206f 6620 6e61 6d65 2d76 vector of name-v │ │ │ +00208e10: 616c 7565 2070 6169 7273 2e20 0a09 2828 alue pairs. ..(( │ │ │ +00208e20: 7072 6f70 6572 7479 206e 616d 652c 2076 property name, v │ │ │ +00208e30: 616c 7565 292c 2028 7072 6f70 6572 7479 alue), (property │ │ │ +00208e40: 206e 616d 652c 2076 616c 7565 292c 202e name, value), . │ │ │ +00208e50: 2e2e 292e 200a 2020 2020 3c2f 7061 7261 ..). . . . │ │ │ +00208e70: 2020 3c72 6566 7365 6374 3120 6964 3d22 P │ │ │ +00208e90: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ +00208eb0: 3c74 6974 6c65 3e70 6174 683c 2f74 6974 path</tit │ │ │ +00208ec0: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +00208ed0: 3c74 7970 653e 7661 7263 6861 723c 2f74 <type>varchar</t │ │ │ +00208ee0: 7970 653e 2072 656c 6174 6976 6520 7061 ype> relative pa │ │ │ +00208ef0: 7468 2e3c 2f70 6172 613e 0a20 2020 203c th.</para>. < │ │ │ +00208f00: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. </r │ │ │ +00208f10: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ +00208f20: 6563 7431 2069 643d 2265 7861 6d70 6c65 ect1 id="example │ │ │ +00208f30: 7322 3e3c 7469 746c 653e 4578 616d 706c s"><title>Exampl │ │ │ +00208f40: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ +00208f50: 6578 616d 706c 6520 6964 3d22 6578 5f73 example id="ex_s │ │ │ +00208f60: 706f 746c 6967 6874 5f6d 6574 6164 6174 potlight_metadat │ │ │ +00208f70: 6122 3e3c 7469 746c 653e 5369 6d70 6c65 a">Simple │ │ │ +00208f80: 2065 7861 6d70 6c65 3c2f 7469 746c 653e example │ │ │ +00208f90: 0a09 3c70 6172 613e 4173 6b20 7370 6f74 ..Ask spot │ │ │ +00208fa0: 6c69 6768 7420 666f 7220 7669 7274 756f light for virtuo │ │ │ +00208fb0: 736f 2e69 6e69 206d 6574 6164 6174 612e so.ini metadata. │ │ │ +00208fc0: 3c2f 7061 7261 3e0a 2020 2020 2020 3c73 . .SQL> sele │ │ │ +00208fe0: 6374 2064 6267 5f6f 626a 5f70 7269 6e74 ct dbg_obj_print │ │ │ +00208ff0: 2028 7370 6f74 6c69 6768 745f 6d65 7461 (spotlight_meta │ │ │ +00209000: 6461 7461 2028 2776 6972 7475 6f73 6f2e data ('virtuoso. │ │ │ +00209010: 696e 6927 2929 3b0a 0a0a 5365 7276 6572 ini'));...Server │ │ │ +00209020: 2063 6f6e 736f 6c65 3a0a 0a28 2822 6b4d console:..(("kM │ │ │ +00209030: 4449 7465 6d46 534f 776e 6572 5573 6572 DItemFSOwnerUser │ │ │ +00209040: 4944 2220 3530 312e 3030 3030 3030 2029 ID" 501.000000 ) │ │ │ +00209050: 2028 226b 4d44 4974 656d 4653 4f77 6e65 ("kMDItemFSOwne │ │ │ +00209060: 7247 726f 7570 4944 2220 3530 312e 3030 rGroupID" 501.00 │ │ │ +00209070: 3030 3030 2029 2028 226b 4d44 4974 656d 0000 ) ("kMDItem │ │ │ +00209080: 4653 5479 7065 436f 6465 2220 302e 3030 FSTypeCode" 0.00 │ │ │ +00209090: 3030 3030 2029 2028 226b 4d44 4974 656d 0000 ) ("kMDItem │ │ │ +002090a0: 4944 2220 3539 3839 3034 342e 3030 3030 ID" 5989044.0000 │ │ │ +002090b0: 3030 2029 2028 226b 4d44 4974 656d 4653 00 ) ("kMDItemFS │ │ │ +002090c0: 5369 7a65 2220 3439 3032 2e30 3030 3030 Size" 4902.00000 │ │ │ +002090d0: 3020 2920 2822 6b4d 4449 7465 6d46 5343 0 ) ("kMDItemFSC │ │ │ +002090e0: 7265 6174 696f 6e44 6174 6522 207b 7473 reationDate" {ts │ │ │ +002090f0: 2032 3030 352d 3036 2d32 3120 3134 3a30 2005-06-21 14:0 │ │ │ +00209100: 303a 3233 2e30 3030 3030 307d 2029 2028 0:23.000000} ) ( │ │ │ +00209110: 226b 4d44 4974 656d 4653 4e61 6d65 2220 "kMDItemFSName" │ │ │ +00209120: 2276 6972 7475 6f73 6f2e 696e 6922 2029 "virtuoso.ini" ) │ │ │ +00209130: 2028 226b 4d44 4974 656d 4653 436f 6e74 ("kMDItemFSCont │ │ │ +00209140: 656e 7443 6861 6e67 6544 6174 6522 207b entChangeDate" { │ │ │ +00209150: 7473 2032 3030 352d 3036 2d32 3720 3037 ts 2005-06-27 07 │ │ │ +00209160: 3a32 363a 3035 2e30 3030 3030 307d 2029 :26:05.000000} ) │ │ │ +00209170: 2028 226b 4d44 4974 656d 4653 4372 6561 ("kMDItemFSCrea │ │ │ +00209180: 746f 7243 6f64 6522 2030 2e30 3030 3030 torCode" 0.00000 │ │ │ +00209190: 3020 2920 2822 6b4d 4449 7465 6d46 534c 0 ) ("kMDItemFSL │ │ │ +002091a0: 6162 656c 2220 302e 3030 3030 3030 2029 abel" 0.000000 ) │ │ │ +002091b0: 2028 226b 4d44 4974 656d 4653 496e 7669 ("kMDItemFSInvi │ │ │ +002091c0: 7369 626c 6522 2030 2029 2028 226b 4d44 sible" 0 ) ("kMD │ │ │ +002091d0: 4974 656d 4653 4e6f 6465 436f 756e 7422 ItemFSNodeCount" │ │ │ +002091e0: 2030 2e30 3030 3030 3020 2920 2822 6b4d 0.000000 ) ("kM │ │ │ +002091f0: 4449 7465 6d41 7474 7269 6275 7465 4368 DItemAttributeCh │ │ │ +00209200: 616e 6765 4461 7465 2220 7b74 7320 3139 angeDate" {ts 19 │ │ │ +00209210: 3730 2d30 312d 3031 2030 363a 3433 3a30 70-01-01 06:43:0 │ │ │ +00209220: 382e 3030 3030 3030 7d20 2920 2822 6b4d 8.000000} ) ("kM │ │ │ +00209230: 4449 7465 6d46 5346 696e 6465 7246 6c61 DItemFSFinderFla │ │ │ +00209240: 6773 2220 302e 3030 3030 3030 2029 2028 gs" 0.000000 ) ( │ │ │ +00209250: 226b 4d44 4974 656d 5573 6564 4461 7465 "kMDItemUsedDate │ │ │ +00209260: 7322 2028 7b74 7320 3230 3035 2d30 362d s" ({ts 2005-06- │ │ │ +00209270: 3237 2030 363a 3236 3a30 352e 3030 3030 27 06:26:05.0000 │ │ │ +00209280: 3030 7d20 2920 2920 2822 6b4d 4449 7465 00} ) ) ("kMDIte │ │ │ +00209290: 6d4c 6173 7455 7365 6444 6174 6522 207b mLastUsedDate" { │ │ │ +002092a0: 7473 2032 3030 352d 3036 2d32 3720 3036 ts 2005-06-27 06 │ │ │ +002092b0: 3a32 363a 3035 2e30 3030 3030 307d 2029 :26:05.000000} ) │ │ │ +002092c0: 2029 0a3c 2f73 6372 6565 6e3e 0a20 2020 ).. │ │ │ +002092d0: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f . ......!demo/ │ │ │ +00209300: 646f 6373 7263 2f66 756e 6372 6566 2f74 docsrc/funcref/t │ │ │ +00209310: 6964 795f 6874 6d6c 2e78 6d6c df00 0064 idy_html.xml...d │ │ │ +00209320: 4d3c 3f78 6d6c 2076 6572 7369 6f6e 3d22 M... . tidy_h │ │ │ +002096f0: 746d 6c3c 2f72 6566 656e 7472 7974 6974 tml. xml. . . │ │ │ +00209750: 7469 6479 5f68 746d 6c3c 2f72 6566 6e61 tidy_html. Invoke built │ │ │ +00209780: 2d69 6e20 7665 7273 696f 6e20 6f66 2048 -in version of H │ │ │ +00209790: 544d 4c20 5469 6479 2075 7469 6c69 7479 TML Tidy utility │ │ │ +002097a0: 2074 6f20 6669 7820 7479 7069 6361 6c20 to fix typical │ │ │ +002097b0: 6572 726f 7273 2069 6e20 2048 544d 4c20 errors in HTML │ │ │ +002097c0: 7465 7874 3c2f 7265 6670 7572 706f 7365 text. . . . │ │ │ +00209820: 2020 3c66 756e 6370 726f 746f 7479 7065 . │ │ │ +00209850: 3c66 756e 6364 6566 3e3c 6675 6e63 7469 tidy_html..in │ │ │ +00209890: 3c70 6172 616d 6574 6572 3e72 6177 5f68 raw_h │ │ │ +002098a0: 746d 6c3c 2f70 6172 616d 6574 6572 3e20 tml │ │ │ +002098b0: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar..in │ │ │ +002098d0: 203c 7061 7261 6d65 7465 723e 7469 6479 tidy │ │ │ +002098e0: 5f63 6f6e 6669 673c 2f70 6172 616d 6574 _config varchar. . │ │ │ +00209920: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . Des │ │ │ +00209970: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +00209980: 3c70 6172 613e 0a54 6869 7320 6675 6e63 .This func │ │ │ +00209990: 7469 6f6e 2069 6d70 726f 7665 7320 7468 tion improves th │ │ │ +002099a0: 6520 6769 7665 6e20 736f 7572 6365 2048 e given source H │ │ │ +002099b0: 544d 4c20 7465 7874 2c20 6279 2069 6e76 TML text, by inv │ │ │ +002099c0: 6f6b 696e 6720 610a 6375 7374 6f6d 2076 oking a.custom v │ │ │ +002099d0: 6572 7369 6f6e 206f 6620 4854 4d4c 2054 ersion of HTML T │ │ │ +002099e0: 6964 7920 7574 696c 6974 792e 0a54 6f20 idy utility..To │ │ │ +002099f0: 6c65 6172 6e20 6d6f 7265 2061 626f 7574 learn more about │ │ │ +00209a00: 2054 6964 7920 7365 6520 6874 7470 3a2f Tidy see http:/ │ │ │ +00209a10: 2f77 7777 2e77 332e 6f72 672f 5065 6f70 /www.w3.org/Peop │ │ │ +00209a20: 6c65 2f52 6167 6765 7474 2f74 6964 792f le/Raggett/tidy/ │ │ │ +00209a30: 202e 0a53 6f6d 6520 7061 7274 6963 756c ..Some particul │ │ │ +00209a40: 6172 2063 6f6d 6269 6e61 7469 6f6e 7320 ar combinations │ │ │ +00209a50: 6f66 2065 7272 6f72 7320 696e 2073 6f75 of errors in sou │ │ │ +00209a60: 7263 6520 4854 4d4c 206d 6179 2063 6175 rce HTML may cau │ │ │ +00209a70: 7365 2054 6964 7920 746f 0a6d 6973 696e se Tidy to.misin │ │ │ +00209a80: 7465 7270 7265 7420 7468 6520 736f 7572 terpret the sour │ │ │ +00209a90: 6365 2073 6f20 7468 6520 6f75 7470 7574 ce so the output │ │ │ +00209aa0: 206d 6179 2062 6520 696e 636f 6d70 6c65 may be incomple │ │ │ +00209ab0: 7465 206f 7220 636f 7272 7570 7465 642e te or corrupted. │ │ │ +00209ac0: 0a54 6869 7320 6973 2061 6e20 2075 6e61 .This is an una │ │ │ +00209ad0: 766f 6964 6162 6c65 2070 726f 626c 656d voidable problem │ │ │ +00209ae0: 2c20 6475 6520 746f 2068 6575 7269 7374 , due to heurist │ │ │ +00209af0: 6963 206e 6174 7572 6520 6f66 2074 6865 ic nature of the │ │ │ +00209b00: 2070 726f 6365 6475 7265 2e0a 204f 6e20 procedure.. On │ │ │ +00209b10: 7468 6520 6f74 6865 7220 6861 6e64 2c20 the other hand, │ │ │ +00209b20: 5469 6479 2077 696c 6c20 7072 6f63 6573 Tidy will proces │ │ │ +00209b30: 7320 616c 6d6f 7374 2061 6e79 2048 544d s almost any HTM │ │ │ +00209b40: 4c20 7375 6974 6162 6c65 2066 6f72 2073 L suitable for s │ │ │ +00209b50: 6f6d 650a 2671 756f 743b 706f 7075 6c61 ome."popula │ │ │ +00209b60: 7226 7175 6f74 3b20 6272 6f77 7365 722c r" browser, │ │ │ +00209b70: 2065 2e67 2e20 496e 7465 726e 6574 2045 e.g. Internet E │ │ │ +00209b80: 7870 6c6f 7265 7220 6f72 204e 6574 7363 xplorer or Netsc │ │ │ +00209b90: 6170 6520 4e61 7669 6761 746f 722e 0a3c ape Navigator..< │ │ │ +00209ba0: 2f70 6172 613e 3c2f 7265 6673 6563 7431 /para>. Parameters</tit │ │ │ +00209be0: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ +00209bf0: 323e 3c74 6974 6c65 3e72 6177 5f68 746d 2><title>raw_htm │ │ │ +00209c00: 6c3c 2f74 6974 6c65 3e0a 2020 2020 2020 l. │ │ │ +00209c10: 3c70 6172 613e 0a53 6f75 7263 6520 4854 .Source HT │ │ │ +00209c20: 4d4c 2074 6578 7420 746f 2070 726f 6365 ML text to proce │ │ │ +00209c30: 7373 2e0a 4e6f 7465 2074 6861 7420 7468 ss..Note that th │ │ │ +00209c40: 6520 656e 636f 6469 6e67 206f 6620 7468 e encoding of th │ │ │ +00209c50: 6973 2074 6578 7420 6d75 7374 2062 6520 is text must be │ │ │ +00209c60: 7370 6563 6966 6965 6420 696e 0a3c 7061 specified in.tidy_con │ │ │ +00209c80: 6669 673c 2f70 6172 616d 6574 6572 3e20 fig │ │ │ +00209c90: 7374 7269 6e67 2c0a 616e 6420 6465 6661 string,.and defa │ │ │ +00209ca0: 756c 7420 656e 636f 6469 6e67 206f 6620 ult encoding of │ │ │ +00209cb0: 7365 7373 696f 6e20 7769 6c6c 206e 6f74 session will not │ │ │ +00209cc0: 2062 6520 6d65 6e74 696f 6e65 6420 6279 be mentioned by │ │ │ +00209cd0: 2054 6964 792e 0a3c 2f70 6172 613e 0a3c Tidy...< │ │ │ +00209ce0: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ +00209cf0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ +00209d00: 7469 6479 5f63 6f6e 6669 673c 2f74 6974 tidy_config</tit │ │ │ +00209d10: 6c65 3e0a 3c21 2d2d 0a20 2020 2020 203c le>.<!--. < │ │ │ +00209d20: 7061 7261 3e0a 436f 6e66 6967 7572 6174 para>.Configurat │ │ │ +00209d30: 696f 6e20 7374 7269 6e67 2c20 7370 6163 ion string, spac │ │ │ +00209d40: 652d 6465 6c69 6d69 7465 6420 6c69 7374 e-delimited list │ │ │ +00209d50: 206f 6620 6f70 7469 6f6e 732c 2065 7861 of options, exa │ │ │ +00209d60: 6374 6c79 2061 730a 696e 206f 7269 6769 ctly as.in origi │ │ │ +00209d70: 6e61 6c20 5469 6479 2773 2063 6f6d 6d61 nal Tidy's comma │ │ │ +00209d80: 6e64 2d6c 696e 6520 6f72 2069 6e20 5469 nd-line or in Ti │ │ │ +00209d90: 6479 2773 2063 6f6e 6669 6775 7261 7469 dy's configurati │ │ │ +00209da0: 6f6e 2066 696c 652e 0a4e 6f74 2061 6c6c on file..Not all │ │ │ +00209db0: 206f 7074 696f 6e73 206f 6620 6f72 6967 options of orig │ │ │ +00209dc0: 696e 616c 2054 6964 7920 7769 6c6c 2077 inal Tidy will w │ │ │ +00209dd0: 6f72 6b2c 2064 7565 2074 6f20 6f62 7669 ork, due to obvi │ │ │ +00209de0: 6f75 7320 7265 6173 6f6e 732c 0a75 6e73 ous reasons,.uns │ │ │ +00209df0: 7570 706f 7274 6564 206f 7074 696f 6e73 upported options │ │ │ +00209e00: 2077 696c 6c20 6265 2073 696c 656e 746c will be silentl │ │ │ +00209e10: 7920 6967 6e6f 7265 642c 2073 6f20 796f y ignored, so yo │ │ │ +00209e20: 7520 6d61 7920 7265 6164 2079 6f75 720a u may read your. │ │ │ +00209e30: 6661 766f 7269 7465 2054 6964 7927 7320 favorite Tidy's │ │ │ +00209e40: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ +00209e50: 6c65 2062 7920 6669 6c65 5f74 6f5f 7374 le by file_to_st │ │ │ +00209e60: 7269 6e67 2066 756e 6374 696f 6e20 616e ring function an │ │ │ +00209e70: 640a 7061 7373 2069 7420 746f 2074 6964 d.pass it to tid │ │ │ +00209e80: 795f 6874 6d6c 2e0a 3c2f 7061 7261 3e0a y_html..</para>. │ │ │ +00209e90: 2020 2020 3c74 6162 6c65 3e3c 7469 746c <table><titl │ │ │ +00209ea0: 653e 5469 6479 206f 7074 696f 6e73 3c2f e>Tidy options</ │ │ │ +00209eb0: 7469 746c 653e 0a20 2020 2020 203c 7467 title>. <tg │ │ │ +00209ec0: 726f 7570 2063 6f6c 733d 2232 223e 0a20 roup cols="2">. │ │ │ +00209ed0: 2020 2020 2020 3c74 6865 6164 3e3c 726f <thead><ro │ │ │ +00209ee0: 773e 3c65 6e74 7279 3e4f 7074 696f 6e3c w><entry>Option< │ │ │ +00209ef0: 2f65 6e74 7279 3e3c 656e 7472 793e 4566 /entry><entry>Ef │ │ │ +00209f00: 6665 6374 3c2f 656e 7472 793e 3c2f 726f fect</entry></ro │ │ │ +00209f10: 773e 3c2f 7468 6561 643e 0a09 3c74 626f w></thead>..<tbo │ │ │ +00209f20: 6479 3e0a 3c72 6f77 3e3c 656e 7472 793e dy>.<row><entry> │ │ │ +00209f30: 2d69 6e64 656e 7420 6f72 202d 693c 2f65 -indent or -i</e │ │ │ +00209f40: 6e74 7279 3e3c 656e 7472 793e 696e 6465 ntry><entry>inde │ │ │ +00209f50: 6e74 2065 6c65 6d65 6e74 2063 6f6e 7465 nt element conte │ │ │ +00209f60: 6e74 3c2f 656e 7472 793e 3c2f 726f 773e nt</entry></row> │ │ │ +00209f70: 0a3c 726f 773e 3c65 6e74 7279 3e2d 6f6d .<row><entry>-om │ │ │ +00209f80: 6974 2020 206f 7220 2d6f 3c2f 656e 7472 it or -o</entr │ │ │ +00209f90: 793e 3c65 6e74 7279 3e6f 6d69 7420 6f70 y><entry>omit op │ │ │ +00209fa0: 7469 6f6e 616c 2065 6e64 7461 6773 3c2f tional endtags</ │ │ │ +00209fb0: 656e 7472 793e 3c2f 726f 773e 0a3c 726f entry></row>.<ro │ │ │ +00209fc0: 773e 3c65 6e74 7279 3e2d 7772 6170 2037 w><entry>-wrap 7 │ │ │ +00209fd0: 323c 2f65 6e74 7279 3e3c 656e 7472 793e 2</entry><entry> │ │ │ +00209fe0: 7772 6170 2074 6578 7420 6174 2063 6f6c wrap text at col │ │ │ +00209ff0: 756d 6e20 3732 2028 6465 6661 756c 7420 umn 72 (default │ │ │ +0020a000: 6973 2036 3829 3c2f 656e 7472 793e 3c2f is 68)</entry></ │ │ │ +0020a010: 726f 773e 0a3c 726f 773e 3c65 6e74 7279 row>.<row><entry │ │ │ +0020a020: 3e2d 7570 7065 7220 206f 7220 2d75 3c2f >-upper or -u</ │ │ │ +0020a030: 656e 7472 793e 3c65 6e74 7279 3e66 6f72 entry><entry>for │ │ │ +0020a040: 6365 2074 6167 7320 746f 2075 7070 6572 ce tags to upper │ │ │ +0020a050: 2063 6173 6520 2864 6566 6175 6c74 2069 case (default i │ │ │ +0020a060: 7320 6c6f 7765 7229 3c2f 656e 7472 793e s lower)</entry> │ │ │ +0020a070: 3c2f 726f 773e 0a3c 726f 773e 3c65 6e74 </row>.<row><ent │ │ │ +0020a080: 7279 3e2d 636c 6561 6e20 206f 7220 2d63 ry>-clean or -c │ │ │ +0020a090: 3c2f 656e 7472 793e 3c65 6e74 7279 3e72 </entry><entry>r │ │ │ +0020a0a0: 6570 6c61 6365 2066 6f6e 742c 206e 6f62 eplace font, nob │ │ │ +0020a0b0: 7220 2661 6d70 3b20 6365 6e74 6572 2074 r & center t │ │ │ +0020a0c0: 6167 7320 6279 2043 5353 3c2f 656e 7472 ags by CSS</entr │ │ │ +0020a0d0: 793e 3c2f 726f 773e 0a3c 726f 773e 3c65 y></row>.<row><e │ │ │ +0020a0e0: 6e74 7279 3e2d 6e75 6d65 7269 6320 6f72 ntry>-numeric or │ │ │ +0020a0f0: 202d 6e3c 2f65 6e74 7279 3e3c 656e 7472 -n</entry><entr │ │ │ +0020a100: 793e 6f75 7470 7574 206e 756d 6572 6963 y>output numeric │ │ │ +0020a110: 2072 6174 6865 7220 7468 616e 206e 616d rather than nam │ │ │ +0020a120: 6564 2065 6e74 6974 6965 733c 2f65 6e74 ed entities</ent │ │ │ +0020a130: 7279 3e3c 2f72 6f77 3e0a 3c72 6f77 3e3c ry></row>.<row>< │ │ │ +0020a140: 656e 7472 793e 2d65 7272 6f72 7320 6f72 entry>-errors or │ │ │ +0020a150: 202d 653c 2f65 6e74 7279 3e3c 656e 7472 -e</entry><entr │ │ │ +0020a160: 793e 6f6e 6c79 2073 686f 7720 6572 726f y>only show erro │ │ │ +0020a170: 7273 3c2f 656e 7472 793e 3c2f 726f 773e rs</entry></row> │ │ │ +0020a180: 0a3c 726f 773e 3c65 6e74 7279 3e2d 7175 .<row><entry>-qu │ │ │ +0020a190: 6965 7420 6f72 202d 713c 2f65 6e74 7279 iet or -q</entry │ │ │ +0020a1a0: 3e3c 656e 7472 793e 7375 7070 7265 7373 ><entry>suppress │ │ │ +0020a1b0: 206e 6f6e 6573 7365 6e74 6961 6c20 6f75 nonessential ou │ │ │ +0020a1c0: 7470 7574 3c2f 656e 7472 793e 3c2f 726f tput</entry></ro │ │ │ +0020a1d0: 773e 0a3c 726f 773e 3c65 6e74 7279 3e2d w>.<row><entry>- │ │ │ +0020a1e0: 786d 6c3c 2f65 6e74 7279 3e3c 656e 7472 xml</entry><entr │ │ │ +0020a1f0: 793e 7573 6520 7468 6973 2077 6865 6e20 y>use this when │ │ │ +0020a200: 696e 7075 7420 6973 2077 656c 6c66 6f72 input is wellfor │ │ │ +0020a210: 6d65 6420 786d 6c3c 2f65 6e74 7279 3e3c med xml</entry>< │ │ │ +0020a220: 2f72 6f77 3e0a 3c72 6f77 3e3c 656e 7472 /row>.<row><entr │ │ │ +0020a230: 793e 2d61 7378 6d6c 3c2f 656e 7472 793e y>-asxml</entry> │ │ │ +0020a240: 3c65 6e74 7279 3e74 6f20 636f 6e76 6572 <entry>to conver │ │ │ +0020a250: 7420 6874 6d6c 2074 6f20 7765 6c6c 666f t html to wellfo │ │ │ +0020a260: 726d 6564 2078 6d6c 3c2f 656e 7472 793e rmed xml</entry> │ │ │ +0020a270: 3c2f 726f 773e 0a3c 726f 773e 3c65 6e74 </row>.<row><ent │ │ │ +0020a280: 7279 3e2d 736c 6964 6573 3c2f 656e 7472 ry>-slides</entr │ │ │ +0020a290: 793e 3c65 6e74 7279 3e28 4449 5341 424c y><entry>(DISABL │ │ │ +0020a2a0: 4544 2920 746f 2062 7572 7374 2069 6e74 ED) to burst int │ │ │ +0020a2b0: 6f20 736c 6964 6573 206f 6e20 6832 2065 o slides on h2 e │ │ │ +0020a2c0: 6c65 6d65 6e74 733c 2f65 6e74 7279 3e3c lements</entry>< │ │ │ +0020a2d0: 2f72 6f77 3e0a 3c72 6f77 3e3c 656e 7472 /row>.<row><entr │ │ │ +0020a2e0: 793e 2d72 6177 3c2f 656e 7472 793e 3c65 y>-raw</entry><e │ │ │ +0020a2f0: 6e74 7279 3e6c 6561 7665 2063 6861 7273 ntry>leave chars │ │ │ +0020a300: 203e 2031 3238 2075 6e63 6861 6e67 6564 > 128 unchanged │ │ │ +0020a310: 2075 706f 6e20 6f75 7470 7574 3c2f 656e upon output</en │ │ │ +0020a320: 7472 793e 3c2f 726f 773e 0a3c 726f 773e try></row>.<row> │ │ │ +0020a330: 3c65 6e74 7279 3e2d 6173 6369 693c 2f65 <entry>-ascii</e │ │ │ +0020a340: 6e74 7279 3e3c 656e 7472 793e 7573 6520 ntry><entry>use │ │ │ +0020a350: 4153 4349 4920 666f 7220 6f75 7470 7574 ASCII for output │ │ │ +0020a360: 2c20 4c61 7469 6e2d 3120 666f 7220 696e , Latin-1 for in │ │ │ +0020a370: 7075 743c 2f65 6e74 7279 3e3c 2f72 6f77 put</entry></row │ │ │ +0020a380: 3e0a 3c72 6f77 3e3c 656e 7472 793e 2d6c >.<row><entry>-l │ │ │ +0020a390: 6174 696e 313c 2f65 6e74 7279 3e3c 656e atin1</entry><en │ │ │ +0020a3a0: 7472 793e 7573 6520 4c61 7469 6e2d 3120 try>use Latin-1 │ │ │ +0020a3b0: 666f 7220 626f 7468 2069 6e70 7574 2061 for both input a │ │ │ +0020a3c0: 6e64 206f 7574 7075 743c 2f65 6e74 7279 nd output</entry │ │ │ +0020a3d0: 3e3c 2f72 6f77 3e0a 3c72 6f77 3e3c 656e ></row>.<row><en │ │ │ +0020a3e0: 7472 793e 2d69 736f 3230 3232 3c2f 656e try>-iso2022</en │ │ │ +0020a3f0: 7472 793e 3c65 6e74 7279 3e75 7365 2049 try><entry>use I │ │ │ +0020a400: 534f 3230 3232 2066 6f72 2062 6f74 6820 SO2022 for both │ │ │ +0020a410: 696e 7075 7420 616e 6420 6f75 7470 7574 input and output │ │ │ +0020a420: 3c2f 656e 7472 793e 3c2f 726f 773e 0a3c </entry></row>.< │ │ │ +0020a430: 726f 773e 3c65 6e74 7279 3e2d 7574 6638 row><entry>-utf8 │ │ │ +0020a440: 3c2f 656e 7472 793e 3c65 6e74 7279 3e75 </entry><entry>u │ │ │ +0020a450: 7365 2055 5446 2d38 2066 6f72 2062 6f74 se UTF-8 for bot │ │ │ +0020a460: 6820 696e 7075 7420 616e 6420 6f75 7470 h input and outp │ │ │ +0020a470: 7574 3c2f 656e 7472 793e 3c2f 726f 773e ut</entry></row> │ │ │ +0020a480: 0a3c 726f 773e 3c65 6e74 7279 3e2d 6d61 .<row><entry>-ma │ │ │ +0020a490: 633c 2f65 6e74 7279 3e3c 656e 7472 793e c</entry><entry> │ │ │ +0020a4a0: 7573 6520 7468 6520 4170 706c 6520 4d61 use the Apple Ma │ │ │ +0020a4b0: 6352 6f6d 616e 2063 6861 7261 6374 6572 cRoman character │ │ │ +0020a4c0: 2073 6574 3c2f 656e 7472 793e 3c2f 726f set</entry></ro │ │ │ +0020a4d0: 773e 0a3c 726f 773e 3c65 6e74 7279 3e2d w>.<row><entry>- │ │ │ +0020a4e0: 636f 6e66 6967 2026 6c74 3b66 696c 6526 config <file& │ │ │ +0020a4f0: 6774 3b3c 2f65 6e74 7279 3e3c 656e 7472 gt;</entry><entr │ │ │ +0020a500: 793e 2844 4953 4142 4c45 4429 2073 6574 y>(DISABLED) set │ │ │ +0020a510: 206f 7074 696f 6e73 2066 726f 6d20 636f options from co │ │ │ +0020a520: 6e66 6967 2026 6c74 3b66 696c 6526 6774 nfig <file> │ │ │ +0020a530: 3b3c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a ;</entry></row>. │ │ │ +0020a540: 3c72 6f77 3e3c 656e 7472 793e 2d66 2026 <row><entry>-f & │ │ │ +0020a550: 6c74 3b66 696c 6526 6774 3b3c 2f65 6e74 lt;file></ent │ │ │ +0020a560: 7279 3e3c 656e 7472 793e 2844 4953 4142 ry><entry>(DISAB │ │ │ +0020a570: 4c45 4429 2077 7269 7465 2065 7272 6f72 LED) write error │ │ │ +0020a580: 7320 746f 206e 616d 6564 2026 6c74 3b66 s to named <f │ │ │ +0020a590: 696c 6526 6774 3b3c 2f65 6e74 7279 3e3c ile></entry>< │ │ │ +0020a5a0: 2f72 6f77 3e0a 3c72 6f77 3e3c 656e 7472 /row>.<row><entr │ │ │ +0020a5b0: 793e 2d6d 6f64 6966 7920 6f72 202d 6d3c y>-modify or -m< │ │ │ +0020a5c0: 2f65 6e74 7279 3e3c 656e 7472 793e 2844 /entry><entry>(D │ │ │ +0020a5d0: 4953 4142 4c45 4429 2074 6f20 6d6f 6469 ISABLED) to modi │ │ │ +0020a5e0: 6679 206f 7269 6769 6e61 6c20 6669 6c65 fy original file │ │ │ +0020a5f0: 733c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a s</entry></row>. │ │ │ +0020a600: 3c72 6f77 3e3c 656e 7472 793e 2d76 6572 <row><entry>-ver │ │ │ +0020a610: 7369 6f6e 206f 7220 2d76 3c2f 656e 7472 sion or -v</entr │ │ │ +0020a620: 793e 3c65 6e74 7279 3e28 4449 5341 424c y><entry>(DISABL │ │ │ +0020a630: 4544 2920 7368 6f77 2076 6572 7369 6f6e ED) show version │ │ │ +0020a640: 3c2f 656e 7472 793e 3c2f 726f 773e 0a3c </entry></row>.< │ │ │ +0020a650: 726f 773e 3c65 6e74 7279 3e2d 6865 6c70 row><entry>-help │ │ │ +0020a660: 206f 7220 2d68 3c2f 656e 7472 793e 3c65 or -h</entry><e │ │ │ +0020a670: 6e74 7279 3e28 4449 5341 424c 4544 2920 ntry>(DISABLED) │ │ │ +0020a680: 6c69 7374 2063 6f6d 6d61 6e64 206c 696e list command lin │ │ │ +0020a690: 6520 2f20 636f 6e66 6967 7572 6174 696f e / configuratio │ │ │ +0020a6a0: 6e20 6f70 7469 6f6e 733c 2f65 6e74 7279 n options</entry │ │ │ +0020a6b0: 3e3c 2f72 6f77 3e0a 093c 2f74 626f 6479 ></row>..</tbody │ │ │ +0020a6c0: 3e0a 2020 2020 2020 3c2f 7467 726f 7570 >. </tgroup │ │ │ +0020a6d0: 3e0a 2020 2020 3c2f 7461 626c 653e 0a2d >. </table>.- │ │ │ +0020a6e0: 2d3e 0a20 2020 2020 203c 7061 7261 3e0a ->. <para>. │ │ │ +0020a6f0: 436f 6e66 6967 7572 6174 696f 6e20 7374 Configuration st │ │ │ +0020a700: 7269 6e67 2069 7320 6120 6c69 7374 206f ring is a list o │ │ │ +0020a710: 6620 6f70 7469 6f6e 732c 2064 656c 696d f options, delim │ │ │ +0020a720: 6974 6564 2062 7920 6e65 776c 696e 6573 ited by newlines │ │ │ +0020a730: 2c0a 7769 7468 2065 7861 6374 6c79 2074 ,.with exactly t │ │ │ +0020a740: 6865 2073 616d 6520 7379 6e74 6178 2061 he same syntax a │ │ │ +0020a750: 7320 6f72 6967 696e 616c 2054 6964 7927 s original Tidy' │ │ │ +0020a760: 7320 636f 6e66 6967 7572 6174 696f 6e20 s configuration │ │ │ +0020a770: 6669 6c65 2e0a 4e6f 7420 616c 6c20 6f70 file..Not all op │ │ │ +0020a780: 7469 6f6e 7320 6f66 206f 7269 6769 6e61 tions of origina │ │ │ +0020a790: 6c20 5469 6479 2077 696c 6c20 776f 726b l Tidy will work │ │ │ +0020a7a0: 2c20 6475 6520 746f 206f 6276 696f 7573 , due to obvious │ │ │ +0020a7b0: 2072 6561 736f 6e73 2c0a 756e 7375 7070 reasons,.unsupp │ │ │ +0020a7c0: 6f72 7465 6420 6f70 7469 6f6e 7320 7769 orted options wi │ │ │ +0020a7d0: 6c6c 2062 6520 7369 6c65 6e74 6c79 2069 ll be silently i │ │ │ +0020a7e0: 676e 6f72 6564 2c20 736f 2079 6f75 206d gnored, so you m │ │ │ +0020a7f0: 6179 2072 6561 6420 796f 7572 0a66 6176 ay read your.fav │ │ │ +0020a800: 6f72 6974 6520 5469 6479 2773 2063 6f6e orite Tidy's con │ │ │ +0020a810: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ +0020a820: 6279 2066 696c 655f 746f 5f73 7472 696e by file_to_strin │ │ │ +0020a830: 6720 6675 6e63 7469 6f6e 2061 6e64 0a70 g function and.p │ │ │ +0020a840: 6173 7320 6974 2074 6f20 7469 6479 5f68 ass it to tidy_h │ │ │ +0020a850: 746d 6c2e 0a3c 2f70 6172 613e 0a0a 3c66 tml..</para>..<f │ │ │ +0020a860: 6f72 6d61 6c70 6172 613e 3c74 6974 6c65 ormalpara><title │ │ │ +0020a870: 3e74 6964 792d 6d61 726b 3a20 3c65 6d70 >tidy-mark: <emp │ │ │ +0020a880: 6861 7369 733e 626f 6f6c 3c2f 656d 7068 hasis>bool</emph │ │ │ +0020a890: 6173 6973 3e3c 2f74 6974 6c65 3e0a 0a3c asis>..< │ │ │ +0020a8a0: 7061 7261 3e49 6620 7365 7420 746f 203c para>If set to < │ │ │ +0020a8b0: 656d 7068 6173 6973 3e79 6573 3c2f 656d emphasis>yes (the def │ │ │ +0020a8d0: 6175 6c74 2920 5469 6479 2077 696c 6c20 ault) Tidy will │ │ │ +0020a8e0: 6164 6420 6120 6d65 7461 0a65 6c65 6d65 add a meta.eleme │ │ │ +0020a8f0: 6e74 2074 6f20 7468 6520 646f 6375 6d65 nt to the docume │ │ │ +0020a900: 6e74 2068 6561 6420 746f 2069 6e64 6963 nt head to indic │ │ │ +0020a910: 6174 6520 7468 6174 2074 6865 2064 6f63 ate that the doc │ │ │ +0020a920: 756d 656e 7420 6861 730a 6265 656e 2074 ument has.been t │ │ │ +0020a930: 6964 6965 642e 2054 6f20 7375 7070 7265 idied. To suppre │ │ │ +0020a940: 7373 2074 6869 732c 2073 6574 2074 6964 ss this, set tid │ │ │ +0020a950: 792d 6d61 726b 2074 6f20 3c65 6d70 6861 y-mark to no. Tidy.won't ad │ │ │ +0020a980: 6420 6120 6d65 7461 2065 6c65 6d65 6e74 d a meta element │ │ │ +0020a990: 2069 6620 6f6e 6520 6973 2061 6c72 6561 if one is alrea │ │ │ +0020a9a0: 6479 2070 7265 7365 6e74 2e3c 2f70 6172 dy present.. │ │ │ +0020a9c0: 0a3c 666f 726d 616c 7061 7261 3e3c 7469 .markup: bool..< │ │ │ +0020aa00: 7061 7261 3e44 6574 6572 6d69 6e65 7320 para>Determines │ │ │ +0020aa10: 7768 6574 6865 7220 5469 6479 2067 656e whether Tidy gen │ │ │ +0020aa20: 6572 6174 6573 2061 2070 7265 7474 7920 erates a pretty │ │ │ +0020aa30: 7072 696e 7465 6420 7665 7273 696f 6e20 printed version │ │ │ +0020aa40: 6f66 0a74 6865 206d 6172 6b75 702e 2042 of.the markup. B │ │ │ +0020aa50: 6f6f 6c20 7661 6c75 6573 2061 7265 2065 ool values are e │ │ │ +0020aa60: 6974 6865 7220 3c65 6d70 6861 7369 733e ither │ │ │ +0020aa70: 7965 733c 2f65 6d70 6861 7369 733e 206f yes o │ │ │ +0020aa80: 7220 3c65 6d70 6861 7369 733e 6e6f 3c2f r no..Note │ │ │ +0020aaa0: 7468 6174 2054 6964 7920 776f 6e27 7420 that Tidy won't │ │ │ +0020aab0: 6765 6e65 7261 7465 2061 2070 7265 7474 generate a prett │ │ │ +0020aac0: 7920 7072 696e 7465 6420 7665 7273 696f y printed versio │ │ │ +0020aad0: 6e20 6966 2069 740a 6669 6e64 7320 756e n if it.finds un │ │ │ +0020aae0: 6b6e 6f77 6e20 7461 6773 2c20 6f72 206d known tags, or m │ │ │ +0020aaf0: 6973 7369 6e67 2074 7261 696c 696e 6720 issing trailing │ │ │ +0020ab00: 7175 6f74 6573 206f 6e20 6174 7472 6962 quotes on attrib │ │ │ +0020ab10: 7574 650a 7661 6c75 6573 2c20 6f72 206d ute.values, or m │ │ │ +0020ab20: 6973 7369 6e67 2074 7261 696c 696e 6720 issing trailing │ │ │ +0020ab30: 2726 6774 3b27 206f 6e20 7461 6773 2e20 '>' on tags. │ │ │ +0020ab40: 5468 6520 6465 6661 756c 7420 6973 0a3c The default is.< │ │ │ +0020ab50: 656d 7068 6173 6973 3e79 6573 3c2f 656d emphasis>yes.< │ │ │ +0020ab70: 2f66 6f72 6d61 6c70 6172 613e 0a0a 3c66 /formalpara>..wrap: <emphasis │ │ │ +0020aba0: 3e6e 756d 6265 723c 2f65 6d70 6861 7369 >number</emphasi │ │ │ +0020abb0: 733e 3c2f 7469 746c 653e 0a0a 3c70 6172 s>..Sets the right │ │ │ +0020abd0: 206d 6172 6769 6e20 666f 7220 6c69 6e65 margin for line │ │ │ +0020abe0: 2077 7261 7070 696e 672e 2054 6964 7920 wrapping. Tidy │ │ │ +0020abf0: 7472 6965 7320 746f 2077 7261 700a 6c69 tries to wrap.li │ │ │ +0020ac00: 6e65 7320 736f 2074 6861 7420 7468 6579 nes so that they │ │ │ +0020ac10: 2064 6f20 6e6f 7420 6578 6365 6564 2074 do not exceed t │ │ │ +0020ac20: 6869 7320 6c65 6e67 7468 2e20 5468 6520 his length. The │ │ │ +0020ac30: 6465 6661 756c 7420 6973 2036 362e 0a53 default is 66..S │ │ │ +0020ac40: 6574 2077 7261 7020 746f 207a 6572 6f20 et wrap to zero │ │ │ +0020ac50: 6966 2079 6f75 2077 616e 7420 746f 2064 if you want to d │ │ │ +0020ac60: 6973 6162 6c65 206c 696e 6520 7772 6170 isable line wrap │ │ │ +0020ac70: 7069 6e67 2e3c 2f70 6172 613e 3c2f 666f ping...
    wr │ │ │ +0020aca0: 6170 2d61 7474 7269 6275 7465 733a 203c ap-attributes: < │ │ │ +0020acb0: 656d 7068 6173 6973 3e62 6f6f 6c3c 2f65 emphasis>bool</e │ │ │ +0020acc0: 6d70 6861 7369 733e 3c2f 7469 746c 653e mphasis> │ │ │ +0020acd0: 0a0a 3c70 6172 613e 4966 2073 6574 2074 ..If set t │ │ │ +0020ace0: 6f20 3c65 6d70 6861 7369 733e 7965 733c o yes< │ │ │ +0020acf0: 2f65 6d70 6861 7369 733e 2c20 6174 7472 /emphasis>, attr │ │ │ +0020ad00: 6962 7574 6520 7661 6c75 6573 206d 6179 ibute values may │ │ │ +0020ad10: 2062 6520 7772 6170 7065 640a 6163 726f be wrapped.acro │ │ │ +0020ad20: 7373 206c 696e 6573 2066 6f72 2065 6173 ss lines for eas │ │ │ +0020ad30: 6965 7220 6564 6974 696e 672e 2054 6865 ier editing. The │ │ │ +0020ad40: 2064 6566 6175 6c74 2069 7320 6e6f 2e20 default is no. │ │ │ +0020ad50: 5468 6973 206f 7074 696f 6e0a 6361 6e20 This option.can │ │ │ +0020ad60: 6265 2073 6574 2069 6e64 6570 656e 6465 be set independe │ │ │ +0020ad70: 6e74 6c79 206f 6620 7772 6170 2d73 6372 ntly of wrap-scr │ │ │ +0020ad80: 6970 746c 6574 733c 2f70 6172 613e 3c2f iptlets.. │ │ │ +0020adb0: 7772 6170 2d73 6372 6970 742d 6c69 7465 wrap-script-lite │ │ │ +0020adc0: 7261 6c73 3a20 3c65 6d70 6861 7369 733e rals: <emphasis> │ │ │ +0020add0: 626f 6f6c 3c2f 656d 7068 6173 6973 3e3c bool</emphasis>< │ │ │ +0020ade0: 2f74 6974 6c65 3e0a 0a3c 7061 7261 3e49 /title>..<para>I │ │ │ +0020adf0: 6620 7365 7420 746f 203c 656d 7068 6173 f set to <emphas │ │ │ +0020ae00: 6973 3e79 6573 3c2f 656d 7068 6173 6973 is>yes</emphasis │ │ │ +0020ae10: 3e2c 2074 6869 7320 616c 6c6f 7773 206c >, this allows l │ │ │ +0020ae20: 696e 6573 2074 6f20 6265 2077 7261 7070 ines to be wrapp │ │ │ +0020ae30: 6564 0a77 6974 6869 6e20 7374 7269 6e67 ed.within string │ │ │ +0020ae40: 206c 6974 6572 616c 7320 7468 6174 2061 literals that a │ │ │ +0020ae50: 7070 6561 7220 696e 2073 6372 6970 7420 ppear in script │ │ │ +0020ae60: 6174 7472 6962 7574 6573 2e20 5468 650a attributes. The. │ │ │ +0020ae70: 6465 6661 756c 7420 6973 203c 656d 7068 default is <emph │ │ │ +0020ae80: 6173 6973 3e6e 6f3c 2f65 6d70 6861 7369 asis>no</emphasi │ │ │ +0020ae90: 733e 2e20 5468 6520 6578 616d 706c 6520 s>. The example │ │ │ +0020aea0: 7368 6f77 7320 686f 7720 5469 6479 2077 shows how Tidy w │ │ │ +0020aeb0: 7261 7073 2061 2072 6561 6c6c 790a 7265 raps a really.re │ │ │ +0020aec0: 616c 6c79 206c 6f6e 6720 7363 7269 7074 ally long script │ │ │ +0020aed0: 2073 7472 696e 6720 6c69 7465 7261 6c20 string literal │ │ │ +0020aee0: 696e 7365 7274 696e 6720 6120 6261 636b inserting a back │ │ │ +0020aef0: 736c 6173 6820 6368 6172 6163 7465 720a slash character. │ │ │ +0020af00: 6265 666f 7265 2074 6865 206c 696e 6562 before the lineb │ │ │ +0020af10: 7265 616b 3a0a 3c73 6372 6565 6e3e 0a26 reak:.<screen>.& │ │ │ +0020af20: 6c74 3b61 2068 7265 663d 2273 6f6d 6577 lt;a href="somew │ │ │ +0020af30: 6865 7265 2e68 746d 6c22 206f 6e6d 6f75 here.html" onmou │ │ │ +0020af40: 7365 6f76 6572 3d22 646f 6375 6d65 6e74 seover="document │ │ │ +0020af50: 2e73 7461 7475 7320 3d20 272e 2e2e 736f .status = '...so │ │ │ +0020af60: 6d65 205c 0a72 6561 6c6c 792c 2072 6561 me \.really, rea │ │ │ +0020af70: 6c6c 792c 2072 6561 6c6c 792c 2072 6561 lly, really, rea │ │ │ +0020af80: 6c6c 792c 2072 6561 6c6c 792c 2072 6561 lly, really, rea │ │ │ +0020af90: 6c6c 792c 2072 6561 6c6c 792c 2072 6561 lly, really, rea │ │ │ +0020afa0: 6c6c 792c 205c 0a72 6561 6c6c 792c 2072 lly, \.really, r │ │ │ +0020afb0: 6561 6c6c 7920 6c6f 6e67 2073 7472 696e eally long strin │ │ │ +0020afc0: 672e 2e27 3b22 2667 743b 7465 7374 266c g..';">test&l │ │ │ +0020afd0: 743b 2f61 2667 743b 0a3c 2f73 6372 6565 t;/a>.</scree │ │ │ +0020afe0: 6e3e 0a3c 2f70 6172 613e 3c2f 666f 726d n>.</para></form │ │ │ +0020aff0: 616c 7061 7261 3e0a 0a3c 666f 726d 616c alpara>..<formal │ │ │ +0020b000: 7061 7261 3e3c 7469 746c 653e 7772 6170 para><title>wrap │ │ │ +0020b010: 2d61 7370 3a20 3c65 6d70 6861 7369 733e -asp: <emphasis> │ │ │ +0020b020: 626f 6f6c 3c2f 656d 7068 6173 6973 3e3c bool</emphasis>< │ │ │ +0020b030: 2f74 6974 6c65 3e0a 0a3c 7061 7261 3e49 /title>..<para>I │ │ │ +0020b040: 6620 7365 7420 746f 203c 656d 7068 6173 f set to <emphas │ │ │ +0020b050: 6973 3e6e 6f3c 2f65 6d70 6861 7369 733e is>no</emphasis> │ │ │ +0020b060: 2c20 7468 6973 2070 7265 7665 6e74 7320 , this prevents │ │ │ +0020b070: 6c69 6e65 7320 6672 6f6d 2062 6569 6e67 lines from being │ │ │ +0020b080: 2077 7261 7070 6564 0a77 6974 6869 6e20 wrapped.within │ │ │ +0020b090: 4153 5020 7073 6575 646f 2065 6c65 6d65 ASP pseudo eleme │ │ │ +0020b0a0: 6e74 732c 2077 6869 6368 206c 6f6f 6b20 nts, which look │ │ │ +0020b0b0: 6c69 6b65 3a0a 266c 743b 2526 2331 3630 like:.<%  │ │ │ +0020b0c0: 3b2e 2e2e 2623 3136 303b 2526 6774 3b2e ;... %>. │ │ │ +0020b0d0: 2054 6865 2064 6566 6175 6c74 2069 7320 The default is │ │ │ +0020b0e0: 3c65 6d70 6861 7369 733e 7965 733c 2f65 <emphasis>yes</e │ │ │ +0020b0f0: 6d70 6861 7369 733e 2e3c 2f70 6172 613e mphasis>.</para> │ │ │ +0020b100: 3c2f 666f 726d 616c 7061 7261 3e0a 0a3c </formalpara>..< │ │ │ +0020b110: 666f 726d 616c 7061 7261 3e3c 7469 746c formalpara><titl │ │ │ +0020b120: 653e 7772 6170 2d6a 7374 653a 203c 656d e>wrap-jste: <em │ │ │ +0020b130: 7068 6173 6973 3e62 6f6f 6c3c 2f65 6d70 phasis>bool</emp │ │ │ +0020b140: 6861 7369 733e 3c2f 7469 746c 653e 0a0a hasis>.. │ │ │ +0020b150: 3c70 6172 613e 4966 2073 6574 2074 6f20 If set to │ │ │ +0020b160: 3c65 6d70 6861 7369 733e 6e6f 3c2f 656d no, this pr │ │ │ +0020b180: 6576 656e 7473 206c 696e 6573 2066 726f events lines fro │ │ │ +0020b190: 6d20 6265 696e 6720 7772 6170 7065 640a m being wrapped. │ │ │ +0020b1a0: 7769 7468 696e 204a 5354 4520 7073 6575 within JSTE pseu │ │ │ +0020b1b0: 646f 2065 6c65 6d65 6e74 732c 2077 6869 do elements, whi │ │ │ +0020b1c0: 6368 206c 6f6f 6b20 6c69 6b65 3a0a 266c ch look like:.&l │ │ │ +0020b1d0: 743b 2326 2331 3630 3b2e 2e2e 2623 3136 t;# ... │ │ │ +0020b1e0: 303b 2326 6774 3b2e 2054 6865 2064 6566 0;#>. The def │ │ │ +0020b1f0: 6175 6c74 2069 7320 3c65 6d70 6861 7369 ault is yes │ │ │ +0020b210: 2e3c 2f70 6172 613e 3c2f 666f 726d 616c ...wrap-p │ │ │ +0020b240: 6870 3a20 3c65 6d70 6861 7369 733e 626f hp: <emphasis>bo │ │ │ +0020b250: 6f6c 3c2f 656d 7068 6173 6973 3e3c 2f74 ol</emphasis></t │ │ │ +0020b260: 6974 6c65 3e0a 0a3c 7061 7261 3e49 6620 itle>..<para>If │ │ │ +0020b270: 7365 7420 746f 203c 656d 7068 6173 6973 set to <emphasis │ │ │ +0020b280: 3e6e 6f3c 2f65 6d70 6861 7369 733e 2c20 >no</emphasis>, │ │ │ +0020b290: 7468 6973 2070 7265 7665 6e74 7320 6c69 this prevents li │ │ │ +0020b2a0: 6e65 7320 6672 6f6d 2062 6569 6e67 2077 nes from being w │ │ │ +0020b2b0: 7261 7070 6564 0a77 6974 6869 6e20 5048 rapped.within PH │ │ │ +0020b2c0: 5020 7073 6575 646f 2065 6c65 6d65 6e74 P pseudo element │ │ │ +0020b2d0: 732e 2054 6865 2064 6566 6175 6c74 2069 s. The default i │ │ │ +0020b2e0: 7320 3c65 6d70 6861 7369 733e 7965 733c s <emphasis>yes< │ │ │ +0020b2f0: 2f65 6d70 6861 7369 733e 2e3c 2f70 6172 /emphasis>.</par │ │ │ +0020b300: 613e 3c2f 666f 726d 616c 7061 7261 3e0a a></formalpara>. │ │ │ +0020b310: 0a3c 666f 726d 616c 7061 7261 3e3c 7469 .<formalpara><ti │ │ │ +0020b320: 746c 653e 6c69 7465 7261 6c2d 6174 7472 tle>literal-attr │ │ │ +0020b330: 6962 7574 6573 3a20 3c65 6d70 6861 7369 ibutes: <emphasi │ │ │ +0020b340: 733e 626f 6f6c 3c2f 656d 7068 6173 6973 s>bool</emphasis │ │ │ +0020b350: 3e3c 2f74 6974 6c65 3e0a 0a3c 7061 7261 >..If set to yes, this ensure │ │ │ +0020b390: 7320 7468 6174 2077 6869 7465 7370 6163 s that whitespac │ │ │ +0020b3a0: 650a 6368 6172 6163 7465 7273 2077 6974 e.characters wit │ │ │ +0020b3b0: 6869 6e20 6174 7472 6962 7574 6520 7661 hin attribute va │ │ │ +0020b3c0: 6c75 6573 2061 7265 2070 6173 7365 6420 lues are passed │ │ │ +0020b3d0: 7468 726f 7567 6820 756e 6368 616e 6765 through unchange │ │ │ +0020b3e0: 642e 0a54 6865 2064 6566 6175 6c74 2069 d..The default i │ │ │ +0020b3f0: 7320 3c65 6d70 6861 7369 733e 6e6f 3c2f s no.
    .. │ │ │ +0020b420: 3c66 6f72 6d61 6c70 6172 613e 3c74 6974 tab-size: number │ │ │ +0020b460: 0a0a 3c70 6172 613e 5365 7473 2074 6865 ..Sets the │ │ │ +0020b470: 206e 756d 6265 7220 6f66 2063 6f6c 756d number of colum │ │ │ +0020b480: 6e73 2062 6574 7765 656e 2073 7563 6365 ns between succe │ │ │ +0020b490: 7373 6976 6520 7461 6220 7374 6f70 732e ssive tab stops. │ │ │ +0020b4a0: 2054 6865 0a64 6566 6175 6c74 2069 7320 The.default is │ │ │ +0020b4b0: 342e 2049 7420 6973 2075 7365 6420 746f 4. It is used to │ │ │ +0020b4c0: 206d 6170 2074 6162 7320 746f 2073 7061 map tabs to spa │ │ │ +0020b4d0: 6365 7320 7768 656e 2072 6561 6469 6e67 ces when reading │ │ │ +0020b4e0: 0a66 696c 6573 2e20 5469 6479 206e 6576 .files. Tidy nev │ │ │ +0020b4f0: 6572 206f 7574 7075 7473 2066 696c 6573 er outputs files │ │ │ +0020b500: 2077 6974 6820 7461 6273 2e3c 2f70 6172 with tabs.. │ │ │ +0020b520: 0a3c 666f 726d 616c 7061 7261 3e3c 7469 .indent: no, yes or auto..< │ │ │ +0020b580: 7061 7261 3e49 6620 7365 7420 746f 203c para>If set to < │ │ │ +0020b590: 656d 7068 6173 6973 3e79 6573 3c2f 656d emphasis>yes, Tidy wi │ │ │ +0020b5b0: 6c6c 2069 6e64 656e 7420 626c 6f63 6b2d ll indent block- │ │ │ +0020b5c0: 6c65 7665 6c20 7461 6773 2e0a 5468 6520 level tags..The │ │ │ +0020b5d0: 6465 6661 756c 7420 6973 203c 656d 7068 default is no. If set to auto Tidy wil │ │ │ +0020b620: 6c0a 6465 6369 6465 2077 6865 7468 6572 l.decide whether │ │ │ +0020b630: 206f 7220 6e6f 7420 746f 2069 6e64 656e or not to inden │ │ │ +0020b640: 7420 7468 6520 636f 6e74 656e 7420 6f66 t the content of │ │ │ +0020b650: 2074 6167 7320 7375 6368 2061 730a 7469 tags such as.ti │ │ │ +0020b660: 746c 652c 2068 312d 6836 2c20 6c69 2c20 tle, h1-h6, li, │ │ │ +0020b670: 7464 2c20 7468 2c20 6f72 2070 2064 6570 td, th, or p dep │ │ │ +0020b680: 656e 6469 6e67 206f 6e20 7768 6574 6865 ending on whethe │ │ │ +0020b690: 7220 6f72 206e 6f74 2074 6865 0a63 6f6e r or not the.con │ │ │ +0020b6a0: 7465 6e74 2069 6e63 6c75 6465 7320 6120 tent includes a │ │ │ +0020b6b0: 626c 6f63 6b2d 6c65 7665 6c20 656c 656d block-level elem │ │ │ +0020b6c0: 656e 742e 2059 6f75 2061 7265 2061 6476 ent. You are adv │ │ │ +0020b6d0: 6973 6564 2074 6f20 6176 6f69 640a 7365 ised to avoid.se │ │ │ +0020b6e0: 7474 696e 6720 696e 6465 6e74 2074 6f20 tting indent to │ │ │ +0020b6f0: 7965 7320 6173 2074 6869 7320 6361 6e20 yes as this can │ │ │ +0020b700: 6578 706f 7365 206c 6179 6f75 7420 6275 expose layout bu │ │ │ +0020b710: 6773 2069 6e20 736f 6d65 0a62 726f 7773 gs in some.brows │ │ │ +0020b720: 6572 732e 3c2f 7061 7261 3e3c 2f66 6f72 ers...ind │ │ │ +0020b750: 656e 742d 7370 6163 6573 3a20 3c65 6d70 ent-spaces: <emp │ │ │ +0020b760: 6861 7369 733e 6e75 6d62 6572 3c2f 656d hasis>number</em │ │ │ +0020b770: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020b780: 0a3c 7061 7261 3e53 6574 7320 7468 6520 .Sets the │ │ │ +0020b790: 6e75 6d62 6572 206f 6620 7370 6163 6573 number of spaces │ │ │ +0020b7a0: 2074 6f20 696e 6465 6e74 2063 6f6e 7465 to indent conte │ │ │ +0020b7b0: 6e74 2077 6865 6e20 696e 6465 6e74 6174 nt when indentat │ │ │ +0020b7c0: 696f 6e0a 6973 2065 6e61 626c 6564 2e20 ion.is enabled. │ │ │ +0020b7d0: 5468 6520 6465 6661 756c 7420 6973 2032 The default is 2 │ │ │ +0020b7e0: 2073 7061 6365 732e 3c2f 7061 7261 3e3c spaces.< │ │ │ +0020b7f0: 2f66 6f72 6d61 6c70 6172 613e 0a0a 3c66 /formalpara>..indent-attribut │ │ │ +0020b820: 6573 3a20 3c65 6d70 6861 7369 733e 626f es: <emphasis>bo │ │ │ +0020b830: 6f6c 3c2f 656d 7068 6173 6973 3e3c 2f74 ol</emphasis></t │ │ │ +0020b840: 6974 6c65 3e0a 0a3c 7061 7261 3e49 6620 itle>..<para>If │ │ │ +0020b850: 7365 7420 746f 203c 656d 7068 6173 6973 set to <emphasis │ │ │ +0020b860: 3e79 6573 3c2f 656d 7068 6173 6973 3e2c >yes</emphasis>, │ │ │ +0020b870: 2065 6163 6820 6174 7472 6962 7574 6520 each attribute │ │ │ +0020b880: 7769 6c6c 2062 6567 696e 206f 6e20 6120 will begin on a │ │ │ +0020b890: 6e65 770a 6c69 6e65 2e20 5468 6520 6465 new.line. The de │ │ │ +0020b8a0: 6661 756c 7420 6973 203c 656d 7068 6173 fault is <emphas │ │ │ +0020b8b0: 6973 3e6e 6f3c 2f65 6d70 6861 7369 733e is>no</emphasis> │ │ │ +0020b8c0: 2e3c 2f70 6172 613e 3c2f 666f 726d 616c .</para></formal │ │ │ +0020b8d0: 7061 7261 3e0a 0a3c 666f 726d 616c 7061 para>..<formalpa │ │ │ +0020b8e0: 7261 3e3c 7469 746c 653e 6869 6465 2d65 ra><title>hide-e │ │ │ +0020b8f0: 6e64 7461 6773 3a20 3c65 6d70 6861 7369 ndtags: <emphasi │ │ │ +0020b900: 733e 626f 6f6c 3c2f 656d 7068 6173 6973 s>bool</emphasis │ │ │ +0020b910: 3e3c 2f74 6974 6c65 3e0a 0a3c 7061 7261 >..If set to yes, optional en │ │ │ +0020b950: 642d 7461 6773 2077 696c 6c20 6265 206f d-tags will be o │ │ │ +0020b960: 6d69 7474 6564 0a77 6865 6e20 6765 6e65 mitted.when gene │ │ │ +0020b970: 7261 7469 6e67 2074 6865 2070 7265 7474 rating the prett │ │ │ +0020b980: 7920 7072 696e 7465 6420 6d61 726b 7570 y printed markup │ │ │ +0020b990: 2e20 5468 6973 206f 7074 696f 6e20 6973 . This option is │ │ │ +0020b9a0: 2069 676e 6f72 6564 0a69 6620 796f 7520 ignored.if you │ │ │ +0020b9b0: 6172 6520 6f75 7470 7574 7469 6e67 2074 are outputting t │ │ │ +0020b9c0: 6f20 584d 4c2e 2054 6865 2064 6566 6175 o XML. The defau │ │ │ +0020b9d0: 6c74 2069 7320 3c65 6d70 6861 7369 733e lt is │ │ │ +0020b9e0: 6e6f 3c2f 656d 7068 6173 6973 3e2e 3c2f no... │ │ │ +0020ba10: 3c74 6974 6c65 3e69 6e70 7574 2d78 6d6c input-xml │ │ │ +0020ba20: 3a20 3c65 6d70 6861 7369 733e 626f 6f6c : <emphasis>bool │ │ │ +0020ba30: 3c2f 656d 7068 6173 6973 3e3c 2f74 6974 </emphasis></tit │ │ │ +0020ba40: 6c65 3e0a 0a3c 7061 7261 3e49 6620 7365 le>..<para>If se │ │ │ +0020ba50: 7420 746f 203c 656d 7068 6173 6973 3e79 t to <emphasis>y │ │ │ +0020ba60: 6573 3c2f 656d 7068 6173 6973 3e2c 2054 es</emphasis>, T │ │ │ +0020ba70: 6964 7920 7769 6c6c 2075 7365 2074 6865 idy will use the │ │ │ +0020ba80: 2058 4d4c 2070 6172 7365 7220 7261 7468 XML parser rath │ │ │ +0020ba90: 6572 0a74 6861 6e20 7468 6520 6572 726f er.than the erro │ │ │ +0020baa0: 7220 636f 7272 6563 7469 6e67 2048 544d r correcting HTM │ │ │ +0020bab0: 4c20 7061 7273 6572 2e20 5468 6520 6465 L parser. The de │ │ │ +0020bac0: 6661 756c 7420 6973 0a3c 656d 7068 6173 fault is.<emphas │ │ │ +0020bad0: 6973 3e6e 6f3c 2f65 6d70 6861 7369 733e is>no</emphasis> │ │ │ +0020bae0: 2e3c 2f70 6172 613e 3c2f 666f 726d 616c .</para></formal │ │ │ +0020baf0: 7061 7261 3e0a 0a3c 666f 726d 616c 7061 para>..<formalpa │ │ │ +0020bb00: 7261 3e3c 7469 746c 653e 6f75 7470 7574 ra><title>output │ │ │ +0020bb10: 2d78 6d6c 3a20 3c65 6d70 6861 7369 733e -xml: <emphasis> │ │ │ +0020bb20: 626f 6f6c 3c2f 656d 7068 6173 6973 3e3c bool</emphasis>< │ │ │ +0020bb30: 2f74 6974 6c65 3e0a 0a3c 7061 7261 3e49 /title>..<para>I │ │ │ +0020bb40: 6620 7365 7420 746f 203c 656d 7068 6173 f set to <emphas │ │ │ +0020bb50: 6973 3e79 6573 3c2f 656d 7068 6173 6973 is>yes</emphasis │ │ │ +0020bb60: 3e2c 2054 6964 7920 7769 6c6c 2075 7365 >, Tidy will use │ │ │ +0020bb70: 2067 656e 6572 6174 6520 7468 6520 7072 generate the pr │ │ │ +0020bb80: 6574 7479 0a70 7269 6e74 6564 206f 7574 etty.printed out │ │ │ +0020bb90: 7075 7420 7772 6974 696e 6720 6974 2061 put writing it a │ │ │ +0020bba0: 7320 7765 6c6c 2d66 6f72 6d65 6420 584d s well-formed XM │ │ │ +0020bbb0: 4c2e 2041 6e79 2065 6e74 6974 6965 7320 L. Any entities │ │ │ +0020bbc0: 6e6f 740a 6465 6669 6e65 6420 696e 2058 not.defined in X │ │ │ +0020bbd0: 4d4c 2031 2e30 2077 696c 6c20 6265 2077 ML 1.0 will be w │ │ │ +0020bbe0: 7269 7474 656e 2061 7320 6e75 6d65 7269 ritten as numeri │ │ │ +0020bbf0: 6320 656e 7469 7469 6573 2074 6f20 616c c entities to al │ │ │ +0020bc00: 6c6f 770a 7468 656d 2074 6f20 6265 2070 low.them to be p │ │ │ +0020bc10: 6172 7365 6420 6279 2061 6e20 584d 4c20 arsed by an XML │ │ │ +0020bc20: 7061 7273 6572 2e20 5468 6520 7461 6773 parser. The tags │ │ │ +0020bc30: 2061 6e64 2061 7474 7269 6275 7465 7320 and attributes │ │ │ +0020bc40: 7769 6c6c 0a62 6520 696e 2074 6865 2063 will.be in the c │ │ │ +0020bc50: 6173 6520 7573 6564 2069 6e20 7468 6520 ase used in the │ │ │ +0020bc60: 696e 7075 7420 646f 6375 6d65 6e74 2c20 input document, │ │ │ +0020bc70: 7265 6761 7264 6c65 7373 206f 6620 6f74 regardless of ot │ │ │ +0020bc80: 6865 720a 6f70 7469 6f6e 732e 2054 6865 her.options. The │ │ │ +0020bc90: 2064 6566 6175 6c74 2069 7320 3c65 6d70 default is <emp │ │ │ +0020bca0: 6861 7369 733e 6e6f 3c2f 656d 7068 6173 hasis>no</emphas │ │ │ +0020bcb0: 6973 3e2e 3c2f 7061 7261 3e3c 2f66 6f72 is>.</para></for │ │ │ +0020bcc0: 6d61 6c70 6172 613e 0a0a 3c66 6f72 6d61 malpara>..<forma │ │ │ +0020bcd0: 6c70 6172 613e 3c74 6974 6c65 3e61 6464 lpara><title>add │ │ │ +0020bce0: 2d78 6d6c 2d70 693a 203c 656d 7068 6173 -xml-pi: <emphas │ │ │ +0020bcf0: 6973 3e62 6f6f 6c3c 2f65 6d70 6861 7369 is>bool</emphasi │ │ │ +0020bd00: 733e 2c20 6164 642d 786d 6c2d 6465 636c s>, add-xml-decl │ │ │ +0020bd10: 3a20 3c65 6d70 6861 7369 733e 626f 6f6c : <emphasis>bool │ │ │ +0020bd20: 3c2f 656d 7068 6173 6973 3e3c 2f74 6974 </emphasis></tit │ │ │ +0020bd30: 6c65 3e0a 0a3c 7061 7261 3e49 6620 7365 le>..<para>If se │ │ │ +0020bd40: 7420 746f 203c 656d 7068 6173 6973 3e79 t to <emphasis>y │ │ │ +0020bd50: 6573 3c2f 656d 7068 6173 6973 3e2c 2054 es</emphasis>, T │ │ │ +0020bd60: 6964 7920 7769 6c6c 2061 6464 2074 6865 idy will add the │ │ │ +0020bd70: 2058 4d4c 2064 6563 6c61 7261 7469 6f6e XML declaration │ │ │ +0020bd80: 0a77 6865 6e20 6f75 7470 7574 7469 6e67 .when outputting │ │ │ +0020bd90: 2058 4d4c 206f 7220 5848 544d 4c2e 2054 XML or XHTML. T │ │ │ +0020bda0: 6865 2064 6566 6175 6c74 2069 7320 3c65 he default is <e │ │ │ +0020bdb0: 6d70 6861 7369 733e 6e6f 3c2f 656d 7068 mphasis>no</emph │ │ │ +0020bdc0: 6173 6973 3e2e 204e 6f74 650a 7468 6174 asis>. Note.that │ │ │ +0020bdd0: 2069 6620 7468 6520 696e 7075 7420 646f if the input do │ │ │ +0020bde0: 6375 6d65 6e74 2069 6e63 6c75 6465 7320 cument includes │ │ │ +0020bdf0: 616e 2026 6c74 3b3f 786d 6c3f 2667 743b an <?xml?> │ │ │ +0020be00: 2064 6563 6c61 7261 7469 6f6e 0a74 6865 declaration.the │ │ │ +0020be10: 6e20 6974 2077 696c 6c20 6170 7065 6172 n it will appear │ │ │ +0020be20: 2069 6e20 7468 6520 6f75 7470 7574 2069 in the output i │ │ │ +0020be30: 6e64 6570 656e 6465 6e74 206f 6620 7468 ndependent of th │ │ │ +0020be40: 6520 7661 6c75 6520 6f66 0a74 6869 7320 e value of.this │ │ │ +0020be50: 6f70 7469 6f6e 2e3c 2f70 6172 613e 3c2f option.</para></ │ │ │ +0020be60: 666f 726d 616c 7061 7261 3e0a 0a3c 666f formalpara>..<fo │ │ │ +0020be70: 726d 616c 7061 7261 3e3c 7469 746c 653e rmalpara><title> │ │ │ +0020be80: 6f75 7470 7574 2d78 6874 6d6c 3a20 3c65 output-xhtml: <e │ │ │ +0020be90: 6d70 6861 7369 733e 626f 6f6c 3c2f 656d mphasis>bool</em │ │ │ +0020bea0: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020beb0: 0a3c 7061 7261 3e49 6620 7365 7420 746f .If set to │ │ │ +0020bec0: 203c 656d 7068 6173 6973 3e79 6573 3c2f yes, Tidy │ │ │ +0020bee0: 7769 6c6c 2067 656e 6572 6174 6520 7468 will generate th │ │ │ +0020bef0: 6520 7072 6574 7479 2070 7269 6e74 6564 e pretty printed │ │ │ +0020bf00: 0a6f 7574 7075 7420 7772 6974 696e 6720 .output writing │ │ │ +0020bf10: 6974 2061 7320 6578 7465 6e73 6962 6c65 it as extensible │ │ │ +0020bf20: 2048 544d 4c2e 2054 6865 2064 6566 6175 HTML. The defau │ │ │ +0020bf30: 6c74 2069 7320 3c65 6d70 6861 7369 733e lt is │ │ │ +0020bf40: 6e6f 3c2f 656d 7068 6173 6973 3e2e 0a54 no..T │ │ │ +0020bf50: 6869 7320 6f70 7469 6f6e 2063 6175 7365 his option cause │ │ │ +0020bf60: 7320 5469 6479 2074 6f20 7365 7420 7468 s Tidy to set th │ │ │ +0020bf70: 6520 646f 6374 7970 6520 616e 6420 6465 e doctype and de │ │ │ +0020bf80: 6661 756c 7420 6e61 6d65 7370 6163 650a fault namespace. │ │ │ +0020bf90: 6173 2061 7070 726f 7072 6961 7465 2074 as appropriate t │ │ │ +0020bfa0: 6f20 5848 544d 4c2e 2049 6620 6120 646f o XHTML. If a do │ │ │ +0020bfb0: 6374 7970 6520 6f72 206e 616d 6573 7061 ctype or namespa │ │ │ +0020bfc0: 6365 2069 7320 6769 7665 6e20 7468 6579 ce is given they │ │ │ +0020bfd0: 0a77 696c 6c20 6368 6563 6b65 6420 666f .will checked fo │ │ │ +0020bfe0: 7220 636f 6e73 6973 7465 6e63 7920 7769 r consistency wi │ │ │ +0020bff0: 7468 2074 6865 2063 6f6e 7465 6e74 206f th the content o │ │ │ +0020c000: 6620 7468 6520 646f 6375 6d65 6e74 2e20 f the document. │ │ │ +0020c010: 496e 0a74 6865 2063 6173 6520 6f66 2061 In.the case of a │ │ │ +0020c020: 6e20 696e 636f 6e73 6973 7465 6e63 792c n inconsistency, │ │ │ +0020c030: 2074 6865 2063 6f72 7265 6374 6564 2076 the corrected v │ │ │ +0020c040: 616c 7565 7320 7769 6c6c 2061 7070 6561 alues will appea │ │ │ +0020c050: 7220 696e 0a74 6865 206f 7574 7075 742e r in.the output. │ │ │ +0020c060: 2046 6f72 2058 4854 4d4c 2c20 656e 7469 For XHTML, enti │ │ │ +0020c070: 7469 6573 2063 616e 2062 6520 7772 6974 ties can be writ │ │ │ +0020c080: 7465 6e20 6173 206e 616d 6564 206f 720a ten as named or. │ │ │ +0020c090: 6e75 6d65 7269 6320 656e 7469 7469 6573 numeric entities │ │ │ +0020c0a0: 2061 6363 6f72 6469 6e67 2074 6f20 7468 according to th │ │ │ +0020c0b0: 6520 7661 6c75 6520 6f66 2074 6865 2022 e value of the " │ │ │ +0020c0c0: 6e75 6d65 7269 632d 656e 7469 7469 6573 numeric-entities │ │ │ +0020c0d0: 220a 7072 6f70 6572 7479 2e20 5468 6520 ".property. The │ │ │ +0020c0e0: 7461 6773 2061 6e64 2061 7474 7269 6275 tags and attribu │ │ │ +0020c0f0: 7465 7320 7769 6c6c 2062 6520 6f75 7470 tes will be outp │ │ │ +0020c100: 7574 2069 6e20 7468 6520 6361 7365 2075 ut in the case u │ │ │ +0020c110: 7365 640a 696e 2074 6865 2069 6e70 7574 sed.in the input │ │ │ +0020c120: 2064 6f63 756d 656e 742c 2072 6567 6172 document, regar │ │ │ +0020c130: 646c 6573 7320 6f66 206f 7468 6572 206f dless of other o │ │ │ +0020c140: 7074 696f 6e73 2e3c 2f70 6172 613e 3c2f ptions... │ │ │ +0020c170: 646f 6374 7970 653a 203c 656d 7068 6173 doctype: <emphas │ │ │ +0020c180: 6973 3e6f 6d69 742c 2061 7574 6f2c 2073 is>omit, auto, s │ │ │ +0020c190: 7472 6963 742c 206c 6f6f 7365 3c2f 656d trict, loose</em │ │ │ +0020c1a0: 7068 6173 6973 3e20 6f72 0a26 6c74 3b3c phasis> or.<< │ │ │ +0020c1b0: 656d 7068 6173 6973 3e66 7069 3c2f 656d emphasis>fpi</em │ │ │ +0020c1c0: 7068 6173 6973 3e26 6774 3b3c 2f74 6974 phasis>></tit │ │ │ +0020c1d0: 6c65 3e0a 0a3c 7061 7261 3e54 6869 7320 le>..<para>This │ │ │ +0020c1e0: 7072 6f70 6572 7479 2063 6f6e 7472 6f6c property control │ │ │ +0020c1f0: 7320 7468 6520 646f 6374 7970 6520 6465 s the doctype de │ │ │ +0020c200: 636c 6172 6174 696f 6e20 6765 6e65 7261 claration genera │ │ │ +0020c210: 7465 6420 6279 0a54 6964 792e 2049 6620 ted by.Tidy. If │ │ │ +0020c220: 7365 7420 746f 203c 656d 7068 6173 6973 set to <emphasis │ │ │ +0020c230: 3e6f 6d69 743c 2f65 6d70 6861 7369 733e >omit</emphasis> │ │ │ +0020c240: 2074 6865 206f 7574 7075 7420 6669 6c65 the output file │ │ │ +0020c250: 2077 6f6e 2774 2063 6f6e 7461 696e 2061 won't contain a │ │ │ +0020c260: 0a64 6f63 7479 7065 2064 6563 6c61 7261 .doctype declara │ │ │ +0020c270: 7469 6f6e 2e20 4966 2073 6574 2074 6f20 tion. If set to │ │ │ +0020c280: 3c65 6d70 6861 7369 733e 6175 746f 3c2f <emphasis>auto</ │ │ │ +0020c290: 656d 7068 6173 6973 3e20 2874 6865 2064 emphasis> (the d │ │ │ +0020c2a0: 6566 6175 6c74 2920 5469 6479 0a77 696c efault) Tidy.wil │ │ │ +0020c2b0: 6c20 7573 6520 616e 2065 6475 6361 7465 l use an educate │ │ │ +0020c2c0: 6420 6775 6573 7320 6261 7365 6420 7570 d guess based up │ │ │ +0020c2d0: 6f6e 2074 6865 2063 6f6e 7465 6e74 7320 on the contents │ │ │ +0020c2e0: 6f66 2074 6865 0a64 6f63 756d 656e 742e of the.document. │ │ │ +0020c2f0: 2049 6620 7365 7420 746f 203c 656d 7068 If set to <emph │ │ │ +0020c300: 6173 6973 3e73 7472 6963 743c 2f65 6d70 asis>strict</emp │ │ │ +0020c310: 6861 7369 733e 2c20 5469 6479 2077 696c hasis>, Tidy wil │ │ │ +0020c320: 6c20 7365 7420 7468 6520 646f 6374 7970 l set the doctyp │ │ │ +0020c330: 6520 746f 0a74 6865 2073 7472 6963 7420 e to.the strict │ │ │ +0020c340: 4454 442e 2049 6620 7365 7420 746f 203c DTD. If set to < │ │ │ +0020c350: 656d 7068 6173 6973 3e6c 6f6f 7365 3c2f emphasis>loose</ │ │ │ +0020c360: 656d 7068 6173 6973 3e2c 2074 6865 2064 emphasis>, the d │ │ │ +0020c370: 6f63 7479 7065 2069 7320 7365 7420 746f octype is set to │ │ │ +0020c380: 0a74 6865 206c 6f6f 7365 2028 7472 616e .the loose (tran │ │ │ +0020c390: 7369 7469 6f6e 616c 2920 4454 442e 2041 sitional) DTD. A │ │ │ +0020c3a0: 6c74 6572 6e61 7469 7665 6c79 2c20 796f lternatively, yo │ │ │ +0020c3b0: 7520 6361 6e20 7375 7070 6c79 2061 0a73 u can supply a.s │ │ │ +0020c3c0: 7472 696e 6720 666f 7220 7468 6520 666f tring for the fo │ │ │ +0020c3d0: 726d 616c 2070 7562 6c69 6320 6964 656e rmal public iden │ │ │ +0020c3e0: 7469 6669 6572 2028 6670 6929 2066 6f72 tifier (fpi) for │ │ │ +0020c3f0: 2065 7861 6d70 6c65 3a0a 3c73 6372 6565 example:.<scree │ │ │ +0020c400: 6e3e 0a64 6f63 7479 7065 3a20 222d 2f2f n>.doctype: "-// │ │ │ +0020c410: 4143 4d45 2f2f 4454 4420 4854 4d4c 2033 ACME//DTD HTML 3 │ │ │ +0020c420: 2e31 3431 3539 2f2f 454e 220a 3c2f 7363 .14159//EN".</sc │ │ │ +0020c430: 7265 656e 3e0a 4966 2079 6f75 2073 7065 reen>.If you spe │ │ │ +0020c440: 6369 6679 2074 6865 2066 7069 2066 6f72 cify the fpi for │ │ │ +0020c450: 2061 6e20 5848 544d 4c20 646f 6375 6d65 an XHTML docume │ │ │ +0020c460: 6e74 2c20 5469 6479 2077 696c 6c20 7365 nt, Tidy will se │ │ │ +0020c470: 740a 7468 6520 7379 7374 656d 2069 6465 t.the system ide │ │ │ +0020c480: 6e74 6966 6965 7220 746f 2074 6865 2065 ntifier to the e │ │ │ +0020c490: 6d70 7479 2073 7472 696e 672e 2054 6964 mpty string. Tid │ │ │ +0020c4a0: 7920 6c65 6176 6573 2074 6865 0a64 6f63 y leaves the.doc │ │ │ +0020c4b0: 756d 656e 7420 7479 7065 2066 6f72 2067 ument type for g │ │ │ +0020c4c0: 656e 6572 6963 2058 4d4c 2064 6f63 756d eneric XML docum │ │ │ +0020c4d0: 656e 7473 2075 6e63 6861 6e67 6564 2e3c ents unchanged.< │ │ │ +0020c4e0: 2f70 6172 613e 3c2f 666f 726d 616c 7061 /para></formalpa │ │ │ +0020c4f0: 7261 3e0a 0a3c 666f 726d 616c 7061 7261 ra>..<formalpara │ │ │ +0020c500: 3e3c 7469 746c 653e 6368 6172 2d65 6e63 ><title>char-enc │ │ │ +0020c510: 6f64 696e 673a 203c 656d 7068 6173 6973 oding: <emphasis │ │ │ +0020c520: 3e72 6177 2c20 6173 6369 692c 206c 6174 >raw, ascii, lat │ │ │ +0020c530: 696e 312c 2075 7466 383c 2f65 6d70 6861 in1, utf8</empha │ │ │ +0020c540: 7369 733e 206f 720a 3c65 6d70 6861 7369 sis> or.<emphasi │ │ │ +0020c550: 733e 6973 6f32 3032 323c 2f65 6d70 6861 s>iso2022</empha │ │ │ +0020c560: 7369 733e 3c2f 7469 746c 653e 0a0a 3c70 sis>..

    Determines h │ │ │ +0020c580: 6f77 2054 6964 7920 696e 7465 7270 7265 ow Tidy interpre │ │ │ +0020c590: 7473 2063 6861 7261 6374 6572 2073 7472 ts character str │ │ │ +0020c5a0: 6561 6d73 2e20 466f 720a 3c65 6d70 6861 eams. For.ascii, Tidy will │ │ │ +0020c5d0: 6163 6365 7074 204c 6174 696e 2d31 2063 accept Latin-1 c │ │ │ +0020c5e0: 6861 7261 6374 6572 2076 616c 7565 732c haracter values, │ │ │ +0020c5f0: 2062 7574 0a77 696c 6c20 7573 6520 656e but.will use en │ │ │ +0020c600: 7469 7469 6573 2066 6f72 2061 6c6c 2063 tities for all c │ │ │ +0020c610: 6861 7261 6374 6572 7320 7768 6f73 6520 haracters whose │ │ │ +0020c620: 7661 6c75 6520 2667 743b 2031 3237 2e20 value > 127. │ │ │ +0020c630: 466f 720a 3c65 6d70 6861 7369 733e 7261 For.ra │ │ │ +0020c640: 773c 2f65 6d70 6861 7369 733e 2c20 5469 w, Ti │ │ │ +0020c650: 6479 2077 696c 6c20 6f75 7470 7574 2076 dy will output v │ │ │ +0020c660: 616c 7565 7320 6162 6f76 6520 3132 3720 alues above 127 │ │ │ +0020c670: 7769 7468 6f75 740a 7472 616e 736c 6174 without.translat │ │ │ +0020c680: 696e 6720 7468 656d 2069 6e74 6f20 656e ing them into en │ │ │ +0020c690: 7469 7469 6573 2e20 466f 7220 3c65 6d70 tities. For latin1 characte │ │ │ +0020c6c0: 7273 0a61 626f 7665 2032 3535 2077 696c rs.above 255 wil │ │ │ +0020c6d0: 6c20 6265 2077 7269 7474 656e 2061 7320 l be written as │ │ │ +0020c6e0: 656e 7469 7469 6573 2e20 466f 7220 3c65 entities. For utf8, Tidy.as │ │ │ +0020c710: 7375 6d65 7320 7468 6174 2062 6f74 6820 sumes that both │ │ │ +0020c720: 696e 7075 7420 616e 6420 6f75 7470 7574 input and output │ │ │ +0020c730: 2069 7320 656e 636f 6465 6420 6173 2055 is encoded as U │ │ │ +0020c740: 5446 2d38 2e20 596f 7520 6361 6e0a 7573 TF-8. You can.us │ │ │ +0020c750: 6520 3c65 6d70 6861 7369 733e 6973 6f32 e iso2 │ │ │ +0020c760: 3032 323c 2f65 6d70 6861 7369 733e 2066 022 f │ │ │ +0020c770: 6f72 2066 696c 6573 2065 6e63 6f64 6564 or files encoded │ │ │ +0020c780: 2075 7369 6e67 2074 6865 2049 534f 3230 using the ISO20 │ │ │ +0020c790: 3232 2066 616d 696c 790a 6f66 2065 6e63 22 family.of enc │ │ │ +0020c7a0: 6f64 696e 6773 2065 2e67 2e20 4953 4f20 odings e.g. ISO │ │ │ +0020c7b0: 3230 3232 2d4a 502e 2054 6865 2064 6566 2022-JP. The def │ │ │ +0020c7c0: 6175 6c74 2069 730a 3c65 6d70 6861 7369 ault is.ascii...nume │ │ │ +0020c810: 7269 632d 656e 7469 7469 6573 3a20 3c65 ric-entities: <e │ │ │ +0020c820: 6d70 6861 7369 733e 626f 6f6c 3c2f 656d mphasis>bool</em │ │ │ +0020c830: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020c840: 0a3c 7061 7261 3e43 6175 7365 7320 656e .Causes en │ │ │ +0020c850: 7469 7469 6573 206f 7468 6572 2074 6861 tities other tha │ │ │ +0020c860: 6e20 7468 6520 6261 7369 6320 584d 4c20 n the basic XML │ │ │ +0020c870: 312e 3020 6e61 6d65 6420 656e 7469 7469 1.0 named entiti │ │ │ +0020c880: 6573 0a74 6f20 6265 2077 7269 7474 656e es.to be written │ │ │ +0020c890: 2069 6e20 7468 6520 6e75 6d65 7269 6320 in the numeric │ │ │ +0020c8a0: 7261 7468 6572 2074 6861 6e20 7468 6520 rather than the │ │ │ +0020c8b0: 6e61 6d65 6420 656e 7469 7479 2066 6f72 named entity for │ │ │ +0020c8c0: 6d2e 0a54 6865 2064 6566 6175 6c74 2069 m..The default i │ │ │ +0020c8d0: 7320 3c65 6d70 6861 7369 733e 6e6f 3c2f s no │ │ │ +0020c8f0: 3c2f 666f 726d 616c 7061 7261 3e0a 0a3c ..< │ │ │ +0020c900: 666f 726d 616c 7061 7261 3e3c 7469 746c formalpara>quote-marks: < │ │ │ +0020c920: 656d 7068 6173 6973 3e62 6f6f 6c3c 2f65 emphasis>bool │ │ │ +0020c940: 0a0a 3c70 6172 613e 4966 2073 6574 2074 ..If set t │ │ │ +0020c950: 6f20 3c65 6d70 6861 7369 733e 7965 733c o yes< │ │ │ +0020c960: 2f65 6d70 6861 7369 733e 2c20 7468 6973 /emphasis>, this │ │ │ +0020c970: 2063 6175 7365 7320 2220 6368 6172 6163 causes " charac │ │ │ +0020c980: 7465 7273 2074 6f20 6265 0a77 7269 7474 ters to be.writt │ │ │ +0020c990: 656e 206f 7574 2061 7320 2661 6d70 3b71 en out as &q │ │ │ +0020c9a0: 756f 743b 2061 7320 6973 2070 7265 6665 uot; as is prefe │ │ │ +0020c9b0: 7272 6564 2062 7920 736f 6d65 2065 6469 rred by some edi │ │ │ +0020c9c0: 7469 6e67 0a65 6e76 6972 6f6e 6d65 6e74 ting.environment │ │ │ +0020c9d0: 732e 2054 6865 2061 706f 7374 726f 7068 s. The apostroph │ │ │ +0020c9e0: 6520 6368 6172 6163 7465 7220 2720 6973 e character ' is │ │ │ +0020c9f0: 2077 7269 7474 656e 206f 7574 2061 730a written out as. │ │ │ +0020ca00: 2661 6d70 3b23 3339 3b20 7369 6e63 6520 &#39; since │ │ │ +0020ca10: 6d61 6e79 2077 6562 2062 726f 7773 6572 many web browser │ │ │ +0020ca20: 7320 646f 6e27 7420 7965 7420 7375 7070 s don't yet supp │ │ │ +0020ca30: 6f72 7420 2661 6d70 3b61 706f 733b 2e0a ort &apos;.. │ │ │ +0020ca40: 5468 6520 6465 6661 756c 7420 6973 203c The default is < │ │ │ +0020ca50: 656d 7068 6173 6973 3e6e 6f3c 2f65 6d70 emphasis>no... │ │ │ +0020ca90: 7175 6f74 652d 6e62 7370 3a20 3c65 6d70 quote-nbsp: <emp │ │ │ +0020caa0: 6861 7369 733e 626f 6f6c 3c2f 656d 7068 hasis>bool</emph │ │ │ +0020cab0: 6173 6973 3e3c 2f74 6974 6c65 3e0a 0a3c asis>..< │ │ │ +0020cac0: 7061 7261 3e49 6620 7365 7420 746f 203c para>If set to < │ │ │ +0020cad0: 656d 7068 6173 6973 3e79 6573 3c2f 656d emphasis>yes, this ca │ │ │ +0020caf0: 7573 6573 206e 6f6e 2d62 7265 616b 696e uses non-breakin │ │ │ +0020cb00: 6720 7370 6163 650a 6368 6172 6163 7465 g space.characte │ │ │ +0020cb10: 7273 2074 6f20 6265 2077 7269 7474 656e rs to be written │ │ │ +0020cb20: 206f 7574 2061 7320 656e 7469 7469 6573 out as entities │ │ │ +0020cb30: 2c20 7261 7468 6572 2074 6861 6e20 6173 , rather than as │ │ │ +0020cb40: 2074 6865 0a55 6e69 636f 6465 2063 6861 the.Unicode cha │ │ │ +0020cb50: 7261 6374 6572 2076 616c 7565 2031 3630 racter value 160 │ │ │ +0020cb60: 2028 6465 6369 6d61 6c29 2e20 5468 6520 (decimal). The │ │ │ +0020cb70: 6465 6661 756c 7420 6973 0a3c 656d 7068 default is.yes...quo │ │ │ +0020cbc0: 7465 2d61 6d70 6572 7361 6e64 3a20 3c65 te-ampersand: <e │ │ │ +0020cbd0: 6d70 6861 7369 733e 626f 6f6c 3c2f 656d mphasis>bool</em │ │ │ +0020cbe0: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020cbf0: 0a3c 7061 7261 3e49 6620 7365 7420 746f .If set to │ │ │ +0020cc00: 203c 656d 7068 6173 6973 3e79 6573 3c2f yes, this │ │ │ +0020cc20: 6361 7573 6573 2075 6e61 646f 726e 6564 causes unadorned │ │ │ +0020cc30: 2026 616d 703b 0a63 6861 7261 6374 6572 &.character │ │ │ +0020cc40: 7320 746f 2062 6520 7772 6974 7465 6e20 s to be written │ │ │ +0020cc50: 6f75 7420 6173 2026 616d 703b 616d 703b out as &amp; │ │ │ +0020cc60: 2e20 5468 6520 6465 6661 756c 7420 6973 . The default is │ │ │ +0020cc70: 0a3c 656d 7068 6173 6973 3e79 6573 3c2f .yes... │ │ │ +0020cca0: 3c66 6f72 6d61 6c70 6172 613e 3c74 6974 assume-xml-pr │ │ │ +0020ccc0: 6f63 696e 733a 203c 656d 7068 6173 6973 ocins: bool │ │ │ +0020cce0: 3c2f 7469 746c 653e 0a0a 3c70 6172 613e .. │ │ │ +0020ccf0: 4966 2073 6574 2074 6f20 3c65 6d70 6861 If set to yes, this changes │ │ │ +0020cd20: 2074 6865 2070 6172 7369 6e67 206f 660a the parsing of. │ │ │ +0020cd30: 7072 6f63 6573 7369 6e67 2069 6e73 7472 processing instr │ │ │ +0020cd40: 7563 7469 6f6e 7320 746f 2072 6571 7569 uctions to requi │ │ │ +0020cd50: 7265 203f 2667 743b 2061 7320 7468 6520 re ?> as the │ │ │ +0020cd60: 7465 726d 696e 6174 6f72 2072 6174 6865 terminator rathe │ │ │ +0020cd70: 720a 7468 616e 2026 6774 3b2e 2054 6865 r.than >. The │ │ │ +0020cd80: 2064 6566 6175 6c74 2069 7320 3c65 6d70 default is no. This option │ │ │ +0020cdb0: 2069 730a 6175 746f 6d61 7469 6361 6c6c is.automaticall │ │ │ +0020cdc0: 7920 7365 7420 6966 2074 6865 2069 6e70 y set if the inp │ │ │ +0020cdd0: 7574 2069 7320 696e 2058 4d4c 2e3c 2f70 ut is in XML.

    ..< │ │ │ +0020ce00: 7469 746c 653e 6669 782d 6261 636b 736c title>fix-backsl │ │ │ +0020ce10: 6173 683a 203c 656d 7068 6173 6973 3e62 ash: b │ │ │ +0020ce20: 6f6f 6c3c 2f65 6d70 6861 7369 733e 3c2f ool..If │ │ │ +0020ce40: 2073 6574 2074 6f20 3c65 6d70 6861 7369 set to yes │ │ │ +0020ce60: 2c20 7468 6973 2063 6175 7365 7320 6261 , this causes ba │ │ │ +0020ce70: 636b 736c 6173 6820 6368 6172 6163 7465 ckslash characte │ │ │ +0020ce80: 7273 2022 5c22 0a69 6e20 5552 4c73 2074 rs "\".in URLs t │ │ │ +0020ce90: 6f20 6265 2072 6570 6c61 6365 6420 6279 o be replaced by │ │ │ +0020cea0: 2066 6f72 7761 7264 2073 6c61 7368 6573 forward slashes │ │ │ +0020ceb0: 2022 2f22 2e20 5468 6520 6465 6661 756c "/". The defaul │ │ │ +0020cec0: 7420 6973 0a3c 656d 7068 6173 6973 3e79 t is.y │ │ │ +0020ced0: 6573 3c2f 656d 7068 6173 6973 3e2e 3c2f es... │ │ │ +0020cf00: 3c74 6974 6c65 3e62 7265 616b 2d62 6566 break-bef │ │ │ +0020cf10: 6f72 652d 6272 3a20 3c65 6d70 6861 7369 ore-br: <emphasi │ │ │ +0020cf20: 733e 626f 6f6c 3c2f 656d 7068 6173 6973 s>bool</emphasis │ │ │ +0020cf30: 3e3c 2f74 6974 6c65 3e0a 0a3c 7061 7261 >..If set to yes, Tidy will o │ │ │ +0020cf70: 7574 7075 7420 6120 6c69 6e65 2062 7265 utput a line bre │ │ │ +0020cf80: 616b 2062 6566 6f72 650a 6561 6368 2026 ak before.each & │ │ │ +0020cf90: 6c74 3b62 7226 6774 3b20 656c 656d 656e lt;br> elemen │ │ │ +0020cfa0: 742e 2054 6865 2064 6566 6175 6c74 2069 t. The default i │ │ │ +0020cfb0: 7320 3c65 6d70 6861 7369 733e 6e6f 3c2f s no... │ │ │ +0020cfe0: 3c66 6f72 6d61 6c70 6172 613e 3c74 6974 uppercase-tag │ │ │ +0020d000: 733a 203c 656d 7068 6173 6973 3e62 6f6f s: boo │ │ │ +0020d010: 6c3c 2f65 6d70 6861 7369 733e 3c2f 7469 l..Caus │ │ │ +0020d030: 6573 2074 6167 206e 616d 6573 2074 6f20 es tag names to │ │ │ +0020d040: 6265 206f 7574 7075 7420 696e 2075 7070 be output in upp │ │ │ +0020d050: 6572 2063 6173 652e 2054 6865 2064 6566 er case. The def │ │ │ +0020d060: 6175 6c74 2069 730a 3c65 6d70 6861 7369 ault is.no │ │ │ +0020d080: 7265 7375 6c74 696e 6720 696e 206c 6f77 resulting in low │ │ │ +0020d090: 6572 6361 7365 2c20 6578 6365 7074 2066 ercase, except f │ │ │ +0020d0a0: 6f72 2058 4d4c 2069 6e70 7574 2077 6865 or XML input whe │ │ │ +0020d0b0: 7265 0a74 6865 206f 7269 6769 6e61 6c20 re.the original │ │ │ +0020d0c0: 6361 7365 2069 7320 7072 6573 6572 7665 case is preserve │ │ │ +0020d0d0: 642e 3c2f 7061 7261 3e3c 2f66 6f72 6d61 d.
    ..upper │ │ │ +0020d100: 6361 7365 2d61 7474 7269 6275 7465 733a case-attributes: │ │ │ +0020d110: 203c 656d 7068 6173 6973 3e62 6f6f 6c3c <emphasis>bool< │ │ │ +0020d120: 2f65 6d70 6861 7369 733e 3c2f 7469 746c /emphasis></titl │ │ │ +0020d130: 653e 0a0a 3c70 6172 613e 4966 2073 6574 e>..<para>If set │ │ │ +0020d140: 2074 6f20 3c65 6d70 6861 7369 733e 7965 to <emphasis>ye │ │ │ +0020d150: 733c 2f65 6d70 6861 7369 733e 2061 7474 s</emphasis> att │ │ │ +0020d160: 7269 6275 7465 206e 616d 6573 2061 7265 ribute names are │ │ │ +0020d170: 206f 7574 7075 7420 696e 2075 7070 6572 output in upper │ │ │ +0020d180: 0a63 6173 652e 2054 6865 2064 6566 6175 .case. The defau │ │ │ +0020d190: 6c74 2069 7320 3c65 6d70 6861 7369 733e lt is <emphasis> │ │ │ +0020d1a0: 6e6f 3c2f 656d 7068 6173 6973 3e20 7265 no</emphasis> re │ │ │ +0020d1b0: 7375 6c74 696e 6720 696e 206c 6f77 6572 sulting in lower │ │ │ +0020d1c0: 6361 7365 2c20 6578 6365 7074 0a66 6f72 case, except.for │ │ │ +0020d1d0: 2058 4d4c 2077 6865 7265 2074 6865 206f XML where the o │ │ │ +0020d1e0: 7269 6769 6e61 6c20 6361 7365 2069 7320 riginal case is │ │ │ +0020d1f0: 7072 6573 6572 7665 642e 3c2f 7061 7261 preserved.</para │ │ │ +0020d200: 3e3c 2f66 6f72 6d61 6c70 6172 613e 0a0a ></formalpara>.. │ │ │ +0020d210: 3c66 6f72 6d61 6c70 6172 613e 3c74 6974 <formalpara><tit │ │ │ +0020d220: 6c65 3e77 6f72 642d 3230 3030 3a20 3c65 le>word-2000: <e │ │ │ +0020d230: 6d70 6861 7369 733e 626f 6f6c 3c2f 656d mphasis>bool</em │ │ │ +0020d240: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020d250: 0a3c 7061 7261 3e49 6620 7365 7420 746f .If set to │ │ │ +0020d260: 203c 656d 7068 6173 6973 3e79 6573 3c2f yes, Tidy │ │ │ +0020d280: 7769 6c6c 2067 6f20 746f 2067 7265 6174 will go to great │ │ │ +0020d290: 2070 6169 6e73 2074 6f20 7374 7269 700a pains to strip. │ │ │ +0020d2a0: 6f75 7420 616c 6c20 7468 6520 7375 7270 out all the surp │ │ │ +0020d2b0: 6c75 7320 7374 7566 6620 4d69 6372 6f73 lus stuff Micros │ │ │ +0020d2c0: 6f66 7420 576f 7264 2032 3030 3020 696e oft Word 2000 in │ │ │ +0020d2d0: 7365 7274 7320 7768 656e 2079 6f75 0a73 serts when you.s │ │ │ +0020d2e0: 6176 6520 576f 7264 2064 6f63 756d 656e ave Word documen │ │ │ +0020d2f0: 7473 2061 7320 2257 6562 2070 6167 6573 ts as "Web pages │ │ │ +0020d300: 222e 2054 6865 2064 6566 6175 6c74 2069 ". The default i │ │ │ +0020d310: 7320 3c65 6d70 6861 7369 733e 6e6f 3c2f s no..Note │ │ │ +0020d330: 7468 6174 2054 6964 7920 646f 6573 6e27 that Tidy doesn' │ │ │ +0020d340: 7420 7965 7420 6b6e 6f77 2077 6861 7420 t yet know what │ │ │ +0020d350: 746f 2064 6f20 7769 7468 2056 4d4c 206d to do with VML m │ │ │ +0020d360: 6172 6b75 7020 6672 6f6d 0a57 6f72 642c arkup from.Word, │ │ │ +0020d370: 2062 7574 2069 6e20 6675 7475 7265 2049 but in future I │ │ │ +0020d380: 2068 6f70 6520 746f 2062 6520 6162 6c65 hope to be able │ │ │ +0020d390: 2074 6f20 6d61 7020 564d 4c20 746f 2053 to map VML to S │ │ │ +0020d3a0: 5647 2e3c 2f70 6172 613e 0a3c 7061 7261 VG... Microsoft has │ │ │ +0020d3c0: 2064 6576 656c 6f70 6564 2069 7473 206f developed its o │ │ │ +0020d3d0: 776e 206f 7074 696f 6e61 6c20 6669 6c74 wn optional filt │ │ │ +0020d3e0: 6572 2066 6f72 2065 7870 6f72 7469 6e67 er for exporting │ │ │ +0020d3f0: 2074 6f0a 4854 4d4c 2c20 616e 6420 7468 to.HTML, and th │ │ │ +0020d400: 6520 322e 3020 7665 7273 696f 6e20 6973 e 2.0 version is │ │ │ +0020d410: 206d 7563 6820 696d 7072 6f76 6564 2e20 much improved. │ │ │ +0020d420: 596f 7520 6361 6e20 646f 776e 6c6f 6164 You can download │ │ │ +0020d430: 2074 6865 0a66 696c 7465 7220 6672 6565 the.filter free │ │ │ +0020d440: 2066 726f 6d20 7468 6520 3c75 6c69 6e6b from the .Micr │ │ │ +0020d4a0: 6f73 6f66 7420 4f66 6669 6365 2055 7064 osoft Office Upd │ │ │ +0020d4b0: 6174 6520 7369 7465 3c2f 756c 696e 6b3e ate site │ │ │ +0020d4c0: 2e3c 2f70 6172 613e 3c2f 666f 726d 616c ...clean: │ │ │ +0020d4f0: 203c 656d 7068 6173 6973 3e62 6f6f 6c3c <emphasis>bool< │ │ │ +0020d500: 2f65 6d70 6861 7369 733e 3c2f 7469 746c /emphasis></titl │ │ │ +0020d510: 653e 0a0a 3c70 6172 613e 4966 2073 6574 e>..<para>If set │ │ │ +0020d520: 2074 6f20 3c65 6d70 6861 7369 733e 7965 to <emphasis>ye │ │ │ +0020d530: 733c 2f65 6d70 6861 7369 733e 2c20 6361 s</emphasis>, ca │ │ │ +0020d540: 7573 6573 2054 6964 7920 746f 2073 7472 uses Tidy to str │ │ │ +0020d550: 6970 206f 7574 2073 7572 706c 7573 0a70 ip out surplus.p │ │ │ +0020d560: 7265 7365 6e74 6174 696f 6e61 6c20 7461 resentational ta │ │ │ +0020d570: 6773 2061 6e64 2061 7474 7269 6275 7465 gs and attribute │ │ │ +0020d580: 7320 7265 706c 6163 696e 6720 7468 656d s replacing them │ │ │ +0020d590: 2062 7920 7374 796c 6520 7275 6c65 730a by style rules. │ │ │ +0020d5a0: 616e 6420 7374 7275 6374 7572 616c 206d and structural m │ │ │ +0020d5b0: 6172 6b75 7020 6173 2061 7070 726f 7072 arkup as appropr │ │ │ +0020d5c0: 6961 7465 2e20 4974 2077 6f72 6b73 2077 iate. It works w │ │ │ +0020d5d0: 656c 6c20 6f6e 2074 6865 2068 746d 6c0a ell on the html. │ │ │ +0020d5e0: 7361 7665 6420 6672 6f6d 204d 6963 726f saved from Micro │ │ │ +0020d5f0: 736f 6674 204f 6666 6963 6527 3937 2e20 soft Office'97. │ │ │ +0020d600: 5468 6520 6465 6661 756c 7420 6973 203c The default is < │ │ │ +0020d610: 656d 7068 6173 6973 3e6e 6f3c 2f65 6d70 emphasis>no</emp │ │ │ +0020d620: 6861 7369 733e 2e3c 2f70 6172 613e 3c2f hasis>.</para></ │ │ │ +0020d630: 666f 726d 616c 7061 7261 3e0a 0a3c 666f formalpara>..<fo │ │ │ +0020d640: 726d 616c 7061 7261 3e3c 7469 746c 653e rmalpara><title> │ │ │ +0020d650: 6c6f 6769 6361 6c2d 656d 7068 6173 6973 logical-emphasis │ │ │ +0020d660: 3a20 3c65 6d70 6861 7369 733e 626f 6f6c : <emphasis>bool │ │ │ +0020d670: 3c2f 656d 7068 6173 6973 3e3c 2f74 6974 </emphasis></tit │ │ │ +0020d680: 6c65 3e0a 0a3c 7061 7261 3e49 6620 7365 le>..<para>If se │ │ │ +0020d690: 7420 746f 203c 656d 7068 6173 6973 3e79 t to <emphasis>y │ │ │ +0020d6a0: 6573 3c2f 656d 7068 6173 6973 3e2c 2063 es</emphasis>, c │ │ │ +0020d6b0: 6175 7365 7320 5469 6479 2074 6f20 7265 auses Tidy to re │ │ │ +0020d6c0: 706c 6163 6520 616e 7920 6f63 6375 7272 place any occurr │ │ │ +0020d6d0: 656e 6365 0a6f 6620 6920 6279 2065 6d20 ence.of i by em │ │ │ +0020d6e0: 616e 6420 616e 7920 6f63 6375 7272 656e and any occurren │ │ │ +0020d6f0: 6365 206f 6620 6220 6279 2073 7472 6f6e ce of b by stron │ │ │ +0020d700: 672e 2049 6e20 626f 7468 2063 6173 6573 g. In both cases │ │ │ +0020d710: 2c20 7468 650a 6174 7472 6962 7574 6573 , the.attributes │ │ │ +0020d720: 2061 7265 2070 7265 7365 7276 6564 2075 are preserved u │ │ │ +0020d730: 6e63 6861 6e67 6564 2e20 5468 6520 6465 nchanged. The de │ │ │ +0020d740: 6661 756c 7420 6973 203c 656d 7068 6173 fault is <emphas │ │ │ +0020d750: 6973 3e6e 6f3c 2f65 6d70 6861 7369 733e is>no</emphasis> │ │ │ +0020d760: 2e0a 5468 6973 206f 7074 696f 6e20 6361 ..This option ca │ │ │ +0020d770: 6e20 6e6f 7720 6265 2073 6574 2069 6e64 n now be set ind │ │ │ +0020d780: 6570 656e 6465 6e74 6c79 206f 6620 7468 ependently of th │ │ │ +0020d790: 6520 636c 6561 6e20 616e 640a 6472 6f70 e clean and.drop │ │ │ +0020d7a0: 2d66 6f6e 742d 7461 6773 206f 7074 696f -font-tags optio │ │ │ +0020d7b0: 6e73 2e3c 2f70 6172 613e 3c2f 666f 726d ns.</para></form │ │ │ +0020d7c0: 616c 7061 7261 3e0a 0a3c 666f 726d 616c alpara>..<formal │ │ │ +0020d7d0: 7061 7261 3e3c 7469 746c 653e 6472 6f70 para><title>drop │ │ │ +0020d7e0: 2d65 6d70 7479 2d70 6172 6173 3a20 3c65 -empty-paras: <e │ │ │ +0020d7f0: 6d70 6861 7369 733e 626f 6f6c 3c2f 656d mphasis>bool</em │ │ │ +0020d800: 7068 6173 6973 3e3c 2f74 6974 6c65 3e0a phasis>. │ │ │ +0020d810: 0a3c 7061 7261 3e49 6620 7365 7420 746f .If set to │ │ │ +0020d820: 203c 656d 7068 6173 6973 3e79 6573 3c2f yes, empty │ │ │ +0020d840: 2070 6172 6167 7261 7068 7320 7769 6c6c paragraphs will │ │ │ +0020d850: 2062 6520 6469 7363 6172 6465 642e 0a49 be discarded..I │ │ │ +0020d860: 6620 7365 7420 746f 206e 6f2c 2065 6d70 f set to no, emp │ │ │ +0020d870: 7479 2070 6172 6167 7261 7068 7320 6172 ty paragraphs ar │ │ │ +0020d880: 6520 7265 706c 6163 6564 2062 7920 6120 e replaced by a │ │ │ +0020d890: 7061 6972 206f 660a 266c 743b 6272 2667 pair of.<br&g │ │ │ +0020d8a0: 743b 2065 6c65 6d65 6e74 7320 6173 2048 t; elements as H │ │ │ +0020d8b0: 544d 4c34 2070 7265 636c 7564 6573 2065 TML4 precludes e │ │ │ +0020d8c0: 6d70 7479 2070 6172 6167 7261 7068 732e mpty paragraphs. │ │ │ +0020d8d0: 2054 6865 0a64 6566 6175 6c74 2069 7320 The.default is │ │ │ +0020d8e0: 3c65 6d70 6861 7369 733e 7965 733c 2f65 yes
    . │ │ │ +0020d900: 3c2f 666f 726d 616c 7061 7261 3e0a 0a3c ..< │ │ │ +0020d910: 666f 726d 616c 7061 7261 3e3c 7469 746c formalpara>drop-font-tags │ │ │ +0020d930: 3a20 3c65 6d70 6861 7369 733e 626f 6f6c : bool │ │ │ +0020d940: 3c2f 656d 7068 6173 6973 3e3c 2f74 6974 ..If se │ │ │ +0020d960: 7420 746f 203c 656d 7068 6173 6973 3e79 t to y │ │ │ +0020d970: 6573 3c2f 656d 7068 6173 6973 3e20 746f es to │ │ │ +0020d980: 6765 7468 6572 2077 6974 6820 7468 6520 gether with the │ │ │ +0020d990: 636c 6561 6e20 6f70 7469 6f6e 2028 7365 clean option (se │ │ │ +0020d9a0: 650a 6162 6f76 6529 2c20 5469 6479 2077 e.above), Tidy w │ │ │ +0020d9b0: 696c 6c20 6469 7363 6172 6420 666f 6e74 ill discard font │ │ │ +0020d9c0: 2061 6e64 2063 656e 7465 7220 7461 6773 and center tags │ │ │ +0020d9d0: 2072 6174 6865 7220 7468 616e 0a63 7265 rather than.cre │ │ │ +0020d9e0: 6174 696e 6720 7468 6520 636f 7272 6573 ating the corres │ │ │ +0020d9f0: 706f 6e64 696e 6720 7374 796c 6520 7275 ponding style ru │ │ │ +0020da00: 6c65 732e 2054 6865 2064 6566 6175 6c74 les. The default │ │ │ +0020da10: 2069 730a 3c65 6d70 6861 7369 733e 6e6f is.no │ │ │ +0020da20: 3c2f 656d 7068 6173 6973 3e2e 3c2f 7061 . │ │ │ +0020da40: 0a0a 3c66 6f72 6d61 6c70 6172 613e 3c74 ..enclose-tex │ │ │ +0020da60: 743a 203c 656d 7068 6173 6973 3e62 6f6f t: boo │ │ │ +0020da70: 6c3c 2f65 6d70 6861 7369 733e 3c2f 7469 l..If s │ │ │ +0020da90: 6574 2074 6f20 3c65 6d70 6861 7369 733e et to │ │ │ +0020daa0: 7965 733c 2f65 6d70 6861 7369 733e 2c20 yes, │ │ │ +0020dab0: 7468 6973 2063 6175 7365 7320 5469 6479 this causes Tidy │ │ │ +0020dac0: 2074 6f20 656e 636c 6f73 6520 616e 7920 to enclose any │ │ │ +0020dad0: 7465 7874 0a69 7420 6669 6e64 7320 696e text.it finds in │ │ │ +0020dae0: 2074 6865 2062 6f64 7920 656c 656d 656e the body elemen │ │ │ +0020daf0: 7420 7769 7468 696e 2061 2070 2065 6c65 t within a p ele │ │ │ +0020db00: 6d65 6e74 2e20 5468 6973 2069 7320 7573 ment. This is us │ │ │ +0020db10: 6566 756c 0a77 6865 6e20 796f 7520 7761 eful.when you wa │ │ │ +0020db20: 6e74 2074 6f20 7461 6b65 2061 6e20 6578 nt to take an ex │ │ │ +0020db30: 6973 7469 6e67 2068 746d 6c20 6669 6c65 isting html file │ │ │ +0020db40: 2061 6e64 2075 7365 2069 7420 7769 7468 and use it with │ │ │ +0020db50: 2061 0a73 7479 6c65 2073 6865 6574 2e20 a.style sheet. │ │ │ +0020db60: 416e 7920 7465 7874 2061 7420 7468 6520 Any text at the │ │ │ +0020db70: 626f 6479 206c 6576 656c 2077 696c 6c20 body level will │ │ │ +0020db80: 7363 7265 7720 7570 2074 6865 0a6d 6172 screw up the.mar │ │ │ +0020db90: 6769 6e73 2c20 6275 7420 7772 6170 2074 gins, but wrap t │ │ │ +0020dba0: 6865 2074 6578 7420 7769 7468 696e 2061 he text within a │ │ │ +0020dbb0: 2070 2065 6c65 6d65 6e74 2061 6e64 2061 p element and a │ │ │ +0020dbc0: 6c6c 2069 7320 7765 6c6c 210a 5468 6520 ll is well!.The │ │ │ +0020dbd0: 6465 6661 756c 7420 6973 203c 656d 7068 default is no...encl │ │ │ +0020dc20: 6f73 652d 626c 6f63 6b2d 7465 7874 3a20 ose-block-text: │ │ │ +0020dc30: 3c65 6d70 6861 7369 733e 626f 6f6c 3c2f <emphasis>bool</ │ │ │ +0020dc40: 656d 7068 6173 6973 3e3c 2f74 6974 6c65 emphasis>..If set │ │ │ +0020dc60: 746f 203c 656d 7068 6173 6973 3e79 6573 to yes │ │ │ +0020dc70: 3c2f 656d 7068 6173 6973 3e2c 2074 6869 , thi │ │ │ +0020dc80: 7320 6361 7573 6573 2054 6964 7920 746f s causes Tidy to │ │ │ +0020dc90: 2069 6e73 6572 7420 6120 700a 656c 656d insert a p.elem │ │ │ +0020dca0: 656e 7420 746f 2065 6e63 6c6f 7365 2061 ent to enclose a │ │ │ +0020dcb0: 6e79 2074 6578 7420 6974 2066 696e 6473 ny text it finds │ │ │ +0020dcc0: 2069 6e20 616e 7920 656c 656d 656e 7420 in any element │ │ │ +0020dcd0: 7468 6174 2061 6c6c 6f77 730a 6d69 7865 that allows.mixe │ │ │ +0020dce0: 6420 636f 6e74 656e 7420 666f 7220 4854 d content for HT │ │ │ +0020dcf0: 4d4c 2074 7261 6e73 6974 696f 6e61 6c20 ML transitional │ │ │ +0020dd00: 6275 7420 6e6f 7420 4854 4d4c 2073 7472 but not HTML str │ │ │ +0020dd10: 6963 742e 2054 6865 0a64 6566 6175 6c74 ict. The.default │ │ │ +0020dd20: 2069 7320 3c65 6d70 6861 7369 733e 6e6f is no │ │ │ +0020dd30: 3c2f 656d 7068 6173 6973 3e2e 3c2f 7061 . │ │ │ +0020dd50: 0a0a 3c66 6f72 6d61 6c70 6172 613e 3c74 ..fix-bad-com │ │ │ +0020dd70: 6d65 6e74 733a 203c 656d 7068 6173 6973 ments: bool │ │ │ +0020dd90: 3c2f 7469 746c 653e 0a0a 3c70 6172 613e .. │ │ │ +0020dda0: 4966 2073 6574 2074 6f20 3c65 6d70 6861 If set to yes, this causes │ │ │ +0020ddd0: 5469 6479 2074 6f20 7265 706c 6163 650a Tidy to replace. │ │ │ +0020dde0: 756e 6578 7065 6374 6564 2068 7970 6865 unexpected hyphe │ │ │ +0020ddf0: 6e73 2077 6974 6820 223d 2220 6368 6172 ns with "=" char │ │ │ +0020de00: 6163 7465 7273 2077 6865 6e20 6974 2063 acters when it c │ │ │ +0020de10: 6f6d 6573 2061 6372 6f73 730a 6164 6a61 omes across.adja │ │ │ +0020de20: 6365 6e74 2068 7970 6865 6e73 2e20 5468 cent hyphens. Th │ │ │ +0020de30: 6520 6465 6661 756c 7420 6973 203c 656d e default is yes
    . This opti │ │ │ +0020de60: 6f6e 2069 730a 7072 6f76 6964 6564 2066 on is.provided f │ │ │ +0020de70: 6f72 2075 7365 7273 206f 6620 436f 6c64 or users of Cold │ │ │ +0020de80: 2046 7573 696f 6e20 7768 6963 6820 7573 Fusion which us │ │ │ +0020de90: 6573 2074 6865 2063 6f6d 6d65 6e74 2073 es the comment s │ │ │ +0020dea0: 796e 7461 783a 0a26 6c74 3b21 2d2d 2d26 yntax:.<!---& │ │ │ +0020deb0: 2331 3630 3b2d 2d2d 2667 743b 3c2f 7061 #160;---> │ │ │ +0020ded0: 0a0a 3c66 6f72 6d61 6c70 6172 613e 3c74 ..add-xml-spa │ │ │ +0020def0: 6365 3a20 3c65 6d70 6861 7369 733e 626f ce: bo │ │ │ +0020df00: 6f6c 3c2f 656d 7068 6173 6973 3e3c 2f74 ol..If │ │ │ +0020df20: 7365 7420 746f 203c 656d 7068 6173 6973 set to yes, │ │ │ +0020df40: 2074 6869 7320 6361 7573 6573 2054 6964 this causes Tid │ │ │ +0020df50: 7920 746f 2061 6464 0a78 6d6c 3a73 7061 y to add.xml:spa │ │ │ +0020df60: 6365 3d22 7072 6573 6572 7665 2220 746f ce="preserve" to │ │ │ +0020df70: 2065 6c65 6d65 6e74 7320 7375 6368 2061 elements such a │ │ │ +0020df80: 7320 7072 652c 2073 7479 6c65 2061 6e64 s pre, style and │ │ │ +0020df90: 2073 6372 6970 740a 7768 656e 2067 656e script.when gen │ │ │ +0020dfa0: 6572 6174 696e 6720 584d 4c2e 2054 6869 erating XML. Thi │ │ │ +0020dfb0: 7320 6973 206e 6565 6465 6420 6966 2074 s is needed if t │ │ │ +0020dfc0: 6865 2077 6869 7465 7370 6163 6520 696e he whitespace in │ │ │ +0020dfd0: 2073 7563 680a 656c 656d 656e 7473 2069 such.elements i │ │ │ +0020dfe0: 7320 746f 2062 6520 7061 7273 6564 2061 s to be parsed a │ │ │ +0020dff0: 7070 726f 7072 6961 7465 6c79 2077 6974 ppropriately wit │ │ │ +0020e000: 686f 7574 2068 6176 696e 6720 6163 6365 hout having acce │ │ │ +0020e010: 7373 2074 6f0a 7468 6520 4454 442e 2054 ss to.the DTD. T │ │ │ +0020e020: 6865 2064 6566 6175 6c74 2069 7320 3c65 he default is no...a │ │ │ +0020e070: 6c74 2d74 6578 743a 203c 656d 7068 6173 lt-text: <emphas │ │ │ +0020e080: 6973 3e73 7472 696e 673c 2f65 6d70 6861 is>string</empha │ │ │ +0020e090: 7369 733e 3c2f 7469 746c 653e 0a0a 3c70 sis>..

    This allows │ │ │ +0020e0b0: 796f 7520 746f 2073 6574 2074 6865 2064 you to set the d │ │ │ +0020e0c0: 6566 6175 6c74 2061 6c74 2074 6578 7420 efault alt text │ │ │ +0020e0d0: 666f 7220 696d 670a 6174 7472 6962 7574 for img.attribut │ │ │ +0020e0e0: 6573 2e20 5468 6973 2066 6561 7475 7265 es. This feature │ │ │ +0020e0f0: 2069 7320 6461 6e67 6572 6f75 7320 6173 is dangerous as │ │ │ +0020e100: 2069 7420 7375 7070 7265 7373 6573 2066 it suppresses f │ │ │ +0020e110: 7572 7468 6572 0a61 6363 6573 7369 6269 urther.accessibi │ │ │ +0020e120: 6c69 7479 2077 6172 6e69 6e67 732e 203c lity warnings. < │ │ │ +0020e130: 656d 7068 6173 6973 3e59 4f55 2041 5245 emphasis>YOU ARE │ │ │ +0020e140: 2052 4553 504f 4e53 4942 4c45 2046 4f52 RESPONSIBLE FOR │ │ │ +0020e150: 204d 414b 494e 4720 594f 5552 0a44 4f43 MAKING YOUR.DOC │ │ │ +0020e160: 554d 454e 5453 2041 4343 4553 5349 424c UMENTS ACCESSIBL │ │ │ +0020e170: 4520 544f 2050 454f 504c 4520 5748 4f20 E TO PEOPLE WHO │ │ │ +0020e180: 4341 4e27 5420 5345 4520 5448 450a 494d CAN'T SEE THE.IM │ │ │ +0020e190: 4147 4553 2121 213c 2f65 6d70 6861 7369 AGES!!!..write │ │ │ +0020e1d0: 2d62 6163 6b3a 203c 656d 7068 6173 6973 -back: <emphasis │ │ │ +0020e1e0: 3e62 6f6f 6c3c 2f65 6d70 6861 7369 733e >bool</emphasis> │ │ │ +0020e1f0: 3c2f 7469 746c 653e 0a0a 3c70 6172 613e .. │ │ │ +0020e200: 4966 2073 6574 2074 6f20 3c65 6d70 6861 If set to yes, Tidy will wr │ │ │ +0020e230: 6974 6520 6261 636b 2074 6865 2074 6964 ite back the tid │ │ │ +0020e240: 6965 640a 6d61 726b 7570 2074 6f20 7468 ied.markup to th │ │ │ +0020e250: 6520 7361 6d65 2066 696c 6520 6974 2072 e same file it r │ │ │ +0020e260: 6561 6420 6672 6f6d 2e20 5468 6520 6465 ead from. The de │ │ │ +0020e270: 6661 756c 7420 6973 203c 656d 7068 6173 fault is no │ │ │ +0020e290: 2e0a 596f 7520 6172 6520 6164 7669 7365 ..You are advise │ │ │ +0020e2a0: 6420 746f 206b 6565 7020 636f 7069 6573 d to keep copies │ │ │ +0020e2b0: 206f 6620 696d 706f 7274 616e 7420 6669 of important fi │ │ │ +0020e2c0: 6c65 7320 6265 666f 7265 2074 6964 7969 les before tidyi │ │ │ +0020e2d0: 6e67 0a74 6865 6d20 6173 206f 6e20 7261 ng.them as on ra │ │ │ +0020e2e0: 7265 206f 6363 6173 696f 6e73 2074 6865 re occasions the │ │ │ +0020e2f0: 2072 6573 756c 7420 6d61 7920 6e6f 7420 result may not │ │ │ +0020e300: 616c 7761 7973 2062 6520 7768 6174 2079 always be what y │ │ │ +0020e310: 6f75 0a65 7870 6563 742e 3c2f 7061 7261 ou.expect... │ │ │ +0020e330: 3c66 6f72 6d61 6c70 6172 613e 3c74 6974 keep-time: bool. │ │ │ +0020e370: 0a3c 7061 7261 3e49 6620 7365 7420 746f .If set to │ │ │ +0020e380: 203c 656d 7068 6173 6973 3e79 6573 3c2f yes, Tidy │ │ │ +0020e3a0: 776f 6e27 7420 616c 7465 7220 7468 6520 won't alter the │ │ │ +0020e3b0: 6c61 7374 206d 6f64 6966 6965 640a 7469 last modified.ti │ │ │ +0020e3c0: 6d65 2066 6f72 2066 696c 6573 2069 7420 me for files it │ │ │ +0020e3d0: 7772 6974 6573 2062 6163 6b20 746f 2e20 writes back to. │ │ │ +0020e3e0: 5468 6520 6465 6661 756c 7420 6973 203c The default is < │ │ │ +0020e3f0: 656d 7068 6173 6973 3e79 6573 3c2f 656d emphasis>yes..This al │ │ │ +0020e410: 6c6f 7773 2079 6f75 2074 6f20 7469 6479 lows you to tidy │ │ │ +0020e420: 2066 696c 6573 2077 6974 686f 7574 2065 files without e │ │ │ +0020e430: 6666 6563 7469 6e67 2077 6869 6368 206f ffecting which o │ │ │ +0020e440: 6e65 7320 7769 6c6c 0a62 6520 7570 6c6f nes will.be uplo │ │ │ +0020e450: 6164 6564 2074 6f20 7468 6520 5765 6220 aded to the Web │ │ │ +0020e460: 7365 7276 6572 2077 6865 6e20 7573 696e server when usin │ │ │ +0020e470: 6720 6120 746f 6f6c 2073 7563 6820 6173 g a tool such as │ │ │ +0020e480: 0a27 5369 7465 436f 7079 272e 204e 6f74 .'SiteCopy'. Not │ │ │ +0020e490: 6520 7468 6174 2074 6869 7320 6665 6174 e that this feat │ │ │ +0020e4a0: 7572 6520 6d61 7920 6e6f 7420 776f 726b ure may not work │ │ │ +0020e4b0: 206f 6e20 736f 6d65 0a70 6c61 7466 6f72 on some.platfor │ │ │ +0020e4c0: 6d73 2e3c 2f70 6172 613e 3c2f 666f 726d ms...erro │ │ │ +0020e4f0: 722d 6669 6c65 3a20 3c65 6d70 6861 7369 r-file: <emphasi │ │ │ +0020e500: 733e 6669 6c65 6e61 6d65 3c2f 656d 7068 s>filename</emph │ │ │ +0020e510: 6173 6973 3e3c 2f74 6974 6c65 3e0a 0a3c asis>..< │ │ │ +0020e520: 7061 7261 3e57 7269 7465 7320 6572 726f para>Writes erro │ │ │ +0020e530: 7273 2061 6e64 2077 6172 6e69 6e67 7320 rs and warnings │ │ │ +0020e540: 746f 2074 6865 206e 616d 6564 2066 696c to the named fil │ │ │ +0020e550: 6520 7261 7468 6572 2074 6861 6e20 746f e rather than to │ │ │ +0020e560: 0a73 7464 6572 722e 3c2f 7061 7261 3e3c .stderr.< │ │ │ +0020e570: 2f66 6f72 6d61 6c70 6172 613e 0a0a 3c66 /formalpara>..show-warnings: │ │ │ +0020e5a0: 3c65 6d70 6861 7369 733e 626f 6f6c 3c2f <emphasis>bool</ │ │ │ +0020e5b0: 656d 7068 6173 6973 3e3c 2f74 6974 6c65 emphasis>..If set │ │ │ +0020e5d0: 746f 203c 656d 7068 6173 6973 3e6e 6f3c to no< │ │ │ +0020e5e0: 2f65 6d70 6861 7369 733e 2c20 7761 726e /emphasis>, warn │ │ │ +0020e5f0: 696e 6773 2061 7265 2073 7570 7072 6573 ings are suppres │ │ │ +0020e600: 7365 642e 2054 6869 7320 6361 6e20 6265 sed. This can be │ │ │ +0020e610: 0a75 7365 6675 6c20 7768 656e 2061 2066 .useful when a f │ │ │ +0020e620: 6577 2065 7272 6f72 7320 6172 6520 6869 ew errors are hi │ │ │ +0020e630: 6464 656e 2069 6e20 6120 666c 7572 7279 dden in a flurry │ │ │ +0020e640: 206f 6620 7761 726e 696e 6773 2e20 5468 of warnings. Th │ │ │ +0020e650: 650a 6465 6661 756c 7420 6973 203c 656d e.default is yes...q │ │ │ +0020e6a0: 7569 6574 3a20 3c65 6d70 6861 7369 733e uiet: <emphasis> │ │ │ +0020e6b0: 626f 6f6c 3c2f 656d 7068 6173 6973 3e3c bool</emphasis>< │ │ │ +0020e6c0: 2f74 6974 6c65 3e0a 0a3c 7061 7261 3e49 /title>..<para>I │ │ │ +0020e6d0: 6620 7365 7420 746f 203c 656d 7068 6173 f set to <emphas │ │ │ +0020e6e0: 6973 3e79 6573 3c2f 656d 7068 6173 6973 is>yes</emphasis │ │ │ +0020e6f0: 3e2c 2054 6964 7920 776f 6e27 7420 6f75 >, Tidy won't ou │ │ │ +0020e700: 7470 7574 2074 6865 2077 656c 636f 6d65 tput the welcome │ │ │ +0020e710: 206d 6573 7361 6765 0a6f 7220 7468 6520 message.or the │ │ │ +0020e720: 7375 6d6d 6172 7920 6f66 2074 6865 206e summary of the n │ │ │ +0020e730: 756d 6265 7273 206f 6620 6572 726f 7273 umbers of errors │ │ │ +0020e740: 2061 6e64 2077 6172 6e69 6e67 732e 2054 and warnings. T │ │ │ +0020e750: 6865 2064 6566 6175 6c74 0a69 7320 3c65 he default.is <e │ │ │ +0020e760: 6d70 6861 7369 733e 6e6f 3c2f 656d 7068 mphasis>no</emph │ │ │ +0020e770: 6173 6973 3e2e 3c2f 7061 7261 3e3c 2f66 asis>.</para></f │ │ │ +0020e780: 6f72 6d61 6c70 6172 613e 0a0a 3c66 6f72 ormalpara>..<for │ │ │ +0020e790: 6d61 6c70 6172 613e 3c74 6974 6c65 3e67 malpara><title>g │ │ │ +0020e7a0: 6e75 2d65 6d61 6373 3a20 3c65 6d70 6861 nu-emacs: <empha │ │ │ +0020e7b0: 7369 733e 626f 6f6c 3c2f 656d 7068 6173 sis>bool</emphas │ │ │ +0020e7c0: 6973 3e3c 2f74 6974 6c65 3e0a 0a3c 7061 is>..If set to yes, Tidy chan │ │ │ +0020e800: 6765 7320 7468 6520 666f 726d 6174 2066 ges the format f │ │ │ +0020e810: 6f72 2072 6570 6f72 7469 6e67 0a65 7272 or reporting.err │ │ │ +0020e820: 6f72 7320 616e 6420 7761 726e 696e 6773 ors and warnings │ │ │ +0020e830: 2074 6f20 6120 666f 726d 6174 2074 6861 to a format tha │ │ │ +0020e840: 7420 6973 206d 6f72 6520 6561 7369 6c79 t is more easily │ │ │ +0020e850: 2070 6172 7365 6420 6279 2047 4e55 0a45 parsed by GNU.E │ │ │ +0020e860: 6d61 6373 2e20 5468 6520 6465 6661 756c macs. The defaul │ │ │ +0020e870: 7420 6973 203c 656d 7068 6173 6973 3e6e t is n │ │ │ +0020e880: 6f3c 2f65 6d70 6861 7369 733e 2e3c 2f70 o.

    ..< │ │ │ +0020e8b0: 7469 746c 653e 7370 6c69 743a 203c 656d title>split: bool.. │ │ │ +0020e8e0: 3c70 6172 613e 4966 2073 6574 2074 6f20 If set to │ │ │ +0020e8f0: 3c65 6d70 6861 7369 733e 7965 733c 2f65 yes Tidy wi │ │ │ +0020e910: 6c6c 2075 7365 2074 6865 2069 6e70 7574 ll use the input │ │ │ +0020e920: 2066 696c 6520 746f 2063 7265 6174 650a file to create. │ │ │ +0020e930: 6120 7365 7175 656e 6365 206f 6620 736c a sequence of sl │ │ │ +0020e940: 6964 6573 2c20 7370 6c69 7474 696e 6720 ides, splitting │ │ │ +0020e950: 7468 6520 6d61 726b 7570 2070 7269 6f72 the markup prior │ │ │ +0020e960: 2074 6f20 6561 6368 0a73 7563 6365 7373 to each.success │ │ │ +0020e970: 6976 6520 266c 743b 6832 2667 743b 2e20 ive <h2>. │ │ │ +0020e980: 596f 7520 6361 6e20 7365 6520 616e 2065 You can see an e │ │ │ +0020e990: 7861 6d70 6c65 206f 6620 7468 6520 7265 xample of the re │ │ │ +0020e9a0: 7375 6c74 7320 696e 2061 0a3c 756c 696e sults in a..rec │ │ │ +0020e9f0: 656e 7420 7461 6c6b 206f 6e20 5848 544d ent talk on XHTM │ │ │ +0020ea00: 4c3c 2f75 6c69 6e6b 3e2e 2054 6865 2073 L. The s │ │ │ +0020ea10: 6c69 6465 7320 6172 6520 7772 6974 7465 lides are writte │ │ │ +0020ea20: 6e20 746f 0a22 736c 6964 6531 2e68 746d n to."slide1.htm │ │ │ +0020ea30: 6c22 2c20 2273 6c69 6465 322e 6874 6d6c l", "slide2.html │ │ │ +0020ea40: 2220 6574 632e 2054 6865 2064 6566 6175 " etc. The defau │ │ │ +0020ea50: 6c74 2069 730a 3c65 6d70 6861 7369 733e lt is. │ │ │ +0020ea60: 6e6f 3c2f 656d 7068 6173 6973 3e2e 3c2f no... │ │ │ +0020ea90: 3c74 6974 6c65 3e6e 6577 2d65 6d70 7479 new-empty │ │ │ +0020eaa0: 2d74 6167 733a 203c 656d 7068 6173 6973 -tags: <emphasis │ │ │ +0020eab0: 3e74 6167 312c 2074 6167 322c 2074 6167 >tag1, tag2, tag │ │ │ +0020eac0: 333c 2f65 6d70 6861 7369 733e 3c2f 7469 3</emphasis></ti │ │ │ +0020ead0: 746c 653e 0a0a 3c70 6172 613e 5573 6520 tle>..<para>Use │ │ │ +0020eae0: 7468 6973 2074 6f20 6465 636c 6172 6520 this to declare │ │ │ +0020eaf0: 6e65 7720 656d 7074 7920 696e 6c69 6e65 new empty inline │ │ │ +0020eb00: 2074 6167 732e 2054 6865 206f 7074 696f tags. The optio │ │ │ +0020eb10: 6e20 7461 6b65 7320 610a 7370 6163 6520 n takes a.space │ │ │ +0020eb20: 6f72 2063 6f6d 6d61 2073 6570 6172 6174 or comma separat │ │ │ +0020eb30: 6564 206c 6973 7420 6f66 2074 6167 206e ed list of tag n │ │ │ +0020eb40: 616d 6573 2e20 556e 6c65 7373 2079 6f75 ames. Unless you │ │ │ +0020eb50: 2064 6563 6c61 7265 0a6e 6577 2074 6167 declare.new tag │ │ │ +0020eb60: 732c 2054 6964 7920 7769 6c6c 2072 6566 s, Tidy will ref │ │ │ +0020eb70: 7573 6520 746f 2067 656e 6572 6174 6520 use to generate │ │ │ +0020eb80: 6120 7469 6469 6564 2066 696c 6520 6966 a tidied file if │ │ │ +0020eb90: 2074 6865 2069 6e70 7574 0a69 6e63 6c75 the input.inclu │ │ │ +0020eba0: 6465 7320 7072 6576 696f 7573 6c79 2075 des previously u │ │ │ +0020ebb0: 6e6b 6e6f 776e 2074 6167 732e 2052 656d nknown tags. Rem │ │ │ +0020ebc0: 656d 6265 7220 746f 2061 6c73 6f20 6465 ember to also de │ │ │ +0020ebd0: 636c 6172 6520 656d 7074 790a 7461 6773 clare empty.tags │ │ │ +0020ebe0: 2061 7320 6569 7468 6572 2069 6e6c 696e as either inlin │ │ │ +0020ebf0: 6520 6f72 2062 6c6f 636b 6c65 7665 6c2c e or blocklevel, │ │ │ +0020ec00: 2073 6565 2062 656c 6f77 2e3c 2f70 6172 see below.</par │ │ │ +0020ec10: 613e 3c2f 666f 726d 616c 7061 7261 3e0a a></formalpara>. │ │ │ +0020ec20: 0a3c 666f 726d 616c 7061 7261 3e3c 7469 .<formalpara><ti │ │ │ +0020ec30: 746c 653e 6e65 772d 696e 6c69 6e65 2d74 tle>new-inline-t │ │ │ +0020ec40: 6167 733a 203c 656d 7068 6173 6973 3e74 ags: <emphasis>t │ │ │ +0020ec50: 6167 312c 2074 6167 322c 2074 6167 333c ag1, tag2, tag3< │ │ │ +0020ec60: 2f65 6d70 6861 7369 733e 3c2f 7469 746c /emphasis></titl │ │ │ +0020ec70: 653e 0a0a 3c70 6172 613e 5573 6520 7468 e>..<para>Use th │ │ │ +0020ec80: 6973 2074 6f20 6465 636c 6172 6520 6e65 is to declare ne │ │ │ +0020ec90: 7720 6e6f 6e2d 656d 7074 7920 696e 6c69 w non-empty inli │ │ │ +0020eca0: 6e65 2074 6167 732e 2054 6865 206f 7074 ne tags. The opt │ │ │ +0020ecb0: 696f 6e0a 7461 6b65 7320 6120 7370 6163 ion.takes a spac │ │ │ +0020ecc0: 6520 6f72 2063 6f6d 6d61 2073 6570 6172 e or comma separ │ │ │ +0020ecd0: 6174 6564 206c 6973 7420 6f66 2074 6167 ated list of tag │ │ │ +0020ece0: 206e 616d 6573 2e20 556e 6c65 7373 2079 names. Unless y │ │ │ +0020ecf0: 6f75 0a64 6563 6c61 7265 206e 6577 2074 ou.declare new t │ │ │ +0020ed00: 6167 732c 2054 6964 7920 7769 6c6c 2072 ags, Tidy will r │ │ │ +0020ed10: 6566 7573 6520 746f 2067 656e 6572 6174 efuse to generat │ │ │ +0020ed20: 6520 6120 7469 6469 6564 2066 696c 6520 e a tidied file │ │ │ +0020ed30: 6966 0a74 6865 2069 6e70 7574 2069 6e63 if.the input inc │ │ │ +0020ed40: 6c75 6465 7320 7072 6576 696f 7573 6c79 ludes previously │ │ │ +0020ed50: 2075 6e6b 6e6f 776e 2074 6167 732e 3c2f unknown tags.</ │ │ │ +0020ed60: 7061 7261 3e3c 2f66 6f72 6d61 6c70 6172 para></formalpar │ │ │ +0020ed70: 613e 0a0a 3c66 6f72 6d61 6c70 6172 613e a>..<formalpara> │ │ │ +0020ed80: 3c74 6974 6c65 3e6e 6577 2d62 6c6f 636b <title>new-block │ │ │ +0020ed90: 6c65 7665 6c2d 7461 6773 3a20 3c65 6d70 level-tags: <emp │ │ │ +0020eda0: 6861 7369 733e 7461 6731 2c20 7461 6732 hasis>tag1, tag2 │ │ │ +0020edb0: 2c20 7461 6733 3c2f 656d 7068 6173 6973 , tag3</emphasis │ │ │ +0020edc0: 3e3c 2f74 6974 6c65 3e0a 0a3c 7061 7261 >..Use this to dec │ │ │ +0020ede0: 6c61 7265 206e 6577 2062 6c6f 636b 2d6c lare new block-l │ │ │ +0020edf0: 6576 656c 2074 6167 732e 2054 6865 206f evel tags. The o │ │ │ +0020ee00: 7074 696f 6e20 7461 6b65 7320 610a 7370 ption takes a.sp │ │ │ +0020ee10: 6163 6520 6f72 2063 6f6d 6d61 2073 6570 ace or comma sep │ │ │ +0020ee20: 6172 6174 6564 206c 6973 7420 6f66 2074 arated list of t │ │ │ +0020ee30: 6167 206e 616d 6573 2e20 556e 6c65 7373 ag names. Unless │ │ │ +0020ee40: 2079 6f75 2064 6563 6c61 7265 0a6e 6577 you declare.new │ │ │ +0020ee50: 2074 6167 732c 2054 6964 7920 7769 6c6c tags, Tidy will │ │ │ +0020ee60: 2072 6566 7573 6520 746f 2067 656e 6572 refuse to gener │ │ │ +0020ee70: 6174 6520 6120 7469 6469 6564 2066 696c ate a tidied fil │ │ │ +0020ee80: 6520 6966 2074 6865 2069 6e70 7574 0a69 e if the input.i │ │ │ +0020ee90: 6e63 6c75 6465 7320 7072 6576 696f 7573 ncludes previous │ │ │ +0020eea0: 6c79 2075 6e6b 6e6f 776e 2074 6167 732e ly unknown tags. │ │ │ +0020eeb0: 204e 6f74 6520 796f 7520 6361 6e27 7420 Note you can't │ │ │ +0020eec0: 6368 616e 6765 2074 6865 0a63 6f6e 7465 change the.conte │ │ │ +0020eed0: 6e74 206d 6f64 656c 2066 6f72 2065 6c65 nt model for ele │ │ │ +0020eee0: 6d65 6e74 7320 7375 6368 2061 7320 7461 ments such as ta │ │ │ +0020eef0: 626c 652c 2075 6c2c 206f 6c20 616e 6420 ble, ul, ol and │ │ │ +0020ef00: 646c 2e20 5468 6973 2069 730a 6578 706c dl. This is.expl │ │ │ +0020ef10: 6169 6e65 6420 696e 206d 6f72 6520 6465 ained in more de │ │ │ +0020ef20: 7461 696c 2069 6e20 7468 6520 6f72 6967 tail in the orig │ │ │ +0020ef30: 696e 616c 2072 656c 6561 7365 206e 6f74 inal release not │ │ │ +0020ef40: 6573 2e3c 2f70 6172 613e 3c2f 666f 726d es...new- │ │ │ +0020ef70: 7072 652d 7461 6773 3a20 3c65 6d70 6861 pre-tags: <empha │ │ │ +0020ef80: 7369 733e 7461 6731 2c20 7461 6732 2c20 sis>tag1, tag2, │ │ │ +0020ef90: 7461 6733 3c2f 656d 7068 6173 6973 3e3c tag3</emphasis>< │ │ │ +0020efa0: 2f74 6974 6c65 3e0a 0a3c 7061 7261 3e55 /title>..<para>U │ │ │ +0020efb0: 7365 2074 6869 7320 746f 2064 6563 6c61 se this to decla │ │ │ +0020efc0: 7265 206e 6577 2074 6167 7320 7468 6174 re new tags that │ │ │ +0020efd0: 2061 7265 2074 6f20 6265 2070 726f 6365 are to be proce │ │ │ +0020efe0: 7373 6564 2069 6e0a 6578 6163 746c 7920 ssed in.exactly │ │ │ +0020eff0: 7468 6520 7361 6d65 2077 6179 2061 7320 the same way as │ │ │ +0020f000: 4854 4d4c 2773 2070 7265 2065 6c65 6d65 HTML's pre eleme │ │ │ +0020f010: 6e74 2e20 5468 6520 6f70 7469 6f6e 2074 nt. The option t │ │ │ +0020f020: 616b 6573 2061 0a73 7061 6365 206f 7220 akes a.space or │ │ │ +0020f030: 636f 6d6d 6120 7365 7061 7261 7465 6420 comma separated │ │ │ +0020f040: 6c69 7374 206f 6620 7461 6720 6e61 6d65 list of tag name │ │ │ +0020f050: 732e 2055 6e6c 6573 7320 796f 7520 6465 s. Unless you de │ │ │ +0020f060: 636c 6172 650a 6e65 7720 7461 6773 2c20 clare.new tags, │ │ │ +0020f070: 5469 6479 2077 696c 6c20 7265 6675 7365 Tidy will refuse │ │ │ +0020f080: 2074 6f20 6765 6e65 7261 7465 2061 2074 to generate a t │ │ │ +0020f090: 6964 6965 6420 6669 6c65 2069 6620 7468 idied file if th │ │ │ +0020f0a0: 6520 696e 7075 740a 696e 636c 7564 6573 e input.includes │ │ │ +0020f0b0: 2070 7265 7669 6f75 736c 7920 756e 6b6e previously unkn │ │ │ +0020f0c0: 6f77 6e20 7461 6773 2e20 4e6f 7465 2079 own tags. Note y │ │ │ +0020f0d0: 6f75 2063 616e 2774 2061 7320 7965 7420 ou can't as yet │ │ │ +0020f0e0: 6164 6420 6e65 770a 4344 4154 4120 656c add new.CDATA el │ │ │ +0020f0f0: 656d 656e 7473 2028 7369 6d69 6c61 7220 ements (similar │ │ │ +0020f100: 746f 2073 6372 6970 7429 2e3c 2f70 6172 to script).</par │ │ │ +0020f110: 613e 3c2f 666f 726d 616c 7061 7261 3e0a a></formalpara>. │ │ │ +0020f120: 0a0a 3c2f 7265 6673 6563 7432 3e0a 2020 ..</refsect2>. │ │ │ +0020f130: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ +0020f140: 6566 7365 6374 3120 6964 3d22 7265 7422 efsect1 id="ret" │ │ │ +0020f150: 3e3c 7469 746c 653e 5265 7475 726e 2054 ><title>Return T │ │ │ +0020f160: 7970 6573 3c2f 7469 746c 653e 0a3c 7061 ypes.. E │ │ │ +0020f1b0: 7272 6f72 733c 2f74 6974 6c65 3e0a 2020 rrors. │ │ │ +0020f1c0: 2020 3c74 6162 6c65 3e3c 7469 746c 653e
  • │ │ │ +0020f1d0: 4572 726f 7273 2073 6967 6e61 6c6c 6564 Errors signalled │ │ │ +0020f1e0: 2062 7920 7469 6479 5f68 746d 6c3c 2f74 by tidy_html</t │ │ │ +0020f1f0: 6974 6c65 3e0a 2020 2020 2020 3c74 6772 itle>. <tgr │ │ │ +0020f200: 6f75 7020 636f 6c73 3d22 3422 3e0a 2020 oup cols="4">. │ │ │ +0020f210: 2020 2020 203c 7468 6561 643e 3c72 6f77 <thead><row │ │ │ +0020f220: 3e3c 656e 7472 793e 5351 4c53 7461 7465 ><entry>SQLState │ │ │ +0020f230: 3c2f 656e 7472 793e 3c65 6e74 7279 3e45 </entry><entry>E │ │ │ +0020f240: 7272 6f72 2043 6f64 653c 2f65 6e74 7279 rror Code</entry │ │ │ +0020f250: 3e3c 656e 7472 793e 4572 726f 7220 5465 ><entry>Error Te │ │ │ +0020f260: 7874 3c2f 656e 7472 793e 3c65 6e74 7279 xt</entry><entry │ │ │ +0020f270: 3e44 6573 6372 6970 7469 6f6e 3c2f 656e >Description</en │ │ │ +0020f280: 7472 793e 3c2f 726f 773e 3c2f 7468 6561 try></row></thea │ │ │ +0020f290: 643e 0a09 3c74 626f 6479 3e0a 0920 203c d>..<tbody>.. < │ │ │ +0020f2a0: 726f 773e 0a09 2020 2020 3c65 6e74 7279 row>.. <entry │ │ │ +0020f2b0: 3e3c 6572 726f 7263 6f64 653e 5854 4944 ><errorcode>XTID │ │ │ +0020f2c0: 323c 2f65 7272 6f72 636f 6465 3e3c 2f65 2</errorcode></e │ │ │ +0020f2d0: 6e74 7279 3e0a 0920 2020 203c 656e 7472 ntry>.. <entr │ │ │ +0020f2e0: 793e 3c65 7272 6f72 636f 6465 3e3c 2f65 y><errorcode></e │ │ │ +0020f2f0: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0020f300: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0020f310: 7272 6f72 6e61 6d65 3e48 544d 4c20 5469 rrorname>HTML Ti │ │ │ +0020f320: 6479 2066 6169 6c65 643c 2f65 7272 6f72 dy failed</error │ │ │ +0020f330: 6e61 6d65 3e3c 2f65 6e74 7279 3e0a 0920 name></entry>.. │ │ │ +0020f340: 2020 203c 656e 7472 793e 5468 6520 6769 <entry>The gi │ │ │ +0020f350: 7665 6e20 4854 4d4c 2074 6578 7420 636f ven HTML text co │ │ │ +0020f360: 6e74 6169 6e73 2073 6572 696f 7573 2065 ntains serious e │ │ │ +0020f370: 7272 6f72 732e 2054 6f20 6765 7420 6465 rrors. To get de │ │ │ +0020f380: 7461 696c 6564 206c 6973 7420 6f66 2074 tailed list of t │ │ │ +0020f390: 6865 6d2c 2063 616c 6c20 7469 6479 5f6c hem, call tidy_l │ │ │ +0020f3a0: 6973 745f 6572 726f 7273 2077 6974 6820 ist_errors with │ │ │ +0020f3b0: 7361 6d65 2070 6172 616d 6574 6572 7320 same parameters │ │ │ +0020f3c0: 6173 2074 6964 795f 6874 6d6c 2e3c 2f65 as tidy_html.</e │ │ │ +0020f3d0: 6e74 7279 3e0a 0920 203c 2f72 6f77 3e0a ntry>.. </row>. │ │ │ +0020f3e0: 093c 2f74 626f 6479 3e0a 2020 2020 2020 .</tbody>. │ │ │ +0020f3f0: 3c2f 7467 726f 7570 3e0a 2020 2020 3c2f </tgroup>. </ │ │ │ +0020f400: 7461 626c 653e 0a20 203c 2f72 6566 7365 table>. </refse │ │ │ +0020f410: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ +0020f420: 2069 643d 2265 7861 6d70 6c65 7322 3e3c id="examples">< │ │ │ +0020f430: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples</ │ │ │ +0020f440: 7469 746c 653e 0a20 2020 203c 6578 616d title>. <exam │ │ │ +0020f450: 706c 6520 6964 3d22 6578 5f74 6964 795f ple id="ex_tidy_ │ │ │ +0020f460: 6874 6d6c 223e 3c74 6974 6c65 3e3c 2f74 html"><title></t │ │ │ +0020f470: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +0020f480: 613e 3c2f 7061 7261 3e0a 2020 2020 2020 a></para>. │ │ │ +0020f490: 3c73 6372 6565 6e3e 0a66 696e 655f 6874 <screen>.fine_ht │ │ │ +0020f4a0: 6d6c 203a 3d20 7469 6479 5f68 746d 6c20 ml := tidy_html │ │ │ +0020f4b0: 2875 676c 795f 6874 6d6c 2c20 270a 696e (ugly_html, '.in │ │ │ +0020f4c0: 6465 6e74 3a20 6175 746f 0a69 6e64 656e dent: auto.inden │ │ │ +0020f4d0: 742d 7370 6163 6573 3a20 320a 7772 6170 t-spaces: 2.wrap │ │ │ +0020f4e0: 3a20 3732 0a6d 6172 6b75 703a 2079 6573 : 72.markup: yes │ │ │ +0020f4f0: 0a6f 7574 7075 742d 786d 6c3a 206e 6f0a .output-xml: no. │ │ │ +0020f500: 696e 7075 742d 786d 6c3a 206e 6f0a 7368 input-xml: no.sh │ │ │ +0020f510: 6f77 2d77 6172 6e69 6e67 733a 2079 6573 ow-warnings: yes │ │ │ +0020f520: 0a6e 756d 6572 6963 2d65 6e74 6974 6965 .numeric-entitie │ │ │ +0020f530: 733a 2079 6573 0a71 756f 7465 2d6d 6172 s: yes.quote-mar │ │ │ +0020f540: 6b73 3a20 7965 730a 7175 6f74 652d 6e62 ks: yes.quote-nb │ │ │ +0020f550: 7370 3a20 7965 730a 7175 6f74 652d 616d sp: yes.quote-am │ │ │ +0020f560: 7065 7273 616e 643a 206e 6f0a 6272 6561 persand: no.brea │ │ │ +0020f570: 6b2d 6265 666f 7265 2d62 723a 206e 6f0a k-before-br: no. │ │ │ +0020f580: 7570 7065 7263 6173 652d 7461 6773 3a20 uppercase-tags: │ │ │ +0020f590: 6e6f 0a75 7070 6572 6361 7365 2d61 7474 no.uppercase-att │ │ │ +0020f5a0: 7269 6275 7465 733a 206e 6f0a 6368 6172 ributes: no.char │ │ │ +0020f5b0: 2d65 6e63 6f64 696e 673a 206c 6174 696e -encoding: latin │ │ │ +0020f5c0: 310a 6e65 772d 696e 6c69 6e65 2d74 6167 1.new-inline-tag │ │ │ +0020f5d0: 733a 2063 6669 662c 2063 6665 6c73 652c s: cfif, cfelse, │ │ │ +0020f5e0: 206d 6174 682c 206d 726f 6f74 2c0a 2020 math, mroot,. │ │ │ +0020f5f0: 6d72 6f77 2c20 6d69 2c20 6d6e 2c20 6d6f mrow, mi, mn, mo │ │ │ +0020f600: 2c20 6d73 7172 742c 206d 6672 6163 2c20 , msqrt, mfrac, │ │ │ +0020f610: 6d73 7562 7375 702c 206d 756e 6465 726f msubsup, mundero │ │ │ +0020f620: 7665 722c 0a20 206d 756e 6465 722c 206d ver,. munder, m │ │ │ +0020f630: 6f76 6572 2c20 6d6d 756c 7469 7363 7269 over, mmultiscri │ │ │ +0020f640: 7074 732c 206d 7375 702c 206d 7375 622c pts, msup, msub, │ │ │ +0020f650: 206d 7465 7874 2c0a 2020 6d70 7265 7363 mtext,. mpresc │ │ │ +0020f660: 7269 7074 732c 206d 7461 626c 652c 206d ripts, mtable, m │ │ │ +0020f670: 7472 2c20 6d74 642c 206d 7468 0a6e 6577 tr, mtd, mth.new │ │ │ +0020f680: 2d62 6c6f 636b 6c65 7665 6c2d 7461 6773 -blocklevel-tags │ │ │ +0020f690: 3a20 6366 6f75 7470 7574 2c20 6366 7175 : cfoutput, cfqu │ │ │ +0020f6a0: 6572 790a 6e65 772d 656d 7074 792d 7461 ery.new-empty-ta │ │ │ +0020f6b0: 6773 3a20 6366 656c 7365 2729 3b0a 3c2f gs: cfelse');.</ │ │ │ +0020f6c0: 7363 7265 656e 3e0a 2020 2020 3c2f 6578 screen>. </ex │ │ │ +0020f6d0: 616d 706c 653e 0a20 203c 2f72 6566 7365 ample>. </refse │ │ │ +0020f6e0: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ +0020f6f0: 2069 643d 2273 6565 616c 736f 223e 3c74 id="seealso"><t │ │ │ +0020f700: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ +0020f710: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +0020f720: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ +0020f730: 6e5f 7469 6479 5f6c 6973 745f 6572 726f n_tidy_list_erro │ │ │ +0020f740: 7273 223e 3c2f 6c69 6e6b 3e3c 2f70 6172 rs"></link></par │ │ │ +0020f750: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +0020f760: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 .</refentry>.... │ │ │ +0020f770: 0000 2364 656d 6f2f 646f 6373 7263 2f66 ..#demo/docsrc/f │ │ │ +0020f780: 756e 6372 6566 2f67 7a5f 636f 6d70 7265 uncref/gz_compre │ │ │ +0020f790: 7373 2e78 6d6c df00 000f 833c 3f78 6d6c ss.xml.....<?xml │ │ │ +0020f7a0: 2076 6572 7369 6f6e 3d22 312e 3022 2065 version="1.0" e │ │ │ +0020f7b0: 6e63 6f64 696e 673d 2249 534f 2d38 3835 ncoding="ISO-885 │ │ │ +0020f7c0: 392d 3122 3f3e 0a3c 212d 2d0a 202d 2020 9-1"?>.<!--. - │ │ │ +0020f7d0: 0a20 2d20 2054 6869 7320 6669 6c65 2069 . - This file i │ │ │ +0020f7e0: 7320 7061 7274 206f 6620 7468 6520 4f70 s part of the Op │ │ │ +0020f7f0: 656e 4c69 6e6b 2053 6f66 7477 6172 6520 enLink Software │ │ │ +0020f800: 5669 7274 756f 736f 204f 7065 6e2d 536f Virtuoso Open-So │ │ │ +0020f810: 7572 6365 2028 564f 5329 0a20 2d20 2070 urce (VOS). - p │ │ │ +0020f820: 726f 6a65 6374 2e0a 202d 2020 0a20 2d20 roject.. - . - │ │ │ +0020f830: 2043 6f70 7972 6967 6874 2028 4329 2031 Copyright (C) 1 │ │ │ +0020f840: 3939 382d 3230 3234 204f 7065 6e4c 696e 998-2024 OpenLin │ │ │ +0020f850: 6b20 536f 6674 7761 7265 0a20 2d20 200a k Software. - . │ │ │ +0020f860: 202d 2020 5468 6973 2070 726f 6a65 6374 - This project │ │ │ +0020f870: 2069 7320 6672 6565 2073 6f66 7477 6172 is free softwar │ │ │ +0020f880: 653b 2079 6f75 2063 616e 2072 6564 6973 e; you can redis │ │ │ +0020f890: 7472 6962 7574 6520 6974 2061 6e64 2f6f tribute it and/o │ │ │ +0020f8a0: 7220 6d6f 6469 6679 2069 740a 202d 2020 r modify it. - │ │ │ +0020f8b0: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ +0020f8c0: 6f66 2074 6865 2047 4e55 2047 656e 6572 of the GNU Gener │ │ │ +0020f8d0: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ +0020f8e0: 6520 6173 2070 7562 6c69 7368 6564 2062 e as published b │ │ │ +0020f8f0: 7920 7468 650a 202d 2020 4672 6565 2053 y the. - Free S │ │ │ +0020f900: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ +0020f910: 6f6e 3b20 6f6e 6c79 2076 6572 7369 6f6e on; only version │ │ │ +0020f920: 2032 206f 6620 7468 6520 4c69 6365 6e73 2 of the Licens │ │ │ +0020f930: 652c 2064 6174 6564 204a 756e 6520 3139 e, dated June 19 │ │ │ +0020f940: 3931 2e0a 202d 2020 0a20 2d20 2054 6869 91.. - . - Thi │ │ │ +0020f950: 7320 7072 6f67 7261 6d20 6973 2064 6973 s program is dis │ │ │ +0020f960: 7472 6962 7574 6564 2069 6e20 7468 6520 tributed in the │ │ │ +0020f970: 686f 7065 2074 6861 7420 6974 2077 696c hope that it wil │ │ │ +0020f980: 6c20 6265 2075 7365 6675 6c2c 2062 7574 l be useful, but │ │ │ +0020f990: 0a20 2d20 2057 4954 484f 5554 2041 4e59 . - WITHOUT ANY │ │ │ +0020f9a0: 2057 4152 5241 4e54 593b 2077 6974 686f WARRANTY; witho │ │ │ +0020f9b0: 7574 2065 7665 6e20 7468 6520 696d 706c ut even the impl │ │ │ +0020f9c0: 6965 6420 7761 7272 616e 7479 206f 660a ied warranty of. │ │ │ +0020f9d0: 202d 2020 4d45 5243 4841 4e54 4142 494c - MERCHANTABIL │ │ │ +0020f9e0: 4954 5920 6f72 2046 4954 4e45 5353 2046 ITY or FITNESS F │ │ │ +0020f9f0: 4f52 2041 2050 4152 5449 4355 4c41 5220 OR A PARTICULAR │ │ │ +0020fa00: 5055 5250 4f53 452e 2053 6565 2074 6865 PURPOSE. See the │ │ │ +0020fa10: 2047 4e55 0a20 2d20 2047 656e 6572 616c GNU. - General │ │ │ +0020fa20: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +0020fa30: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ +0020fa40: 2e0a 202d 2020 0a20 2d20 2059 6f75 2073 .. - . - You s │ │ │ +0020fa50: 686f 756c 6420 6861 7665 2072 6563 6569 hould have recei │ │ │ +0020fa60: 7665 6420 6120 636f 7079 206f 6620 7468 ved a copy of th │ │ │ +0020fa70: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ +0020fa80: 626c 6963 204c 6963 656e 7365 2061 6c6f blic License alo │ │ │ +0020fa90: 6e67 0a20 2d20 2077 6974 6820 7468 6973 ng. - with this │ │ │ +0020faa0: 2070 726f 6772 616d 3b20 6966 206e 6f74 program; if not │ │ │ +0020fab0: 2c20 7772 6974 6520 746f 2074 6865 2046 , write to the F │ │ │ +0020fac0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ +0020fad0: 6e64 6174 696f 6e2c 2049 6e63 2e2c 0a20 ndation, Inc.,. │ │ │ +0020fae0: 2d20 2035 3120 4672 616e 6b6c 696e 2053 - 51 Franklin S │ │ │ +0020faf0: 742c 2046 6966 7468 2046 6c6f 6f72 2c20 t, Fifth Floor, │ │ │ +0020fb00: 426f 7374 6f6e 2c20 4d41 2030 3231 3130 Boston, MA 02110 │ │ │ +0020fb10: 2d31 3330 3120 5553 410a 202d 2020 0a20 -1301 USA. - . │ │ │ +0020fb20: 2d20 200a 2d2d 3e0a 3c72 6566 656e 7472 - .-->.<refentr │ │ │ +0020fb30: 7920 6964 3d22 666e 5f67 7a5f 636f 6d70 y id="fn_gz_comp │ │ │ +0020fb40: 7265 7373 223e 0a20 203c 7265 666d 6574 ress">. <refmet │ │ │ +0020fb50: 613e 0a20 2020 203c 7265 6665 6e74 7279 a>. <refentry │ │ │ +0020fb60: 7469 746c 653e 677a 5f63 6f6d 7072 6573 title>gz_compres │ │ │ +0020fb70: 733c 2f72 6566 656e 7472 7974 6974 6c65 s</refentrytitle │ │ │ +0020fb80: 3e0a 2020 2020 3c72 6566 6d69 7363 696e >. <refmiscin │ │ │ +0020fb90: 666f 3e63 6f6d 7072 6573 7369 6f6e 3c2f fo>compression</ │ │ │ +0020fba0: 7265 666d 6973 6369 6e66 6f3e 0a20 203c refmiscinfo>. < │ │ │ +0020fbb0: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. <ref │ │ │ +0020fbc0: 6e61 6d65 6469 763e 0a20 2020 203c 7265 namediv>. <re │ │ │ +0020fbd0: 666e 616d 653e 677a 5f63 6f6d 7072 6573 fname>gz_compres │ │ │ +0020fbe0: 733c 2f72 6566 6e61 6d65 3e0a 2020 2020 s</refname>. │ │ │ +0020fbf0: 3c72 6566 7075 7270 6f73 653e 436f 6d70 <refpurpose>Comp │ │ │ +0020fc00: 7265 7373 2064 6174 6120 7573 696e 6720 ress data using │ │ │ +0020fc10: 677a 6970 2061 6c67 6f72 6974 686d 3c2f gzip algorithm</ │ │ │ +0020fc20: 7265 6670 7572 706f 7365 3e0a 2020 3c2f refpurpose>. </ │ │ │ +0020fc30: 7265 666e 616d 6564 6976 3e0a 2020 3c72 refnamediv>. <r │ │ │ +0020fc40: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ +0020fc50: 2020 203c 6675 6e63 7379 6e6f 7073 6973 <funcsynopsis │ │ │ +0020fc60: 2069 643d 2266 7379 6e5f 677a 5f63 6f6d id="fsyn_gz_com │ │ │ +0020fc70: 7072 6573 7322 3e0a 2020 2020 2020 3c66 press">. <f │ │ │ +0020fc80: 756e 6370 726f 746f 7479 7065 2069 643d uncprototype id= │ │ │ +0020fc90: 2266 7072 6f74 6f5f 677a 5f63 6f6d 7072 "fproto_gz_compr │ │ │ +0020fca0: 6573 7322 3e0a 2020 2020 2020 2020 3c66 ess">. <f │ │ │ +0020fcb0: 756e 6364 6566 3e3c 6675 6e63 7469 6f6e uncdef><function │ │ │ +0020fcc0: 3e67 7a5f 636f 6d70 7265 7373 3c2f 6675 >gz_compress</fu │ │ │ +0020fcd0: 6e63 7469 6f6e 3e3c 2f66 756e 6364 6566 nction></funcdef │ │ │ +0020fce0: 3e0a 2020 2020 2020 2020 3c70 6172 616d >. <param │ │ │ +0020fcf0: 6465 663e 696e 203c 7061 7261 6d65 7465 def>in <paramete │ │ │ +0020fd00: 723e 7374 723c 2f70 6172 616d 6574 6572 r>str</parameter │ │ │ +0020fd10: 3e20 7661 7263 6861 723c 2f70 6172 616d > varchar</param │ │ │ +0020fd20: 6465 663e 0a20 2020 2020 203c 2f66 756e def>. </fun │ │ │ +0020fd30: 6370 726f 746f 7479 7065 3e0a 2020 2020 cprototype>. │ │ │ +0020fd40: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a </funcsynopsis>. │ │ │ +0020fd50: 2020 3c2f 7265 6673 796e 6f70 7369 7364 </refsynopsisd │ │ │ +0020fd60: 6976 3e0a 2020 3c72 6566 7365 6374 3120 iv>. <refsect1 │ │ │ +0020fd70: 6964 3d22 6465 7363 5f63 6f6d 7072 6573 id="desc_compres │ │ │ +0020fd80: 7322 3e3c 7469 746c 653e 4465 7363 7269 s"><title>Descri │ │ │ +0020fd90: 7074 696f 6e3c 2f74 6974 6c65 3e0a 093c ption..< │ │ │ +0020fda0: 7061 7261 3e0a 5468 6520 677a 5f63 6f6d para>.The gz_com │ │ │ +0020fdb0: 7072 6573 7320 7265 7475 726e 7320 6974 press returns it │ │ │ +0020fdc0: 7320 6172 6775 6d65 6e74 2063 6f6d 7072 s argument compr │ │ │ +0020fdd0: 6573 7365 6420 7769 7468 2074 6865 2067 essed with the g │ │ │ +0020fde0: 7a69 700a 616c 676f 7269 7468 6d2e 2054 zip.algorithm. T │ │ │ +0020fdf0: 6865 2061 7267 756d 656e 7420 616e 6420 he argument and │ │ │ +0020fe00: 7265 7475 726e 2076 616c 7565 7320 6172 return values ar │ │ │ +0020fe10: 6520 6172 6269 7472 6172 7920 7374 7269 e arbitrary stri │ │ │ +0020fe20: 6e67 732c 0a70 6f73 7369 626c 7920 696e ngs,.possibly in │ │ │ +0020fe30: 636c 7564 696e 6720 616e 7920 3820 6269 cluding any 8 bi │ │ │ +0020fe40: 7420 6368 6172 6163 7465 7273 2e0a 093c t characters...< │ │ │ +0020fe50: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . . Parameters< │ │ │ +0020fea0: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. str │ │ │ +0020fec0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +0020fed0: 7061 7261 3e54 6865 2073 7472 696e 6720 para>The string │ │ │ +0020fee0: 636f 6e74 6169 6e69 6e67 2064 6174 6120 containing data │ │ │ +0020fef0: 746f 2062 6520 636f 6d70 7265 7373 6564 to be compressed │ │ │ +0020ff00: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . R │ │ │ +0020ff50: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ +0020ff60: 6c65 3e0a 2020 2020 3c70 6172 613e 4120 le>. <para>A │ │ │ +0020ff70: 7374 7269 6e67 2063 6f6e 7461 696e 696e string containin │ │ │ +0020ff80: 6720 7468 6520 636f 6d70 7265 7373 6564 g the compressed │ │ │ +0020ff90: 2064 6174 612e 3c2f 7061 7261 3e0a 2020 data.</para>. │ │ │ +0020ffa0: 3c2f 7265 6673 6563 7431 3e0a 3c21 2d2d </refsect1>.<!-- │ │ │ +0020ffb0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +0020ffc0: 6572 726f 7273 5f67 7a5f 636f 6d70 7265 errors_gz_compre │ │ │ +0020ffd0: 7373 223e 0a20 2020 203c 7469 746c 653e ss">. <title> │ │ │ +0020ffe0: 4572 726f 7273 3c2f 7469 746c 653e 0a20 Errors. │ │ │ +0020fff0: 2020 203c 7461 626c 653e 0a20 2020 2020
    . │ │ │ +00210000: 203c 7469 746c 653e 4572 726f 7273 2073 Errors s │ │ │ +00210010: 6967 6e61 6c6c 6564 2062 793c 2f74 6974 ignalled by</tit │ │ │ +00210020: 6c65 3e0a 2020 2020 2020 3c74 6772 6f75 le>. <tgrou │ │ │ +00210030: 7020 636f 6c73 3d22 3422 3e0a 2020 2020 p cols="4">. │ │ │ +00210040: 2020 203c 7468 6561 643e 0a20 2020 2020 <thead>. │ │ │ +00210050: 2020 2020 3c72 6f77 3e0a 2020 2020 2020 <row>. │ │ │ +00210060: 2020 2020 203c 656e 7472 793e 5351 4c53 <entry>SQLS │ │ │ +00210070: 7461 7465 3c2f 656e 7472 793e 0a20 2020 tate</entry>. │ │ │ +00210080: 2020 2020 2020 2020 3c65 6e74 7279 3e45 <entry>E │ │ │ +00210090: 7272 6f72 2043 6f64 653c 2f65 6e74 7279 rror Code</entry │ │ │ +002100a0: 3e0a 2020 2020 2020 2020 2020 203c 656e >. <en │ │ │ +002100b0: 7472 793e 4572 726f 7220 5465 7874 3c2f try>Error Text</ │ │ │ +002100c0: 656e 7472 793e 0a20 2020 2020 2020 2020 entry>. │ │ │ +002100d0: 2020 3c65 6e74 7279 3e44 6573 6372 6970 <entry>Descrip │ │ │ +002100e0: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion</entry></ro │ │ │ +002100f0: 773e 3c2f 7468 6561 643e 0a09 3c74 626f w></thead>..<tbo │ │ │ +00210100: 6479 3e0a 0920 203c 726f 773e 0a09 2020 dy>.. <row>.. │ │ │ +00210110: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 <entry><errorc │ │ │ +00210120: 6f64 653e 3c2f 6572 726f 7263 6f64 653e ode></errorcode> │ │ │ +00210130: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 </entry>.. <e │ │ │ +00210140: 6e74 7279 3e3c 6572 726f 7263 6f64 653e ntry><errorcode> │ │ │ +00210150: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e </errorcode></en │ │ │ +00210160: 7472 793e 0a09 2020 2020 3c65 6e74 7279 try>.. <entry │ │ │ +00210170: 3e3c 6572 726f 726e 616d 653e 3c2f 6572 ><errorname></er │ │ │ +00210180: 726f 726e 616d 653e 3c2f 656e 7472 793e rorname></entry> │ │ │ +00210190: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. <entry></e │ │ │ +002101a0: 6e74 7279 3e0a 0920 203c 2f72 6f77 3e0a ntry>.. </row>. │ │ │ +002101b0: 093c 2f74 626f 6479 3e0a 2020 2020 2020 .</tbody>. │ │ │ +002101c0: 3c2f 7467 726f 7570 3e0a 2020 2020 3c2f </tgroup>. </ │ │ │ +002101d0: 7461 626c 653e 0a20 203c 2f72 6566 7365 table>. </refse │ │ │ +002101e0: 6374 313e 202d 2d3e 0a20 203c 7265 6673 ct1> -->. <refs │ │ │ +002101f0: 6563 7431 2069 643d 2265 7861 6d70 6c65 ect1 id="example │ │ │ +00210200: 735f 677a 5f63 6f6d 7072 6573 7322 3e0a s_gz_compress">. │ │ │ +00210210: 2020 2020 3c74 6974 6c65 3e45 7861 6d70 <title>Examp │ │ │ +00210220: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ +00210230: 3c65 7861 6d70 6c65 2069 643d 2265 785f < │ │ │ +00210250: 7469 746c 653e 475a 4950 2074 6573 7420 title>GZIP test │ │ │ +00210260: 323c 2f74 6974 6c65 3e0a 2020 2020 2020 2. │ │ │ +00210270: 3c70 6172 613e 4a75 7374 2073 6565 2068 Just see h │ │ │ +00210280: 6f77 2069 7420 636f 6d70 7265 7373 6573 ow it compresses │ │ │ +00210290: 2e3c 2f70 6172 613e 0a20 2020 2020 203c .. < │ │ │ +002102a0: 7363 7265 656e 3e63 7265 6174 6520 7072 screen>create pr │ │ │ +002102b0: 6f63 6564 7572 650a 677a 5f74 6573 745f ocedure.gz_test_ │ │ │ +002102c0: 3220 2869 6e20 7374 7220 7661 7263 6861 2 (in str varcha │ │ │ +002102d0: 7229 0a7b 0a20 2064 6563 6c61 7265 2072 r).{. declare r │ │ │ +002102e0: 6573 2061 6e79 3b0a 2020 6465 636c 6172 es any;. declar │ │ │ +002102f0: 6520 5f6f 7574 2076 6172 6368 6172 3b0a e _out varchar;. │ │ │ +00210300: 2020 6465 636c 6172 6520 5f6c 656e 2069 declare _len i │ │ │ +00210310: 6e74 6567 6572 3b0a 0a20 2072 6573 756c nteger;.. resul │ │ │ +00210320: 745f 6e61 6d65 7320 285f 6f75 742c 205f t_names (_out, _ │ │ │ +00210330: 6c65 6e29 3b0a 0a20 2072 6573 203a 3d20 len);.. res := │ │ │ +00210340: 7374 7269 6e67 5f6f 7574 7075 7420 2829 string_output () │ │ │ +00210350: 3b0a 2020 7265 7375 6c74 2028 7374 722c ;. result (str, │ │ │ +00210360: 206c 656e 6774 6820 2873 7472 2929 3b0a length (str));. │ │ │ +00210370: 2020 7374 7220 3a3d 2067 7a5f 636f 6d70 str := gz_comp │ │ │ +00210380: 7265 7373 2028 7374 7229 3b0a 2020 7265 ress (str);. re │ │ │ +00210390: 7375 6c74 2028 2762 696e 6172 7927 2c20 sult ('binary', │ │ │ +002103a0: 6c65 6e67 7468 2028 7374 7229 293b 0a20 length (str));. │ │ │ +002103b0: 2067 7a5f 756e 636f 6d70 7265 7373 2028 gz_uncompress ( │ │ │ +002103c0: 7374 722c 2072 6573 293b 0a20 2072 6573 str, res);. res │ │ │ +002103d0: 756c 7420 2872 6573 2c20 6c65 6e67 7468 ult (res, length │ │ │ +002103e0: 2028 7265 7329 293b 0a7d 0a0a 0a53 514c (res));.}...SQL │ │ │ +002103f0: 3e20 677a 5f74 6573 745f 3220 2827 6630 > gz_test_2 ('f0 │ │ │ +00210400: 3066 2066 3030 6620 6d30 3035 3320 3220 0f f00f m0053 2 │ │ │ +00210410: 7733 7220 6834 7830 7237 2063 6830 3032 w3r h4x0r7 ch002 │ │ │ +00210420: 2030 3030 3030 3030 3030 3030 3030 3030 000000000000000 │ │ │ +00210430: 3030 3030 3030 3030 2729 3b0a 5f6f 7574 00000000');._out │ │ │ +00210440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00210450: 2020 2020 2020 5f6c 656e 0a56 4152 4348 _len.VARCH │ │ │ +00210460: 4152 2020 2020 2020 2020 2020 2020 2020 AR │ │ │ +00210470: 2020 2020 2049 4e54 4547 4552 0a5f 5f5f INTEGER.___ │ │ │ +00210480: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00210490: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002104a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002104b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002104c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 6630 ____________..f0 │ │ │ +002104d0: 3066 2066 3030 6620 6d30 3035 3320 3520 0f f00f m0053 5 │ │ │ +002104e0: 7733 7220 6834 7830 7237 2063 6830 3032 w3r h4x0r7 ch002 │ │ │ +002104f0: 2030 3030 3030 3030 3030 3030 3030 3030 000000000000000 │ │ │ +00210500: 3030 3030 3030 3030 2020 3538 0a62 696e 00000000 58.bin │ │ │ +00210510: 6172 7920 2020 2020 2020 2020 2020 2020 ary │ │ │ +00210520: 2020 2020 2020 2034 330a 6630 3066 2066 43.f00f f │ │ │ +00210530: 3030 6620 6d30 3035 3320 3520 7733 7220 00f m0053 5 w3r │ │ │ +00210540: 6834 7830 7237 2063 6830 3032 2030 3030 h4x0r7 ch002 000 │ │ │ +00210550: 3030 3030 3030 3030 3030 3030 3030 3030 0000000000000000 │ │ │ +00210560: 3030 3030 2020 3538 0a0a 3320 526f 7773 0000 58..3 Rows │ │ │ +00210570: 2e20 2d2d 2031 3020 6d73 6563 2e0a 5351 . -- 10 msec..SQ │ │ │ +00210580: 4c3e 0a0a 3c2f 7363 7265 656e 3e0a 2020 L>... │ │ │ +00210590: 2020 3c2f 6578 616d 706c 653e 0a20 203c . < │ │ │ +002105a0: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. │ │ │ +002105d0: 0a20 2020 203c 7469 746c 653e 5365 6520 . See │ │ │ +002105e0: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ +002105f0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e gz_uncompress< │ │ │ +00210630: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. st │ │ │ +00210680: 7269 6e67 5f6f 7574 7075 745f 677a 5f63 ring_output_gz_c │ │ │ +00210690: 6f6d 7072 6573 733c 2f66 756e 6374 696f ompress,. < │ │ │ +002106b0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +002106c0: 5f73 7472 696e 675f 6f75 7470 7574 223e _string_output"> │ │ │ +002106d0: 3c66 756e 6374 696f 6e3e 7374 7269 6e67 string │ │ │ +002106e0: 5f6f 7574 7075 743c 2f66 756e 6374 696f _output.. . │ │ │ +00210710: 3c2f 7265 6665 6e74 7279 3e0a 0a0a b600 ..... │ │ │ +00210720: 0000 2364 656d 6f2f 646f 6373 7263 2f66 ..#demo/docsrc/f │ │ │ +00210730: 756e 6372 6566 2f73 6861 315f 6469 6765 uncref/sha1_dige │ │ │ +00210740: 7374 2e78 6d6c df00 000b 093c 3f78 6d6c st.xml........ . sha1_dig │ │ │ +00210b10: 6573 743c 2f72 6566 656e 7472 7974 6974 est. hash. . . sha1_digest. returns s │ │ │ +00210ba0: 7472 696e 6720 636f 6e74 6169 6e69 6e67 tring containing │ │ │ +00210bb0: 2073 6861 3120 6469 6765 7374 2065 6e63 sha1 digest enc │ │ │ +00210bc0: 6f64 6564 2069 6e20 6261 7365 3634 3c2f oded in base64. . . │ │ │ +00210c00: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . . sha1_ │ │ │ +00210c70: 6469 6765 7374 3c2f 6675 6e63 7469 6f6e digest. │ │ │ +00210c90: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ +00210ca0: 7061 7261 6d65 7465 723e 7374 723c 2f70 parameter>str

    varcha │ │ │ +00210cc0: 723c 2f70 6172 616d 6465 663e 0a20 2020 r
    . │ │ │ +00210cd0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . Description</ti │ │ │ +00210d40: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +00210d50: 3e52 6574 7572 6e73 2073 7472 696e 6720 >Returns string │ │ │ +00210d60: 636f 6e74 6169 6e69 6e67 2073 6861 3120 containing sha1 │ │ │ +00210d70: 6469 6765 7374 2065 6e63 6f64 6564 2069 digest encoded i │ │ │ +00210d80: 6e20 6261 7365 3634 2e20 5468 6973 2066 n base64. This f │ │ │ +00210d90: 756e 6374 696f 6e20 6861 7320 616e 2061 unction has an a │ │ │ +00210da0: 6c69 6173 3a20 7865 6e63 5f73 6861 315f lias: xenc_sha1_ │ │ │ +00210db0: 6469 6765 7374 2028 292e 3c2f 7061 7261 digest ().</para │ │ │ +00210dc0: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ +00210dd0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +00210de0: 7061 7261 6d73 5f73 6861 315f 6469 6765 params_sha1_dige │ │ │ +00210df0: 7374 223e 3c74 6974 6c65 3e50 6172 616d st"><title>Param │ │ │ +00210e00: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ +00210e10: 2020 3c72 6566 7365 6374 323e 3c74 6974 st │ │ │ +00210e30: 723c 2f70 6172 616d 6574 6572 3e3c 2f74 r. A varcha │ │ │ +00210e60: 723c 2f74 7970 653e 2076 616c 7565 2e3c r value.< │ │ │ +00210e70: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . Ret │ │ │ +00210ec0: 7572 6e20 5661 6c75 6573 3c2f 7469 746c urn Values</titl │ │ │ +00210ed0: 653e 0a20 2020 203c 7061 7261 3e3c 6675 e>. <para><fu │ │ │ +00210ee0: 6e63 7469 6f6e 3e73 6861 315f 6469 6765 nction>sha1_dige │ │ │ +00210ef0: 7374 3c2f 6675 6e63 7469 6f6e 3e20 7265 st</function> re │ │ │ +00210f00: 7475 726e 7320 6120 3c74 7970 653e 7661 turns a <type>va │ │ │ +00210f10: 7263 6861 723c 2f74 7970 653e 0a20 2020 rchar</type>. │ │ │ +00210f20: 2063 6f6e 7461 696e 696e 6720 7368 6131 containing sha1 │ │ │ +00210f30: 2064 6967 6573 7420 656e 636f 6465 6420 digest encoded │ │ │ +00210f40: 696e 2062 6173 6536 342e 203c 2f70 6172 in base64. </par │ │ │ +00210f50: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +00210f60: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +00210f70: 2265 7861 6d70 6c65 735f 7368 6131 5f64 "examples_sha1_d │ │ │ +00210f80: 6967 6573 7422 3e3c 7469 746c 653e 4578 igest"><title>Ex │ │ │ +00210f90: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ +00210fa0: 2020 203c 6578 616d 706c 6520 6964 3d22 Simple │ │ │ +00210fd0: 4578 616d 706c 653c 2f74 6974 6c65 3e0a Example. │ │ │ +00210fe0: 2020 2020 2020 3c70 6172 613e 4261 7365 Base │ │ │ +00210ff0: 3634 2d65 6e63 6f64 6520 6120 7374 7269 64-encode a stri │ │ │ +00211000: 6e67 3c2f 7061 7261 3e0a 2020 2020 2020 ng. │ │ │ +00211010: 3c73 6372 6565 6e3e 5351 4c3e 2073 656c SQL> sel │ │ │ +00211020: 6563 7420 7368 6131 5f64 6967 6573 7428 ect sha1_digest( │ │ │ +00211030: 2764 656d 6f64 656d 6f27 293b 0a63 616c 'demodemo');.cal │ │ │ +00211040: 6c72 6574 0a56 4152 4348 4152 0a5f 5f5f lret.VARCHAR.___ │ │ │ +00211050: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00211060: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00211070: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00211080: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00211090: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a 3538 ____________..58 │ │ │ +002110a0: 3633 6439 6534 6362 6466 3532 3265 6161 63d9e4cbdf522eaa │ │ │ +002110b0: 3632 6530 3734 3766 6365 6231 6335 6232 62e0747fceb1c5b2 │ │ │ +002110c0: 3439 6261 3133 0a0a 3120 526f 7773 2e20 49ba13..1 Rows. │ │ │ +002110d0: 2d2d 2032 3520 6d73 6563 2e0a 3c2f 7363 -- 25 msec... . . S │ │ │ +00211130: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ +00211140: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 encode_base │ │ │ +00211180: 3634 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 64. │ │ │ +002111a0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b md5. serialize │ │ │ +00211230: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . ........-demo/do │ │ │ +00211260: 6373 7263 2f66 756e 6372 6566 2f58 4d4c csrc/funcref/XML │ │ │ +00211270: 5479 7065 2e69 7353 6368 656d 6156 616c Type.isSchemaVal │ │ │ +00211280: 6964 2e78 6d6c df00 0012 af3c 3f78 6d6c id.xml....... │ │ │ +00211640: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ +00211650: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ +00211660: 584d 4c54 7970 652e 6973 5363 6865 6d61 XMLType.isSchema │ │ │ +00211670: 5661 6c69 643c 2f72 6566 656e 7472 7974 Valid. xml. . . XMLType.isSche │ │ │ +002116e0: 6d61 5661 6c69 643c 2f72 6566 6e61 6d65 maValid. Validates the │ │ │ +00211710: 6769 7665 6e20 584d 4c54 7970 6520 696e given XMLType in │ │ │ +00211720: 7374 616e 6365 2061 6761 696e 7374 2061 stance against a │ │ │ +00211730: 6e20 6172 6269 7472 6172 7920 584d 4c20 n arbitrary XML │ │ │ +00211740: 7363 6865 6d61 2c20 7265 7475 726e 7320 schema, returns │ │ │ +00211750: 3120 6966 2073 7563 6365 7373 6675 6c2c 1 if successful, │ │ │ +00211760: 2030 2069 6620 6572 726f 7273 2061 7265 0 if errors are │ │ │ +00211770: 2064 6574 6563 7465 642e 3c2f 7265 6670 detected.
    . . . < │ │ │ +002117b0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +002117c0: 2266 7379 6e5f 584d 4c54 7970 652e 6973 "fsyn_XMLType.is │ │ │ +002117d0: 5363 6865 6d61 5661 6c69 6422 3e0a 2020 SchemaValid">. │ │ │ +002117e0: 2020 2020 3c66 756e 6370 726f 746f 7479 . XMLType.isSchem │ │ │ +00211840: 6156 616c 6964 3c2f 6675 6e63 7469 6f6e aValid..in s │ │ │ +00211880: 6368 656d 615f 7572 6c3c 2f70 6172 616d chema_url varchar..< │ │ │ +002118c0: 6f70 7469 6f6e 616c 3e69 6e20 3c70 6172 optional>in top_eleme │ │ │ +002118e0: 6e74 5f6e 616d 653c 2f70 6172 616d 6574 nt_name varchar. . . < │ │ │ +00211940: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ +00211950: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ +00211980: 2020 3c74 6974 6c65 3e44 6573 6372 6970 Descrip │ │ │ +00211990: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ +002119a0: 203c 7061 7261 3e54 6865 2066 756e 6374 The funct │ │ │ +002119b0: 696f 6e20 7661 6c69 6461 7465 7320 7468 ion validates th │ │ │ +002119c0: 6520 6769 7665 6e20 584d 4c54 7970 6520 e given XMLType │ │ │ +002119d0: 696e 7374 616e 6365 2061 6761 696e 7374 instance against │ │ │ +002119e0: 2074 6865 2058 4d4c 200a 0973 6368 656d the XML ..schem │ │ │ +002119f0: 6120 6c6f 6361 7465 6420 6174 203c 7061 a located at schema_u │ │ │ +00211a10: 726c 3c2f 7061 7261 6d65 7465 723e 2e20 rl. │ │ │ +00211a20: 2054 6865 206e 616d 6520 6f66 2074 6865 The name of the │ │ │ +00211a30: 200a 0963 7572 7265 6e74 206e 6f64 6520 ..current node │ │ │ +00211a40: 6f66 2074 6865 2058 4d4c 2065 6e74 6974 of the XML entit │ │ │ +00211a50: 7920 7368 6f75 6c64 206d 6174 6368 203c y should match < │ │ │ +00211a60: 7061 7261 6d65 7465 723e 746f 705f 656c parameter>top_el │ │ │ +00211a70: 656d 656e 745f 6e61 6d65 3c2f 7061 7261 ement_name ..if it i │ │ │ +00211a90: 7320 7370 6563 6966 6965 642e 3c2f 7061 s specified. ..The │ │ │ +00211ab0: 203c 7061 7261 6d65 7465 723e 7363 6865 sche │ │ │ +00211ac0: 6d61 5f75 726c 3c2f 7061 7261 6d65 7465 ma_url is optional f │ │ │ +00211ae0: 6f72 2073 6368 656d 6120 6261 7365 6420 or schema based │ │ │ +00211af0: 0a09 696e 7374 616e 6365 733a 2074 6865 ..instances: the │ │ │ +00211b00: 2064 6566 6175 6c74 2076 616c 7565 2069 default value i │ │ │ +00211b10: 7320 7468 6520 5552 4920 6f66 2074 6865 s the URI of the │ │ │ +00211b20: 2061 7373 6f63 6961 7465 6420 7363 6865 associated sche │ │ │ +00211b30: 6d61 206f 6620 7468 6520 0a09 696e 7374 ma of the ..inst │ │ │ +00211b40: 616e 6365 2e20 2046 6f72 206e 6f6e 2d73 ance. For non-s │ │ │ +00211b50: 6368 656d 6120 6261 7365 6420 696e 7374 chema based inst │ │ │ +00211b60: 616e 6365 7320 7468 6520 3c70 6172 616d ances the schema_url< │ │ │ +00211b80: 2f70 6172 616d 6574 6572 3e20 200a 0969 /parameter> ..i │ │ │ +00211b90: 7320 7265 7175 6972 6564 2c20 616e 2065 s required, an e │ │ │ +00211ba0: 7272 6f72 2069 7320 7369 676e 616c 6c65 rror is signalle │ │ │ +00211bb0: 6420 6f74 6865 7277 6973 652e 3c2f 7061 d otherwise.. Th │ │ │ +00211bd0: 6520 6675 6e63 7469 6f6e 2064 6f65 7320 e function does │ │ │ +00211be0: 6e6f 7420 7573 6520 6f72 206d 6f64 6966 not use or modif │ │ │ +00211bf0: 7920 696e 7465 726e 616c 2026 7175 6f74 y internal " │ │ │ +00211c00: 3b76 616c 6964 6174 6564 2671 756f 743b ;validated" │ │ │ +00211c10: 200a 0966 6c61 6720 7468 6174 2069 7320 ..flag that is │ │ │ +00211c20: 652e 672e 2075 7365 6420 6279 203c 6675 e.g. used by XMLType.s │ │ │ +00211c40: 6368 656d 6156 616c 6964 6174 6528 293c chemaValidate()< │ │ │ +00211c50: 2f66 756e 6374 696f 6e3e 2e0a 0949 7420 /function>...It │ │ │ +00211c60: 6973 2074 7275 6520 6576 656e 2069 6620 is true even if │ │ │ +00211c70: 7468 6520 6769 7665 6e20 3c70 6172 616d the given schema_url< │ │ │ +00211c90: 2f70 6172 616d 6574 6572 3e20 6973 2065 /parameter> is e │ │ │ +00211ca0: 7175 616c 2074 6f20 7468 6520 5552 4920 qual to the URI │ │ │ +00211cb0: 0a09 6f66 206f 776e 2073 6368 656d 6120 ..of own schema │ │ │ +00211cc0: 6f66 2074 6865 2069 6e73 7461 6e63 652e of the instance. │ │ │ +00211cd0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . │ │ │ +00211d20: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ +00211d30: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ +00211d40: 3e3c 7469 746c 653e 7363 6865 6d61 5f75 ><title>schema_u │ │ │ +00211d50: 726c 3c2f 7469 746c 653e 0a20 2020 2020 rl. │ │ │ +00211d60: 203c 7061 7261 3e54 6865 2055 5249 206f The URI o │ │ │ +00211d70: 6620 7468 6520 7363 6865 6d61 2074 6f20 f the schema to │ │ │ +00211d80: 6170 706c 792e 3c2f 7061 7261 3e0a 2020 apply.. │ │ │ +00211d90: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +00211da0: 2020 3c72 6566 7365 6374 323e 3c74 6974 top_element_n │ │ │ +00211dc0: 616d 653c 2f74 6974 6c65 3e0a 2020 2020 ame. │ │ │ +00211dd0: 2020 3c70 6172 613e 5468 6520 616c 6c6f The allo │ │ │ +00211de0: 7765 6420 6e61 6d65 206f 6620 746f 7020 wed name of top │ │ │ +00211df0: 6c65 7665 6c20 656c 656d 656e 7420 6f66 level element of │ │ │ +00211e00: 2074 6865 2069 6e73 7461 6e63 652e 3c2f the instance.. . . < │ │ │ +00211e60: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ +00211e70: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ +00211e80: 7061 7261 3e54 6865 2066 756e 6374 696f para>The functio │ │ │ +00211e90: 6e20 7265 7475 726e 7320 3120 6966 2074 n returns 1 if t │ │ │ +00211ea0: 6865 2076 616c 6964 6174 696f 6e20 6973 he validation is │ │ │ +00211eb0: 2070 6173 7365 642c 2030 2069 6620 6974 passed, 0 if it │ │ │ +00211ec0: 2069 7320 6661 696c 6564 2e3c 2f70 6172 is failed.. │ │ │ +00211ee0: 0a3c 212d 2d0a 2020 3c72 6566 7365 6374 ... │ │ │ -00212f00: 3c72 6566 6d65 7461 3e0a 2020 2020 3c72 . xml │ │ │ -00212f20: 5f61 7574 6f5f 6474 643c 2f72 6566 656e _auto_dtd. xml. < │ │ │ -00212f60: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . xml_auto_d │ │ │ -00212f90: 7464 3c2f 7265 666e 616d 653e 0a20 2020 td. │ │ │ -00212fa0: 203c 7265 6670 7572 706f 7365 3e72 6574 ret │ │ │ -00212fb0: 7572 6e73 2061 6e20 584d 4c20 4454 4420 urns an XML DTD │ │ │ -00212fc0: 666f 7220 7468 6520 7265 7375 6c74 206f for the result o │ │ │ -00212fd0: 6620 6120 5351 4c20 7175 6572 7920 7769 f a SQL query wi │ │ │ -00212fe0: 7468 2061 2046 4f52 2058 4d4c 2063 6c61 th a FOR XML cla │ │ │ -00212ff0: 7573 653c 2f72 6566 7075 7270 6f73 653e use │ │ │ -00213000: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -00213010: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . │ │ │ -00213050: 2020 2020 3c66 756e 6370 726f 746f 7479 . │ │ │ -00213080: 2020 2020 203c 6675 6e63 6465 663e 7661 va │ │ │ -00213090: 7263 6861 7220 3c66 756e 6374 696f 6e3e rchar │ │ │ -002130a0: 786d 6c5f 6175 746f 5f64 7464 3c2f 6675 xml_auto_dtd. in query varchar. < │ │ │ -00213110: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in root_elem │ │ │ -00213130: 656e 743c 2f70 6172 616d 6574 6572 3e20 ent │ │ │ -00213140: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar. . . < │ │ │ -00213180: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -00213190: 0a20 203c 7265 6673 6563 7431 2069 643d . Descr │ │ │ -002131c0: 6970 7469 6f6e 3c2f 7469 746c 653e 0a3c iption.< │ │ │ -002131d0: 7061 7261 3e54 6869 7320 6675 6e63 7469 para>This functi │ │ │ -002131e0: 6f6e 2072 6574 7572 6e73 2061 6e20 584d on returns an XM │ │ │ -002131f0: 4c20 4454 4420 666f 7220 7468 6520 7265 L DTD for the re │ │ │ -00213200: 7375 6c74 7320 6f66 2061 2053 514c 2071 sults of a SQL q │ │ │ -00213210: 7565 7279 2077 6974 680a 6120 464f 5220 uery with.a FOR │ │ │ -00213220: 584d 4c20 636c 6175 7365 2e20 2054 6865 XML clause. The │ │ │ -00213230: 2072 6574 7572 6e65 6420 4454 4420 7769 returned DTD wi │ │ │ -00213240: 6c6c 2061 7070 6c79 2074 6f20 7468 6520 ll apply to the │ │ │ -00213250: 6f75 7470 7574 2067 656e 6572 6174 6564 output generated │ │ │ -00213260: 0a62 7920 786d 6c5f 6175 746f 2077 6974 .by xml_auto wit │ │ │ -00213270: 6820 7468 6520 7175 6572 7920 696e 2071 h the query in q │ │ │ -00213280: 7565 7374 696f 6e20 6166 7465 7220 7772 uestion after wr │ │ │ -00213290: 6170 7069 6e67 2069 7420 696e 746f 2074 apping it into t │ │ │ -002132a0: 6865 2073 7065 6369 6669 6564 2072 6f6f he specified roo │ │ │ -002132b0: 7420 656c 656d 656e 742e 0a3c 2f70 6172 t element... │ │ │ -002132d0: 0a20 203c 7265 6673 6563 7431 2069 643d . Par │ │ │ -00213300: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -00213310: 2020 2020 3c72 6566 7365 6374 323e 3c74 query. v │ │ │ -00213340: 616c 6964 2053 514c 2071 7565 7279 3c2f alid SQL query │ │ │ -00213360: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00213370: 7469 746c 653e 726f 6f74 5f65 6c65 6d65 title>root_eleme │ │ │ -00213380: 6e74 3c2f 7469 746c 653e 0a20 2020 2020 nt. │ │ │ -00213390: 203c 7061 7261 3e6e 616d 6520 6f66 2072 name of r │ │ │ -002133a0: 6f6f 7420 656c 656d 656e 7420 746f 2077 oot element to w │ │ │ -002133b0: 7261 7020 7265 7375 6c74 2069 6e74 6f3c rap result into< │ │ │ -002133c0: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. . │ │ │ -002133e0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Return │ │ │ -00213410: 5479 7065 733c 2f74 6974 6c65 3e3c 7061 Typesvarchar of th │ │ │ -00213430: 6520 7265 7375 6c74 616e 7420 4454 443c e resultant DTD< │ │ │ -00213440: 2f70 6172 613e 3c2f 7265 6673 6563 7431 /para>.. E │ │ │ -00213480: 7272 6f72 733c 2f74 6974 6c65 3e0a 0920 rrors.. │ │ │ -00213490: 2020 203c 7061 7261 3e49 6620 7468 6520 If the │ │ │ -002134a0: 3c70 6172 616d 6574 6572 3e71 7565 7279 query │ │ │ -002134b0: 3c2f 7061 7261 6d65 7465 723e 2061 7267 arg │ │ │ -002134c0: 756d 656e 7420 6973 206e 6f74 2061 2076 ument is not a v │ │ │ -002134d0: 616c 6964 2053 514c 2073 7461 7465 6d65 alid SQL stateme │ │ │ -002134e0: 6e74 2c20 692e 652e 2053 514c 2063 6f6d nt, i.e. SQL com │ │ │ -002134f0: 7069 6c65 7220 7369 676e 616c 7320 616e piler signals an │ │ │ -00213500: 2065 7272 6f72 206d 6573 7361 6765 2c20 error message, │ │ │ -00213510: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ -00213520: 2020 2020 7468 6520 6675 6e63 7469 6f6e the function │ │ │ -00213530: 2072 6573 6967 6e61 6c73 2074 6865 2065 resignals the e │ │ │ -00213540: 7272 6f72 2e0a 2020 2020 2020 2020 2020 rror.. │ │ │ -00213550: 2020 3c2f 7061 7261 3e0a 2020 3c2f 7265 . .. │ │ │ -00213590: 3c74 6974 6c65 3e45 7861 6d70 6c65 733c Examples< │ │ │ -002135a0: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -002135b0: 6d70 6c65 2069 643d 2265 785f 786d 6c5f mple id="ex_xml_ │ │ │ -002135c0: 6175 746f 5f64 7464 223e 3c74 6974 6c65 auto_dtd"><title │ │ │ -002135d0: 3e53 696d 706c 6520 5573 653c 2f74 6974 >Simple Use</tit │ │ │ -002135e0: 6c65 3e0a 3c70 726f 6772 616d 6c69 7374 le>.<programlist │ │ │ -002135f0: 696e 673e 0a53 514c 2667 743b 2073 656c ing>.SQL> sel │ │ │ -00213600: 6563 7420 786d 6c5f 6175 746f 5f64 7464 ect xml_auto_dtd │ │ │ -00213610: 2028 2720 2073 656c 6563 7420 2671 756f (' select &quo │ │ │ -00213620: 743b 6361 7465 676f 7279 2671 756f 743b t;category" │ │ │ -00213630: 2e26 7175 6f74 3b43 6174 6567 6f72 7949 ."CategoryI │ │ │ -00213640: 4426 7175 6f74 3b2c 2026 7175 6f74 3b43 D", "C │ │ │ -00213650: 6174 6567 6f72 794e 616d 6526 7175 6f74 ategoryName" │ │ │ -00213660: 3b2c 0a20 2020 2026 7175 6f74 3b50 726f ;,. "Pro │ │ │ -00213670: 6475 6374 4e61 6d65 2671 756f 743b 2c20 ductName", │ │ │ -00213680: 2671 756f 743b 5072 6f64 7563 7449 4426 "ProductID& │ │ │ -00213690: 7175 6f74 3b0a 2020 2020 6672 6f6d 2026 quot;. from & │ │ │ -002136a0: 7175 6f74 3b44 656d 6f26 7175 6f74 3b2e quot;Demo". │ │ │ -002136b0: 2e26 7175 6f74 3b43 6174 6567 6f72 6965 ."Categorie │ │ │ -002136c0: 7326 7175 6f74 3b20 2671 756f 743b 6361 s" "ca │ │ │ -002136d0: 7465 676f 7279 2671 756f 743b 2c20 2671 tegory", &q │ │ │ -002136e0: 756f 743b 4465 6d6f 2671 756f 743b 2e2e uot;Demo".. │ │ │ -002136f0: 2671 756f 743b 5072 6f64 7563 7473 2671 "Products&q │ │ │ -00213700: 756f 743b 2061 7320 2671 756f 743b 7072 uot; as "pr │ │ │ -00213710: 6f64 7563 7426 7175 6f74 3b0a 2020 2020 oduct". │ │ │ -00213720: 7768 6572 6520 2671 756f 743b 7072 6f64 where "prod │ │ │ -00213730: 7563 7426 7175 6f74 3b2e 2671 756f 743b uct"." │ │ │ -00213740: 4361 7465 676f 7279 4944 2671 756f 743b CategoryID" │ │ │ -00213750: 203d 2026 7175 6f74 3b63 6174 6567 6f72 = "categor │ │ │ -00213760: 7926 7175 6f74 3b2e 2671 756f 743b 4361 y"."Ca │ │ │ -00213770: 7465 676f 7279 4944 2671 756f 743b 2066 tegoryID" f │ │ │ -00213780: 6f72 2078 6d6c 2061 7574 6f20 656c 656d or xml auto elem │ │ │ -00213790: 656e 7427 2c20 2772 6f6f 7427 293b 0a63 ent', 'root');.c │ │ │ -002137a0: 616c 6c72 6574 0a56 4152 4348 4152 0a5f allret.VARCHAR._ │ │ │ -002137b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002137c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002137d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002137e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002137f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ -00213800: 266c 743b 212d 2d20 6474 6420 666f 7220 <!-- dtd for │ │ │ -00213810: 6f75 7470 7574 206f 6620 7468 6520 666f output of the fo │ │ │ -00213820: 6c6c 6f77 696e 6720 5351 4c20 7374 6174 llowing SQL stat │ │ │ -00213830: 656d 656e 743a 0a20 2073 656c 6563 7420 ement:. select │ │ │ -00213840: 2671 756f 743b 6361 7465 676f 7279 2671 "category&q │ │ │ -00213850: 756f 743b 2e26 7175 6f74 3b43 6174 6567 uot;."Categ │ │ │ -00213860: 6f72 7949 4426 7175 6f74 3b2c 2026 7175 oryID", &qu │ │ │ -00213870: 6f74 3b43 6174 6567 6f72 794e 616d 6526 ot;CategoryName& │ │ │ -00213880: 7175 6f74 3b2c 0a09 0926 7175 6f74 3b50 quot;,..."P │ │ │ -00213890: 726f 6475 6374 4e61 6d65 2671 756f 743b roductName" │ │ │ -002138a0: 2c20 2671 756f 743b 5072 6f64 7563 7449 , "ProductI │ │ │ -002138b0: 4426 7175 6f74 3b0a 0966 726f 6d20 2671 D"..from &q │ │ │ -002138c0: 756f 743b 4465 6d6f 2671 756f 743b 2e2e uot;Demo".. │ │ │ -002138d0: 2671 756f 743b 4361 7465 676f 7269 6573 "Categories │ │ │ -002138e0: 2671 756f 743b 2026 7175 6f74 3b63 6174 " "cat │ │ │ -002138f0: 6567 6f72 7926 7175 6f74 3b2c 0a0a 0909 egory",.... │ │ │ -00213900: 2671 756f 743b 4465 6d6f 2671 756f 743b "Demo" │ │ │ -00213910: 2e2e 2671 756f 743b 5072 6f64 7563 7473 .."Products │ │ │ -00213920: 2671 756f 743b 2061 7320 2671 756f 743b " as " │ │ │ -00213930: 7072 6f64 7563 7426 7175 6f74 3b0a 0977 product"..w │ │ │ -00213940: 6865 7265 2026 7175 6f74 3b70 726f 6475 here "produ │ │ │ -00213950: 6374 2671 756f 743b 2e26 7175 6f74 3b43 ct"."C │ │ │ -00213960: 6174 6567 6f72 7949 4426 7175 6f74 3b20 ategoryID" │ │ │ -00213970: 3d20 2671 756f 743b 6361 7465 676f 7279 = "category │ │ │ -00213980: 2671 756f 743b 2e26 7175 6f74 3b43 6174 "."Cat │ │ │ -00213990: 6567 6f72 7949 4426 7175 6f74 3b0a 0966 egoryID"..f │ │ │ -002139a0: 6f72 2078 6d6c 2061 7574 6f20 656c 656d or xml auto elem │ │ │ -002139b0: 656e 740a 2d2d 2667 743b 0a26 6c74 3b21 ent.-->.<! │ │ │ -002139c0: 454c 454d 454e 5420 726f 6f74 2028 2350 ELEMENT root (#P │ │ │ -002139d0: 4344 4154 4120 7c20 6361 7465 676f 7279 CDATA | category │ │ │ -002139e0: 292a 2026 6774 3b0a 266c 743b 2145 4c45 )* >.<!ELE │ │ │ -002139f0: 4d45 4e54 2063 6174 6567 6f72 7920 2823 MENT category (# │ │ │ -00213a00: 5043 4441 5441 207c 2043 6174 6567 6f72 PCDATA | Categor │ │ │ -00213a10: 7949 4420 7c20 4361 7465 676f 7279 4e61 yID | CategoryNa │ │ │ -00213a20: 6d65 207c 2070 726f 6475 6374 292a 2026 me | product)* & │ │ │ -00213a30: 6774 3b0a 266c 743b 2145 4c45 4d45 4e54 gt;.<!ELEMENT │ │ │ -00213a40: 2070 726f 6475 6374 2028 2350 4344 4154 product (#PCDAT │ │ │ -00213a50: 4120 7c20 5072 6f64 7563 744e 616d 6520 A | ProductName │ │ │ -00213a60: 7c20 5072 6f64 7563 7449 4429 2a20 2667 | ProductID)* &g │ │ │ -00213a70: 743b 0a26 6c74 3b21 4154 544c 4953 5420 t;.<!ATTLIST │ │ │ -00213a80: 6361 7465 676f 7279 0926 6774 3b0a 266c category.>.&l │ │ │ -00213a90: 743b 2141 5454 4c49 5354 2070 726f 6475 t;!ATTLIST produ │ │ │ -00213aa0: 6374 0926 6774 3b0a 266c 743b 2145 4c45 ct.>.<!ELE │ │ │ -00213ab0: 4d45 4e54 2043 6174 6567 6f72 7949 4420 MENT CategoryID │ │ │ -00213ac0: 2823 5043 4441 5441 2926 6774 3b0a 266c (#PCDATA)>.&l │ │ │ -00213ad0: 743b 2141 5454 524c 4953 5420 4361 7465 t;!ATTRLIST Cate │ │ │ -00213ae0: 676f 7279 4944 0926 6774 3b0a 266c 743b goryID.>.< │ │ │ -00213af0: 2145 4c45 4d45 4e54 2043 6174 6567 6f72 !ELEMENT Categor │ │ │ -00213b00: 794e 616d 6520 2823 5043 4441 5441 2926 yName (#PCDATA)& │ │ │ -00213b10: 6774 3b0a 266c 743b 2141 5454 524c 4953 gt;.<!ATTRLIS │ │ │ -00213b20: 5420 4361 7465 676f 7279 4e61 6d65 0926 T CategoryName.& │ │ │ -00213b30: 6774 3b0a 266c 743b 2145 4c45 4d45 4e54 gt;.<!ELEMENT │ │ │ -00213b40: 2050 726f 6475 6374 4e61 6d65 2028 2350 ProductName (#P │ │ │ -00213b50: 4344 4154 4129 2667 743b 0a26 6c74 3b21 CDATA)>.<! │ │ │ -00213b60: 4154 5452 4c49 5354 2050 726f 6475 6374 ATTRLIST Product │ │ │ -00213b70: 4e61 6d65 0926 6774 3b0a 266c 743b 2145 Name.>.<!E │ │ │ -00213b80: 4c45 4d45 4e54 2050 726f 6475 6374 4944 LEMENT ProductID │ │ │ -00213b90: 2028 2350 4344 4154 4129 2667 743b 0a26 (#PCDATA)>.& │ │ │ -00213ba0: 6c74 3b21 4154 5452 4c49 5354 2050 726f lt;!ATTRLIST Pro │ │ │ -00213bb0: 6475 6374 4944 0926 6774 3b0a 0a31 2052 ductID.>..1 R │ │ │ -00213bc0: 6f77 732e 202d 2d20 3420 6d73 6563 2e0a ows. -- 4 msec.. │ │ │ -00213bd0: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 </programlisting │ │ │ -00213be0: 3e0a 2020 2020 3c2f 6578 616d 706c 653e >. </example> │ │ │ -00213bf0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ -00213c00: 203c 7265 6673 6563 7431 2069 643d 2273 <refsect1 id="s │ │ │ -00213c10: 6565 616c 736f 5f78 6d6c 5f61 7574 6f5f eealso_xml_auto_ │ │ │ -00213c20: 6474 6422 3e3c 7469 746c 653e 5365 6520 dtd"><title>See │ │ │ -00213c30: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ -00213c40: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xml │ │ │ -00213c70: 5f61 7574 6f28 293c 2f66 756e 6374 696f _auto() │ │ │ -00213c90: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xml_auto │ │ │ -00213cd0: 5f73 6368 656d 6128 293c 2f66 756e 6374 _schema(). │ │ │ -00213d00: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 ..... │ │ │ -00213d10: 0000 2064 656d 6f2f 646f 6373 7263 2f66 .. demo/docsrc/f │ │ │ -00213d20: 756e 6372 6566 2f78 6d6c 5f61 7574 6f2e uncref/xml_auto. │ │ │ -00213d30: 786d 6cdf 0000 152d 3c3f 786d 6c20 7665 xml....-.. │ │ │ -002140e0: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -002140f0: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -00214100: 786d 6c5f 6175 746f 3c2f 7265 6665 6e74 xml_auto. xml. . . xml_auto. prepares │ │ │ -00214190: 2061 6e64 2065 7865 6375 7465 7320 6769 and executes gi │ │ │ -002141a0: 7665 6e20 5351 4c20 666f 7220 584d 4c20 ven SQL for XML │ │ │ -002141b0: 7374 7269 6e67 206f 7574 7075 743c 2f72 string output. . . │ │ │ -002141f0: 2020 3c66 756e 6373 796e 6f70 7369 7320 . . │ │ │ -00214240: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ -00214250: 3c66 756e 6374 696f 6e3e 786d 6c5f 6175 xml_au │ │ │ -00214260: 746f 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 to. │ │ │ -00214280: 3c70 6172 616d 6465 663e 696e 203c 7061 in sql_text │ │ │ -002142a0: 203c 2f70 6172 616d 6574 6572 3e76 6172 var │ │ │ -002142b0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -002142c0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -002142e0: 7061 7261 6d73 203c 2f70 6172 616d 6574 params any. in │ │ │ -00214320: 203c 7061 7261 6d65 7465 723e 7374 7269 stri │ │ │ -00214330: 6e67 5f6f 7574 7075 7420 3c2f 7061 7261 ng_output any. │ │ │ -00214360: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -002143a0: 203c 7265 6673 6563 7431 2069 643d 2264 Description │ │ │ -002143d0: 3c2f 7469 746c 653e 0a09 3c70 6172 613e .. │ │ │ -002143e0: 0a54 6869 7320 6675 6e63 7469 6f6e 2070 .This function p │ │ │ -002143f0: 7265 7061 7265 7320 616e 6420 6578 6563 repares and exec │ │ │ -00214400: 7574 6573 2074 6865 2067 6976 656e 2053 utes the given S │ │ │ -00214410: 514c 2073 7472 696e 672c 2077 6869 6368 QL string, which │ │ │ -00214420: 2073 686f 756c 6420 6265 2061 2071 7565 should be a que │ │ │ -00214430: 7279 2065 7870 7265 7373 696f 6e20 7769 ry expression wi │ │ │ -00214440: 7468 0a74 6865 2046 4f52 2058 4d4c 2063 th.the FOR XML c │ │ │ -00214450: 6c61 7573 6520 6174 2074 6865 2065 6e64 lause at the end │ │ │ -00214460: 206f 6620 7468 6520 6c61 7374 2074 6572 of the last ter │ │ │ -00214470: 6d2e 2020 5468 6520 7175 6572 790a 6973 m. The query.is │ │ │ -00214480: 2070 6173 7365 6420 7468 6520 7061 7261 passed the para │ │ │ -00214490: 6d65 7465 7273 2066 726f 6d20 7468 6520 meters from the │ │ │ -002144a0: 7061 7261 6d73 2076 6563 746f 722c 2077 params vector, w │ │ │ -002144b0: 6869 6368 2073 686f 756c 6420 6861 7665 hich should have │ │ │ -002144c0: 206f 6e65 2065 6c65 6d65 6e74 2066 6f72 one element for │ │ │ -002144d0: 0a65 6163 6820 3f20 696e 2074 6865 2071 .each ? in the q │ │ │ -002144e0: 7565 7279 2074 6578 742c 2076 616c 7565 uery text, value │ │ │ -002144f0: 7320 6173 7369 676e 6564 2066 726f 6d20 s assigned from │ │ │ -00214500: 6c65 6674 2074 6f20 7269 6768 742e 2020 left to right. │ │ │ -00214510: 436f 6e73 6964 6572 2074 6865 0a71 7565 Consider the.que │ │ │ -00214520: 7279 3a20 7365 6c65 6374 2061 2c20 6220 ry: select a, b │ │ │ -00214530: 6672 6f6d 2074 6162 6c65 2077 6865 7265 from table where │ │ │ -00214540: 2061 203d 203f 2061 6e64 2062 203d 203f a = ? and b = ? │ │ │ -00214550: 3b20 7468 656e 2074 6865 2070 6172 616d ; then the param │ │ │ -00214560: 7320 7665 6374 6f72 0a63 6f75 6c64 2072 s vector.could r │ │ │ -00214570: 6561 736f 6e61 626c 7920 6265 3a20 3c73 easonably be: vector(1, │ │ │ -00214590: 276d 7966 696c 7465 7227 293c 2f73 6372 'myfilter')....< │ │ │ -002145b0: 7061 7261 3e0a 5468 6520 7265 7375 6c74 para>.The result │ │ │ -002145c0: 2073 6574 2069 7320 636f 6e76 6572 7465 set is converte │ │ │ -002145d0: 6420 746f 2058 4d4c 2061 6e64 2061 7070 d to XML and app │ │ │ -002145e0: 656e 6465 6420 746f 2074 6865 203c 7061 ended to the string_outpu │ │ │ -00214610: 742e 0a49 6620 7468 6520 3c70 6172 616d t..If the string_output i │ │ │ -00214640: 7320 6f6d 6974 7465 6420 616e 6420 7468 s omitted and th │ │ │ -00214650: 6520 6675 6e63 7469 6f6e 2065 7865 6375 e function execu │ │ │ -00214660: 7465 7320 696e 2074 6865 2063 6f6e 7465 tes in the conte │ │ │ -00214670: 7874 0a6f 6620 6120 5653 5020 7061 6765 xt.of a VSP page │ │ │ -00214680: 2c20 7468 6520 6f75 7470 7574 2069 7320 , the output is │ │ │ -00214690: 7365 6e74 2074 6f20 7468 6520 7374 7265 sent to the stre │ │ │ -002146a0: 616d 2067 6f69 6e67 2074 6f20 7468 6520 am going to the │ │ │ -002146b0: 7573 6572 2061 6765 6e74 2e0a 3c2f 7061 user agent... . Parame │ │ │ -00214700: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -00214710: 203c 7265 6673 6563 7432 3e3c 7469 746c sql_text. V │ │ │ -00214740: 616c 6964 2053 514c 2071 7565 7279 2075 alid SQL query u │ │ │ -00214750: 7369 6e67 2074 6865 2046 4f52 2058 4d4c sing the FOR XML │ │ │ -00214760: 2063 6c61 7573 652e 2020 5061 7261 6d65 clause. Parame │ │ │ -00214770: 7465 7269 7a65 640a 7175 6572 6965 7320 terized.queries │ │ │ -00214780: 6361 6e20 6265 2063 6f6e 7374 7275 6374 can be construct │ │ │ -00214790: 6564 2075 7369 6e67 2074 6865 2071 7565 ed using the que │ │ │ -002147a0: 7374 696f 6e20 6d61 726b 2028 3f29 2074 stion mark (?) t │ │ │ -002147b0: 6f20 7370 6563 6966 7920 610a 7061 7261 o specify a.para │ │ │ -002147c0: 6d65 7465 7220 706c 6163 652d 686f 6c64 meter place-hold │ │ │ -002147d0: 6572 2074 6861 7420 7769 6c6c 2062 6520 er that will be │ │ │ -002147e0: 7265 706c 6163 6564 2061 7420 7275 6e20 replaced at run │ │ │ -002147f0: 7469 6d65 2077 6974 6820 7468 6520 6170 time with the ap │ │ │ -00214800: 7072 6f70 7269 6174 650a 2020 2020 2020 propriate. │ │ │ -00214810: 7661 6c75 6520 6672 6f6d 2074 6865 203c value from the < │ │ │ -00214820: 7061 7261 6d65 7465 723e 7061 7261 6d73 parameter>params │ │ │ -00214830: 3c2f 7061 7261 6d65 7465 723e 2076 6563 vec │ │ │ -00214840: 746f 722e 3c2f 7061 7261 3e3c 2f72 6566 tor.. para │ │ │ -00214870: 6d73 3c2f 7469 746c 653e 0a20 2020 2020 ms. │ │ │ -00214880: 203c 7061 7261 3e56 6563 746f 7220 6f66 Vector of │ │ │ -00214890: 2070 6172 616d 6574 6572 732c 206f 6e65 parameters, one │ │ │ -002148a0: 2065 6c65 6d65 6e74 2070 6572 203f 2075 element per ? u │ │ │ -002148b0: 7365 6420 696e 2074 6865 2071 7565 7279 sed in the query │ │ │ -002148c0: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .. string_ │ │ │ -002148f0: 6f75 7470 7574 3c2f 7469 746c 653e 0a20 output. │ │ │ -00214900: 2020 2020 203c 7061 7261 3e53 7472 696e Strin │ │ │ -00214910: 6720 7661 7269 6162 6c65 206f 7220 7374 g variable or st │ │ │ -00214920: 7265 616d 2066 6f72 2072 6563 6569 7669 ream for receivi │ │ │ -00214930: 6e67 2074 6865 2072 6573 756c 742e 3c2f ng the result. │ │ │ -00214950: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -00214960: 203c 7265 6673 6563 7431 2069 643d 2272 Return Types │ │ │ -00214990: 3c2f 7469 746c 653e 3c70 6172 613e 4966 If │ │ │ -002149a0: 2079 6f75 206f 6d69 7420 7468 6520 7468 you omit the th │ │ │ -002149b0: 6972 6420 7061 7261 6d65 7465 722c 0a20 ird parameter,. │ │ │ -002149c0: 2074 6869 7320 6675 6e63 7469 6f6e 2077 this function w │ │ │ -002149d0: 696c 6c20 6f75 7470 7574 2074 6f20 7468 ill output to th │ │ │ -002149e0: 6520 636f 6e74 6578 7420 6f66 2074 6865 e context of the │ │ │ -002149f0: 2063 616c 6c69 6e67 2056 5350 2070 6167 calling VSP pag │ │ │ -00214a00: 652e 3c2f 7061 7261 3e3c 2f72 6566 7365 e.. Err │ │ │ -00214a40: 6f72 733c 2f74 6974 6c65 3e0a 2020 2020 ors. │ │ │ -00214a50: 3c74 6162 6c65 3e3c 7469 746c 653e 4572
    Er │ │ │ -00214a60: 726f 7273 2073 6967 6e61 6c6c 6564 2062 rors signalled b │ │ │ -00214a70: 7920 3c66 756e 6374 696f 6e3e 786d 6c5f y <function>xml_ │ │ │ -00214a80: 6175 746f 3c2f 6675 6e63 7469 6f6e 3e3c auto</function>< │ │ │ -00214a90: 2f74 6974 6c65 3e0a 2020 2020 2020 3c74 /title>. <t │ │ │ -00214aa0: 6772 6f75 7020 636f 6c73 3d22 3422 3e0a group cols="4">. │ │ │ -00214ab0: 2020 2020 2020 203c 7468 6561 643e 3c72 <thead><r │ │ │ -00214ac0: 6f77 3e3c 656e 7472 793e 5351 4c53 7461 ow><entry>SQLSta │ │ │ -00214ad0: 7465 3c2f 656e 7472 793e 3c65 6e74 7279 te</entry><entry │ │ │ -00214ae0: 3e45 7272 6f72 2043 6f64 653c 2f65 6e74 >Error Code</ent │ │ │ -00214af0: 7279 3e3c 656e 7472 793e 4572 726f 7220 ry><entry>Error │ │ │ -00214b00: 5465 7874 3c2f 656e 7472 793e 3c65 6e74 Text</entry><ent │ │ │ -00214b10: 7279 3e44 6573 6372 6970 7469 6f6e 3c2f ry>Description</ │ │ │ -00214b20: 656e 7472 793e 3c2f 726f 773e 3c2f 7468 entry></row></th │ │ │ -00214b30: 6561 643e 0a09 3c74 626f 6479 3e0a 0920 ead>..<tbody>.. │ │ │ -00214b40: 203c 726f 773e 0a09 2020 2020 3c65 6e74 <row>.. <ent │ │ │ -00214b50: 7279 3e3c 6572 726f 7263 6f64 653e 3432 ry><errorcode>42 │ │ │ -00214b60: 3030 303c 2f65 7272 6f72 636f 6465 3e3c 000</errorcode>< │ │ │ -00214b70: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ -00214b80: 7472 793e 3c65 7272 6f72 636f 6465 3e3c try><errorcode>< │ │ │ -00214b90: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode></ent │ │ │ -00214ba0: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ -00214bb0: 3c65 7272 6f72 6e61 6d65 3e68 7474 7020 <errorname>http │ │ │ -00214bc0: 6f75 7470 7574 2066 756e 6374 696f 6e20 output function │ │ │ -00214bd0: 6f75 7473 6964 6520 6f66 2068 7474 7020 outside of http │ │ │ -00214be0: 636f 6e74 6578 7420 616e 6420 6e6f 2073 context and no s │ │ │ -00214bf0: 7472 6561 6d20 7370 6563 6966 6965 643c tream specified< │ │ │ -00214c00: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ -00214c10: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ -00214c20: 4672 6f6d 2061 6e20 6174 7465 6d70 7420 From an attempt │ │ │ -00214c30: 746f 2073 656e 6420 7468 6520 6f75 7470 to send the outp │ │ │ -00214c40: 7574 2064 6972 6563 746c 7920 746f 2061 ut directly to a │ │ │ -00214c50: 206e 6f6e 2048 5454 5020 7461 7267 6574 non HTTP target │ │ │ -00214c60: 2073 7563 6820 6173 2049 5351 4c2e 3c2f such as ISQL.</ │ │ │ -00214c70: 656e 7472 793e 0a09 2020 3c2f 726f 773e entry>.. </row> │ │ │ -00214c80: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. <row>.. < │ │ │ -00214c90: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ -00214ca0: 3e34 3230 3030 3c2f 6572 726f 7263 6f64 >42000</errorcod │ │ │ -00214cb0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ -00214cc0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 <entry><errorcod │ │ │ -00214cd0: 653e 3c2f 6572 726f 7263 6f64 653e 3c2f e></errorcode></ │ │ │ -00214ce0: 656e 7472 793e 0a09 2020 2020 3c65 6e74 entry>.. <ent │ │ │ -00214cf0: 7279 3e3c 6572 726f 726e 616d 653e 436f ry><errorname>Co │ │ │ -00214d00: 6c75 6d6e 2031 206f 6620 7468 6520 7265 lumn 1 of the re │ │ │ -00214d10: 7375 6c74 2073 6574 206f 6620 7468 6520 sult set of the │ │ │ -00214d20: 7365 6c65 6374 2073 7461 7465 6d65 6e74 select statement │ │ │ -00214d30: 2073 686f 756c 6420 6265 206f 6620 494e should be of IN │ │ │ -00214d40: 5445 4745 5220 7479 7065 2077 6865 6e20 TEGER type when │ │ │ -00214d50: 464f 5220 584d 4c20 4558 504c 4943 4954 FOR XML EXPLICIT │ │ │ -00214d60: 2063 6c61 7573 6520 6973 2075 7365 643c clause is used< │ │ │ -00214d70: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ -00214d80: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ -00214d90: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f </entry>.. </ro │ │ │ -00214da0: 773e 0a09 2020 3c72 6f77 3e0a 0920 2020 w>.. <row>.. │ │ │ -00214db0: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ -00214dc0: 6465 3e34 3230 3030 3c2f 6572 726f 7263 de>42000</errorc │ │ │ -00214dd0: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ -00214de0: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 <entry><errorc │ │ │ -00214df0: 6f64 653e 3c2f 6572 726f 7263 6f64 653e ode></errorcode> │ │ │ -00214e00: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 </entry>.. <e │ │ │ -00214e10: 6e74 7279 3e3c 6572 726f 726e 616d 653e ntry><errorname> │ │ │ -00214e20: 436f 6c75 6d6e 2032 206f 6620 7468 6520 Column 2 of the │ │ │ -00214e30: 7265 7375 6c74 2073 6574 206f 6620 7468 result set of th │ │ │ -00214e40: 6520 7365 6c65 6374 2073 7461 7465 6d65 e select stateme │ │ │ -00214e50: 6e74 2073 686f 756c 6420 6265 206f 6620 nt should be of │ │ │ -00214e60: 494e 5445 4745 5220 7479 7065 2077 6865 INTEGER type whe │ │ │ -00214e70: 6e20 464f 5220 584d 4c20 4558 504c 4943 n FOR XML EXPLIC │ │ │ -00214e80: 4954 2063 6c61 7573 6520 6973 2075 7365 IT clause is use │ │ │ -00214e90: 643c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 d</errorname></e │ │ │ -00214ea0: 6e74 7279 3e0a 0920 2020 203c 656e 7472 ntry>.. <entr │ │ │ -00214eb0: 793e 3c2f 656e 7472 793e 0a09 2020 3c2f y></entry>.. </ │ │ │ -00214ec0: 726f 773e 0a09 3c2f 7462 6f64 793e 0a20 row>..</tbody>. │ │ │ -00214ed0: 2020 2020 203c 2f74 6772 6f75 703e 0a20 </tgroup>. │ │ │ -00214ee0: 2020 203c 2f74 6162 6c65 3e0a 2020 3c2f </table>. </ │ │ │ -00214ef0: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -00214f00: 7365 6374 3120 6964 3d22 6578 616d 706c sect1 id="exampl │ │ │ -00214f10: 6573 5f78 6d6c 5f61 7574 6f22 3e3c 7469 es_xml_auto"><ti │ │ │ -00214f20: 746c 653e 4578 616d 706c 6573 3c2f 7469 tle>Examples</ti │ │ │ -00214f30: 746c 653e 0a20 2020 203c 6578 616d 706c tle>. <exampl │ │ │ -00214f40: 6520 6964 3d22 6578 5f78 6d6c 5f61 7574 e id="ex_xml_aut │ │ │ -00214f50: 6f22 3e3c 7469 746c 653e 5072 6f64 7563 o"><title>Produc │ │ │ -00214f60: 696e 6720 584d 4c20 6672 6f6d 2053 514c ing XML from SQL │ │ │ -00214f70: 3c2f 7469 746c 653e 0a3c 7061 7261 3e0a .. │ │ │ -00214f80: 5468 6520 7072 6f63 6564 7572 6520 6265 The procedure be │ │ │ -00214f90: 6c6f 7720 7461 6b65 7320 616e 2053 514c low takes an SQL │ │ │ -00214fa0: 2073 7472 696e 672c 2065 7661 6c75 6174 string, evaluat │ │ │ -00214fb0: 6573 2069 7420 266d 6461 7368 3b20 636f es it — co │ │ │ -00214fc0: 6e76 6572 7469 6e67 0a74 6f20 584d 4c20 nverting.to XML │ │ │ -00214fd0: 266d 6461 7368 3b20 616e 640a 7072 6f64 — and.prod │ │ │ -00214fe0: 7563 6573 2061 2072 6573 756c 7420 7365 uces a result se │ │ │ -00214ff0: 7420 7768 6572 6520 7468 6520 584d 4c20 t where the XML │ │ │ -00215000: 7465 7874 2069 7320 7265 7475 726e 6564 text is returned │ │ │ -00215010: 2061 7320 6120 7661 7263 6861 7220 636f as a varchar co │ │ │ -00215020: 6c75 6d6e 2e0a 5061 7261 6d65 7465 7273 lumn..Parameters │ │ │ -00215030: 2061 7265 206e 6f74 2070 6173 7365 6420 are not passed │ │ │ -00215040: 696e 2074 6869 7320 6578 616d 706c 6520 in this example │ │ │ -00215050: 666f 7220 7468 6520 7361 6b65 206f 6620 for the sake of │ │ │ -00215060: 7369 6d70 6c69 6369 7479 2e0a 3c2f 7061 simplicity.....create pro │ │ │ -00215090: 6365 6475 7265 2078 6d6c 6120 2869 6e20 cedure xmla (in │ │ │ -002150a0: 7120 7661 7263 6861 7229 0a7b 0a20 2064 q varchar).{. d │ │ │ -002150b0: 6563 6c61 7265 2073 7420 616e 793b 0a20 eclare st any;. │ │ │ -002150c0: 2073 7420 3a3d 2073 7472 696e 675f 6f75 st := string_ou │ │ │ -002150d0: 7470 7574 2028 293b 0a20 2078 6d6c 5f61 tput ();. xml_a │ │ │ -002150e0: 7574 6f20 2871 2c20 7665 6374 6f72 2028 uto (q, vector ( │ │ │ -002150f0: 292c 2073 7429 3b0a 2020 7265 7375 6c74 ), st);. result │ │ │ -00215100: 5f6e 616d 6573 2028 7129 3b0a 2020 7265 _names (q);. re │ │ │ -00215110: 7375 6c74 2028 7374 7269 6e67 5f6f 7574 sult (string_out │ │ │ -00215120: 7075 745f 7374 7269 6e67 2028 7374 2929 put_string (st)) │ │ │ -00215130: 3b0a 7d0a 3c2f 7072 6f67 7261 6d6c 6973 ;.}. . . See A │ │ │ -00215190: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -002151a0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xml_auto_sche │ │ │ -002151e0: 6d61 2829 3c2f 6675 6e63 7469 6f6e 3e3c ma()< │ │ │ -002151f0: 2f6c 696e 6b3e 2c3c 6c69 6e6b 206c 696e /link>,xml_auto_dtd()< │ │ │ -00215230: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. ........:demo/d │ │ │ -00215270: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ -00215280: 6c53 746f 7261 6765 5379 7374 656d 2e73 lStorageSystem.s │ │ │ -00215290: 6176 654d 756c 7469 706c 6546 696c 6573 aveMultipleFiles │ │ │ -002152a0: 2e78 6d6c df00 0015 2c3c 3f78 6d6c 2076 .xml....,.. . │ │ │ -00215690: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -002156a0: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -002156b0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -002156c0: 2e73 6176 654d 756c 7469 706c 6546 696c .saveMultipleFil │ │ │ -002156d0: 6573 3c2f 7265 6665 6e74 7279 7469 746c es. blog. . . │ │ │ -00215730: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -00215740: 2e73 6176 654d 756c 7469 706c 6546 696c .saveMultipleFil │ │ │ -00215750: 6573 3c2f 7265 666e 616d 653e 0a20 2020 es. │ │ │ -00215760: 203c 7265 6670 7572 706f 7365 3e55 706c Upl │ │ │ -00215770: 6f61 6420 6120 7365 7420 6f66 2066 696c oad a set of fil │ │ │ -00215780: 6573 2074 6f20 584d 4c20 5374 6f72 6167 es to XML Storag │ │ │ -00215790: 6520 5379 7374 656d 2064 6972 6563 746f e System directo │ │ │ -002157a0: 7279 2e3c 2f72 6566 7075 7270 6f73 653e ry. │ │ │ -002157b0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -002157c0: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . │ │ │ -00215860: 203c 6675 6e63 6465 663e 7374 7275 6374 struct │ │ │ -00215870: 7572 6520 3c66 756e 6374 696f 6e3e 786d ure xm │ │ │ -00215880: 6c53 746f 7261 6765 5379 7374 656d 2e73 lStorageSystem.s │ │ │ -00215890: 6176 654d 756c 7469 706c 6546 696c 6573 aveMultipleFiles │ │ │ -002158a0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e .

    in email string. │ │ │ -00215900: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -00215910: 7061 7261 6d65 7465 723e 7061 7373 776f parameter>passwo │ │ │ -00215920: 7264 3c2f 7061 7261 6d65 7465 723e 2073 rd s │ │ │ -00215930: 7472 696e 673c 2f70 6172 616d 6465 663e tring │ │ │ -00215940: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in relativepathLis │ │ │ -00215970: 743c 2f70 6172 616d 6574 6572 3e20 6172 t ar │ │ │ -00215980: 7261 793c 2f70 6172 616d 6465 663e 0a20 ray. │ │ │ -00215990: 2020 2020 2020 203c 7061 7261 6d64 6566 in f │ │ │ -002159b0: 696c 6554 6578 744c 6973 743c 2f70 6172 ileTextList array

    . < │ │ │ -002159e0: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ -002159f0: 2020 2020 3c2f 6675 6e63 7379 6e6f 7073 . . . Des │ │ │ -00215a60: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -00215a70: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ -00215a80: 6d65 7468 6f64 2061 6c6c 6f77 7320 7573 method allows us │ │ │ -00215a90: 6572 7320 746f 2075 706c 6f61 6420 6120 ers to upload a │ │ │ -00215aa0: 7365 7420 6f66 2066 696c 6573 2e20 5468 set of files. Th │ │ │ -00215ab0: 6520 6669 6c65 7320 7769 6c6c 2062 6520 e files will be │ │ │ -00215ac0: 7374 6f72 6564 0a20 2020 2069 6e20 5765 stored. in We │ │ │ -00215ad0: 6244 4156 2072 6570 6f73 6974 6f72 7920 bDAV repository │ │ │ -00215ae0: 616e 6420 7769 6c6c 2062 6520 6163 6365 and will be acce │ │ │ -00215af0: 7373 6962 6c65 2076 6961 2048 5454 502e ssible via HTTP. │ │ │ -00215b00: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . . Paramet │ │ │ -00215b60: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -00215b70: 3c72 6566 7365 6374 323e 3c74 6974 6c65 email. │ │ │ -00215b90: 2020 2020 203c 7061 7261 3e46 6f72 2075 For u │ │ │ -00215ba0: 7365 7220 6964 656e 7469 6669 6361 7469 ser identificati │ │ │ -00215bb0: 6f6e 2c20 7468 6973 2073 686f 756c 6420 on, this should │ │ │ -00215bc0: 6265 2061 2076 616c 6964 2065 6d61 696c be a valid email │ │ │ -00215bd0: 2061 6363 6f75 6e74 2e3c 2f70 6172 613e account. │ │ │ -00215be0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00215bf0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 password. Th │ │ │ -00215c20: 6520 4d44 3520 6861 7368 206f 6620 7468 e MD5 hash of th │ │ │ -00215c30: 6520 7061 7373 776f 7264 2e3c 2f70 6172 e password.. │ │ │ -00215c50: 2020 3c72 6566 7365 6374 323e 3c74 6974 relativepathL │ │ │ -00215c70: 6973 743c 2f74 6974 6c65 3e0a 2020 2020 ist. │ │ │ -00215c80: 2020 3c70 6172 613e 4172 7261 7920 6f66 Array of │ │ │ -00215c90: 2073 7472 696e 6773 206f 6620 7461 7267 strings of targ │ │ │ -00215ca0: 6574 2070 6174 6873 2072 656c 6174 6976 et paths relativ │ │ │ -00215cb0: 6520 746f 2074 6865 200a 3c63 6f6d 7075 e to the .<us │ │ │ -00215cd0: 6572 2068 6f6d 6526 6774 3b2f 626c 6f67 er home>/blog │ │ │ -00215ce0: 3c2f 636f 6d70 7574 6572 6f75 7470 7574 folder .in Web │ │ │ -00215d00: 4441 562e 3c2f 7061 7261 3e3c 2f72 6566 DAV.. file │ │ │ -00215d30: 5465 7874 4c69 7374 3c2f 7469 746c 653e TextList │ │ │ -00215d40: 0a20 2020 2020 203c 7061 7261 3e41 6e20 . An │ │ │ -00215d50: 6172 7261 7920 6f66 2073 7472 696e 6773 array of strings │ │ │ -00215d60: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ -00215d70: 636f 6e74 656e 7473 206f 6620 7468 6520 contents of the │ │ │ -00215d80: 6669 6c65 7320 746f 2062 6520 7570 6c6f files to be uplo │ │ │ -00215d90: 6164 6564 2e20 200a 5468 6573 6520 6d75 aded. .These mu │ │ │ -00215da0: 7374 2062 6520 696e 2074 6865 2073 616d st be in the sam │ │ │ -00215db0: 6520 7365 7175 656e 6365 2061 7320 7468 e sequence as th │ │ │ -00215dc0: 6520 7265 6c61 7469 7665 7061 7468 4c69 e relativepathLi │ │ │ -00215dd0: 7374 2e20 200a 692e 652e 2072 656c 6174 st. .i.e. relat │ │ │ -00215de0: 6976 6570 6174 684c 6973 745b 695d 2069 ivepathList[i] i │ │ │ -00215df0: 7320 6e61 6d65 2066 6f72 2066 696c 6554 s name for fileT │ │ │ -00215e00: 6578 744c 6973 745b 695d 2e3c 2f70 6172 extList[i].. │ │ │ -00215e20: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72
    . Retur │ │ │ -00215e70: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ -00215e80: 2020 2020 3c70 6172 613e 5468 6973 206d This m │ │ │ -00215e90: 6574 686f 6420 7265 7475 726e 7320 6120 ethod returns a │ │ │ -00215ea0: 7374 7275 6374 7572 6520 6173 2066 6f6c structure as fol │ │ │ -00215eb0: 6c6f 7773 3a3c 2f70 6172 613e 0a3c 7072 lows:.. │ │ │ -00215ed0: 2020 2623 3339 3b66 6c45 7272 6f72 2623 'flError&# │ │ │ -00215ee0: 3339 3b20 626f 6f6c 6561 6e20 2020 0909 39; boolean .. │ │ │ -00215ef0: 3020 7375 6363 6573 732c 2031 2066 6175 0 success, 1 fau │ │ │ -00215f00: 6c74 0a20 2020 2026 2333 393b 6d65 7373 lt. 'mess │ │ │ -00215f10: 6167 6526 2333 393b 2073 7472 696e 6720 age' string │ │ │ -00215f20: 2020 2009 0966 6175 6c74 206d 6573 7361 ..fault messa │ │ │ -00215f30: 6765 2028 6361 6e20 6265 2075 7365 6420 ge (can be used │ │ │ -00215f40: 746f 2068 616e 646c 6520 6572 726f 7220 to handle error │ │ │ -00215f50: 6361 7365 7329 0a20 2020 2026 2333 393b cases). ' │ │ │ -00215f60: 7572 6c6c 6973 7426 2333 393b 2061 7272 urllist' arr │ │ │ -00215f70: 6179 206f 6620 7374 7269 6e67 2009 636f ay of string .co │ │ │ -00215f80: 6e74 6169 6e73 206c 6973 7420 6f66 2055 ntains list of U │ │ │ -00215f90: 524c 7320 636f 7272 6573 706f 6e64 696e RLs correspondin │ │ │ -00215fa0: 6720 746f 2075 706c 6f61 6465 6420 6669 g to uploaded fi │ │ │ -00215fb0: 6c65 730a 2020 2020 2623 3339 3b79 6f75 les. 'you │ │ │ -00215fc0: 7255 7073 7472 6561 6d46 6f6c 6465 7255 rUpstreamFolderU │ │ │ -00215fd0: 726c 2623 3339 3b20 7374 7269 6e67 0962 rl' string.b │ │ │ -00215fe0: 6173 6520 5552 4c20 666f 7220 7570 6c6f ase URL for uplo │ │ │ -00215ff0: 6164 0a3c 2f70 726f 6772 616d 6c69 7374 ad.. . .. │ │ │ -002160e0: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ -00216120: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 Example │ │ │ -00216130: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. Using t │ │ │ -00216180: 6865 2058 4d4c 2053 746f 7261 6765 2053 he XML Storage S │ │ │ -00216190: 7973 7465 6d20 746f 2053 6176 6520 4d75 ystem to Save Mu │ │ │ -002161a0: 6c74 6970 6c65 2046 696c 6573 3c2f 7469 ltiple Files</ti │ │ │ -002161b0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -002161c0: 3e53 696d 706c 6520 6578 616d 706c 6520 >Simple example │ │ │ -002161d0: 6f66 2073 6176 696e 6720 6120 6669 6c65 of saving a file │ │ │ -002161e0: 2e3c 2f70 6172 613e 0a20 2020 2020 203c .</para>. < │ │ │ -002161f0: 7363 7265 656e 3e0a 2020 2020 2d20 496e screen>. - In │ │ │ -00216200: 766f 6361 7469 6f6e 3a0a 0a20 2020 2053 vocation:.. S │ │ │ -00216210: 514c 2667 743b 2053 4f41 505f 434c 4945 QL> SOAP_CLIE │ │ │ -00216220: 4e54 2028 7572 6c3d 2667 743b 2623 3339 NT (url=>' │ │ │ -00216230: 3b68 7474 703a 2f2f 6578 616d 706c 652e ;http://example. │ │ │ -00216240: 636f 6d2f 786d 6c53 746f 7261 6765 5379 com/xmlStorageSy │ │ │ -00216250: 7374 656d 2623 3339 3b2c 206f 7065 7261 stem', opera │ │ │ -00216260: 7469 6f6e 3d26 6774 3b26 2333 393b 7361 tion=>'sa │ │ │ -00216270: 7665 4d75 6c74 6970 6c65 4669 6c65 7326 veMultipleFiles& │ │ │ -00216280: 2333 393b 2c0a 0970 6172 616d 6574 6572 #39;,..parameter │ │ │ -00216290: 733d 2667 743b 7665 6374 6f72 2028 2623 s=>vector (&# │ │ │ -002162a0: 3339 3b65 6d61 696c 2623 3339 3b2c 2623 39;email',&# │ │ │ -002162b0: 3339 3b75 7365 7240 6578 616d 706c 652e 39;user@example. │ │ │ -002162c0: 646f 6d61 696e 2623 3339 3b2c 2026 2333 domain',  │ │ │ -002162d0: 393b 7061 7373 776f 7264 2623 3339 3b2c 9;password', │ │ │ -002162e0: 206d 6435 2826 2333 393b 7878 7826 2333 md5('xxx │ │ │ -002162f0: 393b 292c 0a09 2020 2623 3339 3b72 656c 9;),.. 'rel │ │ │ -00216300: 6174 6976 6570 6174 684c 6973 7426 2333 ativepathList │ │ │ -00216310: 393b 2c20 7665 6374 6f72 2028 2623 3339 9;, vector (' │ │ │ -00216320: 3b74 6573 742e 7478 7426 2333 393b 292c ;test.txt'), │ │ │ -00216330: 2026 2333 393b 6669 6c65 5465 7874 4c69 'fileTextLi │ │ │ -00216340: 7374 2623 3339 3b2c 2076 6563 746f 7220 st', vector │ │ │ -00216350: 2826 2333 393b 7468 6973 2069 7320 6120 ('this is a │ │ │ -00216360: 7465 7374 2623 3339 3b29 293b 0a0a 2020 test'));.. │ │ │ -00216370: 2020 2d20 534f 4150 2052 6573 706f 6e73 - SOAP Respons │ │ │ -00216380: 6509 0a20 2020 2009 0a20 2020 2026 6c74 e.. .. < │ │ │ -00216390: 3b73 6176 654d 756c 7469 706c 6546 696c ;saveMultipleFil │ │ │ -002163a0: 6573 5265 7370 6f6e 7365 2667 743b 0a20 esResponse>. │ │ │ -002163b0: 2020 2020 2026 6c74 3b52 6573 756c 7426 <Result& │ │ │ -002163c0: 6774 3b0a 0926 6c74 3b66 6c45 7272 6f72 gt;..<flError │ │ │ -002163d0: 2667 743b 3026 6c74 3b2f 666c 4572 726f >0</flErro │ │ │ -002163e0: 7226 6774 3b0a 0926 6c74 3b6d 6573 7361 r>..<messa │ │ │ -002163f0: 6765 202f 2667 743b 0a09 266c 743b 7572 ge />..<ur │ │ │ -00216400: 6c6c 6973 7426 6774 3b0a 0920 2026 6c74 llist>.. < │ │ │ -00216410: 3b69 7465 6d26 6774 3b68 7474 703a 2f2f ;item>http:// │ │ │ -00216420: 6578 616d 706c 652e 636f 6d2f 4441 562f example.com/DAV/ │ │ │ -00216430: 7573 6572 4065 7861 6d70 6c65 2e64 6f6d user@example.dom │ │ │ -00216440: 6169 6e2f 626c 6f67 2f74 6573 742e 7478 ain/blog/test.tx │ │ │ -00216450: 7426 6c74 3b2f 6974 656d 2667 743b 0a09 t</item>.. │ │ │ -00216460: 266c 743b 2f75 726c 6c69 7374 2667 743b </urllist> │ │ │ -00216470: 0a09 266c 743b 796f 7572 5570 7374 7265 ..<yourUpstre │ │ │ -00216480: 616d 466f 6c64 6572 5572 6c26 6774 3b68 amFolderUrl>h │ │ │ -00216490: 7474 703a 2f2f 6578 616d 706c 652e 636f ttp://example.co │ │ │ -002164a0: 6d2f 4441 562f 7573 6572 4065 7861 6d70 m/DAV/user@examp │ │ │ -002164b0: 6c65 2e64 6f6d 6169 6e2f 626c 6f67 2f26 le.domain/blog/& │ │ │ -002164c0: 6c74 3b2f 796f 7572 5570 7374 7265 616d lt;/yourUpstream │ │ │ -002164d0: 466f 6c64 6572 5572 6c26 6774 3b0a 2020 FolderUrl>. │ │ │ -002164e0: 2020 2020 266c 743b 2f52 6573 756c 7426 </Result& │ │ │ -002164f0: 6774 3b0a 2020 2020 266c 743b 2f73 6176 gt;. </sav │ │ │ -00216500: 654d 756c 7469 706c 6546 696c 6573 5265 eMultipleFilesRe │ │ │ -00216510: 7370 6f6e 7365 2667 743b 0a3c 2f73 6372 sponse>.</scr │ │ │ -00216520: 6565 6e3e 0a20 2020 203c 2f65 7861 6d70 een>. </examp │ │ │ -00216530: 6c65 3e0a 2020 3c2f 7265 6673 6563 7431 le>. </refsect1 │ │ │ -00216540: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ -00216550: 3d22 7365 6561 6c73 6f5f 786d 6c53 746f ="seealso_xmlSto │ │ │ -00216560: 7261 6765 5379 7374 656d 2e73 6176 654d rageSystem.saveM │ │ │ -00216570: 756c 7469 706c 6546 696c 6573 223e 0a20 ultipleFiles">. │ │ │ -00216580: 2020 203c 7469 746c 653e 5365 6520 416c <title>See Al │ │ │ -00216590: 736f 3c2f 7469 746c 653e 0a20 203c 7061 so. xm │ │ │ -002165e0: 6c53 746f 7261 6765 5379 7374 656d 2e72 lStorageSystem.r │ │ │ -002165f0: 6567 6973 7465 7255 7365 7228 293c 2f66 egisterUser()< │ │ │ -00216610: 2f70 6172 613e 0a20 203c 7061 7261 3e3c /para>. < │ │ │ -00216620: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -00216630: 5f78 6d6c 5374 6f72 6167 6553 7973 7465 _xmlStorageSyste │ │ │ -00216640: 6d2e 6d61 696c 5061 7373 776f 7264 546f m.mailPasswordTo │ │ │ -00216650: 5573 6572 223e 3c66 756e 6374 696f 6e3e User"> │ │ │ -00216660: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -00216670: 2e6d 6169 6c50 6173 7377 6f72 6454 6f55 .mailPasswordToU │ │ │ -00216680: 7365 7228 293c 2f66 756e 6374 696f 6e3e ser() │ │ │ -00216690: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -002166a0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xmlSt │ │ │ -002166f0: 6f72 6167 6553 7973 7465 6d2e 6765 7453 orageSystem.getS │ │ │ -00216700: 6572 7665 7243 6170 6162 696c 6974 6965 erverCapabilitie │ │ │ -00216710: 7328 293c 2f66 756e 6374 696f 6e3e 3c2f s(). < │ │ │ -00216730: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xmlStorag │ │ │ -00216780: 6553 7973 7465 6d2e 6465 6c65 7465 4d75 eSystem.deleteMu │ │ │ -00216790: 6c74 6970 6c65 4669 6c65 7328 293c 2f66 ltipleFiles()< │ │ │ -002167b0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -002167d0: 0a20 2020 0ab6 0000 0035 6465 6d6f 2f64 . .....5demo/d │ │ │ -002167e0: 6f63 7372 632f 6675 6e63 7265 662f 786d ocsrc/funcref/xm │ │ │ -002167f0: 6c53 746f 7261 6765 5379 7374 656d 2e72 lStorageSystem.r │ │ │ -00216800: 6567 6973 7465 7255 7365 722e 786d 6cdf egisterUser.xml. │ │ │ -00216810: 0000 1570 3c3f 786d 6c20 7665 7273 696f ...p. │ │ │ -00216840: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 │ │ │ -00216ba0: 0a20 203c 212d 2d20 4372 6561 7465 6420 . . . . xmlStora │ │ │ -00216c20: 6765 5379 7374 656d 2e72 6567 6973 7465 geSystem.registe │ │ │ -00216c30: 7255 7365 723c 2f72 6566 656e 7472 7974 rUser. blog. . . xmlStorageSys │ │ │ -00216ca0: 7465 6d2e 7265 6769 7374 6572 5573 6572 tem.registerUser │ │ │ -00216cb0: 3c2f 7265 666e 616d 653e 0a20 2020 203c . < │ │ │ -00216cc0: 7265 6670 7572 706f 7365 3e52 6567 6973 refpurpose>Regis │ │ │ -00216cd0: 7465 7220 6120 7573 6572 2077 6974 6820 ter a user with │ │ │ -00216ce0: 7468 6520 584d 4c20 5374 6f72 6167 6520 the XML Storage │ │ │ -00216cf0: 5379 7374 656d 3c2f 7265 6670 7572 706f System. . . . . structure xmlStorag │ │ │ -00216dd0: 6553 7973 7465 6d2e 7265 6769 7374 6572 eSystem.register │ │ │ -00216de0: 5573 6572 3c2f 6675 6e63 7469 6f6e 3e3c User< │ │ │ -00216df0: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -00216e00: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -00216e10: 7061 7261 6d65 7465 723e 656d 6169 6c3c parameter>email< │ │ │ -00216e20: 2f70 6172 616d 6574 6572 3e20 7374 7269 /parameter> stri │ │ │ -00216e30: 6e67 3c2f 7061 7261 6d64 6566 3e0a 2020 ng. │ │ │ -00216e40: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -00216e50: 696e 203c 7061 7261 6d65 7465 723e 6e61 in na │ │ │ -00216e60: 6d65 3c2f 7061 7261 6d65 7465 723e 2073 me s │ │ │ -00216e70: 7472 696e 673c 2f70 6172 616d 6465 663e tring │ │ │ -00216e80: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in password string. │ │ │ -00216ed0: 3c70 6172 616d 6465 663e 696e 203c 7061 in clientPo │ │ │ -00216ef0: 7274 3c2f 7061 7261 6d65 7465 723e 2069 rt i │ │ │ -00216f00: 6e74 6567 6572 3c2f 7061 7261 6d64 6566 nteger. in userAgent string. │ │ │ -00216f60: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -00216f70: 7061 7261 6d65 7465 723e 7365 7269 616c parameter>serial │ │ │ -00216f80: 4e75 6d62 6572 3c2f 7061 7261 6d65 7465 Number string. . │ │ │ -00216fc0: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ -00216fd0: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . . Description< │ │ │ -00217030: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. This method al │ │ │ -00217050: 6c6f 7773 2075 7365 7273 2074 6f20 7265 lows users to re │ │ │ -00217060: 6769 7374 6572 2077 6974 6869 6e20 584d gister within XM │ │ │ -00217070: 4c20 5374 6f72 6167 6520 5379 7374 656d L Storage System │ │ │ -00217080: 2e20 2054 6865 2061 6374 696f 6e73 200a . The actions . │ │ │ -00217090: 7065 7266 6f72 6d65 6420 6f6e 2074 6865 performed on the │ │ │ -002170a0: 2073 6572 7665 7220 6172 653a 3c2f 7061 server are:. │ │ │ -002170c0: 0a20 203c 6d65 6d62 6572 3e6d 616b 6520 . make │ │ │ -002170d0: 6120 6e65 7720 5765 6220 6163 636f 756e a new Web accoun │ │ │ -002170e0: 7420 6e61 6d65 6420 266c 743b 656d 6169 t named <emai │ │ │ -002170f0: 6c26 6774 3b20 7769 7468 2074 6865 2070 l> with the p │ │ │ -00217100: 6173 7377 6f72 6420 7370 6563 6966 6965 assword specifie │ │ │ -00217110: 642e 3c2f 6d65 6d62 6572 3e0a 2020 3c6d d.. make a hom │ │ │ -00217130: 652d 666f 6c64 6572 2069 6e20 5765 6244 e-folder in WebD │ │ │ -00217140: 4156 2072 6570 6f73 6974 6f72 7920 6173 AV repository as │ │ │ -00217150: 202f 4441 562f 266c 743b 656d 6169 6c26 /DAV/<email& │ │ │ -00217160: 6774 3b2e 3c2f 6d65 6d62 6572 3e0a 2020 gt;.. │ │ │ -00217170: 3c6d 656d 6265 723e 6d61 6b65 2061 2073 make a s │ │ │ -00217180: 7562 2d66 6f6c 6465 7220 6361 6c6c 6564 ub-folder called │ │ │ -00217190: 2026 7175 6f74 3b62 6c6f 6726 7175 6f74 "blog" │ │ │ -002171a0: 3b2e 3c2f 6d65 6d62 6572 3e0a 3c2f 7369 ;... . Parameters< │ │ │ -00217210: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. ema │ │ │ -00217230: 696c 3c2f 7469 746c 653e 0a20 2020 2020 il. │ │ │ -00217240: 203c 7061 7261 3e46 6f72 2075 7365 7220 For user │ │ │ -00217250: 6964 656e 7469 6669 6361 7469 6f6e 2c20 identification, │ │ │ -00217260: 7468 6973 2073 686f 756c 6420 6265 2061 this should be a │ │ │ -00217270: 2076 616c 6964 2065 6d61 696c 2061 6363 valid email acc │ │ │ -00217280: 6f75 6e74 2e3c 2f70 6172 613e 3c2f 7265 ount.. nam │ │ │ -002172b0: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -002172c0: 3c70 6172 613e 4120 6875 6d61 6e20 7265 A human re │ │ │ -002172d0: 6164 6162 6c65 206e 616d 6520 666f 7220 adable name for │ │ │ -002172e0: 7468 6520 7573 6572 2061 6363 6f75 6e74 the user account │ │ │ -002172f0: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .. passwor │ │ │ -00217320: 643c 2f74 6974 6c65 3e0a 2020 2020 2020 d. │ │ │ -00217330: 3c70 6172 613e 5468 6520 7061 7373 776f The passwo │ │ │ -00217340: 7264 2066 6f72 2061 7574 6865 6e74 6963 rd for authentic │ │ │ -00217350: 6174 696f 6e2e 2020 4e6f 7465 2074 6861 ation. Note tha │ │ │ -00217360: 7420 7468 6973 2069 7320 7468 6520 6f6e t this is the on │ │ │ -00217370: 6c79 2063 616c 6c20 7468 6174 200a 2020 ly call that . │ │ │ -00217380: 2020 2020 7365 6e64 7320 7468 6520 7061 sends the pa │ │ │ -00217390: 7373 776f 7264 2069 6e20 636c 6561 722d ssword in clear- │ │ │ -002173a0: 7465 7874 2e20 2041 6c6c 206f 7468 6572 text. All other │ │ │ -002173b0: 2066 756e 6374 696f 6e73 2073 656e 6420 functions send │ │ │ -002173c0: 7468 6520 7061 7373 776f 7264 200a 2020 the password . │ │ │ -002173d0: 2020 2020 6173 2061 204d 4435 2068 6173 as a MD5 has │ │ │ -002173e0: 682e 3c2f 7061 7261 3e3c 2f72 6566 7365 h.. client │ │ │ -00217410: 506f 7274 3c2f 7469 746c 653e 0a20 2020 Port. │ │ │ -00217420: 2020 203c 7061 7261 3e43 7572 7265 6e74 Current │ │ │ -00217430: 6c79 2069 676e 6f72 6564 2061 6e64 2072 ly ignored and r │ │ │ -00217440: 6573 6572 7665 6420 666f 7220 6675 7475 eserved for futu │ │ │ -00217450: 7265 2075 7365 2e3c 2f70 6172 613e 3c2f re use.. u │ │ │ -00217480: 7365 7241 6765 6e74 3c2f 7469 746c 653e serAgent │ │ │ -00217490: 0a20 2020 2020 203c 7061 7261 3e43 7572 . Cur │ │ │ -002174a0: 7265 6e74 6c79 2069 676e 6f72 6564 2061 rently ignored a │ │ │ -002174b0: 6e64 2072 6573 6572 7665 6420 666f 7220 nd reserved for │ │ │ -002174c0: 6675 7475 7265 2075 7365 2e3c 2f70 6172 future use.. │ │ │ -002174e0: 2020 3c72 6566 7365 6374 323e 3c74 6974 serialNumber< │ │ │ -00217500: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    Currently ig │ │ │ -00217520: 6e6f 7265 6420 616e 6420 7265 7365 7276 nored and reserv │ │ │ -00217530: 6564 2066 6f72 2066 7574 7572 6520 7573 ed for future us │ │ │ -00217540: 652e 3c2f 7061 7261 3e3c 2f72 6566 7365 e.. . Ret │ │ │ -002175a0: 7572 6e20 5479 7065 733c 2f74 6974 6c65 urn Types. This │ │ │ -002175c0: 206d 6574 686f 6420 7265 7475 726e 7320 method returns │ │ │ -002175d0: 6120 7374 7275 6374 7572 6520 6173 2066 a structure as f │ │ │ -002175e0: 6f6c 6c6f 7773 3a3c 2f70 6172 613e 0a3c ollows:.< │ │ │ -002175f0: 7072 6f67 7261 6d6c 6973 7469 6e67 3e0a programlisting>. │ │ │ -00217600: 2020 2020 2623 3339 3b75 7365 726e 756d 'usernum │ │ │ -00217610: 2623 3339 3b20 7374 7269 6e67 2009 6163 ' string .ac │ │ │ -00217620: 636f 756e 7420 6964 0a20 2020 2026 2333 count id.  │ │ │ -00217630: 393b 666c 4572 726f 7226 2333 393b 2062 9;flError' b │ │ │ -00217640: 6f6f 6c65 616e 2020 2030 2073 7563 6365 oolean 0 succe │ │ │ -00217650: 7373 2c20 3120 6661 756c 740a 2020 2020 ss, 1 fault. │ │ │ -00217660: 2623 3339 3b6d 6573 7361 6765 2623 3339 'message' │ │ │ -00217670: 3b20 7374 7269 6e67 2020 2020 6661 756c ; string faul │ │ │ -00217680: 7420 6d65 7373 6167 6520 2863 616e 2062 t message (can b │ │ │ -00217690: 6520 7573 6564 2074 6f20 6861 6e64 6c65 e used to handle │ │ │ -002176a0: 2065 7272 6f72 2063 6173 6573 290a 3c2f error cases).. │ │ │ -002176c0: 200a 2020 3c2f 7265 6673 6563 7431 3e0a . . │ │ │ -002176d0: 3c21 2d2d 0a20 203c 7265 6673 6563 7431 . . │ │ │ -002177d0: 2020 203c 7469 746c 653e 4578 616d 706c Exampl │ │ │ -002177e0: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ -002177f0: 6578 616d 706c 6520 6964 3d22 6578 5f78 example id="ex_x │ │ │ -00217800: 6d6c 5374 6f72 6167 6553 7973 7465 6d22 mlStorageSystem" │ │ │ -00217810: 3e3c 7469 746c 653e 5265 6769 7374 6572 >Register │ │ │ -00217820: 696e 6720 6120 6e65 7720 7573 6572 3c2f ing a new user</ │ │ │ -00217830: 7469 746c 653e 0a20 2020 2020 203c 7363 title>. <sc │ │ │ -00217840: 7265 656e 3e0a 5351 4c26 6774 3b20 534f reen>.SQL> SO │ │ │ -00217850: 4150 5f43 4c49 454e 5420 2875 726c 3d26 AP_CLIENT (url=& │ │ │ -00217860: 6774 3b26 2333 393b 6874 7470 3a2f 2f65 gt;'http://e │ │ │ -00217870: 7861 6d70 6c65 2e63 6f6d 2f78 6d6c 5374 xample.com/xmlSt │ │ │ -00217880: 6f72 6167 6553 7973 7465 6d26 2333 393b orageSystem' │ │ │ -00217890: 2c0a 0920 0920 6f70 6572 6174 696f 6e3d ,.. . operation= │ │ │ -002178a0: 2667 743b 2623 3339 3b72 6567 6973 7465 >'registe │ │ │ -002178b0: 7255 7365 7226 2333 393b 2c20 7061 7261 rUser', para │ │ │ -002178c0: 6d65 7465 7273 3d26 6774 3b76 6563 746f meters=>vecto │ │ │ -002178d0: 720a 0909 2826 2333 393b 656d 6169 6c26 r...('email& │ │ │ -002178e0: 2333 393b 2c26 2333 393b 7573 6572 4065 #39;,'user@e │ │ │ -002178f0: 7861 6d70 6c65 2e64 6f6d 6169 6e26 2333 xample.domain │ │ │ -00217900: 393b 2c20 2623 3339 3b6e 616d 6526 2333 9;, 'name │ │ │ -00217910: 393b 2c20 2623 3339 3b53 6f6d 6562 6f64 9;, 'Somebod │ │ │ -00217920: 7920 4e61 6d65 2623 3339 3b2c 200a 0909 y Name', ... │ │ │ -00217930: 2026 2333 393b 7061 7373 776f 7264 2623 'password&# │ │ │ -00217940: 3339 3b2c 2026 2333 393b 7878 7826 2333 39;, 'xxx │ │ │ -00217950: 393b 2c20 2623 3339 3b63 6c69 656e 7450 9;, 'clientP │ │ │ -00217960: 6f72 7426 2333 393b 2c20 302c 2026 2333 ort', 0,  │ │ │ -00217970: 393b 7573 6572 4167 656e 7426 2333 393b 9;userAgent' │ │ │ -00217980: 2c20 2623 3339 3b26 2333 393b 202c 2026 , '' , & │ │ │ -00217990: 2333 393b 7365 7269 616c 4e75 6d62 6572 #39;serialNumber │ │ │ -002179a0: 2623 3339 3b2c 2026 2333 393b 2623 3339 ', '' │ │ │ -002179b0: 3b29 293b 0a0a 2020 2020 2d20 534f 4150 ;));.. - SOAP │ │ │ -002179c0: 2072 6573 706f 6e73 650a 2020 2020 266c response. &l │ │ │ -002179d0: 743b 7265 6769 7374 6572 5573 6572 5265 t;registerUserRe │ │ │ -002179e0: 7370 6f6e 7365 2667 743b 0a20 2020 2020 sponse>. │ │ │ -002179f0: 2026 6c74 3b52 6573 756c 7426 6774 3b0a <Result>. │ │ │ -00217a00: 0926 6c74 3b75 7365 726e 756d 2667 743b .<usernum> │ │ │ -00217a10: 7573 6572 4065 7861 6d70 6c65 2e64 6f6d user@example.dom │ │ │ -00217a20: 6169 6e26 6c74 3b2f 7573 6572 6e75 6d26 ain</usernum& │ │ │ -00217a30: 6774 3b0a 0926 6c74 3b66 6c45 7272 6f72 gt;..<flError │ │ │ -00217a40: 2667 743b 3026 6c74 3b2f 666c 4572 726f >0</flErro │ │ │ -00217a50: 7226 6774 3b0a 0926 6c74 3b6d 6573 7361 r>..<messa │ │ │ -00217a60: 6765 2667 743b 5765 6c63 6f6d 652c 2053 ge>Welcome, S │ │ │ -00217a70: 6f6d 6562 6f64 7920 4e61 6d65 266c 743b omebody Name< │ │ │ -00217a80: 2f6d 6573 7361 6765 2667 743b 0a20 2020 /message>. │ │ │ -00217a90: 2020 2026 6c74 3b2f 5265 7375 6c74 2667 </Result&g │ │ │ -00217aa0: 743b 0a20 2020 2026 6c74 3b2f 7265 6769 t;. </regi │ │ │ -00217ab0: 7374 6572 5573 6572 5265 7370 6f6e 7365 sterUserResponse │ │ │ -00217ac0: 2667 743b 0a3c 2f73 6372 6565 6e3e 0a20 >.</screen>. │ │ │ -00217ad0: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 </example>. │ │ │ -00217ae0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ -00217af0: 6566 7365 6374 3120 6964 3d22 7365 6561 efsect1 id="seea │ │ │ -00217b00: 6c73 6f5f 786d 6c53 746f 7261 6765 5379 lso_xmlStorageSy │ │ │ -00217b10: 7374 656d 2e72 6567 6973 7465 7255 7365 stem.registerUse │ │ │ -00217b20: 7222 3e0a 2020 2020 3c74 6974 6c65 3e53 r">. <title>S │ │ │ -00217b30: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ -00217b40: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 < │ │ │ -00217b80: 6675 6e63 7469 6f6e 3e78 6d6c 5374 6f72 function>xmlStor │ │ │ -00217b90: 6167 6553 7973 7465 6d2e 6d61 696c 5061 ageSystem.mailPa │ │ │ -00217ba0: 7373 776f 7264 546f 5573 6572 2829 3c2f sswordToUser() │ │ │ -00217bc0: 3c2f 7061 7261 3e0a 2020 3c70 6172 613e . │ │ │ -00217bd0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xmlStorageSy │ │ │ -00217c20: 7374 656d 2e67 6574 5365 7276 6572 4361 stem.getServerCa │ │ │ -00217c30: 7061 6269 6c69 7469 6573 2829 3c2f 6675 pabilities(). │ │ │ -00217ca0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -00217cb0: 2e64 656c 6574 654d 756c 7469 706c 6546 .deleteMultipleF │ │ │ -00217cc0: 696c 6573 2829 3c2f 6675 6e63 7469 6f6e iles(). │ │ │ -00217ce0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xmlStora │ │ │ -00217d30: 6765 5379 7374 656d 2e73 6176 654d 756c geSystem.saveMul │ │ │ -00217d40: 7469 706c 6546 696c 6573 2829 3c2f 6675 tipleFiles(). .. │ │ │ -00217d80: 2020 200a b600 0000 3b64 656d 6f2f 646f .....;demo/do │ │ │ -00217d90: 6373 7263 2f66 756e 6372 6566 2f78 6d6c csrc/funcref/xml │ │ │ -00217da0: 5374 6f72 6167 6553 7973 7465 6d2e 6d61 StorageSystem.ma │ │ │ -00217db0: 696c 5061 7373 776f 7264 546f 5573 6572 ilPasswordToUser │ │ │ -00217dc0: 2e78 6d6c df00 0010 773c 3f78 6d6c 2076 .xml....w.. .. . │ │ │ -002181c0: 2020 3c72 6566 656e 7472 7974 6974 6c65 xmlStorageSyste │ │ │ -002181e0: 6d2e 6d61 696c 5061 7373 776f 7264 546f m.mailPasswordTo │ │ │ -002181f0: 5573 6572 3c2f 7265 6665 6e74 7279 7469 User. blog. . . xmlStorageSyst │ │ │ -00218260: 656d 2e6d 6169 6c50 6173 7377 6f72 6454 em.mailPasswordT │ │ │ -00218270: 6f55 7365 723c 2f72 6566 6e61 6d65 3e0a oUser. │ │ │ -00218280: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -00218290: 4d61 696c 2070 6173 7377 6f72 6420 746f Mail password to │ │ │ -002182a0: 2075 7365 722e 3c2f 7265 6670 7572 706f user.. . . . . │ │ │ -00218360: 2020 2020 2020 3c66 756e 6364 6566 3e73 s │ │ │ -00218370: 7472 7563 7475 7265 203c 6675 6e63 7469 tructure xmlStorageSys │ │ │ -00218390: 7465 6d2e 6d61 696c 5061 7373 776f 7264 tem.mailPassword │ │ │ -002183a0: 546f 5573 6572 3c2f 6675 6e63 7469 6f6e ToUser. │ │ │ -002183c0: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ -002183d0: 203c 7061 7261 6d65 7465 723e 656d 6169 emai │ │ │ -002183e0: 6c3c 2f70 6172 616d 6574 6572 3e20 7374 l st │ │ │ -002183f0: 7269 6e67 3c2f 7061 7261 6d64 6566 3e0a ring. │ │ │ -00218400: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -00218440: 203c 7265 6673 6563 7431 2069 643d 2264 . Description │ │ │ -00218490: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This method i │ │ │ -002184b0: 7320 7573 6564 2074 6f20 7365 6e64 2074 s used to send t │ │ │ -002184c0: 6865 2070 6173 7377 6f72 6420 666f 7220 he password for │ │ │ -002184d0: 7573 6572 2069 6465 6e74 6966 6965 6420 user identified │ │ │ -002184e0: 6279 2065 6d61 696c 2e0a 2020 2020 546f by email.. To │ │ │ -002184f0: 2077 6f72 6b20 7072 6f70 6572 6c79 2074 work properly t │ │ │ -00218500: 6865 2064 6566 6175 6c74 2053 4d54 5020 he default SMTP │ │ │ -00218510: 7365 7276 6572 2056 6972 7475 6f73 6f20 server Virtuoso │ │ │ -00218520: 494e 4920 6669 6c65 2073 6574 7469 6e67 INI file setting │ │ │ -00218530: 206d 7573 7420 6265 2073 6574 2070 726f must be set pro │ │ │ -00218540: 7065 726c 792e 3c2f 7061 7261 3e0a 2020 perly.. │ │ │ -00218550: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . P │ │ │ -002185a0: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ -002185c0: 3c74 6974 6c65 3e65 6d61 696c 3c2f 7469 email</ti │ │ │ -002185d0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -002185e0: 3e46 6f72 2075 7365 7220 6964 656e 7469 >For user identi │ │ │ -002185f0: 6669 6361 7469 6f6e 2c20 7468 6973 2073 fication, this s │ │ │ -00218600: 686f 756c 6420 6265 2061 2076 616c 6964 hould be a valid │ │ │ -00218610: 2065 6d61 696c 2061 6363 6f75 6e74 2e3c email account.< │ │ │ -00218620: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para></refsect2 │ │ │ -00218630: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ -00218640: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -00218650: 7265 745f 786d 6c53 746f 7261 6765 5379 ret_xmlStorageSy │ │ │ -00218660: 7374 656d 2e6d 6169 6c50 6173 7377 6f72 stem.mailPasswor │ │ │ -00218670: 6454 6f55 7365 7222 3e3c 7469 746c 653e dToUser"><title> │ │ │ -00218680: 5265 7475 726e 2054 7970 6573 3c2f 7469 Return Types</ti │ │ │ -00218690: 746c 653e 0a20 2020 203c 7061 7261 3e54 tle>. <para>T │ │ │ -002186a0: 6869 7320 6d65 7468 6f64 2072 6574 7572 his method retur │ │ │ -002186b0: 6e73 2061 2073 7472 7563 7475 7265 2061 ns a structure a │ │ │ -002186c0: 7320 666f 6c6c 6f77 733a 3c2f 7061 7261 s follows:</para │ │ │ -002186d0: 3e0a 3c70 726f 6772 616d 6c69 7374 696e >.<programlistin │ │ │ -002186e0: 673e 0a20 2020 2026 2333 393b 666c 4572 g>. 'flEr │ │ │ -002186f0: 726f 7226 2333 393b 2062 6f6f 6c65 616e ror' boolean │ │ │ -00218700: 2020 2009 0930 2073 7563 6365 7373 2c20 ..0 success, │ │ │ -00218710: 3120 6661 756c 740a 2020 2020 2623 3339 1 fault. ' │ │ │ -00218720: 3b6d 6573 7361 6765 2623 3339 3b20 7374 ;message' st │ │ │ -00218730: 7269 6e67 2020 2020 0909 6661 756c 7420 ring ..fault │ │ │ -00218740: 6d65 7373 6167 6520 2863 616e 2062 6520 message (can be │ │ │ -00218750: 7573 6564 2074 6f20 6861 6e64 6c65 2065 used to handle e │ │ │ -00218760: 7272 6f72 2063 6173 6573 290a 3c2f 7072 rror cases).</pr │ │ │ -00218770: 6f67 7261 6d6c 6973 7469 6e67 3e0a 200a ogramlisting>. . │ │ │ -00218780: 2020 3c2f 7265 6673 6563 7431 3e0a 3c21 </refsect1>.<! │ │ │ -00218790: 2d2d 0a20 203c 7265 6673 6563 7431 2069 --. <refsect1 i │ │ │ -002187a0: 643d 2265 7272 6f72 735f 786d 6c53 746f d="errors_xmlSto │ │ │ -002187b0: 7261 6765 5379 7374 656d 2e6d 6169 6c50 rageSystem.mailP │ │ │ -002187c0: 6173 7377 6f72 6454 6f55 7365 7222 3e0a asswordToUser">. │ │ │ -002187d0: 2020 2020 3c74 6974 6c65 3e45 7272 6f72 <title>Error │ │ │ -002187e0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c70 s.

    This functio │ │ │ -00218800: 6e20 6361 6e20 6765 6e65 7261 7465 2074 n can generate t │ │ │ -00218810: 6865 2066 6f6c 6c6f 7769 6e67 2065 7272 he following err │ │ │ -00218820: 6f72 733a 3c2f 7061 7261 3e0a 2020 2020 ors:. │ │ │ -00218830: 3c65 7272 6f72 636f 6465 3e3c 2f65 7272 . .-->. . Examples. Mailing the │ │ │ -00218900: 2058 4d4c 2053 746f 7261 6765 2053 7973 XML Storage Sys │ │ │ -00218910: 7465 6d20 5573 6572 7320 5061 7373 776f tem Users Passwo │ │ │ -00218920: 7264 2074 6f20 7468 6520 5573 6572 3c2f rd to the User. Simple exampl │ │ │ -00218950: 6520 6f66 206d 6169 6c69 6e67 2074 6865 e of mailing the │ │ │ -00218960: 2075 7365 7273 2070 6173 7377 6f72 642e users password. │ │ │ -00218970: 3c2f 7061 7261 3e0a 2020 2020 2020 3c73 . . SQL&g │ │ │ -00218990: 743b 2053 4f41 505f 434c 4945 4e54 2028 t; SOAP_CLIENT ( │ │ │ -002189a0: 7572 6c3d 2667 743b 2623 3339 3b68 7474 url=>'htt │ │ │ -002189b0: 703a 2f2f 6578 616d 706c 652e 636f 6d2f p://example.com/ │ │ │ -002189c0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -002189d0: 2623 3339 3b2c 0a20 2020 206f 7065 7261 ',. opera │ │ │ -002189e0: 7469 6f6e 3d26 6774 3b26 2333 393b 6d61 tion=>'ma │ │ │ -002189f0: 696c 5061 7373 776f 7264 546f 5573 6572 ilPasswordToUser │ │ │ -00218a00: 2623 3339 3b2c 2070 6172 616d 6574 6572 ', parameter │ │ │ -00218a10: 733d 2667 743b 7665 6374 6f72 2028 2623 s=>vector (&# │ │ │ -00218a20: 3339 3b65 6d61 696c 2623 3339 3b2c 2623 39;email',&# │ │ │ -00218a30: 3339 3b75 7365 7240 6578 616d 706c 652e 39;user@example. │ │ │ -00218a40: 646f 6d61 696e 2623 3339 3b29 293b 0a0a domain'));.. │ │ │ -00218a50: 2020 2020 534f 4150 2072 6573 706f 6e73 SOAP respons │ │ │ -00218a60: 653a 0a0a 2020 2020 266c 743b 6d61 696c e:.. <mail │ │ │ -00218a70: 5061 7373 776f 7264 546f 5573 6572 5265 PasswordToUserRe │ │ │ -00218a80: 7370 6f6e 7365 2667 743b 0a20 2020 2020 sponse>. │ │ │ -00218a90: 2026 6c74 3b52 6573 756c 7426 6774 3b0a <Result>. │ │ │ -00218aa0: 0926 6c74 3b66 6c45 7272 6f72 2667 743b .<flError> │ │ │ -00218ab0: 3126 6c74 3b2f 666c 4572 726f 7226 6774 1</flError> │ │ │ -00218ac0: 3b0a 0926 6c74 3b6d 6573 7361 6765 2667 ;..<message&g │ │ │ -00218ad0: 743b 4d61 696c 2073 6572 7669 6365 2069 t;Mail service i │ │ │ -00218ae0: 7320 6e6f 7420 6176 6169 6c61 626c 6520 s not available │ │ │ -00218af0: 6f6e 2074 6861 7420 7365 7276 6572 2e26 on that server.& │ │ │ -00218b00: 6c74 3b2f 6d65 7373 6167 6526 6774 3b0a lt;/message>. │ │ │ -00218b10: 2020 2020 2020 266c 743b 2f52 6573 756c </Resul │ │ │ -00218b20: 7426 6774 3b0a 2020 2020 266c 743b 2f6d t>. </m │ │ │ -00218b30: 6169 6c50 6173 7377 6f72 6454 6f55 7365 ailPasswordToUse │ │ │ -00218b40: 7252 6573 706f 6e73 6526 6774 3b0a 3c2f rResponse>.. │ │ │ -00218b60: 2020 4e6f 7465 203a 2069 6e20 7468 6973 Note : in this │ │ │ -00218b70: 2063 6173 6520 656d 6169 6c69 6e67 2077 case emailing w │ │ │ -00218b80: 6173 2066 6169 6c65 643c 2f70 6172 613e as failed │ │ │ -00218b90: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -00218ba0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00218bb0: 3c72 6566 7365 6374 3120 6964 3d22 7365 . │ │ │ -00218bf0: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ -00218c00: 2f74 6974 6c65 3e0a 2020 3c70 6172 613e /title>. <para> │ │ │ -00218c10: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ -00218c20: 6e5f 786d 6c53 746f 7261 6765 5379 7374 n_xmlStorageSyst │ │ │ -00218c30: 656d 2e72 6567 6973 7465 7255 7365 7222 em.registerUser" │ │ │ -00218c40: 3e3c 6675 6e63 7469 6f6e 3e78 6d6c 5374 ><function>xmlSt │ │ │ -00218c50: 6f72 6167 6553 7973 7465 6d2e 7265 6769 orageSystem.regi │ │ │ -00218c60: 7374 6572 5573 6572 2829 3c2f 6675 6e63 sterUser()</func │ │ │ -00218c70: 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 tion></link></pa │ │ │ -00218c80: 7261 3e0a 2020 3c70 6172 613e 3c6c 696e ra>. <para><lin │ │ │ -00218c90: 6b20 6c69 6e6b 656e 643d 2266 6e5f 786d k linkend="fn_xm │ │ │ -00218ca0: 6c53 746f 7261 6765 5379 7374 656d 2e67 lStorageSystem.g │ │ │ -00218cb0: 6574 5365 7276 6572 4361 7061 6269 6c69 etServerCapabili │ │ │ -00218cc0: 7469 6573 223e 3c66 756e 6374 696f 6e3e ties"><function> │ │ │ -00218cd0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -00218ce0: 2e67 6574 5365 7276 6572 4361 7061 6269 .getServerCapabi │ │ │ -00218cf0: 6c69 7469 6573 2829 3c2f 6675 6e63 7469 lities()</functi │ │ │ -00218d00: 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 on></link></para │ │ │ -00218d10: 3e0a 2020 3c70 6172 613e 3c6c 696e 6b20 >. <para><link │ │ │ -00218d20: 6c69 6e6b 656e 643d 2266 6e5f 786d 6c53 linkend="fn_xmlS │ │ │ -00218d30: 746f 7261 6765 5379 7374 656d 2e64 656c torageSystem.del │ │ │ -00218d40: 6574 654d 756c 7469 706c 6546 696c 6573 eteMultipleFiles │ │ │ -00218d50: 223e 3c66 756e 6374 696f 6e3e 786d 6c53 "><function>xmlS │ │ │ -00218d60: 746f 7261 6765 5379 7374 656d 2e64 656c torageSystem.del │ │ │ -00218d70: 6574 654d 756c 7469 706c 6546 696c 6573 eteMultipleFiles │ │ │ -00218d80: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ()</function></l │ │ │ -00218d90: 696e 6b3e 3c2f 7061 7261 3e0a 2020 3c70 ink></para>. <p │ │ │ -00218da0: 6172 613e 3c6c 696e 6b20 6c69 6e6b 656e ara><link linken │ │ │ -00218db0: 643d 2266 6e5f 786d 6c53 746f 7261 6765 d="fn_xmlStorage │ │ │ -00218dc0: 5379 7374 656d 2e73 6176 654d 756c 7469 System.saveMulti │ │ │ -00218dd0: 706c 6546 696c 6573 223e 3c66 756e 6374 pleFiles"><funct │ │ │ -00218de0: 696f 6e3e 786d 6c53 746f 7261 6765 5379 ion>xmlStorageSy │ │ │ -00218df0: 7374 656d 2e73 6176 654d 756c 7469 706c stem.saveMultipl │ │ │ -00218e00: 6546 696c 6573 2829 3c2f 6675 6e63 7469 eFiles()</functi │ │ │ -00218e10: 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 on></link></para │ │ │ -00218e20: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ -00218e30: 3c2f 7265 6665 6e74 7279 3e0a 2020 200a </refentry>. . │ │ │ -00218e40: b600 0000 3e64 656d 6f2f 646f 6373 7263 ....>demo/docsrc │ │ │ -00218e50: 2f66 756e 6372 6566 2f78 6d6c 5374 6f72 /funcref/xmlStor │ │ │ -00218e60: 6167 6553 7973 7465 6d2e 6765 7453 6572 ageSystem.getSer │ │ │ -00218e70: 7665 7243 6170 6162 696c 6974 6965 732e verCapabilities. │ │ │ -00218e80: 786d 6cdf 0000 13f8 3c3f 786d 6c20 7665 xml.....<?xml ve │ │ │ -00218e90: 7273 696f 6e3d 2231 2e30 2220 656e 636f rsion="1.0" enco │ │ │ -00218ea0: 6469 6e67 3d22 4953 4f2d 3838 3539 2d31 ding="ISO-8859-1 │ │ │ -00218eb0: 223f 3e0a 3c21 2d2d 0a20 2d20 200a 202d "?>.<!--. - . - │ │ │ -00218ec0: 2020 5468 6973 2066 696c 6520 6973 2070 This file is p │ │ │ -00218ed0: 6172 7420 6f66 2074 6865 204f 7065 6e4c art of the OpenL │ │ │ -00218ee0: 696e 6b20 536f 6674 7761 7265 2056 6972 ink Software Vir │ │ │ -00218ef0: 7475 6f73 6f20 4f70 656e 2d53 6f75 7263 tuoso Open-Sourc │ │ │ -00218f00: 6520 2856 4f53 290a 202d 2020 7072 6f6a e (VOS). - proj │ │ │ -00218f10: 6563 742e 0a20 2d20 200a 202d 2020 436f ect.. - . - Co │ │ │ -00218f20: 7079 7269 6768 7420 2843 2920 3139 3938 pyright (C) 1998 │ │ │ -00218f30: 2d32 3032 3420 4f70 656e 4c69 6e6b 2053 -2024 OpenLink S │ │ │ -00218f40: 6f66 7477 6172 650a 202d 2020 0a20 2d20 oftware. - . - │ │ │ -00218f50: 2054 6869 7320 7072 6f6a 6563 7420 6973 This project is │ │ │ -00218f60: 2066 7265 6520 736f 6674 7761 7265 3b20 free software; │ │ │ -00218f70: 796f 7520 6361 6e20 7265 6469 7374 7269 you can redistri │ │ │ -00218f80: 6275 7465 2069 7420 616e 642f 6f72 206d bute it and/or m │ │ │ -00218f90: 6f64 6966 7920 6974 0a20 2d20 2075 6e64 odify it. - und │ │ │ -00218fa0: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ -00218fb0: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ -00218fc0: 5075 626c 6963 204c 6963 656e 7365 2061 Public License a │ │ │ -00218fd0: 7320 7075 626c 6973 6865 6420 6279 2074 s published by t │ │ │ -00218fe0: 6865 0a20 2d20 2046 7265 6520 536f 6674 he. - Free Soft │ │ │ -00218ff0: 7761 7265 2046 6f75 6e64 6174 696f 6e3b ware Foundation; │ │ │ -00219000: 206f 6e6c 7920 7665 7273 696f 6e20 3220 only version 2 │ │ │ -00219010: 6f66 2074 6865 204c 6963 656e 7365 2c20 of the License, │ │ │ -00219020: 6461 7465 6420 4a75 6e65 2031 3939 312e dated June 1991. │ │ │ -00219030: 0a20 2d20 200a 202d 2020 5468 6973 2070 . - . - This p │ │ │ -00219040: 726f 6772 616d 2069 7320 6469 7374 7269 rogram is distri │ │ │ -00219050: 6275 7465 6420 696e 2074 6865 2068 6f70 buted in the hop │ │ │ -00219060: 6520 7468 6174 2069 7420 7769 6c6c 2062 e that it will b │ │ │ -00219070: 6520 7573 6566 756c 2c20 6275 740a 202d e useful, but. - │ │ │ -00219080: 2020 5749 5448 4f55 5420 414e 5920 5741 WITHOUT ANY WA │ │ │ -00219090: 5252 414e 5459 3b20 7769 7468 6f75 7420 RRANTY; without │ │ │ -002190a0: 6576 656e 2074 6865 2069 6d70 6c69 6564 even the implied │ │ │ -002190b0: 2077 6172 7261 6e74 7920 6f66 0a20 2d20 warranty of. - │ │ │ -002190c0: 204d 4552 4348 414e 5441 4249 4c49 5459 MERCHANTABILITY │ │ │ -002190d0: 206f 7220 4649 544e 4553 5320 464f 5220 or FITNESS FOR │ │ │ -002190e0: 4120 5041 5254 4943 554c 4152 2050 5552 A PARTICULAR PUR │ │ │ -002190f0: 504f 5345 2e20 5365 6520 7468 6520 474e POSE. See the GN │ │ │ -00219100: 550a 202d 2020 4765 6e65 7261 6c20 5075 U. - General Pu │ │ │ -00219110: 626c 6963 204c 6963 656e 7365 2066 6f72 blic License for │ │ │ -00219120: 206d 6f72 6520 6465 7461 696c 732e 0a20 more details.. │ │ │ -00219130: 2d20 200a 202d 2020 596f 7520 7368 6f75 - . - You shou │ │ │ -00219140: 6c64 2068 6176 6520 7265 6365 6976 6564 ld have received │ │ │ -00219150: 2061 2063 6f70 7920 6f66 2074 6865 2047 a copy of the G │ │ │ -00219160: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -00219170: 6320 4c69 6365 6e73 6520 616c 6f6e 670a c License along. │ │ │ -00219180: 202d 2020 7769 7468 2074 6869 7320 7072 - with this pr │ │ │ -00219190: 6f67 7261 6d3b 2069 6620 6e6f 742c 2077 ogram; if not, w │ │ │ -002191a0: 7269 7465 2074 6f20 7468 6520 4672 6565 rite to the Free │ │ │ -002191b0: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ -002191c0: 7469 6f6e 2c20 496e 632e 2c0a 202d 2020 tion, Inc.,. - │ │ │ -002191d0: 3531 2046 7261 6e6b 6c69 6e20 5374 2c20 51 Franklin St, │ │ │ -002191e0: 4669 6674 6820 466c 6f6f 722c 2042 6f73 Fifth Floor, Bos │ │ │ -002191f0: 746f 6e2c 204d 4120 3032 3131 302d 3133 ton, MA 02110-13 │ │ │ -00219200: 3031 2055 5341 0a20 2d20 200a 202d 2020 01 USA. - . - │ │ │ -00219210: 0a2d 2d3e 0a20 203c 212d 2d20 4372 6561 .-->. <!-- Crea │ │ │ -00219220: 7465 6420 7769 7468 2046 756e 636d 616b ted with Funcmak │ │ │ -00219230: 652e 7673 7020 2d2d 3e0a 3c72 6566 656e e.vsp -->.<refen │ │ │ -00219240: 7472 7920 6964 3d22 666e 5f78 6d6c 5374 try id="fn_xmlSt │ │ │ -00219250: 6f72 6167 6553 7973 7465 6d2e 6765 7453 orageSystem.getS │ │ │ -00219260: 6572 7665 7243 6170 6162 696c 6974 6965 erverCapabilitie │ │ │ -00219270: 7322 3e0a 2020 3c72 6566 6d65 7461 3e0a s">. <refmeta>. │ │ │ -00219280: 2020 2020 3c72 6566 656e 7472 7974 6974 <refentrytit │ │ │ -00219290: 6c65 3e78 6d6c 5374 6f72 6167 6553 7973 le>xmlStorageSys │ │ │ -002192a0: 7465 6d2e 6765 7453 6572 7665 7243 6170 tem.getServerCap │ │ │ -002192b0: 6162 696c 6974 6965 733c 2f72 6566 656e abilities</refen │ │ │ -002192c0: 7472 7974 6974 6c65 3e0a 2020 2020 3c72 trytitle>. <r │ │ │ -002192d0: 6566 6d69 7363 696e 666f 3e62 6c6f 673c efmiscinfo>blog< │ │ │ -002192e0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ -002192f0: 3c2f 7265 666d 6574 613e 0a20 203c 7265 </refmeta>. <re │ │ │ -00219300: 666e 616d 6564 6976 3e0a 2020 2020 3c72 fnamediv>. <r │ │ │ -00219310: 6566 6e61 6d65 3e78 6d6c 5374 6f72 6167 efname>xmlStorag │ │ │ -00219320: 6553 7973 7465 6d2e 6765 7453 6572 7665 eSystem.getServe │ │ │ -00219330: 7243 6170 6162 696c 6974 6965 733c 2f72 rCapabilities</r │ │ │ -00219340: 6566 6e61 6d65 3e0a 2020 2020 3c72 6566 efname>. <ref │ │ │ -00219350: 7075 7270 6f73 653e 5265 7472 6965 7665 purpose>Retrieve │ │ │ -00219360: 2073 6572 7665 7220 7370 6563 6966 6963 server specific │ │ │ -00219370: 2069 6e66 6f72 6d61 7469 6f6e 2e3c 2f72 information.</r │ │ │ -00219380: 6566 7075 7270 6f73 653e 0a20 203c 2f72 efpurpose>. </r │ │ │ -00219390: 6566 6e61 6d65 6469 763e 0a20 203c 7265 efnamediv>. <re │ │ │ -002193a0: 6673 796e 6f70 7369 7364 6976 3e0a 2020 fsynopsisdiv>. │ │ │ -002193b0: 2020 3c66 756e 6373 796e 6f70 7369 7320 <funcsynopsis │ │ │ -002193c0: 6964 3d22 6673 796e 5f78 6d6c 5374 6f72 id="fsyn_xmlStor │ │ │ -002193d0: 6167 6553 7973 7465 6d2e 6765 7453 6572 ageSystem.getSer │ │ │ -002193e0: 7665 7243 6170 6162 696c 6974 6965 7322 verCapabilities" │ │ │ -002193f0: 3e0a 2020 2020 2020 3c66 756e 6370 726f >. <funcpro │ │ │ -00219400: 746f 7479 7065 2069 643d 2266 7072 6f74 totype id="fprot │ │ │ -00219410: 6f5f 786d 6c53 746f 7261 6765 5379 7374 o_xmlStorageSyst │ │ │ -00219420: 656d 2e67 6574 5365 7276 6572 4361 7061 em.getServerCapa │ │ │ -00219430: 6269 6c69 7469 6573 223e 0a20 2020 2020 bilities">. │ │ │ -00219440: 2020 203c 6675 6e63 6465 663e 7374 7275 <funcdef>stru │ │ │ -00219450: 6374 7572 6520 3c66 756e 6374 696f 6e3e cture <function> │ │ │ -00219460: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ -00219470: 2e67 6574 5365 7276 6572 4361 7061 6269 .getServerCapabi │ │ │ -00219480: 6c69 7469 6573 3c2f 6675 6e63 7469 6f6e lities</function │ │ │ -00219490: 3e3c 2f66 756e 6364 6566 3e0a 2020 2020 ></funcdef>. │ │ │ -002194a0: 2020 2020 3c70 6172 616d 6465 663e 696e <paramdef>in │ │ │ -002194b0: 203c 7061 7261 6d65 7465 723e 656d 6169 <parameter>emai │ │ │ -002194c0: 6c3c 2f70 6172 616d 6574 6572 3e20 7374 l</parameter> st │ │ │ -002194d0: 7269 6e67 3c2f 7061 7261 6d64 6566 3e0a ring</paramdef>. │ │ │ -002194e0: 2020 2020 2020 2020 3c70 6172 616d 6465 <paramde │ │ │ -002194f0: 663e 696e 203c 7061 7261 6d65 7465 723e f>in <parameter> │ │ │ -00219500: 7061 7373 776f 7264 3c2f 7061 7261 6d65 password</parame │ │ │ -00219510: 7465 723e 2073 7472 696e 673c 2f70 6172 ter> string</par │ │ │ -00219520: 616d 6465 663e 0a20 2020 2020 203c 2f66 amdef>. </f │ │ │ -00219530: 756e 6370 726f 746f 7479 7065 3e0a 2020 uncprototype>. │ │ │ -00219540: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 </funcsynopsis │ │ │ -00219550: 3e0a 2020 3c2f 7265 6673 796e 6f70 7369 >. </refsynopsi │ │ │ -00219560: 7364 6976 3e0a 2020 3c72 6566 7365 6374 sdiv>. <refsect │ │ │ -00219570: 3120 6964 3d22 6465 7363 5f78 6d6c 5374 1 id="desc_xmlSt │ │ │ -00219580: 6f72 6167 6553 7973 7465 6d2e 6765 7453 orageSystem.getS │ │ │ -00219590: 6572 7665 7243 6170 6162 696c 6974 6965 erverCapabilitie │ │ │ -002195a0: 7322 3e0a 2020 2020 3c74 6974 6c65 3e44 s">. <title>D │ │ │ -002195b0: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ -002195c0: 653e 0a20 2020 203c 7061 7261 3e54 6869 e>. <para>Thi │ │ │ -002195d0: 7320 6d65 7468 6f64 2069 7320 7573 6564 s method is used │ │ │ -002195e0: 2074 6f20 6f62 7461 696e 2069 6e66 6f72 to obtain infor │ │ │ -002195f0: 6d61 7469 6f6e 2061 626f 7574 2074 6865 mation about the │ │ │ -00219600: 2063 6170 6162 696c 6974 6965 7320 6f66 capabilities of │ │ │ -00219610: 2074 6865 2073 6572 7665 722c 2073 7563 the server, suc │ │ │ -00219620: 6820 6173 200a 6669 6c65 7320 7369 7a65 h as .files size │ │ │ -00219630: 206c 696d 6974 6174 696f 6e73 2c20 7375 limitations, su │ │ │ -00219640: 7070 6f72 7465 6420 7479 7065 732c 2065 pported types, e │ │ │ -00219650: 7463 2e2e 2e3c 2f70 6172 613e 0a20 203c tc...</para>. < │ │ │ -00219660: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. <re │ │ │ -00219670: 6673 6563 7431 2069 643d 2270 6172 616d fsect1 id="param │ │ │ -00219680: 735f 786d 6c53 746f 7261 6765 5379 7374 s_xmlStorageSyst │ │ │ -00219690: 656d 2e67 6574 5365 7276 6572 4361 7061 em.getServerCapa │ │ │ -002196a0: 6269 6c69 7469 6573 223e 3c74 6974 6c65 bilities"><title │ │ │ -002196b0: 3e50 6172 616d 6574 6572 733c 2f74 6974 >Parameters</tit │ │ │ -002196c0: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -002196d0: 323e 3c74 6974 6c65 3e65 6d61 696c 3c2f 2><title>email</ │ │ │ -002196e0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -002196f0: 7261 3e46 6f72 2075 7365 7220 6964 656e ra>For user iden │ │ │ -00219700: 7469 6669 6361 7469 6f6e 2c20 7468 6973 tification, this │ │ │ -00219710: 2073 686f 756c 6420 6265 2061 2076 616c should be a val │ │ │ -00219720: 6964 2065 6d61 696c 2061 6363 6f75 6e74 id email account │ │ │ -00219730: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .</para></refsec │ │ │ -00219740: 7432 3e0a 2020 2020 3c72 6566 7365 6374 t2>. <refsect │ │ │ -00219750: 323e 3c74 6974 6c65 3e70 6173 7377 6f72 2><title>passwor │ │ │ -00219760: 643c 2f74 6974 6c65 3e0a 2020 2020 2020 d. │ │ │ -00219770: 3c70 6172 613e 5468 6520 4d44 3520 6861 The MD5 ha │ │ │ -00219780: 7368 206f 6620 7468 6520 7061 7373 776f sh of the passwo │ │ │ -00219790: 7264 2e3c 2f70 6172 613e 3c2f 7265 6673 rd.. . │ │ │ -002197f0: 3c74 6974 6c65 3e52 6574 7572 6e20 5479 Return Ty │ │ │ -00219800: 7065 733c 2f74 6974 6c65 3e0a 2020 2020 pes. │ │ │ -00219810: 3c70 6172 613e 5468 6973 206d 6574 686f This metho │ │ │ -00219820: 6420 7265 7475 726e 7320 6120 7374 7275 d returns a stru │ │ │ -00219830: 6374 7572 6520 6173 2066 6f6c 6c6f 7773 cture as follows │ │ │ -00219840: 3a3c 2f70 6172 613e 0a3c 7072 6f67 7261 :.. &# │ │ │ -00219860: 3339 3b66 6c45 7272 6f72 2623 3339 3b20 39;flError' │ │ │ -00219870: 626f 6f6c 6561 6e20 2020 0909 3020 7375 boolean ..0 su │ │ │ -00219880: 6363 6573 732c 2031 2066 6175 6c74 0a20 ccess, 1 fault. │ │ │ -00219890: 2020 2026 2333 393b 6d65 7373 6167 6526 'message& │ │ │ -002198a0: 2333 393b 2073 7472 696e 6720 2020 2009 #39; string . │ │ │ -002198b0: 0966 6175 6c74 206d 6573 7361 6765 2028 .fault message ( │ │ │ -002198c0: 6361 6e20 6265 2075 7365 6420 746f 2068 can be used to h │ │ │ -002198d0: 616e 646c 6520 6572 726f 7220 6361 7365 andle error case │ │ │ -002198e0: 7329 0a20 2020 2020 6374 4279 7465 7349 s). ctBytesI │ │ │ -002198f0: 6e55 7365 2069 6e74 6567 6572 0909 686f nUse integer..ho │ │ │ -00219900: 7720 6d61 6e79 2062 7974 6573 2061 7265 w many bytes are │ │ │ -00219910: 2075 7365 6420 6f6e 2072 6570 6f73 6974 used on reposit │ │ │ -00219920: 6f72 790a 2020 2020 206c 6567 616c 4669 ory. legalFi │ │ │ -00219930: 6c65 4578 7465 6e73 696f 6e73 2073 7472 leExtensions str │ │ │ -00219940: 696e 6720 6172 7261 7920 2020 7768 6963 ing array whic │ │ │ -00219950: 6820 6578 7465 6e73 696f 6e73 2061 7265 h extensions are │ │ │ -00219960: 2072 6563 6f67 6e69 7a65 6420 0a20 2020 recognized . │ │ │ -00219970: 2020 6d61 7842 7974 6573 5065 7255 7365 maxBytesPerUse │ │ │ -00219980: 7220 696e 7465 6765 7209 0974 6f74 616c r integer..total │ │ │ -00219990: 2062 7974 6573 2061 7661 696c 6162 6c65 bytes available │ │ │ -002199a0: 2066 6f72 2074 6869 7320 7573 6572 0a20 for this user. │ │ │ -002199b0: 2020 2020 6d61 7846 696c 6553 697a 6520 maxFileSize │ │ │ -002199c0: 696e 7465 6765 7209 096c 6172 6765 7374 integer..largest │ │ │ -002199d0: 2066 696c 6520 7369 7a65 2066 6f72 2075 file size for u │ │ │ -002199e0: 706c 6f61 6420 2862 7974 6573 290a 2020 pload (bytes). │ │ │ -002199f0: 2020 2079 6f75 7255 7073 7472 6561 6d46 yourUpstreamF │ │ │ -00219a00: 6f6c 6465 7255 726c 2073 7472 696e 6709 olderUrl string. │ │ │ -00219a10: 6261 7365 2055 524c 2066 6f72 2075 7365 base URL for use │ │ │ -00219a20: 7226 2333 393b 7320 626c 6f67 206f 6e20 r's blog on │ │ │ -00219a30: 7265 706f 7369 746f 7279 0a3c 2f70 726f repository.. . │ │ │ -00219a50: 203c 2f72 6566 7365 6374 313e 0a3c 212d .. Err │ │ │ -00219ab0: 6f72 733c 2f74 6974 6c65 3e0a 2020 2020 ors. │ │ │ -00219ac0: 3c70 6172 613e 5468 6973 2066 756e 6374 This funct │ │ │ -00219ad0: 696f 6e20 6361 6e20 6765 6e65 7261 7465 ion can generate │ │ │ -00219ae0: 2074 6865 2066 6f6c 6c6f 7769 6e67 2065 the following e │ │ │ -00219af0: 7272 6f72 733a 3c2f 7061 7261 3e0a 2020 rrors:. │ │ │ -00219b00: 2020 3c65 7272 6f72 636f 6465 3e3c 2f65 . .-->. . │ │ │ -00219b70: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 Example │ │ │ -00219b80: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. Ret │ │ │ -00219bd0: 7269 6576 696e 6720 7468 6520 584d 4c20 rieving the XML │ │ │ -00219be0: 5374 6f72 6167 6520 5379 7374 656d 2043 Storage System C │ │ │ -00219bf0: 6170 6162 696c 6974 6965 733c 2f74 6974 apabilities</tit │ │ │ -00219c00: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -00219c10: 5369 6d70 6c65 2065 7861 6d70 6c65 206f Simple example o │ │ │ -00219c20: 6620 6665 7463 6869 6e67 2074 6865 2073 f fetching the s │ │ │ -00219c30: 6572 7665 7220 6361 7061 6269 6c69 7469 erver capabiliti │ │ │ -00219c40: 6573 2e3c 2f70 6172 613e 0a20 2020 2020 es.</para>. │ │ │ -00219c50: 203c 7363 7265 656e 3e0a 2020 2020 5351 <screen>. SQ │ │ │ -00219c60: 4c26 6774 3b20 534f 4150 5f43 4c49 454e L> SOAP_CLIEN │ │ │ -00219c70: 5420 2875 726c 3d26 6774 3b26 2333 393b T (url=>' │ │ │ -00219c80: 6874 7470 3a2f 2f65 7861 6d70 6c65 2e63 http://example.c │ │ │ -00219c90: 6f6d 2f78 6d6c 5374 6f72 6167 6553 7973 om/xmlStorageSys │ │ │ -00219ca0: 7465 6d26 2333 393b 2c0a 096f 7065 7261 tem',..opera │ │ │ -00219cb0: 7469 6f6e 3d26 6774 3b26 2333 393b 6765 tion=>'ge │ │ │ -00219cc0: 7453 6572 7665 7243 6170 6162 696c 6974 tServerCapabilit │ │ │ -00219cd0: 6965 7326 2333 393b 2c20 7061 7261 6d65 ies', parame │ │ │ -00219ce0: 7465 7273 3d26 6774 3b76 6563 746f 720a ters=>vector. │ │ │ -00219cf0: 0928 2623 3339 3b65 6d61 696c 2623 3339 .('email' │ │ │ -00219d00: 3b2c 2623 3339 3b75 7365 7240 6578 616d ;,'user@exam │ │ │ -00219d10: 706c 652e 646f 6d61 696e 2623 3339 3b2c ple.domain', │ │ │ -00219d20: 2026 2333 393b 7061 7373 776f 7264 2623 'password&# │ │ │ -00219d30: 3339 3b2c 206d 6435 2826 2333 393b 7878 39;, md5('xx │ │ │ -00219d40: 7826 2333 393b 2929 3b0a 0a20 2020 2053 x'));.. S │ │ │ -00219d50: 4f41 5020 7265 7370 6f6e 7365 3a09 0a0a OAP response:... │ │ │ -00219d60: 2020 2020 266c 743b 6765 7453 6572 7665 <getServe │ │ │ -00219d70: 7243 6170 6162 696c 6974 6965 7352 6573 rCapabilitiesRes │ │ │ -00219d80: 706f 6e73 6526 6774 3b0a 2020 2020 2020 ponse>. │ │ │ -00219d90: 2026 6c74 3b52 6573 756c 7426 6774 3b0a <Result>. │ │ │ -00219da0: 0920 266c 743b 6374 4279 7465 7349 6e55 . <ctBytesInU │ │ │ -00219db0: 7365 2667 743b 3134 266c 743b 2f63 7442 se>14</ctB │ │ │ -00219dc0: 7974 6573 496e 5573 6526 6774 3b0a 0920 ytesInUse>.. │ │ │ -00219dd0: 266c 743b 666c 4572 726f 7226 6774 3b30 <flError>0 │ │ │ -00219de0: 266c 743b 2f66 6c45 7272 6f72 2667 743b </flError> │ │ │ -00219df0: 0a09 2020 2026 6c74 3b6c 6567 616c 4669 .. <legalFi │ │ │ -00219e00: 6c65 4578 7465 6e73 696f 6e73 2667 743b leExtensions> │ │ │ -00219e10: 0a09 2020 2020 2026 6c74 3b69 7465 6d26 .. <item& │ │ │ -00219e20: 6774 3b61 6926 6c74 3b2f 6974 656d 2667 gt;ai</item&g │ │ │ -00219e30: 743b 0a09 2020 2020 2026 6c74 3b69 7465 t;.. <ite │ │ │ -00219e40: 6d26 6774 3b61 6966 266c 743b 2f69 7465 m>aif</ite │ │ │ -00219e50: 6d26 6774 3b0a 0920 2020 2020 266c 743b m>.. < │ │ │ -00219e60: 6974 656d 2667 743b 6169 6663 266c 743b item>aifc< │ │ │ -00219e70: 2f69 7465 6d26 6774 3b0a 0920 2020 266c /item>.. &l │ │ │ -00219e80: 743b 2f6c 6567 616c 4669 6c65 4578 7465 t;/legalFileExte │ │ │ -00219e90: 6e73 696f 6e73 2667 743b 0a09 2026 6c74 nsions>.. < │ │ │ -00219ea0: 3b6d 6178 4279 7465 7350 6572 5573 6572 ;maxBytesPerUser │ │ │ -00219eb0: 2667 743b 3431 3934 3330 3430 266c 743b >41943040< │ │ │ -00219ec0: 2f6d 6178 4279 7465 7350 6572 5573 6572 /maxBytesPerUser │ │ │ -00219ed0: 2667 743b 0a09 2026 6c74 3b6d 6178 4669 >.. <maxFi │ │ │ -00219ee0: 6c65 5369 7a65 2667 743b 3130 3438 3537 leSize>104857 │ │ │ -00219ef0: 3626 6c74 3b2f 6d61 7846 696c 6553 697a 6</maxFileSiz │ │ │ -00219f00: 6526 6774 3b0a 0920 266c 743b 6d65 7373 e>.. <mess │ │ │ -00219f10: 6167 6520 2f26 6774 3b0a 0920 266c 743b age />.. < │ │ │ -00219f20: 796f 7572 5570 7374 7265 616d 466f 6c64 yourUpstreamFold │ │ │ -00219f30: 6572 5572 6c26 6774 3b68 7474 703a 2f2f erUrl>http:// │ │ │ -00219f40: 6578 616d 706c 652e 636f 6d2f 4441 562f example.com/DAV/ │ │ │ -00219f50: 7573 6572 4065 7861 6d70 6c65 2e64 6f6d user@example.dom │ │ │ -00219f60: 6169 6e2f 626c 6f67 2f26 6c74 3b2f 796f ain/blog/</yo │ │ │ -00219f70: 7572 5570 7374 7265 616d 466f 6c64 6572 urUpstreamFolder │ │ │ -00219f80: 5572 6c26 6774 3b0a 2020 2020 2020 2026 Url>. & │ │ │ -00219f90: 6c74 3b2f 5265 7375 6c74 2667 743b 0a20 lt;/Result>. │ │ │ -00219fa0: 2020 2026 6c74 3b2f 6765 7453 6572 7665 </getServe │ │ │ -00219fb0: 7243 6170 6162 696c 6974 6965 7352 6573 rCapabilitiesRes │ │ │ -00219fc0: 706f 6e73 6526 6774 3b0a 3c2f 7363 7265 ponse>.</scre │ │ │ -00219fd0: 656e 3e0a 2020 2020 3c2f 6578 616d 706c en>. </exampl │ │ │ -00219fe0: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ -00219ff0: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ -0021a000: 2273 6565 616c 736f 5f78 6d6c 5374 6f72 "seealso_xmlStor │ │ │ -0021a010: 6167 6553 7973 7465 6d2e 6765 7453 6572 ageSystem.getSer │ │ │ -0021a020: 7665 7243 6170 6162 696c 6974 6965 7322 verCapabilities" │ │ │ -0021a030: 3e0a 2020 2020 3c74 6974 6c65 3e53 6565 >. <title>See │ │ │ -0021a040: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -0021a050: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xmlStorageSyste │ │ │ -0021a0a0: 6d2e 7265 6769 7374 6572 5573 6572 2829 m.registerUser() │ │ │ -0021a0b0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e . xmlStorageSys │ │ │ -0021a120: 7465 6d2e 6d61 696c 5061 7373 776f 7264 tem.mailPassword │ │ │ -0021a130: 546f 5573 6572 2829 3c2f 6675 6e63 7469 ToUser(). xmlS │ │ │ -0021a1a0: 746f 7261 6765 5379 7374 656d 2e64 656c torageSystem.del │ │ │ -0021a1b0: 6574 654d 756c 7469 706c 6546 696c 6573 eteMultipleFiles │ │ │ -0021a1c0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ().

    xmlStorageSy │ │ │ -0021a230: 7374 656d 2e73 6176 654d 756c 7469 706c stem.saveMultipl │ │ │ -0021a240: 6546 696c 6573 2829 3c2f 6675 6e63 7469 eFiles(). . │ │ │ -0021a270: 3c2f 7265 6665 6e74 7279 3e0a 2020 200a . . │ │ │ -0021a280: b600 0000 3c64 656d 6f2f 646f 6373 7263 ....... │ │ │ -0021a6b0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ -0021a6c0: 3c72 6566 656e 7472 7974 6974 6c65 3e78 x │ │ │ -0021a6d0: 6d6c 5374 6f72 6167 6553 7973 7465 6d2e mlStorageSystem. │ │ │ -0021a6e0: 6465 6c65 7465 4d75 6c74 6970 6c65 4669 deleteMultipleFi │ │ │ -0021a6f0: 6c65 733c 2f72 6566 656e 7472 7974 6974 les. blog. . . xmlStorageSyste │ │ │ -0021a760: 6d2e 6465 6c65 7465 4d75 6c74 6970 6c65 m.deleteMultiple │ │ │ -0021a770: 4669 6c65 733c 2f72 6566 6e61 6d65 3e0a Files. │ │ │ -0021a780: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -0021a790: 5265 6d6f 7665 2066 696c 6573 2066 726f Remove files fro │ │ │ -0021a7a0: 6d20 584d 4c20 5374 6f72 6167 6520 5379 m XML Storage Sy │ │ │ -0021a7b0: 7374 656d 2044 6972 6563 746f 7279 3c2f stem Directory. . . │ │ │ -0021a7f0: 2020 203c 6675 6e63 7379 6e6f 7073 6973 │ │ │ -0021a830: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . │ │ │ -0021a880: 3c66 756e 6364 6566 3e73 7472 7563 7475 structu │ │ │ -0021a890: 7265 203c 6675 6e63 7469 6f6e 3e78 6d6c re xml │ │ │ -0021a8a0: 5374 6f72 6167 6553 7973 7465 6d2e 6465 StorageSystem.de │ │ │ -0021a8b0: 6c65 7465 4d75 6c74 6970 6c65 4669 6c65 leteMultipleFile │ │ │ -0021a8c0: 733c 2f66 756e 6374 696f 6e3e 3c2f 6675 s. < │ │ │ -0021a8e0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in email string< │ │ │ -0021a910: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -0021a920: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -0021a930: 3c70 6172 616d 6574 6572 3e70 6173 7377 passw │ │ │ -0021a940: 6f72 643c 2f70 6172 616d 6574 6572 3e20 ord │ │ │ -0021a950: 7374 7269 6e67 3c2f 7061 7261 6d64 6566 string. in relativepathLi │ │ │ -0021a990: 7374 3c2f 7061 7261 6d65 7465 723e 2061 st a │ │ │ -0021a9a0: 7272 6179 3c2f 7061 7261 6d64 6566 3e0a rray. │ │ │ -0021a9b0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -0021a9f0: 203c 7265 6673 6563 7431 2069 643d 2264 . < │ │ │ -0021aa30: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ -0021aa40: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    This method │ │ │ -0021aa60: 6973 2075 7365 6420 666f 7220 7265 6d6f is used for remo │ │ │ -0021aa70: 7669 6e67 2066 696c 6573 2066 726f 6d20 ving files from │ │ │ -0021aa80: 7468 6520 7265 706f 7369 746f 7279 2e3c the repository.< │ │ │ -0021aa90: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . Paramet │ │ │ -0021aaf0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -0021ab00: 3c72 6566 7365 6374 323e 3c74 6974 6c65 email. │ │ │ -0021ab20: 2020 2020 203c 7061 7261 3e46 6f72 2075 For u │ │ │ -0021ab30: 7365 7220 6964 656e 7469 6669 6361 7469 ser identificati │ │ │ -0021ab40: 6f6e 2c20 7468 6973 2073 686f 756c 6420 on, this should │ │ │ -0021ab50: 6265 2061 2076 616c 6964 2065 6d61 696c be a valid email │ │ │ -0021ab60: 2061 6363 6f75 6e74 2e3c 2f70 6172 613e account. │ │ │ -0021ab70: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -0021ab80: 3c72 6566 7365 6374 323e 3c74 6974 6c65 password. Th │ │ │ -0021abb0: 6520 4d44 3520 6861 7368 206f 6620 7468 e MD5 hash of th │ │ │ -0021abc0: 6520 7061 7373 776f 7264 2e3c 2f70 6172 e password.. │ │ │ -0021abe0: 2020 3c72 6566 7365 6374 323e 3c74 6974 relativepathL │ │ │ -0021ac00: 6973 743c 2f74 6974 6c65 3e0a 2020 2020 ist. │ │ │ -0021ac10: 2020 3c70 6172 613e 4172 7261 7920 6f66 Array of │ │ │ -0021ac20: 2073 7472 696e 6773 206f 6620 7061 7468 strings of path │ │ │ -0021ac30: 7320 7265 6c61 7469 7665 2074 6f20 7468 s relative to th │ │ │ -0021ac40: 6520 0a3c 636f 6d70 7574 6572 6f75 7470 e .<user home │ │ │ -0021ac60: 2667 743b 2f62 6c6f 673c 2f63 6f6d 7075 >/blog folde │ │ │ -0021ac80: 7220 0a69 6e20 5765 6244 4156 2074 6f20 r .in WebDAV to │ │ │ -0021ac90: 6265 2064 656c 6574 6564 2e3c 2f70 6172 be deleted.. │ │ │ -0021acb0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . Ret │ │ │ -0021ad00: 7572 6e20 5479 7065 733c 2f74 6974 6c65 urn Types. This │ │ │ -0021ad20: 206d 6574 686f 6420 7265 7475 726e 7320 method returns │ │ │ -0021ad30: 6120 7374 7275 6374 7572 6520 6173 2066 a structure as f │ │ │ -0021ad40: 6f6c 6c6f 7773 3a3c 2f70 6172 613e 0a3c ollows:.< │ │ │ -0021ad50: 7072 6f67 7261 6d6c 6973 7469 6e67 3e0a programlisting>. │ │ │ -0021ad60: 2020 2020 2623 3339 3b66 6c45 7272 6f72 'flError │ │ │ -0021ad70: 2623 3339 3b20 626f 6f6c 6561 6e20 2020 ' boolean │ │ │ -0021ad80: 0909 3020 7375 6363 6573 732c 2031 2066 ..0 success, 1 f │ │ │ -0021ad90: 6175 6c74 0a20 2020 2026 2333 393b 6d65 ault. 'me │ │ │ -0021ada0: 7373 6167 6526 2333 393b 2073 7472 696e ssage' strin │ │ │ -0021adb0: 6720 2020 2009 0966 6175 6c74 206d 6573 g ..fault mes │ │ │ -0021adc0: 7361 6765 2028 6361 6e20 6265 2075 7365 sage (can be use │ │ │ -0021add0: 6420 746f 2068 616e 646c 6520 6572 726f d to handle erro │ │ │ -0021ade0: 7220 6361 7365 7329 0a20 2020 2026 2333 r cases).  │ │ │ -0021adf0: 393b 6572 726f 724c 6973 7426 2333 393b 9;errorList' │ │ │ -0021ae00: 2061 7272 6179 206f 6620 7374 7269 6e67 array of string │ │ │ -0021ae10: 2009 636f 6e74 6169 6e73 2061 206c 6973 .contains a lis │ │ │ -0021ae20: 7420 6f66 2065 7272 6f72 7320 636f 7272 t of errors corr │ │ │ -0021ae30: 6573 706f 6e64 696e 6720 746f 2066 696c esponding to fil │ │ │ -0021ae40: 6573 0a20 2020 2020 2020 2020 2020 2020 es. │ │ │ -0021ae50: 2020 2020 2020 2020 2077 6869 6368 2063 which c │ │ │ -0021ae60: 616e 6e6f 7420 6265 2072 656d 6f76 6564 annot be removed │ │ │ -0021ae70: 2e20 2053 7563 6365 7373 6675 6c6c 7920 . Successfully │ │ │ -0021ae80: 6465 6c65 7465 6420 6669 6c65 7320 6861 deleted files ha │ │ │ -0021ae90: 7665 2061 6e20 656d 7074 7920 7374 7269 ve an empty stri │ │ │ -0021aea0: 6e67 2e0a 3c2f 7072 6f67 7261 6d6c 6973 ng... . ... . xenc_x509_ │ │ │ -0021b9d0: 7373 5f67 656e 6572 6174 653c 2f72 6566 ss_generate. │ │ │ -0021b9f0: 3c72 6566 6d69 7363 696e 666f 3e68 6173 has │ │ │ -0021ba00: 683c 2f72 6566 6d69 7363 696e 666f 3e0a h. │ │ │ -0021ba10: 2020 3c2f 7265 666d 6574 613e 0a20 203c . < │ │ │ -0021ba20: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ -0021ba30: 3c72 6566 6e61 6d65 3e78 656e 635f 7835 xenc_x5 │ │ │ -0021ba40: 3039 5f73 735f 6765 6e65 7261 7465 3c2f 09_ss_generate. Creates │ │ │ -0021ba70: 2061 2073 656c 662d 7369 676e 6564 2058 a self-signed X │ │ │ -0021ba80: 2e35 3039 7633 2063 6572 7469 6669 6361 .509v3 certifica │ │ │ -0021ba90: 7465 3c2f 7265 6670 7572 706f 7365 3e0a te. │ │ │ -0021baa0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -0021bab0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ -0021bb30: 2020 2020 2020 3c66 756e 6364 6566 3e3c < │ │ │ -0021bb40: 6675 6e63 7469 6f6e 3e78 656e 635f 7835 function>xenc_x5 │ │ │ -0021bb50: 3039 5f73 735f 6765 6e65 7261 7465 3c2f 09_ss_generate..i │ │ │ -0021bb80: 6e20 3c70 6172 616d 6574 6572 3e6b 6579 n key │ │ │ -0021bb90: 5f6e 616d 653c 2f70 6172 616d 6574 6572 _name varchar.. │ │ │ -0021bbc0: 696e 203c 7061 7261 6d65 7465 723e 7365 in se │ │ │ -0021bbd0: 7269 616c 3c2f 7061 7261 6d65 7465 723e rial │ │ │ -0021bbe0: 2069 6e74 6567 6572 3c2f 7061 7261 6d64 integer..i │ │ │ -0021bc00: 6e20 3c70 6172 616d 6574 6572 3e76 616c n val │ │ │ -0021bc10: 6964 6974 793c 2f70 6172 616d 6574 6572 idity integer.. │ │ │ -0021bc40: 696e 203c 7061 7261 6d65 7465 723e 7375 in su │ │ │ -0021bc50: 626a 6563 743c 2f70 6172 616d 6574 6572 bject vector..i │ │ │ -0021bc80: 6e20 3c70 6172 616d 6574 6572 3e65 7874 n ext │ │ │ -0021bc90: 656e 7369 6f6e 733c 2f70 6172 616d 6574 ensions vector. . │ │ │ -0021bcd0: 203c 2f66 756e 6373 796e 6f70 7369 733e │ │ │ -0021bce0: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . . . Des │ │ │ -0021bd30: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -0021bd40: 0a20 2020 203c 7061 7261 3e54 6869 7320 . This │ │ │ -0021bd50: 6675 6e63 7469 6f6e 2069 7320 7573 6564 function is used │ │ │ -0021bd60: 2074 6f20 6372 6561 7465 2061 2073 656c to create a sel │ │ │ -0021bd70: 662d 7369 676e 6564 2058 2e35 3039 2063 f-signed X.509 c │ │ │ -0021bd80: 6572 7469 6669 6361 7465 2062 7920 6769 ertificate by gi │ │ │ -0021bd90: 7665 6e20 7072 6976 6174 6520 6b65 793c ven private key< │ │ │ -0021bda0: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . . P │ │ │ -0021bdf0: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ -0021be10: 3c74 6974 6c65 3e6b 6579 5f6e 616d 653c key_name< │ │ │ -0021be20: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -0021be30: 6172 613e 5468 6520 6e61 6d65 206f 6620 ara>The name of │ │ │ -0021be40: 7468 6520 6b65 7920 7573 6564 2074 6f20 the key used to │ │ │ -0021be50: 6372 6561 7465 2061 6e64 2073 6967 6e20 create and sign │ │ │ -0021be60: 7468 6520 6365 7274 6966 6963 6174 653c the certificate< │ │ │ -0021be70: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. </ref │ │ │ -0021be80: 7365 6374 323e 0a20 2020 203c 7265 6673 sect2>. <refs │ │ │ -0021be90: 6563 7432 3e3c 7469 746c 653e 7365 7269 ect2><title>seri │ │ │ -0021bea0: 616c 3c2f 7469 746c 653e 0a20 2020 2020 al. │ │ │ -0021beb0: 203c 7061 7261 3e54 6865 2073 6572 6961 The seria │ │ │ -0021bec0: 6c20 6e75 6d62 6572 3c2f 7061 7261 3e0a l number. │ │ │ -0021bed0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ -0021bee0: 2020 2020 3c72 6566 7365 6374 323e 3c74 validity. Certificate's │ │ │ -0021bf20: 7661 6c69 6469 7479 2069 6e20 6461 7973 validity in days │ │ │ -0021bf30: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . sub │ │ │ -0021bf60: 6a65 6374 3c2f 7469 746c 653e 0a09 3c70 ject..

    An array of │ │ │ -0021bf80: 6e61 6d65 2f76 616c 7565 2070 6169 7273 name/value pairs │ │ │ -0021bf90: 2072 6570 7265 7365 6e74 696e 6720 7468 representing th │ │ │ -0021bfa0: 6520 7375 626a 6563 7420 616b 6120 6e61 e subject aka na │ │ │ -0021bfb0: 6d65 2065 6e74 6965 7320 3c2f 7061 7261 me enties . . │ │ │ -0021bfe0: 3c74 6974 6c65 3e65 7874 656e 7369 6f6e extension │ │ │ -0021bff0: 733c 2f74 6974 6c65 3e0a 093c 7061 7261 s..An array of nam │ │ │ -0021c010: 652f 7661 6c75 6520 7061 6972 7320 746f e/value pairs to │ │ │ -0021c020: 2061 6464 2061 7320 582e 3530 3976 3320 add as X.509v3 │ │ │ -0021c030: 6578 7465 6e73 696f 6e73 2074 6f20 6365 extensions to ce │ │ │ -0021c040: 7274 6966 6963 6174 653c 2f70 6172 613e rtificate │ │ │ -0021c050: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ -0021c060: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -0021c070: 203c 7265 6673 6563 7431 2069 643d 2265 . │ │ │ -0021c0a0: 2020 2020 3c74 6974 6c65 3e45 7861 6d70 Examp │ │ │ -0021c0b0: 6c65 733c 2f74 6974 6c65 3e0a 2020 2020 les. │ │ │ -0021c0c0: 3c65 7861 6d70 6c65 2069 643d 2265 785f Se │ │ │ -0021c0f0: 6c66 2d73 6967 6e65 6420 6365 7274 6966 lf-signed certif │ │ │ -0021c100: 6963 6174 6520 6765 6e65 7261 7469 6f6e icate generation │ │ │ -0021c110: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0021c120: 7061 7261 3e54 6865 2065 7861 6d70 6c65 para>The example │ │ │ -0021c130: 2062 656c 6f77 2073 686f 7773 2068 6f77 below shows how │ │ │ -0021c140: 2063 6f75 6c64 2062 6520 6372 6561 7465 could be create │ │ │ -0021c150: 6420 5253 4120 7072 6976 6174 6520 6b65 d RSA private ke │ │ │ -0021c160: 792c 2074 6865 6e20 7365 6c66 2d73 6967 y, then self-sig │ │ │ -0021c170: 6e65 6420 6365 7274 6966 6963 6174 6520 ned certificate │ │ │ -0021c180: 616e 6420 6669 6e61 6c6c 7920 746f 2062 and finally to b │ │ │ -0021c190: 6520 7374 6f72 6564 2069 6e20 7468 6520 e stored in the │ │ │ -0021c1a0: 7573 6572 2773 206b 6579 2073 746f 7265 user's key store │ │ │ -0021c1b0: 2e3c 2f70 6172 613e 0a20 2020 2020 203c .. < │ │ │ -0021c1c0: 7363 7265 656e 3e3c 215b 4344 4154 415b screen>. │ │ │ -0021c3f0: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f . . . See Also. │ │ │ -0021c460: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 user │ │ │ -0021c490: 5f6b 6579 5f73 746f 7265 2829 3c2f 6675 _key_store(). │ │ │ -0021c4c0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 │ │ │ -0021c4f0: 7865 6e63 5f78 3530 395f 6765 6e65 7261 xenc_x509_genera │ │ │ -0021c500: 7465 2829 3c2f 6675 6e63 7469 6f6e 3e3c te()< │ │ │ -0021c510: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -0021c520: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 < │ │ │ -0021c550: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -0021c560: 795f 5253 415f 6372 6561 7465 2829 3c2f y_RSA_create() │ │ │ -0021c580: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xenc_pkcs12_ex │ │ │ -0021c5d0: 706f 7274 2829 3c2f 6675 6e63 7469 6f6e port(). │ │ │ -0021c5f0: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......*d │ │ │ -0021c610: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -0021c620: 6566 2f78 656e 635f 7835 3039 5f67 656e ef/xenc_x509_gen │ │ │ -0021c630: 6572 6174 652e 786d 6cdf 0000 120a 3c3f erate.xml........ │ │ │ -0021dc30: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -0021dc40: 7265 6665 6e74 7279 7469 746c 653e 7865 refentrytitle>xe │ │ │ -0021dc50: 6e63 5f78 3530 395f 6672 6f6d 5f63 7372 nc_x509_from_csr │ │ │ -0021dc60: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ -0021dc70: 0a20 2020 203c 7265 666d 6973 6369 6e66 . hash. . │ │ │ -0021dcb0: 0a20 2020 203c 7265 666e 616d 653e 7865 . xe │ │ │ -0021dcc0: 6e63 5f78 3530 395f 6672 6f6d 5f63 7372 nc_x509_from_csr │ │ │ -0021dcd0: 3c2f 7265 666e 616d 653e 0a20 2020 203c . < │ │ │ -0021dce0: 7265 6670 7572 706f 7365 3e47 656e 6572 refpurpose>Gener │ │ │ -0021dcf0: 6174 6520 7835 3039 2063 6572 7469 6669 ate x509 certifi │ │ │ -0021dd00: 6361 7465 2066 726f 6d20 4353 522e 3c2f cate from CSR.. . . │ │ │ -0021dd40: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . │ │ │ -0021dd70: 2020 2020 203c 6675 6e63 7072 6f74 6f74 . varchar xenc_x509 │ │ │ -0021ddd0: 5f66 726f 6d5f 6373 723c 2f66 756e 6374 _from_csr.. │ │ │ -0021ddf0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -0021de10: 6361 5f6b 6579 5f6e 616d 653c 2f70 6172 ca_key_name varchar< │ │ │ -0021de30: 2f70 6172 616d 6465 663e 0a09 2020 2020 /paramdef>.. │ │ │ -0021de40: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ -0021de50: 203c 7061 7261 6d65 7465 723e 636c 695f cli_ │ │ │ -0021de60: 6b65 795f 6e61 6d65 3c2f 7061 7261 6d65 key_name varchar. │ │ │ -0021de90: 0a09 2020 2020 2020 2020 3c70 6172 616d .. in csr_str varchar

    . │ │ │ -0021dee0: 200a 0920 2020 2020 2020 203c 7061 7261 .. in serial_no varchar │ │ │ -0021df20: 3c2f 7061 7261 6d64 6566 3e09 2020 2020 . │ │ │ -0021df30: 2020 2020 0920 2020 2020 2020 2009 2020 . . │ │ │ -0021df40: 2020 2020 2020 0a09 2020 2020 2020 2020 .. │ │ │ -0021df50: 3c70 6172 616d 6465 663e 696e 203c 7061 in days_val │ │ │ -0021df70: 6964 6974 793c 2f70 6172 616d 6574 6572 idity varchar. . │ │ │ -0021dfa0: 2020 2020 2020 0920 2020 2020 2020 2009 . . │ │ │ -0021dfb0: 2020 2020 2020 2020 0a09 2020 2020 2020 .. │ │ │ -0021dfc0: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -0021dfd0: 7061 7261 6d65 7465 723e 686f 7572 735f parameter>hours_ │ │ │ -0021dfe0: 7661 6c69 6469 7479 3c2f 7061 7261 6d65 validity varchar. │ │ │ -0021e010: 0a20 2020 2020 3c2f 6675 6e63 7072 6f74 . . .
    . │ │ │ -0021e050: 203c 7265 6673 6563 7431 2069 643d 2264 D │ │ │ -0021e080: 6573 6372 6970 7469 6f6e 3c2f 7469 746c escription</titl │ │ │ -0021e090: 653e 0a20 2020 2020 203c 7061 7261 3e54 e>. <para>T │ │ │ -0021e0a0: 6869 7320 6675 6e63 7469 6f6e 2067 656e his function gen │ │ │ -0021e0b0: 6572 6174 6573 2043 6572 7469 6669 6361 erates Certifica │ │ │ -0021e0c0: 7465 2053 6967 6e69 6e67 2052 6571 7565 te Signing Reque │ │ │ -0021e0d0: 7374 2028 4353 5229 2e20 5468 6520 6675 st (CSR). The fu │ │ │ -0021e0e0: 6e63 7469 6f6e 2072 6574 7572 6e20 3120 nction return 1 │ │ │ -0021e0f0: 7570 6f6e 2073 7563 6365 7373 2c20 0a20 upon success, . │ │ │ -0021e100: 2020 2020 2009 7371 6c20 6572 726f 7220 .sql error │ │ │ -0021e110: 6f6e 2066 6169 6c75 7265 2e20 5468 6520 on failure. The │ │ │ -0021e120: 6e65 7720 6365 7274 6966 6963 6174 6520 new certificate │ │ │ -0021e130: 6361 6e20 6265 2065 7870 6f72 7465 6420 can be exported │ │ │ -0021e140: 696e 2050 454d 2066 6f72 6d61 7420 7769 in PEM format wi │ │ │ -0021e150: 7468 200a 2020 2020 2020 093c 6c69 6e6b th . .<link │ │ │ -0021e160: 206c 696e 6b65 6e64 3d22 666e 5f78 656e linkend="fn_xen │ │ │ -0021e170: 635f 7065 6d5f 6578 706f 7274 223e 3c66 c_pem_export"><f │ │ │ -0021e180: 756e 6374 696f 6e3e 7865 6e63 5f70 656d unction>xenc_pem │ │ │ -0021e190: 5f65 7870 6f72 7428 636c 695f 6b65 795f _export(cli_key_ │ │ │ -0021e1a0: 6e61 6d65 293c 2f66 756e 6374 696f 6e3e name)</function> │ │ │ -0021e1b0: 3c2f 6c69 6e6b 3e2e 3c2f 7061 7261 3e0a </link>.</para>. │ │ │ -0021e1c0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -0021e1d0: 3c72 6566 7365 6374 3120 6964 3d22 7061 <refsect1 id="pa │ │ │ -0021e1e0: 7261 6d73 5f78 656e 635f 7835 3039 5f66 rams_xenc_x509_f │ │ │ -0021e1f0: 726f 6d5f 6373 7222 3e3c 7469 746c 653e rom_csr"><title> │ │ │ -0021e200: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -0021e210: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -0021e220: 3e0a 2020 2020 093c 7469 746c 653e 6361 >. .<title>ca │ │ │ -0021e230: 5f6b 6579 5f6e 616d 653c 2f74 6974 6c65 _key_name. Th │ │ │ -0021e250: 6520 6e61 6d65 206f 6620 4341 2070 7269 e name of CA pri │ │ │ -0021e260: 7661 7465 206b 6579 2077 6869 6368 2077 vate key which w │ │ │ -0021e270: 696c 6c20 6265 2075 7365 6420 746f 2073 ill be used to s │ │ │ -0021e280: 6967 6e20 6365 7274 6966 6963 6174 652e ign certificate. │ │ │ -0021e290: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . . cli_key_name │ │ │ -0021e2d0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0021e2e0: 7061 7261 3e54 6865 206e 616d 6520 6f66 para>The name of │ │ │ -0021e2f0: 2061 206b 6579 2077 6869 6368 2077 696c a key which wil │ │ │ -0021e300: 6c20 6265 2063 7265 6174 6564 2061 6e64 l be created and │ │ │ -0021e310: 2077 696c 6c20 636f 6e74 6169 6e73 2074 will contains t │ │ │ -0021e320: 6865 2063 6c69 656e 7420 6365 7274 6966 he client certif │ │ │ -0021e330: 6963 6174 652e 3c2f 7061 7261 3e0a 2020 icate.
    . │ │ │ -0021e340: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ -0021e350: 2020 3c72 6566 7365 6374 323e 0a20 2020 . │ │ │ -0021e360: 2009 3c74 6974 6c65 3e63 7372 5f73 7472 .csr_str │ │ │ -0021e370: 3c2f 7469 746c 653e 0a20 2009 2020 3c70 . .

    pem encoded │ │ │ -0021e390: 4353 522e 3c2f 7061 7261 3e0a 2020 2020 CSR.. │ │ │ -0021e3a0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -0021e3b0: 3c72 6566 7365 6374 323e 0a20 2020 2009 . . │ │ │ -0021e3c0: 3c74 6974 6c65 3e73 6572 6961 6c5f 6e6f serial_no │ │ │ -0021e3d0: 3c2f 7469 746c 653e 0a20 2009 2020 3c70 . .

    Serial numbe │ │ │ -0021e3f0: 722e 3c2f 7061 7261 3e0a 2020 2020 3c2f r.. . │ │ │ -0021e410: 2020 3c72 6566 7365 6374 323e 0a20 2020 . │ │ │ -0021e420: 2009 3c74 6974 6c65 3e64 6179 735f 7661 .days_va │ │ │ -0021e430: 6c69 6469 7479 3c2f 7469 746c 653e 0a20 lidity. │ │ │ -0021e440: 2009 2020 3c70 6172 613e 486f 7720 6d61 . How ma │ │ │ -0021e450: 6e79 2064 6179 7320 7769 6c6c 2062 6520 ny days will be │ │ │ -0021e460: 7661 6c69 6420 7468 6520 6365 7274 6966 valid the certif │ │ │ -0021e470: 6963 6174 652e 3c2f 7061 7261 3e0a 2020 icate.. │ │ │ -0021e480: 2020 3c2f 7265 6673 6563 7432 3e20 2020 │ │ │ -0021e490: 2020 2020 2020 200a 2020 2020 3c72 6566 . . .hours_validit │ │ │ -0021e4c0: 793c 2f74 6974 6c65 3e0a 2020 0920 203c y. . < │ │ │ -0021e4d0: 7061 7261 3e48 6f77 206d 616e 7920 686f para>How many ho │ │ │ -0021e4e0: 7572 7320 7769 6c6c 2062 6520 7661 6c69 urs will be vali │ │ │ -0021e4f0: 6420 7468 6520 6365 7274 6966 6963 6174 d the certificat │ │ │ -0021e500: 652e 3c2f 7061 7261 3e0a 2020 2020 3c2f e.. │ │ │ -0021e520: 2020 2020 2020 200a 2020 3c2f 7265 6673 . . Return Type │ │ │ -0021e570: 733c 2f74 6974 6c65 3e0a 2020 2020 2020 s. │ │ │ -0021e580: 3c70 6172 613e 7468 6520 6675 6e63 7469 the functi │ │ │ -0021e590: 6f6e 2072 6574 7572 6e73 2031 2075 706f on returns 1 upo │ │ │ -0021e5a0: 6e20 7375 6363 6573 732c 2073 716c 2065 n success, sql e │ │ │ -0021e5b0: 7272 6f72 206f 6e20 6661 696c 7572 652e rror on failure. │ │ │ -0021e5c0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . Errors</ │ │ │ -0021e610: 7469 746c 653e 0a20 2020 203c 7461 626c title>. <tabl │ │ │ -0021e620: 653e 3c74 6974 6c65 3e45 7272 6f72 7320 e><title>Errors │ │ │ -0021e630: 7369 676e 616c 6c65 6420 6279 203c 6675 signalled by <fu │ │ │ -0021e640: 6e63 7469 6f6e 3e78 656e 635f 7835 3039 nction>xenc_x509 │ │ │ -0021e650: 5f66 726f 6d5f 6373 723c 2f66 756e 6374 _from_csr</funct │ │ │ -0021e660: 696f 6e3e 3c2f 7469 746c 653e 0a20 2020 ion>. │ │ │ -0021e670: 2020 203c 7467 726f 7570 2063 6f6c 733d .

    . < │ │ │ -0021e6a0: 726f 773e 0a20 2020 2020 2020 2020 2020 row>. │ │ │ -0021e6b0: 203c 656e 7472 793e 5351 4c53 7461 7465 SQLState │ │ │ -0021e6c0: 3c2f 656e 7472 793e 0a20 2020 2020 2020 . │ │ │ -0021e6d0: 2020 2020 203c 656e 7472 793e 4572 726f Erro │ │ │ -0021e6e0: 7220 436f 6465 3c2f 656e 7472 793e 0a20 r Code. │ │ │ -0021e6f0: 2020 2020 2020 2020 2020 203c 656e 7472 Error Text. │ │ │ -0021e720: 203c 656e 7472 793e 4465 7363 7269 7074 Descript │ │ │ -0021e730: 696f 6e3c 2f65 6e74 7279 3e0a 2020 2020 ion. │ │ │ -0021e740: 2020 2020 2020 3c2f 726f 773e 0a20 2020 . │ │ │ -0021e750: 2020 2020 203c 2f74 6865 6164 3e0a 093c ..< │ │ │ -0021e760: 7462 6f64 793e 0a09 2020 3c72 6f77 3e0a tbody>.. . │ │ │ -0021e770: 0920 2020 203c 656e 7472 793e 3c65 7272 . 22023 │ │ │ -0021e7a0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. XECXX.. The key │ │ │ -0021e7f0: 205b 6e61 6d65 206f 6620 7468 6520 6b65 [name of the ke │ │ │ -0021e800: 795d 2061 6c72 6561 6479 2065 7869 7374 y] already exist │ │ │ -0021e810: 733c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 s.. .. .. .. │ │ │ -0021e850: 2020 203c 656e 7472 793e 3c65 7272 6f72 22023.. │ │ │ -0021e880: 2020 2020 3c65 6e74 7279 3e3c 6572 726f XECXX. │ │ │ -0021e8b0: 0920 2020 203c 656e 7472 793e 3c65 7272 . Missing o │ │ │ -0021e8d0: 7220 696e 7661 6c69 6420 7369 676e 6572 r invalid signer │ │ │ -0021e8e0: 2063 6572 7469 6669 6361 7465 3c2f 6572 certificate │ │ │ -0021e900: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ -0021e920: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ -0021e940: 3232 3032 333c 2f65 7272 6f72 636f 6465 22023.. < │ │ │ -0021e960: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>XECXX.. │ │ │ -0021e990: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Invalid certif │ │ │ -0021e9b0: 6963 6174 6520 7265 7175 6573 743c 2f65 icate request.. .. │ │ │ -0021e9f0: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ -0021ea00: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>22023.. │ │ │ -0021ea30: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 XECXX.. │ │ │ -0021ea60: 203c 656e 7472 793e 3c65 7272 6f72 6e61 Invalid certi │ │ │ -0021ea80: 6669 6361 7465 2072 6571 7565 7374 2070 ficate request p │ │ │ -0021ea90: 7562 6c69 6320 6b65 793c 2f65 7272 6f72 ublic key.. │ │ │ -0021eab0: 2020 203c 656e 7472 793e 3c2f 656e 7472 .. .. │ │ │ -0021ead0: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 .. 220 │ │ │ -0021eaf0: 3233 3c2f 6572 726f 7263 6f64 653e 3c2f 23.. XE │ │ │ -0021eb20: 4358 583c 2f65 7272 6f72 636f 6465 3e3c CXX< │ │ │ -0021eb30: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. S │ │ │ -0021eb50: 6967 6e61 7475 7265 2064 6964 206e 6f74 ignature did not │ │ │ -0021eb60: 206d 6174 6368 2074 6865 2063 6572 7469 match the certi │ │ │ -0021eb70: 6669 6361 7465 2072 6571 7565 7374 3c2f ficate request.. < │ │ │ -0021eba0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ -0021ebc0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 22023.. │ │ │ -0021ebf0: 203c 656e 7472 793e 3c65 7272 6f72 636f XECXX.. │ │ │ -0021ec20: 2020 3c65 6e74 7279 3e3c 6572 726f 726e Invalid cert │ │ │ -0021ec40: 6966 6963 6174 6520 7265 7175 6573 7420 ificate request │ │ │ -0021ec50: 7375 626a 6563 7420 6e61 6d65 3c2f 6572 subject name │ │ │ -0021ec70: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ -0021ec90: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ -0021ecb0: 3432 3030 303c 2f65 7272 6f72 636f 6465 42000.. < │ │ │ -0021ecd0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>XECXX.. │ │ │ -0021ed00: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Can not create │ │ │ -0021ed20: 2078 2e35 3039 2073 7472 7563 7475 7265 x.509 structure │ │ │ -0021ed30: 3c2f 6572 726f 726e 616d 653e 3c2f 656e .. .. .. .. │ │ │ -0021ed70: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 42000.. │ │ │ -0021eda0: 2020 203c 656e 7472 793e 3c65 7272 6f72 XECXX.. │ │ │ -0021edd0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f Can not si │ │ │ -0021edf0: 676e 2063 6572 7469 6669 6361 7465 3c2f gn certificate.. < │ │ │ -0021ee20: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ -0021ee40: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 42000.. │ │ │ -0021ee70: 203c 656e 7472 793e 3c65 7272 6f72 636f XECXX.. │ │ │ -0021eea0: 2020 3c65 6e74 7279 3e3c 6572 726f 726e The type of │ │ │ -0021eec0: 7075 626c 6963 206b 6579 2069 7320 6e6f public key is no │ │ │ -0021eed0: 7420 7375 7070 6f72 7465 6420 6d75 7320 t supported mus │ │ │ -0021eee0: 7462 6520 5253 4120 6f72 2044 5341 3c2f tbe RSA or DSA.. < │ │ │ -0021ef10: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ -0021ef30: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 42000.. │ │ │ -0021ef60: 203c 656e 7472 793e 3c65 7272 6f72 636f XECXX.. │ │ │ -0021ef90: 2020 3c65 6e74 7279 3e3c 6572 726f 726e Can not crea │ │ │ -0021efb0: 7465 2061 206b 6579 3c2f 6572 726f 726e te a key.. │ │ │ -0021efd0: 2020 3c65 6e74 7279 3e3c 2f65 6e74 7279 .. .. < │ │ │ -0021eff0: 726f 773e 0a09 2020 2020 3c65 6e74 7279 row>.. 4200 │ │ │ -0021f010: 303c 2f65 7272 6f72 636f 6465 3e3c 2f65 0.. XEC │ │ │ -0021f040: 5858 3c2f 6572 726f 7263 6f64 653e 3c2f XX.. Ca │ │ │ -0021f070: 6e20 6e6f 7420 7369 676e 2063 6572 7469 n not sign certi │ │ │ -0021f080: 6669 6361 7465 203a 205b 7468 6520 7369 ficate : [the si │ │ │ -0021f090: 676e 2065 7272 6f72 2074 6578 745d 3c2f gn error text].. < │ │ │ -0021f0c0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. . . . . ..< │ │ │ -0021f0e0: 2f74 626f 6479 3e0a 2020 2020 2020 3c2f /tbody>. . . . │ │ │ -0021f140: 3c74 6974 6c65 3e45 7861 6d70 6c65 3c2f Example</ │ │ │ -0021f150: 7469 746c 653e 0a20 2020 203c 6578 616d title>. <exam │ │ │ -0021f160: 706c 6520 6964 3d22 6578 5f78 656e 635f ple id="ex_xenc_ │ │ │ -0021f170: 7835 3039 5f66 726f 6d5f 6373 7222 3e0a x509_from_csr">. │ │ │ -0021f180: 2020 2020 093c 7061 7261 3e54 6865 2066 .<para>The f │ │ │ -0021f190: 6f6c 6c6f 7769 6e67 2065 7861 6d70 6c65 ollowing example │ │ │ -0021f1a0: 2064 656d 6f6e 7374 7261 7465 7320 686f demonstrates ho │ │ │ -0021f1b0: 7720 746f 2067 656e 6572 6174 6520 4365 w to generate Ce │ │ │ -0021f1c0: 7274 6966 6963 6174 6520 5369 676e 696e rtificate Signin │ │ │ -0021f1d0: 6720 5265 7175 6573 7420 2843 5352 292e g Request (CSR). │ │ │ -0021f1e0: 3c2f 7061 7261 3e0a 2020 2020 2020 3c69 </para>. <i │ │ │ -0021f1f0: 7465 6d69 7a65 646c 6973 7420 6d61 726b temizedlist mark │ │ │ -0021f200: 3d22 6275 6c6c 6574 223e 0a20 2020 2020 ="bullet">. │ │ │ -0021f210: 2020 203c 6c69 7374 6974 656d 3e3c 6c69 <listitem><li │ │ │ -0021f220: 6e6b 206c 696e 6b65 6e64 3d22 7666 6f61 nk linkend="vfoa │ │ │ -0021f230: 6673 736c 6361 636f 6e64 7422 3e55 7369 fsslcacondt">Usi │ │ │ -0021f240: 6e67 2043 6f6e 6475 6374 6f72 2c20 666f ng Conductor, fo │ │ │ -0021f250: 7220 7573 6572 2064 6261 2069 6d70 6f72 r user dba impor │ │ │ -0021f260: 7420 6120 6365 7274 6966 6963 6174 6520 t a certificate │ │ │ -0021f270: 7769 7468 2070 7269 6d61 7279 206b 6579 with primary key │ │ │ -0021f280: 2061 6e64 2077 6974 6820 6e61 6d65 2069 and with name i │ │ │ -0021f290: 645f 7273 612e 3c2f 6c69 6e6b 3e3c 2f6c d_rsa.</link></l │ │ │ -0021f2a0: 6973 7469 7465 6d3e 0a20 2020 2020 2020 istitem>. │ │ │ -0021f2b0: 203c 6c69 7374 6974 656d 3e45 7865 6375 <listitem>Execu │ │ │ -0021f2c0: 7465 3a3c 2f6c 6973 7469 7465 6d3e 0a20 te:</listitem>. │ │ │ -0021f2d0: 2020 2020 203c 2f69 7465 6d69 7a65 646c </itemizedl │ │ │ -0021f2e0: 6973 743e 090a 3c70 726f 6772 616d 6c69 ist>..<programli │ │ │ -0021f2f0: 7374 696e 673e 3c21 5b43 4441 5441 5b0a sting><![CDATA[. │ │ │ -0021f300: 5351 4c3e 6372 6561 7465 2070 726f 6365 SQL>create proce │ │ │ -0021f310: 6475 7265 2063 7372 5f64 656d 6f28 290a dure csr_demo(). │ │ │ -0021f320: 7b0a 6465 636c 6172 6520 6b6e 616d 652c {.declare kname, │ │ │ -0021f330: 2063 7661 6c75 6520 7661 7263 6861 723b cvalue varchar; │ │ │ -0021f340: 200a 6465 636c 6172 6520 5f6b 6579 2061 .declare _key a │ │ │ -0021f350: 6e79 3b0a 6465 636c 6172 6520 5f6f 7574 ny;.declare _out │ │ │ -0021f360: 7075 7420 696e 743b 0a0a 2020 2020 2020 put int;.. │ │ │ -0021f370: 2078 656e 635f 6b65 795f 5253 415f 6372 xenc_key_RSA_cr │ │ │ -0021f380: 6561 7465 2028 2752 5341 4b65 7931 272c eate ('RSAKey1', │ │ │ -0021f390: 2031 3032 3429 3b0a 2020 2020 2020 200a 1024);. . │ │ │ -0021f3a0: 2020 2020 5f6b 6579 203a 3d20 7865 6e63 _key := xenc │ │ │ -0021f3b0: 5f78 3530 395f 6373 725f 6765 6e65 7261 _x509_csr_genera │ │ │ -0021f3c0: 7465 2028 2752 5341 4b65 7931 272c 0a09 te ('RSAKey1',.. │ │ │ -0021f3d0: 0976 6563 746f 7220 280a 0909 0927 434e .vector (....'CN │ │ │ -0021f3e0: 272c 2027 4465 6d6f 2075 7365 7227 2c0a ', 'Demo user',. │ │ │ -0021f3f0: 0909 0927 4327 2c20 2027 5553 272c 0a09 ...'C', 'US',.. │ │ │ -0021f400: 0909 274f 272c 2020 274f 7065 6e4c 696e ..'O', 'OpenLin │ │ │ -0021f410: 6b27 2c0a 0909 0927 4f55 272c 2027 4163 k',....'OU', 'Ac │ │ │ -0021f420: 636f 756e 7473 272c 0a09 0909 2765 6d61 counts',....'ema │ │ │ -0021f430: 696c 4164 6472 6573 7327 2c20 2764 656d ilAddress', 'dem │ │ │ -0021f440: 6f40 6f70 656e 6c69 6e6b 7377 2e63 6f6d o@openlinksw.com │ │ │ -0021f450: 2729 2c20 0a09 0976 6563 746f 7220 2827 '), ...vector (' │ │ │ -0021f460: 7375 626a 6563 7441 6c74 4e61 6d65 272c subjectAltName', │ │ │ -0021f470: 2027 5552 493a 2068 7474 703a 2f2f 7777 'URI: http://ww │ │ │ -0021f480: 772e 6f70 656e 6c69 6e6b 7377 2e63 6f6d w.openlinksw.com │ │ │ -0021f490: 2f64 6174 6173 7061 6365 2f70 6572 736f /dataspace/perso │ │ │ -0021f4a0: 6e2f 6465 6d6f 2374 6869 7327 2c20 276e n/demo#this', 'n │ │ │ -0021f4b0: 7343 6f6d 6d65 6e74 272c 2027 5669 7274 sComment', 'Virt │ │ │ -0021f4c0: 756f 736f 2047 656e 6572 6174 6564 2043 uoso Generated C │ │ │ -0021f4d0: 6572 7469 6669 6361 7465 272c 200a 0909 ertificate', ... │ │ │ -0021f4e0: 0927 6175 7468 6f72 6974 794b 6579 4964 .'authorityKeyId │ │ │ -0021f4f0: 656e 7469 6669 6572 272c 2027 6b65 7969 entifier', 'keyi │ │ │ -0021f500: 642c 6973 7375 6572 3a61 6c77 6179 7327 d,issuer:always' │ │ │ -0021f510: 2929 3b0a 0909 090a 0909 090a 2020 2078 ));......... x │ │ │ -0021f520: 656e 635f 7835 3039 5f66 726f 6d5f 6373 enc_x509_from_cs │ │ │ -0021f530: 7220 2827 6964 5f72 7361 272c 2027 4d79 r ('id_rsa', 'My │ │ │ -0021f540: 4b65 7931 272c 205f 6b65 7920 2c20 7365 Key1', _key , se │ │ │ -0021f550: 7175 656e 6365 5f6e 6578 7420 2827 6361 quence_next ('ca │ │ │ -0021f560: 5f69 645f 7273 6127 292c 2033 3635 2c20 _id_rsa'), 365, │ │ │ -0021f570: 3130 3029 3b0a 2020 2072 6574 7572 6e20 100);. return │ │ │ -0021f580: 7865 6e63 5f70 656d 5f65 7870 6f72 7420 xenc_pem_export │ │ │ -0021f590: 2827 4d79 4b65 7931 2729 3b0a 0a7d 0a3b ('MyKey1');..}.; │ │ │ -0021f5a0: 0a0a 446f 6e65 2e20 2d2d 2030 206d 7365 ..Done. -- 0 mse │ │ │ -0021f5b0: 632e 0a0a 5351 4c3e 2073 656c 6563 7420 c...SQL> select │ │ │ -0021f5c0: 6373 725f 6465 6d6f 2829 3b0a 7465 6d70 csr_demo();.temp │ │ │ -0021f5d0: 320a 5641 5243 4841 520a 5f5f 5f5f 5f5f 2.VARCHAR.______ │ │ │ -0021f5e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0021f5f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0021f600: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0021f610: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0021f620: 5f5f 5f5f 5f5f 5f5f 5f0a 0a2d 2d2d 2d2d _________..----- │ │ │ -0021f630: 4245 4749 4e20 4345 5254 4946 4943 4154 BEGIN CERTIFICAT │ │ │ -0021f640: 452d 2d2d 2d2d 0a4d 4949 4453 6a43 4341 E-----.MIIDSjCCA │ │ │ -0021f650: 6a4b 6741 7749 4241 6749 4245 7a41 4e42 jKgAwIBAgIBEzANB │ │ │ -0021f660: 676b 7168 6b69 4739 7730 4241 5151 4641 gkqhkiG9w0BAQQFA │ │ │ -0021f670: 4442 564d 5173 7743 5159 4456 5151 4945 DBVMQswCQYDVQQIE │ │ │ -0021f680: 774a 7662 4445 4c0a 4d41 6b47 4131 5545 wJvbDEL.MAkGA1UE │ │ │ -0021f690: 4368 4d43 6232 7778 437a 414a 4267 4e56 ChMCb2wxCzAJBgNV │ │ │ -0021f6a0: 4241 7354 416d 3973 4d51 3077 4377 5944 BAsTAm9sMQ0wCwYD │ │ │ -0021f6b0: 5651 5144 4577 5271 6232 6875 4d52 3077 VQQDEwRqb2huMR0w │ │ │ -0021f6c0: 4777 594a 4b6f 5a49 0a68 7663 4e41 516b GwYJKoZI.hvcNAQk │ │ │ -0021f6d0: 4246 6735 7162 3268 7551 4764 7459 576c BFg5qb2huQGdtYWl │ │ │ -0021f6e0: 734c 6d4e 7662 5441 6546 7730 784d 5441 sLmNvbTAeFw0xMTA │ │ │ -0021f6f0: 324d 4463 784e 5441 784e 4468 6146 7730 2MDcxNTAxNDhaFw0 │ │ │ -0021f700: 784d 6a41 324d 5441 780a 4f54 4178 4e44 xMjA2MTAx.OTAxND │ │ │ -0021f710: 6861 4d47 7378 456a 4151 4267 4e56 4241 haMGsxEjAQBgNVBA │ │ │ -0021f720: 4d54 4355 526c 6257 3867 6458 4e6c 636a MTCURlbW8gdXNlcj │ │ │ -0021f730: 454c 4d41 6b47 4131 5545 4268 4d43 5656 ELMAkGA1UEBhMCVV │ │ │ -0021f740: 4d78 4554 4150 4267 4e56 0a42 416f 5443 MxETAPBgNV.BAoTC │ │ │ -0021f750: 4539 775a 5735 4d61 5735 724d 5245 7744 E9wZW5MaW5rMREwD │ │ │ -0021f760: 7759 4456 5151 4c45 7768 4259 324e 7664 wYDVQQLEwhBY2Nvd │ │ │ -0021f770: 5735 3063 7a45 694d 4341 4743 5371 4753 W50czEiMCAGCSqGS │ │ │ -0021f780: 4962 3344 5145 4a41 5259 540a 5a47 5674 Ib3DQEJARYT.ZGVt │ │ │ -0021f790: 6230 4276 6347 5675 6247 6c75 6133 4e33 b0BvcGVubGlua3N3 │ │ │ -0021f7a0: 4c6d 4e76 6254 4342 6e7a 414e 4267 6b71 LmNvbTCBnzANBgkq │ │ │ -0021f7b0: 686b 6947 3977 3042 4151 4546 4141 4f42 hkiG9w0BAQEFAAOB │ │ │ -0021f7c0: 6a51 4177 6759 6b43 6759 4541 0a33 4d61 jQAwgYkCgYEA.3Ma │ │ │ -0021f7d0: 2f4d 6c4d 7247 7275 7770 4473 5732 4433 /MlMrGruwpDsW2D3 │ │ │ -0021f7e0: 6959 4136 7371 4671 6c64 5073 6778 3833 iYA6sqFqldPsgx83 │ │ │ -0021f7f0: 3764 4e4a 656c 385a 5175 352f 304e 7972 7dNJel8ZQu5/0Nyr │ │ │ -0021f800: 3544 4374 4151 4e71 366e 575a 6f0a 3062 5DCtAQNq6nWZo.0b │ │ │ -0021f810: 657a 4b39 5549 6641 5845 5158 5774 3453 ezK9UIfAXEQXWt4S │ │ │ -0021f820: 3749 4d50 6654 4636 6f43 5438 3559 4473 7IMPfTF6oCT85YDs │ │ │ -0021f830: 5145 4545 2f6f 3173 7073 5a39 5137 6b58 QEEE/o1spsZ9Q7kX │ │ │ -0021f840: 684b 7533 5233 4c4e 4e69 5478 5972 0a54 hKu3R3LNNiTxYr.T │ │ │ -0021f850: 5234 4653 6c33 3631 7055 7179 596e 6753 R4FSl361pUqyYngS │ │ │ -0021f860: 4d54 7856 574a 784b 6e50 5733 3070 3934 MTxVWJxKnPW30p94 │ │ │ -0021f870: 6935 5175 516a 4c46 3173 4341 7745 4141 i5QuQjLF1sCAwEAA │ │ │ -0021f880: 614f 426b 6a43 426a 7a41 6442 674e 560a aOBkjCBjzAdBgNV. │ │ │ -0021f890: 4851 3445 4667 5155 4635 7754 5358 4839 HQ4EFgQUF5wTSXH9 │ │ │ -0021f8a0: 3849 7169 6161 7866 5654 4e63 7569 3870 8IqiaaxfVTNcui8p │ │ │ -0021f8b0: 3853 6f77 5077 5944 5652 3052 4244 6777 8SowPwYDVR0RBDgw │ │ │ -0021f8c0: 4e6f 5930 6148 5230 6344 6f76 4c33 6433 NoY0aHR0cDovL3d3 │ │ │ -0021f8d0: 0a64 7935 7663 4756 7562 476c 7561 334e .dy5vcGVubGlua3N │ │ │ -0021f8e0: 334c 6d4e 7662 5339 6b59 5852 6863 3342 3LmNvbS9kYXRhc3B │ │ │ -0021f8f0: 6859 3255 7663 4756 7963 3239 754c 3252 hY2UvcGVyc29uL2R │ │ │ -0021f900: 6c62 5738 6a64 4768 7063 7a41 7442 676c lbW8jdGhpczAtBgl │ │ │ -0021f910: 670a 686b 6742 6876 6843 4151 3045 4942 g.hkgBhvhCAQ0EIB │ │ │ -0021f920: 5965 566d 6c79 6448 5676 6332 3867 5232 YeVmlydHVvc28gR2 │ │ │ -0021f930: 5675 5a58 4a68 6447 566b 4945 4e6c 636e VuZXJhdGVkIENlcn │ │ │ -0021f940: 5270 5a6d 6c6a 5958 526c 4d41 3047 4353 RpZmljYXRlMA0GCS │ │ │ -0021f950: 7147 0a53 4962 3344 5145 4242 4155 4141 qG.SIb3DQEBBAUAA │ │ │ -0021f960: 3449 4241 5143 7753 4e33 7936 7965 434e 4IBAQCwSN3y6yeCN │ │ │ -0021f970: 652b 2f69 7a6f 3547 774d 2b31 3663 6a6d e+/izo5GwM+16cjm │ │ │ -0021f980: 5a6b 794d 5559 6d41 4f36 3249 3654 3632 ZkyMUYmAO62I6T62 │ │ │ -0021f990: 6a6d 490a 7030 6e59 6156 684a 3957 5630 jmI.p0nYaVhJ9WV0 │ │ │ -0021f9a0: 6e74 566e 7831 4838 2f4c 4b77 7267 794c ntVnx1H8/LKwrgyL │ │ │ -0021f9b0: 6c68 5861 6356 7734 6a79 5877 464d 536f lhXacVw4jyXwFMSo │ │ │ -0021f9c0: 2b59 754f 4e6a 2b6b 4b70 6f62 4e48 3263 +YuONj+kKpobNH2c │ │ │ -0021f9d0: 6c2b 7531 0a2b 6330 6b4a 4762 592f 6553 l+u1.+c0kJGbY/eS │ │ │ -0021f9e0: 3939 5332 4433 4a68 4c36 6e2b 5175 6b76 99S2D3JhL6n+Qukv │ │ │ -0021f9f0: 5149 7168 596e 695a 3231 7754 3175 6777 QIqhYniZ21wT1ugw │ │ │ -0021fa00: 704e 3241 374e 7459 2b67 3932 352b 7651 pN2A7NtY+g925+vQ │ │ │ -0021fa10: 424f 3055 480a 3077 516d 3365 516b 384e BO0UH.0wQm3eQk8N │ │ │ -0021fa20: 4144 456a 6371 726d 476d 4a63 724b 3232 ADEjcqrmGmJcrK22 │ │ │ -0021fa30: 6a66 6142 4e6f 762b 4f32 7776 635a 514d jfaBNov+O2wvcZQM │ │ │ -0021fa40: 3757 494b 6d39 3866 2f37 536f 376b 424e 7WIKm98f/7So7kBN │ │ │ -0021fa50: 3042 6f52 5838 0a37 4c52 6633 7a49 6870 0BoRX8.7LRf3zIhp │ │ │ -0021fa60: 3466 3966 6b31 5144 776c 6d39 4e67 7767 4f9fk1QDwlm9Ngwg │ │ │ -0021fa70: 7841 5271 4e4f 6652 754a 5532 5955 3149 xARqNOfRuJU2YU1I │ │ │ -0021fa80: 437a 3838 4c62 774d 3458 4465 622b 4d64 Cz88LbwM4XDeb+Md │ │ │ -0021fa90: 7230 594d 4e64 550a 3665 596b 4342 3476 r0YMNdU.6eYkCB4v │ │ │ -0021faa0: 4b73 5648 2b73 3145 386d 3637 515a 3854 KsVH+s1E8m67QZ8T │ │ │ -0021fab0: 4778 704e 5a4c 5958 4c5a 5a42 6474 3836 GxpNZLYXLZZBdt86 │ │ │ -0021fac0: 0a2d 2d2d 2d2d 454e 4420 4345 5254 4946 .-----END CERTIF │ │ │ -0021fad0: 4943 4154 452d 2d2d 2d2d 0a0a 0a31 2052 ICATE-----...1 R │ │ │ -0021fae0: 6f77 732e 202d 2d20 3137 3220 6d73 6563 ows. -- 172 msec │ │ │ -0021faf0: 2e0a 0a5d 5d3e 3c2f 7072 6f67 7261 6d6c ...]]></programl │ │ │ -0021fb00: 6973 7469 6e67 3e0a 2020 2020 3c2f 6578 isting>. </ex │ │ │ -0021fb10: 616d 706c 653e 0a20 203c 2f72 6566 7365 ample>. </refse │ │ │ -0021fb20: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ -0021fb30: 2069 643d 2273 6565 616c 736f 5f78 656e id="seealso_xen │ │ │ -0021fb40: 635f 7835 3039 5f66 726f 6d5f 6373 7222 c_x509_from_csr" │ │ │ -0021fb50: 3e3c 7469 746c 653e 5365 6520 416c 736f ><title>See Also │ │ │ -0021fb60: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . get_c │ │ │ -0021fba0: 6572 7469 6669 6361 7465 5f69 6e66 6f28 ertificate_info( │ │ │ -0021fbb0: 293c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ). │ │ │ -0021fbc0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xenc_x509_cs │ │ │ -0021fc00: 725f 6765 6e65 7261 7465 2829 3c2f 6c69 r_generate(). < │ │ │ -0021fc20: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_ │ │ │ -0021fc50: 7835 3039 5f67 656e 6572 6174 6528 293c x509_generate()< │ │ │ -0021fc60: 2f6c 696e 6b3e 3c2f 7061 7261 3e20 2020 /link> │ │ │ -0021fc70: 200a 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ -0021fc80: 2f72 6566 656e 7472 793e 0a0a b600 0000 /refentry>...... │ │ │ -0021fc90: 2e64 656d 6f2f 646f 6373 7263 2f66 756e .demo/docsrc/fun │ │ │ -0021fca0: 6372 6566 2f78 656e 635f 7835 3039 5f63 cref/xenc_x509_c │ │ │ -0021fcb0: 7372 5f67 656e 6572 6174 652e 786d 6cdf sr_generate.xml. │ │ │ -0021fcc0: 0000 1c08 3c3f 786d 6c20 7665 7273 696f ..... │ │ │ -0021fcf0: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 │ │ │ -00220050: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . xenc_x │ │ │ -002200a0: 3530 395f 6373 725f 6765 6e65 7261 7465 509_csr_generate │ │ │ -002200b0: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ -002200c0: 0a20 2020 203c 7265 666d 6973 6369 6e66 . hash. . │ │ │ -00220100: 0a20 2020 203c 7265 666e 616d 653e 7865 . xe │ │ │ -00220110: 6e63 5f78 3530 395f 6373 725f 6765 6e65 nc_x509_csr_gene │ │ │ -00220120: 7261 7465 3c2f 7265 666e 616d 653e 0a20 rate. │ │ │ -00220130: 2020 203c 7265 6670 7572 706f 7365 3e47 G │ │ │ -00220140: 656e 6572 6174 6520 4365 7274 6966 6963 enerate Certific │ │ │ -00220150: 6174 6520 5369 676e 696e 6720 5265 7175 ate Signing Requ │ │ │ -00220160: 6573 7420 2843 5352 293c 2f72 6566 7075 est (CSR). . . . │ │ │ -002201d0: 2020 2020 3c66 756e 6370 726f 746f 7479 . < │ │ │ -00220210: 6675 6e63 6465 663e 7661 7263 6861 7220 funcdef>varchar │ │ │ -00220220: 3c66 756e 6374 696f 6e3e 7865 6e63 5f78 xenc_x │ │ │ -00220230: 3530 395f 6373 725f 6765 6e65 7261 7465 509_csr_generate │ │ │ -00220240: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e .. < │ │ │ -00220260: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in cli_pk_na │ │ │ -00220280: 6d65 3c2f 7061 7261 6d65 7465 723e 2076 me v │ │ │ -00220290: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. in subject array

    . │ │ │ -002202f0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -00220300: 3c70 6172 616d 6574 6572 3e65 7874 656e exten │ │ │ -00220310: 7369 6f6e 733c 2f70 6172 616d 6574 6572 sions array. .
    . < │ │ │ -00220360: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -00220370: 0a20 203c 7265 6673 6563 7431 2069 643d . Description │ │ │ -002203b0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -002203c0: 7061 7261 3e54 6869 7320 6675 6e63 7469 para>This functi │ │ │ -002203d0: 6f6e 2067 656e 6572 6174 6573 2043 6572 on generates Cer │ │ │ -002203e0: 7469 6669 6361 7465 2053 6967 6e69 6e67 tificate Signing │ │ │ -002203f0: 2052 6571 7565 7374 2028 4353 5229 3c2f Request (CSR). . Parame │ │ │ -00220450: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -00220460: 203c 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00220470: 093c 7469 746c 653e 636c 695f 706b 5f6e .cli_pk_n │ │ │ -00220480: 616d 653c 2f74 6974 6c65 3e0a 2020 2020 ame. │ │ │ -00220490: 2020 3c70 6172 613e 5468 6520 7573 6572 The user │ │ │ -002204a0: 2773 2070 7269 7661 7465 206b 6579 206e 's private key n │ │ │ -002204b0: 616d 652e 3c2f 7061 7261 3e0a 2020 2020 ame.. │ │ │ -002204c0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -002204d0: 3c72 6566 7365 6374 323e 0a20 2020 2020 . │ │ │ -002204e0: 203c 7469 746c 653e 7375 626a 6563 743c subject< │ │ │ -002204f0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -00220500: 6172 613e 416e 2061 7272 6179 206f 6620 ara>An array of │ │ │ -00220510: 6e61 6d65 2f76 616c 7565 2070 6169 7273 name/value pairs │ │ │ -00220520: 2072 6570 7265 7365 6e74 696e 6720 7468 representing th │ │ │ -00220530: 6520 7375 626a 6563 7420 616b 6120 6e61 e subject aka na │ │ │ -00220540: 6d65 2065 6e74 6965 732c 2066 6f72 2065 me enties, for e │ │ │ -00220550: 783a 3c2f 7061 7261 3e0a 3c70 726f 6772 x:</para>.<progr │ │ │ -00220560: 616d 6c69 7374 696e 673e 3c21 5b43 4441 amlisting><![CDA │ │ │ -00220570: 5441 5b0a 2827 434e 272c 2027 4465 6d6f TA[.('CN', 'Demo │ │ │ -00220580: 2055 7365 7227 2c20 2743 272c 2027 5553 User', 'C', 'US │ │ │ -00220590: 2729 090a 5d5d 3e3c 2f70 726f 6772 616d ')..]]></program │ │ │ -002205a0: 6c69 7374 696e 673e 2020 2020 2020 0a20 listing> . │ │ │ -002205b0: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ -002205c0: 2020 203c 7265 6673 6563 7432 3e0a 2020 <refsect2>. │ │ │ -002205d0: 2020 093c 7469 746c 653e 6578 7465 6e73 .<title>extens │ │ │ -002205e0: 696f 6e73 3c2f 7469 746c 653e 0a20 2009 ions. . │ │ │ -002205f0: 2020 3c70 6172 613e 416e 2061 7272 6179 An array │ │ │ -00220600: 206f 6620 6e61 6d65 2f76 616c 7565 2070 of name/value p │ │ │ -00220610: 6169 7273 2074 6f20 6164 6420 6173 2058 airs to add as X │ │ │ -00220620: 2e35 3039 7633 2065 7874 656e 7369 6f6e .509v3 extension │ │ │ -00220630: 7320 746f 2063 6572 7469 6669 6361 7465 s to certificate │ │ │ -00220640: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . Return │ │ │ -002206a0: 2054 7970 6573 3c2f 7469 746c 653e 0a20 Types. │ │ │ -002206b0: 2020 2020 203c 7061 7261 3e53 7472 696e Strin │ │ │ -002206c0: 673c 2f70 6172 613e 0a20 203c 2f72 6566 g. . Err │ │ │ -00220710: 6f72 733c 2f74 6974 6c65 3e0a 2020 2020 ors. │ │ │ -00220720: 3c74 6162 6c65 3e3c 7469 746c 653e 4572 Er │ │ │ -00220730: 726f 7273 2073 6967 6e61 6c6c 6564 2062 rors signalled b │ │ │ -00220740: 7920 3c66 756e 6374 696f 6e3e 7865 6e63 y <function>xenc │ │ │ -00220750: 5f78 3530 395f 6373 725f 6765 6e65 7261 _x509_csr_genera │ │ │ -00220760: 7465 3c2f 6675 6e63 7469 6f6e 3e3c 2f74 te</function></t │ │ │ -00220770: 6974 6c65 3e0a 2020 2020 2020 3c74 6772 itle>. <tgr │ │ │ -00220780: 6f75 7020 636f 6c73 3d22 3422 3e0a 2020 oup cols="4">. │ │ │ -00220790: 2020 2020 2020 3c74 6865 6164 3e0a 2020 <thead>. │ │ │ -002207a0: 2020 2020 2020 2020 3c72 6f77 3e0a 2020 <row>. │ │ │ -002207b0: 2020 2020 2020 2020 2020 3c65 6e74 7279 <entry │ │ │ -002207c0: 3e53 514c 5374 6174 653c 2f65 6e74 7279 >SQLState</entry │ │ │ -002207d0: 3e0a 2020 2020 2020 2020 2020 2020 3c65 >. <e │ │ │ -002207e0: 6e74 7279 3e45 7272 6f72 2043 6f64 653c ntry>Error Code< │ │ │ -002207f0: 2f65 6e74 7279 3e0a 2020 2020 2020 2020 /entry>. │ │ │ -00220800: 2020 2020 3c65 6e74 7279 3e45 7272 6f72 <entry>Error │ │ │ -00220810: 2054 6578 743c 2f65 6e74 7279 3e0a 2020 Text</entry>. │ │ │ -00220820: 2020 2020 2020 2020 2020 3c65 6e74 7279 <entry │ │ │ -00220830: 3e44 6573 6372 6970 7469 6f6e 3c2f 656e >Description</en │ │ │ -00220840: 7472 793e 0a20 2020 2020 2020 2020 203c try>. < │ │ │ -00220850: 2f72 6f77 3e0a 2020 2020 2020 2020 3c2f /row>. </ │ │ │ -00220860: 7468 6561 643e 0a09 3c74 626f 6479 3e0a thead>..<tbody>. │ │ │ -00220870: 0920 203c 726f 773e 0a09 2020 2020 3c65 . <row>.. <e │ │ │ -00220880: 6e74 7279 3e3c 6572 726f 7263 6f64 653e ntry><errorcode> │ │ │ -00220890: 3232 3032 333c 2f65 7272 6f72 636f 6465 22023</errorcode │ │ │ -002208a0: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ -002208b0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ -002208c0: 3e58 4543 5858 3c2f 6572 726f 7263 6f64 >XECXX</errorcod │ │ │ -002208d0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ -002208e0: 3c65 6e74 7279 3e3c 6572 726f 726e 616d <entry><errornam │ │ │ -002208f0: 653e 4d69 7373 696e 6720 6b65 793c 2f65 e>Missing key</e │ │ │ -00220900: 7272 6f72 6e61 6d65 3e3c 2f65 6e74 7279 rrorname></entry │ │ │ -00220910: 3e0a 0920 2020 203c 656e 7472 793e 3c2f >.. <entry></ │ │ │ -00220920: 656e 7472 793e 0a09 2020 3c2f 726f 773e entry>.. </row> │ │ │ -00220930: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. <row>.. < │ │ │ -00220940: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ -00220950: 3e32 3230 3233 3c2f 6572 726f 7263 6f64 >22023</errorcod │ │ │ -00220960: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ -00220970: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 <entry><errorcod │ │ │ -00220980: 653e 5845 4358 583c 2f65 7272 6f72 636f e>XECXX</errorco │ │ │ -00220990: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ -002209a0: 203c 656e 7472 793e 3c65 7272 6f72 6e61 <entry><errorna │ │ │ -002209b0: 6d65 3e4b 6579 2069 7320 6e6f 7420 4453 me>Key is not DS │ │ │ -002209c0: 4120 6e6f 7220 5253 413c 2f65 7272 6f72 A nor RSA</error │ │ │ -002209d0: 6e61 6d65 3e3c 2f65 6e74 7279 3e0a 0920 name></entry>.. │ │ │ -002209e0: 2020 203c 656e 7472 793e 3c2f 656e 7472 <entry></entr │ │ │ -002209f0: 793e 0a09 2020 3c2f 726f 773e 0a09 2020 y>.. </row>.. │ │ │ -00220a00: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 <row>.. <entr │ │ │ -00220a10: 793e 3c65 7272 6f72 636f 6465 3e32 3230 y><errorcode>220 │ │ │ -00220a20: 3233 3c2f 6572 726f 7263 6f64 653e 3c2f 23</errorcode></ │ │ │ -00220a30: 656e 7472 793e 0a09 2020 2020 3c65 6e74 entry>.. <ent │ │ │ -00220a40: 7279 3e3c 6572 726f 7263 6f64 653e 5845 ry><errorcode>XE │ │ │ -00220a50: 4358 583c 2f65 7272 6f72 636f 6465 3e3c CXX</errorcode>< │ │ │ -00220a60: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ -00220a70: 7472 793e 3c65 7272 6f72 6e61 6d65 3e4d try><errorname>M │ │ │ -00220a80: 6973 7369 6e67 2070 7269 7661 7465 206b issing private k │ │ │ -00220a90: 6579 3c2f 6572 726f 726e 616d 653e 3c2f ey</errorname></ │ │ │ -00220aa0: 656e 7472 793e 0a09 2020 2020 3c65 6e74 entry>.. <ent │ │ │ -00220ab0: 7279 3e3c 2f65 6e74 7279 3e0a 0920 203c ry></entry>.. < │ │ │ -00220ac0: 2f72 6f77 3e0a 0920 203c 726f 773e 0a09 /row>.. <row>.. │ │ │ -00220ad0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ -00220ae0: 7263 6f64 653e 3232 3032 333c 2f65 7272 rcode>22023</err │ │ │ -00220af0: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ -00220b00: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ -00220b10: 6f72 636f 6465 3e58 4543 5858 3c2f 6572 orcode>XECXX</er │ │ │ -00220b20: 726f 7263 6f64 653e 3c2f 656e 7472 793e rorcode></entry> │ │ │ -00220b30: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -00220b40: 726f 726e 616d 653e 5375 626a 6563 7420 rorname>Subject │ │ │ -00220b50: 6172 7261 7920 6d75 7374 2062 6520 6e61 array must be na │ │ │ -00220b60: 6d65 2f76 616c 7565 2070 6169 7273 3c2f me/value pairs</ │ │ │ -00220b70: 6572 726f 726e 616d 653e 3c2f 656e 7472 errorname></entr │ │ │ -00220b80: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -00220b90: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. </row │ │ │ -00220ba0: 3e0a 0920 203c 726f 773e 0a09 2020 2020 >.. <row>.. │ │ │ -00220bb0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 <entry><errorcod │ │ │ -00220bc0: 653e 3232 3032 333c 2f65 7272 6f72 636f e>22023</errorco │ │ │ -00220bd0: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ -00220be0: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ -00220bf0: 6465 3e58 4543 5858 3c2f 6572 726f 7263 de>XECXX</errorc │ │ │ -00220c00: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ -00220c10: 2020 3c65 6e74 7279 3e3c 6572 726f 726e <entry><errorn │ │ │ -00220c20: 616d 653e 4578 7465 6e73 696f 6e20 6172 ame>Extension ar │ │ │ -00220c30: 7261 7920 6d75 7374 2062 6520 6e61 6d65 ray must be name │ │ │ -00220c40: 2f76 616c 7565 2070 6169 7273 3c2f 6572 /value pairs</er │ │ │ -00220c50: 726f 726e 616d 653e 3c2f 656e 7472 793e rorname></entry> │ │ │ -00220c60: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. <entry></e │ │ │ -00220c70: 6e74 7279 3e0a 0920 203c 2f72 6f77 3e0a ntry>.. </row>. │ │ │ -00220c80: 0920 203c 726f 773e 0a09 2020 2020 3c65 . <row>.. <e │ │ │ -00220c90: 6e74 7279 3e3c 6572 726f 7263 6f64 653e ntry><errorcode> │ │ │ -00220ca0: 3432 3030 303c 2f65 7272 6f72 636f 6465 42000</errorcode │ │ │ -00220cb0: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ -00220cc0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ -00220cd0: 3e58 4543 5858 3c2f 6572 726f 7263 6f64 >XECXX</errorcod │ │ │ -00220ce0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ -00220cf0: 3c65 6e74 7279 3e3c 6572 726f 726e 616d <entry><errornam │ │ │ -00220d00: 653e 4361 6e20 6e6f 7420 6372 6561 7465 e>Can not create │ │ │ -00220d10: 2070 6b65 793c 2f65 7272 6f72 6e61 6d65 pkey</errorname │ │ │ -00220d20: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ -00220d30: 656e 7472 793e 3c2f 656e 7472 793e 0a09 entry></entry>.. │ │ │ -00220d40: 2020 3c2f 726f 773e 0a09 2020 3c72 6f77 </row>.. <row │ │ │ -00220d50: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ -00220d60: 7272 6f72 636f 6465 3e34 3230 3030 3c2f rrorcode>42000</ │ │ │ -00220d70: 6572 726f 7263 6f64 653e 3c2f 656e 7472 errorcode></entr │ │ │ -00220d80: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -00220d90: 6572 726f 7263 6f64 653e 5845 4358 583c errorcode>XECXX< │ │ │ -00220da0: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode></ent │ │ │ -00220db0: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ -00220dc0: 3c65 7272 6f72 6e61 6d65 3e43 616e 206e <errorname>Can n │ │ │ -00220dd0: 6f74 2061 7373 6967 6e20 7072 696d 6172 ot assign primar │ │ │ -00220de0: 7920 6b65 793c 2f65 7272 6f72 6e61 6d65 y key</errorname │ │ │ -00220df0: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ -00220e00: 656e 7472 793e 3c2f 656e 7472 793e 0a09 entry></entry>.. │ │ │ -00220e10: 2020 3c2f 726f 773e 0a09 2020 3c72 6f77 </row>.. <row │ │ │ -00220e20: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ -00220e30: 7272 6f72 636f 6465 3e34 3230 3030 3c2f rrorcode>42000</ │ │ │ -00220e40: 6572 726f 7263 6f64 653e 3c2f 656e 7472 errorcode></entr │ │ │ -00220e50: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -00220e60: 6572 726f 7263 6f64 653e 5845 4358 583c errorcode>XECXX< │ │ │ -00220e70: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode></ent │ │ │ -00220e80: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ -00220e90: 3c65 7272 6f72 6e61 6d65 3e43 616e 206e <errorname>Can n │ │ │ -00220ea0: 6f74 2063 7265 6174 6520 706b 6579 3c2f ot create pkey</ │ │ │ -00220eb0: 6572 726f 726e 616d 653e 3c2f 656e 7472 errorname></entr │ │ │ -00220ec0: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ -00220ed0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. </row │ │ │ -00220ee0: 3e0a 0920 203c 726f 773e 0a09 2020 2020 >.. <row>.. │ │ │ -00220ef0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 <entry><errorcod │ │ │ -00220f00: 653e 3432 3030 303c 2f65 7272 6f72 636f e>42000</errorco │ │ │ -00220f10: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ -00220f20: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ -00220f30: 6465 3e58 4543 5858 3c2f 6572 726f 7263 de>XECXX</errorc │ │ │ -00220f40: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ -00220f50: 2020 3c65 6e74 7279 3e3c 6572 726f 726e <entry><errorn │ │ │ -00220f60: 616d 653e 4361 6e20 6e6f 7420 6372 6561 ame>Can not crea │ │ │ -00220f70: 7465 2078 2e35 3039 2073 7472 7563 7475 te x.509 structu │ │ │ -00220f80: 7265 3c2f 6572 726f 726e 616d 653e 3c2f re</errorname></ │ │ │ -00220f90: 656e 7472 793e 0a09 2020 2020 3c65 6e74 entry>.. <ent │ │ │ -00220fa0: 7279 3e3c 2f65 6e74 7279 3e0a 0920 203c ry></entry>.. < │ │ │ -00220fb0: 2f72 6f77 3e0a 0920 203c 726f 773e 0a09 /row>.. <row>.. │ │ │ -00220fc0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ -00220fd0: 7263 6f64 653e 3432 3030 303c 2f65 7272 rcode>42000</err │ │ │ -00220fe0: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ -00220ff0: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ -00221000: 6f72 636f 6465 3e58 4543 5858 3c2f 6572 orcode>XECXX</er │ │ │ -00221010: 726f 7263 6f64 653e 3c2f 656e 7472 793e rorcode></entry> │ │ │ -00221020: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. <entry><er │ │ │ -00221030: 726f 726e 616d 653e 4361 6e20 6e6f 7420 rorname>Can not │ │ │ -00221040: 7369 676e 2063 6572 7469 6669 6361 7465 sign certificate │ │ │ -00221050: 203a 205b 7468 6520 7369 676e 2065 7272 : [the sign err │ │ │ -00221060: 6f72 2074 6578 745d 3c2f 6572 726f 726e or text]</errorn │ │ │ -00221070: 616d 653e 3c2f 656e 7472 793e 0a09 2020 ame></entry>.. │ │ │ -00221080: 2020 3c65 6e74 7279 3e3c 2f65 6e74 7279 <entry></entry │ │ │ -00221090: 3e0a 0920 203c 2f72 6f77 3e09 2020 0920 >.. </row>. . │ │ │ -002210a0: 2009 2020 0920 200a 093c 2f74 626f 6479 . . ..</tbody │ │ │ -002210b0: 3e0a 2020 2020 2020 3c2f 7467 726f 7570 >. </tgroup │ │ │ -002210c0: 3e0a 2020 2020 3c2f 7461 626c 653e 0a20 >. </table>. │ │ │ -002210d0: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ -002210e0: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ -002210f0: 6d70 6c65 735f 7865 6e63 5f78 3530 395f mples_xenc_x509_ │ │ │ -00221100: 6373 725f 6765 6e65 7261 7465 223e 3c74 csr_generate"><t │ │ │ -00221110: 6974 6c65 3e45 7861 6d70 6c65 733c 2f74 itle>Examples</t │ │ │ -00221120: 6974 6c65 3e0a 2020 2020 3c65 7861 6d70 itle>. <examp │ │ │ -00221130: 6c65 2069 643d 2265 785f 7865 6e63 5f78 le id="ex_xenc_x │ │ │ -00221140: 3530 395f 6373 725f 6765 6e65 7261 7465 509_csr_generate │ │ │ -00221150: 223e 0a3c 7072 6f67 7261 6d6c 6973 7469 ">.<programlisti │ │ │ -00221160: 6e67 3e3c 215b 4344 4154 415b 0a53 514c ng><![CDATA[.SQL │ │ │ -00221170: 3e20 6372 6561 7465 2070 726f 6365 6475 > create procedu │ │ │ -00221180: 7265 2063 7372 5f67 656e 5f64 656d 6f28 re csr_gen_demo( │ │ │ -00221190: 290a 7b0a 6465 636c 6172 6520 6b6e 616d ).{.declare knam │ │ │ -002211a0: 652c 2063 7661 6c75 6520 7661 7263 6861 e, cvalue varcha │ │ │ -002211b0: 723b 200a 2020 2020 2020 2078 656e 635f r; . xenc_ │ │ │ -002211c0: 6b65 795f 5253 415f 6372 6561 7465 2028 key_RSA_create ( │ │ │ -002211d0: 276d 7952 5341 6b65 7927 2c20 3130 3234 'myRSAkey', 1024 │ │ │ -002211e0: 293b 0a20 2020 2020 2020 7865 6e63 5f78 );. xenc_x │ │ │ -002211f0: 3530 395f 6373 725f 6765 6e65 7261 7465 509_csr_generate │ │ │ -00221200: 2028 276d 7952 5341 6b65 7927 2c0a 0909 ('myRSAkey',... │ │ │ -00221210: 7665 6374 6f72 2028 0a09 0909 2743 4e27 vector (....'CN' │ │ │ -00221220: 2c20 2744 656d 6f20 7573 6572 272c 0a09 , 'Demo user',.. │ │ │ -00221230: 0909 2743 272c 2020 2755 5327 2c0a 0909 ..'C', 'US',... │ │ │ -00221240: 0927 4f27 2c20 2027 4f70 656e 4c69 6e6b .'O', 'OpenLink │ │ │ -00221250: 272c 0a09 0909 274f 5527 2c20 2741 6363 ',....'OU', 'Acc │ │ │ -00221260: 6f75 6e74 7327 2c0a 0909 0927 656d 6169 ounts',....'emai │ │ │ -00221270: 6c41 6464 7265 7373 272c 2027 6465 6d6f lAddress', 'demo │ │ │ -00221280: 406f 7065 6e6c 696e 6b73 772e 636f 6d27 @openlinksw.com' │ │ │ -00221290: 292c 200a 0909 7665 6374 6f72 2028 2773 ), ...vector ('s │ │ │ -002212a0: 7562 6a65 6374 416c 744e 616d 6527 2c20 ubjectAltName', │ │ │ -002212b0: 2755 5249 3a20 6874 7470 3a2f 2f77 7777 'URI: http://www │ │ │ -002212c0: 2e6f 7065 6e6c 696e 6b73 772e 636f 6d2f .openlinksw.com/ │ │ │ -002212d0: 6461 7461 7370 6163 652f 7065 7273 6f6e dataspace/person │ │ │ -002212e0: 2f64 656d 6f23 7468 6973 272c 2027 6e73 /demo#this', 'ns │ │ │ -002212f0: 436f 6d6d 656e 7427 2c20 2756 6972 7475 Comment', 'Virtu │ │ │ -00221300: 6f73 6f20 4765 6e65 7261 7465 6420 4365 oso Generated Ce │ │ │ -00221310: 7274 6966 6963 6174 6527 2c20 0a09 0909 rtificate', .... │ │ │ -00221320: 2761 7574 686f 7269 7479 4b65 7949 6465 'authorityKeyIde │ │ │ -00221330: 6e74 6966 6965 7227 2c20 276b 6579 6964 ntifier', 'keyid │ │ │ -00221340: 2c69 7373 7565 723a 616c 7761 7973 2729 ,issuer:always') │ │ │ -00221350: 293b 0a7d 3b0a 0a44 6f6e 652e 202d 2d20 );.};..Done. -- │ │ │ -00221360: 3020 6d73 6563 2e0a 5351 4c3e 2073 656c 0 msec..SQL> sel │ │ │ -00221370: 6563 7420 6373 725f 6765 6e5f 6465 6d6f ect csr_gen_demo │ │ │ -00221380: 2829 3b0a 7465 6d70 0a56 4152 4348 4152 ();.temp.VARCHAR │ │ │ -00221390: 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ._______________ │ │ │ -002213a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002213b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002213c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002213d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002213e0: 0a0a 2d2d 2d2d 2d42 4547 494e 2043 4552 ..-----BEGIN CER │ │ │ -002213f0: 5449 4649 4341 5445 2052 4551 5545 5354 TIFICATE REQUEST │ │ │ -00221400: 2d2d 2d2d 2d0a 4d49 4943 4c44 4343 415a -----.MIICLDCCAZ │ │ │ -00221410: 5543 4144 4272 4d52 4977 4541 5944 5651 UCADBrMRIwEAYDVQ │ │ │ -00221420: 5144 4577 6c45 5a57 3176 4948 567a 5a58 QDEwlEZW1vIHVzZX │ │ │ -00221430: 4978 437a 414a 4267 4e56 4241 5954 416c IxCzAJBgNVBAYTAl │ │ │ -00221440: 5654 4d52 4577 0a44 7759 4456 5151 4b45 VTMREw.DwYDVQQKE │ │ │ -00221450: 7768 5063 4756 7554 476c 7561 7a45 524d whPcGVuTGluazERM │ │ │ -00221460: 4138 4741 3155 4543 784d 4951 574e 6a62 A8GA1UECxMIQWNjb │ │ │ -00221470: 3356 7564 484d 7849 6a41 6742 676b 7168 3VudHMxIjAgBgkqh │ │ │ -00221480: 6b69 4739 7730 420a 4351 4557 4532 526c kiG9w0B.CQEWE2Rl │ │ │ -00221490: 6257 3941 6233 426c 626d 7870 626d 747a bW9Ab3Blbmxpbmtz │ │ │ -002214a0: 6479 356a 6232 3077 675a 3877 4451 594a dy5jb20wgZ8wDQYJ │ │ │ -002214b0: 4b6f 5a49 6876 634e 4151 4542 4251 4144 KoZIhvcNAQEBBQAD │ │ │ -002214c0: 6759 3041 4d49 474a 0a41 6f47 4241 4d2b gY0AMIGJ.AoGBAM+ │ │ │ -002214d0: 6532 3178 6551 494a 5835 7953 6436 4a75 e21xeQIJX5ySd6Ju │ │ │ -002214e0: 6333 4774 436e 7954 2b4a 7644 4b67 6f78 c3GtCnyT+JvDKgox │ │ │ -002214f0: 6b6d 6f76 4664 716b 436d 314b 7337 5079 kmovFdqkCm1Ks7Py │ │ │ -00221500: 7330 7835 396b 7353 5a0a 445a 6f45 4154 s0x59ksSZ.DZoEAT │ │ │ -00221510: 4574 2f73 5173 4542 3741 6e52 416b 4837 Et/sQsEB7AnRAkH7 │ │ │ -00221520: 366c 5779 4730 7a4d 7476 7864 6b46 4838 6lWyG0zMtvxdkFH8 │ │ │ -00221530: 4365 7061 6171 3462 6364 7153 676d 4531 Cepaaq4bcdqSgmE1 │ │ │ -00221540: 3244 5277 5669 5239 3561 0a5a 4e41 3876 2DRwViR95a.ZNA8v │ │ │ -00221550: 686f 6e72 3555 6454 6274 4b6b 4947 4436 honr5UdTbtKkIGD6 │ │ │ -00221560: 3749 726b 4748 3831 4338 7472 7746 2b38 7IrkGH81C8trwF+8 │ │ │ -00221570: 4c6e 594b 6474 6631 624d 6441 674d 4241 LnYKdtf1bMdAgMBA │ │ │ -00221580: 4147 6767 5945 7766 7759 4a0a 4b6f 5a49 AGggYEwfwYJ.KoZI │ │ │ -00221590: 6876 634e 4151 6b4f 4d58 4977 6344 412f hvcNAQkOMXIwcDA/ │ │ │ -002215a0: 4267 4e56 4852 4545 4f44 4132 686a 526f BgNVHREEODA2hjRo │ │ │ -002215b0: 6448 5277 4f69 3876 6433 6433 4c6d 3977 dHRwOi8vd3d3Lm9w │ │ │ -002215c0: 5a57 3573 6157 3572 6333 6375 0a59 3239 ZW5saW5rc3cu.Y29 │ │ │ -002215d0: 744c 3252 6864 4746 7a63 4746 6a5a 5339 tL2RhdGFzcGFjZS9 │ │ │ -002215e0: 775a 584a 7a62 3234 765a 4756 7462 794e wZXJzb24vZGVtbyN │ │ │ -002215f0: 3061 476c 7a4d 4330 4743 5743 4753 4147 0aGlzMC0GCWCGSAG │ │ │ -00221600: 472b 4549 4244 5151 6746 6835 570a 6158 G+EIBDQQgFh5W.aX │ │ │ -00221610: 4a30 6457 397a 6279 4248 5a57 356c 636d J0dW9zbyBHZW5lcm │ │ │ -00221620: 4630 5a57 5167 5132 5679 6447 6c6d 6157 F0ZWQgQ2VydGlmaW │ │ │ -00221630: 4e68 6447 5577 4451 594a 4b6f 5a49 6876 NhdGUwDQYJKoZIhv │ │ │ -00221640: 634e 4151 4545 4251 4144 6759 4541 0a43 cNAQEEBQADgYEA.C │ │ │ -00221650: 512b 5565 5147 574c 6e48 6e35 5839 744b Q+UeQGWLnHn5X9tK │ │ │ -00221660: 756d 7667 5032 7034 4c67 7848 734e 7130 umvgP2p4LgxHsNq0 │ │ │ -00221670: 7546 5a66 6656 4252 5541 5636 7738 5752 uFZffVBRUAV6w8WR │ │ │ -00221680: 776f 7235 5a4b 4f65 4e68 4872 6c64 700a wor5ZKOeNhHrldp. │ │ │ -00221690: 5a76 7848 6339 4553 4642 5441 3737 3257 ZvxHc9ESFBTA772W │ │ │ -002216a0: 3031 566d 514e 6670 6a6b 4663 7048 3579 01VmQNfpjkFcpH5y │ │ │ -002216b0: 6438 3164 466b 5373 4633 6c4b 656d 5149 d81dFkSsF3lKemQI │ │ │ -002216c0: 486e 6c7a 3462 4f52 5534 6176 3254 4d4d Hnlz4bORU4av2TMM │ │ │ -002216d0: 0a54 394f 4970 3546 4e4f 6563 3133 6a58 .T9OIp5FNOec13jX │ │ │ -002216e0: 7156 6573 796d 642b 4b6c 2b56 6239 7352 qVesymd+Kl+Vb9sR │ │ │ -002216f0: 4261 4331 5862 314f 5372 7955 3d0a 2d2d BaC1Xb1OSryU=.-- │ │ │ -00221700: 2d2d 2d45 4e44 2043 4552 5449 4649 4341 ---END CERTIFICA │ │ │ -00221710: 5445 2052 4551 5545 5354 2d2d 2d2d 2d0a TE REQUEST-----. │ │ │ -00221720: 0a0a 3120 526f 7773 2e20 2d2d 2033 3930 ..1 Rows. -- 390 │ │ │ -00221730: 206d 7365 632e 0a5d 5d3e 3c2f 7072 6f67 msec..]]></prog │ │ │ -00221740: 7261 6d6c 6973 7469 6e67 3e0a 2020 2020 ramlisting>. │ │ │ -00221750: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 </example>. </r │ │ │ -00221760: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -00221770: 6563 7431 2069 643d 2273 6565 616c 736f ect1 id="seealso │ │ │ -00221780: 5f78 656e 635f 7835 3039 5f63 7372 5f67 _xenc_x509_csr_g │ │ │ -00221790: 656e 6572 6174 6522 3e3c 7469 746c 653e enerate"><title> │ │ │ -002217a0: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ -002217b0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . get_certifica │ │ │ -002217f0: 7465 5f69 6e66 6f28 293c 2f6c 696e 6b3e te_info() │ │ │ -00221800: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xenc_x50 │ │ │ -00221840: 395f 6672 6f6d 5f63 7372 2829 3c2f 6c69 9_from_csr(). < │ │ │ -00221860: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_ │ │ │ -00221890: 7835 3039 5f67 656e 6572 6174 6528 293c x509_generate()< │ │ │ -002218a0: 2f6c 696e 6b3e 3c2f 7061 7261 3e20 2020 /link> │ │ │ -002218b0: 200a 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ -002218c0: 2f72 6566 656e 7472 793e 0a0a b600 0000 /refentry>...... │ │ │ -002218d0: 2c64 656d 6f2f 646f 6373 7263 2f66 756e ,demo/docsrc/fun │ │ │ -002218e0: 6372 6566 2f78 656e 635f 7365 745f 7072 cref/xenc_set_pr │ │ │ -002218f0: 696d 6172 795f 6b65 792e 786d 6cdf 0000 imary_key.xml... │ │ │ -00221900: 0a8d 3c3f 786d 6c20 7665 7273 696f 6e3d ....< │ │ │ -00221c90: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ -00221ca0: 7865 6e63 5f73 6574 5f70 7269 6d61 7279 xenc_set_primary │ │ │ -00221cb0: 5f6b 6579 223e 0a20 203c 7265 666d 6574 _key">. . xenc_set_p │ │ │ -00221ce0: 7269 6d61 7279 5f6b 6579 3c2f 7265 6665 rimary_key. < │ │ │ -00221d00: 7265 666d 6973 6369 6e66 6f3e 6861 7368 refmiscinfo>hash │ │ │ -00221d10: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -00221d20: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72 . . < │ │ │ -00221d40: 7265 666e 616d 653e 7865 6e63 5f73 6574 refname>xenc_set │ │ │ -00221d50: 5f70 7269 6d61 7279 5f6b 6579 3c2f 7265 _primary_key. Associate │ │ │ -00221d80: 2061 2058 2e35 3039 2063 6572 7469 6669 a X.509 certifi │ │ │ -00221d90: 6361 7465 2077 6974 6820 6120 6b65 793c cate with a key< │ │ │ -00221da0: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -00221db0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -00221dc0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -00221dd0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . . │ │ │ -00221e40: 203c 6675 6e63 6465 663e 3c66 756e 6374 xenc_set_pri │ │ │ -00221e60: 6d61 7279 5f6b 6579 3c2f 6675 6e63 7469 mary_key..< │ │ │ -00221e80: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in name varchar< │ │ │ -00221eb0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -00221ec0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . . Description</ti │ │ │ -00221f40: 746c 653e 0a20 2020 203c 7061 7261 3e0a tle>. <para>. │ │ │ -00221f50: 0954 6869 7320 6675 6e63 7469 6f6e 2069 .This function i │ │ │ -00221f60: 7320 7573 6564 2074 6f20 6173 736f 6369 s used to associ │ │ │ -00221f70: 6174 6520 6120 6b65 7920 2874 6f20 6265 ate a key (to be │ │ │ -00221f80: 2075 7365 6420 6173 2070 7269 6d61 7279 used as primary │ │ │ -00221f90: 2920 7769 7468 2061 2058 2e35 3039 2063 ) with a X.509 c │ │ │ -00221fa0: 6572 7469 6669 6361 7465 2e20 0a09 5573 ertificate. ..Us │ │ │ -00221fb0: 7561 6c6c 7920 7468 6973 2066 756e 6374 ually this funct │ │ │ -00221fc0: 696f 6e20 6973 2063 616c 6c65 6420 6166 ion is called af │ │ │ -00221fd0: 7465 7220 6b65 7920 696d 706f 7274 2066 ter key import f │ │ │ -00221fe0: 726f 6d20 6120 582e 3530 3920 6365 7274 rom a X.509 cert │ │ │ -00221ff0: 6966 6963 6174 652e 2020 0a20 2020 203c ificate. . < │ │ │ -00222000: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. </refse │ │ │ -00222010: 6374 313e 0a20 203c 7265 6673 6563 7431 ct1>. <refsect1 │ │ │ -00222020: 2069 643d 2270 6172 616d 735f 7865 6e63 id="params_xenc │ │ │ -00222030: 5f73 6574 5f70 7269 6d61 7279 5f6b 6579 _set_primary_key │ │ │ -00222040: 223e 0a20 2020 203c 7469 746c 653e 5061 ">. <title>Pa │ │ │ -00222050: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ -00222060: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00222070: 7469 746c 653e 6e61 6d65 3c2f 7469 746c title>name. N │ │ │ -00222090: 616d 6520 6f66 2074 6865 206b 6579 2074 ame of the key t │ │ │ -002220a0: 6f20 6265 2070 726f 6365 7373 6564 2e3c o be processed.< │ │ │ -002220b0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . < │ │ │ -00222100: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ -00222110: 6573 3c2f 7469 746c 653e 0a20 2020 2020 es. │ │ │ -00222120: 203c 7061 7261 3e4e 6f20 7265 7475 726e No return │ │ │ -00222130: 2076 616c 7565 2e3c 2f70 6172 613e 0a20 value.. │ │ │ -00222140: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -00222150: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ -00222160: 6d70 6c65 735f 7865 6e63 5f73 6574 5f70 mples_xenc_set_p │ │ │ -00222170: 7269 6d61 7279 5f6b 6579 223e 0a20 2020 rimary_key">. │ │ │ -00222180: 203c 7469 746c 653e 4578 616d 706c 6573 Examples │ │ │ -00222190: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Import │ │ │ -002221d0: 696e 6720 6120 6b65 7920 6672 6f6d 2058 ing a key from X │ │ │ -002221e0: 2e35 3039 2063 6572 7469 6669 6361 7465 .509 certificate │ │ │ -002221f0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00222200: 7363 7265 656e 3e3c 215b 4344 4154 415b screen>. │ │ │ -002222a0: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -002222b0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -002222c0: 3c72 6566 7365 6374 3120 6964 3d22 7365 . │ │ │ -002222f0: 203c 7469 746c 653e 5365 6520 416c 736f See Also │ │ │ -00222300: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . xenc_key_cr │ │ │ -00222350: 6561 7465 5f63 6572 7428 293c 2f66 756e eate_cert()

    . .
    .. │ │ │ -00222390: 0000 002a 6465 6d6f 2f64 6f63 7372 632f ...*demo/docsrc/ │ │ │ -002223a0: 6675 6e63 7265 662f 7865 6e63 5f70 6b63 funcref/xenc_pkc │ │ │ -002223b0: 7331 325f 6578 706f 7274 2e78 6d6c df00 s12_export.xml.. │ │ │ -002223c0: 000f c93c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -002223f0: 212d 2d0a 2020 0a20 2054 6869 7320 6669 !--. . This fi │ │ │ -00222400: 6c65 2069 7320 7061 7274 206f 6620 7468 le is part of th │ │ │ -00222410: 6520 4f70 656e 4c69 6e6b 2053 6f66 7477 e OpenLink Softw │ │ │ -00222420: 6172 6520 5669 7274 756f 736f 204f 7065 are Virtuoso Ope │ │ │ -00222430: 6e2d 536f 7572 6365 2028 564f 5329 0a20 n-Source (VOS). │ │ │ -00222440: 2070 726f 6a65 6374 2e0a 2020 0a20 2043 project.. . C │ │ │ -00222450: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ -00222460: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ -00222470: 536f 6674 7761 7265 0a20 200a 2020 5468 Software. . Th │ │ │ -00222480: 6973 2070 726f 6a65 6374 2069 7320 6672 is project is fr │ │ │ -00222490: 6565 2073 6f66 7477 6172 653b 2079 6f75 ee software; you │ │ │ -002224a0: 2063 616e 2072 6564 6973 7472 6962 7574 can redistribut │ │ │ -002224b0: 6520 6974 2061 6e64 2f6f 7220 6d6f 6469 e it and/or modi │ │ │ -002224c0: 6679 2069 740a 2020 756e 6465 7220 7468 fy it. under th │ │ │ -002224d0: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -002224e0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -002224f0: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -00222500: 6c69 7368 6564 2062 7920 7468 650a 2020 lished by the. │ │ │ -00222510: 4672 6565 2053 6f66 7477 6172 6520 466f Free Software Fo │ │ │ -00222520: 756e 6461 7469 6f6e 3b20 6f6e 6c79 2076 undation; only v │ │ │ -00222530: 6572 7369 6f6e 2032 206f 6620 7468 6520 ersion 2 of the │ │ │ -00222540: 4c69 6365 6e73 652c 2064 6174 6564 204a License, dated J │ │ │ -00222550: 756e 6520 3139 3931 2e0a 2020 0a20 2054 une 1991.. . T │ │ │ -00222560: 6869 7320 7072 6f67 7261 6d20 6973 2064 his program is d │ │ │ -00222570: 6973 7472 6962 7574 6564 2069 6e20 7468 istributed in th │ │ │ -00222580: 6520 686f 7065 2074 6861 7420 6974 2077 e hope that it w │ │ │ -00222590: 696c 6c20 6265 2075 7365 6675 6c2c 2062 ill be useful, b │ │ │ -002225a0: 7574 0a20 2057 4954 484f 5554 2041 4e59 ut. WITHOUT ANY │ │ │ -002225b0: 2057 4152 5241 4e54 593b 2077 6974 686f WARRANTY; witho │ │ │ -002225c0: 7574 2065 7665 6e20 7468 6520 696d 706c ut even the impl │ │ │ -002225d0: 6965 6420 7761 7272 616e 7479 206f 660a ied warranty of. │ │ │ -002225e0: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ -002225f0: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ -00222600: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ -00222610: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ -00222620: 4e55 0a20 2047 656e 6572 616c 2050 7562 NU. General Pub │ │ │ -00222630: 6c69 6320 4c69 6365 6e73 6520 666f 7220 lic License for │ │ │ -00222640: 6d6f 7265 2064 6574 6169 6c73 2e0a 2020 more details.. │ │ │ -00222650: 0a20 2059 6f75 2073 686f 756c 6420 6861 . You should ha │ │ │ -00222660: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -00222670: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -00222680: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -00222690: 656e 7365 2061 6c6f 6e67 0a20 2077 6974 ense along. wit │ │ │ -002226a0: 6820 7468 6973 2070 726f 6772 616d 3b20 h this program; │ │ │ -002226b0: 6966 206e 6f74 2c20 7772 6974 6520 746f if not, write to │ │ │ -002226c0: 2074 6865 2046 7265 6520 536f 6674 7761 the Free Softwa │ │ │ -002226d0: 7265 2046 6f75 6e64 6174 696f 6e2c 2049 re Foundation, I │ │ │ -002226e0: 6e63 2e2c 0a20 2035 3120 4672 616e 6b6c nc.,. 51 Frankl │ │ │ -002226f0: 696e 2053 742c 2046 6966 7468 2046 6c6f in St, Fifth Flo │ │ │ -00222700: 6f72 2c20 426f 7374 6f6e 2c20 4d41 2030 or, Boston, MA 0 │ │ │ -00222710: 3231 3130 2d31 3330 3120 5553 410a 0a20 2110-1301 USA.. │ │ │ -00222720: 203a 2074 656d 706c 6174 652e 7368 2c76 : template.sh,v │ │ │ -00222730: 2031 2e35 2032 3030 362f 3034 2f31 3820 1.5 2006/04/18 │ │ │ -00222740: 3231 3a35 393a 3133 2069 7661 6e20 4578 21:59:13 ivan Ex │ │ │ -00222750: 7020 240a 2d2d 3e0a 3c72 6566 656e 7472 p $.-->.. │ │ │ -00222780: 3c72 6566 6d65 7461 3e0a 2020 2020 3c72 . xen │ │ │ -002227a0: 635f 706b 6373 3132 5f65 7870 6f72 743c c_pkcs12_export< │ │ │ -002227b0: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ -002227c0: 2020 2020 3c72 6566 6d69 7363 696e 666f hash. │ │ │ -002227f0: 0a20 203c 7265 666e 616d 6564 6976 3e0a . . │ │ │ -00222800: 2020 2020 3c72 6566 6e61 6d65 3e78 656e xen │ │ │ -00222810: 635f 706b 6373 3132 5f65 7870 6f72 743c c_pkcs12_export< │ │ │ -00222820: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Genera │ │ │ -00222840: 7465 7320 6120 7365 6375 7265 2050 7562 tes a secure Pub │ │ │ -00222850: 6c69 632d 4b65 7920 4372 7970 746f 6772 lic-Key Cryptogr │ │ │ -00222860: 6170 6879 2053 7461 6e64 6172 6473 2028 aphy Standards ( │ │ │ -00222870: 504b 4353 2331 3229 2066 696c 6520 6672 PKCS#12) file fr │ │ │ -00222880: 6f6d 2061 2050 454d 2028 6261 7365 3634 om a PEM (base64 │ │ │ -00222890: 2065 6e63 6f64 6564 2044 4552 2920 6669 encoded DER) fi │ │ │ -002228a0: 6c65 2063 6f6d 7072 6973 6564 206f 6620 le comprised of │ │ │ -002228b0: 616e 2058 2e35 3039 2063 6572 7469 6669 an X.509 certifi │ │ │ -002228c0: 6361 7465 2061 6e64 2061 6e20 6173 736f cate and an asso │ │ │ -002228d0: 6369 6174 6564 2050 7269 7661 7465 204b ciated Private K │ │ │ -002228e0: 6579 2e3c 2f72 6566 7075 7270 6f73 653e ey. │ │ │ -002228f0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -00222900: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . │ │ │ -00222980: 203c 6675 6e63 6465 663e 3c66 756e 6374 xenc_pkcs12_ │ │ │ -002229a0: 6578 706f 7274 3c2f 6675 6e63 7469 6f6e export..in key_name

    varcha │ │ │ -002229f0: 723c 2f70 6172 616d 6465 663e 0a09 3c70 r..

    in name varchar..in pass varchar..in < │ │ │ -00222a90: 7061 7261 6d65 7465 723e 6578 706f 7274 parameter>export │ │ │ -00222aa0: 5f63 6861 696e 3c2f 7061 7261 6d65 7465 _chain integer := 0 │ │ │ -00222ac0: 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 6172 ..in < │ │ │ -00222af0: 7061 7261 6d65 7465 723e 6164 6469 7469 parameter>additi │ │ │ -00222b00: 6f6e 616c 5f63 6572 7473 3c2f 7061 7261 onal_certs varchar. . │ │ │ -00222b50: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ -00222b60: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . . │ │ │ -00222ba0: 2020 3c74 6974 6c65 3e44 6573 6372 6970 Descrip │ │ │ -00222bb0: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ -00222bc0: 203c 7061 7261 3e47 656e 6572 6174 6573 Generates │ │ │ -00222bd0: 2061 2073 6563 7572 6520 5075 626c 6963 a secure Public │ │ │ -00222be0: 2d4b 6579 2043 7279 7074 6f67 7261 7068 -Key Cryptograph │ │ │ -00222bf0: 7920 5374 616e 6461 7264 7320 2850 4b43 y Standards (PKC │ │ │ -00222c00: 5323 3132 2920 6669 6c65 2066 726f 6d20 S#12) file from │ │ │ -00222c10: 6120 5045 4d20 2862 6173 6536 3420 656e a PEM (base64 en │ │ │ -00222c20: 636f 6465 6420 4445 5229 2066 696c 6520 coded DER) file │ │ │ -00222c30: 636f 6d70 7269 7365 6420 6f66 2061 6e20 comprised of an │ │ │ -00222c40: 582e 3530 3920 6365 7274 6966 6963 6174 X.509 certificat │ │ │ -00222c50: 6520 616e 6420 616e 2061 7373 6f63 6961 e and an associa │ │ │ -00222c60: 7465 6420 5072 6976 6174 6520 4b65 792e ted Private Key. │ │ │ -00222c70: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . Par │ │ │ -00222cc0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -00222cd0: 2020 2020 3c72 6566 7365 6374 323e 3c74 key_name. Name that iden │ │ │ -00222d10: 7469 6669 6573 2070 7269 7661 7465 206b tifies private k │ │ │ -00222d20: 6579 2061 7373 6f63 6961 7465 6420 7769 ey associated wi │ │ │ -00222d30: 7468 2058 2e35 3039 2063 6572 7469 6669 th X.509 certifi │ │ │ -00222d40: 6361 7465 2e3c 2f70 6172 613e 0a20 2020 cate.. │ │ │ -00222d50: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ -00222d60: 203c 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00222d70: 093c 7469 746c 653e 6e61 6d65 3c2f 7469 .name</ti │ │ │ -00222d80: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -00222d90: 3e4e 616d 6520 746f 2075 7365 6420 746f >Name to used to │ │ │ -00222da0: 2069 6465 6e74 6966 7920 6561 6368 2020 identify each │ │ │ -00222db0: 706b 6373 2331 3220 6f62 6a65 6374 2062 pkcs#12 object b │ │ │ -00222dc0: 756e 646c 652e 3c2f 7061 7261 3e0a 2020 undle.</para>. │ │ │ -00222dd0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 </refsect2>. │ │ │ -00222de0: 2020 3c72 6566 7365 6374 323e 3c74 6974 <refsect2><tit │ │ │ -00222df0: 6c65 3e70 6173 733c 2f74 6974 6c65 3e0a le>pass. │ │ │ -00222e00: 2020 2020 2020 3c70 6172 613e 4120 7061 A pa │ │ │ -00222e10: 7373 776f 7264 206f 7220 7061 7373 2070 ssword or pass p │ │ │ -00222e20: 6872 6173 6520 7573 6564 2074 6f20 656e hrase used to en │ │ │ -00222e30: 6372 7970 7420 7468 6520 706b 6373 2331 crypt the pkcs#1 │ │ │ -00222e40: 3220 6669 6c65 3c2f 7061 7261 3e0a 2020 2 file. │ │ │ -00222e50: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ -00222e60: 2020 3c72 6566 7365 6374 323e 3c74 6974 export_chain< │ │ │ -00222e80: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    1/0 - to exp │ │ │ -00222ea0: 6f72 7420 7468 6520 6365 7274 6966 6963 ort the certific │ │ │ -00222eb0: 6174 6520 6368 6169 6e20 6966 2074 6865 ate chain if the │ │ │ -00222ec0: 7265 2069 7320 6120 7375 6368 3c2f 7061 re is a such. . additio │ │ │ -00222f00: 6e61 6c5f 6365 7274 733c 2f74 6974 6c65 nal_certs. Ce │ │ │ -00222f20: 7274 6966 6963 6174 6573 2069 6e20 5045 rtificates in PE │ │ │ -00222f30: 4d20 666f 726d 6174 2074 6f20 6265 2061 M format to be a │ │ │ -00222f40: 6464 6564 2074 6f20 7468 6520 6275 6e64 dded to the bund │ │ │ -00222f50: 6c65 2065 7665 6e20 6966 2074 6865 7920 le even if they │ │ │ -00222f60: 6172 6520 6e6f 7420 696e 2074 6865 2063 are not in the c │ │ │ -00222f70: 6572 7469 6669 6361 7465 2063 6861 696e ertificate chain │ │ │ -00222f80: 2073 746f 7265 6420 696e 0a20 2020 2020 stored in. │ │ │ -00222f90: 2009 7468 6520 6d65 6d6f 7279 206f 626a .the memory obj │ │ │ -00222fa0: 6563 7420 6f66 2074 6865 2063 6572 7469 ect of the certi │ │ │ -00222fb0: 6669 6361 7465 3c2f 7061 7261 3e0a 2020 ficate. │ │ │ -00222fc0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ -00222fd0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . . Examples. Persisting │ │ │ -00223060: 6120 6b65 7920 2661 6d70 3b20 6365 7274 a key & cert │ │ │ -00223070: 6966 6963 6174 653c 2f74 6974 6c65 3e0a ificate. │ │ │ -00223080: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -00223090: 6578 616d 706c 6520 6265 6c6f 7720 7065 example below pe │ │ │ -002230a0: 7273 6973 7473 2061 206b 6579 206e 616d rsists a key nam │ │ │ -002230b0: 6564 2027 6964 5f72 7361 2720 616e 6420 ed 'id_rsa' and │ │ │ -002230c0: 6365 7274 6966 6963 6174 6520 6372 6561 certificate crea │ │ │ -002230d0: 7465 6420 666f 7220 6974 2069 6e74 6f20 ted for it into │ │ │ -002230e0: 7573 6572 2773 206b 6579 2073 7061 6365 user's key space │ │ │ -002230f0: 2e0a 2020 2020 2020 5468 7573 2061 6674 .. Thus aft │ │ │ -00223100: 6572 2073 6572 7665 7220 7265 7374 6172 er server restar │ │ │ -00223110: 7420 7468 6520 6b65 7920 7769 6c6c 2062 t the key will b │ │ │ -00223120: 6520 6176 6169 6c61 626c 6520 6167 6169 e available agai │ │ │ -00223130: 6e2e 3c2f 7061 7261 3e0a 3c70 726f 6772 n... . . . │ │ │ -00223220: 2020 2020 3c74 6974 6c65 3e53 6565 2041 See A │ │ │ -00223230: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -00223240: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b user_key_store │ │ │ -00223280: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ -002232a0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xenc_x509_ │ │ │ -002232e0: 6765 6e65 7261 7465 2829 3c2f 6675 6e63 generate(). xenc_x509_ss_ge │ │ │ -00223350: 6e65 7261 7465 2829 3c2f 6675 6e63 7469 nerate(). . │ │ │ -00223380: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 ..... │ │ │ -00223390: 2764 656d 6f2f 646f 6373 7263 2f66 756e 'demo/docsrc/fun │ │ │ -002233a0: 6372 6566 2f78 656e 635f 7065 6d5f 6578 cref/xenc_pem_ex │ │ │ -002233b0: 706f 7274 2e78 6d6c df00 0011 ee3c 3f78 port.xml........ . │ │ │ -002249a0: 2020 3c72 6566 656e 7472 7974 6974 6c65 xenc_key_serial │ │ │ -002249c0: 697a 653c 2f72 6566 656e 7472 7974 6974 ize. hash. . . xenc_key_serial │ │ │ -00224a30: 697a 653c 2f72 6566 6e61 6d65 3e0a 2020 ize. │ │ │ -00224a40: 2020 3c72 6566 7075 7270 6f73 653e 4578 Ex │ │ │ -00224a50: 7472 6163 7473 2061 206b 6579 2066 726f tracts a key fro │ │ │ -00224a60: 6d20 7573 6572 2773 2072 6570 6f73 6974 m user's reposit │ │ │ -00224a70: 6f72 793c 2f72 6566 7075 7270 6f73 653e ory │ │ │ -00224a80: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -00224a90: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . │ │ │ -00224b10: 203c 6675 6e63 6465 663e 7661 7263 6861 varcha │ │ │ -00224b20: 7220 3c66 756e 6374 696f 6e3e 7865 6e63 r xenc │ │ │ -00224b30: 5f6b 6579 5f73 6572 6961 6c69 7a65 3c2f _key_serialize..i │ │ │ -00224b60: 6e20 3c70 6172 616d 6574 6572 3e6e 616d n nam │ │ │ -00224b70: 653c 2f70 6172 616d 6574 6572 3e20 7661 e va │ │ │ -00224b80: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ -00224b90: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -00224ba0: 7061 7261 6d65 7465 723e 7075 626c 6963 parameter>public │ │ │ -00224bb0: 3c2f 7061 7261 6d65 7465 723e 2069 6e74 int │ │ │ -00224bc0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ -00224bd0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . │ │ │ -00224c40: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -00224c50: 6c65 3e0a 2020 2020 3c70 6172 613e 0a09 le>. <para>.. │ │ │ -00224c60: 5468 6520 6675 6e63 7469 6f6e 2072 6574 The function ret │ │ │ -00224c70: 7572 6e73 2061 2073 7472 696e 6720 636f urns a string co │ │ │ -00224c80: 6e74 6169 6e69 6e67 2062 6173 6536 3420 ntaining base64 │ │ │ -00224c90: 656e 636f 6465 6420 6269 6e61 7279 200a encoded binary . │ │ │ -00224ca0: 096b 6579 2064 6174 612e 2049 7420 6973 .key data. It is │ │ │ -00224cb0: 2075 7365 6420 746f 2065 7874 7261 6374 used to extract │ │ │ -00224cc0: 2073 796d 6d65 7472 6963 206f 7220 6173 symmetric or as │ │ │ -00224cd0: 796d 6d65 7472 6963 206b 6579 732e 0a09 ymmetric keys... │ │ │ -00224ce0: 536f 2069 6620 6b65 7920 6973 2061 7379 So if key is asy │ │ │ -00224cf0: 6d6d 6574 7269 6320 2852 5341 206f 7220 mmetric (RSA or │ │ │ -00224d00: 4453 4129 2074 6865 2073 6563 6f6e 6420 DSA) the second │ │ │ -00224d10: 7061 7261 6d65 7465 7220 0a09 6465 7369 parameter ..desi │ │ │ -00224d20: 676e 6174 6520 7768 6963 6820 7061 7274 gnate which part │ │ │ -00224d30: 2074 6f20 6578 7472 6163 7420 7072 6976 to extract priv │ │ │ -00224d40: 6174 6520 6f72 2070 7562 6c69 632e 0a20 ate or public.. │ │ │ -00224d50: 2020 203c 2f70 6172 613e 0a20 203c 2f72 </para>. </r │ │ │ -00224d60: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -00224d70: 6563 7431 2069 643d 2270 6172 616d 735f ect1 id="params_ │ │ │ -00224d80: 7865 6e63 5f6b 6579 5f73 6572 6961 6c69 xenc_key_seriali │ │ │ -00224d90: 7a65 223e 0a20 2020 203c 7469 746c 653e ze">. <title> │ │ │ -00224da0: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -00224db0: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -00224dc0: 3e3c 7469 746c 653e 6e61 6d65 3c2f 7469 ><title>name</ti │ │ │ -00224dd0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -00224de0: 3e54 6865 206b 6579 206e 616d 652e 3c2f >The key name.</ │ │ │ -00224df0: 7061 7261 3e0a 2020 2020 3c2f 7265 6673 para>. </refs │ │ │ -00224e00: 6563 7432 3e0a 2020 2020 3c72 6566 7365 ect2>. <refse │ │ │ -00224e10: 6374 323e 3c74 6974 6c65 3e70 7562 6c69 ct2><title>publi │ │ │ -00224e20: 633c 2f74 6974 6c65 3e0a 2020 2020 2020 c. │ │ │ -00224e30: 3c70 6172 613e 3120 2d20 6578 706f 7274 1 - export │ │ │ -00224e40: 2070 7562 6c69 6320 7061 7274 2c20 3020 public part, 0 │ │ │ -00224e50: 2d20 6578 706f 7274 2070 7269 7661 7465 - export private │ │ │ -00224e60: 206b 6579 2069 6620 6578 6973 7473 2e3c key if exists.< │ │ │ -00224e70: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . Return Types │ │ │ -00224ed0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00224ee0: 7061 7261 3e54 6865 2066 756e 6374 696f para>The functio │ │ │ -00224ef0: 6e20 7265 7475 726e 7320 7365 7269 616c n returns serial │ │ │ -00224f00: 697a 6564 206b 6579 206d 6174 6572 6961 ized key materia │ │ │ -00224f10: 6c2e 3c2f 7061 7261 3e0a 2020 3c2f 7265 l.. . . Examples. Exporting a RSA │ │ │ -00224fb0: 2070 7562 6c69 6320 6b65 792e 3c2f 7469 public key.</ti │ │ │ -00224fc0: 746c 653e 0a09 3c70 6172 613e 0a09 2020 tle>..<para>.. │ │ │ -00224fd0: 2020 5468 6520 2753 6572 7665 7250 7269 The 'ServerPri │ │ │ -00224fe0: 7661 7465 2e70 6678 2720 6973 2061 206f vate.pfx' is a o │ │ │ -00224ff0: 776e 2052 5341 206b 6579 2073 6f20 7765 wn RSA key so we │ │ │ -00225000: 2065 7870 6f72 7469 6e67 2070 7562 6c69 exporting publi │ │ │ -00225010: 6320 7061 7274 200a 0920 2020 2074 6f20 c part .. to │ │ │ -00225020: 7375 7070 6c79 2074 6f20 736f 6d65 2070 supply to some p │ │ │ -00225030: 6172 7479 2074 6f20 656e 6372 7970 7420 arty to encrypt │ │ │ -00225040: 6461 7461 2066 6f72 2075 732e 0a09 3c2f data for us...</ │ │ │ -00225050: 7061 7261 3e0a 093c 7363 7265 656e 3e3c para>..<screen>< │ │ │ -00225060: 215b 4344 4154 415b 0a53 514c 3e20 7365 ![CDATA[.SQL> se │ │ │ -00225070: 6c65 6374 2078 656e 635f 6b65 795f 7365 lect xenc_key_se │ │ │ -00225080: 7269 616c 697a 6520 2827 5365 7276 6572 rialize ('Server │ │ │ -00225090: 5072 6976 6174 652e 7066 7827 2c20 3129 Private.pfx', 1) │ │ │ -002250a0: 3b0a 6361 6c6c 7265 740a 5641 5243 4841 ;.callret.VARCHA │ │ │ -002250b0: 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f R.______________ │ │ │ -002250c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002250d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002250e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002250f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00225100: 5f0a 0a4d 4947 4a41 6f47 4241 4d75 5371 _..MIGJAoGBAMuSq │ │ │ -00225110: 4355 4373 6965 3652 4755 5042 6474 794d CUCsie6RGUPBdtyM │ │ │ -00225120: 3366 5046 2b79 4e35 6f74 3334 6939 2f49 3fPF+yN5ot34i9/I │ │ │ -00225130: 506d 6a66 6d6c 534f 6c4f 512f 4139 6559 PmjfmlSOlOQ/A9eY │ │ │ -00225140: 436c 4a79 7678 5256 4445 486b 6b4e 464a ClJyvxRVDEHkkNFJ │ │ │ -00225150: 5755 7a50 5756 5244 6f49 4573 5573 5967 WUzPWVRDoIEsUsYg │ │ │ -00225160: 4241 366c 7338 7166 6169 3658 6457 596f BA6ls8qfai6XdWYo │ │ │ -00225170: 422f 3264 4642 2f30 3874 5435 754a 616a B/2dFB/08tT5uJaj │ │ │ -00225180: 4e6c 6553 4635 736a 4a72 6a63 5076 6d76 NleSF5sjJrjcPvmv │ │ │ -00225190: 6e37 6b31 5372 5646 7443 4949 4c69 6f69 n7k1SrVFtCIILioi │ │ │ -002251a0: 6874 4770 5232 4470 7032 364d 466a 6666 htGpR2Dpp26MFjff │ │ │ -002251b0: 6641 6e4c 6869 4441 674d 4241 4145 3d0a fAnLhiDAgMBAAE=. │ │ │ -002251c0: 0a31 2052 6f77 732e 202d 2d20 3120 6d73 .1 Rows. -- 1 ms │ │ │ -002251d0: 6563 2e0a 0920 2020 200a 5d5d 3e0a 3c2f ec... .]]>.</ │ │ │ -002251e0: 7363 7265 656e 3e0a 2020 2020 3c2f 6578 screen>. </ex │ │ │ -002251f0: 616d 706c 653e 0a20 203c 2f72 6566 7365 ample>. </refse │ │ │ -00225200: 6374 313e 0a3c 2f72 6566 656e 7472 793e ct1>.</refentry> │ │ │ -00225210: 0ab6 0000 002b 6465 6d6f 2f64 6f63 7372 .....+demo/docsr │ │ │ -00225220: 632f 6675 6e63 7265 662f 7865 6e63 5f6b c/funcref/xenc_k │ │ │ -00225230: 6579 5f72 7361 5f63 7265 6174 652e 786d ey_rsa_create.xm │ │ │ -00225240: 6cdf 0000 0d5c 3c3f 786d 6c20 7665 7273 l....\<?xml vers │ │ │ -00225250: 696f 6e3d 2231 2e30 2220 656e 636f 6469 ion="1.0" encodi │ │ │ -00225260: 6e67 3d22 4953 4f2d 3838 3539 2d31 223f ng="ISO-8859-1"? │ │ │ -00225270: 3e0a 3c21 2d2d 0a20 2d0a 202d 2020 5468 >.<!--. -. - Th │ │ │ -00225280: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ -00225290: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ -002252a0: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ -002252b0: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ -002252c0: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ -002252d0: 0a20 2d0a 202d 2020 436f 7079 7269 6768 . -. - Copyrigh │ │ │ -002252e0: 7420 2843 2920 3139 3938 2d32 3032 3420 t (C) 1998-2024 │ │ │ -002252f0: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ -00225300: 650a 202d 0a20 2d20 2054 6869 7320 7072 e. -. - This pr │ │ │ -00225310: 6f6a 6563 7420 6973 2066 7265 6520 736f oject is free so │ │ │ -00225320: 6674 7761 7265 3b20 796f 7520 6361 6e20 ftware; you can │ │ │ -00225330: 7265 6469 7374 7269 6275 7465 2069 7420 redistribute it │ │ │ -00225340: 616e 642f 6f72 206d 6f64 6966 7920 6974 and/or modify it │ │ │ -00225350: 0a20 2d20 2075 6e64 6572 2074 6865 2074 . - under the t │ │ │ -00225360: 6572 6d73 206f 6620 7468 6520 474e 5520 erms of the GNU │ │ │ -00225370: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ -00225380: 6963 656e 7365 2061 7320 7075 626c 6973 icense as publis │ │ │ -00225390: 6865 6420 6279 2074 6865 0a20 2d20 2046 hed by the. - F │ │ │ -002253a0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ -002253b0: 6e64 6174 696f 6e3b 206f 6e6c 7920 7665 ndation; only ve │ │ │ -002253c0: 7273 696f 6e20 3220 6f66 2074 6865 204c rsion 2 of the L │ │ │ -002253d0: 6963 656e 7365 2c20 6461 7465 6420 4a75 icense, dated Ju │ │ │ -002253e0: 6e65 2031 3939 312e 0a20 2d0a 202d 2020 ne 1991.. -. - │ │ │ -002253f0: 5468 6973 2070 726f 6772 616d 2069 7320 This program is │ │ │ -00225400: 6469 7374 7269 6275 7465 6420 696e 2074 distributed in t │ │ │ -00225410: 6865 2068 6f70 6520 7468 6174 2069 7420 he hope that it │ │ │ -00225420: 7769 6c6c 2062 6520 7573 6566 756c 2c20 will be useful, │ │ │ -00225430: 6275 740a 202d 2020 5749 5448 4f55 5420 but. - WITHOUT │ │ │ -00225440: 414e 5920 5741 5252 414e 5459 3b20 7769 ANY WARRANTY; wi │ │ │ -00225450: 7468 6f75 7420 6576 656e 2074 6865 2069 thout even the i │ │ │ -00225460: 6d70 6c69 6564 2077 6172 7261 6e74 7920 mplied warranty │ │ │ -00225470: 6f66 0a20 2d20 204d 4552 4348 414e 5441 of. - MERCHANTA │ │ │ -00225480: 4249 4c49 5459 206f 7220 4649 544e 4553 BILITY or FITNES │ │ │ -00225490: 5320 464f 5220 4120 5041 5254 4943 554c S FOR A PARTICUL │ │ │ -002254a0: 4152 2050 5552 504f 5345 2e20 5365 6520 AR PURPOSE. See │ │ │ -002254b0: 7468 6520 474e 550a 202d 2020 4765 6e65 the GNU. - Gene │ │ │ -002254c0: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ -002254d0: 7365 2066 6f72 206d 6f72 6520 6465 7461 se for more deta │ │ │ -002254e0: 696c 732e 0a20 2d0a 202d 2020 596f 7520 ils.. -. - You │ │ │ -002254f0: 7368 6f75 6c64 2068 6176 6520 7265 6365 should have rece │ │ │ -00225500: 6976 6564 2061 2063 6f70 7920 6f66 2074 ived a copy of t │ │ │ -00225510: 6865 2047 4e55 2047 656e 6572 616c 2050 he GNU General P │ │ │ -00225520: 7562 6c69 6320 4c69 6365 6e73 6520 616c ublic License al │ │ │ -00225530: 6f6e 670a 202d 2020 7769 7468 2074 6869 ong. - with thi │ │ │ -00225540: 7320 7072 6f67 7261 6d3b 2069 6620 6e6f s program; if no │ │ │ -00225550: 742c 2077 7269 7465 2074 6f20 7468 6520 t, write to the │ │ │ -00225560: 4672 6565 2053 6f66 7477 6172 6520 466f Free Software Fo │ │ │ -00225570: 756e 6461 7469 6f6e 2c20 496e 632e 2c0a undation, Inc.,. │ │ │ -00225580: 202d 2020 3531 2046 7261 6e6b 6c69 6e20 - 51 Franklin │ │ │ -00225590: 5374 2c20 4669 6674 6820 466c 6f6f 722c St, Fifth Floor, │ │ │ -002255a0: 2042 6f73 746f 6e2c 204d 4120 3032 3131 Boston, MA 0211 │ │ │ -002255b0: 302d 3133 3031 2055 5341 0a20 2d0a 202d 0-1301 USA. -. - │ │ │ -002255c0: 0a2d 2d3e 0a3c 7265 6665 6e74 7279 2069 .-->.<refentry i │ │ │ -002255d0: 643d 2266 6e5f 7865 6e63 5f6b 6579 5f52 d="fn_xenc_key_R │ │ │ -002255e0: 5341 5f63 7265 6174 6522 3e0a 2020 3c72 SA_create">. <r │ │ │ -002255f0: 6566 6d65 7461 3e0a 2020 2020 3c72 6566 efmeta>. <ref │ │ │ -00225600: 656e 7472 7974 6974 6c65 3e78 656e 635f entrytitle>xenc_ │ │ │ -00225610: 6b65 795f 5253 415f 6372 6561 7465 3c2f key_RSA_create</ │ │ │ -00225620: 7265 6665 6e74 7279 7469 746c 653e 0a20 refentrytitle>. │ │ │ -00225630: 2020 203c 7265 666d 6973 6369 6e66 6f3e <refmiscinfo> │ │ │ -00225640: 6861 7368 3c2f 7265 666d 6973 6369 6e66 hash</refmiscinf │ │ │ -00225650: 6f3e 0a20 203c 2f72 6566 6d65 7461 3e0a o>. </refmeta>. │ │ │ -00225660: 2020 3c72 6566 6e61 6d65 6469 763e 0a20 <refnamediv>. │ │ │ -00225670: 2020 203c 7265 666e 616d 653e 7865 6e63 <refname>xenc │ │ │ -00225680: 5f6b 6579 5f52 5341 5f63 7265 6174 653c _key_RSA_create< │ │ │ -00225690: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. <r │ │ │ -002256a0: 6566 7075 7270 6f73 653e 5573 6564 2074 efpurpose>Used t │ │ │ -002256b0: 6f20 6d61 6b65 2052 5341 206b 6579 2e3c o make RSA key.< │ │ │ -002256c0: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -002256d0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -002256e0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -002256f0: 2020 2020 3c66 756e 6373 796e 6f70 7369 <funcsynopsi │ │ │ -00225700: 7320 6964 3d22 6673 796e 5f78 656e 635f s id="fsyn_xenc_ │ │ │ -00225710: 6b65 795f 5253 415f 6372 6561 7465 223e key_RSA_create"> │ │ │ -00225720: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . <funcprot │ │ │ -00225730: 6f74 7970 6520 6964 3d22 6670 726f 746f otype id="fproto │ │ │ -00225740: 5f78 656e 635f 6b65 795f 5253 415f 6372 _xenc_key_RSA_cr │ │ │ -00225750: 6561 7465 223e 0a20 2020 2020 2020 203c eate">. < │ │ │ -00225760: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef><functio │ │ │ -00225770: 6e3e 7865 6e63 5f6b 6579 5f52 5341 5f63 n>xenc_key_RSA_c │ │ │ -00225780: 7265 6174 653c 2f66 756e 6374 696f 6e3e reate</function> │ │ │ -00225790: 3c2f 6675 6e63 6465 663e 0a09 2020 2020 </funcdef>.. │ │ │ -002257a0: 2020 3c70 6172 616d 6465 663e 696e 203c <paramdef>in < │ │ │ -002257b0: 7061 7261 6d65 7465 723e 6e61 6d65 3c2f parameter>name</ │ │ │ -002257c0: 7061 7261 6d65 7465 723e 2076 6172 6368 parameter> varch │ │ │ -002257d0: 6172 3c2f 7061 7261 6d64 6566 3e0a 0920 ar</paramdef>.. │ │ │ -002257e0: 2020 2020 203c 7061 7261 6d64 6566 3e69 <paramdef>i │ │ │ -002257f0: 6e20 3c70 6172 616d 6574 6572 3e62 6974 n <parameter>bit │ │ │ -00225800: 733c 2f70 6172 616d 6574 6572 3e20 696e s</parameter> in │ │ │ -00225810: 743c 2f70 6172 616d 6465 663e 0a20 2020 t</paramdef>. │ │ │ -00225820: 2020 203c 2f66 756e 6370 726f 746f 7479 </funcprototy │ │ │ -00225830: 7065 3e0a 2020 2020 3c2f 6675 6e63 7379 pe>. </funcsy │ │ │ -00225840: 6e6f 7073 6973 3e0a 2020 3c2f 7265 6673 nopsis>. </refs │ │ │ -00225850: 796e 6f70 7369 7364 6976 3e0a 2020 3c72 ynopsisdiv>. <r │ │ │ -00225860: 6566 7365 6374 3120 6964 3d22 6465 7363 efsect1 id="desc │ │ │ -00225870: 5f78 656e 635f 6b65 795f 5253 415f 6372 _xenc_key_RSA_cr │ │ │ -00225880: 6561 7465 223e 0a20 2020 203c 7469 746c eate">. <titl │ │ │ -00225890: 653e 4465 7363 7269 7074 696f 6e3c 2f74 e>Description</t │ │ │ -002258a0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ -002258b0: 5573 6564 2074 6f20 6d61 6b65 2052 5341 Used to make RSA │ │ │ -002258c0: 206b 6579 2e0a 2020 2020 3c2f 7061 7261 key.. </para │ │ │ -002258d0: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ -002258e0: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ -002258f0: 7061 7261 6d73 5f78 656e 635f 6b65 795f params_xenc_key_ │ │ │ -00225900: 5253 415f 6372 6561 7465 223e 0a20 2020 RSA_create">. │ │ │ -00225910: 203c 7469 746c 653e 5061 7261 6d65 7465 <title>Paramete │ │ │ -00225920: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -00225930: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -00225940: 6e61 6d65 3c2f 7469 746c 653e 0a20 2020 name. │ │ │ -00225950: 2020 203c 7061 7261 3e54 6865 206e 616d The nam │ │ │ -00225960: 6520 6f66 2074 6865 206b 6579 2e3c 2f70 e of the key.

    . . bits</ │ │ │ -002259a0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -002259b0: 7261 3e4e 756d 6265 7220 6f66 2062 6974 ra>Number of bit │ │ │ -002259c0: 7320 696e 2067 656e 6572 6174 6564 206b s in generated k │ │ │ -002259d0: 6579 2e20 5468 6520 7661 6c75 6573 2073 ey. The values s │ │ │ -002259e0: 7570 706f 7274 6564 2061 7265 2066 726f upported are fro │ │ │ -002259f0: 6d20 3531 3220 746f 2032 3034 382e 3c2f m 512 to 2048.</ │ │ │ -00225a00: 7061 7261 3e0a 2020 2020 3c2f 7265 6673 para>. </refs │ │ │ -00225a10: 6563 7432 3e0a 2020 3c2f 7265 6673 6563 ect2>. </refsec │ │ │ -00225a20: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ -00225a30: 6964 3d22 7265 745f 7865 6e63 5f6b 6579 id="ret_xenc_key │ │ │ -00225a40: 5f52 5341 5f63 7265 6174 6522 3e3c 7469 _RSA_create"><ti │ │ │ -00225a50: 746c 653e 5265 7475 726e 2054 7970 6573 tle>Return Types │ │ │ -00225a60: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . None.. │ │ │ -00225a80: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00225a90: 3c72 6566 7365 6374 3120 6964 3d22 6578 . │ │ │ -00225ac0: 203c 7469 746c 653e 4578 616d 706c 653c Example< │ │ │ -00225ad0: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -00225ae0: 6d70 6c65 2069 643d 2265 785f 7865 6e63 mple id="ex_xenc │ │ │ -00225af0: 5f6b 6579 5f52 5341 5f63 7265 6174 6522 _key_RSA_create" │ │ │ -00225b00: 3e3c 7469 746c 653e 5369 6d70 6c65 2055 ><title>Simple U │ │ │ -00225b10: 7365 3c2f 7469 746c 653e 0a20 2020 2020 se. │ │ │ -00225b20: 203c 7363 7265 656e 3e3c 215b 4344 4154 │ │ │ -00225b60: 0a3c 2f73 6372 6565 6e3e 0a20 2020 203c .. < │ │ │ -00225b70: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. . . See Also. xe │ │ │ -00225c10: 6e63 5f6b 6579 5f33 4445 535f 6372 6561 nc_key_3DES_crea │ │ │ -00225c20: 7465 2829 3c2f 6675 6e63 7469 6f6e 3e3c te()< │ │ │ -00225c30: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00225c40: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 x │ │ │ -00225c80: 656e 635f 6b65 795f 3364 6573 5f72 616e enc_key_3des_ran │ │ │ -00225c90: 645f 6372 6561 7465 2829 3c2f 6675 6e63 d_create(). x │ │ │ -00225cf0: 656e 635f 6b65 795f 6165 735f 6372 6561 enc_key_aes_crea │ │ │ -00225d00: 7465 2829 3c2f 6675 6e63 7469 6f6e 3e3c te()< │ │ │ -00225d10: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00225d20: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xenc_key │ │ │ -00225d60: 5f33 4445 535f 7265 6164 2829 3c2f 6675 _3DES_read(). │ │ │ -00225d90: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 x │ │ │ -00225dc0: 656e 635f 6b65 795f 4453 415f 7265 6164 enc_key_DSA_read │ │ │ -00225dd0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ -00225df0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xenc_key_RS │ │ │ -00225e30: 415f 7265 6164 2829 3c2f 6675 6e63 7469 A_read(). xe │ │ │ -00225e90: 6e63 5f6b 6579 5f63 7265 6174 655f 6365 nc_key_create_ce │ │ │ -00225ea0: 7274 2829 3c2f 6675 6e63 7469 6f6e 3e3c rt()< │ │ │ -00225eb0: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00225ec0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xenc_key │ │ │ -00225f00: 5f73 6572 6961 6c69 7a65 2829 3c2f 6675 _serialize(). │ │ │ -00225f30: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xen │ │ │ -00225f60: 635f 6b65 795f 7265 6d6f 7665 2829 3c2f c_key_remove() │ │ │ -00225f80: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . ......'demo/docs │ │ │ -00225fb0: 7263 2f66 756e 6372 6566 2f78 656e 635f rc/funcref/xenc_ │ │ │ -00225fc0: 6b65 795f 7265 6d6f 7665 2e78 6d6c df00 key_remove.xml.. │ │ │ -00225fd0: 0008 dc3c 3f78 6d6c 2076 6572 7369 6f6e ....< │ │ │ -00226000: 212d 2d0a 202d 2020 0a20 2d20 2054 6869 !--. - . - Thi │ │ │ -00226010: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ -00226020: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ -00226030: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ -00226040: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ -00226050: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ -00226060: 202d 2020 0a20 2d20 2043 6f70 7972 6967 - . - Copyrig │ │ │ -00226070: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -00226080: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -00226090: 7265 0a20 2d20 200a 202d 2020 5468 6973 re. - . - This │ │ │ -002260a0: 2070 726f 6a65 6374 2069 7320 6672 6565 project is free │ │ │ -002260b0: 2073 6f66 7477 6172 653b 2079 6f75 2063 software; you c │ │ │ -002260c0: 616e 2072 6564 6973 7472 6962 7574 6520 an redistribute │ │ │ -002260d0: 6974 2061 6e64 2f6f 7220 6d6f 6469 6679 it and/or modify │ │ │ -002260e0: 2069 740a 202d 2020 756e 6465 7220 7468 it. - under th │ │ │ -002260f0: 6520 7465 726d 7320 6f66 2074 6865 2047 e terms of the G │ │ │ -00226100: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ -00226110: 6320 4c69 6365 6e73 6520 6173 2070 7562 c License as pub │ │ │ -00226120: 6c69 7368 6564 2062 7920 7468 650a 202d lished by the. - │ │ │ -00226130: 2020 4672 6565 2053 6f66 7477 6172 6520 Free Software │ │ │ -00226140: 466f 756e 6461 7469 6f6e 3b20 6f6e 6c79 Foundation; only │ │ │ -00226150: 2076 6572 7369 6f6e 2032 206f 6620 7468 version 2 of th │ │ │ -00226160: 6520 4c69 6365 6e73 652c 2064 6174 6564 e License, dated │ │ │ -00226170: 204a 756e 6520 3139 3931 2e0a 202d 2020 June 1991.. - │ │ │ -00226180: 0a20 2d20 2054 6869 7320 7072 6f67 7261 . - This progra │ │ │ -00226190: 6d20 6973 2064 6973 7472 6962 7574 6564 m is distributed │ │ │ -002261a0: 2069 6e20 7468 6520 686f 7065 2074 6861 in the hope tha │ │ │ -002261b0: 7420 6974 2077 696c 6c20 6265 2075 7365 t it will be use │ │ │ -002261c0: 6675 6c2c 2062 7574 0a20 2d20 2057 4954 ful, but. - WIT │ │ │ -002261d0: 484f 5554 2041 4e59 2057 4152 5241 4e54 HOUT ANY WARRANT │ │ │ -002261e0: 593b 2077 6974 686f 7574 2065 7665 6e20 Y; without even │ │ │ -002261f0: 7468 6520 696d 706c 6965 6420 7761 7272 the implied warr │ │ │ -00226200: 616e 7479 206f 660a 202d 2020 4d45 5243 anty of. - MERC │ │ │ -00226210: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -00226220: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -00226230: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -00226240: 2053 6565 2074 6865 2047 4e55 0a20 2d20 See the GNU. - │ │ │ -00226250: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ -00226260: 4c69 6365 6e73 6520 666f 7220 6d6f 7265 License for more │ │ │ -00226270: 2064 6574 6169 6c73 2e0a 202d 2020 0a20 details.. - . │ │ │ -00226280: 2d20 2059 6f75 2073 686f 756c 6420 6861 - You should ha │ │ │ -00226290: 7665 2072 6563 6569 7665 6420 6120 636f ve received a co │ │ │ -002262a0: 7079 206f 6620 7468 6520 474e 5520 4765 py of the GNU Ge │ │ │ -002262b0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ -002262c0: 656e 7365 2061 6c6f 6e67 0a20 2d20 2077 ense along. - w │ │ │ -002262d0: 6974 6820 7468 6973 2070 726f 6772 616d ith this program │ │ │ -002262e0: 3b20 6966 206e 6f74 2c20 7772 6974 6520 ; if not, write │ │ │ -002262f0: 746f 2074 6865 2046 7265 6520 536f 6674 to the Free Soft │ │ │ -00226300: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ -00226310: 2049 6e63 2e2c 0a20 2d20 2035 3120 4672 Inc.,. - 51 Fr │ │ │ -00226320: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ -00226330: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ -00226340: 4d41 2030 3231 3130 2d31 3330 3120 5553 MA 02110-1301 US │ │ │ -00226350: 410a 202d 2020 0a20 2d20 200a 2d2d 3e0a A. - . - .-->. │ │ │ -00226360: 3c72 6566 656e 7472 7920 6964 3d22 666e . . │ │ │ -00226390: 2020 203c 7265 6665 6e74 7279 7469 746c xenc_key_remov │ │ │ -002263b0: 653c 2f72 6566 656e 7472 7974 6974 6c65 e. hash.
    . . x │ │ │ -00226410: 656e 635f 6b65 795f 7265 6d6f 7665 3c2f enc_key_remove. This wi │ │ │ -00226440: 6c6c 2064 656c 6574 6520 6120 6b65 7920 ll delete a key │ │ │ -00226450: 6672 6f6d 2063 7572 7265 6e74 2075 7365 from current use │ │ │ -00226460: 7227 7320 7370 6163 652e 3c2f 7265 6670 r's space.. . . < │ │ │ -002264a0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -002264b0: 2266 7379 6e5f 7865 6e63 5f6b 6579 5f72 "fsyn_xenc_key_r │ │ │ -002264c0: 656d 6f76 6522 3e0a 2020 2020 2020 3c66 emove">. . │ │ │ -00226500: 2020 3c66 756e 6364 6566 3e3c 6675 6e63 xenc_key_re │ │ │ -00226520: 6d6f 7665 3c2f 6675 6e63 7469 6f6e 3e3c move< │ │ │ -00226530: 2f66 756e 6364 6566 3e0a 093c 7061 7261 /funcdef>..in key_name
    varchar< │ │ │ -00226570: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -00226580: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . │ │ │ -002265e0: 0a20 2020 203c 7469 746c 653e 4465 7363 . Desc │ │ │ -002265f0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -00226600: 2020 2020 3c70 6172 613e 5468 6973 2077 This w │ │ │ -00226610: 696c 6c20 6465 6c65 7465 2061 206b 6579 ill delete a key │ │ │ -00226620: 2066 726f 6d20 6375 7272 656e 7420 7573 from current us │ │ │ -00226630: 6572 2773 2073 7061 6365 2e3c 2f70 6172 er's space.. │ │ │ -00226650: 0a20 203c 7265 6673 6563 7431 2069 643d . . Parameters< │ │ │ -00226690: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. key │ │ │ -002266b0: 5f6e 616d 653c 2f74 6974 6c65 3e0a 2020 _name. │ │ │ -002266c0: 2020 2020 3c70 6172 613e 5468 6520 6e61 The na │ │ │ -002266d0: 6d65 206f 6620 7468 6520 6b65 792e 3c2f me of the key.. . . . │ │ │ -00226730: 2020 203c 7469 746c 653e 4578 616d 706c Exampl │ │ │ -00226740: 653c 2f74 6974 6c65 3e0a 2020 2020 3c65 e. < │ │ │ -00226770: 7469 746c 653e 5369 6d70 6c65 2055 7365 title>Simple Use │ │ │ -00226780: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -00226790: 7363 7265 656e 3e3c 215b 4344 4154 415b screen>.. │ │ │ -002267d0: 2020 2020 3c2f 6578 616d 706c 653e 0a20 . │ │ │ -002267e0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -002267f0: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ -00226800: 616c 736f 5f78 656e 635f 6b65 795f 7265 also_xenc_key_re │ │ │ -00226810: 6d6f 7665 223e 0a20 2020 203c 7469 746c move">. See Also.
  • │ │ │ -00226860: 3c66 756e 6374 696f 6e3e 7865 6e63 5f6b xenc_k │ │ │ -00226870: 6579 5f65 7869 7374 7328 293c 2f66 756e ey_exists()

    . ... │ │ │ -002268b0: 0000 002c 6465 6d6f 2f64 6f63 7372 632f ...,demo/docsrc/ │ │ │ -002268c0: 6675 6e63 7265 662f 7865 6e63 5f6b 6579 funcref/xenc_key │ │ │ -002268d0: 5f69 6e73 745f 6372 6561 7465 2e78 6d6c _inst_create.xml │ │ │ -002268e0: df00 000b e23c 3f78 6d6c 2076 6572 7369 ..... │ │ │ -00226910: 0a3c 212d 2d0a 202d 2020 0a20 2d20 2054 ... . xenc_key_ │ │ │ -002278d0: 6578 6973 7473 3c2f 7265 6665 6e74 7279 exists. hash. . . xenc_key_exi │ │ │ -00227940: 7374 733c 2f72 6566 6e61 6d65 3e0a 2020 sts. │ │ │ -00227950: 2020 3c72 6566 7075 7270 6f73 653e 4368 Ch │ │ │ -00227960: 6563 6b20 6966 206e 616d 6564 2065 6e63 eck if named enc │ │ │ -00227970: 7279 7074 696f 6e20 6b65 7920 6973 2069 ryption key is i │ │ │ -00227980: 6e20 7468 6520 2075 7365 7227 7320 7265 n the user's re │ │ │ -00227990: 706f 7369 746f 7279 3c2f 7265 6670 7572 pository. . . . . │ │ │ -00227a30: 3c66 756e 6364 6566 3e69 6e74 203c 6675 int xenc_key_ │ │ │ -00227a50: 6578 6973 7473 3c2f 6675 6e63 7469 6f6e exists
    ..in name varchar

    . < │ │ │ -00227ab0: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ -00227ac0: 2020 2020 3c2f 6675 6e63 7379 6e6f 7073 . . . │ │ │ -00227b10: 2020 203c 7469 746c 653e 4465 7363 7269 Descri │ │ │ -00227b20: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -00227b30: 2020 3c70 6172 613e 5468 6520 6675 6e63 The func │ │ │ -00227b40: 7469 6f6e 2063 6865 636b 7320 6966 206b tion checks if k │ │ │ -00227b50: 6579 2077 6974 6820 6769 7665 6e20 6e61 ey with given na │ │ │ -00227b60: 6d65 2065 7869 7374 7320 696e 2074 6865 me exists in the │ │ │ -00227b70: 2075 7365 7227 7320 6b65 7973 2e3c 2f70 user's keys.

    . . . │ │ │ -00227bc0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ -00227bd0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. n │ │ │ -00227bf0: 616d 653c 2f74 6974 6c65 3e0a 2020 2020 ame. │ │ │ -00227c00: 2020 3c70 6172 613e 5468 6520 6e61 6d65 The name │ │ │ -00227c10: 206f 6620 7468 6520 6b65 793c 2f70 6172 of the key. . │ │ │ -00227c40: 0a20 203c 7265 6673 6563 7431 2069 643d . Ret │ │ │ -00227c70: 7572 6e20 5479 7065 733c 2f74 6974 6c65 urn Types. Th │ │ │ -00227c90: 6520 6675 6e63 7469 6f6e 2072 6574 7572 e function retur │ │ │ -00227ca0: 6e73 2069 6e74 6567 6572 2031 202d 2074 ns integer 1 - t │ │ │ -00227cb0: 7275 6520 6f72 2030 202d 2066 616c 7365 rue or 0 - false │ │ │ -00227cc0: 2028 7a65 726f 2920 6966 206b 6579 2065 (zero) if key e │ │ │ -00227cd0: 7869 7374 7320 6f72 206e 6f74 3c2f 7061 xists or not
    . . . │ │ │ -00227d20: 203c 7469 746c 653e 4578 616d 706c 6573 Examples │ │ │ -00227d30: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Simple Use< │ │ │ -00227d70: 2f74 6974 6c65 3e0a 2020 2020 2020 3c73 /title>. select xenc │ │ │ -00227da0: 5f6b 6579 5f65 7869 7374 7320 2827 4d79 _key_exists ('My │ │ │ -00227db0: 4b65 7927 293b 0a56 4152 4348 4152 0a5f Key');.VARCHAR._ │ │ │ +00212320: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a _______________. │ │ │ +00212330: 0a30 0a0a 3120 526f 7773 2e20 2d2d 2030 .0..1 Rows. -- 0 │ │ │ +00212340: 3030 3030 206d 7365 632e 0a5d 5d3e 0a3c 0000 msec..]]>.< │ │ │ +00212350: 2f73 6372 6565 6e3e 0a20 2020 203c 2f65 /screen>. . . . See Also. XMLType.isSch │ │ │ +00212410: 656d 6156 616c 6964 6174 6564 2829 3c2f emaValidated() │ │ │ +00212430: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . │ │ │ +00212470: 3c66 756e 6374 696f 6e3e 584d 4c54 7970 XMLTyp │ │ │ +00212480: 652e 7365 7453 6368 656d 6156 616c 6964 e.setSchemaValid │ │ │ +00212490: 6174 6564 2829 3c2f 6675 6e63 7469 6f6e ated(). │ │ │ +002124b0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 XM │ │ │ +002124f0: 4c54 7970 652e 7363 6865 6d61 5661 6c69 LType.schemaVali │ │ │ +00212500: 6461 7465 2829 3c2f 6675 6e63 7469 6f6e date(). │ │ │ +00212520: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......%d │ │ │ +00212540: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ +00212550: 6566 2f76 645f 7374 6174 6973 7469 6373 ef/vd_statistics │ │ │ +00212560: 2e78 6d6c df00 000c e33c 3f78 6d6c 2076 .xml........ . vd_statist │ │ │ +00212940: 6963 733c 2f72 6566 656e 7472 7974 6974 ics. rmt. . . │ │ │ +002129a0: 5644 5f53 5441 5449 5354 4943 533c 2f72 VD_STATISTICS. Update V │ │ │ +002129d0: 4442 2052 5043 2063 6f73 7420 7374 6174 DB RPC cost stat │ │ │ +002129e0: 6973 7469 6373 2066 6f72 2067 6976 656e istics for given │ │ │ +002129f0: 2044 534e 3c2f 7265 6670 7572 706f 7365 DSN. . . . │ │ │ +00212a50: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +00212a80: 2020 2020 2020 2020 3c66 756e 6364 6566 DB.DBA.VD_STATISTICS< │ │ │ +00212ab0: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>.. │ │ │ +00212ad0: 3c6f 7074 696f 6e61 6c3e 696e 203c 7061 in _dsn varchar │ │ │ +00212b00: 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 6172 ..in < │ │ │ +00212b30: 7061 7261 6d65 7465 723e 7664 5f74 6162 parameter>vd_tab │ │ │ +00212b40: 6c65 5f6d 6173 6b3c 2f70 6172 616d 6574 le_mask varchar. . . < │ │ │ +00212ba0: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ +00212bb0: 0a20 203c 7265 6673 6563 7431 2069 643d . . Description</ti │ │ │ +00212bf0: 746c 653e 0a20 2020 203c 7061 7261 3e54 tle>. <para>T │ │ │ +00212c00: 6869 7320 7072 6f63 6564 7572 6520 7769 his procedure wi │ │ │ +00212c10: 6c6c 2075 7064 6174 6520 7468 6520 5250 ll update the RP │ │ │ +00212c20: 4320 726f 756e 642d 7472 6970 2073 7461 C round-trip sta │ │ │ +00212c30: 7469 7374 6963 7320 666f 720a 0973 656c tistics for..sel │ │ │ +00212c40: 6563 7465 6420 6461 7461 2073 6f75 7263 ected data sourc │ │ │ +00212c50: 6573 2e3c 2f70 6172 613e 0a20 203c 2f72 es.</para>. </r │ │ │ +00212c60: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ +00212c70: 6563 7431 2069 643d 2270 6172 616d 735f ect1 id="params_ │ │ │ +00212c80: 7664 5f73 7461 7469 7374 6963 7322 3e0a vd_statistics">. │ │ │ +00212c90: 2020 2020 3c74 6974 6c65 3e50 6172 616d <title>Param │ │ │ +00212ca0: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ +00212cb0: 2020 3c72 6566 7365 6374 323e 3c74 6974 _dsn. │ │ │ +00212cd0: 2020 2020 2020 3c70 6172 613e 5468 6973 This │ │ │ +00212ce0: 2070 6172 616d 6574 6572 2069 7320 6120 parameter is a │ │ │ +00212cf0: 4c49 4b45 206d 6173 6b20 666f 7220 7468 LIKE mask for th │ │ │ +00212d00: 6520 6e61 6d65 206f 6620 7468 6520 6461 e name of the da │ │ │ +00212d10: 7461 2073 6f75 7263 652c 0a09 2020 6173 ta source,.. as │ │ │ +00212d20: 2073 746f 7265 6420 696e 2044 535f 4453 stored in DS_DS │ │ │ +00212d30: 4e20 636f 6c75 6d6e 206f 6620 5359 535f N column of SYS_ │ │ │ +00212d40: 4441 5441 5f53 4f55 5243 4520 7379 7374 DATA_SOURCE syst │ │ │ +00212d50: 656d 2074 6162 6c65 2e20 2049 7473 0a09 em table. Its.. │ │ │ +00212d60: 2020 6465 6661 756c 7420 7661 6c75 6520 default value │ │ │ +00212d70: 6f66 2027 2527 206d 6561 6e73 2075 7064 of '%' means upd │ │ │ +00212d80: 6174 6520 7468 6520 2272 6f75 6e64 2d74 ate the "round-t │ │ │ +00212d90: 7269 7022 2074 696d 6573 2066 6f72 2061 rip" times for a │ │ │ +00212da0: 6c6c 0a09 2020 7265 6d6f 7465 2064 6174 ll.. remote dat │ │ │ +00212db0: 6120 736f 7572 6365 732e 3c2f 7061 7261 a sources.. . │ │ │ +00212de0: 3c74 6974 6c65 3e76 645f 7461 626c 655f vd_table_ │ │ │ +00212df0: 6d61 736b 3c2f 7469 746c 653e 0a20 2020 mask. │ │ │ +00212e00: 2020 203c 7061 7261 3e54 6869 7320 7061 This pa │ │ │ +00212e10: 7261 6d65 7465 7220 6973 2061 204c 494b rameter is a LIK │ │ │ +00212e20: 4520 6d61 736b 2066 6f72 2074 6865 206e E mask for the n │ │ │ +00212e30: 616d 6520 6f66 2074 6865 2074 6162 6c65 ame of the table │ │ │ +00212e40: 202c 0a09 2020 6173 2073 746f 7265 6420 ,.. as stored │ │ │ +00212e50: 696e 2052 545f 4e41 4d45 2063 6f6c 756d in RT_NAME colum │ │ │ +00212e60: 6e20 6f66 2053 5953 5f44 4154 415f 534f n of SYS_DATA_SO │ │ │ +00212e70: 5552 4345 2073 7973 7465 6d20 7461 626c URCE system tabl │ │ │ +00212e80: 652e 2020 4974 730a 0920 2064 6566 6175 e. Its.. defau │ │ │ +00212e90: 6c74 2076 616c 7565 206f 6620 2725 2720 lt value of '%' │ │ │ +00212ea0: 6d65 616e 7320 7570 6461 7465 2061 6c6c means update all │ │ │ +00212eb0: 2074 6162 6c65 732e 3c2f 7061 7261 3e0a tables.. │ │ │ +00212ec0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ +00212ed0: 2020 3c2f 7265 6673 6563 7431 3e0a 3c21 .Retu │ │ │ +00212f10: 726e 2054 7970 6573 3c2f 7469 746c 653e rn Types │ │ │ +00212f20: 0a20 2020 203c 7061 7261 3e3c 2f70 6172 . . │ │ │ +00212f40: 0a20 203c 7265 6673 6563 7431 2069 643d . . Errors.. In case of n │ │ │ +00212f90: 6f6e 2d66 756e 6374 696f 6e2d 7370 6563 on-function-spec │ │ │ +00212fa0: 6966 6963 2065 7272 6f72 732c 2069 2e65 ific errors, i.e │ │ │ +00212fb0: 2e20 6f6e 6c79 2063 6f6d 6d6f 6e0a 2020 . only common. │ │ │ +00212fc0: 2020 2070 6172 616d 6574 6572 2065 7272 parameter err │ │ │ +00212fd0: 6f72 7320 6172 6520 7369 676e 616c 6c65 ors are signalle │ │ │ +00212fe0: 642c 2063 6f6d 6d65 6e74 206f 7574 2074 d, comment out t │ │ │ +00212ff0: 6865 2074 6162 6c65 2062 656c 6f77 0a20 he table below. │ │ │ +00213000: 2020 2020 6f74 6865 7277 6973 6520 6164 otherwise ad │ │ │ +00213010: 6420 7468 6520 756e 6971 7565 2065 7272 d the unique err │ │ │ +00213020: 6f72 2076 616c 7565 7320 6173 2069 6e64 or values as ind │ │ │ +00213030: 6976 6964 7561 6c20 6572 726f 7263 6f64 ividual errorcod │ │ │ +00213040: 6573 0a0a 2020 2020 3c70 6172 613e 5468 es.. Th │ │ │ +00213050: 6973 2066 756e 6374 696f 6e20 6361 6e20 is function can │ │ │ +00213060: 6765 6e65 7261 7465 2074 6865 2066 6f6c generate the fol │ │ │ +00213070: 6c6f 7769 6e67 2065 7272 6f72 733a 3c2f lowing errors:. . . │ │ │ +002130b0: 2020 3c72 6566 7365 6374 3120 6964 3d22 . Examples. < │ │ │ +00213120: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +00213130: 6172 613e 3c2f 7061 7261 3e0a 2020 2020 ara></para>. │ │ │ +00213140: 2020 3c73 6372 6565 6e3e 3c21 5b43 4441 <screen><![CDA │ │ │ +00213150: 5441 5b0a 5d5d 3e0a 3c2f 7363 7265 656e TA[.]]>.</screen │ │ │ +00213160: 3e0a 2020 2020 3c2f 6578 616d 706c 653e >. </example> │ │ │ +00213170: 0a20 203c 2f72 6566 7365 6374 313e 0a2d . </refsect1>.- │ │ │ +00213180: 2d3e 2020 3c72 6566 7365 6374 3120 6964 -> <refsect1 id │ │ │ +00213190: 3d22 7365 6561 6c73 6f5f 7664 5f73 7461 ="seealso_vd_sta │ │ │ +002131a0: 7469 7374 6963 7322 3e0a 2020 2020 3c74 tistics">. <t │ │ │ +002131b0: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ +002131c0: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +002131d0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ +002131e0: 6e5f 7664 645f 6d65 6173 7572 655f 7270 n_vdd_measure_rp │ │ │ +002131f0: 635f 7469 6d65 223e 3c66 756e 6374 696f c_time"><functio │ │ │ +00213200: 6e3e 7664 645f 6d65 6173 7572 655f 7270 n>vdd_measure_rp │ │ │ +00213210: 635f 7469 6d65 2829 3c2f 6675 6e63 7469 c_time()</functi │ │ │ +00213220: 6f6e 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 on></link></para │ │ │ +00213230: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ +00213240: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 </refentry>..... │ │ │ +00213250: 2664 656d 6f2f 646f 6373 7263 2f66 756e &demo/docsrc/fun │ │ │ +00213260: 6372 6566 2f72 6466 5f71 7561 645f 7572 cref/rdf_quad_ur │ │ │ +00213270: 695f 6c2e 786d 6cdf 0000 11ae 3c3f 786d i_l.xml.....<?xm │ │ │ +00213280: 6c20 7665 7273 696f 6e3d 2231 2e30 2220 l version="1.0" │ │ │ +00213290: 656e 636f 6469 6e67 3d22 4953 4f2d 3838 encoding="ISO-88 │ │ │ +002132a0: 3539 2d31 223f 3e0a 3c21 2d2d 0a20 2d0a 59-1"?>.<!--. -. │ │ │ +002132b0: 202d 2020 5468 6973 2066 696c 6520 6973 - This file is │ │ │ +002132c0: 2070 6172 7420 6f66 2074 6865 204f 7065 part of the Ope │ │ │ +002132d0: 6e4c 696e 6b20 536f 6674 7761 7265 2056 nLink Software V │ │ │ +002132e0: 6972 7475 6f73 6f20 4f70 656e 2d53 6f75 irtuoso Open-Sou │ │ │ +002132f0: 7263 6520 2856 4f53 290a 202d 2020 7072 rce (VOS). - pr │ │ │ +00213300: 6f6a 6563 742e 0a20 2d0a 202d 2020 436f oject.. -. - Co │ │ │ +00213310: 7079 7269 6768 7420 2843 2920 3139 3938 pyright (C) 1998 │ │ │ +00213320: 2d32 3032 3420 4f70 656e 4c69 6e6b 2053 -2024 OpenLink S │ │ │ +00213330: 6f66 7477 6172 650a 202d 0a20 2d20 2054 oftware. -. - T │ │ │ +00213340: 6869 7320 7072 6f6a 6563 7420 6973 2066 his project is f │ │ │ +00213350: 7265 6520 736f 6674 7761 7265 3b20 796f ree software; yo │ │ │ +00213360: 7520 6361 6e20 7265 6469 7374 7269 6275 u can redistribu │ │ │ +00213370: 7465 2069 7420 616e 642f 6f72 206d 6f64 te it and/or mod │ │ │ +00213380: 6966 7920 6974 0a20 2d20 2075 6e64 6572 ify it. - under │ │ │ +00213390: 2074 6865 2074 6572 6d73 206f 6620 7468 the terms of th │ │ │ +002133a0: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ +002133b0: 626c 6963 204c 6963 656e 7365 2061 7320 blic License as │ │ │ +002133c0: 7075 626c 6973 6865 6420 6279 2074 6865 published by the │ │ │ +002133d0: 0a20 2d20 2046 7265 6520 536f 6674 7761 . - Free Softwa │ │ │ +002133e0: 7265 2046 6f75 6e64 6174 696f 6e3b 206f re Foundation; o │ │ │ +002133f0: 6e6c 7920 7665 7273 696f 6e20 3220 6f66 nly version 2 of │ │ │ +00213400: 2074 6865 204c 6963 656e 7365 2c20 6461 the License, da │ │ │ +00213410: 7465 6420 4a75 6e65 2031 3939 312e 0a20 ted June 1991.. │ │ │ +00213420: 2d0a 202d 2020 5468 6973 2070 726f 6772 -. - This progr │ │ │ +00213430: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ +00213440: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ +00213450: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ +00213460: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ +00213470: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ +00213480: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ +00213490: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ +002134a0: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ +002134b0: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ +002134c0: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ +002134d0: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ +002134e0: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ +002134f0: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ +00213500: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ +00213510: 6520 6465 7461 696c 732e 0a20 2d0a 202d e details.. -. - │ │ │ +00213520: 2020 596f 7520 7368 6f75 6c64 2068 6176 You should hav │ │ │ +00213530: 6520 7265 6365 6976 6564 2061 2063 6f70 e received a cop │ │ │ +00213540: 7920 6f66 2074 6865 2047 4e55 2047 656e y of the GNU Gen │ │ │ +00213550: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ +00213560: 6e73 6520 616c 6f6e 670a 202d 2020 7769 nse along. - wi │ │ │ +00213570: 7468 2074 6869 7320 7072 6f67 7261 6d3b th this program; │ │ │ +00213580: 2069 6620 6e6f 742c 2077 7269 7465 2074 if not, write t │ │ │ +00213590: 6f20 7468 6520 4672 6565 2053 6f66 7477 o the Free Softw │ │ │ +002135a0: 6172 6520 466f 756e 6461 7469 6f6e 2c20 are Foundation, │ │ │ +002135b0: 496e 632e 2c0a 202d 2020 3531 2046 7261 Inc.,. - 51 Fra │ │ │ +002135c0: 6e6b 6c69 6e20 5374 2c20 4669 6674 6820 nklin St, Fifth │ │ │ +002135d0: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d Floor, Boston, M │ │ │ +002135e0: 4120 3032 3131 302d 3133 3031 2055 5341 A 02110-1301 USA │ │ │ +002135f0: 0a20 2d0a 2d2d 3e0a 3c72 6566 656e 7472 . -.-->.<refentr │ │ │ +00213600: 7920 6964 3d22 666e 5f72 6466 5f71 7561 y id="fn_rdf_qua │ │ │ +00213610: 645f 7572 695f 6c22 3e0a 2020 3c72 6566 d_uri_l">. <ref │ │ │ +00213620: 6d65 7461 3e0a 2020 2020 3c72 6566 656e meta>. <refen │ │ │ +00213630: 7472 7974 6974 6c65 3e44 422e 4442 412e trytitle>DB.DBA. │ │ │ +00213640: 5244 465f 5155 4144 5f55 5249 5f4c 3c2f RDF_QUAD_URI_L</ │ │ │ +00213650: 7265 6665 6e74 7279 7469 746c 653e 0a20 refentrytitle>. │ │ │ +00213660: 2020 203c 7265 666d 6973 6369 6e66 6f3e <refmiscinfo> │ │ │ +00213670: 7264 663c 2f72 6566 6d69 7363 696e 666f rdf</refmiscinfo │ │ │ +00213680: 3e0a 2020 3c2f 7265 666d 6574 613e 0a20 >. </refmeta>. │ │ │ +00213690: 203c 7265 666e 616d 6564 6976 3e0a 2020 <refnamediv>. │ │ │ +002136a0: 2020 3c72 6566 6e61 6d65 3e44 422e 4442 <refname>DB.DB │ │ │ +002136b0: 412e 5244 465f 5155 4144 5f55 5249 5f4c A.RDF_QUAD_URI_L │ │ │ +002136c0: 3c2f 7265 666e 616d 653e 0a20 2020 203c </refname>. < │ │ │ +002136d0: 7265 6670 7572 706f 7365 3e50 6572 666f refpurpose>Perfo │ │ │ +002136e0: 726d 7320 7369 6d70 6c65 2069 6e73 6572 rms simple inser │ │ │ +002136f0: 7469 6f6e 206f 6620 6120 7175 6164 2077 tion of a quad w │ │ │ +00213700: 6865 7265 206f 626a 6563 7420 6973 2061 here object is a │ │ │ +00213710: 206c 6974 6572 616c 2076 616c 7565 2069 literal value i │ │ │ +00213720: 6e20 2753 514c 2076 616c 6d6f 6465 272e n 'SQL valmode'. │ │ │ +00213730: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 </refpurpose>. │ │ │ +00213740: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 </refnamediv>. │ │ │ +00213750: 3c72 6566 7379 6e6f 7073 6973 6469 763e <refsynopsisdiv> │ │ │ +00213760: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . <funcsynops │ │ │ +00213770: 6973 2069 643d 2266 7379 6e5f 7264 665f is id="fsyn_rdf_ │ │ │ +00213780: 7175 6164 5f75 7269 5f6c 223e 0a20 2020 quad_uri_l">. │ │ │ +00213790: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ +002137a0: 6520 6964 3d22 6670 726f 746f 5f72 6466 e id="fproto_rdf │ │ │ +002137b0: 5f71 7561 645f 7572 695f 6c22 3e0a 2020 _quad_uri_l">. │ │ │ +002137c0: 2020 2020 2020 3c66 756e 6364 6566 3e3c <funcdef>< │ │ │ +002137d0: 6675 6e63 7469 6f6e 3e44 422e 4442 412e function>DB.DBA. │ │ │ +002137e0: 5244 465f 5155 4144 5f55 5249 5f4c 3c2f RDF_QUAD_URI_L</ │ │ │ +002137f0: 6675 6e63 7469 6f6e 3e3c 2f66 756e 6364 function></funcd │ │ │ +00213800: 6566 3e0a 093c 7061 7261 6d64 6566 3e69 ef>..<paramdef>i │ │ │ +00213810: 6e20 3c70 6172 616d 6574 6572 3e67 5f75 n <parameter>g_u │ │ │ +00213820: 7269 3c2f 7061 7261 6d65 7465 723e 2076 ri</parameter> v │ │ │ +00213830: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar</paramdef │ │ │ +00213840: 3e0a 093c 7061 7261 6d64 6566 3e69 6e20 >..<paramdef>in │ │ │ +00213850: 3c70 6172 616d 6574 6572 3e73 5f75 7269 <parameter>s_uri │ │ │ +00213860: 3c2f 7061 7261 6d65 7465 723e 2076 6172 </parameter> var │ │ │ +00213870: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char</paramdef>. │ │ │ +00213880: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .<paramdef>in <p │ │ │ +00213890: 6172 616d 6574 6572 3e70 5f75 7269 3c2f arameter>p_uri</ │ │ │ +002138a0: 7061 7261 6d65 7465 723e 2076 6172 6368 parameter> varch │ │ │ +002138b0: 6172 3c2f 7061 7261 6d64 6566 3e0a 093c ar</paramdef>..< │ │ │ +002138c0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in <par │ │ │ +002138d0: 616d 6574 6572 3e6f 5f6c 6974 3c2f 7061 ameter>o_lit</pa │ │ │ +002138e0: 7261 6d65 7465 723e 2061 6e79 3c2f 7061 rameter> any</pa │ │ │ +002138f0: 7261 6d64 6566 3e0a 2020 2020 2020 3c2f ramdef>. </ │ │ │ +00213900: 6675 6e63 7072 6f74 6f74 7970 653e 0a20 funcprototype>. │ │ │ +00213910: 2020 203c 2f66 756e 6373 796e 6f70 7369 </funcsynopsi │ │ │ +00213920: 733e 0a20 203c 2f72 6566 7379 6e6f 7073 s>. </refsynops │ │ │ +00213930: 6973 6469 763e 0a20 203c 7265 6673 6563 isdiv>. <refsec │ │ │ +00213940: 7431 2069 643d 2264 6573 635f 7264 665f t1 id="desc_rdf_ │ │ │ +00213950: 7175 6164 5f75 7269 5f6c 223e 0a20 2020 quad_uri_l">. │ │ │ +00213960: 203c 7469 746c 653e 4465 7363 7269 7074 <title>Descript │ │ │ +00213970: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ +00213980: 3c70 6172 613e 5065 7266 6f72 6d73 2073 Performs s │ │ │ +00213990: 696d 706c 6520 696e 7365 7274 696f 6e20 imple insertion │ │ │ +002139a0: 6f66 2061 2071 7561 6420 7768 6572 6520 of a quad where │ │ │ +002139b0: 6f62 6a65 6374 2069 7320 6120 6c69 7465 object is a lite │ │ │ +002139c0: 7261 6c20 7661 6c75 6520 696e 2027 5351 ral value in 'SQ │ │ │ +002139d0: 4c20 7661 6c6d 6f64 6527 2e20 5468 6520 L valmode'. The │ │ │ +002139e0: 6172 6775 6d65 6e74 7320 675f 7572 692c arguments g_uri, │ │ │ +002139f0: 2073 5f75 7269 2061 6e64 2070 5f75 7269 s_uri and p_uri │ │ │ +00213a00: 2073 686f 756c 6420 6265 2049 5249 2073 should be IRI s │ │ │ +00213a10: 7472 696e 6773 206f 7220 4952 495f 4944 trings or IRI_ID │ │ │ +00213a20: 732e 2041 6c6c 2073 7472 696e 6720 6172 s. All string ar │ │ │ +00213a30: 6775 6d65 6e74 7320 7368 6f75 6c64 2062 guments should b │ │ │ +00213a40: 6520 696e 2055 5446 2d38 2065 6e63 6f64 e in UTF-8 encod │ │ │ +00213a50: 696e 672c 206f 7468 6572 7769 7365 2074 ing, otherwise t │ │ │ +00213a60: 6865 7920 7769 6c6c 2062 6520 7374 6f72 hey will be stor │ │ │ +00213a70: 6564 2062 7574 2061 7265 206e 6f74 2071 ed but are not q │ │ │ +00213a80: 7565 7279 6162 6c65 2076 6961 2053 5041 ueryable via SPA │ │ │ +00213a90: 5251 4c2e 3c2f 7061 7261 3e0a 2020 3c2f RQL.. . . Par │ │ │ +00213ae0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ +00213af0: 2020 2020 3c72 6566 7365 6374 323e 3c74 g_uri. g │ │ │ +00213b20: 7261 7068 2075 7269 2049 5249 2073 7472 raph uri IRI str │ │ │ +00213b30: 696e 6720 6f72 2049 5249 5f49 443c 2f70 ing or IRI_ID

    . . s_uri< │ │ │ +00213b70: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +00213b80: 6172 613e 7375 626a 6563 7420 4952 4920 ara>subject IRI │ │ │ +00213b90: 7374 7269 6e67 206f 7220 4952 495f 4944 string or IRI_ID │ │ │ +00213ba0: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 </para>. </re │ │ │ +00213bb0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ +00213bc0: 7365 6374 323e 3c74 6974 6c65 3e70 5f75 sect2><title>p_u │ │ │ +00213bd0: 7269 3c2f 7469 746c 653e 0a20 2020 2020 ri. │ │ │ +00213be0: 203c 7061 7261 3e70 7265 6469 6361 7465 predicate │ │ │ +00213bf0: 2049 5249 2073 7472 696e 6720 6f72 2049 IRI string or I │ │ │ +00213c00: 5249 5f49 443c 2f70 6172 613e 0a20 2020 RI_ID. │ │ │ +00213c10: 203c 2f72 6566 7365 6374 323e 0a20 2020
    . │ │ │ +00213c20: 203c 7265 6673 6563 7432 3e3c 7469 746c o_uri. │ │ │ +00213c40: 2020 2020 2020 3c70 6172 613e 7374 7269 stri │ │ │ +00213c50: 6e67 2c20 6e75 6d62 6572 206f 7220 6461 ng, number or da │ │ │ +00213c60: 7465 7469 6d65 2c20 4e55 4c4c 2069 7320 tetime, NULL is │ │ │ +00213c70: 6e6f 7420 616c 6c6f 7765 643c 2f70 6172 not allowed. .
    │ │ │ +00213ca0: 0a20 203c 7265 6673 6563 7431 2069 643d . Retu │ │ │ +00213cd0: 726e 2054 7970 6573 3c2f 7469 746c 653e rn Types │ │ │ +00213ce0: 0a20 2020 203c 7061 7261 3e61 6e79 3c2f . any. .. . E │ │ │ +00213df0: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ +00213e00: 2020 2020 3c65 7861 6d70 6c65 2069 643d Simpl │ │ │ +00213e30: 6520 6578 616d 706c 653c 2f74 6974 6c65 e example.DB.DBA.R │ │ │ +00213e60: 4446 5f51 5541 445f 5552 495f 4c20 2827 DF_QUAD_URI_L (' │ │ │ +00213e70: 675f 6d61 6e79 272c 2027 7331 272c 2027 g_many', 's1', ' │ │ │ +00213e80: 705f 736f 6d65 272c 2027 7a30 3136 2c67 p_some', 'z016,g │ │ │ +00213e90: 5f6d 616e 792c 7331 2c70 5f73 6f6d 6527 _many,s1,p_some' │ │ │ +00213ea0: 293b 0a0a 446f 6e65 2e20 2d2d 2030 206d );..Done. -- 0 m │ │ │ +00213eb0: 7365 632e 0a5d 5d3e 3c2f 7363 7265 656e sec..]]>. │ │ │ +00213ed0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +00213ee0: 203c 7265 6673 6563 7431 2069 643d 2273 . See Also. DB │ │ │ +00213f60: 2e44 4241 2e52 4446 5f41 5544 4954 5f4d .DBA.RDF_AUDIT_M │ │ │ +00213f70: 4554 4144 4154 413c 2f66 756e 6374 696f ETADATA
    │ │ │ +00213f90: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . DB.D │ │ │ +00213fd0: 4241 2e52 4446 5f42 4143 4b55 505f 4d45 BA.RDF_BACKUP_ME │ │ │ +00213fe0: 5441 4441 5441 3c2f 6675 6e63 7469 6f6e TADATA. │ │ │ +00214000: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 │ │ │ +00214030: 3c66 756e 6374 696f 6e3e 4442 2e44 4241 DB.DBA │ │ │ +00214040: 2e52 4446 5f4c 4f41 445f 5244 4658 4d4c .RDF_LOAD_RDFXML │ │ │ +00214050: 5f4d 543c 2f66 756e 6374 696f 6e3e 3c2f _MT. │ │ │ +00214070: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ +00214090: 6675 6e63 7469 6f6e 3e44 422e 4442 412e function>DB.DBA. │ │ │ +002140a0: 5454 4c50 3c2f 6675 6e63 7469 6f6e 3e3c TTLP< │ │ │ +002140b0: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +002140c0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 DB. │ │ │ +002140f0: 4442 412e 5454 4c50 5f4d 543c 2f66 756e DBA.TTLP_MT

    . < │ │ │ +00214120: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00214130: 5f72 6466 5f74 7269 706c 6573 5f74 6f5f _rdf_triples_to_ │ │ │ +00214140: 7264 665f 786d 6c5f 7465 7874 223e 3c66 rdf_xml_text">DB.DBA.R │ │ │ +00214160: 4446 5f54 5249 504c 4553 5f54 4f5f 5244 DF_TRIPLES_TO_RD │ │ │ +00214170: 465f 584d 4c5f 5445 5854 3c2f 6675 6e63 F_XML_TEXT. DB.DBA.S │ │ │ +002141d0: 5041 5251 4c5f 5245 5845 433c 2f66 756e PARQL_REXEC

    . < │ │ │ +00214200: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00214210: 5f73 7061 7271 6c5f 7265 7865 635f 746f _sparql_rexec_to │ │ │ +00214220: 5f61 7272 6179 223e 3c66 756e 6374 696f _array">DB.DBA.SPARQL_ │ │ │ +00214240: 5245 5845 435f 544f 5f41 5252 4159 3c2f REXEC_TO_ARRAY │ │ │ +00214260: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . DB.DBA.SPA │ │ │ +002142b0: 5251 4c5f 5245 5845 435f 5749 5448 5f4d RQL_REXEC_WITH_M │ │ │ +002142c0: 4554 413c 2f66 756e 6374 696f 6e3e 3c2f ETA
    . │ │ │ +002142e0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e DB.DBA.RDF_QUAD │ │ │ +00214320: 5f55 5249 3c2f 6675 6e63 7469 6f6e 3e3c _URI< │ │ │ +00214330: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00214340: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ +00214370: 3c66 756e 6374 696f 6e3e 4442 2e44 4241 DB.DBA │ │ │ +00214380: 2e52 4446 5f51 5541 445f 5552 495f 4c5f .RDF_QUAD_URI_L_ │ │ │ +00214390: 5459 5045 443c 2f66 756e 6374 696f 6e3e TYPED │ │ │ +002143a0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +002143b0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c DB.DBA.RDF_TT │ │ │ +002143f0: 4c32 4841 5348 3c2f 6675 6e63 7469 6f6e L2HASH. │ │ │ +00214410: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......+d │ │ │ +00214430: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ +00214440: 6566 2f78 6d6c 5f6e 616d 6573 7061 6365 ef/xml_namespace │ │ │ +00214450: 5f73 636f 7065 2e78 6d6c df00 0014 5e3c _scope.xml....^< │ │ │ +00214460: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +00214470: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +00214480: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . │ │ │ +00214820: 2020 203c 7265 6665 6e74 7279 7469 746c xml_namespace_ │ │ │ +00214840: 7363 6f70 653c 2f72 6566 656e 7472 7974 scope. xml. . . xml_namespace_ │ │ │ +002148b0: 7363 6f70 653c 2f72 6566 6e61 6d65 3e0a scope. │ │ │ +002148c0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +002148d0: 5265 7475 726e 7320 6120 7665 6374 6f72 Returns a vector │ │ │ +002148e0: 206f 6620 616c 6c20 6e61 6d65 7370 6163 of all namespac │ │ │ +002148f0: 6520 6465 636c 6172 6174 696f 6e73 2069 e declarations i │ │ │ +00214900: 6e20 616c 6c20 616e 6365 7374 6f72 7320 n all ancestors │ │ │ +00214910: 6f66 2074 6865 2067 6976 656e 2058 4d4c of the given XML │ │ │ +00214920: 2065 6e74 6974 792e 3c2f 7265 6670 7572 entity.. . . . │ │ │ +00214990: 3c66 756e 6370 726f 746f 7479 7065 2069 . │ │ │ +002149c0: 2020 2020 2020 2020 3c66 756e 6364 6566 vector xml_namespace_ │ │ │ +002149f0: 7363 6f70 653c 2f66 756e 6374 696f 6e3e scope │ │ │ +00214a00: 3c2f 6675 6e63 6465 663e 0a09 3c70 6172 ..in ent XML Entity..in use_default_n │ │ │ +00214a70: 733c 2f70 6172 616d 6574 6572 3e20 696e s in │ │ │ +00214a80: 7465 6765 723c 2f70 6172 616d 6465 663e teger │ │ │ +00214a90: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ +00214ad0: 2020 3c72 6566 7365 6374 3120 6964 3d22 . < │ │ │ +00214b00: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ +00214b10: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    The function │ │ │ +00214b30: 2072 6574 7572 6e73 2061 2076 6563 746f returns a vecto │ │ │ +00214b40: 7220 6f66 2065 7665 6e20 6c65 6e67 7468 r of even length │ │ │ +00214b50: 2074 6861 7420 636f 6e73 6973 7473 206f that consists o │ │ │ +00214b60: 6620 616c 6c20 6465 636c 6172 6564 206e f all declared n │ │ │ +00214b70: 616d 6573 7061 6365 2070 7265 6669 7865 amespace prefixe │ │ │ +00214b80: 7320 616e 6420 6e61 6d65 7370 6163 6520 s and namespace │ │ │ +00214b90: 5552 4973 0a20 2020 2009 6672 6f6d 2074 URIs. .from t │ │ │ +00214ba0: 6865 203c 636f 6465 3e65 6e74 3c2f 636f he ent and all its │ │ │ +00214bc0: 616e 6365 7374 6f72 732e 2054 6869 7320 ancestors. This │ │ │ +00214bd0: 696e 666f 726d 6174 696f 6e20 6973 206e information is n │ │ │ +00214be0: 6565 6465 6420 666f 7220 7072 6f63 6573 eeded for proces │ │ │ +00214bf0: 7369 6e67 2058 4d4c 2064 6f63 756d 656e sing XML documen │ │ │ +00214c00: 7473 2074 6861 740a 636f 6e74 6169 6e73 ts that.contains │ │ │ +00214c10: 2061 206d 6978 206f 6620 6461 7461 2061 a mix of data a │ │ │ +00214c20: 6e64 2058 5061 7468 2065 7870 7265 7373 nd XPath express │ │ │ +00214c30: 696f 6e73 2c20 7375 6368 2061 7320 4250 ions, such as BP │ │ │ +00214c40: 454c 2064 6f63 756d 656e 7473 2e3c 2f70 EL documents.

    . . . │ │ │ +00214c90: 2020 2020 3c74 6974 6c65 3e50 6172 616d Param │ │ │ +00214ca0: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ +00214cb0: 2020 3c72 6566 7365 6374 323e 3c74 6974 ent. │ │ │ +00214cd0: 2020 2020 203c 7061 7261 3e54 6865 2065 The e │ │ │ +00214ce0: 6e74 6974 7920 746f 2070 726f 6365 7373 ntity to process │ │ │ +00214cf0: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . us │ │ │ +00214d20: 655f 6465 6661 756c 745f 6e73 3c2f 7469 e_default_ns</ti │ │ │ +00214d30: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +00214d40: 3e46 6c61 6773 2069 6620 7468 6520 7265 >Flags if the re │ │ │ +00214d50: 7375 6c74 696e 6720 6172 7261 7920 7368 sulting array sh │ │ │ +00214d60: 6f75 6c64 2063 6f6e 7461 696e 2064 6563 ould contain dec │ │ │ +00214d70: 6c61 7261 7469 6f6e 7320 6f66 2064 6566 larations of def │ │ │ +00214d80: 6175 6c74 206e 616d 6573 7061 6365 2e20 ault namespace. │ │ │ +00214d90: 4966 2069 7420 6973 207a 6572 6f20 7468 If it is zero th │ │ │ +00214da0: 656e 0a6f 6e6c 7920 6465 636c 6172 6174 en.only declarat │ │ │ +00214db0: 696f 6e73 206f 6620 6e61 6d65 7370 6163 ions of namespac │ │ │ +00214dc0: 6520 7072 6566 6978 6573 2061 7265 206c e prefixes are l │ │ │ +00214dd0: 6973 7465 643b 2069 6620 6e6f 6e2d 7a65 isted; if non-ze │ │ │ +00214de0: 726f 2074 6865 6e20 616c 6c20 6465 636c ro then all decl │ │ │ +00214df0: 6172 6174 696f 6e73 2061 7265 206c 6973 arations are lis │ │ │ +00214e00: 7465 642e 3c2f 7061 7261 3e0a 2020 2020 ted.</para>. │ │ │ +00214e10: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f </refsect2>. </ │ │ │ +00214e20: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ +00214e30: 7365 6374 3120 6964 3d22 7265 745f 786d sect1 id="ret_xm │ │ │ +00214e40: 6c5f 6e61 6d65 7370 6163 655f 7363 6f70 l_namespace_scop │ │ │ +00214e50: 6522 3e3c 7469 746c 653e 5265 7475 726e e"><title>Return │ │ │ +00214e60: 2054 7970 6573 3c2f 7469 746c 653e 0a20 Types. │ │ │ +00214e70: 2020 203c 7061 7261 3e54 6865 2066 756e The fun │ │ │ +00214e80: 6374 696f 6e20 7265 7475 726e 7320 6120 ction returns a │ │ │ +00214e90: 7665 6374 6f72 206f 6620 6576 656e 206c vector of even l │ │ │ +00214ea0: 656e 6774 6820 7468 6174 2063 6f6e 7461 ength that conta │ │ │ +00214eb0: 696e 7320 6e61 7272 6f77 2073 7472 696e ins narrow strin │ │ │ +00214ec0: 6773 2069 6e20 5554 462d 3820 656e 636f gs in UTF-8 enco │ │ │ +00214ed0: 6469 6e67 2e3c 2f70 6172 613e 0a20 203c ding.. < │ │ │ +00214ee0: 2f72 6566 7365 6374 313e 0a3c 212d 2d20 /refsect1>. . . Examples. < │ │ │ +00215020: 7469 746c 653e 4164 6469 6e67 206e 616d title>Adding nam │ │ │ +00215030: 6573 7061 6365 2064 6563 6c61 7261 7469 espace declarati │ │ │ +00215040: 6f6e 7320 746f 2074 6865 2058 5061 7468 ons to the XPath │ │ │ +00215050: 2065 7870 7265 7373 696f 6e3c 2f74 6974 expression. │ │ │ +00215070: 5468 6520 6675 6e63 7469 6f6e 2067 6574 The function get │ │ │ +00215080: 7320 616e 2065 6e74 6974 7920 7768 6f73 s an entity whos │ │ │ +00215090: 6520 7374 7269 6e67 2d76 616c 7565 2069 e string-value i │ │ │ +002150a0: 7320 616e 2058 5041 5448 2065 7870 7265 s an XPATH expre │ │ │ +002150b0: 7373 696f 6e20 616e 6420 7265 7475 726e ssion and return │ │ │ +002150c0: 730a 7468 6520 7465 7874 206f 6620 6578 s.the text of ex │ │ │ +002150d0: 7072 6573 7369 6f6e 2077 6974 6820 616c pression with al │ │ │ +002150e0: 6c20 6e61 6d65 7370 6163 6520 6465 636c l namespace decl │ │ │ +002150f0: 6172 6174 696f 6e73 2074 6861 7420 6172 arations that ar │ │ │ +00215100: 6520 696e 2073 636f 7065 2e20 5468 6520 e in scope. The │ │ │ +00215110: 7265 7375 6c74 696e 6720 6578 7072 6573 resulting expres │ │ │ +00215120: 7369 6f6e 2069 730a 636f 6e74 6578 742d sion is.context- │ │ │ +00215130: 696e 6465 7065 6e64 656e 742e 2054 6869 independent. Thi │ │ │ +00215140: 7320 6973 2075 7365 6675 6c20 666f 7220 s is useful for │ │ │ +00215150: 4250 454c 2d6c 696b 6520 6170 706c 6963 BPEL-like applic │ │ │ +00215160: 6174 696f 6e73 2061 6e64 2066 6f72 2065 ations and for e │ │ │ +00215170: 7874 7261 6374 696e 6720 5850 4154 4820 xtracting XPATH │ │ │ +00215180: 6578 7072 6573 7369 6f6e 7320 6672 6f6d expressions from │ │ │ +00215190: 0a58 4d4c 2053 6368 656d 6120 646f 6375 .XML Schema docu │ │ │ +002151a0: 6d65 6e74 732e 3c2f 7061 7261 3e0a 2020 ments.. │ │ │ +002151b0: 2020 2020 3c73 6372 6565 6e3e 3c21 5b43 0). {. │ │ │ +00215380: 2020 2069 6620 285f 7363 6f70 655b 5f63 if (_scope[_c │ │ │ +00215390: 7472 2d32 5d20 3d20 2727 290a 2020 2020 tr-2] = ''). │ │ │ +002153a0: 2020 2020 6874 7470 2028 7370 7269 6e74 http (sprint │ │ │ +002153b0: 6620 2827 2078 6d6c 6e73 3d22 2573 2227 f (' xmlns="%s"' │ │ │ +002153c0: 2c20 5f73 636f 7065 5b5f 6374 722d 315d , _scope[_ctr-1] │ │ │ +002153d0: 292c 205f 7365 7329 3b0a 2020 2020 2020 ), _ses);. │ │ │ +002153e0: 656c 7365 0a20 2020 2020 2020 2068 7474 else. htt │ │ │ +002153f0: 7020 2873 7072 696e 7466 2028 2720 786d p (sprintf (' xm │ │ │ +00215400: 6c6e 733a 2573 3d22 2573 2227 2c20 5f73 lns:%s="%s"', _s │ │ │ +00215410: 636f 7065 5b5f 6374 722d 325d 2c20 5f73 cope[_ctr-2], _s │ │ │ +00215420: 636f 7065 5b5f 6374 722d 315d 292c 205f cope[_ctr-1]), _ │ │ │ +00215430: 7365 7329 3b0a 2020 2020 2020 5f63 7472 ses);. _ctr │ │ │ +00215440: 203a 3d20 5f63 7472 202d 2032 3b0a 2020 := _ctr - 2;. │ │ │ +00215450: 2020 7d0a 2020 6874 7470 2028 2720 5d20 }. http (' ] │ │ │ +00215460: 272c 205f 7365 7329 3b0a 2020 6874 7470 ', _ses);. http │ │ │ +00215470: 2028 5f65 7870 6e2c 205f 7365 7329 3b0a (_expn, _ses);. │ │ │ +00215480: 2020 7265 7475 726e 2073 7472 696e 675f return string_ │ │ │ +00215490: 6f75 7470 7574 5f73 7472 696e 6720 285f output_string (_ │ │ │ +002154a0: 7365 7329 3b0a 7d0a 0a73 656c 6563 7420 ses);.}..select │ │ │ +002154b0: 7870 6174 685f 6164 645f 6e61 6d65 7370 xpath_add_namesp │ │ │ +002154c0: 6163 655f 7363 6f70 6520 280a 2020 7871 ace_scope (. xq │ │ │ +002154d0: 7565 7279 5f65 7661 6c20 280a 2764 6563 uery_eval (.'dec │ │ │ +002154e0: 6c61 7265 206e 616d 6573 7061 6365 2078 lare namespace x │ │ │ +002154f0: 7364 3d22 6874 7470 3a2f 2f77 7777 2e77 sd="http://www.w │ │ │ +00215500: 332e 6f72 672f 3230 3031 2f58 4d4c 5363 3.org/2001/XMLSc │ │ │ +00215510: 6865 6d61 223b 0a2f 2f78 7364 3a6b 6579 hema";.//xsd:key │ │ │ +00215520: 7265 665b 406e 616d 653d 2249 5342 4e6e ref[@name="ISBNn │ │ │ +00215530: 756d 6265 7222 5d2f 7873 643a 6669 656c umber"]/xsd:fiel │ │ │ +00215540: 642f 4078 7061 7468 272c 0a20 2020 2078 d/@xpath',. x │ │ │ +00215550: 7472 6565 5f64 6f63 2028 0a27 3c78 7364 tree_doc (.'. . . │ │ │ +00215670: 2020 3c78 7364 3a73 656c 6563 746f 7220 . │ │ │ +00215690: 2020 3c78 7364 3a66 6965 6c64 2078 7061 . │ │ │ +002156b0: 3c2f 7873 643a 6b65 7972 6566 3e0a 2020 . │ │ │ +002156c0: 3c2f 7873 643a 656c 656d 656e 743e 0a20 . │ │ │ +002156d0: 203c 212d 2d20 5468 6520 7265 7374 206f .')),. 1 );..c │ │ │ +00215720: 616c 6c72 6574 0a56 4152 4348 4152 0a5f allret.VARCHAR._ │ │ │ +00215730: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00215740: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00215750: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00215760: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00215770: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ +00215780: 5b20 786d 6c6e 733d 2268 7474 703a 2f2f [ xmlns="http:// │ │ │ +00215790: 7777 772e 7075 626c 6973 6869 6e67 2e6f www.publishing.o │ │ │ +002157a0: 7267 2220 786d 6c6e 733a 7873 643d 2268 rg" xmlns:xsd="h │ │ │ +002157b0: 7474 703a 2f2f 7777 772e 7733 2e6f 7267 ttp://www.w3.org │ │ │ +002157c0: 2f32 3030 312f 584d 4c53 6368 656d 6122 /2001/XMLSchema" │ │ │ +002157d0: 205d 2049 5342 4e0a 5d5d 3e0a 3c2f 7363 ] ISBN.]]>.. . . │ │ │ +00215830: 0a20 2020 203c 7469 746c 653e 5365 6520 . See │ │ │ +00215840: 416c 736f 3c2f 7469 746c 653e 0a20 2020 Also. │ │ │ +00215850: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e x │ │ │ +00215880: 7061 7468 5f65 7661 6c3c 2f66 756e 6374 path_eval. │ │ │ +002158b0: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 .
    .... │ │ │ +002158c0: 0020 6465 6d6f 2f64 6f63 7372 632f 6675 . demo/docsrc/fu │ │ │ +002158d0: 6e63 7265 662f 6c64 6170 5f61 6464 2e78 ncref/ldap_add.x │ │ │ +002158e0: 6d6c df00 0017 213c 3f78 6d6c 2076 6572 ml....!... │ │ │ +00215c90: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ +00215ca0: 3c72 6566 656e 7472 7974 6974 6c65 3e6c l │ │ │ +00215cb0: 6461 705f 6164 643c 2f72 6566 656e 7472 dap_add. ldap. . . ldap_add. Adds a n │ │ │ +00215d40: 6577 2065 6e74 7279 2074 6f20 616e 204c ew entry to an L │ │ │ +00215d50: 4441 5020 6469 7265 6374 6f72 792e 3c2f DAP directory.. . . │ │ │ +00215d90: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . . │ │ │ +00215de0: 2020 2020 2020 2020 3c66 756e 6364 6566 int l │ │ │ +00215e00: 6461 705f 6164 643c 2f66 756e 6374 696f dap_add..

    in server_url │ │ │ +00215e40: 203c 2f70 6172 616d 6574 6572 3e76 6172 var │ │ │ +00215e50: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +00215e60: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .in

    try_tls │ │ │ +00215e80: 203c 2f70 6172 616d 6574 6572 3e69 6e74 int │ │ │ +00215e90: 6567 6572 3c2f 7061 7261 6d64 6566 3e0a eger. │ │ │ +00215ea0: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .in

    data varcha │ │ │ +00215ed0: 723c 2f70 6172 616d 6465 663e 0a09 3c70 r..

    in username < │ │ │ +00215f00: 2f70 6172 616d 6574 6572 3e76 6172 6368 /parameter>varch │ │ │ +00215f10: 6172 3c2f 7061 7261 6d64 6566 3e0a 093c ar..< │ │ │ +00215f20: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in password │ │ │ +00215f40: 3c2f 7061 7261 6d65 7465 723e 7661 7263 varc │ │ │ +00215f50: 6861 723c 2f70 6172 616d 6465 663e 0a20 har. │ │ │ +00215f60: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ +00215fa0: 3c72 6566 7365 6374 3120 6964 3d22 6465 Description< │ │ │ +00215fd0: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. This function │ │ │ +00215ff0: 6164 6473 2061 206e 6577 2065 6e74 7279 adds a new entry │ │ │ +00216000: 2074 6f20 7468 6520 4c44 4150 2064 6972 to the LDAP dir │ │ │ +00216010: 6563 746f 7279 2e3c 2f70 6172 613e 3c2f ectory.. Parameters. server │ │ │ +00216080: 5f75 726c 3c2f 7469 746c 653e 0a20 2020 _url. │ │ │ +00216090: 2020 203c 7061 7261 3e54 6865 2073 6572 The ser │ │ │ +002160a0: 7665 7220 5552 4c20 6861 7320 7468 7265 ver URL has thre │ │ │ +002160b0: 6520 7061 7274 732c 2026 6c74 3b70 726f e parts, <pro │ │ │ +002160c0: 746f 636f 6c26 6774 3b3a 2f2f 266c 743b tocol>://< │ │ │ +002160d0: 686f 7374 2667 743b 3a26 6c74 3b70 6f72 host>:<por │ │ │ +002160e0: 7426 6774 3b2e 0a20 2020 2020 204d 6973 t>.. Mis │ │ │ +002160f0: 7369 6e67 2070 6172 616d 6574 6572 7320 sing parameters │ │ │ +00216100: 7769 6c6c 2062 6520 6465 6661 756c 7465 will be defaulte │ │ │ +00216110: 6420 746f 3a20 3c70 726f 6772 616d 6c69 d to: <ldap:/ │ │ │ +00216130: 2f6c 6f63 616c 686f 7374 3a33 3839 2667 /localhost:389&g │ │ │ +00216140: 743b 3c2f 7072 6f67 7261 6d6c 6973 7469 t;.. │ │ │ +00216160: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ +00216170: 3c72 6566 7365 6374 323e 3c74 6974 6c65 try_tls │ │ │ +00216190: 0a20 2020 2020 203c 7061 7261 3e3c 7061 . try_tls< │ │ │ +002161b0: 2f70 6172 616d 6574 6572 3e20 6973 2061 /parameter> is a │ │ │ +002161c0: 2066 6c61 6720 7468 6174 2074 656c 6c73 flag that tells │ │ │ +002161d0: 2074 6865 2063 6c69 656e 7420 746f 2070 the client to p │ │ │ +002161e0: 6572 666f 726d 2061 2068 616e 6473 6861 erform a handsha │ │ │ +002161f0: 6b65 0a20 2020 2020 2077 6974 6820 7468 ke. with th │ │ │ +00216200: 6520 4c44 4150 2073 6572 7665 7220 7573 e LDAP server us │ │ │ +00216210: 696e 6720 6120 7365 6375 7265 2063 6f6e ing a secure con │ │ │ +00216220: 6e65 6374 696f 6e2e 2020 5468 6973 2069 nection. This i │ │ │ +00216230: 7320 6f6e 6c79 2061 7070 6c69 6361 626c s only applicabl │ │ │ +00216240: 6520 746f 2074 6865 206c 6461 703a 2f2f e to the ldap:// │ │ │ +00216250: 2070 726f 746f 636f 6c20 616e 6420 6e6f protocol and no │ │ │ +00216260: 740a 2020 2020 2020 6c64 6170 733a 2f2f t. ldaps:// │ │ │ +00216270: 2e20 2049 6620 7468 6520 7365 6375 7265 . If the secure │ │ │ +00216280: 2063 6f6e 6e65 6374 696f 6e20 6174 7465 connection atte │ │ │ +00216290: 6d70 7420 6661 696c 732c 2074 6865 2063 mpt fails, the c │ │ │ +002162a0: 6c69 656e 7420 7769 6c6c 2066 616c 6c20 lient will fall │ │ │ +002162b0: 6261 636b 2074 6f20 696e 7365 6375 7265 back to insecure │ │ │ +002162c0: 2063 6f6e 6e65 6374 2e3c 2f70 6172 613e connect. │ │ │ +002162d0: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ +002162e0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +002162f0: 7469 746c 653e 6461 7461 3c2f 7469 746c title>data. < │ │ │ +00216310: 7061 7261 6d65 7465 723e 6461 7461 3c2f parameter>data is an │ │ │ +00216330: 2061 7272 6179 2077 6974 6820 6e61 6d65 array with name │ │ │ +00216340: 2f76 616c 7565 2070 6169 7273 2072 6570 /value pairs rep │ │ │ +00216350: 7265 7365 6e74 696e 6720 7468 6520 6461 resenting the da │ │ │ +00216360: 7461 2074 6f20 6265 2061 6464 6564 2e3c ta to be added.< │ │ │ +00216370: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ +00216390: 3c74 6974 6c65 3e75 7365 726e 616d 653c username< │ │ │ +002163a0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +002163b0: 6172 613e 7573 6572 6e61 6d65 2061 7574 ara>username aut │ │ │ +002163c0: 686f 7269 7a61 7469 6f6e 2063 7265 6465 horization crede │ │ │ +002163d0: 6e74 6961 6c3c 2f70 6172 613e 3c2f 7265 ntial</para></re │ │ │ +002163e0: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ +002163f0: 7365 6374 323e 3c74 6974 6c65 3e70 6173 sect2><title>pas │ │ │ +00216400: 7377 6f72 643c 2f74 6974 6c65 3e0a 2020 sword. │ │ │ +00216410: 2020 2020 3c70 6172 613e 7061 7373 776f passwo │ │ │ +00216420: 7264 2061 7574 686f 7269 7a61 7469 6f6e rd authorization │ │ │ +00216430: 2063 7265 6465 6e74 6961 6c3c 2f70 6172 credential. │ │ │ +00216450: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . Return Types</t │ │ │ +00216490: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +002164a0: 5468 6520 6572 726f 7220 7374 6174 7573 The error status │ │ │ +002164b0: 2063 6f64 6520 6973 2072 6574 7572 6e65 code is returne │ │ │ +002164c0: 642e 205a 6572 6f20 666f 7220 7375 6363 d. Zero for succ │ │ │ +002164d0: 6573 732e 3c2f 7061 7261 3e0a 2020 3c2f ess.</para>. </ │ │ │ +002164e0: 7265 6673 6563 7431 3e0a 0a20 203c 7265 refsect1>.. <re │ │ │ +002164f0: 6673 6563 7431 2069 643d 2265 7272 6f72 fsect1 id="error │ │ │ +00216500: 735f 6c64 6170 5f61 6464 223e 3c74 6974 s_ldap_add"><tit │ │ │ +00216510: 6c65 3e45 7272 6f72 733c 2f74 6974 6c65 le>Errors.

  • Errors signa │ │ │ +00216540: 6c6c 6564 2062 7920 3c66 756e 6374 696f lled by ldap_add. │ │ │ +00216570: 2020 2020 3c74 6772 6f75 7020 636f 6c73 .
    │ │ │ +002165a0: 5351 4c53 7461 7465 3c2f 656e 7472 793e SQLState │ │ │ +002165b0: 3c65 6e74 7279 3e45 7272 6f72 2043 6f64 Error Cod │ │ │ +002165c0: 653c 2f65 6e74 7279 3e3c 656e 7472 793e e │ │ │ +002165d0: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error TextDescrip │ │ │ +002165f0: 7469 6f6e 3c2f 656e 7472 793e 3c2f 726f tion.... .. │ │ │ +00216620: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 2E000.. │ │ │ +00216650: 2020 203c 656e 7472 793e 3c65 7272 6f72 LD005.. │ │ │ +00216680: 2020 2020 3c65 6e74 7279 3e3c 6572 726f Failed to │ │ │ +002166a0: 696e 6974 6961 6c69 7a65 204c 4441 5020 initialize LDAP │ │ │ +002166b0: 636f 6e6e 6563 7469 6f6e 3a20 266c 743b connection: < │ │ │ +002166c0: 7265 6173 6f6e 2667 743b 2028 266c 743b reason> (< │ │ │ +002166d0: 7265 6173 6f6e 2063 6f64 6526 6774 3b29 reason code>) │ │ │ +002166e0: 3c2f 6572 726f 726e 616d 653e 3c2f 656e .. .. .. .. │ │ │ +00216720: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 2E000.. │ │ │ +00216750: 2020 203c 656e 7472 793e 3c65 7272 6f72 LD006.. │ │ │ +00216780: 2020 2020 3c65 6e74 7279 3e3c 6572 726f Failed to │ │ │ +002167a0: 7365 7420 4c44 4150 2076 6572 7369 6f6e set LDAP version │ │ │ +002167b0: 206f 7074 696f 6e3a 2026 6c74 3b72 6561 option: <rea │ │ │ +002167c0: 736f 6e26 6774 3b20 2826 6c74 3b72 6561 son> (<rea │ │ │ +002167d0: 736f 6e20 636f 6465 2667 743b 293c 2f65 son code>).. .. │ │ │ +00216810: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ +00216820: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>2E000.. │ │ │ +00216850: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 LD016.. │ │ │ +00216880: 203c 656e 7472 793e 3c65 7272 6f72 6e61 Failed to sta │ │ │ +002168a0: 7274 2054 4c53 3a20 266c 743b 7265 6173 rt TLS: <reas │ │ │ +002168b0: 6f6e 2667 743b 2028 266c 743b 7265 6173 on> (<reas │ │ │ +002168c0: 6f6e 2063 6f64 6526 6774 3b29 3c2f 6572 on code>) │ │ │ +002168e0: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ +00216900: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ +00216920: 3238 3030 303c 2f65 7272 6f72 636f 6465 28000.. < │ │ │ +00216940: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>LD007.. │ │ │ +00216970: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Failed to bind │ │ │ +00216990: 2073 796e 6368 726f 6e6f 7573 204c 4441 synchronous LDA │ │ │ +002169a0: 5020 636f 6e6e 6563 7469 6f6e 3a20 266c P connection: &l │ │ │ +002169b0: 743b 7265 6173 6f6e 2667 743b 2028 266c t;reason> (&l │ │ │ +002169c0: 743b 7265 6173 6f6e 2063 6f64 6526 6774 t;reason code> │ │ │ +002169d0: 3b29 3c2f 6572 726f 726e 616d 653e 3c2f ;).. .. < │ │ │ +00216a00: 2f72 6f77 3e0a 0920 203c 726f 773e 0a09 /row>.. .. │ │ │ +00216a10: 2020 2020 3c65 6e74 7279 3e3c 6572 726f 2E000. │ │ │ +00216a40: 0920 2020 203c 656e 7472 793e 3c65 7272 . LD004 │ │ │ +00216a70: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. The DN m │ │ │ +00216a90: 7573 7420 6265 2073 7570 706c 6965 643c ust be supplied< │ │ │ +00216aa0: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname>.. │ │ │ +00216ac0: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f .. .. .. │ │ │ +00216ae0: 203c 656e 7472 793e 3c65 7272 6f72 636f 2E000.. │ │ │ +00216b10: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 LD004.. │ │ │ +00216b40: 2020 203c 656e 7472 793e 3c65 7272 6f72 Failed to m │ │ │ +00216b60: 6f64 6966 7920 6572 723d 266c 743b 7265 odify err=<re │ │ │ +00216b70: 6173 6f6e 2063 6f64 6520 2826 6c74 3b72 ason code (<r │ │ │ +00216b80: 6561 736f 6e26 6774 3b29 3c2f 6572 726f eason>).. │ │ │ +00216ba0: 2020 2020 3c65 6e74 7279 3e3c 2f65 6e74 .. ..< │ │ │ +00216bc0: 2f74 626f 6479 3e0a 2020 2020 2020 3c2f /tbody>. . . . Exa │ │ │ +00216c20: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ +00216c30: 2020 3c65 7861 6d70 6c65 2069 643d 2265 .Using l │ │ │ +00216c60: 6461 705f 6164 643c 2f74 6974 6c65 3e0a dap_add. │ │ │ +00216c70: 2d2d 3e0a 3c70 726f 6772 616d 6c69 7374 -->..create proc │ │ │ +00216c90: 6564 7572 650a 7361 6d5f 6c64 6170 5f61 edure.sam_ldap_a │ │ │ +00216ca0: 6464 2028 696e 2073 3120 7661 7263 6861 dd (in s1 varcha │ │ │ +00216cb0: 722c 2069 6e20 7332 2076 6172 6368 6172 r, in s2 varchar │ │ │ +00216cc0: 290a 7b0a 2020 6465 636c 6172 6520 7265 ).{. declare re │ │ │ +00216cd0: 732c 2076 6563 2061 6e79 3b0a 2020 6465 s, vec any;. de │ │ │ +00216ce0: 636c 6172 6520 5f66 726f 6d5f 6164 6420 clare _from_add │ │ │ +00216cf0: 696e 7465 6765 723b 0a0a 2020 7665 6320 integer;.. vec │ │ │ +00216d00: 3a3d 2076 6563 746f 7220 2827 646e 272c := vector ('dn', │ │ │ +00216d10: 2063 6f6e 6361 7420 2827 636e 3d27 2c20 concat ('cn=', │ │ │ +00216d20: 7331 2c20 2720 272c 2073 322c 2027 2c6f s1, ' ', s2, ',o │ │ │ +00216d30: 3d6f 706c 2c63 3d42 4727 292c 0a20 2020 =opl,c=BG'),. │ │ │ +00216d40: 2020 2020 2020 2763 6e27 2c20 7665 6374 'cn', vect │ │ │ +00216d50: 6f72 2028 636f 6e63 6174 2028 7331 2c20 or (concat (s1, │ │ │ +00216d60: 2720 272c 2073 3229 292c 0a20 2020 2020 ' ', s2)),. │ │ │ +00216d70: 2020 2020 276d 6169 6c27 2c20 7665 6374 'mail', vect │ │ │ +00216d80: 6f72 2827 6d61 696c 4074 6563 686e 6f2d or('mail@techno- │ │ │ +00216d90: 6c69 6e6b 2e63 6f6d 2729 2c0a 2020 2020 link.com'),. │ │ │ +00216da0: 2020 2020 2027 736e 272c 2076 6563 746f 'sn', vecto │ │ │ +00216db0: 7228 7332 292c 2027 7465 6c65 7068 6f6e r(s2), 'telephon │ │ │ +00216dc0: 654e 756d 6265 7227 2c20 7665 6374 6f72 eNumber', vector │ │ │ +00216dd0: 2827 3033 322d 3934 3730 3230 272c 2027 ('032-947020', ' │ │ │ +00216de0: 3033 322d 3633 3337 3130 272c 2027 3034 032-633710', '04 │ │ │ +00216df0: 3820 3835 3020 3736 3027 292c 0a20 2020 8 850 760'),. │ │ │ +00216e00: 2020 2020 2020 276f 626a 6563 7443 6c61 'objectCla │ │ │ +00216e10: 7373 272c 2076 6563 746f 7228 2769 6e65 ss', vector('ine │ │ │ +00216e20: 746f 7267 7065 7273 6f6e 2720 2929 3b0a torgperson' ));. │ │ │ +00216e30: 0a20 205f 6672 6f6d 5f61 6464 203a 3d20 . _from_add := │ │ │ +00216e40: 6c64 6170 5f61 6464 2028 276c 6461 703a ldap_add ('ldap: │ │ │ +00216e50: 2f2f 6275 6261 3a33 3839 272c 2030 2c20 //buba:389', 0, │ │ │ +00216e60: 7665 632c 204e 554c 4c29 3b0a 0a20 2072 vec, NULL);.. r │ │ │ +00216e70: 6574 7572 6e20 285f 6672 6f6d 5f61 6464 eturn (_from_add │ │ │ +00216e80: 293b 0a7d 3b0a 3c2f 7072 6f67 7261 6d6c );.};.. . . Se │ │ │ +00216ee0: 6520 416c 736f 3c2f 7469 746c 653e 203c e Also < │ │ │ +00216ef0: 7061 7261 3e3c 6c69 6e6b 0a20 2020 206c para>ldap_delete()< │ │ │ +00216f30: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. ldap_modify( │ │ │ +00216f80: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 ),. ldap_searc │ │ │ +00216fd0: 6828 293c 2f66 756e 6374 696f 6e3e 3c2f h(). < │ │ │ +00216ff0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>.......%dem │ │ │ +00217010: 6f2f 646f 6373 7263 2f66 756e 6372 6566 o/docsrc/funcref │ │ │ +00217020: 2f58 4d4c 4154 5452 4942 5554 4553 2e78 /XMLATTRIBUTES.x │ │ │ +00217030: 6d6c df00 0012 b03c 3f78 6d6c 2076 6572 ml........ . XMLATTRIBUT │ │ │ +00217410: 4553 3c2f 7265 6665 6e74 7279 7469 746c ES. xml. . . X │ │ │ +00217470: 4d4c 4154 5452 4942 5554 4553 3c2f 7265 MLATTRIBUTES. Creates a │ │ │ +002174a0: 206c 6973 7420 6f66 2061 7474 7269 6275 list of attribu │ │ │ +002174b0: 7465 7320 616e 6420 7468 6569 7220 7661 tes and their va │ │ │ +002174c0: 6c75 6573 3c2f 7265 6670 7572 706f 7365 lues. . . . │ │ │ +00217520: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +00217550: 2020 2020 2020 2020 3c66 756e 6364 6566 XMLAT │ │ │ +00217570: 5452 4942 5554 4553 3c2f 6675 6e63 7469 TRIBUTES. │ │ │ +00217590: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ +002175a0: 3c70 6172 616d 6574 6572 3e73 7472 696e strin │ │ │ +002175b0: 675f 6578 7072 3120 5b41 5320 616c 6961 g_expr1 [AS alia │ │ │ +002175c0: 7331 5d3c 2f70 6172 616d 6574 6572 3e20 s1] │ │ │ +002175d0: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar..string_expr2 │ │ │ +00217610: 5b41 5320 616c 6961 7332 5d3c 2f70 6172 [AS alias2] varchar< │ │ │ +00217630: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>..... │ │ │ +00217680: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..stri │ │ │ +002176b0: 6e67 5f65 7870 724e 205b 4153 2061 6c69 ng_exprN [AS ali │ │ │ +002176c0: 6173 4e5d 3c2f 7061 7261 6d65 7465 723e asN] │ │ │ +002176d0: 2076 6172 6368 6172 3c2f 6f70 7469 6f6e varchar. │ │ │ +002176f0: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ +00217730: 3c72 6566 7365 6374 3120 6964 3d22 6465 Descrip │ │ │ +00217760: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ +00217770: 203c 7061 7261 3e0a 2020 2054 6869 7320 . This │ │ │ +00217780: 6675 6e63 7469 6f6e 2063 7265 6174 6573 function creates │ │ │ +00217790: 2061 2076 6563 746f 7220 7468 6174 206d a vector that m │ │ │ +002177a0: 6179 2062 6520 7573 6564 206f 6e6c 7920 ay be used only │ │ │ +002177b0: 6173 2061 7267 756d 656e 7420 6f66 200a as argument of . │ │ │ +002177c0: 2020 203c 6675 6e63 7469 6f6e 3e58 4d4c XML │ │ │ +002177d0: 454c 454d 454e 543c 2f66 756e 6374 696f ELEMENT function. The │ │ │ +002177f0: 2076 6563 746f 7220 6861 7320 616e 2065 vector has an e │ │ │ +00217800: 7665 6e20 6e75 6d62 6572 206f 6620 656c ven number of el │ │ │ +00217810: 656d 656e 7473 2c20 6561 6368 206f 6464 ements, each odd │ │ │ +00217820: 2065 6c65 6d65 6e74 2069 7320 6120 6e61 element is a na │ │ │ +00217830: 6d65 206f 6620 616e 2061 7474 7269 6275 me of an attribu │ │ │ +00217840: 7465 2c20 616e 0a20 2020 6576 656e 2065 te, an. even e │ │ │ +00217850: 6c65 6d65 6e74 2069 7320 6974 7320 7661 lement is its va │ │ │ +00217860: 6c75 652e 2049 6620 7468 6520 6174 7472 lue. If the attr │ │ │ +00217870: 6962 7574 6520 7661 6c75 6520 6973 204e ibute value is N │ │ │ +00217880: 554c 4c2c 2074 6865 6e20 6e6f 2061 7474 ULL, then no att │ │ │ +00217890: 7269 6275 7465 2061 6e64 206e 6f20 7661 ribute and no va │ │ │ +002178a0: 6c75 6520 6973 2063 7265 6174 6564 2e0a lue is created.. │ │ │ +002178b0: 2020 2049 6620 6e6f 6e65 206f 6620 7468 If none of th │ │ │ +002178c0: 6520 6174 7472 6962 7574 6520 6973 2063 e attribute is c │ │ │ +002178d0: 7265 6174 6564 2c20 7468 656e 2074 6865 reated, then the │ │ │ +002178e0: 2066 756e 6374 696f 6e20 7265 7475 726e function return │ │ │ +002178f0: 7320 4e55 4c4c 2e0a 2020 2049 6620 7374 s NULL.. If st │ │ │ +00217900: 7269 6e67 5f65 7870 7220 6973 2061 2063 ring_expr is a c │ │ │ +00217910: 6f6c 756d 6e20 6e61 6d65 2c20 7468 656e olumn name, then │ │ │ +00217920: 2079 6f75 2063 616e 206f 6d69 7420 7468 you can omit th │ │ │ +00217930: 6520 4153 2063 6c61 7573 652c 2061 6e64 e AS clause, and │ │ │ +00217940: 2056 6972 7475 6f73 6f20 7573 6573 2074 Virtuoso uses t │ │ │ +00217950: 6865 2070 6172 7469 616c 6c79 2065 7363 he partially esc │ │ │ +00217960: 6170 6564 2066 6f72 6d20 6f66 200a 2020 aped form of . │ │ │ +00217970: 2074 6865 2063 6f6c 756d 6e20 6e61 6d65 the column name │ │ │ +00217980: 2061 7320 7468 6520 6174 7472 6962 7574 as the attribut │ │ │ +00217990: 6520 6e61 6d65 2e20 0a20 2020 203c 2f70 e name. .

    . . Paramet │ │ │ +002179e0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +002179f0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 String_exprI [A │ │ │ +00217a10: 5320 616c 6961 7349 5d3c 2f74 6974 6c65 S aliasI]. st │ │ │ +00217a30: 7269 6e67 2076 616c 7565 3b20 4153 2063 ring value; AS c │ │ │ +00217a40: 6c61 7573 6520 6973 206d 616e 6461 746f lause is mandato │ │ │ +00217a50: 7279 2069 6620 6974 2069 7320 6e6f 7420 ry if it is not │ │ │ +00217a60: 6120 636f 6c75 6d6e 206e 616d 6520 6275 a column name bu │ │ │ +00217a70: 7420 616e 2065 7870 7265 7373 696f 6e20 t an expression │ │ │ +00217a80: 6f66 2073 6f6d 6520 6f74 6865 7220 736f of some other so │ │ │ +00217a90: 7274 2e3c 2f70 6172 613e 0a20 2020 203c rt.. < │ │ │ +00217aa0: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. . . │ │ │ +00217d30: 203c 7265 6673 6563 7431 2069 643d 2258 Examples. │ │ │ +00217d90: 584d 4c41 5454 5249 4255 5445 5328 2920 XMLATTRIBUTES() │ │ │ +00217da0: 7769 7468 2074 776f 2070 6172 616d 6574 with two paramet │ │ │ +00217db0: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +00217dc0: 2020 3c70 6172 613e 5468 6520 666f 6c6c The foll │ │ │ +00217dd0: 6f77 696e 6720 6578 616d 706c 6520 7072 owing example pr │ │ │ +00217de0: 6f64 7563 6573 2061 6e20 2661 706f 733b oduces an ' │ │ │ +00217df0: 456d 704e 616d 6526 6170 6f73 3b20 656c EmpName' el │ │ │ +00217e00: 656d 656e 7473 2077 6974 6820 7477 6f20 ements with two │ │ │ +00217e10: 6174 7472 6962 7574 6573 2028 6966 2076 attributes (if v │ │ │ +00217e20: 616c 7565 206f 6620 7468 6520 636f 6c75 alue of the colu │ │ │ +00217e30: 6d6e 2026 6170 6f73 3b52 6567 696f 6e26 mn 'Region& │ │ │ +00217e40: 6170 6f73 3b20 6973 206e 6f74 204e 554c apos; is not NUL │ │ │ +00217e50: 4c29 206f 7220 0a77 6974 6820 6f6e 6520 L) or .with one │ │ │ +00217e60: 6174 7472 6962 7574 6520 2869 6620 7661 attribute (if va │ │ │ +00217e70: 6c75 6520 6f66 2074 6865 2063 6f6c 756d lue of the colum │ │ │ +00217e80: 6e20 2661 706f 733b 5265 6769 6f6e 2661 n 'Region&a │ │ │ +00217e90: 706f 733b 2069 7320 4e55 4c4c 2920 3c2f pos; is NULL) . .select XMLE │ │ │ +00217ec0: 4c45 4d45 4e54 2028 2245 6d70 4e61 6d65 LEMENT ("EmpName │ │ │ +00217ed0: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ +00217ee0: 2020 2020 2020 2058 4d4c 4154 5452 4942 XMLATTRIB │ │ │ +00217ef0: 5554 4553 2028 2246 6972 7374 4e61 6d65 UTES ("FirstName │ │ │ +00217f00: 2220 7c7c 2027 2027 207c 7c20 224c 6173 " || ' ' || "Las │ │ │ +00217f10: 744e 616d 6522 2061 7320 224e 616d 6522 tName" as "Name" │ │ │ +00217f20: 2c20 2252 6567 696f 6e22 2029 290a 2020 , "Region" )). │ │ │ +00217f30: 6672 6f6d 2022 4465 6d6f 222e 2264 656d from "Demo"."dem │ │ │ +00217f40: 6f22 2e22 456d 706c 6f79 6565 7322 3b0a o"."Employees";. │ │ │ +00217f50: 6361 6c6c 7265 740a 5641 5243 4841 520a callret.VARCHAR. │ │ │ +00217f60: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00217f70: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00217f80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00217f90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00217fa0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a _______________. │ │ │ +00217fb0: 266c 743b 456d 704e 616d 6520 4e61 6d65 <EmpName Name │ │ │ +00217fc0: 3d22 4e61 6e63 7920 4461 766f 6c69 6f22 ="Nancy Davolio" │ │ │ +00217fd0: 2052 6567 696f 6e3d 2257 4122 202f 2667 Region="WA" /&g │ │ │ +00217fe0: 743b 0a26 6c74 3b45 6d70 4e61 6d65 204e t;.<EmpName N │ │ │ +00217ff0: 616d 653d 2241 6e64 7265 7720 4675 6c6c ame="Andrew Full │ │ │ +00218000: 6572 2220 5265 6769 6f6e 3d22 5741 2220 er" Region="WA" │ │ │ +00218010: 2f26 6774 3b0a 266c 743b 456d 704e 616d />.<EmpNam │ │ │ +00218020: 6520 4e61 6d65 3d22 4a61 6e65 7420 4c65 e Name="Janet Le │ │ │ +00218030: 7665 726c 696e 6722 2052 6567 696f 6e3d verling" Region= │ │ │ +00218040: 2257 4122 202f 2667 743b 0a26 6c74 3b45 "WA" />.<E │ │ │ +00218050: 6d70 4e61 6d65 204e 616d 653d 224d 6172 mpName Name="Mar │ │ │ +00218060: 6761 7265 7420 5065 6163 6f63 6b22 2052 garet Peacock" R │ │ │ +00218070: 6567 696f 6e3d 2257 4122 202f 2667 743b egion="WA" /> │ │ │ +00218080: 0a26 6c74 3b45 6d70 4e61 6d65 204e 616d .<EmpName Nam │ │ │ +00218090: 653d 2253 7465 7665 6e20 4275 6368 616e e="Steven Buchan │ │ │ +002180a0: 616e 2220 2f26 6774 3b0a 266c 743b 456d an" />.<Em │ │ │ +002180b0: 704e 616d 6520 4e61 6d65 3d22 4d69 6368 pName Name="Mich │ │ │ +002180c0: 6165 6c20 5375 7961 6d61 2220 2f26 6774 ael Suyama" /> │ │ │ +002180d0: 3b0a 266c 743b 456d 704e 616d 6520 4e61 ;.<EmpName Na │ │ │ +002180e0: 6d65 3d22 526f 6265 7274 204b 696e 6722 me="Robert King" │ │ │ +002180f0: 202f 2667 743b 0a26 6c74 3b45 6d70 4e61 />.<EmpNa │ │ │ +00218100: 6d65 204e 616d 653d 224c 6175 7261 2043 me Name="Laura C │ │ │ +00218110: 616c 6c61 6861 6e22 2052 6567 696f 6e3d allahan" Region= │ │ │ +00218120: 2257 4122 202f 2667 743b 0a26 6c74 3b45 "WA" />.<E │ │ │ +00218130: 6d70 4e61 6d65 204e 616d 653d 2241 6e6e mpName Name="Ann │ │ │ +00218140: 6520 446f 6473 776f 7274 6822 202f 2667 e Dodsworth" /&g │ │ │ +00218150: 743b 0a20 0a39 2052 6f77 732e 200a 2020 t;. .9 Rows. . │ │ │ +00218160: 2020 2020 203c 2f73 6372 6565 6e3e 0a20 . │ │ │ +00218170: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020
    . │ │ │ +00218180: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72
    . See Al │ │ │ +002181c0: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ +002181d0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>XMLELEMENT()< │ │ │ +00218200: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00218210: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 XMLFOREST() │ │ │ +00218240: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +00218250: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c XMLAGG().

    XMLCONCAT(). ........2demo │ │ │ +002182f0: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ +00218300: 7661 645f 6368 6563 6b5f 756e 696e 7374 vad_check_uninst │ │ │ +00218310: 616c 6c61 6269 6c69 7479 2e78 6d6c df00 allability.xml.. │ │ │ +00218320: 000e 383c 3f78 6d6c 2076 6572 7369 6f6e ..8.< │ │ │ +00218350: 212d 2d20 0a20 2d20 200a 202d 2020 5468 !-- . - . - Th │ │ │ +00218360: 6973 2066 696c 6520 6973 2070 6172 7420 is file is part │ │ │ +00218370: 6f66 2074 6865 204f 7065 6e4c 696e 6b20 of the OpenLink │ │ │ +00218380: 536f 6674 7761 7265 2056 6972 7475 6f73 Software Virtuos │ │ │ +00218390: 6f20 4f70 656e 2d53 6f75 7263 6520 2856 o Open-Source (V │ │ │ +002183a0: 4f53 290a 202d 2020 7072 6f6a 6563 742e OS). - project. │ │ │ +002183b0: 0a20 2d20 200a 202d 2020 436f 7079 7269 . - . - Copyri │ │ │ +002183c0: 6768 7420 2843 2920 3139 3938 2d32 3032 ght (C) 1998-202 │ │ │ +002183d0: 3420 4f70 656e 4c69 6e6b 2053 6f66 7477 4 OpenLink Softw │ │ │ +002183e0: 6172 650a 202d 2020 0a20 2d20 2054 6869 are. - . - Thi │ │ │ +002183f0: 7320 7072 6f6a 6563 7420 6973 2066 7265 s project is fre │ │ │ +00218400: 6520 736f 6674 7761 7265 3b20 796f 7520 e software; you │ │ │ +00218410: 6361 6e20 7265 6469 7374 7269 6275 7465 can redistribute │ │ │ +00218420: 2069 7420 616e 642f 6f72 206d 6f64 6966 it and/or modif │ │ │ +00218430: 7920 6974 0a20 2d20 2075 6e64 6572 2074 y it. - under t │ │ │ +00218440: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ +00218450: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +00218460: 6963 204c 6963 656e 7365 2061 7320 7075 ic License as pu │ │ │ +00218470: 626c 6973 6865 6420 6279 2074 6865 0a20 blished by the. │ │ │ +00218480: 2d20 2046 7265 6520 536f 6674 7761 7265 - Free Software │ │ │ +00218490: 2046 6f75 6e64 6174 696f 6e3b 206f 6e6c Foundation; onl │ │ │ +002184a0: 7920 7665 7273 696f 6e20 3220 6f66 2074 y version 2 of t │ │ │ +002184b0: 6865 204c 6963 656e 7365 2c20 6461 7465 he License, date │ │ │ +002184c0: 6420 4a75 6e65 2031 3939 312e 0a20 2d20 d June 1991.. - │ │ │ +002184d0: 200a 202d 2020 5468 6973 2070 726f 6772 . - This progr │ │ │ +002184e0: 616d 2069 7320 6469 7374 7269 6275 7465 am is distribute │ │ │ +002184f0: 6420 696e 2074 6865 2068 6f70 6520 7468 d in the hope th │ │ │ +00218500: 6174 2069 7420 7769 6c6c 2062 6520 7573 at it will be us │ │ │ +00218510: 6566 756c 2c20 6275 740a 202d 2020 5749 eful, but. - WI │ │ │ +00218520: 5448 4f55 5420 414e 5920 5741 5252 414e THOUT ANY WARRAN │ │ │ +00218530: 5459 3b20 7769 7468 6f75 7420 6576 656e TY; without even │ │ │ +00218540: 2074 6865 2069 6d70 6c69 6564 2077 6172 the implied war │ │ │ +00218550: 7261 6e74 7920 6f66 0a20 2d20 204d 4552 ranty of. - MER │ │ │ +00218560: 4348 414e 5441 4249 4c49 5459 206f 7220 CHANTABILITY or │ │ │ +00218570: 4649 544e 4553 5320 464f 5220 4120 5041 FITNESS FOR A PA │ │ │ +00218580: 5254 4943 554c 4152 2050 5552 504f 5345 RTICULAR PURPOSE │ │ │ +00218590: 2e20 5365 6520 7468 6520 474e 550a 202d . See the GNU. - │ │ │ +002185a0: 2020 4765 6e65 7261 6c20 5075 626c 6963 General Public │ │ │ +002185b0: 204c 6963 656e 7365 2066 6f72 206d 6f72 License for mor │ │ │ +002185c0: 6520 6465 7461 696c 732e 0a20 2d20 200a e details.. - . │ │ │ +002185d0: 202d 2020 596f 7520 7368 6f75 6c64 2068 - You should h │ │ │ +002185e0: 6176 6520 7265 6365 6976 6564 2061 2063 ave received a c │ │ │ +002185f0: 6f70 7920 6f66 2074 6865 2047 4e55 2047 opy of the GNU G │ │ │ +00218600: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ +00218610: 6365 6e73 6520 616c 6f6e 670a 202d 2020 cense along. - │ │ │ +00218620: 7769 7468 2074 6869 7320 7072 6f67 7261 with this progra │ │ │ +00218630: 6d3b 2069 6620 6e6f 742c 2077 7269 7465 m; if not, write │ │ │ +00218640: 2074 6f20 7468 6520 4672 6565 2053 6f66 to the Free Sof │ │ │ +00218650: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ +00218660: 2c20 496e 632e 2c0a 202d 2020 3531 2046 , Inc.,. - 51 F │ │ │ +00218670: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ +00218680: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ +00218690: 204d 4120 3032 3131 302d 3133 3031 2055 MA 02110-1301 U │ │ │ +002186a0: 5341 0a20 2d20 200a 202d 2020 0a2d 2d3e SA. - . - .--> │ │ │ +002186b0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. │ │ │ +002186e0: 203c 7265 666d 6574 613e 200a 2020 2020 . │ │ │ +002186f0: 3c72 6566 656e 7472 7974 6974 6c65 3e56 V │ │ │ +00218700: 4144 5f43 4845 434b 5f55 4e49 4e53 5441 AD_CHECK_UNINSTA │ │ │ +00218710: 4c4c 4142 494c 4954 593c 2f72 6566 656e LLABILITY . < │ │ │ +00218730: 7265 666d 6973 6369 6e66 6f3e 7661 643c refmiscinfo>vad< │ │ │ +00218740: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +00218750: 3c2f 7265 666d 6574 613e 200a 2020 3c72 . . │ │ │ +00218770: 3c72 6566 6e61 6d65 3e56 4144 5f43 4845 VAD_CHE │ │ │ +00218780: 434b 5f55 4e49 4e53 5441 4c4c 4142 494c CK_UNINSTALLABIL │ │ │ +00218790: 4954 593c 2f72 6566 6e61 6d65 3e20 0a20 ITY . │ │ │ +002187a0: 2020 203c 7265 6670 7572 706f 7365 3e43 C │ │ │ +002187b0: 6865 636b 7320 6966 2074 6865 2070 6163 hecks if the pac │ │ │ +002187c0: 6b61 6765 2063 616e 2062 6520 756e 696e kage can be unin │ │ │ +002187d0: 7374 616c 6c65 642e 3c2f 7265 6670 7572 stalled.. . . < │ │ │ +00218810: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +00218820: 2266 7379 6e5f 7661 645f 6368 6563 6b5f "fsyn_vad_check_ │ │ │ +00218830: 756e 696e 7374 616c 6c61 6269 6c69 7479 uninstallability │ │ │ +00218840: 223e 200a 2020 2020 2020 3c66 756e 6370 "> . │ │ │ +00218880: 0a20 2020 2020 2020 203c 6675 6e63 6465 . varchar DB.DBA │ │ │ +002188a0: 2e3c 6675 6e63 7469 6f6e 3e56 4144 5f43 .VAD_C │ │ │ +002188b0: 4845 434b 5f55 4e49 4e53 5441 4c4c 4142 HECK_UNINSTALLAB │ │ │ +002188c0: 494c 4954 593c 2f66 756e 6374 696f 6e3e ILITY │ │ │ +002188d0: 3c2f 6675 6e63 6465 663e 200a 093c 7061 ..in package_nam │ │ │ +00218900: 6520 3c2f 7061 7261 6d65 7465 723e 7661 e va │ │ │ +00218910: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +00218920: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ +00218960: 2020 3c72 6566 7365 6374 3120 6964 3d22 Des │ │ │ +00218980: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ +00218990: 0a20 203c 7061 7261 3e43 6865 636b 7320 . Checks │ │ │ +002189a0: 6966 2074 6865 2070 6163 6b61 6765 2063 if the package c │ │ │ +002189b0: 616e 2062 6520 756e 696e 7374 616c 6c65 an be uninstalle │ │ │ +002189c0: 642e 2049 7420 646f 6573 206e 6f74 2065 d. It does not e │ │ │ +002189d0: 7865 6375 7465 7320 616e 7920 0a20 2070 xecutes any . p │ │ │ +002189e0: 7265 2d75 6e69 6e73 7461 6c6c 2056 6972 re-uninstall Vir │ │ │ +002189f0: 7475 6f73 6f2f 504c 2063 6f64 6520 6672 tuoso/PL code fr │ │ │ +00218a00: 6f6d 2074 6865 2070 6163 6b61 6765 2c20 om the package, │ │ │ +00218a10: 736f 2074 6865 7265 2069 7320 6e6f 2067 so there is no g │ │ │ +00218a20: 7561 7261 6e74 6565 2074 6861 7420 0a20 uarantee that . │ │ │ +00218a30: 2075 6e69 6e73 7461 6c6c 6174 696f 6e20 uninstallation │ │ │ +00218a40: 7769 6c6c 2062 6520 7375 6363 6573 7366 will be successf │ │ │ +00218a50: 756c 2069 6620 7468 6520 6368 6563 6b20 ul if the check │ │ │ +00218a60: 666f 756e 6420 6e6f 2065 7272 6f72 2e3c found no error.< │ │ │ +00218a70: 2f70 6172 613e 3c2f 7265 6673 6563 7431 /para>. Parameters</tit │ │ │ +00218ab0: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ +00218ac0: 323e 3c74 6974 6c65 3e70 6163 6b61 6765 2><title>package │ │ │ +00218ad0: 5f6e 616d 653c 2f74 6974 6c65 3e0a 2020 _name. │ │ │ +00218ae0: 2020 2020 3c70 6172 613e 6e61 6d65 206f name o │ │ │ +00218af0: 6620 7061 636b 6167 6520 272f 2720 7665 f package '/' ve │ │ │ +00218b00: 7273 696f 6e20 652e 673a 2027 7669 7274 rsion e.g: 'virt │ │ │ +00218b10: 6f64 702f 312e 3027 3c2f 7061 7261 3e3c odp/1.0'< │ │ │ +00218b20: 2f72 6566 7365 6374 323e 0a20 203c 2f72 /refsect2>. ..< │ │ │ +00218b90: 212d 2d20 0a20 203c 7265 6673 6563 7431 !-- . Errors. Errors sign │ │ │ +00218be0: 616c 6c65 6420 6279 3c2f 7469 746c 653e alled by │ │ │ +00218bf0: 0a20 2020 2020 203c 7467 726f 7570 2063 . . │ │ │ +00218c10: 3c74 6865 6164 3e3c 726f 773e 3c65 6e74 SQLStateError │ │ │ +00218c40: 436f 6465 3c2f 656e 7472 793e 3c65 6e74 CodeError TextDesc │ │ │ +00218c70: 7269 7074 696f 6e3c 2f65 6e74 7279 3e3c ription< │ │ │ +00218c80: 2f72 6f77 3e3c 2f74 6865 6164 3e0a 093c /row>..< │ │ │ +00218c90: 7462 6f64 793e 0a09 2020 3c72 6f77 3e0a tbody>.. . │ │ │ +00218ca0: 0920 2020 203c 656e 7472 793e 3c65 7272 . .. │ │ │ +00218cd0: 203c 656e 7472 793e 3c65 7272 6f72 636f < │ │ │ +00218cf0: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. < │ │ │ +00218d10: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname>.. │ │ │ +00218d30: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f .. ... │ │ │ +00218d50: 2020 203c 2f74 6772 6f75 703e 0a20 2020 . │ │ │ +00218d60: 203c 2f74 6162 6c65 3e0a 2020 3c2f 7265
    . . Example │ │ │ +00218da0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. │ │ │ +00218dc0: 3c74 6974 6c65 3e3c 2f74 6974 6c65 3e0a . │ │ │ +00218dd0: 2020 2020 2020 3c70 6172 613e 3c2f 7061 . . │ │ │ +00218e00: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . .-->. < │ │ │ +00218e20: 7265 6673 6563 7431 2069 643d 2273 6565 refsect1 id="see │ │ │ +00218e30: 616c 736f 223e 3c74 6974 6c65 3e53 6565 also">See │ │ │ +00218e40: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ +00218e50: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 vad_fail_che │ │ │ +00218e90: 636b 2829 3c2f 6675 6e63 7469 6f6e 3e3c ck()< │ │ │ +00218ea0: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00218eb0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 va │ │ │ +00218ef0: 645f 6368 6563 6b5f 696e 7374 616c 6c61 d_check_installa │ │ │ +00218f00: 6269 6c69 7479 2829 3c2f 6675 6e63 7469 bility(). vad_install │ │ │ +00218f60: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ +00218f80: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b vad_ │ │ │ +00218fb0: 7061 636b 2829 3c2f 6675 6e63 7469 6f6e pack(). │ │ │ +00218fd0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 vad_safe_ex │ │ │ +00219010: 6563 2829 3c2f 6675 6e63 7469 6f6e 3e3c ec()< │ │ │ +00219020: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00219030: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 vad_uninstall │ │ │ +00219070: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ +00219090: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b vad_load_file() │ │ │ +002190d0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    vad_c │ │ │ +00219120: 6865 636b 2829 3c2f 6675 6e63 7469 6f6e heck(). │ │ │ +00219140: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f .......& │ │ │ +00219160: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ +00219170: 7265 662f 6461 765f 6170 695f 7365 6172 ref/dav_api_sear │ │ │ +00219180: 6368 2e78 6d6c df00 0020 c23c 3f78 6d6c ch.xml... .... . DAV se │ │ │ +00219560: 6172 6368 2066 756e 6374 696f 6e73 3c2f arch functions. │ │ │ +00219580: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ +00219590: 7773 3c2f 7265 666d 6973 6369 6e66 6f3e ws │ │ │ +002195a0: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ +002195b0: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ +002195c0: 203c 7265 666e 616d 653e 4441 565f 5345 DAV_SE │ │ │ +002195d0: 4152 4348 5f49 443c 2f72 6566 6e61 6d65 ARCH_ID. D │ │ │ +002195f0: 4156 5f53 4541 5243 485f 5041 5448 3c2f AV_SEARCH_PATH. DAV_DIR_LI │ │ │ +00219620: 5354 3c2f 7265 666e 616d 653e 0a20 2020 ST. │ │ │ +00219630: 203c 7265 6670 7572 706f 7365 3e46 756e Fun │ │ │ +00219640: 6374 696f 6e73 2066 6f72 2073 6561 7263 ctions for searc │ │ │ +00219650: 6869 6e67 2061 2044 4156 2063 6f6c 6c65 hing a DAV colle │ │ │ +00219660: 6374 696f 6e20 6f72 2072 6573 6f75 7263 ction or resourc │ │ │ +00219670: 653c 2f72 6566 7075 7270 6f73 653e 0a20 e. │ │ │ +00219680: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +00219690: 203c 7265 6673 796e 6f70 7369 7364 6976 . . │ │ │ +002196d0: 2020 2020 3c66 756e 6370 726f 746f 7479 . │ │ │ +00219700: 2020 2020 2020 3c66 756e 6364 6566 3e69 i │ │ │ +00219710: 6e74 6567 6572 203c 6675 6e63 7469 6f6e nteger DAV_SEARCH_ID. in path varchar. │ │ │ +00219790: 3c70 6172 616d 6465 663e 696e 203c 7061 in what char(1) │ │ │ +002197c0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +002197d0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . < │ │ │ +00219860: 6675 6e63 6465 663e 7661 7263 6861 7220 funcdef>varchar │ │ │ +00219870: 3c66 756e 6374 696f 6e3e 4441 565f 5345 DAV_SE │ │ │ +00219880: 4152 4348 5f50 4154 483c 2f66 756e 6374 ARCH_PATH. │ │ │ +002198a0: 2020 2020 2020 203c 7061 7261 6d64 6566 in i │ │ │ +002198c0: 643c 2f70 6172 616d 6574 6572 3e20 696e d in │ │ │ +002198d0: 7465 6765 723c 2f70 6172 616d 6465 663e teger │ │ │ +002198e0: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in what char(1). . │ │ │ +00219940: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ +00219950: 2020 2020 3c66 756e 6373 796e 6f70 7369 . │ │ │ +00219980: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ +002199b0: 2020 3c66 756e 6364 6566 3e61 6e79 203c any < │ │ │ +002199c0: 6675 6e63 7469 6f6e 3e44 4156 5f44 4952 function>DAV_DIR │ │ │ +002199d0: 5f4c 4953 543c 2f66 756e 6374 696f 6e3e _LIST │ │ │ +002199e0: 3c2f 6675 6e63 6465 663e 0a20 2020 2020 . │ │ │ +002199f0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ +00219a00: 3c70 6172 616d 6574 6572 3e70 6174 683c path< │ │ │ +00219a10: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ +00219a20: 6861 723c 2f70 6172 616d 6465 663e 0a20 har. │ │ │ +00219a30: 2020 2020 2020 203c 7061 7261 6d64 6566 in r │ │ │ +00219a50: 6563 7572 7369 7665 3c2f 7061 7261 6d65 ecursive integer. │ │ │ +00219a80: 3c70 6172 616d 6465 663e 696e 203c 7061 in auth_uid │ │ │ +00219aa0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +00219ab0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +00219ac0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +00219ae0: 6175 7468 5f70 7764 3c2f 7061 7261 6d65 auth_pwd varchar. . │ │ │ +00219b20: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Description. DAV_SEARCH_ID() │ │ │ +00219ba0: 2072 6574 7572 6e73 2074 6865 2052 4553 returns the RES │ │ │ +00219bb0: 5f49 4420 6f72 2043 4f4c 5f49 442c 2064 _ID or COL_ID, d │ │ │ +00219bc0: 6570 656e 6469 6e67 206f 6e20 7468 650a epending on the. │ │ │ +00219bd0: 2020 2020 273c 7061 7261 6d65 7465 723e ' │ │ │ +00219be0: 7768 6174 3c2f 7061 7261 6d65 7465 723e what │ │ │ +00219bf0: 2720 7061 7261 6d65 7465 7220 7061 7373 ' parameter pass │ │ │ +00219c00: 6564 2e20 2827 5227 6573 6f75 7263 6520 ed. ('R'esource │ │ │ +00219c10: 6f72 2027 4327 6f6c 6c65 6374 696f 6e0a or 'C'ollection. │ │ │ +00219c20: 2020 2020 6f72 2027 5027 6172 656e 7420 or 'P'arent │ │ │ +00219c30: 636f 6c6c 6563 7469 6f6e 292e 3c2f 7061 collection).. DA │ │ │ +00219c50: 565f 5345 4152 4348 5f50 4154 4828 2920 V_SEARCH_PATH() │ │ │ +00219c60: 7265 7475 726e 7320 6675 6c6c 2070 6174 returns full pat │ │ │ +00219c70: 6820 7374 7269 6e67 206f 6620 7265 736f h string of reso │ │ │ +00219c80: 7572 6365 206f 7220 636f 6c6c 6563 7469 urce or collecti │ │ │ +00219c90: 6f6e 2c0a 2020 2020 6465 7065 6e64 696e on,. dependin │ │ │ +00219ca0: 6720 6f6e 2070 6172 616d 6574 6572 2070 g on parameter p │ │ │ +00219cb0: 6173 7365 642e 2028 2752 2765 736f 7572 assed. ('R'esour │ │ │ +00219cc0: 6365 206f 7220 2743 276f 6c6c 6563 7469 ce or 'C'ollecti │ │ │ +00219cd0: 6f6e 206f 720a 2020 2020 2750 2761 7265 on or. 'P'are │ │ │ +00219ce0: 6e74 2063 6f6c 6c65 6374 696f 6e29 2e3c nt collection).< │ │ │ +00219cf0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. DAV_DIR_LIST() │ │ │ +00219d10: 7265 7475 726e 7320 616e 2061 7272 6179 returns an array │ │ │ +00219d20: 206f 6620 6172 7261 7973 2074 6861 7420 of arrays that │ │ │ +00219d30: 636f 6e74 6169 6e73 2074 6865 0a20 2020 contains the. │ │ │ +00219d40: 2066 6f6c 6c6f 7769 6e67 2069 6e66 6f72 following infor │ │ │ +00219d50: 6d61 7469 6f6e 2061 626f 7574 2074 6865 mation about the │ │ │ +00219d60: 2072 6571 7565 7374 6564 2070 6174 683a requested path: │ │ │ +00219d70: 3c2f 7061 7261 3e0a 2020 2020 3c73 696d . . < │ │ │ +00219d90: 6d65 6d62 6572 3e66 756c 6c70 6174 683c member>fullpath< │ │ │ +00219da0: 2f6d 656d 6265 723e 0a20 2020 2020 203c /member>. < │ │ │ +00219db0: 6d65 6d62 6572 3e74 7970 6520 2827 7227 member>type ('r' │ │ │ +00219dc0: 206f 7220 2763 2729 2077 6869 6368 2069 or 'c') which i │ │ │ +00219dd0: 6e64 6963 6174 6573 2072 6573 6f75 7263 ndicates resourc │ │ │ +00219de0: 6520 6f72 2063 6f6c 6c65 6374 696f 6e2e e or collection. │ │ │ +00219df0: 3c2f 6d65 6d62 6572 3e0a 2020 2020 2020 . │ │ │ +00219e00: 3c6d 656d 6265 723e 6c65 6e67 7468 3c2f length. modificati │ │ │ +00219e30: 6f6e 2074 696d 653c 2f6d 656d 6265 723e on time │ │ │ +00219e40: 0a20 2020 2020 203c 6d65 6d62 6572 3e69 . i │ │ │ +00219e50: 643c 2f6d 656d 6265 723e 0a20 2020 2020 d. │ │ │ +00219e60: 203c 6d65 6d62 6572 3e70 6572 6d69 7373 permiss │ │ │ +00219e70: 696f 6e73 3c2f 6d65 6d62 6572 3e0a 2020 ions. │ │ │ +00219e80: 2020 2020 3c6d 656d 6265 723e 6772 6f75 grou │ │ │ +00219e90: 7020 6964 3c2f 6d65 6d62 6572 3e0a 2020 p id. │ │ │ +00219ea0: 2020 2020 3c6d 656d 6265 723e 6f77 6e65 owne │ │ │ +00219eb0: 7220 6964 3c2f 6d65 6d62 6572 3e0a 2020 r id. │ │ │ +00219ec0: 2020 2020 3c6d 656d 6265 723e 6372 6561 crea │ │ │ +00219ed0: 7465 643c 2f6d 656d 6265 723e 0a20 2020 ted. │ │ │ +00219ee0: 2020 203c 6d65 6d62 6572 3e6d 696d 6520 mime │ │ │ +00219ef0: 7479 7065 3c2f 6d65 6d62 6572 3e0a 2020 type. │ │ │ +00219f00: 2020 3c2f 7369 6d70 6c65 6c69 7374 3e0a . │ │ │ +00219f10: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +00219f20: 3c72 6566 7365 6374 3120 6964 3d22 7061 Para │ │ │ +00219f50: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ +00219f60: 2020 203c 7265 6673 6563 7432 3e3c 7469 path │ │ │ +00219f80: 0a20 2020 2020 203c 7061 7261 3e4e 616d . Nam │ │ │ +00219f90: 6520 6f66 2044 4156 206c 6f63 6174 696f e of DAV locatio │ │ │ +00219fa0: 6e20 746f 2073 6561 7263 682e 3c2f 7061 n to search.. . what</t │ │ │ +00219fe0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +00219ff0: 613e 5468 6520 7479 7065 206f 6620 4441 a>The type of DA │ │ │ +0021a000: 5620 6974 656d 2074 6f20 7365 6172 6368 V item to search │ │ │ +0021a010: 2066 6f72 3a20 2752 2720 666f 7220 7265 for: 'R' for re │ │ │ +0021a020: 736f 7572 6365 2c0a 2020 2020 2020 2743 source,. 'C │ │ │ +0021a030: 2720 666f 7220 636f 6c6c 6563 7469 6f6e ' for collection │ │ │ +0021a040: 206f 7220 2750 2720 666f 7220 7061 7265 or 'P' for pare │ │ │ +0021a050: 6e74 2063 6f6c 6c65 6374 696f 6e2e 3c2f nt collection.</ │ │ │ +0021a060: 7061 7261 3e0a 2020 2020 3c2f 7265 6673 para>. </refs │ │ │ +0021a070: 6563 7432 3e0a 2020 2020 3c72 6566 7365 ect2>. <refse │ │ │ +0021a080: 6374 323e 3c74 6974 6c65 3e69 643c 2f74 ct2><title>id</t │ │ │ +0021a090: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +0021a0a0: 613e 4964 656e 7469 6669 6572 206f 6620 a>Identifier of │ │ │ +0021a0b0: 7265 736f 7572 6365 206f 7220 636f 6c6c resource or coll │ │ │ +0021a0c0: 6563 7469 6f6e 2c20 666f 7220 6578 616d ection, for exam │ │ │ +0021a0d0: 706c 650a 2020 2020 2020 6672 6f6d 2044 ple. from D │ │ │ +0021a0e0: 4156 5f53 4541 5243 485f 4944 2829 2e3c AV_SEARCH_ID().< │ │ │ +0021a0f0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. </ref │ │ │ +0021a100: 7365 6374 323e 0a20 2020 203c 7265 6673 sect2>. <refs │ │ │ +0021a110: 6563 7432 3e3c 7469 746c 653e 7265 6375 ect2><title>recu │ │ │ +0021a120: 7273 6976 653c 2f74 6974 6c65 3e0a 2020 rsive. │ │ │ +0021a130: 2020 2020 3c70 6172 613e 4966 206e 6f6e If non │ │ │ +0021a140: 207a 6572 6f20 7468 656e 2072 6563 7572 zero then recur │ │ │ +0021a150: 7365 2069 6e74 6f20 7375 6264 6972 6563 se into subdirec │ │ │ +0021a160: 746f 7269 6573 2064 7572 696e 6720 7468 tories during th │ │ │ +0021a170: 6520 7365 6172 6368 2e0a 2020 2020 2020 e search.. │ │ │ +0021a180: 4465 6661 756c 7420 6973 2030 2077 6869 Default is 0 whi │ │ │ +0021a190: 6368 2063 6175 7365 7320 6120 7365 6172 ch causes a sear │ │ │ +0021a1a0: 6368 2069 6e20 6375 7272 656e 7420 7061 ch in current pa │ │ │ +0021a1b0: 7468 206f 6e6c 792e 3c2f 7061 7261 3e0a th only.. │ │ │ +0021a1c0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ +0021a1d0: 2020 2020 3c72 6566 7365 6374 323e 3c74 auth_uid. Administration │ │ │ +0021a210: 2075 7365 7220 6361 7061 626c 6520 6f66 user capable of │ │ │ +0021a220: 2070 6572 666f 726d 696e 6720 7468 6520 performing the │ │ │ +0021a230: 6f70 6572 6174 696f 6e2e 0a20 2020 2020 operation.. │ │ │ +0021a240: 2044 6566 6175 6c74 2069 7320 6e75 6c6c Default is null │ │ │ +0021a250: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . au │ │ │ +0021a280: 7468 5f70 7764 3c2f 7469 746c 653e 0a20 th_pwd. │ │ │ +0021a290: 2020 2020 203c 7061 7261 3e50 6173 7377 Passw │ │ │ +0021a2a0: 6f72 6420 6f66 2041 646d 696e 6973 7472 ord of Administr │ │ │ +0021a2b0: 6174 6f72 2e20 4465 6661 756c 7420 6973 ator. Default is │ │ │ +0021a2c0: 206e 756c 6c2e 3c2f 7061 7261 3e0a 2020 null.. │ │ │ +0021a2d0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +0021a2e0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . Errors │ │ │ +0021a320: 3c2f 7469 746c 653e 0a20 2020 203c 7461 . Error │ │ │ +0021a340: 7320 7369 676e 616c 6c65 6420 6279 2044 s signalled by D │ │ │ +0021a350: 4156 5f2a 2066 756e 6374 696f 6e73 3c2f AV_* functions</ │ │ │ +0021a360: 7469 746c 653e 0a20 2020 2020 203c 7467 title>. <tg │ │ │ +0021a370: 726f 7570 2063 6f6c 733d 2232 223e 0a20 roup cols="2">. │ │ │ +0021a380: 2020 2020 2020 3c74 6865 6164 3e3c 726f <thead><ro │ │ │ +0021a390: 773e 3c65 6e74 7279 3e45 7272 6f72 2043 w><entry>Error C │ │ │ +0021a3a0: 6f64 653c 2f65 6e74 7279 3e3c 656e 7472 ode</entry><entr │ │ │ +0021a3b0: 793e 4465 7363 7269 7074 696f 6e3c 2f65 y>Description</e │ │ │ +0021a3c0: 6e74 7279 3e3c 2f72 6f77 3e3c 2f74 6865 ntry></row></the │ │ │ +0021a3d0: 6164 3e0a 093c 7462 6f64 793e 0a09 2020 ad>..<tbody>.. │ │ │ +0021a3e0: 3c72 6f77 3e3c 656e 7472 793e 3c65 7272 <row><entry><err │ │ │ +0021a3f0: 6f72 636f 6465 3e26 6774 3b3d 303c 2f65 orcode>>=0</e │ │ │ +0021a400: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0021a410: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021a420: 7272 6f72 6e61 6d65 3e73 7563 6365 7373 rrorname>success │ │ │ +0021a430: 3c2f 6572 726f 726e 616d 653e 3c2f 656e </errorname></en │ │ │ +0021a440: 7472 793e 3c2f 726f 773e 0a09 2020 3c72 try></row>.. <r │ │ │ +0021a450: 6f77 3e3c 656e 7472 793e 3c65 7272 6f72 ow><entry><error │ │ │ +0021a460: 636f 6465 3e2d 313c 2f65 7272 6f72 636f code>-1</errorco │ │ │ +0021a470: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ +0021a480: 203c 656e 7472 793e 3c65 7272 6f72 6e61 <entry><errorna │ │ │ +0021a490: 6d65 3e54 6865 2070 6174 6820 2874 6172 me>The path (tar │ │ │ +0021a4a0: 6765 7420 6f66 206f 7065 7261 7469 6f6e get of operation │ │ │ +0021a4b0: 2920 6973 206e 6f74 2076 616c 6964 3c2f ) is not valid</ │ │ │ +0021a4c0: 6572 726f 726e 616d 653e 3c2f 656e 7472 errorname></entr │ │ │ +0021a4d0: 793e 3c2f 726f 773e 0a09 2020 3c72 6f77 y></row>.. <row │ │ │ +0021a4e0: 3e3c 656e 7472 793e 3c65 7272 6f72 636f ><entry><errorco │ │ │ +0021a4f0: 6465 3e2d 323c 2f65 7272 6f72 636f 6465 de>-2</errorcode │ │ │ +0021a500: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ +0021a510: 656e 7472 793e 3c65 7272 6f72 6e61 6d65 entry><errorname │ │ │ +0021a520: 3e54 6865 2064 6573 7469 6e61 7469 6f6e >The destination │ │ │ +0021a530: 2028 7061 7468 2920 6973 206e 6f74 2076 (path) is not v │ │ │ +0021a540: 616c 6964 3c2f 6572 726f 726e 616d 653e alid</errorname> │ │ │ +0021a550: 3c2f 656e 7472 793e 3c2f 726f 773e 0a09 </entry></row>.. │ │ │ +0021a560: 2020 3c72 6f77 3e3c 656e 7472 793e 3c65 <row><entry><e │ │ │ +0021a570: 7272 6f72 636f 6465 3e2d 333c 2f65 7272 rrorcode>-3</err │ │ │ +0021a580: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ +0021a590: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ +0021a5a0: 6f72 6e61 6d65 3e4f 7665 7277 7269 7465 orname>Overwrite │ │ │ +0021a5b0: 2066 6c61 6720 6973 206e 6f74 2073 6574 flag is not set │ │ │ +0021a5c0: 2061 6e64 2064 6573 7469 6e61 7469 6f6e and destination │ │ │ +0021a5d0: 2065 7869 7374 733c 2f65 7272 6f72 6e61 exists</errorna │ │ │ +0021a5e0: 6d65 3e3c 2f65 6e74 7279 3e3c 2f72 6f77 me></entry></row │ │ │ +0021a5f0: 3e0a 0920 203c 726f 773e 3c65 6e74 7279 >.. <row><entry │ │ │ +0021a600: 3e3c 6572 726f 7263 6f64 653e 2d34 3c2f ><errorcode>-4</ │ │ │ +0021a610: 6572 726f 7263 6f64 653e 3c2f 656e 7472 errorcode></entr │ │ │ +0021a620: 793e 0a09 2020 2020 3c65 6e74 7279 3e3c y>.. <entry>< │ │ │ +0021a630: 6572 726f 726e 616d 653e 5468 6520 7461 errorname>The ta │ │ │ +0021a640: 7267 6574 2069 7320 7265 736f 7572 6365 rget is resource │ │ │ +0021a650: 2c20 6275 7420 736f 7572 6365 2069 7320 , but source is │ │ │ +0021a660: 636f 6c6c 6563 7469 6f6e 2028 696e 2063 collection (in c │ │ │ +0021a670: 6f70 7920 6d6f 7665 206f 7065 7261 7469 opy move operati │ │ │ +0021a680: 6f6e 7329 3c2f 6572 726f 726e 616d 653e ons)</errorname> │ │ │ +0021a690: 3c2f 656e 7472 793e 3c2f 726f 773e 0a09 </entry></row>.. │ │ │ +0021a6a0: 2020 3c72 6f77 3e3c 656e 7472 793e 3c65 <row><entry><e │ │ │ +0021a6b0: 7272 6f72 636f 6465 3e2d 353c 2f65 7272 rrorcode>-5</err │ │ │ +0021a6c0: 6f72 636f 6465 3e3c 2f65 6e74 7279 3e0a orcode></entry>. │ │ │ +0021a6d0: 0920 2020 203c 656e 7472 793e 3c65 7272 . <entry><err │ │ │ +0021a6e0: 6f72 6e61 6d65 3e50 6572 6d69 7373 696f orname>Permissio │ │ │ +0021a6f0: 6e73 2061 7265 206e 6f74 2076 616c 6964 ns are not valid │ │ │ +0021a700: 3c2f 6572 726f 726e 616d 653e 3c2f 656e </errorname></en │ │ │ +0021a710: 7472 793e 3c2f 726f 773e 0a09 2020 3c72 try></row>.. <r │ │ │ +0021a720: 6f77 3e3c 656e 7472 793e 3c65 7272 6f72 ow><entry><error │ │ │ +0021a730: 636f 6465 3e2d 363c 2f65 7272 6f72 636f code>-6</errorco │ │ │ +0021a740: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ +0021a750: 203c 656e 7472 793e 3c65 7272 6f72 6e61 <entry><errorna │ │ │ +0021a760: 6d65 3e75 6964 2069 7320 6e6f 7420 7661 me>uid is not va │ │ │ +0021a770: 6c69 643c 2f65 7272 6f72 6e61 6d65 3e3c lid</errorname>< │ │ │ +0021a780: 2f65 6e74 7279 3e3c 2f72 6f77 3e0a 0920 /entry></row>.. │ │ │ +0021a790: 203c 726f 773e 3c65 6e74 7279 3e3c 6572 <row><entry><er │ │ │ +0021a7a0: 726f 7263 6f64 653e 2d37 3c2f 6572 726f rorcode>-7</erro │ │ │ +0021a7b0: 7263 6f64 653e 3c2f 656e 7472 793e 0a09 rcode></entry>.. │ │ │ +0021a7c0: 2020 2020 3c65 6e74 7279 3e3c 6572 726f <entry><erro │ │ │ +0021a7d0: 726e 616d 653e 6769 6420 6973 206e 6f74 rname>gid is not │ │ │ +0021a7e0: 2076 616c 6964 3c2f 6572 726f 726e 616d valid</errornam │ │ │ +0021a7f0: 653e 3c2f 656e 7472 793e 3c2f 726f 773e e></entry></row> │ │ │ +0021a800: 0a09 2020 3c72 6f77 3e3c 656e 7472 793e .. <row><entry> │ │ │ +0021a810: 3c65 7272 6f72 636f 6465 3e2d 383c 2f65 <errorcode>-8</e │ │ │ +0021a820: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0021a830: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021a840: 7272 6f72 6e61 6d65 3e54 6172 6765 7420 rrorname>Target │ │ │ +0021a850: 6973 206c 6f63 6b65 643c 2f65 7272 6f72 is locked</error │ │ │ +0021a860: 6e61 6d65 3e3c 2f65 6e74 7279 3e3c 2f72 name></entry></r │ │ │ +0021a870: 6f77 3e0a 0920 203c 726f 773e 3c65 6e74 ow>.. <row><ent │ │ │ +0021a880: 7279 3e3c 6572 726f 7263 6f64 653e 2d39 ry><errorcode>-9 │ │ │ +0021a890: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e </errorcode></en │ │ │ +0021a8a0: 7472 793e 0a09 2020 2020 3c65 6e74 7279 try>.. <entry │ │ │ +0021a8b0: 3e3c 6572 726f 726e 616d 653e 4465 7374 ><errorname>Dest │ │ │ +0021a8c0: 696e 6174 696f 6e20 6973 206c 6f63 6b65 ination is locke │ │ │ +0021a8d0: 643c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 d</errorname></e │ │ │ +0021a8e0: 6e74 7279 3e3c 2f72 6f77 3e0a 0920 203c ntry></row>.. < │ │ │ +0021a8f0: 726f 773e 3c65 6e74 7279 3e3c 6572 726f row><entry><erro │ │ │ +0021a900: 7263 6f64 653e 2d31 303c 2f65 7272 6f72 rcode>-10</error │ │ │ +0021a910: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ +0021a920: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ +0021a930: 6e61 6d65 3e50 726f 7065 7274 7920 6e61 name>Property na │ │ │ +0021a940: 6d65 2069 7320 7265 7365 7276 6564 2028 me is reserved ( │ │ │ +0021a950: 7072 6f74 6563 7465 6420 6f72 2070 7269 protected or pri │ │ │ +0021a960: 7661 7465 293c 2f65 7272 6f72 6e61 6d65 vate)</errorname │ │ │ +0021a970: 3e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a ></entry></row>. │ │ │ +0021a980: 0920 203c 726f 773e 3c65 6e74 7279 3e3c . <row><entry>< │ │ │ +0021a990: 6572 726f 7263 6f64 653e 2d31 313c 2f65 errorcode>-11</e │ │ │ +0021a9a0: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0021a9b0: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021a9c0: 7272 6f72 6e61 6d65 3e50 726f 7065 7274 rrorname>Propert │ │ │ +0021a9d0: 7920 646f 6573 206e 6f74 2065 7869 7374 y does not exist │ │ │ +0021a9e0: 3c2f 6572 726f 726e 616d 653e 3c2f 656e </errorname></en │ │ │ +0021a9f0: 7472 793e 3c2f 726f 773e 0a09 2020 3c72 try></row>.. <r │ │ │ +0021aa00: 6f77 3e3c 656e 7472 793e 3c65 7272 6f72 ow><entry><error │ │ │ +0021aa10: 636f 6465 3e2d 3132 3c2f 6572 726f 7263 code>-12</errorc │ │ │ +0021aa20: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ +0021aa30: 2020 3c65 6e74 7279 3e3c 6572 726f 726e <entry><errorn │ │ │ +0021aa40: 616d 653e 4175 7468 656e 7469 6361 7469 ame>Authenticati │ │ │ +0021aa50: 6f6e 2066 6169 6c65 643c 2f65 7272 6f72 on failed</error │ │ │ +0021aa60: 6e61 6d65 3e3c 2f65 6e74 7279 3e3c 2f72 name></entry></r │ │ │ +0021aa70: 6f77 3e0a 0920 203c 726f 773e 3c65 6e74 ow>.. <row><ent │ │ │ +0021aa80: 7279 3e3c 6572 726f 7263 6f64 653e 2d31 ry><errorcode>-1 │ │ │ +0021aa90: 333c 2f65 7272 6f72 636f 6465 3e3c 2f65 3</errorcode></e │ │ │ +0021aaa0: 6e74 7279 3e0a 0920 2020 203c 656e 7472 ntry>.. <entr │ │ │ +0021aab0: 793e 3c65 7272 6f72 6e61 6d65 3e4f 7065 y><errorname>Ope │ │ │ +0021aac0: 7261 7469 6f6e 2069 7320 666f 7262 6964 ration is forbid │ │ │ +0021aad0: 6465 6e20 2874 6865 2061 7574 6865 6e74 den (the authent │ │ │ +0021aae0: 6963 6174 6564 2075 7365 7220 646f 206e icated user do n │ │ │ +0021aaf0: 6f74 2068 6176 6520 6120 7065 726d 6973 ot have a permis │ │ │ +0021ab00: 7369 6f6e 7320 666f 7220 7468 6520 6163 sions for the ac │ │ │ +0021ab10: 7469 6f6e 293c 2f65 7272 6f72 6e61 6d65 tion)</errorname │ │ │ +0021ab20: 3e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a ></entry></row>. │ │ │ +0021ab30: 0920 203c 726f 773e 3c65 6e74 7279 3e3c . <row><entry>< │ │ │ +0021ab40: 6572 726f 7263 6f64 653e 2d31 343c 2f65 errorcode>-14</e │ │ │ +0021ab50: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0021ab60: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021ab70: 7272 6f72 6e61 6d65 3e74 6865 2074 6172 rrorname>the tar │ │ │ +0021ab80: 6765 7420 7479 7065 2069 7320 6e6f 7420 get type is not │ │ │ +0021ab90: 7661 6c69 643c 2f65 7272 6f72 6e61 6d65 valid</errorname │ │ │ +0021aba0: 3e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e0a ></entry></row>. │ │ │ +0021abb0: 0920 203c 726f 773e 3c65 6e74 7279 3e3c . <row><entry>< │ │ │ +0021abc0: 6572 726f 7263 6f64 653e 2d31 353c 2f65 errorcode>-15</e │ │ │ +0021abd0: 7272 6f72 636f 6465 3e3c 2f65 6e74 7279 rrorcode></entry │ │ │ +0021abe0: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021abf0: 7272 6f72 6e61 6d65 3e54 6865 2075 6d61 rrorname>The uma │ │ │ +0021ac00: 736b 2069 7320 6e6f 7420 7661 6c69 643c sk is not valid< │ │ │ +0021ac10: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ +0021ac20: 7279 3e3c 2f72 6f77 3e0a 0920 203c 726f ry></row>.. <ro │ │ │ +0021ac30: 773e 3c65 6e74 7279 3e3c 6572 726f 7263 w><entry><errorc │ │ │ +0021ac40: 6f64 653e 2d31 363c 2f65 7272 6f72 636f ode>-16</errorco │ │ │ +0021ac50: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ +0021ac60: 203c 656e 7472 793e 3c65 7272 6f72 6e61 <entry><errorna │ │ │ +0021ac70: 6d65 3e54 6865 2070 726f 7065 7274 7920 me>The property │ │ │ +0021ac80: 616c 7265 6164 7920 6578 6973 7473 3c2f already exists</ │ │ │ +0021ac90: 6572 726f 726e 616d 653e 3c2f 656e 7472 errorname></entr │ │ │ +0021aca0: 793e 3c2f 726f 773e 0a09 2020 3c72 6f77 y></row>.. <row │ │ │ +0021acb0: 3e3c 656e 7472 793e 3c65 7272 6f72 636f ><entry><errorco │ │ │ +0021acc0: 6465 3e2d 3137 3c2f 6572 726f 7263 6f64 de>-17</errorcod │ │ │ +0021acd0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ +0021ace0: 3c65 6e74 7279 3e3c 6572 726f 726e 616d <entry><errornam │ │ │ +0021acf0: 653e 496e 7661 6c69 6420 7072 6f70 6572 e>Invalid proper │ │ │ +0021ad00: 7479 2076 616c 7565 3c2f 6572 726f 726e ty value</errorn │ │ │ +0021ad10: 616d 653e 3c2f 656e 7472 793e 3c2f 726f ame></entry></ro │ │ │ +0021ad20: 773e 0a09 2020 3c72 6f77 3e3c 656e 7472 w>.. <row><entr │ │ │ +0021ad30: 793e 3c65 7272 6f72 636f 6465 3e2d 3138 y><errorcode>-18 │ │ │ +0021ad40: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e </errorcode></en │ │ │ +0021ad50: 7472 793e 0a09 2020 2020 3c65 6e74 7279 try>.. <entry │ │ │ +0021ad60: 3e3c 6572 726f 726e 616d 653e 6e6f 2073 ><errorname>no s │ │ │ +0021ad70: 7563 6820 7573 6572 3c2f 6572 726f 726e uch user</errorn │ │ │ +0021ad80: 616d 653e 3c2f 656e 7472 793e 3c2f 726f ame></entry></ro │ │ │ +0021ad90: 773e 0a09 2020 3c72 6f77 3e3c 656e 7472 w>.. <row><entr │ │ │ +0021ada0: 793e 3c65 7272 6f72 636f 6465 3e2d 3139 y><errorcode>-19 │ │ │ +0021adb0: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e </errorcode></en │ │ │ +0021adc0: 7472 793e 0a09 2020 2020 3c65 6e74 7279 try>.. <entry │ │ │ +0021add0: 3e3c 6572 726f 726e 616d 653e 6e6f 2068 ><errorname>no h │ │ │ +0021ade0: 6f6d 6520 6469 7265 6374 6f72 793c 2f65 ome directory</e │ │ │ +0021adf0: 7272 6f72 6e61 6d65 3e3c 2f65 6e74 7279 rrorname></entry │ │ │ +0021ae00: 3e3c 2f72 6f77 3e0a 093c 2f74 626f 6479 ></row>..</tbody │ │ │ +0021ae10: 3e0a 2020 2020 2020 3c2f 7467 726f 7570 >. </tgroup │ │ │ +0021ae20: 3e0a 2020 2020 3c2f 7461 626c 653e 0a20 >. </table>. │ │ │ +0021ae30: 203c 2f72 6566 7365 6374 313e 0a20 200a </refsect1>. . │ │ │ +0021ae40: 2020 3c72 6566 7365 6374 3120 6964 3d22 <refsect1 id=" │ │ │ +0021ae50: 6578 616d 706c 6573 5f64 6176 5f61 7069 examples_dav_api │ │ │ +0021ae60: 5f73 6561 7263 6822 3e3c 7469 746c 653e _search"><title> │ │ │ +0021ae70: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ +0021ae80: 0a20 2020 203c 6578 616d 706c 6520 6964 . Se │ │ │ +0021aeb0: 6172 6368 696e 6720 696e 2057 6562 4441 arching in WebDA │ │ │ +0021aec0: 563c 2f74 6974 6c65 3e0a 2020 2020 203c V. < │ │ │ +0021aed0: 7061 7261 3e54 6865 2065 7861 6d70 6c65 para>The example │ │ │ +0021aee0: 2073 686f 7773 2072 6574 7269 6576 616c shows retrieval │ │ │ +0021aef0: 206f 6620 7468 6520 7265 736f 7572 6365 of the resource │ │ │ +0021af00: 2069 6420 6279 2067 6976 656e 2070 6174 id by given pat │ │ │ +0021af10: 6820 7374 7269 6e67 3c2f 7061 7261 3e0a h string. │ │ │ +0021af20: 2020 2020 2020 3c73 6372 6565 6e3e 0a53 .S │ │ │ +0021af30: 514c 3e20 7365 6c65 6374 2044 422e 4442 QL> select DB.DB │ │ │ +0021af40: 412e 4441 565f 5345 4152 4348 5f49 4420 A.DAV_SEARCH_ID │ │ │ +0021af50: 2827 2f44 4156 2f27 2c27 6327 293b 0a63 ('/DAV/','c');.c │ │ │ +0021af60: 616c 6c72 6574 0a56 4152 4348 4152 0a5f allret.VARCHAR._ │ │ │ +0021af70: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021af80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021af90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021afa0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021afb0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ +0021afc0: 310a 0a0a 5351 4c3e 2073 656c 6563 7420 1...SQL> select │ │ │ +0021afd0: 4442 2e44 4241 2e44 4156 5f53 4541 5243 DB.DBA.DAV_SEARC │ │ │ +0021afe0: 485f 5041 5448 2028 312c 2763 2729 3b0a H_PATH (1,'c');. │ │ │ +0021aff0: 6361 6c6c 7265 740a 5641 5243 4841 520a callret.VARCHAR. │ │ │ +0021b000: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021b010: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021b020: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021b030: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021b040: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a _______________. │ │ │ +0021b050: 0a2f 4441 562f 0a0a 0a20 2020 2020 203c ./DAV/... < │ │ │ +0021b060: 2f73 6372 6565 6e3e 0a20 2020 203c 2f65 /screen>. . .. │ │ │ +0021b0b0: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ +0021b0c0: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ +0021b0d0: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ +0021b0e0: 2266 6e5f 6461 765f 6170 695f 6164 6422 "fn_dav_api_add" │ │ │ +0021b0f0: 3e44 4156 2063 6f6e 7465 6e74 2061 6464 >DAV content add │ │ │ +0021b100: 2f75 7064 6174 652f 6465 6c65 7465 2066 /update/delete f │ │ │ +0021b110: 756e 6374 696f 6e73 3c2f 6c69 6e6b 3e3c unctions</link>< │ │ │ +0021b120: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. <para │ │ │ +0021b130: 3e3c 6c69 6e6b 206c 696e 6b65 6e64 3d22 ><link linkend=" │ │ │ +0021b140: 666e 5f64 6176 5f61 7069 5f63 6861 6e67 fn_dav_api_chang │ │ │ +0021b150: 6522 3e44 4156 2063 6f6e 7465 6e74 206d e">DAV content m │ │ │ +0021b160: 616e 6970 756c 6174 696f 6e20 6675 6e63 anipulation func │ │ │ +0021b170: 7469 6f6e 733c 2f6c 696e 6b3e 3c2f 7061 tions</link></pa │ │ │ +0021b180: 7261 3e0a 2020 2020 3c70 6172 613e 3c6c ra>. <para><l │ │ │ +0021b190: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ +0021b1a0: 6461 765f 6170 695f 6c6f 636b 223e 4441 dav_api_lock">DA │ │ │ +0021b1b0: 5620 6c6f 636b 206d 616e 6970 756c 6174 V lock manipulat │ │ │ +0021b1c0: 696f 6e20 6675 6e63 7469 6f6e 733c 2f6c ion functions</l │ │ │ +0021b1d0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 2020 ink></para>. │ │ │ +0021b1e0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b <para><link link │ │ │ +0021b1f0: 656e 643d 2266 6e5f 6461 765f 6170 695f end="fn_dav_api_ │ │ │ +0021b200: 7573 6572 223e 4441 5620 7573 6572 206d user">DAV user m │ │ │ +0021b210: 616e 6167 656d 656e 7420 6675 6e63 7469 anagement functi │ │ │ +0021b220: 6f6e 733c 2f6c 696e 6b3e 3c2f 7061 7261 ons</link></para │ │ │ +0021b230: 3e0a 2020 3c2f 7265 6673 6563 7431 3e0a >. </refsect1>. │ │ │ +0021b240: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 .</refentry>.... │ │ │ +0021b250: 003e 6465 6d6f 2f64 6f63 7372 632f 6675 .>demo/docsrc/fu │ │ │ +0021b260: 6e63 7265 662f 786d 6c53 746f 7261 6765 ncref/xmlStorage │ │ │ +0021b270: 5379 7374 656d 2e67 6574 5365 7276 6572 System.getServer │ │ │ +0021b280: 4361 7061 6269 6c69 7469 6573 2e78 6d6c Capabilities.xml │ │ │ +0021b290: df00 0013 f83c 3f78 6d6c 2076 6572 7369 .....<?xml versi │ │ │ +0021b2a0: 6f6e 3d22 312e 3022 2065 6e63 6f64 696e on="1.0" encodin │ │ │ +0021b2b0: 673d 2249 534f 2d38 3835 392d 3122 3f3e g="ISO-8859-1"?> │ │ │ +0021b2c0: 0a3c 212d 2d0a 202d 2020 0a20 2d20 2054 .<!--. - . - T │ │ │ +0021b2d0: 6869 7320 6669 6c65 2069 7320 7061 7274 his file is part │ │ │ +0021b2e0: 206f 6620 7468 6520 4f70 656e 4c69 6e6b of the OpenLink │ │ │ +0021b2f0: 2053 6f66 7477 6172 6520 5669 7274 756f Software Virtuo │ │ │ +0021b300: 736f 204f 7065 6e2d 536f 7572 6365 2028 so Open-Source ( │ │ │ +0021b310: 564f 5329 0a20 2d20 2070 726f 6a65 6374 VOS). - project │ │ │ +0021b320: 2e0a 202d 2020 0a20 2d20 2043 6f70 7972 .. - . - Copyr │ │ │ +0021b330: 6967 6874 2028 4329 2031 3939 382d 3230 ight (C) 1998-20 │ │ │ +0021b340: 3234 204f 7065 6e4c 696e 6b20 536f 6674 24 OpenLink Soft │ │ │ +0021b350: 7761 7265 0a20 2d20 200a 202d 2020 5468 ware. - . - Th │ │ │ +0021b360: 6973 2070 726f 6a65 6374 2069 7320 6672 is project is fr │ │ │ +0021b370: 6565 2073 6f66 7477 6172 653b 2079 6f75 ee software; you │ │ │ +0021b380: 2063 616e 2072 6564 6973 7472 6962 7574 can redistribut │ │ │ +0021b390: 6520 6974 2061 6e64 2f6f 7220 6d6f 6469 e it and/or modi │ │ │ +0021b3a0: 6679 2069 740a 202d 2020 756e 6465 7220 fy it. - under │ │ │ +0021b3b0: 7468 6520 7465 726d 7320 6f66 2074 6865 the terms of the │ │ │ +0021b3c0: 2047 4e55 2047 656e 6572 616c 2050 7562 GNU General Pub │ │ │ +0021b3d0: 6c69 6320 4c69 6365 6e73 6520 6173 2070 lic License as p │ │ │ +0021b3e0: 7562 6c69 7368 6564 2062 7920 7468 650a ublished by the. │ │ │ +0021b3f0: 202d 2020 4672 6565 2053 6f66 7477 6172 - Free Softwar │ │ │ +0021b400: 6520 466f 756e 6461 7469 6f6e 3b20 6f6e e Foundation; on │ │ │ +0021b410: 6c79 2076 6572 7369 6f6e 2032 206f 6620 ly version 2 of │ │ │ +0021b420: 7468 6520 4c69 6365 6e73 652c 2064 6174 the License, dat │ │ │ +0021b430: 6564 204a 756e 6520 3139 3931 2e0a 202d ed June 1991.. - │ │ │ +0021b440: 2020 0a20 2d20 2054 6869 7320 7072 6f67 . - This prog │ │ │ +0021b450: 7261 6d20 6973 2064 6973 7472 6962 7574 ram is distribut │ │ │ +0021b460: 6564 2069 6e20 7468 6520 686f 7065 2074 ed in the hope t │ │ │ +0021b470: 6861 7420 6974 2077 696c 6c20 6265 2075 hat it will be u │ │ │ +0021b480: 7365 6675 6c2c 2062 7574 0a20 2d20 2057 seful, but. - W │ │ │ +0021b490: 4954 484f 5554 2041 4e59 2057 4152 5241 ITHOUT ANY WARRA │ │ │ +0021b4a0: 4e54 593b 2077 6974 686f 7574 2065 7665 NTY; without eve │ │ │ +0021b4b0: 6e20 7468 6520 696d 706c 6965 6420 7761 n the implied wa │ │ │ +0021b4c0: 7272 616e 7479 206f 660a 202d 2020 4d45 rranty of. - ME │ │ │ +0021b4d0: 5243 4841 4e54 4142 494c 4954 5920 6f72 RCHANTABILITY or │ │ │ +0021b4e0: 2046 4954 4e45 5353 2046 4f52 2041 2050 FITNESS FOR A P │ │ │ +0021b4f0: 4152 5449 4355 4c41 5220 5055 5250 4f53 ARTICULAR PURPOS │ │ │ +0021b500: 452e 2053 6565 2074 6865 2047 4e55 0a20 E. See the GNU. │ │ │ +0021b510: 2d20 2047 656e 6572 616c 2050 7562 6c69 - General Publi │ │ │ +0021b520: 6320 4c69 6365 6e73 6520 666f 7220 6d6f c License for mo │ │ │ +0021b530: 7265 2064 6574 6169 6c73 2e0a 202d 2020 re details.. - │ │ │ +0021b540: 0a20 2d20 2059 6f75 2073 686f 756c 6420 . - You should │ │ │ +0021b550: 6861 7665 2072 6563 6569 7665 6420 6120 have received a │ │ │ +0021b560: 636f 7079 206f 6620 7468 6520 474e 5520 copy of the GNU │ │ │ +0021b570: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ +0021b580: 6963 656e 7365 2061 6c6f 6e67 0a20 2d20 icense along. - │ │ │ +0021b590: 2077 6974 6820 7468 6973 2070 726f 6772 with this progr │ │ │ +0021b5a0: 616d 3b20 6966 206e 6f74 2c20 7772 6974 am; if not, writ │ │ │ +0021b5b0: 6520 746f 2074 6865 2046 7265 6520 536f e to the Free So │ │ │ +0021b5c0: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ +0021b5d0: 6e2c 2049 6e63 2e2c 0a20 2d20 2035 3120 n, Inc.,. - 51 │ │ │ +0021b5e0: 4672 616e 6b6c 696e 2053 742c 2046 6966 Franklin St, Fif │ │ │ +0021b5f0: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e th Floor, Boston │ │ │ +0021b600: 2c20 4d41 2030 3231 3130 2d31 3330 3120 , MA 02110-1301 │ │ │ +0021b610: 5553 410a 202d 2020 0a20 2d20 200a 2d2d USA. - . - .-- │ │ │ +0021b620: 3e0a 2020 3c21 2d2d 2043 7265 6174 6564 >. <!-- Created │ │ │ +0021b630: 2077 6974 6820 4675 6e63 6d61 6b65 2e76 with Funcmake.v │ │ │ +0021b640: 7370 202d 2d3e 0a3c 7265 6665 6e74 7279 sp -->.<refentry │ │ │ +0021b650: 2069 643d 2266 6e5f 786d 6c53 746f 7261 id="fn_xmlStora │ │ │ +0021b660: 6765 5379 7374 656d 2e67 6574 5365 7276 geSystem.getServ │ │ │ +0021b670: 6572 4361 7061 6269 6c69 7469 6573 223e erCapabilities"> │ │ │ +0021b680: 0a20 203c 7265 666d 6574 613e 0a20 2020 . <refmeta>. │ │ │ +0021b690: 203c 7265 6665 6e74 7279 7469 746c 653e <refentrytitle> │ │ │ +0021b6a0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ +0021b6b0: 2e67 6574 5365 7276 6572 4361 7061 6269 .getServerCapabi │ │ │ +0021b6c0: 6c69 7469 6573 3c2f 7265 6665 6e74 7279 lities</refentry │ │ │ +0021b6d0: 7469 746c 653e 0a20 2020 203c 7265 666d title>. <refm │ │ │ +0021b6e0: 6973 6369 6e66 6f3e 626c 6f67 3c2f 7265 iscinfo>blog</re │ │ │ +0021b6f0: 666d 6973 6369 6e66 6f3e 0a20 203c 2f72 fmiscinfo>. </r │ │ │ +0021b700: 6566 6d65 7461 3e0a 2020 3c72 6566 6e61 efmeta>. <refna │ │ │ +0021b710: 6d65 6469 763e 0a20 2020 203c 7265 666e mediv>. <refn │ │ │ +0021b720: 616d 653e 786d 6c53 746f 7261 6765 5379 ame>xmlStorageSy │ │ │ +0021b730: 7374 656d 2e67 6574 5365 7276 6572 4361 stem.getServerCa │ │ │ +0021b740: 7061 6269 6c69 7469 6573 3c2f 7265 666e pabilities</refn │ │ │ +0021b750: 616d 653e 0a20 2020 203c 7265 6670 7572 ame>. <refpur │ │ │ +0021b760: 706f 7365 3e52 6574 7269 6576 6520 7365 pose>Retrieve se │ │ │ +0021b770: 7276 6572 2073 7065 6369 6669 6320 696e rver specific in │ │ │ +0021b780: 666f 726d 6174 696f 6e2e 3c2f 7265 6670 formation.</refp │ │ │ +0021b790: 7572 706f 7365 3e0a 2020 3c2f 7265 666e urpose>. </refn │ │ │ +0021b7a0: 616d 6564 6976 3e0a 2020 3c72 6566 7379 amediv>. <refsy │ │ │ +0021b7b0: 6e6f 7073 6973 6469 763e 0a20 2020 203c nopsisdiv>. < │ │ │ +0021b7c0: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +0021b7d0: 2266 7379 6e5f 786d 6c53 746f 7261 6765 "fsyn_xmlStorage │ │ │ +0021b7e0: 5379 7374 656d 2e67 6574 5365 7276 6572 System.getServer │ │ │ +0021b7f0: 4361 7061 6269 6c69 7469 6573 223e 0a20 Capabilities">. │ │ │ +0021b800: 2020 2020 203c 6675 6e63 7072 6f74 6f74 <funcprotot │ │ │ +0021b810: 7970 6520 6964 3d22 6670 726f 746f 5f78 ype id="fproto_x │ │ │ +0021b820: 6d6c 5374 6f72 6167 6553 7973 7465 6d2e mlStorageSystem. │ │ │ +0021b830: 6765 7453 6572 7665 7243 6170 6162 696c getServerCapabil │ │ │ +0021b840: 6974 6965 7322 3e0a 2020 2020 2020 2020 ities">. │ │ │ +0021b850: 3c66 756e 6364 6566 3e73 7472 7563 7475 <funcdef>structu │ │ │ +0021b860: 7265 203c 6675 6e63 7469 6f6e 3e78 6d6c re <function>xml │ │ │ +0021b870: 5374 6f72 6167 6553 7973 7465 6d2e 6765 StorageSystem.ge │ │ │ +0021b880: 7453 6572 7665 7243 6170 6162 696c 6974 tServerCapabilit │ │ │ +0021b890: 6965 733c 2f66 756e 6374 696f 6e3e 3c2f ies</function></ │ │ │ +0021b8a0: 6675 6e63 6465 663e 0a20 2020 2020 2020 funcdef>. │ │ │ +0021b8b0: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 <paramdef>in <p │ │ │ +0021b8c0: 6172 616d 6574 6572 3e65 6d61 696c 3c2f arameter>email</ │ │ │ +0021b8d0: 7061 7261 6d65 7465 723e 2073 7472 696e parameter> strin │ │ │ +0021b8e0: 673c 2f70 6172 616d 6465 663e 0a20 2020 g</paramdef>. │ │ │ +0021b8f0: 2020 2020 203c 7061 7261 6d64 6566 3e69 <paramdef>i │ │ │ +0021b900: 6e20 3c70 6172 616d 6574 6572 3e70 6173 n <parameter>pas │ │ │ +0021b910: 7377 6f72 643c 2f70 6172 616d 6574 6572 sword</parameter │ │ │ +0021b920: 3e20 7374 7269 6e67 3c2f 7061 7261 6d64 > string</paramd │ │ │ +0021b930: 6566 3e0a 2020 2020 2020 3c2f 6675 6e63 ef>. </func │ │ │ +0021b940: 7072 6f74 6f74 7970 653e 0a20 2020 203c prototype>. < │ │ │ +0021b950: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ +0021b960: 203c 2f72 6566 7379 6e6f 7073 6973 6469 </refsynopsisdi │ │ │ +0021b970: 763e 0a20 203c 7265 6673 6563 7431 2069 v>. <refsect1 i │ │ │ +0021b980: 643d 2264 6573 635f 786d 6c53 746f 7261 d="desc_xmlStora │ │ │ +0021b990: 6765 5379 7374 656d 2e67 6574 5365 7276 geSystem.getServ │ │ │ +0021b9a0: 6572 4361 7061 6269 6c69 7469 6573 223e erCapabilities"> │ │ │ +0021b9b0: 0a20 2020 203c 7469 746c 653e 4465 7363 . <title>Desc │ │ │ +0021b9c0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +0021b9d0: 2020 2020 3c70 6172 613e 5468 6973 206d This m │ │ │ +0021b9e0: 6574 686f 6420 6973 2075 7365 6420 746f ethod is used to │ │ │ +0021b9f0: 206f 6274 6169 6e20 696e 666f 726d 6174 obtain informat │ │ │ +0021ba00: 696f 6e20 6162 6f75 7420 7468 6520 6361 ion about the ca │ │ │ +0021ba10: 7061 6269 6c69 7469 6573 206f 6620 7468 pabilities of th │ │ │ +0021ba20: 6520 7365 7276 6572 2c20 7375 6368 2061 e server, such a │ │ │ +0021ba30: 7320 0a66 696c 6573 2073 697a 6520 6c69 s .files size li │ │ │ +0021ba40: 6d69 7461 7469 6f6e 732c 2073 7570 706f mitations, suppo │ │ │ +0021ba50: 7274 6564 2074 7970 6573 2c20 6574 632e rted types, etc. │ │ │ +0021ba60: 2e2e 3c2f 7061 7261 3e0a 2020 3c2f 7265 ... . Pa │ │ │ +0021bac0: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ +0021bad0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +0021bae0: 7469 746c 653e 656d 6169 6c3c 2f74 6974 title>email. │ │ │ +0021bb00: 466f 7220 7573 6572 2069 6465 6e74 6966 For user identif │ │ │ +0021bb10: 6963 6174 696f 6e2c 2074 6869 7320 7368 ication, this sh │ │ │ +0021bb20: 6f75 6c64 2062 6520 6120 7661 6c69 6420 ould be a valid │ │ │ +0021bb30: 656d 6169 6c20 6163 636f 756e 742e 3c2f email account. │ │ │ +0021bb50: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +0021bb60: 7469 746c 653e 7061 7373 776f 7264 3c2f title>password. The MD5 hash │ │ │ +0021bb90: 6f66 2074 6865 2070 6173 7377 6f72 642e of the password. │ │ │ +0021bba0: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . │ │ │ +0021bbc0: 0a20 203c 7265 6673 6563 7431 2069 643d . Return Types │ │ │ +0021bc10: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This method r │ │ │ +0021bc30: 6574 7572 6e73 2061 2073 7472 7563 7475 eturns a structu │ │ │ +0021bc40: 7265 2061 7320 666f 6c6c 6f77 733a 3c2f re as follows:.. ' │ │ │ +0021bc70: 666c 4572 726f 7226 2333 393b 2062 6f6f flError' boo │ │ │ +0021bc80: 6c65 616e 2020 2009 0930 2073 7563 6365 lean ..0 succe │ │ │ +0021bc90: 7373 2c20 3120 6661 756c 740a 2020 2020 ss, 1 fault. │ │ │ +0021bca0: 2623 3339 3b6d 6573 7361 6765 2623 3339 'message' │ │ │ +0021bcb0: 3b20 7374 7269 6e67 2020 2020 0909 6661 ; string ..fa │ │ │ +0021bcc0: 756c 7420 6d65 7373 6167 6520 2863 616e ult message (can │ │ │ +0021bcd0: 2062 6520 7573 6564 2074 6f20 6861 6e64 be used to hand │ │ │ +0021bce0: 6c65 2065 7272 6f72 2063 6173 6573 290a le error cases). │ │ │ +0021bcf0: 2020 2020 2063 7442 7974 6573 496e 5573 ctBytesInUs │ │ │ +0021bd00: 6520 696e 7465 6765 7209 0968 6f77 206d e integer..how m │ │ │ +0021bd10: 616e 7920 6279 7465 7320 6172 6520 7573 any bytes are us │ │ │ +0021bd20: 6564 206f 6e20 7265 706f 7369 746f 7279 ed on repository │ │ │ +0021bd30: 0a20 2020 2020 6c65 6761 6c46 696c 6545 . legalFileE │ │ │ +0021bd40: 7874 656e 7369 6f6e 7320 7374 7269 6e67 xtensions string │ │ │ +0021bd50: 2061 7272 6179 2020 2077 6869 6368 2065 array which e │ │ │ +0021bd60: 7874 656e 7369 6f6e 7320 6172 6520 7265 xtensions are re │ │ │ +0021bd70: 636f 676e 697a 6564 200a 2020 2020 206d cognized . m │ │ │ +0021bd80: 6178 4279 7465 7350 6572 5573 6572 2069 axBytesPerUser i │ │ │ +0021bd90: 6e74 6567 6572 0909 746f 7461 6c20 6279 nteger..total by │ │ │ +0021bda0: 7465 7320 6176 6169 6c61 626c 6520 666f tes available fo │ │ │ +0021bdb0: 7220 7468 6973 2075 7365 720a 2020 2020 r this user. │ │ │ +0021bdc0: 206d 6178 4669 6c65 5369 7a65 2069 6e74 maxFileSize int │ │ │ +0021bdd0: 6567 6572 0909 6c61 7267 6573 7420 6669 eger..largest fi │ │ │ +0021bde0: 6c65 2073 697a 6520 666f 7220 7570 6c6f le size for uplo │ │ │ +0021bdf0: 6164 2028 6279 7465 7329 0a20 2020 2020 ad (bytes). │ │ │ +0021be00: 796f 7572 5570 7374 7265 616d 466f 6c64 yourUpstreamFold │ │ │ +0021be10: 6572 5572 6c20 7374 7269 6e67 0962 6173 erUrl string.bas │ │ │ +0021be20: 6520 5552 4c20 666f 7220 7573 6572 2623 e URL for user&# │ │ │ +0021be30: 3339 3b73 2062 6c6f 6720 6f6e 2072 6570 39;s blog on rep │ │ │ +0021be40: 6f73 6974 6f72 790a 3c2f 7072 6f67 7261 ository.. . .. . < │ │ │ +0021bf80: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. Retrie │ │ │ +0021bfe0: 7669 6e67 2074 6865 2058 4d4c 2053 746f ving the XML Sto │ │ │ +0021bff0: 7261 6765 2053 7973 7465 6d20 4361 7061 rage System Capa │ │ │ +0021c000: 6269 6c69 7469 6573 3c2f 7469 746c 653e bilities │ │ │ +0021c010: 0a20 2020 2020 203c 7061 7261 3e53 696d . Sim │ │ │ +0021c020: 706c 6520 6578 616d 706c 6520 6f66 2066 ple example of f │ │ │ +0021c030: 6574 6368 696e 6720 7468 6520 7365 7276 etching the serv │ │ │ +0021c040: 6572 2063 6170 6162 696c 6974 6965 732e er capabilities. │ │ │ +0021c050: 3c2f 7061 7261 3e0a 2020 2020 2020 3c73 . . SQL&g │ │ │ +0021c070: 743b 2053 4f41 505f 434c 4945 4e54 2028 t; SOAP_CLIENT ( │ │ │ +0021c080: 7572 6c3d 2667 743b 2623 3339 3b68 7474 url=>'htt │ │ │ +0021c090: 703a 2f2f 6578 616d 706c 652e 636f 6d2f p://example.com/ │ │ │ +0021c0a0: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ +0021c0b0: 2623 3339 3b2c 0a09 6f70 6572 6174 696f ',..operatio │ │ │ +0021c0c0: 6e3d 2667 743b 2623 3339 3b67 6574 5365 n=>'getSe │ │ │ +0021c0d0: 7276 6572 4361 7061 6269 6c69 7469 6573 rverCapabilities │ │ │ +0021c0e0: 2623 3339 3b2c 2070 6172 616d 6574 6572 ', parameter │ │ │ +0021c0f0: 733d 2667 743b 7665 6374 6f72 0a09 2826 s=>vector..(& │ │ │ +0021c100: 2333 393b 656d 6169 6c26 2333 393b 2c26 #39;email',& │ │ │ +0021c110: 2333 393b 7573 6572 4065 7861 6d70 6c65 #39;user@example │ │ │ +0021c120: 2e64 6f6d 6169 6e26 2333 393b 2c20 2623 .domain', &# │ │ │ +0021c130: 3339 3b70 6173 7377 6f72 6426 2333 393b 39;password' │ │ │ +0021c140: 2c20 6d64 3528 2623 3339 3b78 7878 2623 , md5('xxx&# │ │ │ +0021c150: 3339 3b29 293b 0a0a 2020 2020 534f 4150 39;));.. SOAP │ │ │ +0021c160: 2072 6573 706f 6e73 653a 090a 0a20 2020 response:... │ │ │ +0021c170: 2026 6c74 3b67 6574 5365 7276 6572 4361 <getServerCa │ │ │ +0021c180: 7061 6269 6c69 7469 6573 5265 7370 6f6e pabilitiesRespon │ │ │ +0021c190: 7365 2667 743b 0a20 2020 2020 2020 266c se>. &l │ │ │ +0021c1a0: 743b 5265 7375 6c74 2667 743b 0a09 2026 t;Result>.. & │ │ │ +0021c1b0: 6c74 3b63 7442 7974 6573 496e 5573 6526 lt;ctBytesInUse& │ │ │ +0021c1c0: 6774 3b31 3426 6c74 3b2f 6374 4279 7465 gt;14</ctByte │ │ │ +0021c1d0: 7349 6e55 7365 2667 743b 0a09 2026 6c74 sInUse>.. < │ │ │ +0021c1e0: 3b66 6c45 7272 6f72 2667 743b 3026 6c74 ;flError>0< │ │ │ +0021c1f0: 3b2f 666c 4572 726f 7226 6774 3b0a 0920 ;/flError>.. │ │ │ +0021c200: 2020 266c 743b 6c65 6761 6c46 696c 6545 <legalFileE │ │ │ +0021c210: 7874 656e 7369 6f6e 7326 6774 3b0a 0920 xtensions>.. │ │ │ +0021c220: 2020 2020 266c 743b 6974 656d 2667 743b <item> │ │ │ +0021c230: 6169 266c 743b 2f69 7465 6d26 6774 3b0a ai</item>. │ │ │ +0021c240: 0920 2020 2020 266c 743b 6974 656d 2667 . <item&g │ │ │ +0021c250: 743b 6169 6626 6c74 3b2f 6974 656d 2667 t;aif</item&g │ │ │ +0021c260: 743b 0a09 2020 2020 2026 6c74 3b69 7465 t;.. <ite │ │ │ +0021c270: 6d26 6774 3b61 6966 6326 6c74 3b2f 6974 m>aifc</it │ │ │ +0021c280: 656d 2667 743b 0a09 2020 2026 6c74 3b2f em>.. </ │ │ │ +0021c290: 6c65 6761 6c46 696c 6545 7874 656e 7369 legalFileExtensi │ │ │ +0021c2a0: 6f6e 7326 6774 3b0a 0920 266c 743b 6d61 ons>.. <ma │ │ │ +0021c2b0: 7842 7974 6573 5065 7255 7365 7226 6774 xBytesPerUser> │ │ │ +0021c2c0: 3b34 3139 3433 3034 3026 6c74 3b2f 6d61 ;41943040</ma │ │ │ +0021c2d0: 7842 7974 6573 5065 7255 7365 7226 6774 xBytesPerUser> │ │ │ +0021c2e0: 3b0a 0920 266c 743b 6d61 7846 696c 6553 ;.. <maxFileS │ │ │ +0021c2f0: 697a 6526 6774 3b31 3034 3835 3736 266c ize>1048576&l │ │ │ +0021c300: 743b 2f6d 6178 4669 6c65 5369 7a65 2667 t;/maxFileSize&g │ │ │ +0021c310: 743b 0a09 2026 6c74 3b6d 6573 7361 6765 t;.. <message │ │ │ +0021c320: 202f 2667 743b 0a09 2026 6c74 3b79 6f75 />.. <you │ │ │ +0021c330: 7255 7073 7472 6561 6d46 6f6c 6465 7255 rUpstreamFolderU │ │ │ +0021c340: 726c 2667 743b 6874 7470 3a2f 2f65 7861 rl>http://exa │ │ │ +0021c350: 6d70 6c65 2e63 6f6d 2f44 4156 2f75 7365 mple.com/DAV/use │ │ │ +0021c360: 7240 6578 616d 706c 652e 646f 6d61 696e r@example.domain │ │ │ +0021c370: 2f62 6c6f 672f 266c 743b 2f79 6f75 7255 /blog/</yourU │ │ │ +0021c380: 7073 7472 6561 6d46 6f6c 6465 7255 726c pstreamFolderUrl │ │ │ +0021c390: 2667 743b 0a20 2020 2020 2020 266c 743b >. < │ │ │ +0021c3a0: 2f52 6573 756c 7426 6774 3b0a 2020 2020 /Result>. │ │ │ +0021c3b0: 266c 743b 2f67 6574 5365 7276 6572 4361 </getServerCa │ │ │ +0021c3c0: 7061 6269 6c69 7469 6573 5265 7370 6f6e pabilitiesRespon │ │ │ +0021c3d0: 7365 2667 743b 0a3c 2f73 6372 6565 6e3e se>. │ │ │ +0021c3e0: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ +0021c3f0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +0021c400: 3c72 6566 7365 6374 3120 6964 3d22 7365 . │ │ │ +0021c440: 2020 203c 7469 746c 653e 5365 6520 416c See Al │ │ │ +0021c450: 736f 3c2f 7469 746c 653e 0a20 203c 7061 so. xm │ │ │ +0021c4a0: 6c53 746f 7261 6765 5379 7374 656d 2e72 lStorageSystem.r │ │ │ +0021c4b0: 6567 6973 7465 7255 7365 7228 293c 2f66 egisterUser()< │ │ │ +0021c4d0: 2f70 6172 613e 0a20 203c 7061 7261 3e3c /para>. < │ │ │ +0021c4e0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +0021c4f0: 5f78 6d6c 5374 6f72 6167 6553 7973 7465 _xmlStorageSyste │ │ │ +0021c500: 6d2e 6d61 696c 5061 7373 776f 7264 546f m.mailPasswordTo │ │ │ +0021c510: 5573 6572 223e 3c66 756e 6374 696f 6e3e User"> │ │ │ +0021c520: 786d 6c53 746f 7261 6765 5379 7374 656d xmlStorageSystem │ │ │ +0021c530: 2e6d 6169 6c50 6173 7377 6f72 6454 6f55 .mailPasswordToU │ │ │ +0021c540: 7365 7228 293c 2f66 756e 6374 696f 6e3e ser() │ │ │ +0021c550: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +0021c560: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ +0021c5a0: 6675 6e63 7469 6f6e 3e78 6d6c 5374 6f72 function>xmlStor │ │ │ +0021c5b0: 6167 6553 7973 7465 6d2e 6465 6c65 7465 ageSystem.delete │ │ │ +0021c5c0: 4d75 6c74 6970 6c65 4669 6c65 7328 293c MultipleFiles()< │ │ │ +0021c5d0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xmlStorageSyste │ │ │ +0021c640: 6d2e 7361 7665 4d75 6c74 6970 6c65 4669 m.saveMultipleFi │ │ │ +0021c650: 6c65 7328 293c 2f66 756e 6374 696f 6e3e les() │ │ │ +0021c660: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +0021c670: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 .. .... │ │ │ +0021c690: 002d 6465 6d6f 2f64 6f63 7372 632f 6675 .-demo/docsrc/fu │ │ │ +0021c6a0: 6e63 7265 662f 7674 5f62 6174 6368 5f66 ncref/vt_batch_f │ │ │ +0021c6b0: 6565 645f 6f66 6662 616e 642e 786d 6cdf eed_offband.xml. │ │ │ +0021c6c0: 0000 1962 3c3f 786d 6c20 7665 7273 696f ...b. │ │ │ +0021c6f0: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 │ │ │ +0021ca50: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . vt_batc │ │ │ +0021caa0: 685f 6665 6564 5f6f 6666 6261 6e64 3c2f h_feed_offband. │ │ │ +0021cac0: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ +0021cad0: 6674 3c2f 7265 666d 6973 6369 6e66 6f3e ft │ │ │ +0021cae0: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ +0021caf0: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ +0021cb00: 203c 7265 666e 616d 653e 7674 5f62 6174 vt_bat │ │ │ +0021cb10: 6368 5f66 6565 645f 6f66 6662 616e 643c ch_feed_offband< │ │ │ +0021cb20: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Add of │ │ │ +0021cb40: 6662 616e 6420 696e 666f 726d 6174 696f fband informatio │ │ │ +0021cb50: 6e20 746f 2061 2066 7265 6520 7465 7874 n to a free text │ │ │ +0021cb60: 2075 7064 6174 6520 6261 7463 682e 3c2f update batch.. . . │ │ │ +0021cba0: 2020 203c 6675 6e63 7379 6e6f 7073 6973 . │ │ │ +0021cbd0: 2020 2020 203c 6675 6e63 7072 6f74 6f74 . v │ │ │ +0021cc20: 745f 6261 7463 685f 6665 6564 5f6f 6666 t_batch_feed_off │ │ │ +0021cc30: 6261 6e64 3c2f 6675 6e63 7469 6f6e 3e3c band< │ │ │ +0021cc40: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ +0021cc50: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ +0021cc60: 7061 7261 6d65 7465 723e 7674 5f62 6174 parameter>vt_bat │ │ │ +0021cc70: 6368 3c2f 7061 7261 6d65 7465 723e 2061 ch a │ │ │ +0021cc80: 6e79 3c2f 7061 7261 6d64 6566 3e0a 2020 ny. │ │ │ +0021cc90: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ +0021cca0: 696e 203c 7061 7261 6d65 7465 723e 636c in cl │ │ │ +0021ccb0: 7573 7465 7265 645f 7661 6c75 6573 3c2f ustered_values strin │ │ │ +0021ccd0: 673c 2f70 6172 616d 6465 663e 0a20 2020 g. │ │ │ +0021cce0: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ +0021ccf0: 6e20 3c70 6172 616d 6574 6572 3e69 735f n is_ │ │ │ +0021cd00: 6465 6c3c 2f70 6172 616d 6574 6572 3e20 del │ │ │ +0021cd10: 696e 7465 6765 723c 2f70 6172 616d 6465 integer. . . │ │ │ +0021cd50: 3c2f 7265 6673 796e 6f70 7369 7364 6976 . Description │ │ │ +0021cda0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . This function │ │ │ +0021cdc0: 2061 6c6c 6f77 7320 796f 7520 746f 2061 allows you to a │ │ │ +0021cdd0: 6464 206f 6666 6261 6e64 2069 6e66 6f72 dd offband infor │ │ │ +0021cde0: 6d61 7469 6f6e 2074 6f20 6120 6672 6565 mation to a free │ │ │ +0021cdf0: 2074 6578 7420 7570 6461 7465 2062 6174 text update bat │ │ │ +0021ce00: 6368 2e0a 5468 6973 2073 686f 756c 6420 ch..This should │ │ │ +0021ce10: 6265 2064 6f6e 6520 6279 2069 6e64 6578 be done by index │ │ │ +0021ce20: 2061 6e64 2075 6e69 6e64 6578 2068 6f6f and unindex hoo │ │ │ +0021ce30: 6b20 6675 6e63 7469 6f6e 7320 6f66 2074 k functions of t │ │ │ +0021ce40: 6865 2066 7265 6520 7465 7874 2069 6e64 he free text ind │ │ │ +0021ce50: 6578 0a69 6620 616e 6420 6f6e 6c79 2069 ex.if and only i │ │ │ +0021ce60: 6620 7468 6520 696e 6465 7820 6973 2063 f the index is c │ │ │ +0021ce70: 7265 6174 6564 2077 6974 6820 626f 7468 reated with both │ │ │ +0021ce80: 2026 7175 6f74 3b43 4c55 5354 4552 4544 "CLUSTERED │ │ │ +0021ce90: 2057 4954 4820 282e 2e2e 2926 7175 6f74 WITH (...)" │ │ │ +0021cea0: 3b0a 616e 6420 2671 756f 743b 5553 494e ;.and "USIN │ │ │ +0021ceb0: 4720 4655 4e43 5449 4f4e 2671 756f 743b G FUNCTION" │ │ │ +0021cec0: 206f 7074 696f 6e73 2061 6e64 2074 6865 options and the │ │ │ +0021ced0: 2068 6f6f 6b20 6675 6e63 7469 6f6e 2072 hook function r │ │ │ +0021cee0: 6574 7572 6e73 206e 6f6e 2d7a 6572 6f0a eturns non-zero. │ │ │ +0021cef0: 7661 6c75 652c 2069 2e65 2e20 6469 7361 value, i.e. disa │ │ │ +0021cf00: 626c 6573 2073 7461 6e64 6172 6420 696e bles standard in │ │ │ +0021cf10: 6465 7869 6e67 206f 6620 7468 6520 646f dexing of the do │ │ │ +0021cf20: 6375 6d65 6e74 2e0a 2020 2020 3c2f 7061 cument.. . Th │ │ │ +0021cf40: 6973 2066 756e 6374 696f 6e20 6973 206e is function is n │ │ │ +0021cf50: 6565 6465 6420 6f6e 6c79 2066 6f72 2076 eeded only for v │ │ │ +0021cf60: 6572 7920 756e 7573 7561 6c20 6672 6565 ery unusual free │ │ │ +0021cf70: 2074 6578 7420 696e 6465 7865 732e 3c2f text indexes... │ │ │ +0021cfc0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ +0021cfd0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. v │ │ │ +0021cff0: 745f 6261 7463 683c 2f74 6974 6c65 3e0a t_batch. │ │ │ +0021d000: 2020 2020 2020 3c70 6172 613e 6d75 7374 must │ │ │ +0021d010: 2062 6520 616e 206f 626a 6563 7420 7265 be an object re │ │ │ +0021d020: 7475 726e 6564 2062 7920 3c66 756e 6374 turned by vt_batch on which │ │ │ +0021d050: 0a3c 6675 6e63 7469 6f6e 3e76 745f 6261 .vt_ba │ │ │ +0021d060: 7463 685f 645f 6964 3c2f 6675 6e63 7469 tch_d_id has been cal │ │ │ +0021d080: 6c65 642e 3c2f 7061 7261 3e3c 2f72 6566 led.. clus │ │ │ +0021d0b0: 7465 7265 645f 7661 6c75 6573 3c2f 7469 tered_values</ti │ │ │ +0021d0c0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +0021d0d0: 3e6d 7573 7420 6265 2061 2073 7472 696e >must be a strin │ │ │ +0021d0e0: 6720 7468 6174 2069 7320 6d61 6465 2062 g that is made b │ │ │ +0021d0f0: 7920 7365 7269 616c 697a 6174 696f 6e20 y serialization │ │ │ +0021d100: 6f66 2061 2076 6563 746f 7220 6f66 206f of a vector of o │ │ │ +0021d110: 6666 6261 6e64 2076 616c 7565 733a 0a74 ffband values:.t │ │ │ +0021d120: 6865 206c 656e 6774 6820 6f66 2076 6563 he length of vec │ │ │ +0021d130: 746f 7220 6973 2065 7175 616c 2074 6f20 tor is equal to │ │ │ +0021d140: 6e75 6d62 6572 206f 6620 636f 6c75 6d6e number of column │ │ │ +0021d150: 7320 6c69 7374 6564 2069 6e0a 2671 756f s listed in.&quo │ │ │ +0021d160: 743b 434c 5553 5445 5245 4420 5749 5448 t;CLUSTERED WITH │ │ │ +0021d170: 2028 2e2e 2e29 2671 756f 743b 206f 7074 (...)" opt │ │ │ +0021d180: 696f 6e20 6f66 2026 7175 6f74 3b43 5245 ion of "CRE │ │ │ +0021d190: 4154 4520 5445 5854 2049 4e44 4558 2671 ATE TEXT INDEX&q │ │ │ +0021d1a0: 756f 743b 2073 7461 7465 6d65 6e74 2061 uot; statement a │ │ │ +0021d1b0: 6e64 0a65 6c65 6d65 6e74 7320 6f66 2074 nd.elements of t │ │ │ +0021d1c0: 6865 2076 6563 746f 7220 7368 6f75 6c64 he vector should │ │ │ +0021d1d0: 2062 6520 7661 6c75 6573 206f 6620 7468 be values of th │ │ │ +0021d1e0: 6520 6c69 7374 6564 2066 6965 6c64 7320 e listed fields │ │ │ +0021d1f0: 666f 7220 7468 6520 6375 7272 656e 7420 for the current │ │ │ +0021d200: 646f 6375 6d65 6e74 2e3c 2f70 6172 613e document.</para> │ │ │ +0021d210: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 </refsect2>. │ │ │ +0021d220: 3c72 6566 7365 6374 323e 3c74 6974 6c65 <refsect2><title │ │ │ +0021d230: 3e69 735f 6465 6c3c 2f74 6974 6c65 3e0a >is_del. │ │ │ +0021d240: 2020 2020 2020 3c70 6172 613e 6966 2030 if 0 │ │ │ +0021d250: 206d 6561 6e73 2074 6861 7420 7468 6520 means that the │ │ │ +0021d260: 6461 7461 2069 7320 746f 2062 6520 6164 data is to be ad │ │ │ +0021d270: 6465 642c 2031 206d 6561 6e73 2074 6865 ded, 1 means the │ │ │ +0021d280: 2064 6174 6120 6973 2074 6f0a 6265 2064 data is to.be d │ │ │ +0021d290: 656c 6574 6564 2e3c 2f70 6172 613e 3c2f eleted.. . Return │ │ │ +0021d2f0: 2054 7970 6573 3c2f 7469 746c 653e 3c70 Types

    The returned │ │ │ +0021d310: 2076 616c 7565 206d 6179 2076 6172 7920 value may vary │ │ │ +0021d320: 6672 6f6d 2076 6572 7369 6f6e 2074 6f20 from version to │ │ │ +0021d330: 7665 7273 696f 6e20 616e 6420 7368 6f75 version and shou │ │ │ +0021d340: 6c64 206e 6f74 2062 6520 7573 6572 2062 ld not be user b │ │ │ +0021d350: 7920 6170 706c 6963 6174 696f 6e20 636f y application co │ │ │ +0021d360: 6465 3c2f 7061 7261 3e3c 2f72 6566 7365 de. Exam │ │ │ +0021d3b0: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ +0021d3c0: 203c 6578 616d 706c 6520 6964 3d22 6578 F │ │ │ +0021d3f0: 7265 6520 7465 7874 2069 6e64 6578 696e ree text indexin │ │ │ +0021d400: 6720 6f66 2063 6f6d 706f 7365 6420 7465 g of composed te │ │ │ +0021d410: 7874 2063 6c75 7374 6572 6564 2077 6974 xt clustered wit │ │ │ +0021d420: 6820 6f66 6662 616e 6420 636f 6c75 6d6e h offband column │ │ │ +0021d430: 733c 2f74 6974 6c65 3e0a 2020 2020 2020 s. │ │ │ +0021d440: 3c70 6172 613e 5461 626c 6520 4c45 4144 Table LEAD │ │ │ +0021d450: 5320 636f 6e74 6169 6e73 2064 6573 6372 S contains descr │ │ │ +0021d460: 6970 7469 6f6e 7320 6f66 2061 7274 6963 iptions of artic │ │ │ +0021d470: 6c65 7320 6f66 2073 6f6d 6520 7365 7420 les of some set │ │ │ +0021d480: 6f66 206e 6577 7370 6170 6572 732e 0a48 of newspapers..H │ │ │ +0021d490: 6f6f 6b20 6675 6e63 7469 6f6e 7320 636f ook functions co │ │ │ +0021d4a0: 6d70 6f73 6520 7465 7874 2074 6861 7420 mpose text that │ │ │ +0021d4b0: 636f 6e74 6169 6e73 206e 6f74 206f 6e6c contains not onl │ │ │ +0021d4c0: 7920 7375 626a 6563 7420 6f66 2061 7274 y subject of art │ │ │ +0021d4d0: 6963 6c65 2c20 6275 7420 616c 736f 2074 icle, but also t │ │ │ +0021d4e0: 6974 6c65 2061 6e64 2066 6972 7374 206e itle and first n │ │ │ +0021d4f0: 616d 6520 6f66 2074 6865 2061 7574 686f ame of the autho │ │ │ +0021d500: 722e 0a54 6865 2068 6f6f 6b20 6675 6e63 r..The hook func │ │ │ +0021d510: 7469 6f6e 2073 686f 756c 6420 7265 7475 tion should retu │ │ │ +0021d520: 726e 206e 6f6e 2d7a 6572 6f20 7661 6c75 rn non-zero valu │ │ │ +0021d530: 6520 746f 2064 6973 6162 6c65 2064 6566 e to disable def │ │ │ +0021d540: 6175 6c74 2020 7072 6f63 6573 7369 6e67 ault processing │ │ │ +0021d550: 206f 6620 7465 7874 206f 6620 5355 424a of text of SUBJ │ │ │ +0021d560: 4543 5420 6669 656c 6420 6275 7420 6974 ECT field but it │ │ │ +0021d570: 0a61 6c73 6f20 6469 7361 626c 6573 2074 .also disables t │ │ │ +0021d580: 6865 2064 6566 6175 6c74 2020 7072 6f63 he default proc │ │ │ +0021d590: 6573 7369 6e67 206f 6620 6f66 6662 616e essing of offban │ │ │ +0021d5a0: 6420 7661 6c75 6573 2e0a 4966 2074 6865 d values..If the │ │ │ +0021d5b0: 2063 616c 6c20 6f66 203c 6675 6e63 7469 call of vt_batch_feed │ │ │ +0021d5d0: 5f6f 6666 6261 6e64 3c2f 6675 6e63 7469 _offband is missing t │ │ │ +0021d5f0: 6865 6e20 6672 6565 2074 6578 7420 7365 hen free text se │ │ │ +0021d600: 6172 6368 206f 6620 646f 6375 6d65 6e74 arch of document │ │ │ +0021d610: 7320 6973 2073 7469 6c6c 204f 4b0a 6275 s is still OK.bu │ │ │ +0021d620: 7420 7468 6520 6361 6c6c 206c 696b 6520 t the call like │ │ │ +0021d630: 5345 4c45 4354 204f 5247 5f49 4420 4652 SELECT ORG_ID FR │ │ │ +0021d640: 4f4d 204c 4541 4453 5f54 4553 5420 5748 OM LEADS_TEST WH │ │ │ +0021d650: 4552 4520 434f 4e54 4149 4e53 2028 5355 ERE CONTAINS (SU │ │ │ +0021d660: 424a 4543 542c 2027 7361 6d70 6c65 206c BJECT, 'sample l │ │ │ +0021d670: 6561 6427 2c20 4f46 4642 414e 442c 204f ead', OFFBAND, O │ │ │ +0021d680: 5247 5f49 4429 0a77 696c 6c20 7265 7475 RG_ID).will retu │ │ │ +0021d690: 726e 204e 554c 4c73 2069 6e73 7465 6164 rn NULLs instead │ │ │ +0021d6a0: 206f 6620 636f 7272 6563 7420 7661 6c75 of correct valu │ │ │ +0021d6b0: 6573 2066 726f 6d20 4f52 475f 4944 2063 es from ORG_ID c │ │ │ +0021d6c0: 6f6c 756d 6e20 6265 6361 7573 6520 7468 olumn because th │ │ │ +0021d6d0: 6579 2077 696c 6c20 6e6f 7420 6265 2072 ey will not be r │ │ │ +0021d6e0: 6574 7269 6576 6564 2066 726f 6d0a 6672 etrieved from.fr │ │ │ +0021d6f0: 6565 2074 6578 7420 696e 6465 7820 6279 ee text index by │ │ │ +0021d700: 2026 7175 6f74 3b4f 4646 4241 4e44 2c20 "OFFBAND, │ │ │ +0021d710: 4f52 475f 4944 2671 756f 743b 2e0a 3c2f ORG_ID"... .. │ │ │ +0021de40: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ +0021de50: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +0021de60: 3c72 6566 7365 6374 3120 6964 3d22 7365 See Also. < │ │ │ +0021deb0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +0021dec0: 5f76 745f 6472 6f70 5f66 7474 223e 7674 _vt_drop_ftt">vt │ │ │ +0021ded0: 5f64 726f 705f 6674 743c 2f6c 696e 6b3e _drop_ftt │ │ │ +0021dee0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . vt │ │ │ +0021df10: 5f62 6174 6368 3c2f 6c69 6e6b 3e3c 2f70 _batch

    . < │ │ │ +0021df30: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +0021df40: 5f76 745f 6261 7463 685f 6665 6564 223e _vt_batch_feed"> │ │ │ +0021df50: 7674 5f62 6174 6368 5f66 6565 643c 2f6c vt_batch_feed. │ │ │ +0021df70: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b vt_batc │ │ │ +0021dfa0: 685f 7570 6461 7465 3c2f 6c69 6e6b 3e3c h_update< │ │ │ +0021dfb0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. vt_crea │ │ │ +0021dff0: 7465 5f74 6578 745f 696e 6465 783c 2f6c te_text_index. ......'demo/ │ │ │ +0021e030: 646f 6373 7263 2f66 756e 6372 6566 2f58 docsrc/funcref/X │ │ │ +0021e040: 4d4c 5479 7065 2e65 7874 7261 6374 2e78 MLType.extract.x │ │ │ +0021e050: 6d6c df00 0010 103c 3f78 6d6c 2076 6572 ml........ . XMLType.ex │ │ │ +0021e430: 7472 6163 743c 2f72 6566 656e 7472 7974 tract. xml. . . XMLType.extrac │ │ │ +0021e4a0: 743c 2f72 6566 6e61 6d65 3e0a 2020 2020 t. │ │ │ +0021e4b0: 3c72 6566 7075 7270 6f73 653e 4576 616c Eval │ │ │ +0021e4c0: 7561 7465 7320 6769 7665 6e20 5850 4154 uates given XPAT │ │ │ +0021e4d0: 4820 6578 7072 6573 7369 6f6e 2e3c 2f72 H expression.
    . . . │ │ │ +0021e510: 2020 3c66 756e 6373 796e 6f70 7369 7320 . │ │ │ +0021e540: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ +0021e570: 2020 2020 203c 6675 6e63 6465 663e 3c66 XMLType. │ │ │ +0021e590: 6578 7472 6163 743c 2f66 756e 6374 696f extract..

    in xpath_expn │ │ │ +0021e5d0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +0021e5e0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +0021e5f0: 093c 7061 7261 6d64 6566 3e3c 6f70 7469 .in namespace_map │ │ │ +0021e620: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +0021e630: 6368 6172 3c2f 6f70 7469 6f6e 616c 3e3c char< │ │ │ +0021e640: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +0021e650: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . │ │ │ +0021e6b0: 0a20 2020 203c 7469 746c 653e 4465 7363 . Desc │ │ │ +0021e6c0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +0021e6d0: 2020 2020 3c70 6172 613e 5468 6520 6d65 The me │ │ │ +0021e6e0: 6d62 6572 2066 756e 6374 696f 6e20 6361 mber function ca │ │ │ +0021e6f0: 6c63 756c 6174 6573 2074 6865 2067 6976 lculates the giv │ │ │ +0021e700: 656e 2058 5041 5448 2065 7870 7265 7373 en XPATH express │ │ │ +0021e710: 696f 6e20 3c70 6172 616d 6574 6572 3e78 ion x │ │ │ +0021e720: 7061 7468 5f65 7870 6e3c 2f70 6172 616d path_expn using. │ │ │ +0021e740: 7468 6520 584d 4c20 656e 7469 7479 206f the XML entity o │ │ │ +0021e750: 6620 7468 6520 696e 7374 616e 6365 2061 f the instance a │ │ │ +0021e760: 7320 6120 636f 6e74 6578 7420 6e6f 6465 s a context node │ │ │ +0021e770: 2e20 4966 2061 203c 7061 7261 6d65 7465 . If a namespace_map< │ │ │ +0021e790: 2f70 6172 616d 6574 6572 3e20 7061 7261 /parameter> para │ │ │ +0021e7a0: 6d65 7465 720a 2020 2020 6973 2067 6976 meter. is giv │ │ │ +0021e7b0: 656e 2074 6865 6e20 7468 6520 6675 6e63 en then the func │ │ │ +0021e7c0: 7469 6f6e 2061 6464 7320 6e61 6d65 7370 tion adds namesp │ │ │ +0021e7d0: 6163 6520 6465 636c 6172 6174 696f 6e73 ace declarations │ │ │ +0021e7e0: 2066 726f 6d20 7468 6973 2070 6172 616d from this param │ │ │ +0021e7f0: 6574 6572 2069 6e74 6f20 7468 6520 6265 eter into the be │ │ │ +0021e800: 6769 6e6e 696e 6720 6f66 0a20 2020 203c ginning of. < │ │ │ +0021e810: 7061 7261 6d65 7465 723e 7870 6174 685f parameter>xpath_ │ │ │ +0021e820: 6578 706e 3c2f 7061 7261 6d65 7465 723e expn │ │ │ +0021e830: 2062 6566 6f72 6520 7468 6520 6576 616c before the eval │ │ │ +0021e840: 7561 7469 6f6e 2e0a 2020 2020 5468 6520 uation.. The │ │ │ +0021e850: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ +0021e860: 2074 6865 2066 6972 7374 2072 6573 756c the first resul │ │ │ +0021e870: 7420 6f66 2074 6865 2058 5041 5448 2065 t of the XPATH e │ │ │ +0021e880: 7661 6c75 6174 696f 6e20 6f72 204e 554c valuation or NUL │ │ │ +0021e890: 4c20 6966 2074 6865 7265 2061 7265 206e L if there are n │ │ │ +0021e8a0: 6f20 7265 7375 6c74 732e 0a20 2020 2049 o results.. I │ │ │ +0021e8b0: 6620 7468 6520 7265 7375 6c74 2069 7320 f the result is │ │ │ +0021e8c0: 616e 2058 4d4c 2065 6e74 6974 7920 7468 an XML entity th │ │ │ +0021e8d0: 656e 2069 7420 6973 2063 6f6e 7665 7274 en it is convert │ │ │ +0021e8e0: 6564 2069 6e74 6f20 6120 6e6f 6e2d 7363 ed into a non-sc │ │ │ +0021e8f0: 6865 6d61 2062 6173 6564 2069 6e73 7461 hema based insta │ │ │ +0021e900: 6e63 6520 6f66 2058 4d4c 5479 7065 2e3c nce of XMLType.< │ │ │ +0021e910: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . . │ │ │ +0021e950: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ +0021e960: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ +0021e970: 3c72 6566 7365 6374 323e 3c74 6974 6c65 xpath_expn</tit │ │ │ +0021e990: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +0021e9a0: 4120 7465 7874 206f 6620 5850 4154 4820 A text of XPATH │ │ │ +0021e9b0: 6578 7072 6573 7369 6f6e 2074 6f20 6576 expression to ev │ │ │ +0021e9c0: 616c 7561 7465 2e3c 2f70 6172 613e 0a20 aluate.</para>. │ │ │ +0021e9d0: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ +0021e9e0: 2020 203c 7265 6673 6563 7432 3e3c 7469 <refsect2><ti │ │ │ +0021e9f0: 746c 653e 6e61 6d65 7370 6163 655f 6d61 tle>namespace_ma │ │ │ +0021ea00: 703c 2f74 6974 6c65 3e0a 2020 2020 2020 p. │ │ │ +0021ea10: 3c70 6172 613e 4120 7374 7269 6e67 2074 A string t │ │ │ +0021ea20: 6861 7420 6973 2061 206c 6973 7420 6f66 hat is a list of │ │ │ +0021ea30: 206e 616d 6573 7061 6365 2070 7265 6669 namespace prefi │ │ │ +0021ea40: 7820 6465 636c 6172 6174 696f 6e73 2064 x declarations d │ │ │ +0021ea50: 656c 696d 6974 6564 2062 7920 7768 6974 elimited by whit │ │ │ +0021ea60: 6573 7061 6365 2063 6861 7261 6374 6572 espace character │ │ │ +0021ea70: 732e 0a49 6620 7468 6520 3c70 6172 616d s..If the xpath_expn< │ │ │ +0021ea90: 2f70 6172 616d 6574 6572 3e20 6578 7072 /parameter> expr │ │ │ +0021eaa0: 6573 7369 6f6e 2061 6c73 6f20 636f 6e74 ession also cont │ │ │ +0021eab0: 6169 6e73 2061 206c 6973 7420 6f66 2064 ains a list of d │ │ │ +0021eac0: 6563 6c61 7261 7469 6f6e 7320 7468 656e eclarations then │ │ │ +0021ead0: 2074 6865 7365 2074 776f 0a6c 6973 7473 these two.lists │ │ │ +0021eae0: 2061 7265 2063 6f6e 6361 7465 6e61 7465 are concatenate │ │ │ +0021eaf0: 642e 3c2f 7061 7261 3e0a 2020 2020 3c2f d.. . . Return Types │ │ │ +0021eb50: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . The function │ │ │ +0021eb70: 7265 7475 726e 7320 6120 6e6f 6e2d 7363 returns a non-sc │ │ │ +0021eb80: 6865 6d61 2062 6173 6564 2058 4d4c 5479 hema based XMLTy │ │ │ +0021eb90: 7065 2069 6e73 7461 6e63 652c 204e 554c pe instance, NUL │ │ │ +0021eba0: 4c20 6f72 2061 2076 616c 7565 206f 6620 L or a value of │ │ │ +0021ebb0: 616e 7920 6f74 6865 7220 7479 7065 3c2f any other type. . . │ │ │ +0021ec00: 2020 203c 7469 746c 653e 4578 616d 706c Exampl │ │ │ +0021ec10: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ +0021ec20: 6578 616d 706c 6520 6964 3d22 6578 5f58 example id="ex_X │ │ │ +0021ec30: 4d4c 5479 7065 2e65 7874 7261 6374 223e MLType.extract"> │ │ │ +0021ec40: 3c74 6974 6c65 3e41 2074 6162 6c65 2077 A table w │ │ │ +0021ec50: 6974 6820 616e 2058 4d4c 5479 7065 2063 ith an XMLType c │ │ │ +0021ec60: 6f6c 756d 6e3c 2f74 6974 6c65 3e0a 2020 olumn. │ │ │ +0021ec70: 2020 2020 3c70 6172 613e 5468 6973 2070 This p │ │ │ +0021ec80: 6f70 756c 6174 6573 2061 2074 6162 6c65 opulates a table │ │ │ +0021ec90: 2077 6974 6820 584d 4c20 6461 7461 2061 with XML data a │ │ │ +0021eca0: 6e64 2074 6865 6e20 7365 6c65 6374 7320 nd then selects │ │ │ +0021ecb0: 2765 6e61 6d65 2720 656c 656d 656e 7420 'ename' element │ │ │ +0021ecc0: 6672 6f6d 2074 6865 2061 7070 726f 7072 from the appropr │ │ │ +0021ecd0: 6961 7465 2072 6563 6f72 642e 3c2f 7061 iate record.. 221< │ │ │ +0021ed80: 656e 616d 653e 4a6f 686e 3c2f 656e 616d ename>John'));.ins │ │ │ +0021eda0: 6572 7420 696e 746f 2054 4553 545f 584d ert into TEST_XM │ │ │ +0021edb0: 4c53 2020 7661 6c75 6573 2028 322c 2058 LS values (2, X │ │ │ +0021edc0: 4d4c 5479 7065 2827 3c70 6f3e 3c70 6f6e MLType('331PO_1'));.inser │ │ │ +0021ee00: 7420 696e 746f 2054 4553 545f 584d 4c53 t into TEST_XMLS │ │ │ +0021ee10: 2020 7661 6c75 6573 2028 332c 2058 4d4c values (3, XML │ │ │ +0021ee20: 5479 7065 2827 3c6f 696c 2d72 6967 2069 Type(''));.sel │ │ │ +0021ee70: 6563 7420 652e 584d 4c56 414c 2e65 7874 ect e.XMLVAL.ext │ │ │ +0021ee80: 7261 6374 2028 272f 2f65 6e61 6d65 2729 ract ('//ename') │ │ │ +0021ee90: 2e67 6574 434c 6f62 5661 6c28 2920 6173 .getCLobVal() as │ │ │ +0021eea0: 2045 4e41 4d45 0a20 2066 726f 6d20 5445 ENAME. from TE │ │ │ +0021eeb0: 5354 5f58 4d4c 5320 2061 7320 650a 2020 ST_XMLS as e. │ │ │ +0021eec0: 7768 6572 6520 652e 584d 4c56 414c 2e65 where e.XMLVAL.e │ │ │ +0021eed0: 7869 7374 734e 6f64 6528 272f 656d 702f xistsNode('/emp/ │ │ │ +0021eee0: 656d 706e 6f27 290a 454e 414d 450a 4e56 empno').ENAME.NV │ │ │ +0021eef0: 4152 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f ARCHAR._________ │ │ │ +0021ef00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021ef10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021ef20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021ef30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021ef40: 5f5f 5f5f 5f5f 0a0a 3c65 6e61 6d65 3e4a ______..J │ │ │ +0021ef50: 6f68 6e3c 2f65 6e61 6d65 3e0a 0a31 2052 ohn..1 R │ │ │ +0021ef60: 6f77 732e 202d 2d20 3030 3030 3020 6d73 ows. -- 00000 ms │ │ │ +0021ef70: 6563 2e0a 5d5d 3e0a 3c2f 7363 7265 656e ec..]]>.. │ │ │ +0021ef90: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +0021efa0: 203c 7265 6673 6563 7431 2069 643d 2273 . See Also. < │ │ │ +0021eff0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +0021f000: 5f58 4d4c 5479 7065 2e65 7869 7374 734e _XMLType.existsN │ │ │ +0021f010: 6f64 6522 3e3c 6675 6e63 7469 6f6e 3e58 ode">X │ │ │ +0021f020: 4d4c 5479 7065 2e65 7869 7374 734e 6f64 MLType.existsNod │ │ │ +0021f030: 6528 293c 2f66 756e 6374 696f 6e3e 3c2f e(). < │ │ │ +0021f050: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>.......demo │ │ │ +0021f070: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ +0021f080: 6368 722e 786d 6cdf 0000 114c 3c3f 786d chr.xml....L... │ │ │ +0021f430: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ +0021f440: 3c72 6566 656e 7472 7974 6974 6c65 3e63 c │ │ │ +0021f450: 6872 3c2f 7265 6665 6e74 7279 7469 746c hr. string. . . chr. │ │ │ +0021f4c0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +0021f4d0: 436f 6e76 6572 7420 6120 3c74 7970 653e Convert a │ │ │ +0021f4e0: 6c6f 6e67 3c2f 7479 7065 3e20 6368 6172 long char │ │ │ +0021f4f0: 6163 7465 7220 636f 6465 2074 6f20 6120 acter code to a │ │ │ +0021f500: 6368 6172 6163 7465 7220 6f72 2077 6964 character or wid │ │ │ +0021f510: 6520 6368 6172 6163 7465 723c 2f72 6566 e character. . . │ │ │ +0021f550: 3c66 756e 6373 796e 6f70 7369 7320 6964 . │ │ │ +0021f570: 2020 203c 6675 6e63 7072 6f74 6f74 7970 ..var │ │ │ +0021f5a0: 6368 6172 203c 6675 6e63 7469 6f6e 3e63 char c │ │ │ +0021f5b0: 6872 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 hr..in chr_codelong. . │ │ │ +0021f620: 3c2f 6675 6e63 7379 6e6f 7073 6973 3e0a . │ │ │ +0021f630: 2020 3c2f 7265 6673 796e 6f70 7369 7364 . Description │ │ │ +0021f670: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . chr │ │ │ +0021f690: 3c2f 6675 6e63 7469 6f6e 3e20 7265 7475 retu │ │ │ +0021f6a0: 726e 7320 6120 6e65 7720 6f6e 6520 6368 rns a new one ch │ │ │ +0021f6b0: 6172 6163 7465 7220 6c6f 6e67 2073 7472 aracter long str │ │ │ +0021f6c0: 696e 670a 2020 2020 636f 6e74 6169 6e69 ing. containi │ │ │ +0021f6d0: 6e67 2074 6865 2063 6861 7261 6374 6572 ng the character │ │ │ +0021f6e0: 2077 6974 6820 6368 6172 6163 7465 7220 with character │ │ │ +0021f6f0: 636f 6465 2067 6976 656e 2061 7320 7061 code given as pa │ │ │ +0021f700: 7261 6d65 7465 722e 3c2f 7061 7261 3e0a rameter.. │ │ │ +0021f710: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +0021f720: 3c72 6566 7365 6374 3120 6964 3d22 7061 Parameters</tit │ │ │ +0021f750: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ +0021f760: 323e 3c74 6974 6c65 3e3c 7061 7261 6d65 2><title><parame │ │ │ +0021f770: 7465 723e 6368 725f 636f 6465 3c2f 7061 ter>chr_code</pa │ │ │ +0021f780: 7261 6d65 7465 723e 3c2f 7469 746c 653e rameter> │ │ │ +0021f790: 0a20 2020 2020 203c 7061 7261 3e54 6865 . The │ │ │ +0021f7a0: 203c 7479 7065 3e4c 4f4e 473c 2f74 7970 LONG character cod │ │ │ +0021f7c0: 6520 7661 6c75 6520 666f 7220 7468 6520 e value for the │ │ │ +0021f7d0: 3c74 7970 653e 6368 6172 6163 7465 723c character< │ │ │ +0021f7e0: 2f74 7970 653e 206f 7220 3c74 7970 653e /type> or │ │ │ +0021f7f0: 7769 6465 2063 6861 7261 6374 6572 3c2f wide character to be prod │ │ │ +0021f810: 7563 6564 2e3c 2f70 6172 613e 0a20 2020 uced.. │ │ │ +0021f820: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ +0021f830: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Retur │ │ │ +0021f860: 6e20 5661 6c75 6573 3c2f 7469 746c 653e n Values │ │ │ +0021f870: 0a20 2020 203c 7061 7261 3e49 6620 7468 . If th │ │ │ +0021f880: 6520 3c70 6172 616d 6574 6572 3e63 6872 e chr │ │ │ +0021f890: 5f63 6f64 653c 2f70 6172 616d 6574 6572 _code is smaller tha │ │ │ +0021f8b0: 6e20 6f72 2065 7175 616c 2074 6f20 3235 n or equal to 25 │ │ │ +0021f8c0: 352c 2074 6865 2072 6574 7572 6e65 6420 5, the returned │ │ │ +0021f8d0: 3120 6368 6172 6163 7465 7220 7374 7269 1 character stri │ │ │ +0021f8e0: 6e67 2077 696c 6c20 6265 206f 6620 7479 ng will be of ty │ │ │ +0021f8f0: 7065 203c 7479 7065 3e56 4152 4348 4152 pe VARCHAR │ │ │ +0021f900: 3c2f 7479 7065 3e2e 204f 7468 6572 7769 . Otherwi │ │ │ +0021f910: 7365 2074 6865 2072 6574 7572 6e65 6420 se the returned │ │ │ +0021f920: 7479 7065 2069 7320 3c74 7970 653e 4e56 type is NV │ │ │ +0021f930: 4152 4348 4152 3c2f 7479 7065 3e2e 3c2f ARCHAR.. . │ │ │ +0021f970: 3c74 6974 6c65 3e45 7272 6f72 733c 2f74 Errors</t │ │ │ +0021f980: 6974 6c65 3e0a 2020 2020 3c74 6162 6c65 itle>. <table │ │ │ +0021f990: 3e3c 7469 746c 653e 4572 726f 7273 2073 ><title>Errors s │ │ │ +0021f9a0: 6967 6e61 6c6c 6564 2062 7920 6368 723c ignalled by chr< │ │ │ +0021f9b0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c74 /title>. <t │ │ │ +0021f9c0: 6772 6f75 7020 636f 6c73 3d22 3222 3e0a group cols="2">. │ │ │ +0021f9d0: 093c 7462 6f64 793e 0a09 2020 3c72 6f77 .<tbody>.. <row │ │ │ +0021f9e0: 3e0a 0920 2020 203c 656e 7472 793e 3c65 >.. <entry><e │ │ │ +0021f9f0: 7272 6f72 636f 6465 3e3c 2f65 7272 6f72 rrorcode></error │ │ │ +0021fa00: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ +0021fa10: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ +0021fa20: 6e61 6d65 3e3c 2f65 7272 6f72 6e61 6d65 name></errorname │ │ │ +0021fa30: 3e3c 2f65 6e74 7279 3e0a 0920 203c 2f72 ></entry>.. </r │ │ │ +0021fa40: 6f77 3e0a 093c 2f74 626f 6479 3e0a 2020 ow>..</tbody>. │ │ │ +0021fa50: 2020 2020 3c2f 7467 726f 7570 3e0a 2020 </tgroup>. │ │ │ +0021fa60: 2020 3c2f 7461 626c 653e 0a20 203c 2f72 </table>. </r │ │ │ +0021fa70: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ +0021fa80: 6563 7431 2069 643d 2265 7861 6d70 6c65 ect1 id="example │ │ │ +0021fa90: 735f 6368 7222 3e3c 7469 746c 653e 4578 s_chr"><title>Ex │ │ │ +0021faa0: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ +0021fab0: 2020 203c 6578 616d 706c 6520 6964 3d22 Simple example< │ │ │ +0021fae0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c73 /title>. <s │ │ │ +0021faf0: 6372 6565 6e3e 5351 4c3e 2073 656c 6563 creen>SQL> selec │ │ │ +0021fb00: 7420 6368 7220 2833 3329 3b0a 6361 6c6c t chr (33);.call │ │ │ +0021fb10: 7265 740a 5641 5243 4841 520a 5f5f 5f5f ret.VARCHAR.____ │ │ │ +0021fb20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fb30: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fb40: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fb50: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fb60: 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a 0a21 0a0a ___________..!.. │ │ │ +0021fb70: 3120 526f 7773 2e20 2d2d 2033 206d 7365 1 Rows. -- 3 mse │ │ │ +0021fb80: 632e 0a20 2020 2020 203c 2f73 6372 6565 c.. </scree │ │ │ +0021fb90: 6e3e 0a20 2020 203c 2f65 7861 6d70 6c65 n>. </example │ │ │ +0021fba0: 3e0a 2020 2020 3c65 7861 6d70 6c65 2069 >. <example i │ │ │ +0021fbb0: 643d 2265 785f 6368 725f 3222 3e3c 7469 d="ex_chr_2"><ti │ │ │ +0021fbc0: 746c 653e 5374 6f72 6564 2070 726f 6365 tle>Stored proce │ │ │ +0021fbd0: 6475 7265 2065 7861 6d70 6c65 3c2f 7469 dure example</ti │ │ │ +0021fbe0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +0021fbf0: 3e54 6869 7320 7374 6f72 6564 2070 726f >This stored pro │ │ │ +0021fc00: 6365 6475 7265 206c 6973 7473 2074 6865 cedure lists the │ │ │ +0021fc10: 2041 5343 4949 2076 616c 7565 7320 616e ASCII values an │ │ │ +0021fc20: 6420 6368 6172 6163 7465 7273 2069 6e20 d characters in │ │ │ +0021fc30: 6120 7374 7269 6e67 2067 6976 656e 2061 a string given a │ │ │ +0021fc40: 7320 6172 6775 6d65 6e74 2e3c 2f70 6172 s argument.</par │ │ │ +0021fc50: 613e 0a20 2020 2020 203c 7363 7265 656e a>. <screen │ │ │ +0021fc60: 3e0a 5351 4c3e 2063 7265 6174 6520 7072 >.SQL> create pr │ │ │ +0021fc70: 6f63 6564 7572 650a 7465 7374 5f63 6872 ocedure.test_chr │ │ │ +0021fc80: 2028 696e 2073 7472 2076 6172 6368 6172 (in str varchar │ │ │ +0021fc90: 290a 7b0a 2020 6465 636c 6172 6520 706f ).{. declare po │ │ │ +0021fca0: 7320 696e 7465 6765 723b 2070 6f73 203a s integer; pos : │ │ │ +0021fcb0: 3d20 303b 0a20 2064 6563 6c61 7265 2063 = 0;. declare c │ │ │ +0021fcc0: 5f63 6f64 652c 2063 5f63 6f64 6532 2069 _code, c_code2 i │ │ │ +0021fcd0: 6e74 6567 6572 3b20 6465 636c 6172 6520 nteger; declare │ │ │ +0021fce0: 635f 6368 6172 2076 6172 6368 6172 3b0a c_char varchar;. │ │ │ +0021fcf0: 0a20 2072 6573 756c 745f 6e61 6d65 7320 . result_names │ │ │ +0021fd00: 2863 5f63 6f64 652c 2063 5f63 6f64 6532 (c_code, c_code2 │ │ │ +0021fd10: 2c20 635f 6368 6172 293b 0a0a 2020 7768 , c_char);.. wh │ │ │ +0021fd20: 696c 6520 2870 6f73 2026 6c74 3b20 6c65 ile (pos < le │ │ │ +0021fd30: 6e67 7468 2028 7374 7229 290a 2020 2020 ngth (str)). │ │ │ +0021fd40: 7b0a 2020 2020 2020 7265 7375 6c74 2028 {. result ( │ │ │ +0021fd50: 6172 6566 2028 7374 722c 2070 6f73 292c aref (str, pos), │ │ │ +0021fd60: 2061 7363 6969 2028 7375 6273 6571 2028 ascii (subseq ( │ │ │ +0021fd70: 7374 722c 2070 6f73 2c20 706f 732b 312c str, pos, pos+1, │ │ │ +0021fd80: 2031 2929 2c0a 2020 2020 2020 2020 6368 1)),. ch │ │ │ +0021fd90: 7220 2861 7265 6620 2873 7472 2c20 706f r (aref (str, po │ │ │ +0021fda0: 7329 2929 3b0a 2020 2020 2020 706f 7320 s)));. pos │ │ │ +0021fdb0: 3a3d 2070 6f73 202b 2031 3b0a 2020 2020 := pos + 1;. │ │ │ +0021fdc0: 7d0a 7d0a 3b0a 0a44 6f6e 652e 202d 2d20 }.}.;..Done. -- │ │ │ +0021fdd0: 3720 6d73 6563 2e0a 5351 4c3e 2074 6573 7 msec..SQL> tes │ │ │ +0021fde0: 745f 6368 7220 2827 4e65 6275 6368 6164 t_chr ('Nebuchad │ │ │ +0021fdf0: 6e65 7373 6172 2729 3b0a 635f 636f 6465 nessar');.c_code │ │ │ +0021fe00: 2020 2020 2020 2020 2020 2020 635f 636f c_co │ │ │ +0021fe10: 6465 3220 2020 2020 2020 2020 2020 635f de2 c_ │ │ │ +0021fe20: 6368 6172 0a49 4e54 4547 4552 204e 4f54 char.INTEGER NOT │ │ │ +0021fe30: 204e 554c 4c20 2049 4e54 4547 4552 204e NULL INTEGER N │ │ │ +0021fe40: 4f54 204e 554c 4c20 2056 4152 4348 4152 OT NULL VARCHAR │ │ │ +0021fe50: 204e 4f54 204e 554c 4c0a 5f5f 5f5f 5f5f NOT NULL.______ │ │ │ +0021fe60: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fe70: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fe80: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fe90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +0021fea0: 5f5f 5f5f 5f5f 5f5f 5f0a 0a37 3820 2020 _________..78 │ │ │ +0021feb0: 2020 2020 2020 2020 2020 2020 2037 3820 78 │ │ │ +0021fec0: 2020 2020 2020 2020 2020 2020 2020 204e N │ │ │ +0021fed0: 0a31 3031 2020 2020 2020 2020 2020 2020 .101 │ │ │ +0021fee0: 2020 2031 3031 2020 2020 2020 2020 2020 101 │ │ │ +0021fef0: 2020 2020 2065 0a39 3820 2020 2020 2020 e.98 │ │ │ +0021ff00: 2020 2020 2020 2020 2039 3820 2020 2020 98 │ │ │ +0021ff10: 2020 2020 2020 2020 2020 2062 0a31 3137 b.117 │ │ │ +0021ff20: 2020 2020 2020 2020 2020 2020 2020 2031 1 │ │ │ +0021ff30: 3137 2020 2020 2020 2020 2020 2020 2020 17 │ │ │ +0021ff40: 2075 0a39 3920 2020 2020 2020 2020 2020 u.99 │ │ │ +0021ff50: 2020 2020 2039 3920 2020 2020 2020 2020 99 │ │ │ +0021ff60: 2020 2020 2020 2063 0a31 3034 2020 2020 c.104 │ │ │ +0021ff70: 2020 2020 2020 2020 2020 2031 3034 2020 104 │ │ │ +0021ff80: 2020 2020 2020 2020 2020 2020 2068 0a39 h.9 │ │ │ +0021ff90: 3720 2020 2020 2020 2020 2020 2020 2020 7 │ │ │ +0021ffa0: 2039 3720 2020 2020 2020 2020 2020 2020 97 │ │ │ +0021ffb0: 2020 2061 0a31 3030 2020 2020 2020 2020 a.100 │ │ │ +0021ffc0: 2020 2020 2020 2031 3030 2020 2020 2020 100 │ │ │ +0021ffd0: 2020 2020 2020 2020 2064 0a31 3130 2020 d.110 │ │ │ +0021ffe0: 2020 2020 2020 2020 2020 2020 2031 3130 110 │ │ │ +0021fff0: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ +00220000: 0a31 3031 2020 2020 2020 2020 2020 2020 .101 │ │ │ +00220010: 2020 2031 3031 2020 2020 2020 2020 2020 101 │ │ │ +00220020: 2020 2020 2065 0a31 3135 2020 2020 2020 e.115 │ │ │ +00220030: 2020 2020 2020 2020 2031 3135 2020 2020 115 │ │ │ +00220040: 2020 2020 2020 2020 2020 2073 0a31 3135 s.115 │ │ │ +00220050: 2020 2020 2020 2020 2020 2020 2020 2031 1 │ │ │ +00220060: 3135 2020 2020 2020 2020 2020 2020 2020 15 │ │ │ +00220070: 2073 0a39 3720 2020 2020 2020 2020 2020 s.97 │ │ │ +00220080: 2020 2020 2039 3720 2020 2020 2020 2020 97 │ │ │ +00220090: 2020 2020 2020 2061 0a31 3134 2020 2020 a.114 │ │ │ +002200a0: 2020 2020 2020 2020 2020 2031 3134 2020 114 │ │ │ +002200b0: 2020 2020 2020 2020 2020 2020 2072 0a0a r.. │ │ │ +002200c0: 3134 2052 6f77 732e 202d 2d20 3720 6d73 14 Rows. -- 7 ms │ │ │ +002200d0: 6563 2e0a 2020 2020 2020 3c2f 7363 7265 ec.. </scre │ │ │ +002200e0: 656e 3e0a 2020 2020 3c2f 6578 616d 706c en>. </exampl │ │ │ +002200f0: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ +00220100: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ +00220110: 2273 6565 616c 736f 5f63 6872 223e 3c74 "seealso_chr"><t │ │ │ +00220120: 6974 6c65 3e53 6565 2041 6c73 6f3c 2f74 itle>See Also</t │ │ │ +00220130: 6974 6c65 3e0a 2020 2020 3c70 6172 613e itle>. <para> │ │ │ +00220140: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ +00220150: 6e5f 6172 6566 223e 3c66 756e 6374 696f n_aref"><functio │ │ │ +00220160: 6e3e 6172 6566 3c2f 6675 6e63 7469 6f6e n>aref</function │ │ │ +00220170: 3e3c 2f6c 696e 6b3e 2c20 3c6c 696e 6b20 ></link>, <link │ │ │ +00220180: 6c69 6e6b 656e 643d 2266 6e5f 6173 6369 linkend="fn_asci │ │ │ +00220190: 6922 3e3c 6675 6e63 7469 6f6e 3e61 7363 i"><function>asc │ │ │ +002201a0: 6969 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ii</function></l │ │ │ +002201b0: 696e 6b3e 3c2f 7061 7261 3e0a 2020 3c2f ink></para>. </ │ │ │ +002201c0: 7265 6673 6563 7431 3e0a 3c2f 7265 6665 refsect1>.</refe │ │ │ +002201d0: 6e74 7279 3e0a 0a0a b600 0000 2764 656d ntry>.......'dem │ │ │ +002201e0: 6f2f 646f 6373 7263 2f66 756e 6372 6566 o/docsrc/funcref │ │ │ +002201f0: 2f78 656e 635f 6b65 795f 6578 6973 7473 /xenc_key_exists │ │ │ +00220200: 2e78 6d6c df00 000a 1c3c 3f78 6d6c 2076 .xml.....<?xml v │ │ │ +00220210: 6572 7369 6f6e 3d22 312e 3022 2065 6e63 ersion="1.0" enc │ │ │ +00220220: 6f64 696e 673d 2249 534f 2d38 3835 392d oding="ISO-8859- │ │ │ +00220230: 3122 3f3e 0a3c 212d 2d0a 202d 2020 0a20 1"?>.<!--. - . │ │ │ +00220240: 2d20 2054 6869 7320 6669 6c65 2069 7320 - This file is │ │ │ +00220250: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ +00220260: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ +00220270: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ +00220280: 6365 2028 564f 5329 0a20 2d20 2070 726f ce (VOS). - pro │ │ │ +00220290: 6a65 6374 2e0a 202d 2020 0a20 2d20 2043 ject.. - . - C │ │ │ +002202a0: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ +002202b0: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ +002202c0: 536f 6674 7761 7265 0a20 2d20 200a 202d Software. - . - │ │ │ +002202d0: 2020 5468 6973 2070 726f 6a65 6374 2069 This project i │ │ │ +002202e0: 7320 6672 6565 2073 6f66 7477 6172 653b s free software; │ │ │ +002202f0: 2079 6f75 2063 616e 2072 6564 6973 7472 you can redistr │ │ │ +00220300: 6962 7574 6520 6974 2061 6e64 2f6f 7220 ibute it and/or │ │ │ +00220310: 6d6f 6469 6679 2069 740a 202d 2020 756e modify it. - un │ │ │ +00220320: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ +00220330: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ +00220340: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +00220350: 6173 2070 7562 6c69 7368 6564 2062 7920 as published by │ │ │ +00220360: 7468 650a 202d 2020 4672 6565 2053 6f66 the. - Free Sof │ │ │ +00220370: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ +00220380: 3b20 6f6e 6c79 2076 6572 7369 6f6e 2032 ; only version 2 │ │ │ +00220390: 206f 6620 7468 6520 4c69 6365 6e73 652c of the License, │ │ │ +002203a0: 2064 6174 6564 204a 756e 6520 3139 3931 dated June 1991 │ │ │ +002203b0: 2e0a 202d 2020 0a20 2d20 2054 6869 7320 .. - . - This │ │ │ +002203c0: 7072 6f67 7261 6d20 6973 2064 6973 7472 program is distr │ │ │ +002203d0: 6962 7574 6564 2069 6e20 7468 6520 686f ibuted in the ho │ │ │ +002203e0: 7065 2074 6861 7420 6974 2077 696c 6c20 pe that it will │ │ │ +002203f0: 6265 2075 7365 6675 6c2c 2062 7574 0a20 be useful, but. │ │ │ +00220400: 2d20 2057 4954 484f 5554 2041 4e59 2057 - WITHOUT ANY W │ │ │ +00220410: 4152 5241 4e54 593b 2077 6974 686f 7574 ARRANTY; without │ │ │ +00220420: 2065 7665 6e20 7468 6520 696d 706c 6965 even the implie │ │ │ +00220430: 6420 7761 7272 616e 7479 206f 660a 202d d warranty of. - │ │ │ +00220440: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ +00220450: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ +00220460: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ +00220470: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ +00220480: 4e55 0a20 2d20 2047 656e 6572 616c 2050 NU. - General P │ │ │ +00220490: 7562 6c69 6320 4c69 6365 6e73 6520 666f ublic License fo │ │ │ +002204a0: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ +002204b0: 202d 2020 0a20 2d20 2059 6f75 2073 686f - . - You sho │ │ │ +002204c0: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ +002204d0: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ +002204e0: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ +002204f0: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ +00220500: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ +00220510: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ +00220520: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ +00220530: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ +00220540: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ +00220550: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ +00220560: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ +00220570: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ +00220580: 3330 3120 5553 410a 202d 2020 0a20 2d20 301 USA. - . - │ │ │ +00220590: 200a 2d2d 3e0a 3c72 6566 656e 7472 7920 .-->.<refentry │ │ │ +002205a0: 6964 3d22 666e 5f78 656e 635f 6b65 795f id="fn_xenc_key_ │ │ │ +002205b0: 6578 6973 7473 223e 0a20 203c 7265 666d exists">. <refm │ │ │ +002205c0: 6574 613e 0a20 2020 203c 7265 6665 6e74 eta>. <refent │ │ │ +002205d0: 7279 7469 746c 653e 7865 6e63 5f6b 6579 rytitle>xenc_key │ │ │ +002205e0: 5f65 7869 7374 733c 2f72 6566 656e 7472 _exists</refentr │ │ │ +002205f0: 7974 6974 6c65 3e0a 2020 2020 3c72 6566 ytitle>. <ref │ │ │ +00220600: 6d69 7363 696e 666f 3e68 6173 683c 2f72 miscinfo>hash</r │ │ │ +00220610: 6566 6d69 7363 696e 666f 3e0a 2020 3c2f efmiscinfo>. </ │ │ │ +00220620: 7265 666d 6574 613e 0a20 203c 7265 666e refmeta>. <refn │ │ │ +00220630: 616d 6564 6976 3e0a 2020 2020 3c72 6566 amediv>. <ref │ │ │ +00220640: 6e61 6d65 3e78 656e 635f 6b65 795f 6578 name>xenc_key_ex │ │ │ +00220650: 6973 7473 3c2f 7265 666e 616d 653e 0a20 ists</refname>. │ │ │ +00220660: 2020 203c 7265 6670 7572 706f 7365 3e43 <refpurpose>C │ │ │ +00220670: 6865 636b 2069 6620 6e61 6d65 6420 656e heck if named en │ │ │ +00220680: 6372 7970 7469 6f6e 206b 6579 2069 7320 cryption key is │ │ │ +00220690: 696e 2074 6865 2020 7573 6572 2773 2072 in the user's r │ │ │ +002206a0: 6570 6f73 6974 6f72 793c 2f72 6566 7075 epository</refpu │ │ │ +002206b0: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ +002206c0: 6d65 6469 763e 0a20 203c 7265 6673 796e mediv>. <refsyn │ │ │ +002206d0: 6f70 7369 7364 6976 3e0a 2020 2020 3c66 opsisdiv>. <f │ │ │ +002206e0: 756e 6373 796e 6f70 7369 7320 6964 3d22 uncsynopsis id=" │ │ │ +002206f0: 6673 796e 5f78 656e 635f 6b65 795f 6578 fsyn_xenc_key_ex │ │ │ +00220700: 6973 7473 223e 0a20 2020 2020 203c 6675 ists">. <fu │ │ │ +00220710: 6e63 7072 6f74 6f74 7970 6520 6964 3d22 ncprototype id=" │ │ │ +00220720: 6670 726f 746f 5f78 656e 635f 6b65 795f fproto_xenc_key_ │ │ │ +00220730: 6578 6973 7473 223e 0a20 2020 2020 2020 exists">. │ │ │ +00220740: 203c 6675 6e63 6465 663e 696e 7420 3c66 <funcdef>int <f │ │ │ +00220750: 756e 6374 696f 6e3e 7865 6e63 5f6b 6579 unction>xenc_key │ │ │ +00220760: 5f65 7869 7374 733c 2f66 756e 6374 696f _exists</functio │ │ │ +00220770: 6e3e 3c2f 6675 6e63 6465 663e 0a09 3c70 n></funcdef>..<p │ │ │ +00220780: 6172 616d 6465 663e 696e 203c 7061 7261 aramdef>in <para │ │ │ +00220790: 6d65 7465 723e 6e61 6d65 3c2f 7061 7261 meter>name</para │ │ │ +002207a0: 6d65 7465 723e 2076 6172 6368 6172 3c2f meter> varchar</ │ │ │ +002207b0: 7061 7261 6d64 6566 3e0a 2020 2020 2020 paramdef>. │ │ │ +002207c0: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e </funcprototype> │ │ │ +002207d0: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . </funcsynop │ │ │ +002207e0: 7369 733e 0a20 203c 2f72 6566 7379 6e6f sis>. </refsyno │ │ │ +002207f0: 7073 6973 6469 763e 0a20 203c 7265 6673 psisdiv>. <refs │ │ │ +00220800: 6563 7431 2069 643d 2264 6573 635f 7865 ect1 id="desc_xe │ │ │ +00220810: 6e63 5f6b 6579 5f65 7869 7374 7322 3e0a nc_key_exists">. │ │ │ +00220820: 2020 2020 3c74 6974 6c65 3e44 6573 6372 <title>Descr │ │ │ +00220830: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ +00220840: 2020 203c 7061 7261 3e54 6865 2066 756e The fun │ │ │ +00220850: 6374 696f 6e20 6368 6563 6b73 2069 6620 ction checks if │ │ │ +00220860: 6b65 7920 7769 7468 2067 6976 656e 206e key with given n │ │ │ +00220870: 616d 6520 6578 6973 7473 2069 6e20 7468 ame exists in th │ │ │ +00220880: 6520 7573 6572 2773 206b 6579 732e 3c2f e user's keys.. . . │ │ │ +002208d0: 203c 7469 746c 653e 5061 7261 6d65 7465 Paramete │ │ │ +002208e0: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ +002208f0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ +00220900: 6e61 6d65 3c2f 7469 746c 653e 0a20 2020 name. │ │ │ +00220910: 2020 203c 7061 7261 3e54 6865 206e 616d The nam │ │ │ +00220920: 6520 6f66 2074 6865 206b 6579 3c2f 7061 e of the key. . . Re │ │ │ +00220980: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ +00220990: 653e 0a20 2020 2020 203c 7061 7261 3e54 e>. <para>T │ │ │ +002209a0: 6865 2066 756e 6374 696f 6e20 7265 7475 he function retu │ │ │ +002209b0: 726e 7320 696e 7465 6765 7220 3120 2d20 rns integer 1 - │ │ │ +002209c0: 7472 7565 206f 7220 3020 2d20 6661 6c73 true or 0 - fals │ │ │ +002209d0: 6520 287a 6572 6f29 2069 6620 6b65 7920 e (zero) if key │ │ │ +002209e0: 6578 6973 7473 206f 7220 6e6f 743c 2f70 exists or not</p │ │ │ +002209f0: 6172 613e 0a20 203c 2f72 6566 7365 6374 ara>. </refsect │ │ │ +00220a00: 313e 0a20 203c 7265 6673 6563 7431 2069 1>. <refsect1 i │ │ │ +00220a10: 643d 2265 7861 6d70 6c65 735f 7865 6e63 d="examples_xenc │ │ │ +00220a20: 5f6b 6579 5f65 7869 7374 7322 3e0a 2020 _key_exists">. │ │ │ +00220a30: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 <title>Example │ │ │ +00220a40: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. < │ │ │ +00220a70: 7469 746c 653e 5369 6d70 6c65 2055 7365 title>Simple Use │ │ │ +00220a80: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +00220a90: 7363 7265 656e 3e3c 215b 4344 4154 415b screen> select xen │ │ │ +00220ab0: 635f 6b65 795f 6578 6973 7473 2028 274d c_key_exists ('M │ │ │ +00220ac0: 794b 6579 2729 3b0a 5641 5243 4841 520a yKey');.VARCHAR. │ │ │ +00220ad0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00220ae0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00220af0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00220b00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00220b10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a _______________. │ │ │ +00220b20: 0a30 0a0a 3120 526f 7773 2e20 2d2d 2031 .0..1 Rows. -- 1 │ │ │ +00220b30: 206d 7365 632e 0a0a 5d5d 3e0a 3c2f 7363 msec...]]>.. . . . │ │ │ +00220b90: 203c 7469 746c 653e 5365 6520 416c 736f See Also │ │ │ +00220ba0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . │ │ │ +00220be0: 7865 6e63 5f6b 6579 5f72 656d 6f76 6528 xenc_key_remove( │ │ │ +00220bf0: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 ). .......demo/d │ │ │ +00220c30: 6f63 7372 632f 6675 6e63 7265 662f 7274 ocsrc/funcref/rt │ │ │ +00220c40: 7269 6d2e 786d 6cdf 0000 0869 3c3f 786d rim.xml....i... . │ │ │ +00221000: 2020 3c72 6566 656e 7472 7974 6974 6c65 rtrim. string. < │ │ │ +00221050: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . rtrim. trims give │ │ │ +002210a0: 6e20 6368 6172 6163 7465 7273 2066 726f n characters fro │ │ │ +002210b0: 6d20 7269 6768 7420 6f66 2067 6976 656e m right of given │ │ │ +002210c0: 2073 7472 696e 673c 2f72 6566 7075 7270 string. . . . │ │ │ +00221120: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . rt │ │ │ +00221160: 7269 6d3c 2f66 756e 6374 696f 6e3e 3c2f rim. │ │ │ +00221180: 203c 7061 7261 6d64 6566 3e3c 7061 7261 str string. │ │ │ +002211c0: 3c70 6172 616d 6465 663e 3c6f 7074 696f t │ │ │ +002211e0: 7269 6d63 6861 7273 3c2f 7061 7261 6d65 rimchars string. . . < │ │ │ +00221240: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ +00221250: 0a20 203c 7265 6673 6563 7431 2069 643d . De │ │ │ +00221270: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription.... l │ │ │ +00221290: 7472 696d 2072 6574 7572 6e73 2061 2063 trim returns a c │ │ │ +002212a0: 6f70 7920 6f66 2073 7562 7365 7175 656e opy of subsequen │ │ │ +002212b0: 6365 206f 6620 7374 7269 6e67 2073 7472 ce of string str │ │ │ +002212c0: 2077 6974 6820 616c 6c20 7468 6520 6368 with all the ch │ │ │ +002212d0: 6172 6163 7465 7273 0a70 7265 7365 6e74 aracters.present │ │ │ +002212e0: 2069 6e20 7472 696d 6368 6172 7320 7472 in trimchars tr │ │ │ +002212f0: 696d 6d65 6420 6f66 6620 6672 6f6d 2074 immed off from t │ │ │ +00221300: 6865 2062 6567 696e 6e69 6e67 2e20 4966 he beginning. If │ │ │ +00221310: 2074 6865 2073 6563 6f6e 6420 6172 6775 the second argu │ │ │ +00221320: 6d65 6e74 2069 7320 6f6d 6974 7465 642c ment is omitted, │ │ │ +00221330: 2069 7420 6973 2061 0a73 7061 6365 2027 it is a.space ' │ │ │ +00221340: 2027 2062 7920 6465 6661 756c 742e 3c2f ' by default.. r │ │ │ +00221360: 7472 696d 2069 7320 7369 6d69 6c61 7220 trim is similar │ │ │ +00221370: 6578 6365 7074 2074 6861 7420 6974 2074 except that it t │ │ │ +00221380: 7269 6d73 2066 726f 6d20 7468 6520 7269 rims from the ri │ │ │ +00221390: 6768 742e 3c2f 7061 7261 3e0a 2020 203c ght.. < │ │ │ +002213a0: 7061 7261 3e74 7269 6d20 7472 696d 7320 para>trim trims │ │ │ +002213b0: 6672 6f6d 2062 6f74 6820 656e 6473 2e3c from both ends.< │ │ │ +002213c0: 2f70 6172 613e 0a09 0909 3c73 6372 6565 /para>....concat('*',tri │ │ │ +002213e0: 6d28 2720 2020 5349 4d55 5247 2020 2027 m(' SIMURG ' │ │ │ +002213f0: 292c 272a 2729 202d 2667 743b 2027 2a53 ),'*') -> '*S │ │ │ +00221400: 494d 5552 472a 270a 6c74 7269 6d28 2741 IMURG*'.ltrim('A │ │ │ +00221410: 6272 6163 6164 6162 7241 272c 2762 4172 bracadabrA','bAr │ │ │ +00221420: 2729 2020 2d26 6774 3b20 2761 6361 6461 ') -> 'acada │ │ │ +00221430: 6272 4127 0a72 7472 696d 2827 4162 7261 brA'.rtrim('Abra │ │ │ +00221440: 6361 6461 6272 4127 2c27 6241 7227 2920 cadabrA','bAr') │ │ │ +00221450: 202d 2667 743b 2027 4162 7261 6361 6461 -> 'Abracada │ │ │ +00221460: 270a 7472 696d 2827 4162 7261 6361 6461 '.trim('Abracada │ │ │ +00221470: 6272 4127 2c27 6241 7227 2920 2020 202d brA','bAr') - │ │ │ +00221480: 2667 743b 2027 6163 6164 6127 0a3c 2f73 > 'acada'..... │ │ │ +002214b0: 0a0a 0a0a 0ab6 0000 0028 6465 6d6f 2f64 .........(demo/d │ │ │ +002214c0: 6f63 7372 632f 6675 6e63 7265 662f 6366 ocsrc/funcref/cf │ │ │ +002214d0: 675f 7365 6374 696f 6e5f 6e61 6d65 2e78 g_section_name.x │ │ │ +002214e0: 6d6c df00 000c f73c 3f78 6d6c 2076 6572 ml........ . cfg_sect │ │ │ +002218c0: 696f 6e5f 6e61 6d65 3c2f 7265 6665 6e74 ion_name. admin< │ │ │ +002218f0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +00221900: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . cfg_secti │ │ │ +00221930: 6f6e 5f6e 616d 653c 2f72 6566 6e61 6d65 on_name. returns INI fi │ │ │ +00221960: 6c65 2073 6563 7469 6f6e 206e 616d 653c le section name< │ │ │ +00221970: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ +00221980: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ +00221990: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ +002219a0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . │ │ │ +002219d0: 2020 2020 3c66 756e 6370 726f 746f 7479 │ │ │ +00221a00: 0a20 2020 2020 2020 203c 6675 6e63 6465 . cfg_ │ │ │ +00221a20: 7365 6374 696f 6e5f 6e61 6d65 3c2f 6675 section_name. in path varchar.

    in index integer< │ │ │ +00221ac0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +00221ad0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . Description< │ │ │ +00221b40: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. Returns the na │ │ │ +00221b60: 6d65 206f 6620 7365 6374 696f 6e20 7370 me of section sp │ │ │ +00221b70: 6563 6966 6965 6420 6279 2074 6865 2069 ecified by the i │ │ │ +00221b80: 6e64 6578 0a20 2020 2028 6265 6769 6e73 ndex. (begins │ │ │ +00221b90: 2066 726f 6d20 7a65 726f 292e 2049 6620 from zero). If │ │ │ +00221ba0: 7468 6520 696e 6465 7820 6361 6e20 7265 the index can re │ │ │ +00221bb0: 6665 7265 6e63 6520 6120 7365 6374 696f ference a sectio │ │ │ +00221bc0: 6e2c 2074 6865 2074 6861 740a 2020 2020 n, the that. │ │ │ +00221bd0: 7365 6374 696f 6e20 6e61 6d65 2069 7320 section name is │ │ │ +00221be0: 7265 7475 726e 6564 2c20 6f74 6865 7277 returned, otherw │ │ │ +00221bf0: 6973 6520 7265 7475 726e 7320 7a65 726f ise returns zero │ │ │ +00221c00: 206f 6e20 6572 726f 722e 3c2f 7061 7261 on error.. . │ │ │ +00221c20: 2020 3c72 6566 7365 6374 3120 6964 3d22 Para │ │ │ +00221c50: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ +00221c60: 2020 203c 7265 6673 6563 7432 3e3c 7469 path │ │ │ +00221c80: 0a20 2020 2020 203c 7061 7261 3e4e 616d . Nam │ │ │ +00221c90: 6520 6f66 2074 6865 2049 4e49 2066 696c e of the INI fil │ │ │ +00221ca0: 652e 3c2f 7061 7261 3e0a 2020 2020 3c2f e.. . i │ │ │ +00221cd0: 6e64 6578 3c2f 7469 746c 653e 0a20 2020 ndex. │ │ │ +00221ce0: 2020 203c 7061 7261 3e5a 6572 6f20 6261 Zero ba │ │ │ +00221cf0: 7365 6420 696e 6465 7820 7468 6174 2072 sed index that r │ │ │ +00221d00: 6566 6572 656e 6365 7320 6120 7365 6374 eferences a sect │ │ │ +00221d10: 696f 6e2e 3c2f 7061 7261 3e0a 2020 2020 ion.. │ │ │ +00221d20: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f . . Return Values │ │ │ +00221d70: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . An varc │ │ │ +00221d90: 6861 723c 2f74 7970 653e 2063 6f6e 7461 har conta │ │ │ +00221da0: 696e 696e 6720 7468 6520 6e61 6d65 206f ining the name o │ │ │ +00221db0: 6620 7365 6374 696f 6e2e 3c2f 7061 7261 f section.. . │ │ │ +00221dd0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Ex │ │ │ +00221e00: 616d 706c 6573 3c2f 7469 746c 653e 0a20 amples. │ │ │ +00221e10: 2020 203c 6578 616d 706c 6520 6964 3d22 Simp │ │ │ +00221e40: 6c65 2065 7861 6d70 6c65 733c 2f74 6974 le examples</tit │ │ │ +00221e50: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +00221e60: 4765 7420 7468 6520 7365 636f 6e64 2073 Get the second s │ │ │ +00221e70: 6563 7469 6f6e 206e 616d 6520 6672 6f6d ection name from │ │ │ +00221e80: 2074 6865 0a20 2020 2020 2063 7572 7265 the. curre │ │ │ +00221e90: 6e74 2076 6972 7475 6f73 6f2e 696e 6920 nt virtuoso.ini │ │ │ +00221ea0: 6669 6c65 2e3c 2f70 6172 613e 0a20 2020 file.</para>. │ │ │ +00221eb0: 2020 203c 7363 7265 656e 3e0a 5351 4c3e <screen>.SQL> │ │ │ +00221ec0: 2073 656c 6563 7420 6366 675f 7365 6374 select cfg_sect │ │ │ +00221ed0: 696f 6e5f 6e61 6d65 2876 6972 7475 6f73 ion_name(virtuos │ │ │ +00221ee0: 6f5f 696e 695f 7061 7468 2829 2c20 3129 o_ini_path(), 1) │ │ │ +00221ef0: 3b0a 6361 6c6c 7265 740a 5641 5243 4841 ;.callret.VARCHA │ │ │ +00221f00: 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f R.______________ │ │ │ +00221f10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00221f20: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00221f30: 5f5f 5f5f 5f5f 5f0a 0a50 6172 616d 6574 _______..Paramet │ │ │ +00221f40: 6572 733c 2f73 6372 6565 6e3e 0a20 2020 ers</screen>. │ │ │ +00221f50: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f </example>. </ │ │ │ +00221f60: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ +00221f70: 7365 6374 3120 6964 3d22 7365 6561 6c73 sect1 id="seeals │ │ │ +00221f80: 6f5f 7365 6374 696f 6e5f 6e61 6d65 223e o_section_name"> │ │ │ +00221f90: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c <title>See Also< │ │ │ +00221fa0: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ +00221fb0: 613e 0a20 2020 2020 203c 6c69 6e6b 206c a>. <link l │ │ │ +00221fc0: 696e 6b65 6e64 3d22 666e 5f76 6972 7475 inkend="fn_virtu │ │ │ +00221fd0: 6f73 6f5f 696e 695f 7061 7468 223e 3c66 oso_ini_path"><f │ │ │ +00221fe0: 756e 6374 696f 6e3e 7669 7274 756f 736f unction>virtuoso │ │ │ +00221ff0: 5f69 6e69 5f70 6174 683c 2f66 756e 6374 _ini_path</funct │ │ │ +00222000: 696f 6e3e 3c2f 6c69 6e6b 3e20 2020 0a20 ion></link> . │ │ │ +00222010: 2020 2020 203c 6c69 6e6b 206c 696e 6b65 <link linke │ │ │ +00222020: 6e64 3d22 666e 5f63 6667 5f73 6563 7469 nd="fn_cfg_secti │ │ │ +00222030: 6f6e 5f63 6f75 6e74 223e 3c66 756e 6374 on_count"><funct │ │ │ +00222040: 696f 6e3e 6366 675f 7365 6374 696f 6e5f ion>cfg_section_ │ │ │ +00222050: 636f 756e 743c 2f66 756e 6374 696f 6e3e count</function> │ │ │ +00222060: 3c2f 6c69 6e6b 3e20 2020 0a20 2020 2020 </link> . │ │ │ +00222070: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 <link linkend=" │ │ │ +00222080: 666e 5f63 6667 5f69 7465 6d5f 636f 756e fn_cfg_item_coun │ │ │ +00222090: 7422 3e3c 6675 6e63 7469 6f6e 3e63 6667 t"><function>cfg │ │ │ +002220a0: 5f69 7465 6d5f 636f 756e 743c 2f66 756e _item_count</fun │ │ │ +002220b0: 6374 696f 6e3e 3c2f 6c69 6e6b 3e20 2020 ction></link> │ │ │ +002220c0: 0a20 2020 2020 203c 6c69 6e6b 206c 696e . <link lin │ │ │ +002220d0: 6b65 6e64 3d22 666e 5f63 6667 5f69 7465 kend="fn_cfg_ite │ │ │ +002220e0: 6d5f 6e61 6d65 223e 3c66 756e 6374 696f m_name"><functio │ │ │ +002220f0: 6e3e 6366 675f 6974 656d 5f6e 616d 653c n>cfg_item_name< │ │ │ +00222100: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +00222110: 3e20 2020 0a20 2020 2020 203c 6c69 6e6b > . <link │ │ │ +00222120: 206c 696e 6b65 6e64 3d22 666e 5f63 6667 linkend="fn_cfg │ │ │ +00222130: 5f69 7465 6d5f 7661 6c75 6522 3e3c 6675 _item_value"><fu │ │ │ +00222140: 6e63 7469 6f6e 3e63 6667 5f69 7465 6d5f nction>cfg_item_ │ │ │ +00222150: 7661 6c75 653c 2f66 756e 6374 696f 6e3e value</function> │ │ │ +00222160: 3c2f 6c69 6e6b 3e20 2020 0a20 2020 2020 </link> . │ │ │ +00222170: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 <link linkend=" │ │ │ +00222180: 666e 5f63 6667 5f77 7269 7465 223e 3c66 fn_cfg_write"><f │ │ │ +00222190: 756e 6374 696f 6e3e 6366 675f 7772 6974 unction>cfg_writ │ │ │ +002221a0: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e</function></li │ │ │ +002221b0: 6e6b 3e20 2020 0a20 2020 203c 2f70 6172 nk> . </par │ │ │ +002221c0: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +002221d0: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 .</refentry>.... │ │ │ +002221e0: 0000 2564 656d 6f2f 646f 6373 7263 2f66 ..%demo/docsrc/f │ │ │ +002221f0: 756e 6372 6566 2f73 6571 7565 6e63 655f uncref/sequence_ │ │ │ +00222200: 6e65 7874 2e78 6d6c df00 000d c93c 3f78 next.xml.....<?x │ │ │ +00222210: 6d6c 2076 6572 7369 6f6e 3d22 312e 3022 ml version="1.0" │ │ │ +00222220: 2065 6e63 6f64 696e 673d 2249 534f 2d38 encoding="ISO-8 │ │ │ +00222230: 3835 392d 3122 3f3e 0a3c 212d 2d0a 202d 859-1"?>.<!--. - │ │ │ +00222240: 2020 0a20 2d20 2054 6869 7320 6669 6c65 . - This file │ │ │ +00222250: 2069 7320 7061 7274 206f 6620 7468 6520 is part of the │ │ │ +00222260: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ +00222270: 6520 5669 7274 756f 736f 204f 7065 6e2d e Virtuoso Open- │ │ │ +00222280: 536f 7572 6365 2028 564f 5329 0a20 2d20 Source (VOS). - │ │ │ +00222290: 2070 726f 6a65 6374 2e0a 202d 2020 0a20 project.. - . │ │ │ +002222a0: 2d20 2043 6f70 7972 6967 6874 2028 4329 - Copyright (C) │ │ │ +002222b0: 2031 3939 382d 3230 3234 204f 7065 6e4c 1998-2024 OpenL │ │ │ +002222c0: 696e 6b20 536f 6674 7761 7265 0a20 2d20 ink Software. - │ │ │ +002222d0: 200a 202d 2020 5468 6973 2070 726f 6a65 . - This proje │ │ │ +002222e0: 6374 2069 7320 6672 6565 2073 6f66 7477 ct is free softw │ │ │ +002222f0: 6172 653b 2079 6f75 2063 616e 2072 6564 are; you can red │ │ │ +00222300: 6973 7472 6962 7574 6520 6974 2061 6e64 istribute it and │ │ │ +00222310: 2f6f 7220 6d6f 6469 6679 2069 740a 202d /or modify it. - │ │ │ +00222320: 2020 756e 6465 7220 7468 6520 7465 726d under the term │ │ │ +00222330: 7320 6f66 2074 6865 2047 4e55 2047 656e s of the GNU Gen │ │ │ +00222340: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ +00222350: 6e73 6520 6173 2070 7562 6c69 7368 6564 nse as published │ │ │ +00222360: 2062 7920 7468 650a 202d 2020 4672 6565 by the. - Free │ │ │ +00222370: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ +00222380: 7469 6f6e 3b20 6f6e 6c79 2076 6572 7369 tion; only versi │ │ │ +00222390: 6f6e 2032 206f 6620 7468 6520 4c69 6365 on 2 of the Lice │ │ │ +002223a0: 6e73 652c 2064 6174 6564 204a 756e 6520 nse, dated June │ │ │ +002223b0: 3139 3931 2e0a 202d 2020 0a20 2d20 2054 1991.. - . - T │ │ │ +002223c0: 6869 7320 7072 6f67 7261 6d20 6973 2064 his program is d │ │ │ +002223d0: 6973 7472 6962 7574 6564 2069 6e20 7468 istributed in th │ │ │ +002223e0: 6520 686f 7065 2074 6861 7420 6974 2077 e hope that it w │ │ │ +002223f0: 696c 6c20 6265 2075 7365 6675 6c2c 2062 ill be useful, b │ │ │ +00222400: 7574 0a20 2d20 2057 4954 484f 5554 2041 ut. - WITHOUT A │ │ │ +00222410: 4e59 2057 4152 5241 4e54 593b 2077 6974 NY WARRANTY; wit │ │ │ +00222420: 686f 7574 2065 7665 6e20 7468 6520 696d hout even the im │ │ │ +00222430: 706c 6965 6420 7761 7272 616e 7479 206f plied warranty o │ │ │ +00222440: 660a 202d 2020 4d45 5243 4841 4e54 4142 f. - MERCHANTAB │ │ │ +00222450: 494c 4954 5920 6f72 2046 4954 4e45 5353 ILITY or FITNESS │ │ │ +00222460: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ +00222470: 5220 5055 5250 4f53 452e 2053 6565 2074 R PURPOSE. See t │ │ │ +00222480: 6865 2047 4e55 0a20 2d20 2047 656e 6572 he GNU. - Gener │ │ │ +00222490: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ +002224a0: 6520 666f 7220 6d6f 7265 2064 6574 6169 e for more detai │ │ │ +002224b0: 6c73 2e0a 202d 2020 0a20 2d20 2059 6f75 ls.. - . - You │ │ │ +002224c0: 2073 686f 756c 6420 6861 7665 2072 6563 should have rec │ │ │ +002224d0: 6569 7665 6420 6120 636f 7079 206f 6620 eived a copy of │ │ │ +002224e0: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ +002224f0: 5075 626c 6963 204c 6963 656e 7365 2061 Public License a │ │ │ +00222500: 6c6f 6e67 0a20 2d20 2077 6974 6820 7468 long. - with th │ │ │ +00222510: 6973 2070 726f 6772 616d 3b20 6966 206e is program; if n │ │ │ +00222520: 6f74 2c20 7772 6974 6520 746f 2074 6865 ot, write to the │ │ │ +00222530: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ +00222540: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e2c oundation, Inc., │ │ │ +00222550: 0a20 2d20 2035 3120 4672 616e 6b6c 696e . - 51 Franklin │ │ │ +00222560: 2053 742c 2046 6966 7468 2046 6c6f 6f72 St, Fifth Floor │ │ │ +00222570: 2c20 426f 7374 6f6e 2c20 4d41 2030 3231 , Boston, MA 021 │ │ │ +00222580: 3130 2d31 3330 3120 5553 410a 202d 2020 10-1301 USA. - │ │ │ +00222590: 0a20 2d20 200a 2d2d 3e0a 3c72 6566 656e . - .-->.<refen │ │ │ +002225a0: 7472 7920 6964 3d22 666e 5f73 6571 7565 try id="fn_seque │ │ │ +002225b0: 6e63 655f 6e65 7874 223e 0a20 203c 7265 nce_next">. <re │ │ │ +002225c0: 666d 6574 613e 0a20 2020 203c 7265 6665 fmeta>. <refe │ │ │ +002225d0: 6e74 7279 7469 746c 653e 7365 7175 656e ntrytitle>sequen │ │ │ +002225e0: 6365 5f6e 6578 743c 2f72 6566 656e 7472 ce_next</refentr │ │ │ +002225f0: 7974 6974 6c65 3e0a 2020 2020 3c72 6566 ytitle>. <ref │ │ │ +00222600: 6d69 7363 696e 666f 3e73 716c 3c2f 7265 miscinfo>sql</re │ │ │ +00222610: 666d 6973 6369 6e66 6f3e 0a20 203c 2f72 fmiscinfo>. </r │ │ │ +00222620: 6566 6d65 7461 3e0a 2020 3c72 6566 6e61 efmeta>. <refna │ │ │ +00222630: 6d65 6469 763e 0a20 2020 203c 7265 666e mediv>. <refn │ │ │ +00222640: 616d 653e 7365 7175 656e 6365 5f6e 6578 ame>sequence_nex │ │ │ +00222650: 743c 2f72 6566 6e61 6d65 3e0a 2020 2020 t</refname>. │ │ │ +00222660: 3c72 6566 7075 7270 6f73 653e 5265 7475 <refpurpose>Retu │ │ │ +00222670: 726e 7320 7468 6520 6375 7272 656e 7420 rns the current │ │ │ +00222680: 7374 6174 6520 6f66 2074 6865 2073 7065 state of the spe │ │ │ +00222690: 6369 6669 6564 2073 6571 7565 6e63 6520 cified sequence │ │ │ +002226a0: 616e 6420 696e 6372 656d 656e 7473 2069 and increments i │ │ │ +002226b0: 7420 6279 206f 6e65 2e3c 2f72 6566 7075 t by one.</refpu │ │ │ +002226c0: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ +002226d0: 6d65 6469 763e 0a20 203c 7265 6673 796e mediv>. <refsyn │ │ │ +002226e0: 6f70 7369 7364 6976 3e0a 2020 2020 3c66 opsisdiv>. <f │ │ │ +002226f0: 756e 6373 796e 6f70 7369 7320 6964 3d22 uncsynopsis id=" │ │ │ +00222700: 6673 796e 5f73 6571 7565 6e63 655f 6e65 fsyn_sequence_ne │ │ │ +00222710: 7874 223e 0a20 2020 2020 203c 6675 6e63 xt">. <func │ │ │ +00222720: 7072 6f74 6f74 7970 6520 6964 3d22 6670 prototype id="fp │ │ │ +00222730: 726f 746f 5f73 6571 7565 6e63 655f 6e65 roto_sequence_ne │ │ │ +00222740: 7874 223e 0a20 2020 2020 2020 203c 6675 xt">. <fu │ │ │ +00222750: 6e63 6465 663e 696e 7465 6765 7220 3c66 ncdef>integer <f │ │ │ +00222760: 756e 6374 696f 6e3e 7365 7175 656e 6365 unction>sequence │ │ │ +00222770: 5f6e 6578 743c 2f66 756e 6374 696f 6e3e _next</function> │ │ │ +00222780: 3c2f 6675 6e63 6465 663e 0a09 3c70 6172 </funcdef>..<par │ │ │ +00222790: 616d 6465 663e 696e 203c 7061 7261 6d65 amdef>in <parame │ │ │ +002227a0: 7465 723e 6e61 6d65 3c2f 7061 7261 6d65 ter>name</parame │ │ │ +002227b0: 7465 723e 2076 6172 6368 6172 3c2f 7061 ter> varchar</pa │ │ │ +002227c0: 7261 6d64 6566 3e0a 093c 7061 7261 6d64 ramdef>..<paramd │ │ │ +002227d0: 6566 3e69 6e20 3c70 6172 616d 6574 6572 ef>in <parameter │ │ │ +002227e0: 3e69 6e63 7265 6d65 6e74 5f62 793c 2f70 >increment_by</p │ │ │ +002227f0: 6172 616d 6574 6572 3e20 696e 7465 6765 arameter> intege │ │ │ +00222800: 723c 2f70 6172 616d 6465 663e 0a20 2020 r</paramdef>. │ │ │ +00222810: 2020 203c 2f66 756e 6370 726f 746f 7479 </funcprototy │ │ │ +00222820: 7065 3e0a 2020 2020 3c2f 6675 6e63 7379 pe>. </funcsy │ │ │ +00222830: 6e6f 7073 6973 3e0a 2020 3c2f 7265 6673 nopsis>. </refs │ │ │ +00222840: 796e 6f70 7369 7364 6976 3e0a 2020 3c72 ynopsisdiv>. <r │ │ │ +00222850: 6566 7365 6374 3120 6964 3d22 6465 7363 efsect1 id="desc │ │ │ +00222860: 5f73 6571 7565 6e63 655f 6e65 7874 223e _sequence_next"> │ │ │ +00222870: 0a20 2020 203c 7469 746c 653e 4465 7363 . <title>Desc │ │ │ +00222880: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +00222890: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ +002228a0: 756e 6374 696f 6e20 7265 7475 726e 7320 unction returns │ │ │ +002228b0: 7468 6520 6375 7272 656e 7420 7374 6174 the current stat │ │ │ +002228c0: 6520 6f66 2074 6865 2073 7065 6369 6669 e of the specifi │ │ │ +002228d0: 6564 2073 6571 7565 6e63 6520 616e 640a ed sequence and. │ │ │ +002228e0: 6174 6f6d 6963 616c 6c79 2069 6e63 7265 atomically incre │ │ │ +002228f0: 6d65 6e74 7320 6974 2062 7920 6f6e 652e ments it by one. │ │ │ +00222900: 0a54 6865 206e 6578 7420 6361 6c6c 2077 .The next call w │ │ │ +00222910: 696c 6c20 7468 7573 2072 6574 7572 6e20 ill thus return │ │ │ +00222920: 6120 6e75 6d62 6572 206f 6e65 2067 7265 a number one gre │ │ │ +00222930: 6174 6572 2074 6861 6e20 7468 6520 7072 ater than the pr │ │ │ +00222940: 6576 696f 7573 2e0a 5468 6520 7365 7175 evious..The sequ │ │ │ +00222950: 656e 6365 2069 7320 7368 6172 6564 2062 ence is shared b │ │ │ +00222960: 6574 7765 656e 2061 6c6c 2063 6f6e 6e65 etween all conne │ │ │ +00222970: 6374 696f 6e73 2061 6e64 2061 6c6c 2074 ctions and all t │ │ │ +00222980: 7261 6e73 6163 7469 6f6e 7320 736f 2061 ransactions so a │ │ │ +00222990: 6e20 696e 6372 656d 656e 7420 7468 6174 n increment that │ │ │ +002229a0: 2069 7320 6973 206d 6164 6520 696e 206f is is made in o │ │ │ +002229b0: 6e65 206f 6620 636f 6e6e 6563 7469 6f6e ne of connection │ │ │ +002229c0: 2077 696c 6c0a 6265 2073 6565 6e20 696e will.be seen in │ │ │ +002229d0: 206f 7468 6572 2063 6f6e 6e65 6374 696f other connectio │ │ │ +002229e0: 6e20 696d 6d65 6469 6174 656c 792e 0a55 n immediately..U │ │ │ +002229f0: 7369 6e67 2061 2073 6571 7565 6e63 6520 sing a sequence │ │ │ +00222a00: 6e65 7665 7220 696e 766f 6c76 6573 206c never involves l │ │ │ +00222a10: 6f63 6b69 6e67 2e0a 3c2f 7061 7261 3e0a ocking... │ │ │ +00222a20: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ +00222a30: 3c72 6566 7365 6374 3120 6964 3d22 7061 . │ │ │ +00222a60: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ +00222a70: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ +00222a80: 3e3c 7469 746c 653e 6e61 6d65 3c2f 7469 ><title>name</ti │ │ │ +00222a90: 746c 653e 3c70 6172 613e 5468 6520 7365 tle><para>The se │ │ │ +00222aa0: 7276 6572 2d77 6964 6520 6e61 6d65 206f rver-wide name o │ │ │ +00222ab0: 6620 6120 7365 7175 656e 6365 2e3c 2f70 f a sequence.</p │ │ │ +00222ac0: 6172 613e 0a20 2020 203c 2f72 6566 7365 ara>. </refse │ │ │ +00222ad0: 6374 323e 0a20 2020 203c 7265 6673 6563 ct2>. <refsec │ │ │ +00222ae0: 7432 3e3c 7469 746c 653e 696e 6372 656d t2><title>increm │ │ │ +00222af0: 656e 745f 6279 3c2f 7469 746c 653e 3c70 ent_by

    .. This i │ │ │ +00222b10: 7320 746f 2073 7065 6369 6679 2068 6f77 s to specify how │ │ │ +00222b20: 206d 7563 6820 7769 6c6c 2062 6520 6164 much will be ad │ │ │ +00222b30: 6465 6420 746f 2074 6865 2073 6571 7565 ded to the seque │ │ │ +00222b40: 6e63 6520 286d 7573 7420 6265 2067 7265 nce (must be gre │ │ │ +00222b50: 6174 6572 2074 6861 6e20 7a65 726f 290a ater than zero). │ │ │ +00222b60: 0920 2020 2049 6620 6e6f 7420 7370 6563 . If not spec │ │ │ +00222b70: 6966 6965 6420 6465 6661 756c 7473 2074 ified defaults t │ │ │ +00222b80: 6f20 312e 0a09 3c2f 7061 7261 3e0a 2020 o 1.... │ │ │ +00222b90: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +00222ba0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . < │ │ │ +00222bd0: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ +00222be0: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ +00222bf0: 7061 7261 3e54 6865 2066 756e 6374 696f para>The functio │ │ │ +00222c00: 6e20 7265 7475 726e 7320 696e 7465 6765 n returns intege │ │ │ +00222c10: 723c 2f70 6172 613e 0a20 203c 2f72 6566 r. . . │ │ │ +00222c50: 2020 203c 7469 746c 653e 5365 6520 416c See Al │ │ │ +00222c60: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ +00222c70: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>Sequence Ob │ │ │ +00222ca0: 6a65 6374 733c 2f6c 696e 6b3e 3c2f 7061 jects. sequ │ │ │ +00222cf0: 656e 6365 5f67 6574 5f61 6c6c 3c2f 6675 ence_get_all. │ │ │ +00222d20: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 │ │ │ +00222d40: 3c66 756e 6374 696f 6e3e 7365 7175 656e sequen │ │ │ +00222d50: 6365 5f73 6574 3c2f 6675 6e63 7469 6f6e ce_set. │ │ │ +00222d70: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 sequence_ │ │ │ +00222db0: 7265 6d6f 7665 3c2f 6675 6e63 7469 6f6e remove. │ │ │ +00222dd0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 registry_get │ │ │ +00222e10: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    registry_get_a │ │ │ +00222e70: 6c6c 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ll. │ │ │ +00222e90: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b │ │ │ +00222ec0: 7265 6769 7374 7279 5f73 6574 3c2f 6675 registry_set. │ │ │ +00222ef0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 registry │ │ │ +00222f30: 5f6e 616d 655f 6973 5f70 726f 7465 6374 _name_is_protect │ │ │ +00222f40: 6564 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ed. │ │ │ +00222f60: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b registry_remo │ │ │ +00222fa0: 7665 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c ve. ....../demo/ │ │ │ +00222fe0: 646f 6373 7263 2f66 756e 6372 6566 2f75 docsrc/funcref/u │ │ │ +00222ff0: 6464 695f 6765 745f 6275 7369 6e65 7373 ddi_get_business │ │ │ +00223000: 4465 7461 696c 2e78 6d6c df00 000d 9f3c Detail.xml.....< │ │ │ +00223010: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +00223020: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +00223030: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . uddi_get_b │ │ │ +002233f0: 7573 696e 6573 7344 6574 6169 6c3c 2f72 usinessDetail. │ │ │ +00223410: 2020 3c72 6566 6d69 7363 696e 666f 3e75 u │ │ │ +00223420: 6464 693c 2f72 6566 6d69 7363 696e 666f ddi. . │ │ │ +00223440: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ +00223450: 2020 3c72 6566 6e61 6d65 3e75 6464 695f uddi_ │ │ │ +00223460: 6765 745f 6275 7369 6e65 7373 4465 7461 get_businessDeta │ │ │ +00223470: 696c 3c2f 7265 666e 616d 653e 0a20 2020 il. │ │ │ +00223480: 203c 7265 6670 7572 706f 7365 3e72 6574 ret │ │ │ +00223490: 7572 6e73 2063 6f6d 706c 6574 6520 3c70 urns complete

    busines │ │ │ +002234b0: 7345 6e74 6974 793c 2f70 6172 616d 6574 sEntity information │ │ │ +002234d0: 666f 7220 6f6e 6520 6f72 206d 6f72 6520 for one or more │ │ │ +002234e0: 7370 6563 6966 6965 6420 3c70 6172 616d specified businessEnt │ │ │ +00223500: 6974 6965 733c 2f70 6172 616d 6574 6572 ities. │ │ │ +00223520: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ +00223530: 203c 7265 6673 6563 7431 2069 643d 2273 < │ │ │ +00223560: 7469 746c 653e 5379 6e74 6178 3c2f 7469 title>Syntax. .<uddi_get_b │ │ │ +00223590: 7573 696e 6573 7344 6574 6169 6c0a 2020 usinessDetail. │ │ │ +002235a0: 6765 6e65 7269 633d 2231 2e30 220a 2020 generic="1.0". │ │ │ +002235b0: 786d 6c6e 733d 2275 726e 3a75 6464 692d xmlns="urn:uddi- │ │ │ +002235c0: 6f72 673a 6170 6922 2026 6774 3b0a 0926 org:api" >..& │ │ │ +002235d0: 6c74 3b62 7573 696e 6573 734b 6579 2f26 lt;businessKey/& │ │ │ +002235e0: 6774 3b0a 095b 2026 6c74 3b62 7573 696e gt;..[ <busin │ │ │ +002235f0: 6573 734b 6579 2f26 6774 3b20 2e2e 2e5d essKey/> ...] │ │ │ +00223600: 0a26 6c74 3b2f 7564 6469 5f67 6574 5f62 .</uddi_get_b │ │ │ +00223610: 7573 696e 6573 7344 6574 6169 6c26 6774 usinessDetail> │ │ │ +00223620: 3b0a 2020 3c2f 7363 7265 656e 3e3c 2f72 ;. . │ │ │ +00223670: 4174 7472 6962 7574 6573 2026 616d 703b Attributes & │ │ │ +00223680: 2043 6869 6c64 7265 6e3c 2f74 6974 6c65 Children. │ │ │ +002236a0: 3c74 6974 6c65 3e62 7573 696e 6573 734b businessK │ │ │ +002236b0: 6579 3c2f 7469 746c 653e 3c70 6172 613e ey │ │ │ +002236c0: 6f6e 6520 6f72 206d 6f72 6520 3c70 6172 one or more uuid_key< │ │ │ +002236e0: 2f70 6172 616d 6574 6572 3e20 7661 6c75 /parameter> valu │ │ │ +002236f0: 6573 2074 6861 7420 7265 7072 6573 656e es that represen │ │ │ +00223700: 7420 7370 6563 6966 6963 2069 6e73 7461 t specific insta │ │ │ +00223710: 6e63 6573 206f 660a 6b6e 6f77 6e20 3c70 nces of.known

    busines │ │ │ +00223730: 7345 6e74 6974 793c 2f70 6172 616d 6574 sEntity data. │ │ │ +00223750: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f . . Re │ │ │ +002237a0: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ +002237b0: 653e 0a20 2020 203c 7061 7261 3e0a 5468 e>. <para>.Th │ │ │ +002237c0: 6973 2066 756e 6374 696f 6e20 7265 7475 is function retu │ │ │ +002237d0: 726e 7320 6120 3c70 6172 616d 6574 6572 rns a <parameter │ │ │ +002237e0: 3e62 7573 696e 6573 7344 6574 6169 6c3c >businessDetail< │ │ │ +002237f0: 2f70 6172 616d 6574 6572 3e20 6d65 7373 /parameter> mess │ │ │ +00223800: 6167 6520 6f6e 2073 7563 6365 7373 6675 age on successfu │ │ │ +00223810: 6c0a 6d61 7463 6820 6f66 206f 6e65 206f l.match of one o │ │ │ +00223820: 7220 6d6f 7265 203c 7061 7261 6d65 7465 r more <paramete │ │ │ +00223830: 723e 6275 7369 6e65 7373 4b65 793c 2f70 r>businessKey</p │ │ │ +00223840: 6172 616d 6574 6572 3e20 2076 616c 7565 arameter> value │ │ │ +00223850: 732e 2020 4966 206d 756c 7469 706c 6520 s. If multiple │ │ │ +00223860: 3c70 6172 616d 6574 6572 3e62 7573 696e <parameter>busin │ │ │ +00223870: 6573 734b 6579 3c2f 7061 7261 6d65 7465 essKey</paramete │ │ │ +00223880: 723e 0a76 616c 7565 7320 7765 7265 2070 r>.values were p │ │ │ +00223890: 6173 7365 642c 2074 6865 2072 6573 756c assed, the resul │ │ │ +002238a0: 7473 2077 696c 6c20 6265 2072 6574 7572 ts will be retur │ │ │ +002238b0: 6e65 6420 696e 2074 6865 2073 616d 6520 ned in the same │ │ │ +002238c0: 6f72 6465 720a 6173 2074 6865 206b 6579 order.as the key │ │ │ +002238d0: 7320 7061 7373 6564 2e0a 2020 3c2f 7061 s passed.. </pa │ │ │ +002238e0: 7261 3e0a 2020 2020 3c70 6172 613e 0a49 ra>. <para>.I │ │ │ +002238f0: 6e20 7468 6520 6576 656e 7420 6f66 2061 n the event of a │ │ │ +00223900: 206c 6172 6765 206e 756d 6265 7220 6f66 large number of │ │ │ +00223910: 206d 6174 6368 6573 2c20 6120 7365 7276 matches, a serv │ │ │ +00223920: 6572 206d 6179 2074 7275 6e63 6174 6520 er may truncate │ │ │ +00223930: 7468 6520 7265 7375 6c74 0a73 6574 2e20 the result.set. │ │ │ +00223940: 2049 6620 7468 6973 206f 6363 7572 732c If this occurs, │ │ │ +00223950: 2074 6865 203c 7061 7261 6d65 7465 723e the <parameter> │ │ │ +00223960: 6275 7369 6e65 7373 4465 7461 696c 3c2f businessDetail</ │ │ │ +00223970: 7061 7261 6d65 7465 723e 2072 6573 706f parameter> respo │ │ │ +00223980: 6e73 650a 6d65 7373 6167 6520 7769 6c6c nse.message will │ │ │ +00223990: 2063 6f6e 7461 696e 2074 6865 203c 7061 contain the <pa │ │ │ +002239a0: 7261 6d65 7465 723e 7472 756e 6361 7465 rameter>truncate │ │ │ +002239b0: 643c 2f70 6172 616d 6574 6572 3e20 6174 d</parameter> at │ │ │ +002239c0: 7472 6962 7574 6520 7769 7468 2074 6865 tribute with the │ │ │ +002239d0: 2076 616c 7565 206f 6620 7468 6973 0a61 value of this.a │ │ │ +002239e0: 7474 7269 6275 7465 2073 6574 2074 6f20 ttribute set to │ │ │ +002239f0: 7472 7565 2e0a 2020 3c2f 7061 7261 3e0a true.. </para>. │ │ │ +00223a00: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ +00223a10: 3c72 6566 7365 6374 3120 6964 3d22 6572 <refsect1 id="er │ │ │ +00223a20: 726f 7273 5f75 6464 695f 6765 745f 6275 rors_uddi_get_bu │ │ │ +00223a30: 7369 6e65 7373 4465 7461 696c 223e 3c74 sinessDetail"><t │ │ │ +00223a40: 6974 6c65 3e45 7272 6f72 733c 2f74 6974 itle>Errors</tit │ │ │ +00223a50: 6c65 3e0a 2020 2020 3c70 6172 613e 0a49 le>. <para>.I │ │ │ +00223a60: 6620 616e 2065 7272 6f72 206f 6363 7572 f an error occur │ │ │ +00223a70: 7320 696e 2070 726f 6365 7373 696e 6720 s in processing │ │ │ +00223a80: 7468 6973 206d 6573 7361 6765 2c20 6120 this message, a │ │ │ +00223a90: 3c70 6172 616d 6574 6572 3e64 6973 706f <parameter>dispo │ │ │ +00223aa0: 7369 7469 6f6e 5265 706f 7274 3c2f 7061 sitionReport</pa │ │ │ +00223ab0: 7261 6d65 7465 723e 2073 7472 7563 7475 rameter> structu │ │ │ +00223ac0: 7265 0a77 696c 6c20 6265 2072 6574 7572 re.will be retur │ │ │ +00223ad0: 6e65 6420 746f 2074 6865 2020 6361 6c6c ned to the call │ │ │ +00223ae0: 6572 2069 6e20 6120 534f 4150 2046 6175 er in a SOAP Fau │ │ │ +00223af0: 6c74 2e20 2054 6865 2066 6f6c 6c6f 7769 lt. The followi │ │ │ +00223b00: 6e67 2065 7272 6f72 0a69 6e66 6f72 6d61 ng error.informa │ │ │ +00223b10: 7469 6f6e 2077 696c 6c20 6265 2072 656c tion will be rel │ │ │ +00223b20: 6576 616e 743a 0a20 203c 2f70 6172 613e evant:. </para> │ │ │ +00223b30: 0a20 2020 203c 7461 626c 653e 3c74 6974 . <table><tit │ │ │ +00223b40: 6c65 3e45 7272 6f72 7320 7369 676e 616c le>Errors signal │ │ │ +00223b50: 6c65 6420 6279 2075 6464 695f 6765 745f led by uddi_get_ │ │ │ +00223b60: 6275 7369 6e65 7373 4465 7461 696c 3c2f businessDetail</ │ │ │ +00223b70: 7469 746c 653e 0a20 2020 2020 203c 7467 title>. <tg │ │ │ +00223b80: 726f 7570 2063 6f6c 733d 2232 223e 0a20 roup cols="2">. │ │ │ +00223b90: 2020 2020 2020 3c74 6865 6164 3e3c 726f <thead><ro │ │ │ +00223ba0: 773e 3c65 6e74 7279 3e45 7272 6f72 2043 w><entry>Error C │ │ │ +00223bb0: 6f64 653c 2f65 6e74 7279 3e3c 656e 7472 ode</entry><entr │ │ │ +00223bc0: 793e 4465 7363 7269 7074 696f 6e3c 2f65 y>Description</e │ │ │ +00223bd0: 6e74 7279 3e3c 2f72 6f77 3e3c 2f74 6865 ntry></row></the │ │ │ +00223be0: 6164 3e0a 093c 7462 6f64 793e 0a09 2020 ad>..<tbody>.. │ │ │ +00223bf0: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 <row>.. <entr │ │ │ +00223c00: 793e 3c65 7272 6f72 636f 6465 3e45 5f69 y><errorcode>E_i │ │ │ +00223c10: 6e76 616c 6964 4b65 7950 6173 7365 643c nvalidKeyPassed< │ │ │ +00223c20: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode></ent │ │ │ +00223c30: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ +00223c40: 7369 676e 6966 6965 7320 7468 6174 206f signifies that o │ │ │ +00223c50: 6e65 206f 6620 7468 6520 3c70 6172 616d ne of the <param │ │ │ +00223c60: 6574 6572 3e75 7569 645f 6b65 793c 2f70 eter>uuid_key</p │ │ │ +00223c70: 6172 616d 6574 6572 3e20 7661 6c75 6573 arameter> values │ │ │ +00223c80: 2070 6173 7365 6420 6469 6420 6e6f 7420 passed did not │ │ │ +00223c90: 6d61 7463 6820 7769 7468 0a61 6e79 206b match with.any k │ │ │ +00223ca0: 6e6f 776e 203c 7061 7261 6d65 7465 723e nown <parameter> │ │ │ +00223cb0: 6275 7369 6e65 7373 4b65 793c 2f70 6172 businessKey</par │ │ │ +00223cc0: 616d 6574 6572 3e20 7661 6c75 6573 2e20 ameter> values. │ │ │ +00223cd0: 204e 6f20 7061 7274 6961 6c20 7265 7375 No partial resu │ │ │ +00223ce0: 6c74 7320 7769 6c6c 2062 6520 7265 7475 lts will be retu │ │ │ +00223cf0: 726e 6564 3b20 6966 0a61 6e79 203c 7061 rned; if.any <pa │ │ │ +00223d00: 7261 6d65 7465 723e 6275 7369 6e65 7373 rameter>business │ │ │ +00223d10: 4b65 793c 2f70 6172 616d 6574 6572 3e20 Key</parameter> │ │ │ +00223d20: 7661 6c75 6573 2070 6173 7365 6420 6172 values passed ar │ │ │ +00223d30: 6520 6e6f 7420 7661 6c69 642c 2074 6869 e not valid, thi │ │ │ +00223d40: 7320 6572 726f 7220 7769 6c6c 2062 6520 s error will be │ │ │ +00223d50: 7265 7475 726e 6564 2e3c 2f65 6e74 7279 returned.</entry │ │ │ +00223d60: 3e0a 0920 203c 2f72 6f77 3e0a 093c 2f74 >.. </row>..</t │ │ │ +00223d70: 626f 6479 3e0a 2020 2020 2020 3c2f 7467 body>. </tg │ │ │ +00223d80: 726f 7570 3e0a 2020 2020 3c2f 7461 626c roup>. </tabl │ │ │ +00223d90: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ +00223da0: 0a3c 2f72 6566 656e 7472 793e 0a0a b600 .</refentry>.... │ │ │ +00223db0: 0000 2664 656d 6f2f 646f 6373 7263 2f66 ..&demo/docsrc/f │ │ │ +00223dc0: 756e 6372 6566 2f6e 6d5f 6d69 6e5f 6e6f uncref/nm_min_no │ │ │ +00223dd0: 746e 756c 6c2e 786d 6cdf 0000 103b 3c3f tnull.xml....;<? │ │ │ +00223de0: 786d 6c20 7665 7273 696f 6e3d 2231 2e30 xml version="1.0 │ │ │ +00223df0: 2220 656e 636f 6469 6e67 3d22 4953 4f2d " encoding="ISO- │ │ │ +00223e00: 3838 3539 2d31 223f 3e0a 3c21 2d2d 0a20 8859-1"?>.<!--. │ │ │ +00223e10: 2d20 200a 202d 2020 5468 6973 2066 696c - . - This fil │ │ │ +00223e20: 6520 6973 2070 6172 7420 6f66 2074 6865 e is part of the │ │ │ +00223e30: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ +00223e40: 7265 2056 6972 7475 6f73 6f20 4f70 656e re Virtuoso Open │ │ │ +00223e50: 2d53 6f75 7263 6520 2856 4f53 290a 202d -Source (VOS). - │ │ │ +00223e60: 2020 7072 6f6a 6563 742e 0a20 2d20 200a project.. - . │ │ │ +00223e70: 202d 2020 436f 7079 7269 6768 7420 2843 - Copyright (C │ │ │ +00223e80: 2920 3139 3938 2d32 3032 3420 4f70 656e ) 1998-2024 Open │ │ │ +00223e90: 4c69 6e6b 2053 6f66 7477 6172 650a 202d Link Software. - │ │ │ +00223ea0: 2020 0a20 2d20 2054 6869 7320 7072 6f6a . - This proj │ │ │ +00223eb0: 6563 7420 6973 2066 7265 6520 736f 6674 ect is free soft │ │ │ +00223ec0: 7761 7265 3b20 796f 7520 6361 6e20 7265 ware; you can re │ │ │ +00223ed0: 6469 7374 7269 6275 7465 2069 7420 616e distribute it an │ │ │ +00223ee0: 642f 6f72 206d 6f64 6966 7920 6974 0a20 d/or modify it. │ │ │ +00223ef0: 2d20 2075 6e64 6572 2074 6865 2074 6572 - under the ter │ │ │ +00223f00: 6d73 206f 6620 7468 6520 474e 5520 4765 ms of the GNU Ge │ │ │ +00223f10: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ +00223f20: 656e 7365 2061 7320 7075 626c 6973 6865 ense as publishe │ │ │ +00223f30: 6420 6279 2074 6865 0a20 2d20 2046 7265 d by the. - Fre │ │ │ +00223f40: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ +00223f50: 6174 696f 6e3b 206f 6e6c 7920 7665 7273 ation; only vers │ │ │ +00223f60: 696f 6e20 3220 6f66 2074 6865 204c 6963 ion 2 of the Lic │ │ │ +00223f70: 656e 7365 2c20 6461 7465 6420 4a75 6e65 ense, dated June │ │ │ +00223f80: 2031 3939 312e 0a20 2d20 200a 202d 2020 1991.. - . - │ │ │ +00223f90: 5468 6973 2070 726f 6772 616d 2069 7320 This program is │ │ │ +00223fa0: 6469 7374 7269 6275 7465 6420 696e 2074 distributed in t │ │ │ +00223fb0: 6865 2068 6f70 6520 7468 6174 2069 7420 he hope that it │ │ │ +00223fc0: 7769 6c6c 2062 6520 7573 6566 756c 2c20 will be useful, │ │ │ +00223fd0: 6275 740a 202d 2020 5749 5448 4f55 5420 but. - WITHOUT │ │ │ +00223fe0: 414e 5920 5741 5252 414e 5459 3b20 7769 ANY WARRANTY; wi │ │ │ +00223ff0: 7468 6f75 7420 6576 656e 2074 6865 2069 thout even the i │ │ │ +00224000: 6d70 6c69 6564 2077 6172 7261 6e74 7920 mplied warranty │ │ │ +00224010: 6f66 0a20 2d20 204d 4552 4348 414e 5441 of. - MERCHANTA │ │ │ +00224020: 4249 4c49 5459 206f 7220 4649 544e 4553 BILITY or FITNES │ │ │ +00224030: 5320 464f 5220 4120 5041 5254 4943 554c S FOR A PARTICUL │ │ │ +00224040: 4152 2050 5552 504f 5345 2e20 5365 6520 AR PURPOSE. See │ │ │ +00224050: 7468 6520 474e 550a 202d 2020 4765 6e65 the GNU. - Gene │ │ │ +00224060: 7261 6c20 5075 626c 6963 204c 6963 656e ral Public Licen │ │ │ +00224070: 7365 2066 6f72 206d 6f72 6520 6465 7461 se for more deta │ │ │ +00224080: 696c 732e 0a20 2d20 200a 202d 2020 596f ils.. - . - Yo │ │ │ +00224090: 7520 7368 6f75 6c64 2068 6176 6520 7265 u should have re │ │ │ +002240a0: 6365 6976 6564 2061 2063 6f70 7920 6f66 ceived a copy of │ │ │ +002240b0: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ +002240c0: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ +002240d0: 616c 6f6e 670a 202d 2020 7769 7468 2074 along. - with t │ │ │ +002240e0: 6869 7320 7072 6f67 7261 6d3b 2069 6620 his program; if │ │ │ +002240f0: 6e6f 742c 2077 7269 7465 2074 6f20 7468 not, write to th │ │ │ +00224100: 6520 4672 6565 2053 6f66 7477 6172 6520 e Free Software │ │ │ +00224110: 466f 756e 6461 7469 6f6e 2c20 496e 632e Foundation, Inc. │ │ │ +00224120: 2c0a 202d 2020 3531 2046 7261 6e6b 6c69 ,. - 51 Frankli │ │ │ +00224130: 6e20 5374 2c20 4669 6674 6820 466c 6f6f n St, Fifth Floo │ │ │ +00224140: 722c 2042 6f73 746f 6e2c 204d 4120 3032 r, Boston, MA 02 │ │ │ +00224150: 3131 302d 3133 3031 2055 5341 0a20 2d20 110-1301 USA. - │ │ │ +00224160: 200a 202d 2020 0a2d 2d3e 0a3c 7265 6665 . - .-->.<refe │ │ │ +00224170: 6e74 7279 2069 643d 2266 6e5f 6e6d 5f6d ntry id="fn_nm_m │ │ │ +00224180: 696e 5f6e 6f74 6e75 6c6c 223e 0a20 203c in_notnull">. < │ │ │ +00224190: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. <re │ │ │ +002241a0: 6665 6e74 7279 7469 746c 653e 5f5f 6d69 fentrytitle>__mi │ │ │ +002241b0: 6e5f 6e6f 746e 756c 6c3c 2f72 6566 656e n_notnull</refen │ │ │ +002241c0: 7472 7974 6974 6c65 3e0a 2020 2020 3c72 trytitle>. <r │ │ │ +002241d0: 6566 6d69 7363 696e 666f 3e6e 756d 6265 efmiscinfo>numbe │ │ │ +002241e0: 723c 2f72 6566 6d69 7363 696e 666f 3e0a r</refmiscinfo>. │ │ │ +002241f0: 2020 3c2f 7265 666d 6574 613e 0a20 203c </refmeta>. < │ │ │ +00224200: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ +00224210: 3c72 6566 6e61 6d65 3e5f 5f6d 696e 5f6e <refname>__min_n │ │ │ +00224220: 6f74 6e75 6c6c 3c2f 7265 666e 616d 653e otnull</refname> │ │ │ +00224230: 0a20 2020 203c 7265 6670 7572 706f 7365 . <refpurpose │ │ │ +00224240: 3e52 6574 7572 6e73 206d 696e 696d 756d >Returns minimum │ │ │ +00224250: 2076 616c 7565 2061 6d6f 6e67 2061 6c6c value among all │ │ │ +00224260: 2069 7473 2061 7267 756d 656e 7473 2c20 its arguments, │ │ │ +00224270: 6967 6e6f 7269 6e67 204e 554c 4c73 2065 ignoring NULLs e │ │ │ +00224280: 6e74 6972 656c 792e 3c2f 7265 6670 7572 ntirely.</refpur │ │ │ +00224290: 706f 7365 3e0a 2020 3c2f 7265 666e 616d pose>. </refnam │ │ │ +002242a0: 6564 6976 3e0a 2020 3c72 6566 7379 6e6f ediv>. <refsyno │ │ │ +002242b0: 7073 6973 6469 763e 0a20 2020 203c 6675 psisdiv>. <fu │ │ │ +002242c0: 6e63 7379 6e6f 7073 6973 2069 643d 2266 ncsynopsis id="f │ │ │ +002242d0: 7379 6e5f 5f5f 6d69 6e5f 6e6f 746e 756c syn___min_notnul │ │ │ +002242e0: 6c22 3e0a 2020 2020 2020 3c66 756e 6370 l">. <funcp │ │ │ +002242f0: 726f 746f 7479 7065 2069 643d 2266 7072 rototype id="fpr │ │ │ +00224300: 6f74 6f5f 5f5f 6d69 6e5f 6e6f 746e 756c oto___min_notnul │ │ │ +00224310: 6c22 3e0a 2020 2020 2020 2020 3c66 756e l">. <fun │ │ │ +00224320: 6364 6566 3e61 6e79 203c 6675 6e63 7469 cdef>any <functi │ │ │ +00224330: 6f6e 3e5f 5f6d 696e 5f6e 6f74 6e75 6c6c on>__min_notnull │ │ │ +00224340: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e </function></fun │ │ │ +00224350: 6364 6566 3e0a 0920 2020 2020 2020 203c cdef>.. < │ │ │ +00224360: 7061 7261 6d64 6566 3e3c 7061 7261 6d65 paramdef><parame │ │ │ +00224370: 7465 723e 6172 6731 3c2f 7061 7261 6d65 ter>arg1</parame │ │ │ +00224380: 7465 723e 2061 6e79 3c2f 7061 7261 6d64 ter> any</paramd │ │ │ +00224390: 6566 3e0a 0920 2020 2020 2020 203c 7061 ef>.. <pa │ │ │ +002243a0: 7261 6d64 6566 3e3c 7061 7261 6d65 7465 ramdef><paramete │ │ │ +002243b0: 723e 6172 6732 3c2f 7061 7261 6d65 7465 r>arg2</paramete │ │ │ +002243c0: 723e 2061 6e79 3c2f 7061 7261 6d64 6566 r> any</paramdef │ │ │ +002243d0: 3e0a 0920 2020 2020 2020 203c 7061 7261 >.. <para │ │ │ +002243e0: 6d64 6566 3e3c 7061 7261 6d65 7465 723e mdef><parameter> │ │ │ +002243f0: 2e2e 2e3c 2f70 6172 616d 6574 6572 3e3c ...</parameter>< │ │ │ +00224400: 2f70 6172 616d 6465 663e 0a09 2020 2020 /paramdef>.. │ │ │ +00224410: 2020 2020 3c70 6172 616d 6465 663e 3c70 <paramdef><p │ │ │ +00224420: 6172 616d 6574 6572 3e61 7267 4e3c 2f70 arameter>argN</p │ │ │ +00224430: 6172 616d 6574 6572 3e20 616e 793c 2f70 arameter> any</p │ │ │ +00224440: 6172 616d 6465 663e 0a20 2020 2020 203c aramdef>. < │ │ │ +00224450: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ +00224460: 2020 2020 3c2f 6675 6e63 7379 6e6f 7073 </funcsynops │ │ │ +00224470: 6973 3e0a 2020 3c2f 7265 6673 796e 6f70 is>. </refsynop │ │ │ +00224480: 7369 7364 6976 3e0a 2020 3c72 6566 7365 sisdiv>. <refse │ │ │ +00224490: 6374 3120 6964 3d22 6465 7363 5f5f 5f6d ct1 id="desc___m │ │ │ +002244a0: 696e 5f6e 6f74 6e75 6c6c 223e 3c74 6974 in_notnull"><tit │ │ │ +002244b0: 6c65 3e44 6573 6372 6970 7469 6f6e 3c2f le>Description</ │ │ │ +002244c0: 7469 746c 653e 0a20 203c 7061 7261 3e54 title>. <para>T │ │ │ +002244d0: 6865 2066 756e 6374 696f 6e20 7265 7475 he function retu │ │ │ +002244e0: 726e 7320 7468 6520 6d69 6e69 6d75 6d20 rns the minimum │ │ │ +002244f0: 7661 6c75 6520 616d 6f6e 6720 616c 6c20 value among all │ │ │ +00224500: 7661 6c75 6573 2069 6e20 616c 6c20 6974 values in all it │ │ │ +00224510: 7320 6172 6775 6d65 6e74 7320 6279 200a s arguments by . │ │ │ +00224520: 2020 0969 676e 6f72 696e 6720 4e55 4c4c .ignoring NULL │ │ │ +00224530: 7320 656e 7469 7265 6c79 2e3c 2f70 6172 s entirely.</par │ │ │ +00224540: 613e 0a20 203c 2f72 6566 7365 6374 313e a>. </refsect1> │ │ │ +00224550: 090a 2020 3c72 6566 7365 6374 3120 6964 .. <refsect1 id │ │ │ +00224560: 3d22 7061 7261 6d73 5f5f 5f6d 696e 5f6e ="params___min_n │ │ │ +00224570: 6f74 6e75 6c6c 223e 3c74 6974 6c65 3e50 otnull"><title>P │ │ │ +00224580: 6172 616d 6574 6572 733c 2f74 6974 6c65 arameters. │ │ │ +002245a0: 3c74 6974 6c65 3e61 7267 493c 2f74 6974 argI</tit │ │ │ +002245b0: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +002245c0: 5661 6c75 6573 2077 6869 6368 2063 616e Values which can │ │ │ +002245d0: 2062 6520 7769 7468 2074 7970 6520 666c be with type fl │ │ │ +002245e0: 6f61 742c 2069 6e74 6567 6572 2065 7463 oat, integer etc │ │ │ +002245f0: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .</para></refsec │ │ │ +00224600: 7432 3e0a 2020 3c2f 7265 6673 6563 7431 t2>. </refsect1 │ │ │ +00224610: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ +00224620: 3d22 6578 616d 706c 6573 5f5f 5f6d 696e ="examples___min │ │ │ +00224630: 5f6e 6f74 6e75 6c6c 223e 3c74 6974 6c65 _notnull"><title │ │ │ +00224640: 3e45 7861 6d70 6c65 733c 2f74 6974 6c65 >Examples. </titl │ │ │ +00224680: 653e 0a3c 7061 7261 3e3c 656d 7068 6173 e>.<para><emphas │ │ │ +00224690: 6973 3e45 7861 6d70 6c65 2031 3c2f 656d is>Example 1</em │ │ │ +002246a0: 7068 6173 6973 3e3c 2f70 6172 613e 2020 phasis></para> │ │ │ +002246b0: 200a 2020 3c73 6372 6565 6e3e 3c21 5b43 . <screen><![C │ │ │ +002246c0: 4441 5441 5b0a 5351 4c3e 2073 656c 6563 DATA[.SQL> selec │ │ │ +002246d0: 7420 5f5f 6d69 6e5f 6e6f 746e 756c 6c20 t __min_notnull │ │ │ +002246e0: 286e 756c 6c2c 2031 2c20 3029 3b0a 5f5f (null, 1, 0);.__ │ │ │ +002246f0: 6d69 6e5f 6e6f 746e 756c 6c0a 5641 5243 min_notnull.VARC │ │ │ +00224700: 4841 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f HAR.____________ │ │ │ +00224710: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224720: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224730: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224740: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224750: 5f5f 5f0a 0a30 0a0a 3120 526f 7773 2e20 ___..0..1 Rows. │ │ │ +00224760: 2d2d 2030 206d 7365 632e 0a53 514c 3e20 -- 0 msec..SQL> │ │ │ +00224770: 7365 6c65 6374 205f 5f6d 696e 2028 6e75 select __min (nu │ │ │ +00224780: 6c6c 2c20 312c 2030 293b 0a5f 5f6d 696e ll, 1, 0);.__min │ │ │ +00224790: 0a56 4152 4348 4152 0a5f 5f5f 5f5f 5f5f .VARCHAR._______ │ │ │ +002247a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002247b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002247c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002247d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002247e0: 5f5f 5f5f 5f5f 5f5f 0a0a 4e55 4c4c 0a0a ________..NULL.. │ │ │ +002247f0: 3120 526f 7773 2e20 2d2d 2030 206d 7365 1 Rows. -- 0 mse │ │ │ +00224800: 632e 0a5d 5d3e 3c2f 7363 7265 656e 3e0a c..]]></screen>. │ │ │ +00224810: 3c70 6172 613e 3c65 6d70 6861 7369 733e <para><emphasis> │ │ │ +00224820: 4578 616d 706c 6520 323c 2f65 6d70 6861 Example 2</empha │ │ │ +00224830: 7369 733e 3c2f 7061 7261 3e0a 3c70 726f sis></para>.<pro │ │ │ +00224840: 6772 616d 6c69 7374 696e 673e 3c21 5b43 gramlisting><![C │ │ │ +00224850: 4441 5441 5b0a 5351 4c3e 2053 5041 5251 DATA[.SQL> SPARQ │ │ │ +00224860: 4c20 0a49 4e53 4552 5420 494e 544f 2047 L .INSERT INTO G │ │ │ +00224870: 5241 5048 203c 6874 7470 3a2f 2f6d 7967 RAPH <http://myg │ │ │ +00224880: 7261 7068 2e63 6f6d 3e0a 2020 7b20 0a20 raph.com>. { . │ │ │ +00224890: 2020 203c 6874 7470 3a2f 2f6d 7967 7261 <http://mygra │ │ │ +002248a0: 7068 322e 636f 6d2f 7072 6963 696e 672f ph2.com/pricing/ │ │ │ +002248b0: 2351 5661 6c31 3e20 3c70 7269 6365 313e #QVal1> <price1> │ │ │ +002248c0: 2020 3120 3b20 2020 2020 2020 2020 2020 1 ; │ │ │ +002248d0: 2020 2020 2020 2020 203c 7072 6963 6533 <price3 │ │ │ +002248e0: 3e20 3520 2e0a 2020 2020 3c68 7474 703a > 5 .. <http: │ │ │ +002248f0: 2f2f 6d79 6772 6170 6832 2e63 6f6d 2f70 //mygraph2.com/p │ │ │ +00224900: 7269 6369 6e67 2f23 5156 616c 323e 2020 ricing/#QVal2> │ │ │ +00224910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00224920: 3c70 7269 6365 323e 2031 203b 2020 2020 <price2> 1 ; │ │ │ +00224930: 3c70 7269 6365 333e 2034 202e 0a20 2020 <price3> 4 .. │ │ │ +00224940: 203c 6874 7470 3a2f 2f6d 7967 7261 7068 <http://mygraph │ │ │ +00224950: 322e 636f 6d2f 7072 6963 696e 672f 2351 2.com/pricing/#Q │ │ │ +00224960: 5661 6c33 3e20 3c70 7269 6365 313e 2020 Val3> <price1> │ │ │ +00224970: 3620 3b20 2020 203c 7072 6963 6532 3e20 6 ; <price2> │ │ │ +00224980: 3220 2020 2020 2020 2020 2020 2020 2020 2 │ │ │ +00224990: 2020 2e0a 2020 7d3b 0a20 2020 200a 496e .. };. .In │ │ │ +002249a0: 7365 7274 2069 6e74 6f20 3c68 7474 703a sert into <http: │ │ │ +002249b0: 2f2f 6d79 6772 6170 682e 636f 6d3e 2c20 //mygraph.com>, │ │ │ +002249c0: 3620 286f 7220 6c65 7373 2920 7472 6970 6 (or less) trip │ │ │ +002249d0: 6c65 7320 2d2d 2064 6f6e 650a 4e6f 2e20 les -- done.No. │ │ │ +002249e0: 6f66 2072 6f77 7320 696e 2072 6573 756c of rows in resul │ │ │ +002249f0: 743a 2031 0a20 090a 5351 4c3e 2053 5041 t: 1. ..SQL> SPA │ │ │ +00224a00: 5251 4c20 5345 4c45 4354 203f 732c 2028 RQL SELECT ?s, ( │ │ │ +00224a10: 6269 663a 5f5f 6d69 6e5f 6e6f 746e 756c bif:__min_notnul │ │ │ +00224a20: 6c20 283f 7072 312c 203f 7072 322c 203f l (?pr1, ?pr2, ? │ │ │ +00224a30: 7072 3329 2920 0a46 524f 4d20 3c68 7474 pr3)) .FROM <htt │ │ │ +00224a40: 703a 2f2f 6d79 6772 6170 682e 636f 6d3e p://mygraph.com> │ │ │ +00224a50: 0a57 4845 5245 200a 2020 7b0a 2020 2020 .WHERE . {. │ │ │ +00224a60: 7b20 0a20 2020 2020 2053 454c 4543 5420 { . SELECT │ │ │ +00224a70: 4449 5354 494e 4354 203f 730a 2020 2020 DISTINCT ?s. │ │ │ +00224a80: 2020 5748 4552 4520 0a20 2020 2020 2020 WHERE . │ │ │ +00224a90: 207b 0a20 2020 2020 2020 2020 203f 7320 {. ?s │ │ │ +00224aa0: 3f70 203f 7072 202e 0a20 2020 2020 2020 ?p ?pr .. │ │ │ +00224ab0: 2020 2046 494c 5445 5220 283f 7020 696e FILTER (?p in │ │ │ +00224ac0: 2028 3c70 7269 6365 313e 2c20 3c70 7269 (<price1>, <pri │ │ │ +00224ad0: 6365 323e 2c20 3c70 7269 6365 333e 2929 ce2>, <price3>)) │ │ │ +00224ae0: 200a 2020 2020 2020 2020 7d20 0a20 2020 . } . │ │ │ +00224af0: 207d 0a20 2020 204f 5054 494f 4e41 4c20 }. OPTIONAL │ │ │ +00224b00: 7b20 3f73 203c 7072 6963 6531 3e20 3f70 { ?s <price1> ?p │ │ │ +00224b10: 7231 207d 0a20 2020 204f 5054 494f 4e41 r1 }. OPTIONA │ │ │ +00224b20: 4c20 7b20 3f73 203c 7072 6963 6532 3e20 L { ?s <price2> │ │ │ +00224b30: 3f70 7232 207d 0a20 2020 204f 5054 494f ?pr2 }. OPTIO │ │ │ +00224b40: 4e41 4c20 7b20 3f73 203c 7072 6963 6533 NAL { ?s <price3 │ │ │ +00224b50: 3e20 3f70 7233 207d 0a20 207d 3b0a 2020 > ?pr3 }. };. │ │ │ +00224b60: 0a51 7565 7279 2072 6573 756c 743a 0a73 .Query result:.s │ │ │ +00224b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00224b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00224b90: 2020 2020 2063 616c 6c72 6574 2d31 0a56 callret-1.V │ │ │ +00224ba0: 4152 4348 4152 2009 2020 2020 2020 2020 ARCHAR . │ │ │ +00224bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ +00224bc0: 2020 2020 5641 5243 4841 520a 5f5f 5f5f VARCHAR.____ │ │ │ +00224bd0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224be0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00224bf0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a 6874 7470 ___________.http │ │ │ +00224c00: 3a2f 2f6d 7967 7261 7068 322e 636f 6d2f ://mygraph2.com/ │ │ │ +00224c10: 7072 6963 696e 672f 2351 5661 6c32 0920 pricing/#QVal2. │ │ │ +00224c20: 310a 6874 7470 3a2f 2f6d 7967 7261 7068 1.http://mygraph │ │ │ +00224c30: 322e 636f 6d2f 7072 6963 696e 672f 2351 2.com/pricing/#Q │ │ │ +00224c40: 5661 6c31 0920 310a 6874 7470 3a2f 2f6d Val1. 1.http://m │ │ │ +00224c50: 7967 7261 7068 322e 636f 6d2f 7072 6963 ygraph2.com/pric │ │ │ +00224c60: 696e 672f 2351 5661 6c33 0920 320a 0a4e ing/#QVal3. 2..N │ │ │ +00224c70: 6f2e 206f 6620 726f 7773 2069 6e20 7265 o. of rows in re │ │ │ +00224c80: 7375 6c74 3a20 3209 0a5d 5d3e 3c2f 7072 sult: 2..]]></pr │ │ │ +00224c90: 6f67 7261 6d6c 6973 7469 6e67 3e20 0a20 ogramlisting> . │ │ │ +00224ca0: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f </example>. </ │ │ │ +00224cb0: 7265 6673 6563 7431 3e0a 2020 2020 3c72 refsect1>. <r │ │ │ +00224cc0: 6566 7365 6374 3120 6964 3d22 7365 6561 efsect1 id="seea │ │ │ +00224cd0: 6c73 6f5f 5f5f 6d69 6e5f 6e6f 746e 756c lso___min_notnul │ │ │ +00224ce0: 6c22 3e0a 2020 2020 3c74 6974 6c65 3e53 l">. <title>S │ │ │ +00224cf0: 6565 2041 6c73 6f3c 2f74 6974 6c65 3e0a ee Also. │ │ │ +00224d00: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 __ │ │ │ +00224d30: 6d61 7828 293c 2f66 756e 6374 696f 6e3e max() │ │ │ +00224d40: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +00224d50: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c __m │ │ │ +00224d80: 696e 2829 3c2f 6675 6e63 7469 6f6e 3e3c in()< │ │ │ +00224d90: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00224da0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 __max_notnul │ │ │ +00224de0: 6c28 293c 2f66 756e 6374 696f 6e3e 3c2f l(). < │ │ │ +00224e00: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>........#de │ │ │ +00224e20: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ +00224e30: 662f 7370 6172 716c 5f65 7661 6c2e 786d f/sparql_eval.xm │ │ │ +00224e40: 6cdf 0000 1049 3c3f 786d 6c20 7665 7273 l....I.. │ │ │ +00225850: 203c 7265 6673 6563 7431 2069 643d 2265 . │ │ │ +00225880: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ +00225890: 0a20 2020 203c 6578 616d 706c 6520 6964 . Simple │ │ │ +002258c0: 5573 653c 2f74 6974 6c65 3e0a 2020 2020 Use. │ │ │ +002258d0: 2020 3c73 6372 6565 6e3e 3c21 5b43 4441 DB.DBA.S │ │ │ +002258f0: 5041 5251 4c5f 4556 414c 2827 5345 4c45 PARQL_EVAL('SELE │ │ │ +00225900: 4354 202a 2057 4845 5245 207b 3f73 203f CT * WHERE {?s ? │ │ │ +00225910: 7020 3f6f 7d27 2c27 6874 7470 3a2f 2f65 p ?o}','http://e │ │ │ +00225920: 7861 6d70 6c65 2f62 6f6f 6b53 746f 7265 xample/bookStore │ │ │ +00225930: 2720 2c31 3029 3b0a 7320 2020 2020 2020 ' ,10);.s │ │ │ +00225940: 2020 2020 2020 2020 2020 2020 2020 7020 p │ │ │ +00225950: 2020 2020 2020 2020 2020 2020 206f 0a56 o.V │ │ │ +00225960: 4152 4348 4152 2020 2020 2020 2020 2020 ARCHAR │ │ │ +00225970: 2020 2020 2056 4152 4348 4152 2020 2020 VARCHAR │ │ │ +00225980: 2020 2020 5641 5243 4841 520a 5f5f 5f5f VARCHAR.____ │ │ │ +00225990: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002259a0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002259b0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002259c0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +002259d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a 0a68 7474 ___________..htt │ │ │ +002259e0: 703a 2f2f 6578 616d 706c 652f 626f 6f6b p://example/book │ │ │ +002259f0: 3320 2068 7474 703a 2f2f 7075 726c 2e6f 3 http://purl.o │ │ │ +00225a00: 7267 2f64 632f 656c 656d 656e 7473 2f31 rg/dc/elements/1 │ │ │ +00225a10: 2e31 2f74 6974 6c65 2020 4675 6e64 616d .1/title Fundam │ │ │ +00225a20: 656e 7461 6c73 0a68 7474 703a 2f2f 6578 entals.http://ex │ │ │ +00225a30: 616d 706c 652f 626f 6f6b 3320 2068 7474 ample/book3 htt │ │ │ +00225a40: 703a 2f2f 7075 726c 2e6f 7267 2f64 632f p://purl.org/dc/ │ │ │ +00225a50: 656c 656d 656e 7473 2f31 2e31 2f64 6174 elements/1.1/dat │ │ │ +00225a60: 6520 2020 3230 3032 2d30 312d 3031 5430 e 2002-01-01T0 │ │ │ +00225a70: 303a 3030 3a30 300a 6874 7470 3a2f 2f65 0:00:00.http://e │ │ │ +00225a80: 7861 6d70 6c65 2f62 6f6f 6b32 2020 6874 xample/book2 ht │ │ │ +00225a90: 7470 3a2f 2f70 7572 6c2e 6f72 672f 6463 tp://purl.org/dc │ │ │ +00225aa0: 2f65 6c65 6d65 6e74 732f 312e 312f 7469 /elements/1.1/ti │ │ │ +00225ab0: 746c 6520 2044 6573 6967 6e20 6e6f 7465 tle Design note │ │ │ +00225ac0: 730a 6874 7470 3a2f 2f65 7861 6d70 6c65 s.http://example │ │ │ +00225ad0: 2f62 6f6f 6b32 2020 6874 7470 3a2f 2f70 /book2 http://p │ │ │ +00225ae0: 7572 6c2e 6f72 672f 6463 2f65 6c65 6d65 url.org/dc/eleme │ │ │ +00225af0: 6e74 732f 312e 312f 6461 7465 2020 2032 nts/1.1/date 2 │ │ │ +00225b00: 3030 312d 3031 2d30 3154 3030 3a30 303a 001-01-01T00:00: │ │ │ +00225b10: 3030 0a0a 3420 526f 7773 2e20 2d2d 2033 00..4 Rows. -- 3 │ │ │ +00225b20: 3020 6d73 6563 2e0a 5d5d 3e3c 2f73 6372 0 msec..]]>. . . . See Also. DB │ │ │ +00225bd0: 2e44 4241 2e52 4446 5f41 5544 4954 5f4d .DBA.RDF_AUDIT_M │ │ │ +00225be0: 4554 4144 4154 413c 2f66 756e 6374 696f ETADATA │ │ │ +00225c00: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . DB.D │ │ │ +00225c40: 4241 2e52 4446 5f42 4143 4b55 505f 4d45 BA.RDF_BACKUP_ME │ │ │ +00225c50: 5441 4441 5441 3c2f 6675 6e63 7469 6f6e TADATA. │ │ │ +00225c70: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 │ │ │ +00225ca0: 3c66 756e 6374 696f 6e3e 4442 2e44 4241 DB.DBA │ │ │ +00225cb0: 2e52 4446 5f4c 4f41 445f 5244 4658 4d4c .RDF_LOAD_RDFXML │ │ │ +00225cc0: 5f4d 543c 2f66 756e 6374 696f 6e3e 3c2f _MT. │ │ │ +00225ce0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ +00225d00: 6675 6e63 7469 6f6e 3e44 422e 4442 412e function>DB.DBA. │ │ │ +00225d10: 5454 4c50 3c2f 6675 6e63 7469 6f6e 3e3c TTLP< │ │ │ +00225d20: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ +00225d30: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 DB. │ │ │ +00225d60: 4442 412e 5454 4c50 5f4d 543c 2f66 756e DBA.TTLP_MT

    . < │ │ │ +00225d90: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00225da0: 5f72 6466 5f74 7269 706c 6573 5f74 6f5f _rdf_triples_to_ │ │ │ +00225db0: 7264 665f 786d 6c5f 7465 7874 223e 3c66 rdf_xml_text">DB.DBA.R │ │ │ +00225dd0: 4446 5f54 5249 504c 4553 5f54 4f5f 5244 DF_TRIPLES_TO_RD │ │ │ +00225de0: 465f 584d 4c5f 5445 5854 3c2f 6675 6e63 F_XML_TEXT. │ │ │ +00225e40: 4442 2e44 4241 2e53 5041 5251 4c5f 4556 DB.DBA.SPARQL_EV │ │ │ +00225e50: 414c 5f54 4f5f 4152 5241 593c 2f66 756e AL_TO_ARRAY

    . ... │ │ │ +00225e90: 0000 0030 6465 6d6f 2f64 6f63 7372 632f ...0demo/docsrc/ │ │ │ +00225ea0: 6675 6e63 7265 662f 5245 504c 5f43 5245 funcref/REPL_CRE │ │ │ +00225eb0: 4154 455f 534e 4150 5348 4f54 5f50 5542 ATE_SNAPSHOT_PUB │ │ │ +00225ec0: 2e78 6d6c df00 0010 163c 3f78 6d6c 2076 .xml........ . │ │ │ +00226290: 2020 3c72 6566 656e 7472 7974 6974 6c65 REPL_CREATE_SNA │ │ │ +002262b0: 5053 484f 545f 5055 423c 2f72 6566 656e PSHOT_PUB. repl< │ │ │ +002262e0: 2f72 6566 6d69 7363 696e 666f 3e0a 2020 /refmiscinfo>. │ │ │ +002262f0: 3c2f 7265 666d 6574 613e 0a20 203c 7265 . . REPL_CREA │ │ │ +00226320: 5445 5f53 4e41 5053 484f 545f 5055 423c TE_SNAPSHOT_PUB< │ │ │ +00226330: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Create │ │ │ +00226350: 2062 692d 6469 7265 6374 696f 6e61 6c20 bi-directional │ │ │ +00226360: 736e 6170 7368 6f74 2070 7562 6c69 6361 snapshot publica │ │ │ +00226370: 7469 6f6e 3c2f 7265 6670 7572 706f 7365 tion. . . . │ │ │ +002263e0: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . None REPL_CREAT │ │ │ +00226440: 455f 534e 4150 5348 4f54 5f50 5542 3c2f E_SNAPSHOT_PUB. in item varchar. │ │ │ +002264b0: 3c70 6172 616d 6465 663e 696e 203c 7061 in type integer │ │ │ +002264e0: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 . │ │ │ +002264f0: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . . < │ │ │ +00226560: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ +00226570: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    This procedu │ │ │ +00226590: 7265 2073 686f 756c 6420 6265 2075 7365 re should be use │ │ │ +002265a0: 6420 746f 2063 7265 6174 6520 6120 6269 d to create a bi │ │ │ +002265b0: 2d64 6972 6563 7469 6f6e 616c 2073 6e61 -directional sna │ │ │ +002265c0: 7073 686f 7420 7075 626c 6963 6174 696f pshot publicatio │ │ │ +002265d0: 6e2e 2020 0a49 6620 7468 6520 3c70 6172 n. .If the item paramete │ │ │ +00226600: 7220 6973 2061 2074 6162 6c65 2074 6865 r is a table the │ │ │ +00226610: 6e20 7468 6973 2070 726f 6365 6475 7265 n this procedure │ │ │ +00226620: 2063 7265 6174 6573 200a 616e 2075 7064 creates .an upd │ │ │ +00226630: 6174 6561 626c 6520 736e 6170 7368 6f74 ateable snapshot │ │ │ +00226640: 206c 6f67 2061 6e64 2067 656e 6572 6174 log and generat │ │ │ +00226650: 6573 2061 6e20 7570 6461 7469 6e67 2070 es an updating p │ │ │ +00226660: 726f 6365 6475 7265 2e3c 2f70 6172 613e rocedure. │ │ │ +00226670: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ +00226680: 203c 7265 6673 6563 7431 2069 643d 2270 │ │ │ +002266b0: 3c74 6974 6c65 3e50 6172 616d 6574 6572 Parameter │ │ │ +002266c0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c72 s. i │ │ │ +002266e0: 7465 6d3c 2f74 6974 6c65 3e0a 2020 2020 tem. │ │ │ +002266f0: 2020 3c70 6172 613e 4974 656d 2069 7320 Item is │ │ │ +00226700: 6120 4441 5620 636f 6c6c 6563 7469 6f6e a DAV collection │ │ │ +00226710: 206f 7220 7461 626c 6520 6e61 6d65 2e3c or table name.< │ │ │ +00226720: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ +00226740: 3c74 6974 6c65 3e74 7970 653c 2f74 6974 type</tit │ │ │ +00226750: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +00226760: 5479 7065 2069 7320 7573 6564 2074 6f20 Type is used to │ │ │ +00226770: 6465 6e6f 7465 2074 6865 2074 7970 6520 denote the type │ │ │ +00226780: 6f66 2049 7465 6d3a 2031 2069 6620 6974 of Item: 1 if it │ │ │ +00226790: 656d 2069 7320 6120 4441 5620 636f 6c6c em is a DAV coll │ │ │ +002267a0: 6563 7469 6f6e 2c20 6f72 2032 2069 6620 ection, or 2 if │ │ │ +002267b0: 6974 656d 2069 7320 6120 7461 626c 6520 item is a table │ │ │ +002267c0: 6e61 6d65 2e3c 2f70 6172 613e 3c2f 7265 name.</para></re │ │ │ +002267d0: 6673 6563 7432 3e0a 2020 3c2f 7265 6673 fsect2>. </refs │ │ │ +002267e0: 6563 7431 3e0a 2020 3c72 6566 7365 6374 ect1>. <refsect │ │ │ +002267f0: 3120 6964 3d22 7265 745f 5245 504c 5f43 1 id="ret_REPL_C │ │ │ +00226800: 5245 4154 455f 534e 4150 5348 4f54 5f50 REATE_SNAPSHOT_P │ │ │ +00226810: 5542 223e 3c74 6974 6c65 3e52 6574 7572 UB"><title>Retur │ │ │ +00226820: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ +00226830: 2020 2020 3c70 6172 613e 4e6f 6e65 2e3c None.< │ │ │ +00226840: 2f70 6172 613e 0a0a 2020 3c2f 7265 6673 /para>.. .. . < │ │ │ +00226950: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. Crea │ │ │ +002269a0: 7469 6e67 2062 692d 6469 7265 6374 696f ting bi-directio │ │ │ +002269b0: 6e61 6c20 736e 6170 7368 6f74 2070 7562 nal snapshot pub │ │ │ +002269c0: 6c69 6361 7469 6f6e 3c2f 7469 746c 653e lication │ │ │ +002269d0: 0a20 2020 2020 203c 7061 7261 3e54 6865 . The │ │ │ +002269e0: 2066 6f6c 6c6f 7769 6e67 2073 7461 7465 following state │ │ │ +002269f0: 6d65 6e74 2063 7265 6174 6573 2062 692d ment creates bi- │ │ │ +00226a00: 6469 7265 6374 696f 6e61 6c20 736e 6170 directional snap │ │ │ +00226a10: 7368 6f74 2070 7562 6c69 6361 7469 6f6e shot publication │ │ │ +00226a20: 0a20 2020 2020 206f 6620 7461 626c 6520 . of table │ │ │ +00226a30: 2744 656d 6f2e 6465 6d6f 2e53 6869 7070 'Demo.demo.Shipp │ │ │ +00226a40: 6572 7327 3a3c 2f70 6172 613e 0a20 2020 ers':. │ │ │ +00226a50: 2020 203c 7363 7265 656e 3e0a 5351 4c3e .SQL> │ │ │ +00226a60: 2044 422e 4442 412e 5245 504c 5f43 5245 DB.DBA.REPL_CRE │ │ │ +00226a70: 4154 455f 534e 4150 5348 4f54 5f50 5542 ATE_SNAPSHOT_PUB │ │ │ +00226a80: 2028 2744 656d 6f2e 6465 6d6f 2e53 6869 ('Demo.demo.Shi │ │ │ +00226a90: 7070 6572 7327 2c20 3229 3b0a 2020 2020 ppers', 2);. │ │ │ +00226aa0: 2020 3c2f 7363 7265 656e 3e0a 2020 2020 . │ │ │ +00226ab0: 2020 3c70 6172 613e 5468 6520 666f 6c6c The foll │ │ │ +00226ac0: 6f77 696e 6720 7374 6174 656d 656e 7420 owing statement │ │ │ +00226ad0: 6372 6561 7465 7320 6269 2d64 6972 6563 creates bi-direc │ │ │ +00226ae0: 7469 6f6e 616c 2073 6e61 7073 686f 7420 tional snapshot │ │ │ +00226af0: 7075 626c 6963 6174 696f 6e0a 2020 2020 publication. │ │ │ +00226b00: 2020 6f66 2044 4156 2063 6f6c 6c65 6374 of DAV collect │ │ │ +00226b10: 696f 6e20 272f 4441 562f 646f 6327 3a3c ion '/DAV/doc':< │ │ │ +00226b20: 2f70 6172 613e 0a20 2020 2020 203c 7363 /para>. .SQL> DB.DB │ │ │ +00226b40: 412e 5245 504c 5f43 5245 4154 455f 534e A.REPL_CREATE_SN │ │ │ +00226b50: 4150 5348 4f54 5f50 5542 2028 272f 4441 APSHOT_PUB ('/DA │ │ │ +00226b60: 562f 646f 6327 2c20 3129 3b0a 2020 2020 V/doc', 1);. │ │ │ +00226b70: 2020 3c2f 7363 7265 656e 3e0a 2020 2020 . │ │ │ +00226b80: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . . │ │ │ +00226bd0: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ +00226be0: 2f74 6974 6c65 3e0a 093c 7061 7261 3e3c /title>..<para>< │ │ │ +00226bf0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00226c00: 5f52 4550 4c5f 4352 4541 5445 5f53 4e41 _REPL_CREATE_SNA │ │ │ +00226c10: 5053 484f 545f 5355 4222 3e3c 6675 6e63 PSHOT_SUB"><func │ │ │ +00226c20: 7469 6f6e 3e52 4550 4c5f 4352 4541 5445 tion>REPL_CREATE │ │ │ +00226c30: 5f53 4e41 5053 484f 545f 5355 4228 293c _SNAPSHOT_SUB()< │ │ │ +00226c40: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function></link │ │ │ +00226c50: 3e3c 2f70 6172 613e 0a09 3c70 6172 613e ></para>..<para> │ │ │ +00226c60: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 <link linkend="f │ │ │ +00226c70: 6e5f 5245 504c 5f44 524f 505f 534e 4150 n_REPL_DROP_SNAP │ │ │ +00226c80: 5348 4f54 5f53 5542 223e 3c66 756e 6374 SHOT_SUB"><funct │ │ │ +00226c90: 696f 6e3e 5245 504c 5f44 524f 505f 534e ion>REPL_DROP_SN │ │ │ +00226ca0: 4150 5348 4f54 5f53 5542 2829 3c2f 6675 APSHOT_SUB()</fu │ │ │ +00226cb0: 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f nction></link></ │ │ │ +00226cc0: 7061 7261 3e0a 093c 7061 7261 3e3c 6c69 para>..<para><li │ │ │ +00226cd0: 6e6b 206c 696e 6b65 6e64 3d22 666e 5f52 nk linkend="fn_R │ │ │ +00226ce0: 4550 4c5f 4452 4f50 5f53 4e41 5053 484f EPL_DROP_SNAPSHO │ │ │ +00226cf0: 545f 5055 4222 3e3c 6675 6e63 7469 6f6e T_PUB"><function │ │ │ +00226d00: 3e52 4550 4c5f 4452 4f50 5f53 4e41 5053 >REPL_DROP_SNAPS │ │ │ +00226d10: 484f 545f 5055 4228 293c 2f66 756e 6374 HOT_PUB()</funct │ │ │ +00226d20: 696f 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 ion></link></par │ │ │ +00226d30: 613e 0a09 3c70 6172 613e 3c6c 696e 6b20 a>..<para><link │ │ │ +00226d40: 6c69 6e6b 656e 643d 2266 6e5f 5245 504c linkend="fn_REPL │ │ │ +00226d50: 5f49 4e49 545f 534e 4150 5348 4f54 223e _INIT_SNAPSHOT"> │ │ │ +00226d60: 3c66 756e 6374 696f 6e3e 5245 504c 5f49 <function>REPL_I │ │ │ +00226d70: 4e49 545f 534e 4150 5348 4f54 2829 3c2f NIT_SNAPSHOT()</ │ │ │ +00226d80: 6675 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e function></link> │ │ │ +00226d90: 3c2f 7061 7261 3e0a 093c 7061 7261 3e3c </para>..<para>< │ │ │ +00226da0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ +00226db0: 5f52 4550 4c5f 5550 4441 5445 5f53 4e41 _REPL_UPDATE_SNA │ │ │ +00226dc0: 5053 484f 5422 3e3c 6675 6e63 7469 6f6e PSHOT"><function │ │ │ +00226dd0: 3e52 4550 4c5f 5550 4441 5445 5f53 4e41 >REPL_UPDATE_SNA │ │ │ +00226de0: 5053 484f 5428 293c 2f66 756e 6374 696f PSHOT()</functio │ │ │ +00226df0: 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 613e n></link></para> │ │ │ +00226e00: 0a09 3c70 6172 613e 3c6c 696e 6b20 6c69 ..<para><link li │ │ │ +00226e10: 6e6b 656e 643d 2266 6e5f 5245 504c 5f53 nkend="fn_REPL_S │ │ │ +00226e20: 4e50 5f53 4552 5645 5222 3e3c 6675 6e63 NP_SERVER"><func │ │ │ +00226e30: 7469 6f6e 3e52 4550 4c5f 534e 505f 5345 tion>REPL_SNP_SE │ │ │ +00226e40: 5256 4552 2829 3c2f 6675 6e63 7469 6f6e RVER()</function │ │ │ +00226e50: 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a ></link></para>. │ │ │ +00226e60: 093c 7061 7261 3e3c 6c69 6e6b 206c 696e .<para><link lin │ │ │ +00226e70: 6b65 6e64 3d22 666e 5f52 4550 4c5f 5345 kend="fn_REPL_SE │ │ │ +00226e80: 5256 4552 5f4e 414d 4522 3e3c 6675 6e63 RVER_NAME"><func │ │ │ +00226e90: 7469 6f6e 3e52 4550 4c5f 5345 5256 4552 tion>REPL_SERVER │ │ │ +00226ea0: 5f4e 414d 4528 293c 2f66 756e 6374 696f _NAME()</functio │ │ │ +00226eb0: 6e3e 3c2f 6c69 6e6b 3e3c 2f70 6172 613e n></link></para> │ │ │ +00226ec0: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . </refsect1>.< │ │ │ +00226ed0: 2f72 6566 656e 7472 793e 0a20 2020 0ab6 /refentry>. .. │ │ │ +00226ee0: 0000 002c 6465 6d6f 2f64 6f63 7372 632f ...,demo/docsrc/ │ │ │ +00226ef0: 6675 6e63 7265 662f 616e 6e5f 7068 7261 funcref/ann_phra │ │ │ +00226f00: 7365 5f63 6c61 7373 5f61 6464 2e78 6d6c se_class_add.xml │ │ │ +00226f10: df00 0011 503c 3f78 6d6c 2076 6572 7369 ....P<?xml versi │ │ │ +00226f20: 6f6e 3d22 312e 3022 2065 6e63 6f64 696e on="1.0" encodin │ │ │ +00226f30: 673d 2249 534f 2d38 3835 392d 3122 3f3e g="ISO-8859-1"?> │ │ │ +00226f40: 0a3c 212d 2d0a 202d 0a20 2d20 2054 6869 .<!--. -. - Thi │ │ │ +00226f50: 7320 6669 6c65 2069 7320 7061 7274 206f s file is part o │ │ │ +00226f60: 6620 7468 6520 4f70 656e 4c69 6e6b 2053 f the OpenLink S │ │ │ +00226f70: 6f66 7477 6172 6520 5669 7274 756f 736f oftware Virtuoso │ │ │ +00226f80: 204f 7065 6e2d 536f 7572 6365 2028 564f Open-Source (VO │ │ │ +00226f90: 5329 0a20 2d20 2070 726f 6a65 6374 2e0a S). - project.. │ │ │ +00226fa0: 202d 0a20 2d20 2043 6f70 7972 6967 6874 -. - Copyright │ │ │ +00226fb0: 2028 4329 2031 3939 382d 3230 3234 204f (C) 1998-2024 O │ │ │ +00226fc0: 7065 6e4c 696e 6b20 536f 6674 7761 7265 penLink Software │ │ │ +00226fd0: 0a20 2d0a 202d 2020 5468 6973 2070 726f . -. - This pro │ │ │ +00226fe0: 6a65 6374 2069 7320 6672 6565 2073 6f66 ject is free sof │ │ │ +00226ff0: 7477 6172 653b 2079 6f75 2063 616e 2072 tware; you can r │ │ │ +00227000: 6564 6973 7472 6962 7574 6520 6974 2061 edistribute it a │ │ │ +00227010: 6e64 2f6f 7220 6d6f 6469 6679 2069 740a nd/or modify it. │ │ │ +00227020: 202d 2020 756e 6465 7220 7468 6520 7465 - under the te │ │ │ +00227030: 726d 7320 6f66 2074 6865 2047 4e55 2047 rms of the GNU G │ │ │ +00227040: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ +00227050: 6365 6e73 6520 6173 2070 7562 6c69 7368 cense as publish │ │ │ +00227060: 6564 2062 7920 7468 650a 202d 2020 4672 ed by the. - Fr │ │ │ +00227070: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ +00227080: 6461 7469 6f6e 3b20 6f6e 6c79 2076 6572 dation; only ver │ │ │ +00227090: 7369 6f6e 2032 206f 6620 7468 6520 4c69 sion 2 of the Li │ │ │ +002270a0: 6365 6e73 652c 2064 6174 6564 204a 756e cense, dated Jun │ │ │ +002270b0: 6520 3139 3931 2e0a 202d 0a20 2d20 2054 e 1991.. -. - T │ │ │ +002270c0: 6869 7320 7072 6f67 7261 6d20 6973 2064 his program is d │ │ │ +002270d0: 6973 7472 6962 7574 6564 2069 6e20 7468 istributed in th │ │ │ +002270e0: 6520 686f 7065 2074 6861 7420 6974 2077 e hope that it w │ │ │ +002270f0: 696c 6c20 6265 2075 7365 6675 6c2c 2062 ill be useful, b │ │ │ +00227100: 7574 0a20 2d20 2057 4954 484f 5554 2041 ut. - WITHOUT A │ │ │ +00227110: 4e59 2057 4152 5241 4e54 593b 2077 6974 NY WARRANTY; wit │ │ │ +00227120: 686f 7574 2065 7665 6e20 7468 6520 696d hout even the im │ │ │ +00227130: 706c 6965 6420 7761 7272 616e 7479 206f plied warranty o │ │ │ +00227140: 660a 202d 2020 4d45 5243 4841 4e54 4142 f. - MERCHANTAB │ │ │ +00227150: 494c 4954 5920 6f72 2046 4954 4e45 5353 ILITY or FITNESS │ │ │ +00227160: 2046 4f52 2041 2050 4152 5449 4355 4c41 FOR A PARTICULA │ │ │ +00227170: 5220 5055 5250 4f53 452e 2053 6565 2074 R PURPOSE. See t │ │ │ +00227180: 6865 2047 4e55 0a20 2d20 2047 656e 6572 he GNU. - Gener │ │ │ +00227190: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ +002271a0: 6520 666f 7220 6d6f 7265 2064 6574 6169 e for more detai │ │ │ +002271b0: 6c73 2e0a 202d 0a20 2d20 2059 6f75 2073 ls.. -. - You s │ │ │ +002271c0: 686f 756c 6420 6861 7665 2072 6563 6569 hould have recei │ │ │ +002271d0: 7665 6420 6120 636f 7079 206f 6620 7468 ved a copy of th │ │ │ +002271e0: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ +002271f0: 626c 6963 204c 6963 656e 7365 2061 6c6f blic License alo │ │ │ +00227200: 6e67 0a20 2d20 2077 6974 6820 7468 6973 ng. - with this │ │ │ +00227210: 2070 726f 6772 616d 3b20 6966 206e 6f74 program; if not │ │ │ +00227220: 2c20 7772 6974 6520 746f 2074 6865 2046 , write to the F │ │ │ +00227230: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ +00227240: 6e64 6174 696f 6e2c 2049 6e63 2e2c 0a20 ndation, Inc.,. │ │ │ +00227250: 2d20 2035 3120 4672 616e 6b6c 696e 2053 - 51 Franklin S │ │ │ +00227260: 742c 2046 6966 7468 2046 6c6f 6f72 2c20 t, Fifth Floor, │ │ │ +00227270: 426f 7374 6f6e 2c20 4d41 2030 3231 3130 Boston, MA 02110 │ │ │ +00227280: 2d31 3330 3120 5553 410a 202d 0a2d 2d3e -1301 USA. -.--> │ │ │ +00227290: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .<refentry id="f │ │ │ +002272a0: 6e5f 616e 6e5f 7068 7261 7365 5f63 6c61 n_ann_phrase_cla │ │ │ +002272b0: 7373 5f61 6464 223e 0a20 203c 7265 666d ss_add">. <refm │ │ │ +002272c0: 6574 613e 0a20 2020 203c 7265 6665 6e74 eta>. <refent │ │ │ +002272d0: 7279 7469 746c 653e 4442 2e44 4241 2e41 rytitle>DB.DBA.A │ │ │ +002272e0: 4e4e 5f50 4852 4153 455f 434c 4153 535f NN_PHRASE_CLASS_ │ │ │ +002272f0: 4144 443c 2f72 6566 656e 7472 7974 6974 ADD</refentrytit │ │ │ +00227300: 6c65 3e0a 2020 2020 3c72 6566 6d69 7363 le>. <refmisc │ │ │ +00227310: 696e 666f 3e70 6872 7a3c 2f72 6566 6d69 info>phrz</refmi │ │ │ +00227320: 7363 696e 666f 3e0a 2020 3c2f 7265 666d scinfo>. </refm │ │ │ +00227330: 6574 613e 0a20 203c 7265 666e 616d 6564 eta>. <refnamed │ │ │ +00227340: 6976 3e0a 2020 2020 3c72 6566 6e61 6d65 iv>. <refname │ │ │ +00227350: 3e44 422e 4442 412e 414e 4e5f 5048 5241 >DB.DBA.ANN_PHRA │ │ │ +00227360: 5345 5f43 4c41 5353 5f41 4444 3c2f 7265 SE_CLASS_ADD</re │ │ │ +00227370: 666e 616d 653e 0a20 2020 203c 7265 6670 fname>. <refp │ │ │ +00227380: 7572 706f 7365 3e52 6574 7572 6e73 2041 urpose>Returns A │ │ │ +00227390: 5043 5f49 4420 6f66 2061 2070 6872 6173 PC_ID of a phras │ │ │ +002273a0: 6520 636c 6173 732e 3c2f 7265 6670 7572 e class.</refpur │ │ │ +002273b0: 706f 7365 3e0a 2020 3c2f 7265 666e 616d pose>. </refnam │ │ │ +002273c0: 6564 6976 3e0a 2020 3c72 6566 7379 6e6f ediv>. <refsyno │ │ │ +002273d0: 7073 6973 6469 763e 0a20 2020 203c 6675 psisdiv>. <fu │ │ │ +002273e0: 6e63 7379 6e6f 7073 6973 2069 643d 2266 ncsynopsis id="f │ │ │ +002273f0: 7379 6e5f 616e 6e5f 7068 7261 7365 5f63 syn_ann_phrase_c │ │ │ +00227400: 6c61 7373 5f61 6464 223e 0a20 2020 2020 lass_add">. │ │ │ +00227410: 203c 6675 6e63 7072 6f74 6f74 7970 6520 <funcprototype │ │ │ +00227420: 6964 3d22 6670 726f 746f 5f61 6e6e 5f70 id="fproto_ann_p │ │ │ +00227430: 6872 6173 655f 636c 6173 735f 6164 6422 hrase_class_add" │ │ │ +00227440: 3e0a 2020 2020 2020 2020 3c66 756e 6364 >. <funcd │ │ │ +00227450: 6566 3e3c 6675 6e63 7469 6f6e 3e44 422e ef><function>DB. │ │ │ +00227460: 4442 412e 414e 4e5f 5048 5241 5345 5f43 DBA.ANN_PHRASE_C │ │ │ +00227470: 4c41 5353 5f41 4444 3c2f 6675 6e63 7469 LASS_ADD</functi │ │ │ +00227480: 6f6e 3e3c 2f66 756e 6364 6566 3e0a 093c on></funcdef>..< │ │ │ +00227490: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in <par │ │ │ +002274a0: 616d 6574 6572 3e5f 6e61 6d65 3c2f 7061 ameter>_name</pa │ │ │ +002274b0: 7261 6d65 7465 723e 2076 6172 6368 6172 rameter> varchar │ │ │ +002274c0: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 </paramdef>..<pa │ │ │ +002274d0: 7261 6d64 6566 3e69 6e20 3c70 6172 616d ramdef>in <param │ │ │ +002274e0: 6574 6572 3e5f 6f77 6e65 725f 7569 643c eter>_owner_uid< │ │ │ +002274f0: 2f70 6172 616d 6574 6572 3e20 696e 7465 /parameter> inte │ │ │ +00227500: 6765 723c 2f70 6172 616d 6465 663e 0a09 ger</paramdef>.. │ │ │ +00227510: 3c70 6172 616d 6465 663e 696e 203c 7061 <paramdef>in <pa │ │ │ +00227520: 7261 6d65 7465 723e 5f72 6561 6465 725f rameter>_reader_ │ │ │ +00227530: 6769 643c 2f70 6172 616d 6574 6572 3e20 gid</parameter> │ │ │ +00227540: 696e 7465 6765 723c 2f70 6172 616d 6465 integer</paramde │ │ │ +00227550: 663e 0a20 2020 2020 2020 203c 7061 7261 f>. <para │ │ │ +00227560: 6d64 6566 3e69 6e20 3c70 6172 616d 6574 mdef>in <paramet │ │ │ +00227570: 6572 3e5f 6361 6c6c 6261 636b 3c2f 7061 er>_callback</pa │ │ │ +00227580: 7261 6d65 7465 723e 2076 6172 6368 6172 rameter> varchar │ │ │ +00227590: 3c2f 7061 7261 6d64 6566 3e0a 2020 2020 </paramdef>. │ │ │ +002275a0: 2020 2020 3c70 6172 616d 6465 663e 696e <paramdef>in │ │ │ +002275b0: 203c 7061 7261 6d65 7465 723e 5f61 7070 <parameter>_app │ │ │ +002275c0: 5f65 6e76 3c2f 7061 7261 6d65 7465 723e _env</parameter> │ │ │ +002275d0: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any</paramdef>. │ │ │ +002275e0: 2020 2020 2020 2020 3c70 6172 616d 6465 <paramde │ │ │ +002275f0: 663e 696e 203c 7061 7261 6d65 7465 723e f>in <parameter> │ │ │ +00227600: 6d6f 6465 3c2f 7061 7261 6d65 7465 723e mode</parameter> │ │ │ +00227610: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar</paramd │ │ │ +00227620: 6566 3e0a 2020 2020 2020 2020 3c70 6172 ef>. <par │ │ │ +00227630: 616d 6465 663e 696e 203c 7061 7261 6d65 amdef>in <parame │ │ │ +00227640: 7465 723e 6175 7468 5f75 6e61 6d65 3c2f ter>auth_uname</ │ │ │ +00227650: 7061 7261 6d65 7465 723e 2076 6172 6368 parameter> varch │ │ │ +00227660: 6172 3c2f 7061 7261 6d64 6566 3e0a 2020 ar</paramdef>. │ │ │ +00227670: 2020 2020 2020 3c70 6172 616d 6465 663e <paramdef> │ │ │ +00227680: 696e 203c 7061 7261 6d65 7465 723e 6175 in <parameter>au │ │ │ +00227690: 7468 5f70 7764 3c2f 7061 7261 6d65 7465 th_pwd</paramete │ │ │ +002276a0: 723e 2076 6172 6368 6172 3c2f 7061 7261 r> varchar</para │ │ │ +002276b0: 6d64 6566 3e0a 2020 2020 2020 3c2f 6675 mdef>. </fu │ │ │ +002276c0: 6e63 7072 6f74 6f74 7970 653e 0a20 2020 ncprototype>. │ │ │ +002276d0: 203c 2f66 756e 6373 796e 6f70 7369 733e </funcsynopsis> │ │ │ +002276e0: 0a20 203c 2f72 6566 7379 6e6f 7073 6973 . </refsynopsis │ │ │ +002276f0: 6469 763e 0a20 203c 7265 6673 6563 7431 div>. <refsect1 │ │ │ +00227700: 2069 643d 2264 6573 635f 616e 6e5f 7068 id="desc_ann_ph │ │ │ +00227710: 7261 7365 5f63 6c61 7373 5f61 6464 223e rase_class_add"> │ │ │ +00227720: 0a20 2020 203c 7469 746c 653e 4465 7363 . <title>Desc │ │ │ +00227730: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ +00227740: 2020 2020 3c70 6172 613e 5468 6520 7265 The re │ │ │ +00227750: 7475 726e 6564 2076 616c 7565 2069 7320 turned value is │ │ │ +00227760: 4150 435f 4944 206f 6620 6120 636c 6173 APC_ID of a clas │ │ │ +00227770: 7320 6966 2070 6f73 6974 6976 6520 6f72 s if positive or │ │ │ +00227780: 2061 6e20 6572 726f 7220 636f 6465 2069 an error code i │ │ │ +00227790: 6620 6e65 6761 7469 7665 2e0a 546f 2075 f negative..To u │ │ │ +002277a0: 7064 6174 6520 7068 7261 7365 2063 6c61 pdate phrase cla │ │ │ +002277b0: 7373 2c20 6e6f 2073 7065 6369 616c 2044 ss, no special D │ │ │ +002277c0: 422e 4442 412e 414e 4e5f 5048 5241 5345 B.DBA.ANN_PHRASE │ │ │ +002277d0: 5f43 4c41 5353 5f55 5044 4154 4528 2920 _CLASS_UPDATE() │ │ │ +002277e0: 6578 6973 7473 2c20 7573 6520 4442 2e44 exists, use DB.D │ │ │ +002277f0: 4241 2e41 4e4e 5f50 4852 4153 455f 434c BA.ANN_PHRASE_CL │ │ │ +00227800: 4153 535f 4144 4428 290a 7769 7468 2070 ASS_ADD().with p │ │ │ +00227810: 6172 616d 6574 6572 2022 6d6f 6465 2220 arameter "mode" │ │ │ +00227820: 6571 7561 6c20 746f 2027 7265 706c 6163 equal to 'replac │ │ │ +00227830: 696e 6727 2e3c 2f70 6172 613e 0a20 203c ing'.. < │ │ │ +00227840: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. . Parameters. _nam │ │ │ +002278b0: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ +002278c0: 3c70 6172 613e 6120 6e61 6d65 206f 6620 a name of │ │ │ +002278d0: 6e65 7720 7068 7261 7365 2063 6c61 7373 new phrase class │ │ │ +002278e0: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . _ow │ │ │ +00227910: 6e65 725f 7569 643c 2f74 6974 6c65 3e0a ner_uid. │ │ │ +00227920: 2020 2020 2020 3c70 6172 613e 6f77 6e65 owne │ │ │ +00227930: 7220 5549 442c 2077 696c 6c20 6265 2073 r UID, will be s │ │ │ +00227940: 746f 7265 6420 6173 2041 5043 5f4f 574e tored as APC_OWN │ │ │ +00227950: 4552 5f55 4944 2c20 6361 6e20 6265 204e ER_UID, can be N │ │ │ +00227960: 554c 4c20 666f 7220 7075 626c 6963 3c2f ULL for public. . _read │ │ │ +002279a0: 6572 5f67 6964 3c2f 7469 746c 653e 0a20 er_gid. │ │ │ +002279b0: 2020 2020 203c 7061 7261 3e72 6561 6465 reade │ │ │ +002279c0: 7220 4749 442c 2077 696c 6c20 6265 2073 r GID, will be s │ │ │ +002279d0: 746f 7265 6420 6173 2041 5043 5f52 4541 tored as APC_REA │ │ │ +002279e0: 4445 525f 4749 442c 2063 616e 2062 6520 DER_GID, can be │ │ │ +002279f0: 4e55 4c4c 2066 6f72 2070 7562 6c69 633c NULL for public< │ │ │ +00227a00: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . _cal │ │ │ +00227a30: 6c62 6163 6b3c 2f74 6974 6c65 3e0a 2020 lback. │ │ │ +00227a40: 2020 2020 3c70 6172 613e 7661 6c75 6520 value │ │ │ +00227a50: 666f 7220 4150 435f 4341 4c4c 4241 434b for APC_CALLBACK │ │ │ +00227a60: 2066 6965 6c64 3c2f 7061 7261 3e0a 2020 field. │ │ │ +00227a70: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +00227a80: 2020 3c72 6566 7365 6374 323e 3c74 6974 _app_env. │ │ │ +00227ab0: 7661 6c75 6520 666f 7220 4150 435f 4150 value for APC_AP │ │ │ +00227ac0: 505f 454e 5620 6669 656c 643c 2f70 6172 P_ENV field. . mode</ti │ │ │ +00227b00: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ +00227b10: 3e49 6e73 7472 7563 7473 2077 6861 7420 >Instructs what │ │ │ +00227b20: 746f 2064 6f20 6f6e 2061 7474 656d 7074 to do on attempt │ │ │ +00227b30: 206f 6620 7772 6974 696e 6720 6f76 6572 of writing over │ │ │ +00227b40: 2065 7869 7374 696e 6720 636c 6173 733a existing class: │ │ │ +00227b50: 2027 696e 746f 2720 7769 6c6c 2073 6967 'into' will sig │ │ │ +00227b60: 6e61 6c2c 0a27 736f 6674 2720 7265 7475 nal,.'soft' retu │ │ │ +00227b70: 726e 2041 5043 5f49 4420 6f66 2028 756e rn APC_ID of (un │ │ │ +00227b80: 6368 616e 6765 6429 2065 7869 7374 696e changed) existin │ │ │ +00227b90: 6720 636c 6173 732c 2027 7265 706c 6163 g class, 'replac │ │ │ +00227ba0: 696e 6727 2077 696c 6c20 636f 6e74 696e ing' will contin │ │ │ +00227bb0: 7565 2077 6974 6820 7570 6461 7465 2e3c ue with update.< │ │ │ +00227bc0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. </ref │ │ │ +00227bd0: 7365 6374 323e 0a20 2020 203c 7265 6673 sect2>. <refs │ │ │ +00227be0: 6563 7432 3e3c 7469 746c 653e 6175 7468 ect2><title>auth │ │ │ +00227bf0: 5f75 6e61 6d65 3c2f 7469 746c 653e 0a20 _uname. │ │ │ +00227c00: 2020 2020 203c 7061 7261 3e41 7574 6865 Authe │ │ │ +00227c10: 6e74 6963 6174 696f 6e20 6e61 6d65 3c2f ntication name. . auth_ │ │ │ +00227c50: 7077 643c 2f74 6974 6c65 3e0a 2020 2020 pwd. │ │ │ +00227c60: 2020 3c70 6172 613e 4175 7468 656e 7469 Authenti │ │ │ +00227c70: 6361 7469 6f6e 2070 6173 7377 6f72 643c cation password< │ │ │ +00227c80: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . . . │ │ │ +00227ce0: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ +00227cf0: 0a20 2020 203c 6578 616d 706c 6520 6964 . .select │ │ │ +00227d40: 2041 4e4e 5f50 4852 4153 455f 434c 4153 ANN_PHRASE_CLAS │ │ │ +00227d50: 535f 4144 4420 2827 4d79 2063 6865 636b S_ADD ('My check │ │ │ +00227d60: 272c 206e 756c 6c2c 206e 756c 6c2c 206e ', null, null, n │ │ │ +00227d70: 756c 6c2c 2027 4d79 2063 6865 636b 2076 ull, 'My check v │ │ │ +00227d80: 6973 6127 2c20 2727 2c20 2764 6261 272c isa', '', 'dba', │ │ │ +00227d90: 2027 6462 6127 293b 0a63 616c 6c72 6574 'dba');.callret │ │ │ +00227da0: 0a49 4e54 4547 4552 0a5f 5f5f 5f5f 5f5f .INTEGER._______ │ │ │ +00227db0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ 00227dc0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ 00227dd0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ 00227de0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00227df0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00227e00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 0a0a ______________.. │ │ │ -00227e10: 300a 0a31 2052 6f77 732e 202d 2d20 3120 0..1 Rows. -- 1 │ │ │ -00227e20: 6d73 6563 2e0a 0a5d 5d3e 0a3c 2f73 6372 msec...]]>.. . . . │ │ │ -00227e80: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ -00227e90: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -00227ea0: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ -00227eb0: 2266 6e5f 7865 6e63 5f6b 6579 5f72 656d "fn_xenc_key_rem │ │ │ -00227ec0: 6f76 6522 3e3c 6675 6e63 7469 6f6e 3e78 ove"><function>x │ │ │ -00227ed0: 656e 635f 6b65 795f 7265 6d6f 7665 2829 enc_key_remove() │ │ │ -00227ee0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e </function></lin │ │ │ -00227ef0: 6b3e 3c2f 7061 7261 3e0a 2020 3c2f 7265 k></para>. </re │ │ │ -00227f00: 6673 6563 7431 3e0a 3c2f 7265 6665 6e74 fsect1>.</refent │ │ │ -00227f10: 7279 3e0a b600 0000 2b64 656d 6f2f 646f ry>.....+demo/do │ │ │ -00227f20: 6373 7263 2f66 756e 6372 6566 2f78 656e csrc/funcref/xen │ │ │ -00227f30: 635f 6b65 795f 6473 615f 6372 6561 7465 c_key_dsa_create │ │ │ -00227f40: 2e78 6d6c df00 000c f33c 3f78 6d6c 2076 .xml.....<?xml v │ │ │ -00227f50: 6572 7369 6f6e 3d22 312e 3022 2065 6e63 ersion="1.0" enc │ │ │ -00227f60: 6f64 696e 673d 2249 534f 2d38 3835 392d oding="ISO-8859- │ │ │ -00227f70: 3122 3f3e 0a3c 212d 2d0a 202d 2020 0a20 1"?>.<!--. - . │ │ │ -00227f80: 2d20 2054 6869 7320 6669 6c65 2069 7320 - This file is │ │ │ -00227f90: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ -00227fa0: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ -00227fb0: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ -00227fc0: 6365 2028 564f 5329 0a20 2d20 2070 726f ce (VOS). - pro │ │ │ -00227fd0: 6a65 6374 2e0a 202d 2020 0a20 2d20 2043 ject.. - . - C │ │ │ -00227fe0: 6f70 7972 6967 6874 2028 4329 2031 3939 opyright (C) 199 │ │ │ -00227ff0: 382d 3230 3234 204f 7065 6e4c 696e 6b20 8-2024 OpenLink │ │ │ -00228000: 536f 6674 7761 7265 0a20 2d20 200a 202d Software. - . - │ │ │ -00228010: 2020 5468 6973 2070 726f 6a65 6374 2069 This project i │ │ │ -00228020: 7320 6672 6565 2073 6f66 7477 6172 653b s free software; │ │ │ -00228030: 2079 6f75 2063 616e 2072 6564 6973 7472 you can redistr │ │ │ -00228040: 6962 7574 6520 6974 2061 6e64 2f6f 7220 ibute it and/or │ │ │ -00228050: 6d6f 6469 6679 2069 740a 202d 2020 756e modify it. - un │ │ │ -00228060: 6465 7220 7468 6520 7465 726d 7320 6f66 der the terms of │ │ │ -00228070: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ -00228080: 2050 7562 6c69 6320 4c69 6365 6e73 6520 Public License │ │ │ -00228090: 6173 2070 7562 6c69 7368 6564 2062 7920 as published by │ │ │ -002280a0: 7468 650a 202d 2020 4672 6565 2053 6f66 the. - Free Sof │ │ │ -002280b0: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ -002280c0: 3b20 6f6e 6c79 2076 6572 7369 6f6e 2032 ; only version 2 │ │ │ -002280d0: 206f 6620 7468 6520 4c69 6365 6e73 652c of the License, │ │ │ -002280e0: 2064 6174 6564 204a 756e 6520 3139 3931 dated June 1991 │ │ │ -002280f0: 2e0a 202d 2020 0a20 2d20 2054 6869 7320 .. - . - This │ │ │ -00228100: 7072 6f67 7261 6d20 6973 2064 6973 7472 program is distr │ │ │ -00228110: 6962 7574 6564 2069 6e20 7468 6520 686f ibuted in the ho │ │ │ -00228120: 7065 2074 6861 7420 6974 2077 696c 6c20 pe that it will │ │ │ -00228130: 6265 2075 7365 6675 6c2c 2062 7574 0a20 be useful, but. │ │ │ -00228140: 2d20 2057 4954 484f 5554 2041 4e59 2057 - WITHOUT ANY W │ │ │ -00228150: 4152 5241 4e54 593b 2077 6974 686f 7574 ARRANTY; without │ │ │ -00228160: 2065 7665 6e20 7468 6520 696d 706c 6965 even the implie │ │ │ -00228170: 6420 7761 7272 616e 7479 206f 660a 202d d warranty of. - │ │ │ -00228180: 2020 4d45 5243 4841 4e54 4142 494c 4954 MERCHANTABILIT │ │ │ -00228190: 5920 6f72 2046 4954 4e45 5353 2046 4f52 Y or FITNESS FOR │ │ │ -002281a0: 2041 2050 4152 5449 4355 4c41 5220 5055 A PARTICULAR PU │ │ │ -002281b0: 5250 4f53 452e 2053 6565 2074 6865 2047 RPOSE. See the G │ │ │ -002281c0: 4e55 0a20 2d20 2047 656e 6572 616c 2050 NU. - General P │ │ │ -002281d0: 7562 6c69 6320 4c69 6365 6e73 6520 666f ublic License fo │ │ │ -002281e0: 7220 6d6f 7265 2064 6574 6169 6c73 2e0a r more details.. │ │ │ -002281f0: 202d 2020 0a20 2d20 2059 6f75 2073 686f - . - You sho │ │ │ -00228200: 756c 6420 6861 7665 2072 6563 6569 7665 uld have receive │ │ │ -00228210: 6420 6120 636f 7079 206f 6620 7468 6520 d a copy of the │ │ │ -00228220: 474e 5520 4765 6e65 7261 6c20 5075 626c GNU General Publ │ │ │ -00228230: 6963 204c 6963 656e 7365 2061 6c6f 6e67 ic License along │ │ │ -00228240: 0a20 2d20 2077 6974 6820 7468 6973 2070 . - with this p │ │ │ -00228250: 726f 6772 616d 3b20 6966 206e 6f74 2c20 rogram; if not, │ │ │ -00228260: 7772 6974 6520 746f 2074 6865 2046 7265 write to the Fre │ │ │ -00228270: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ -00228280: 6174 696f 6e2c 2049 6e63 2e2c 0a20 2d20 ation, Inc.,. - │ │ │ -00228290: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ -002282a0: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ -002282b0: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ -002282c0: 3330 3120 5553 410a 202d 2020 0a20 2d20 301 USA. - . - │ │ │ -002282d0: 200a 2d2d 3e0a 3c72 6566 656e 7472 7920 .-->.<refentry │ │ │ -002282e0: 6964 3d22 666e 5f78 656e 635f 6b65 795f id="fn_xenc_key_ │ │ │ -002282f0: 4453 415f 6372 6561 7465 223e 0a20 203c DSA_create">. < │ │ │ -00228300: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. <re │ │ │ -00228310: 6665 6e74 7279 7469 746c 653e 7865 6e63 fentrytitle>xenc │ │ │ -00228320: 5f6b 6579 5f44 5341 5f63 7265 6174 653c _key_DSA_create< │ │ │ -00228330: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ -00228340: 2020 2020 3c72 6566 6d69 7363 696e 666f <refmiscinfo │ │ │ -00228350: 3e68 6173 683c 2f72 6566 6d69 7363 696e >hash</refmiscin │ │ │ -00228360: 666f 3e0a 2020 3c2f 7265 666d 6574 613e fo>. </refmeta> │ │ │ -00228370: 0a20 203c 7265 666e 616d 6564 6976 3e0a . <refnamediv>. │ │ │ -00228380: 2020 2020 3c72 6566 6e61 6d65 3e78 656e <refname>xen │ │ │ -00228390: 635f 6b65 795f 4453 415f 6372 6561 7465 c_key_DSA_create │ │ │ -002283a0: 3c2f 7265 666e 616d 653e 0a20 2020 203c </refname>. < │ │ │ -002283b0: 7265 6670 7572 706f 7365 3e55 7365 6420 refpurpose>Used │ │ │ -002283c0: 746f 206d 616b 6520 6173 796d 6d65 7472 to make asymmetr │ │ │ -002283d0: 6963 2044 5341 206b 6579 2e3c 2f72 6566 ic DSA key.</ref │ │ │ -002283e0: 7075 7270 6f73 653e 0a20 203c 2f72 6566 purpose>. </ref │ │ │ -002283f0: 6e61 6d65 6469 763e 0a20 203c 7265 6673 namediv>. <refs │ │ │ -00228400: 796e 6f70 7369 7364 6976 3e0a 2020 2020 ynopsisdiv>. │ │ │ -00228410: 3c66 756e 6373 796e 6f70 7369 7320 6964 <funcsynopsis id │ │ │ -00228420: 3d22 6673 796e 5f78 656e 635f 6b65 795f ="fsyn_xenc_key_ │ │ │ -00228430: 4453 415f 6372 6561 7465 223e 0a20 2020 DSA_create">. │ │ │ -00228440: 2020 203c 6675 6e63 7072 6f74 6f74 7970 <funcprototyp │ │ │ -00228450: 6520 6964 3d22 6670 726f 746f 5f78 656e e id="fproto_xen │ │ │ -00228460: 635f 6b65 795f 4453 415f 6372 6561 7465 c_key_DSA_create │ │ │ -00228470: 223e 0a20 2020 2020 2020 203c 6675 6e63 ">. <func │ │ │ -00228480: 6465 663e 3c66 756e 6374 696f 6e3e 7865 def><function>xe │ │ │ -00228490: 6e63 5f6b 6579 5f44 5341 5f63 7265 6174 nc_key_DSA_creat │ │ │ -002284a0: 653c 2f66 756e 6374 696f 6e3e 3c2f 6675 e</function></fu │ │ │ -002284b0: 6e63 6465 663e 0a09 3c70 6172 616d 6465 ncdef>..<paramde │ │ │ -002284c0: 663e 696e 203c 7061 7261 6d65 7465 723e f>in <parameter> │ │ │ -002284d0: 6e61 6d65 3c2f 7061 7261 6d65 7465 723e name</parameter> │ │ │ -002284e0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar</paramd │ │ │ -002284f0: 6566 3e0a 2020 2020 2020 3c2f 6675 6e63 ef>. </func │ │ │ -00228500: 7072 6f74 6f74 7970 653e 0a20 2020 203c prototype>. < │ │ │ -00228510: 2f66 756e 6373 796e 6f70 7369 733e 0a20 /funcsynopsis>. │ │ │ -00228520: 203c 2f72 6566 7379 6e6f 7073 6973 6469 </refsynopsisdi │ │ │ -00228530: 763e 0a20 203c 7265 6673 6563 7431 2069 v>. <refsect1 i │ │ │ -00228540: 643d 2264 6573 635f 7865 6e63 5f6b 6579 d="desc_xenc_key │ │ │ -00228550: 5f44 5341 5f63 7265 6174 6522 3e0a 2020 _DSA_create">. │ │ │ -00228560: 2020 3c74 6974 6c65 3e44 6573 6372 6970 <title>Descrip │ │ │ -00228570: 7469 6f6e 3c2f 7469 746c 653e 0a20 2020 tion. │ │ │ -00228580: 203c 7061 7261 3e55 7365 6420 746f 206d Used to m │ │ │ -00228590: 616b 6520 6173 796d 6d65 7472 6963 2044 ake asymmetric D │ │ │ -002285a0: 5341 206b 6579 2066 6f72 2064 6967 6974 SA key for digit │ │ │ -002285b0: 616c 2073 6967 6e61 7475 7265 732e 2054 al signatures. T │ │ │ -002285c0: 6865 2067 656e 6572 6174 6564 206b 6579 he generated key │ │ │ -002285d0: 2077 696c 6c0a 636f 6e74 6169 6e20 7072 will.contain pr │ │ │ -002285e0: 6976 6174 6520 616e 6420 7075 626c 6963 ivate and public │ │ │ -002285f0: 206b 6579 732e 0a20 2020 203c 2f70 6172 keys.. . │ │ │ -00228610: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ -00228640: 2020 3c74 6974 6c65 3e50 6172 616d 6574 Paramet │ │ │ -00228650: 6572 733c 2f74 6974 6c65 3e0a 2020 2020 ers. │ │ │ -00228660: 3c72 6566 7365 6374 323e 3c74 6974 6c65 name. │ │ │ -00228680: 2020 2020 3c70 6172 613e 5468 6520 6e61 The na │ │ │ -00228690: 6d65 206f 6620 7468 6520 6b65 792e 3c2f me of the key.. . . Return Types │ │ │ -00228700: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . None.. │ │ │ -00228720: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00228730: 3c72 6566 7365 6374 3120 6964 3d22 6578 . │ │ │ -00228760: 203c 7469 746c 653e 4578 616d 706c 653c Example< │ │ │ -00228770: 2f74 6974 6c65 3e0a 2020 2020 3c65 7861 /title>. <exa │ │ │ -00228780: 6d70 6c65 2069 643d 2265 785f 7865 6e63 mple id="ex_xenc │ │ │ -00228790: 5f6b 6579 5f44 5341 5f63 7265 6174 6522 _key_DSA_create" │ │ │ -002287a0: 3e3c 7469 746c 653e 5369 6d70 6c65 2055 ><title>Simple U │ │ │ -002287b0: 7365 3c2f 7469 746c 653e 0a20 2020 2020 se. │ │ │ -002287c0: 203c 7363 7265 656e 3e3c 215b 4344 4154 .. . . . │ │ │ -00228850: 2020 2020 3c74 6974 6c65 3e53 6565 2041 See A │ │ │ -00228860: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -00228870: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xenc_key │ │ │ -002288b0: 5f33 4445 535f 6372 6561 7465 2829 3c2f _3DES_create() │ │ │ -002288d0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . < │ │ │ -00228910: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -00228920: 795f 3364 6573 5f72 616e 645f 6372 6561 y_3des_rand_crea │ │ │ -00228930: 7465 2829 3c2f 6675 6e63 7469 6f6e 3e3c te()< │ │ │ -00228940: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00228950: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 < │ │ │ -00228980: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -00228990: 795f 6165 735f 6372 6561 7465 2829 3c2f y_aes_create() │ │ │ -002289b0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xenc_key_3DES_ │ │ │ -00228a00: 7265 6164 2829 3c2f 6675 6e63 7469 6f6e read(). │ │ │ -00228a20: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 < │ │ │ -00228a50: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -00228a60: 795f 4453 415f 7265 6164 2829 3c2f 6675 y_DSA_read(). │ │ │ -00228a90: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 x │ │ │ -00228ac0: 656e 635f 6b65 795f 5253 415f 7265 6164 enc_key_RSA_read │ │ │ -00228ad0: 2829 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c (). │ │ │ -00228af0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xenc_key │ │ │ -00228b30: 5f63 7265 6174 655f 6365 7274 2829 3c2f _create_cert() │ │ │ -00228b50: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xenc_key_seria │ │ │ -00228ba0: 6c69 7a65 2829 3c2f 6675 6e63 7469 6f6e lize(). │ │ │ -00228bc0: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 xenc_key_ │ │ │ -00228c00: 7265 6d6f 7665 2829 3c2f 6675 6e63 7469 remove(). . │ │ │ -00228c30: 3c2f 7265 6665 6e74 7279 3e0a b600 0000 ..... │ │ │ -00228c40: 2c64 656d 6f2f 646f 6373 7263 2f66 756e ,demo/docsrc/fun │ │ │ -00228c50: 6372 6566 2f78 656e 635f 6b65 795f 6372 cref/xenc_key_cr │ │ │ -00228c60: 6561 7465 5f63 6572 742e 786d 6cdf 0000 eate_cert.xml... │ │ │ -00228c70: 123f 3c3f 786d 6c20 7665 7273 696f 6e3d .?..< │ │ │ -00229000: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ -00229010: 7865 6e63 5f6b 6579 5f63 7265 6174 655f xenc_key_create_ │ │ │ -00229020: 6365 7274 223e 0a20 203c 7265 666d 6574 cert">. . xenc_key_c │ │ │ -00229050: 7265 6174 655f 6365 7274 3c2f 7265 6665 reate_cert. < │ │ │ -00229070: 7265 666d 6973 6369 6e66 6f3e 6861 7368 refmiscinfo>hash │ │ │ -00229080: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -00229090: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72 . . < │ │ │ -002290b0: 7265 666e 616d 653e 7865 6e63 5f6b 6579 refname>xenc_key │ │ │ -002290c0: 5f63 7265 6174 655f 6365 7274 3c2f 7265 _create_cert. Import a │ │ │ -002290f0: 6b65 7920 6672 6f6d 2061 2063 6572 7469 key from a certi │ │ │ -00229100: 6669 6361 7465 3c2f 7265 6670 7572 706f ficate. . . . < │ │ │ -00229170: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -00229180: 3d22 6670 726f 746f 5f78 656e 635f 6b65 ="fproto_xenc_ke │ │ │ -00229190: 795f 6372 6561 7465 5f63 6572 7422 3e0a y_create_cert">. │ │ │ -002291a0: 2020 2020 2020 2020 3c66 756e 6364 6566 xenc_ │ │ │ -002291c0: 6b65 795f 6372 6561 7465 5f63 6572 743c key_create_cert< │ │ │ -002291d0: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>.. │ │ │ -002291f0: 696e 203c 7061 7261 6d65 7465 723e 6e61 in na │ │ │ -00229200: 6d65 3c2f 7061 7261 6d65 7465 723e 2076 me v │ │ │ -00229210: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar..in │ │ │ -00229230: 3c70 6172 616d 6574 6572 3e63 6572 743c cert< │ │ │ -00229240: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ -00229250: 6861 723c 2f70 6172 616d 6465 663e 0a09 har.. │ │ │ -00229260: 3c70 6172 616d 6465 663e 696e 203c 7061 in type varchar │ │ │ -00229290: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 ..in fmt int.. │ │ │ -002292e0: 696e 203c 7061 7261 6d65 7465 723e 706b in pk │ │ │ -002292f0: 6579 3c2f 7061 7261 6d65 7465 723e 2076 ey v │ │ │ -00229300: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar..in │ │ │ -00229320: 3c70 6172 616d 6574 6572 3e70 6173 733c pass< │ │ │ -00229330: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ -00229340: 6861 723c 2f70 6172 616d 6465 663e 0a20 har. │ │ │ -00229350: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ -00229390: 3c72 6566 7365 6374 3120 6964 3d22 6465 . Description │ │ │ -002293d0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . ..The functio │ │ │ -002293f0: 6e20 6973 2075 7365 6420 746f 2069 6d70 n is used to imp │ │ │ -00229400: 6f72 7420 6120 6b65 7920 2875 7375 616c ort a key (usual │ │ │ -00229410: 6c79 2061 6e20 6173 796d 6d65 7472 6963 ly an asymmetric │ │ │ -00229420: 206b 6579 206c 696b 6520 5253 4120 6f72 key like RSA or │ │ │ -00229430: 2044 5341 290a 0969 6e74 6f20 7573 6572 DSA)..into user │ │ │ -00229440: 2773 2073 7061 6365 2066 726f 6d20 6120 's space from a │ │ │ -00229450: 6365 7274 6966 6963 6174 652e 0a20 2020 certificate.. │ │ │ -00229460: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . . . │ │ │ -002294b0: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ -002294c0: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ -002294d0: 3e3c 7469 746c 653e 6e61 6d65 3c2f 7469 ><title>name</ti │ │ │ -002294e0: 746c 653e 0a09 3c70 6172 613e 5468 6520 tle>..<para>The │ │ │ -002294f0: 6e61 6d65 206f 6620 7468 6520 6b65 7920 name of the key │ │ │ -00229500: 746f 2062 6520 7265 6769 7374 6572 6564 to be registered │ │ │ -00229510: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 </para>. </re │ │ │ -00229520: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ -00229530: 7365 6374 323e 3c74 6974 6c65 3e63 6572 sect2><title>cer │ │ │ -00229540: 743c 2f74 6974 6c65 3e0a 093c 7061 7261 t..String containi │ │ │ -00229560: 6e67 2074 6865 2063 6572 7469 6669 6361 ng the certifica │ │ │ -00229570: 7465 3c2f 7061 7261 3e0a 2020 2020 3c2f te. . t │ │ │ -002295a0: 7970 653c 2f74 6974 6c65 3e0a 093c 7061 ype..'X.509' is on │ │ │ -002295c0: 6c79 2073 7570 706f 7274 6564 2076 616c ly supported val │ │ │ -002295d0: 7565 3c2f 7061 7261 3e0a 2020 2020 3c2f ue. . f │ │ │ -00229600: 6d74 3c2f 7469 746c 653e 0a09 3c70 6172 mt..The input form │ │ │ -00229620: 6174 206f 6620 7468 6520 6365 7274 6966 at of the certif │ │ │ -00229630: 6963 6174 653a 2033 202d 2022 4445 5222 icate: 3 - "DER" │ │ │ -00229640: 2c20 3120 2d20 2250 454d 2220 6f72 2032 , 1 - "PEM" or 2 │ │ │ -00229650: 202d 2022 504b 4353 2331 3222 2e0a 093c - "PKCS#12"...< │ │ │ -00229660: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . pkey │ │ │ -00229690: 3c2f 7469 746c 653e 0a09 3c70 6172 613e .. │ │ │ -002296a0: 5768 656e 2061 6e20 582e 3530 3920 6365 When an X.509 ce │ │ │ -002296b0: 7274 6966 6963 6174 6520 6973 2069 6d70 rtificate is imp │ │ │ -002296c0: 6f72 7465 642c 2074 6869 7320 6361 6e20 orted, this can │ │ │ -002296d0: 6265 2073 7570 706c 6965 6420 746f 206c be supplied to l │ │ │ -002296e0: 6f61 640a 0920 2020 2074 6865 2063 6f72 oad.. the cor │ │ │ -002296f0: 7265 7370 6f6e 6469 6e67 2070 7269 7661 responding priva │ │ │ -00229700: 7465 206b 6579 2061 6c73 6f2e 2020 5468 te key also. Th │ │ │ -00229710: 6973 2069 7320 6f70 7469 6f6e 616c 2e20 is is optional. │ │ │ -00229720: 204e 6f74 6520 7468 6174 2077 6865 6e20 Note that when │ │ │ -00229730: 0a09 2020 2020 7468 6520 504b 4353 2331 .. the PKCS#1 │ │ │ -00229740: 3220 666f 726d 6174 2069 7320 7573 6564 2 format is used │ │ │ -00229750: 2074 6f20 696d 706f 7274 2061 6e20 582e to import an X. │ │ │ -00229760: 3530 3920 6365 7274 6966 6963 6174 652c 509 certificate, │ │ │ -00229770: 2074 6865 2070 7269 7661 7465 0a09 2020 the private.. │ │ │ -00229780: 2020 6b65 7920 6973 2069 6e20 7468 6520 key is in the │ │ │ -00229790: 2763 6572 7427 2c20 6865 6e63 6520 7468 'cert', hence th │ │ │ -002297a0: 6973 2070 6172 616d 6574 6572 2069 6e20 is parameter in │ │ │ -002297b0: 7375 6368 2063 6173 6520 6d75 7374 2062 such case must b │ │ │ -002297c0: 650a 0920 2020 206f 6d69 7474 6564 2e0a e.. omitted.. │ │ │ -002297d0: 093c 2f70 6172 613e 0a20 2020 203c 2f72 .. . pa │ │ │ -00229800: 7373 3c2f 7469 746c 653e 0a09 3c70 6172 ss..The password t │ │ │ -00229820: 6f20 756e 6c6f 636b 2074 6865 2070 7269 o unlock the pri │ │ │ -00229830: 7661 7465 206b 6579 2e20 4966 206e 6f74 vate key. If not │ │ │ -00229840: 2072 6571 7569 7265 6420 7468 6973 2063 required this c │ │ │ -00229850: 616e 2062 6520 4e55 4c4c 0a09 2020 2020 an be NULL.. │ │ │ -00229860: 746f 2069 6e64 6963 6174 6520 6e6f 2070 to indicate no p │ │ │ -00229870: 6173 7377 6f72 6420 6973 206e 6565 6465 assword is neede │ │ │ -00229880: 642e 3c2f 7061 7261 3e0a 2020 2020 3c2f d.. . . . Examples. Importing a │ │ │ -00229930: 206b 6579 2066 726f 6d20 582e 3530 3920 key from X.509 │ │ │ -00229940: 6365 7274 6966 6963 6174 653c 2f74 6974 certificate. .. │ │ │ -00229a10: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 . │ │ │ -00229a20: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . . < │ │ │ -00229a60: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also. xenc_set_prim │ │ │ -00229ac0: 6172 795f 6b65 7928 293c 2f66 756e 6374 ary_key().

  • x │ │ │ -00229b20: 656e 635f 6b65 795f 3344 4553 5f63 7265 enc_key_3DES_cre │ │ │ -00229b30: 6174 6528 293c 2f66 756e 6374 696f 6e3e ate() │ │ │ -00229b40: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -00229b50: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c │ │ │ -00229b90: 7865 6e63 5f6b 6579 5f33 6465 735f 7261 xenc_key_3des_ra │ │ │ -00229ba0: 6e64 5f63 7265 6174 6528 293c 2f66 756e nd_create()

    . < │ │ │ -00229bd0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -00229be0: 5f78 656e 635f 6b65 795f 4145 535f 6372 _xenc_key_AES_cr │ │ │ -00229bf0: 6561 7465 223e 3c66 756e 6374 696f 6e3e eate"> │ │ │ -00229c00: 7865 6e63 5f6b 6579 5f61 6573 5f63 7265 xenc_key_aes_cre │ │ │ -00229c10: 6174 6528 293c 2f66 756e 6374 696f 6e3e ate() │ │ │ -00229c20: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -00229c30: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c < │ │ │ -00229c60: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -00229c70: 795f 3344 4553 5f72 6561 6428 293c 2f66 y_3DES_read()< │ │ │ -00229c90: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -00229cd0: 7865 6e63 5f6b 6579 5f44 5341 5f72 6561 xenc_key_DSA_rea │ │ │ -00229ce0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -00229d00: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xenc_key │ │ │ -00229d40: 5f64 7361 5f63 7265 6174 6528 293c 2f66 _dsa_create()< │ │ │ -00229d60: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -00229da0: 7865 6e63 5f6b 6579 5f52 5341 5f72 6561 xenc_key_RSA_rea │ │ │ -00229db0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -00229dd0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xenc_key_ │ │ │ -00229e10: 7365 7269 616c 697a 6528 293c 2f66 756e serialize()

    . < │ │ │ -00229e40: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -00229e50: 5f78 656e 635f 6b65 795f 7265 6d6f 7665 _xenc_key_remove │ │ │ -00229e60: 223e 3c66 756e 6374 696f 6e3e 7865 6e63 ">xenc │ │ │ -00229e70: 5f6b 6579 5f72 656d 6f76 6528 293c 2f66 _key_remove()< │ │ │ -00229e90: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -00229eb0: 0ab6 0000 0030 6465 6d6f 2f64 6f63 7372 .....0demo/docsr │ │ │ -00229ec0: 632f 6675 6e63 7265 662f 7865 6e63 5f6b c/funcref/xenc_k │ │ │ -00229ed0: 6579 5f61 6573 5f72 616e 645f 6372 6561 ey_aes_rand_crea │ │ │ -00229ee0: 7465 2e78 6d6c df00 000e 323c 3f78 6d6c te.xml....2... . │ │ │ -0022a2b0: 2020 2020 3c72 6566 656e 7472 7974 6974 xenc_key_AES_ │ │ │ -0022a2d0: 7261 6e64 5f63 7265 6174 653c 2f72 6566 rand_create. │ │ │ -0022a2f0: 3c72 6566 6d69 7363 696e 666f 3e68 6173 has │ │ │ -0022a300: 683c 2f72 6566 6d69 7363 696e 666f 3e0a h. │ │ │ -0022a310: 2020 3c2f 7265 666d 6574 613e 0a20 203c . < │ │ │ -0022a320: 7265 666e 616d 6564 6976 3e0a 2020 2020 refnamediv>. │ │ │ -0022a330: 3c72 6566 6e61 6d65 3e78 656e 635f 6b65 xenc_ke │ │ │ -0022a340: 795f 4145 535f 7261 6e64 5f63 7265 6174 y_AES_rand_creat │ │ │ -0022a350: 653c 2f72 6566 6e61 6d65 3e0a 2020 2020 e. │ │ │ -0022a360: 3c72 6566 7075 7270 6f73 653e 5573 6564 Used │ │ │ -0022a370: 2074 6f20 6d61 6b65 2061 2074 656d 706f to make a tempo │ │ │ -0022a380: 7261 7279 2073 6573 7369 6f6e 206b 6579 rary session key │ │ │ -0022a390: 2e3c 2f72 6566 7075 7270 6f73 653e 0a20 .. │ │ │ -0022a3a0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -0022a3b0: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . xe │ │ │ -0022a450: 6e63 5f6b 6579 5f41 4553 5f72 616e 645f nc_key_AES_rand_ │ │ │ -0022a460: 6372 6561 7465 3c2f 6675 6e63 7469 6f6e create..in name varchar

    ..in bits int. .
    . < │ │ │ -0022a520: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -0022a530: 0a20 203c 7265 6673 6563 7431 2069 643d . │ │ │ -0022a560: 0a20 2020 203c 7469 746c 653e 4465 7363 . Desc │ │ │ -0022a570: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -0022a580: 2020 2020 3c70 6172 613e 5573 6564 2074 Used t │ │ │ -0022a590: 6f20 6d61 6b65 2061 2074 656d 706f 7261 o make a tempora │ │ │ -0022a5a0: 7279 2073 6573 7369 6f6e 206b 6579 2066 ry session key f │ │ │ -0022a5b0: 6f72 2041 4553 2065 6e63 7279 7074 696f or AES encryptio │ │ │ -0022a5c0: 6e2e 3c2f 7061 7261 3e0a 2020 3c2f 7265 n.. . . Parameters< │ │ │ -0022a620: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. nam │ │ │ -0022a640: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -0022a650: 3c70 6172 613e 5468 6520 6e61 6d65 206f The name o │ │ │ -0022a660: 6620 7468 6520 6b65 792e 3c2f 7061 7261 f the key.. . │ │ │ -0022a690: 3c74 6974 6c65 3e62 6974 733c 2f74 6974 bits</tit │ │ │ -0022a6a0: 6c65 3e0a 093c 7061 7261 3e4e 756d 6265 le>..<para>Numbe │ │ │ -0022a6b0: 7220 6f66 2062 6974 7320 696e 2067 656e r of bits in gen │ │ │ -0022a6c0: 6572 6174 6564 206b 6579 2e20 5468 6520 erated key. The │ │ │ -0022a6d0: 7661 6c75 6573 2073 7570 706f 7274 6564 values supported │ │ │ -0022a6e0: 2061 7265 2031 3238 2c20 3139 3220 616e are 128, 192 an │ │ │ -0022a6f0: 6420 3235 3620 6269 7473 2e3c 2f70 6172 d 256 bits.</par │ │ │ -0022a700: 613e 0a20 2020 203c 2f72 6566 7365 6374 a>. </refsect │ │ │ -0022a710: 323e 0a20 203c 2f72 6566 7365 6374 313e 2>. </refsect1> │ │ │ -0022a720: 0a20 203c 7265 6673 6563 7431 2069 643d . <refsect1 id= │ │ │ -0022a730: 2272 6574 5f78 656e 635f 6b65 795f 4145 "ret_xenc_key_AE │ │ │ -0022a740: 535f 7261 6e64 5f63 7265 6174 6522 3e3c S_rand_create">< │ │ │ -0022a750: 7469 746c 653e 5265 7475 726e 2054 7970 title>Return Typ │ │ │ -0022a760: 6573 3c2f 7469 746c 653e 0a20 2020 203c es. < │ │ │ -0022a770: 7061 7261 3e4e 6f6e 652e 3c2f 7061 7261 para>None.
    . . │ │ │ -0022a790: 2020 3c72 6566 7365 6374 3120 6964 3d22 . E │ │ │ -0022a7d0: 7861 6d70 6c65 3c2f 7469 746c 653e 0a20 xample. │ │ │ -0022a7e0: 2020 203c 6578 616d 706c 6520 6964 3d22 Simple Use. .. . . . See Also.
  • x │ │ │ -0022a920: 656e 635f 6b65 795f 3344 4553 5f63 7265 enc_key_3DES_cre │ │ │ -0022a930: 6174 6528 293c 2f66 756e 6374 696f 6e3e ate() │ │ │ -0022a940: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -0022a950: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c │ │ │ -0022a990: 7865 6e63 5f6b 6579 5f33 6465 735f 7261 xenc_key_3des_ra │ │ │ -0022a9a0: 6e64 5f63 7265 6174 6528 293c 2f66 756e nd_create()

    . < │ │ │ -0022a9d0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0022a9e0: 5f78 656e 635f 6b65 795f 4145 535f 6372 _xenc_key_AES_cr │ │ │ -0022a9f0: 6561 7465 223e 3c66 756e 6374 696f 6e3e eate"> │ │ │ -0022aa00: 7865 6e63 5f6b 6579 5f61 6573 5f63 7265 xenc_key_aes_cre │ │ │ -0022aa10: 6174 6528 293c 2f66 756e 6374 696f 6e3e ate() │ │ │ -0022aa20: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -0022aa30: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c < │ │ │ -0022aa60: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -0022aa70: 795f 3344 4553 5f72 6561 6428 293c 2f66 y_3DES_read()< │ │ │ -0022aa90: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -0022aad0: 7865 6e63 5f6b 6579 5f44 5341 5f72 6561 xenc_key_DSA_rea │ │ │ -0022aae0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -0022ab00: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xenc_key │ │ │ -0022ab40: 5f44 5341 5f63 7265 6174 6528 293c 2f66 _DSA_create()< │ │ │ -0022ab60: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -0022aba0: 7865 6e63 5f6b 6579 5f52 5341 5f72 6561 xenc_key_RSA_rea │ │ │ -0022abb0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -0022abd0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ -0022ac00: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -0022ac10: 795f 6372 6561 7465 5f63 6572 7428 293c y_create_cert()< │ │ │ -0022ac20: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xenc_key_seri │ │ │ -0022ac80: 616c 697a 6528 293c 2f66 756e 6374 696f alize() │ │ │ -0022aca0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xenc_key │ │ │ -0022ace0: 5f72 656d 6f76 6528 293c 2f66 756e 6374 _remove(). │ │ │ -0022ad10: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 ..... │ │ │ -0022ad20: 002b 6465 6d6f 2f64 6f63 7372 632f 6675 .+demo/docsrc/fu │ │ │ -0022ad30: 6e63 7265 662f 7865 6e63 5f6b 6579 5f61 ncref/xenc_key_a │ │ │ -0022ad40: 6573 5f63 7265 6174 652e 786d 6cdf 0000 es_create.xml... │ │ │ -0022ad50: 0eb8 3c3f 786d 6c20 7665 7273 696f 6e3d ....< │ │ │ -0022b0e0: 7265 6665 6e74 7279 2069 643d 2266 6e5f refentry id="fn_ │ │ │ -0022b0f0: 7865 6e63 5f6b 6579 5f41 4553 5f63 7265 xenc_key_AES_cre │ │ │ -0022b100: 6174 6522 3e0a 2020 3c72 6566 6d65 7461 ate">. . xenc_key_AE │ │ │ -0022b130: 535f 6372 6561 7465 3c2f 7265 6665 6e74 S_create. hash. < │ │ │ -0022b170: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . xenc_key_A │ │ │ -0022b1a0: 4553 5f63 7265 6174 653c 2f72 6566 6e61 ES_create. Used to make │ │ │ -0022b1d0: 2061 2073 796d 6d65 7472 6963 206b 6579 a symmetric key │ │ │ -0022b1e0: 2e3c 2f72 6566 7075 7270 6f73 653e 0a20 .. │ │ │ -0022b1f0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -0022b200: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . │ │ │ -0022b280: 203c 6675 6e63 6465 663e 3c66 756e 6374 xenc_key_AES │ │ │ -0022b2a0: 5f63 7265 6174 653c 2f66 756e 6374 696f _create..

    in name varchar..in bits int..in │ │ │ -0022b340: 203c 7061 7261 6d65 7465 723e 7365 6372 secr │ │ │ -0022b350: 6574 3c2f 7061 7261 6d65 7465 723e 2076 et v │ │ │ -0022b360: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. . . < │ │ │ -0022b3a0: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -0022b3b0: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ -0022b3e0: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ -0022b3f0: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ -0022b400: 7061 7261 3e55 7365 6420 746f 206d 616b para>Used to mak │ │ │ -0022b410: 6520 6120 7379 6d6d 6574 7269 6320 7365 e a symmetric se │ │ │ -0022b420: 7373 696f 6e20 6b65 7920 666f 7220 4145 ssion key for AE │ │ │ -0022b430: 5320 656e 6372 7970 7469 6f6e 2061 6c67 S encryption alg │ │ │ -0022b440: 6f72 6974 686d 2e3c 2f70 6172 613e 0a20 orithm.. │ │ │ -0022b450: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ -0022b460: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -0022b470: 616d 735f 7865 6e63 5f6b 6579 5f41 4553 ams_xenc_key_AES │ │ │ -0022b480: 5f63 7265 6174 6522 3e0a 2020 2020 3c74 _create">. Parameters< │ │ │ -0022b4a0: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. nam │ │ │ -0022b4c0: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -0022b4d0: 3c70 6172 613e 5468 6520 6e61 6d65 206f The name o │ │ │ -0022b4e0: 6620 7468 6520 6b65 792e 3c2f 7061 7261 f the key.. . │ │ │ -0022b510: 3c74 6974 6c65 3e62 6974 733c 2f74 6974 bits</tit │ │ │ -0022b520: 6c65 3e0a 093c 7061 7261 3e4e 756d 6265 le>..<para>Numbe │ │ │ -0022b530: 7220 6f66 2062 6974 7320 696e 2067 656e r of bits in gen │ │ │ -0022b540: 6572 6174 6564 206b 6579 2e20 5468 6520 erated key. The │ │ │ -0022b550: 7661 6c75 6573 2073 7570 706f 7274 6564 values supported │ │ │ -0022b560: 2061 7265 2031 3238 2c20 3139 3220 616e are 128, 192 an │ │ │ -0022b570: 6420 3235 3620 6269 7473 2e3c 2f70 6172 d 256 bits.</par │ │ │ -0022b580: 613e 0a20 2020 203c 2f72 6566 7365 6374 a>. </refsect │ │ │ -0022b590: 323e 0a20 2020 203c 7265 6673 6563 7432 2>. <refsect2 │ │ │ -0022b5a0: 3e3c 7469 746c 653e 7365 6372 6574 3c2f ><title>secret</ │ │ │ -0022b5b0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -0022b5c0: 7261 3e54 6865 2073 6861 7265 6420 7365 ra>The shared se │ │ │ -0022b5d0: 6372 6574 2066 6f72 206b 6579 2067 656e cret for key gen │ │ │ -0022b5e0: 6572 6174 696f 6e2e 3c2f 7061 7261 3e0a eration.</para>. │ │ │ -0022b5f0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a </refsect2>. │ │ │ -0022b600: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -0022b610: 3c72 6566 7365 6374 3120 6964 3d22 7265 <refsect1 id="re │ │ │ -0022b620: 745f 7865 6e63 5f6b 6579 5f41 4553 5f63 t_xenc_key_AES_c │ │ │ -0022b630: 7265 6174 6522 3e3c 7469 746c 653e 5265 reate"><title>Re │ │ │ -0022b640: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ -0022b650: 653e 0a20 2020 203c 7061 7261 3e4e 6f6e e>. <para>Non │ │ │ -0022b660: 652e 3c2f 7061 7261 3e0a 2020 3c2f 7265 e.</para>. </re │ │ │ -0022b670: 6673 6563 7431 3e0a 2020 3c72 6566 7365 fsect1>. <refse │ │ │ -0022b680: 6374 3120 6964 3d22 6578 616d 706c 6573 ct1 id="examples │ │ │ -0022b690: 5f78 656e 635f 6b65 795f 4145 535f 6372 _xenc_key_AES_cr │ │ │ -0022b6a0: 6561 7465 223e 0a20 2020 203c 7469 746c eate">. <titl │ │ │ -0022b6b0: 653e 4578 616d 706c 653c 2f74 6974 6c65 e>Example. Simple Use. .. │ │ │ -0022b760: 2020 203c 2f65 7861 6d70 6c65 3e0a 2020 . │ │ │ -0022b770: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . . See Also. │ │ │ -0022b7d0: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 xenc_key_3DES_ │ │ │ -0022b810: 6372 6561 7465 2829 3c2f 6675 6e63 7469 create(). xenc_key_3des │ │ │ -0022b880: 5f72 616e 645f 6372 6561 7465 2829 3c2f _rand_create() │ │ │ -0022b8a0: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . xenc_key_3des_ │ │ │ -0022b8f0: 7265 6164 2829 3c2f 6675 6e63 7469 6f6e read(). │ │ │ -0022b910: 2020 2020 3c70 6172 613e 3c6c 696e 6b20 │ │ │ -0022b950: 7865 6e63 5f6b 6579 5f61 6573 5f72 616e xenc_key_aes_ran │ │ │ -0022b960: 645f 6372 6561 7465 2829 3c2f 6675 6e63 d_create(). xen │ │ │ -0022b9c0: 635f 6b65 795f 4453 415f 7265 6164 2829 c_key_DSA_read() │ │ │ -0022b9d0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    xenc_key_ds │ │ │ -0022ba30: 615f 6372 6561 7465 2829 3c2f 6675 6e63 a_create(). xen │ │ │ -0022ba90: 635f 6b65 795f 5253 415f 7265 6164 2829 c_key_RSA_read() │ │ │ -0022baa0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e .

    xenc_key_c │ │ │ -0022bb00: 7265 6174 655f 6365 7274 2829 3c2f 6675 reate_cert(). │ │ │ -0022bb30: 3c6c 696e 6b20 6c69 6e6b 656e 643d 2266 │ │ │ -0022bb60: 7865 6e63 5f6b 6579 5f73 6572 6961 6c69 xenc_key_seriali │ │ │ -0022bb70: 7a65 2829 3c2f 6675 6e63 7469 6f6e 3e3c ze()< │ │ │ -0022bb80: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -0022bb90: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 xenc_key_re │ │ │ -0022bbd0: 6d6f 7665 2829 3c2f 6675 6e63 7469 6f6e move(). │ │ │ -0022bbf0: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ......)d │ │ │ -0022bc10: 656d 6f2f 646f 6373 7263 2f66 756e 6372 emo/docsrc/funcr │ │ │ -0022bc20: 6566 2f78 656e 635f 6b65 795f 5253 415f ef/xenc_key_RSA_ │ │ │ -0022bc30: 7265 6164 2e78 6d6c df00 000a ef3c 3f78 read.xml........ │ │ │ -0022bff0: 203c 7265 666d 6574 613e 0a20 2020 203c . < │ │ │ -0022c000: 7265 6665 6e74 7279 7469 746c 653e 7865 refentrytitle>xe │ │ │ -0022c010: 6e63 5f6b 6579 5f52 5341 5f72 6561 643c nc_key_RSA_read< │ │ │ -0022c020: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ -0022c030: 2020 2020 3c72 6566 6d69 7363 696e 666f hash. │ │ │ -0022c060: 0a20 203c 7265 666e 616d 6564 6976 3e0a . . │ │ │ -0022c070: 2020 2020 3c72 6566 6e61 6d65 3e78 656e xen │ │ │ -0022c080: 635f 6b65 795f 5253 415f 7265 6164 3c2f c_key_RSA_read. Importi │ │ │ -0022c0b0: 6e67 2061 2052 5341 206b 6579 2069 6e74 ng a RSA key int │ │ │ -0022c0c0: 6f20 7573 6572 2773 2072 6570 6f73 6974 o user's reposit │ │ │ -0022c0d0: 6f72 793c 2f72 6566 7075 7270 6f73 653e ory │ │ │ -0022c0e0: 0a20 203c 2f72 6566 6e61 6d65 6469 763e . │ │ │ -0022c0f0: 0a20 203c 7265 6673 796e 6f70 7369 7364 . . . . < │ │ │ -0022c170: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>xenc_key_RSA_r │ │ │ -0022c190: 6561 643c 2f66 756e 6374 696f 6e3e 3c2f ead..in name varchar..in k │ │ │ -0022c200: 6579 5f64 6174 613c 2f70 6172 616d 6574 ey_data varchar. . │ │ │ -0022c240: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . . │ │ │ -0022c290: 2020 203c 7469 746c 653e 4465 7363 7269 Descri │ │ │ -0022c2a0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -0022c2b0: 2020 3c70 6172 613e 0a09 5468 6973 2066 ..This f │ │ │ -0022c2c0: 756e 6374 696f 6e20 6973 2075 7365 6420 unction is used │ │ │ -0022c2d0: 746f 2069 6d70 6f72 7420 616e 2052 5341 to import an RSA │ │ │ -0022c2e0: 2020 7365 7269 616c 697a 6564 206b 6579 serialized key │ │ │ -0022c2f0: 200a 0969 6e74 6f20 7573 6572 2773 2072 ..into user's r │ │ │ -0022c300: 6570 6f73 6974 6f72 7920 616e 6420 7265 epository and re │ │ │ -0022c310: 6769 7374 6572 2069 7420 7769 7468 2061 gister it with a │ │ │ -0022c320: 206e 616d 6520 7375 7070 6c69 6564 2e0a name supplied.. │ │ │ -0022c330: 2020 2020 3c2f 7061 7261 3e0a 2020 2020 . │ │ │ -0022c340: 3c70 6172 613e 0a09 4e6f 7465 2074 6861 ..Note tha │ │ │ -0022c350: 7420 6b65 7920 7769 6c6c 206e 6f74 2062 t key will not b │ │ │ -0022c360: 6520 7065 7273 6973 7465 642e 2049 7420 e persisted. It │ │ │ -0022c370: 6973 206c 6f61 6465 6420 696e 2074 6865 is loaded in the │ │ │ -0022c380: 200a 096d 656d 6f72 7920 6f6e 6c79 2e0a ..memory only.. │ │ │ -0022c390: 2020 2020 3c2f 7061 7261 3e0a 2020 3c2f . . . . │ │ │ -0022d8a0: 203c 7265 6673 6563 7431 2069 643d 2264 . │ │ │ -0022d8d0: 2020 2020 3c74 6974 6c65 3e44 6573 6372 Descr │ │ │ -0022d8e0: 6970 7469 6f6e 3c2f 7469 746c 653e 0a20 iption. │ │ │ -0022d8f0: 2020 203c 7061 7261 3e55 7365 6420 746f Used to │ │ │ -0022d900: 206d 616b 6520 6120 7465 6d70 6f72 6172 make a temporar │ │ │ -0022d910: 7920 7365 7373 696f 6e20 6b65 792e 3c2f y session key.. . . Parameters. name</ │ │ │ -0022d9a0: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -0022d9b0: 7261 3e54 6865 206e 616d 6520 6f66 2074 ra>The name of t │ │ │ -0022d9c0: 6865 206b 6579 2e3c 2f70 6172 613e 0a20 he key.</para>. │ │ │ -0022d9d0: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ -0022d9e0: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ -0022d9f0: 7265 6673 6563 7431 2069 643d 2272 6574 refsect1 id="ret │ │ │ -0022da00: 5f78 656e 635f 6b65 795f 3344 4553 5f72 _xenc_key_3DES_r │ │ │ -0022da10: 616e 645f 6372 6561 7465 223e 3c74 6974 and_create"><tit │ │ │ -0022da20: 6c65 3e52 6574 7572 6e20 5479 7065 733c le>Return Types< │ │ │ -0022da30: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -0022da40: 613e 4e6f 6e65 2e3c 2f70 6172 613e 0a20 a>None.</para>. │ │ │ -0022da50: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ -0022da60: 7265 6673 6563 7431 2069 643d 2265 7861 refsect1 id="exa │ │ │ -0022da70: 6d70 6c65 735f 7865 6e63 5f6b 6579 5f33 mples_xenc_key_3 │ │ │ -0022da80: 4445 535f 7261 6e64 5f63 7265 6174 6522 DES_rand_create" │ │ │ -0022da90: 3e0a 2020 2020 3c74 6974 6c65 3e45 7861 >. <title>Exa │ │ │ -0022daa0: 6d70 6c65 3c2f 7469 746c 653e 0a20 2020 mple. │ │ │ -0022dab0: 203c 6578 616d 706c 6520 6964 3d22 6578 Simple Use. .. │ │ │ -0022db50: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -0022db60: 203c 7265 6673 6563 7431 2069 643d 2273 . Se │ │ │ -0022dba0: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ -0022dbb0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c xenc_ │ │ │ -0022dbf0: 6b65 795f 3344 4553 5f63 7265 6174 6528 key_3DES_create( │ │ │ -0022dc00: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )

  • . < │ │ │ -0022dc20: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_ │ │ │ -0022dc60: 6b65 795f 4145 535f 7261 6e64 5f63 7265 key_AES_rand_cre │ │ │ -0022dc70: 6174 6528 293c 2f66 756e 6374 696f 6e3e ate() │ │ │ -0022dc80: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20
    . │ │ │ -0022dc90: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c │ │ │ -0022dcc0: 3c66 756e 6374 696f 6e3e 7865 6e63 5f6b xenc_k │ │ │ -0022dcd0: 6579 5f61 6573 5f63 7265 6174 6528 293c ey_aes_create()< │ │ │ -0022dce0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xenc_key_3DES │ │ │ -0022dd40: 5f72 6561 6428 293c 2f66 756e 6374 696f _read() │ │ │ -0022dd60: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -0022dd90: 3c66 756e 6374 696f 6e3e 7865 6e63 5f6b xenc_k │ │ │ -0022dda0: 6579 5f44 5341 5f72 6561 6428 293c 2f66 ey_DSA_read()< │ │ │ -0022ddc0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xenc_key_dsa_c │ │ │ -0022de10: 7265 6174 6528 293c 2f66 756e 6374 696f reate() │ │ │ -0022de30: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -0022de60: 3c66 756e 6374 696f 6e3e 7865 6e63 5f6b xenc_k │ │ │ -0022de70: 6579 5f52 5341 5f72 6561 6428 293c 2f66 ey_RSA_read()< │ │ │ -0022de90: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xenc_key_crea │ │ │ -0022dee0: 7465 5f63 6572 7428 293c 2f66 756e 6374 te_cert().
  • xen │ │ │ -0022df40: 635f 6b65 795f 7365 7269 616c 697a 6528 c_key_serialize( │ │ │ -0022df50: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 )
  • . < │ │ │ -0022df70: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_key_remov │ │ │ -0022dfb0: 6528 293c 2f66 756e 6374 696f 6e3e 3c2f e()
    . < │ │ │ -0022dfd0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......,demo │ │ │ -0022dff0: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -0022e000: 7865 6e63 5f6b 6579 5f33 6465 735f 6372 xenc_key_3des_cr │ │ │ -0022e010: 6561 7465 2e78 6d6c df00 000d f03c 3f78 eate.xml........ . │ │ │ -0022e3e0: 2020 3c72 6566 656e 7472 7974 6974 6c65 xenc_key_3DES_c │ │ │ -0022e400: 7265 6174 653c 2f72 6566 656e 7472 7974 reate. hash. . . xenc_key_3DES │ │ │ -0022e470: 5f63 7265 6174 653c 2f72 6566 6e61 6d65 _create. Used to make a │ │ │ -0022e4a0: 2073 796d 6d65 7472 6963 206b 6579 2e3c symmetric key.< │ │ │ -0022e4b0: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -0022e4c0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -0022e4d0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -0022e4e0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . . │ │ │ -0022e550: 203c 6675 6e63 6465 663e 3c66 756e 6374 xenc_key_3DE │ │ │ -0022e570: 535f 6372 6561 7465 3c2f 6675 6e63 7469 S_create
    ..< │ │ │ -0022e590: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in name varchar< │ │ │ -0022e5c0: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..in secret varchar. │ │ │ -0022e610: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -0022e620: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . . │ │ │ -0022e680: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -0022e690: 6c65 3e0a 2020 2020 3c70 6172 613e 5573 le>. <para>Us │ │ │ -0022e6a0: 6564 2074 6f20 6d61 6b65 2061 2073 796d ed to make a sym │ │ │ -0022e6b0: 6d65 7472 6963 2073 6573 7369 6f6e 206b metric session k │ │ │ -0022e6c0: 6579 2066 6f72 2074 7269 706c 652d 6465 ey for triple-de │ │ │ -0022e6d0: 7320 616c 676f 7269 7468 6d2e 3c2f 7061 s algorithm.</pa │ │ │ -0022e6e0: 7261 3e0a 2020 3c2f 7265 6673 6563 7431 ra>. </refsect1 │ │ │ -0022e6f0: 3e0a 2020 3c72 6566 7365 6374 3120 6964 >. <refsect1 id │ │ │ -0022e700: 3d22 7061 7261 6d73 5f78 656e 635f 6b65 ="params_xenc_ke │ │ │ -0022e710: 795f 3344 4553 5f63 7265 6174 6522 3e0a y_3DES_create">. │ │ │ -0022e720: 2020 2020 3c74 6974 6c65 3e50 6172 616d <title>Param │ │ │ -0022e730: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -0022e740: 2020 3c72 6566 7365 6374 323e 3c74 6974 name. │ │ │ -0022e760: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -0022e770: 6e61 6d65 206f 6620 7468 6520 6b65 792e name of the key. │ │ │ -0022e780: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 . . sec │ │ │ -0022e7b0: 7265 743c 2f74 6974 6c65 3e0a 2020 2020 ret. │ │ │ -0022e7c0: 2020 3c70 6172 613e 5468 6520 7368 6172 The shar │ │ │ -0022e7d0: 6564 2073 6563 7265 7420 666f 7220 6b65 ed secret for ke │ │ │ -0022e7e0: 7920 6765 6e65 7261 7469 6f6e 2e3c 2f70 y generation.

    . . . Return Types │ │ │ -0022e850: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . None.
    . │ │ │ -0022e870: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -0022e880: 3c72 6566 7365 6374 3120 6964 3d22 6578 . │ │ │ -0022e8b0: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 Example │ │ │ -0022e8c0: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Simple │ │ │ -0022e900: 2055 7365 3c2f 7469 746c 653e 0a20 2020 Use. │ │ │ -0022e910: 2020 203c 7363 7265 656e 3e3c 215b 4344 .. . . │ │ │ -0022e980: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ -0022e9b0: 2020 203c 7469 746c 653e 5365 6520 416c See Al │ │ │ -0022e9c0: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ -0022e9d0: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_key_3D │ │ │ -0022ea10: 4553 5f72 6561 6428 293c 2f66 756e 6374 ES_read()
    .
  • xenc_key_3de │ │ │ -0022ea80: 735f 7261 6e64 5f63 7265 6174 6528 293c s_rand_create()< │ │ │ -0022ea90: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xenc_key_aes │ │ │ -0022eaf0: 5f63 7265 6174 6528 293c 2f66 756e 6374 _create().
  • xenc_key_aes_ │ │ │ -0022eb60: 7261 6e64 5f63 7265 6174 6528 293c 2f66 rand_create()< │ │ │ -0022eb80: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -0022ebc0: 7865 6e63 5f6b 6579 5f44 5341 5f72 6561 xenc_key_DSA_rea │ │ │ -0022ebd0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -0022ebf0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xenc_key │ │ │ -0022ec30: 5f64 7361 5f63 7265 6174 6528 293c 2f66 _dsa_create()< │ │ │ -0022ec50: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. │ │ │ -0022ec90: 7865 6e63 5f6b 6579 5f52 5341 5f72 6561 xenc_key_RSA_rea │ │ │ -0022eca0: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ -0022ecc0: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e < │ │ │ -0022ecf0: 6675 6e63 7469 6f6e 3e78 656e 635f 6b65 function>xenc_ke │ │ │ -0022ed00: 795f 6372 6561 7465 5f63 6572 7428 293c y_create_cert()< │ │ │ -0022ed10: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. xenc_key_seri │ │ │ -0022ed70: 616c 697a 6528 293c 2f66 756e 6374 696f alize() │ │ │ -0022ed90: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xenc_key │ │ │ -0022edd0: 5f72 656d 6f76 6528 293c 2f66 756e 6374 _remove(). │ │ │ -0022ee00: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 ..... │ │ │ -0022ee10: 002a 6465 6d6f 2f64 6f63 7372 632f 6675 .*demo/docsrc/fu │ │ │ -0022ee20: 6e63 7265 662f 7865 6e63 5f6b 6579 5f33 ncref/xenc_key_3 │ │ │ -0022ee30: 4445 535f 7265 6164 2e78 6d6c df00 000e DES_read.xml.... │ │ │ -0022ee40: ca3c 3f78 6d6c 2076 6572 7369 6f6e 3d22 .... . │ │ │ -0022f200: 2020 2020 3c72 6566 656e 7472 7974 6974 xenc_key_3DES │ │ │ -0022f220: 5f72 6561 643c 2f72 6566 656e 7472 7974 _read. hash. . . xenc_key_3DES │ │ │ -0022f290: 5f72 6561 643c 2f72 6566 6e61 6d65 3e0a _read. │ │ │ -0022f2a0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -0022f2b0: 496d 706f 7274 696e 6720 6120 7472 6970 Importing a trip │ │ │ -0022f2c0: 6c65 2d64 6573 206b 6579 2069 6e74 6f20 le-des key into │ │ │ -0022f2d0: 7573 6572 2773 2072 6570 6f73 6974 6f72 user's repositor │ │ │ -0022f2e0: 793c 2f72 6566 7075 7270 6f73 653e 0a20 y. │ │ │ -0022f2f0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -0022f300: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . < │ │ │ -0022f380: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef>xenc_key_3DES_ │ │ │ -0022f3a0: 7265 6164 3c2f 6675 6e63 7469 6f6e 3e3c read< │ │ │ -0022f3b0: 2f66 756e 6364 6566 3e0a 093c 7061 7261 /funcdef>..in name varchar..in │ │ │ -0022f410: 6b65 795f 6461 7461 3c2f 7061 7261 6d65 key_data varchar. . │ │ │ -0022f450: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . │ │ │ -0022f4a0: 0a20 2020 203c 7469 746c 653e 4465 7363 . Desc │ │ │ -0022f4b0: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -0022f4c0: 2020 2020 3c70 6172 613e 0a09 5468 6973 ..This │ │ │ -0022f4d0: 2066 756e 6374 696f 6e20 6973 2075 7365 function is use │ │ │ -0022f4e0: 6420 746f 2069 6d70 6f72 7420 6120 7472 d to import a tr │ │ │ -0022f4f0: 6970 6c65 2d64 6573 2073 6572 6961 6c69 iple-des seriali │ │ │ -0022f500: 7a65 6420 6b65 7920 0a09 696e 746f 2075 zed key ..into u │ │ │ -0022f510: 7365 7227 7320 7265 706f 7369 746f 7279 ser's repository │ │ │ -0022f520: 2061 6e64 2072 6567 6973 7465 7220 6974 and register it │ │ │ -0022f530: 2077 6974 6820 6120 6e61 6d65 2073 7570 with a name sup │ │ │ -0022f540: 706c 6965 642e 0a20 2020 203c 2f70 6172 plied.. . ..N │ │ │ -0022f560: 6f74 6520 7468 6174 206b 6579 2077 696c ote that key wil │ │ │ -0022f570: 6c20 6e6f 7420 6265 2070 6572 7369 7374 l not be persist │ │ │ -0022f580: 6564 2e20 4974 2069 7320 6c6f 6164 6564 ed. It is loaded │ │ │ -0022f590: 2069 6e20 7468 6520 0a09 6d65 6d6f 7279 in the ..memory │ │ │ -0022f5a0: 206f 6e6c 792e 0a20 2020 203c 2f70 6172 only.. . │ │ │ -0022f5c0: 0a20 203c 7265 6673 6563 7431 2069 643d . . │ │ │ -0022f5f0: 203c 7469 746c 653e 5061 7261 6d65 7465 Paramete │ │ │ -0022f600: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -0022f610: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -0022f620: 6e61 6d65 3c2f 7469 746c 653e 0a09 3c70 name..

    Name of the │ │ │ -0022f640: 6b65 7920 746f 2072 6567 6973 7465 723c key to register< │ │ │ -0022f650: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . key_ │ │ │ -0022f680: 6461 7461 3c2f 7469 746c 653e 0a09 3c70 data..

    The base64 e │ │ │ -0022f6a0: 6e63 6f64 6564 2062 696e 6172 7920 6461 ncoded binary da │ │ │ -0022f6b0: 7461 2077 6974 6820 6b65 7920 6d61 7465 ta with key mate │ │ │ -0022f6c0: 7269 616c 3c2f 7061 7261 3e0a 2020 2020 rial. │ │ │ -0022f6d0: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f . . Return │ │ │ -0022f720: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ -0022f730: 2020 2020 3c70 6172 613e 4e6f 2072 6574 No ret │ │ │ -0022f740: 7572 6e20 7661 6c75 652e 3c2f 7061 7261 urn value.. . │ │ │ -0022f760: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ -0022f790: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 Example │ │ │ -0022f7a0: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. Loading │ │ │ -0022f7e0: 2061 2073 6861 7265 6420 7365 6372 6574 a shared secret │ │ │ -0022f7f0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0022f800: 7363 7265 656e 3e3c 215b 4344 4154 415b screen>.. . . │ │ │ -0022f890: 2020 3c72 6566 7365 6374 3120 6964 3d22 . │ │ │ -0022f8c0: 203c 7469 746c 653e 5365 6520 416c 736f See Also │ │ │ -0022f8d0: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . xenc_key_3D │ │ │ -0022f920: 4553 5f63 7265 6174 653c 2f66 756e 6374 ES_create.

  • xenc_key_3de │ │ │ -0022f990: 735f 7261 6e64 5f63 7265 6174 653c 2f66 s_rand_create< │ │ │ -0022f9b0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xenc_key_aes_c │ │ │ -0022fa00: 7265 6174 653c 2f66 756e 6374 696f 6e3e reate │ │ │ -0022fa10: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -0022fa20: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c x │ │ │ -0022fa60: 656e 635f 6b65 795f 6165 735f 7261 6e64 enc_key_aes_rand │ │ │ -0022fa70: 5f63 7265 6174 653c 2f66 756e 6374 696f _create │ │ │ -0022fa90: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -0022fac0: 3c66 756e 6374 696f 6e3e 7865 6e63 5f6b xenc_k │ │ │ -0022fad0: 6579 5f44 5341 5f72 6561 643c 2f66 756e ey_DSA_read

    . < │ │ │ -0022fb00: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0022fb10: 5f78 656e 635f 6b65 795f 4453 415f 6372 _xenc_key_DSA_cr │ │ │ -0022fb20: 6561 7465 223e 3c66 756e 6374 696f 6e3e eate"> │ │ │ -0022fb30: 7865 6e63 5f6b 6579 5f64 7361 5f63 7265 xenc_key_dsa_cre │ │ │ -0022fb40: 6174 653c 2f66 756e 6374 696f 6e3e 3c2f ate. │ │ │ -0022fb60: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xenc_key_R │ │ │ -0022fba0: 5341 5f72 6561 643c 2f66 756e 6374 696f SA_read │ │ │ -0022fbc0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xen │ │ │ -0022fc00: 635f 6b65 795f 6372 6561 7465 5f63 6572 c_key_create_cer │ │ │ -0022fc10: 743c 2f66 756e 6374 696f 6e3e 3c2f 6c69 t
  • . < │ │ │ -0022fc30: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>xenc_key_se │ │ │ -0022fc70: 7269 616c 697a 653c 2f66 756e 6374 696f rialize │ │ │ -0022fc90: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xenc_key │ │ │ -0022fcd0: 5f72 656d 6f76 653c 2f66 756e 6374 696f _remove │ │ │ -0022fcf0: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ -0022fd00: 2f72 6566 656e 7472 793e 0ab6 0000 002f /refentry>...../ │ │ │ -0022fd10: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -0022fd20: 7265 662f 7865 6e63 5f67 6574 5f6b 6579 ref/xenc_get_key │ │ │ -0022fd30: 5f69 6465 6e74 6966 6965 722e 786d 6cdf _identifier.xml. │ │ │ -0022fd40: 0000 0b54 3c3f 786d 6c20 7665 7273 696f ...T. │ │ │ -0022fd70: 3c21 2d2d 0a20 2d20 200a 202d 2020 5468 │ │ │ -002300d0: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . xenc_ │ │ │ -00230120: 6765 745f 6b65 795f 6964 656e 7469 6669 get_key_identifi │ │ │ -00230130: 6572 3c2f 7265 6665 6e74 7279 7469 746c er. hash. . . │ │ │ -00230190: 7865 6e63 5f67 6574 5f6b 6579 5f69 6465 xenc_get_key_ide │ │ │ -002301a0: 6e74 6966 6965 723c 2f72 6566 6e61 6d65 ntifier. Determine a ke │ │ │ -002301d0: 7920 6964 656e 7469 6669 6572 3c2f 7265 y identifier. . . │ │ │ -00230210: 203c 6675 6e63 7379 6e6f 7073 6973 2069 . . │ │ │ -00230280: 2020 2020 3c66 756e 6364 6566 3e76 6172 var │ │ │ -00230290: 6368 6172 203c 6675 6e63 7469 6f6e 3e78 char x │ │ │ -002302a0: 656e 635f 6765 745f 6b65 795f 6964 656e enc_get_key_iden │ │ │ -002302b0: 7469 6669 6572 3c2f 6675 6e63 7469 6f6e tifier..in key_name

    varcha │ │ │ -00230300: 723c 2f70 6172 616d 6465 663e 0a20 2020 r. │ │ │ -00230310: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . . < │ │ │ -00230380: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ -00230390: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    The function │ │ │ -002303b0: 2072 6574 7572 6e73 206b 6579 2069 6465 returns key ide │ │ │ -002303c0: 6e74 6966 6965 722e 3c2f 7061 7261 3e0a ntifier.. │ │ │ -002303d0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -002303e0: 3c72 6566 7365 6374 3120 6964 3d22 7061 . │ │ │ -00230410: 2020 203c 7469 746c 653e 5061 7261 6d65 Parame │ │ │ -00230420: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -00230430: 203c 7265 6673 6563 7432 3e3c 7469 746c key_name. N │ │ │ -00230460: 616d 6520 6f66 2074 6865 206b 6579 3c2f ame of the key. . . Return T │ │ │ -002304d0: 7970 6573 3c2f 7469 746c 653e 0a20 2020 ypes. │ │ │ -002304e0: 2020 203c 7061 7261 3e54 6865 2066 756e The fun │ │ │ -002304f0: 6374 696f 6e20 7265 7475 726e 7320 6120 ction returns a │ │ │ -00230500: 6261 7365 3634 2065 6e63 6f64 6564 2073 base64 encoded s │ │ │ -00230510: 7472 696e 6720 636f 6e74 6169 6e69 6e67 tring containing │ │ │ -00230520: 2074 6865 206b 6579 2069 6465 6e74 6966 the key identif │ │ │ -00230530: 6965 722e 0a09 2020 4966 206b 6579 2069 ier... If key i │ │ │ -00230540: 6465 6e74 6966 6965 7220 6973 206e 6f74 dentifier is not │ │ │ -00230550: 2061 7661 696c 6162 6c65 2028 7468 6520 available (the │ │ │ -00230560: 6b65 7920 6861 7320 6e6f 2069 6465 6e74 key has no ident │ │ │ -00230570: 6966 6965 7220 6f72 206b 6579 2064 6f65 ifier or key doe │ │ │ -00230580: 7320 6e6f 7420 6578 6973 7429 2c0a 0920 s not exist),.. │ │ │ -00230590: 2061 204e 554c 4c20 7769 6c6c 2062 6520 a NULL will be │ │ │ -002305a0: 7265 7475 726e 6564 2e0a 2020 2020 2020 returned.. │ │ │ -002305b0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . Examples. Determi │ │ │ -00230650: 6e65 2074 6865 206b 6579 2069 6465 6e74 ne the key ident │ │ │ -00230660: 6966 6965 723c 2f74 6974 6c65 3e0a 2020 ifier. │ │ │ -00230670: 2020 2020 3c73 6372 6565 6e3e 3c21 5b43 selec │ │ │ -00230690: 7420 7865 6e63 5f67 6574 5f6b 6579 5f69 t xenc_get_key_i │ │ │ -002306a0: 6465 6e74 6966 6965 7220 2827 6d79 4b65 dentifier ('myKe │ │ │ -002306b0: 7927 293b 0a63 616c 6c72 6574 0a56 4152 y');.callret.VAR │ │ │ -002306c0: 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f 5f5f CHAR.___________ │ │ │ -002306d0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002306e0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -002306f0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00230700: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00230710: 5f5f 5f5f 0a0a 4c74 564a 4876 5658 4a46 ____..LtVJHvVXJF │ │ │ -00230720: 4676 7a52 6e66 7243 614b 6d64 7851 6147 FvzRnfrCaKmdxQaG │ │ │ -00230730: 513d 0a5d 5d3e 0a3c 2f73 6372 6565 6e3e Q=.]]>. │ │ │ -00230740: 0a20 2020 203c 2f65 7861 6d70 6c65 3e0a . . │ │ │ -00230750: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00230760: 3c72 6566 7365 6374 3120 6964 3d22 7365 . │ │ │ -00230790: 2020 2020 3c74 6974 6c65 3e53 6565 2041 See A │ │ │ -002307a0: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -002307b0: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b xenc_get_ke │ │ │ -002307f0: 795f 616c 676f 2829 3c2f 6675 6e63 7469 y_algo(). ge │ │ │ -00230850: 745f 6365 7274 6966 6963 6174 655f 696e t_certificate_in │ │ │ -00230860: 666f 2829 3c2f 6675 6e63 7469 6f6e 3e3c fo()< │ │ │ -00230870: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00230880: 3c2f 7265 6673 6563 7431 3e0a 3c2f 7265 ......)dem │ │ │ -002308a0: 6f2f 646f 6373 7263 2f66 756e 6372 6566 o/docsrc/funcref │ │ │ -002308b0: 2f78 656e 635f 6765 745f 6b65 795f 616c /xenc_get_key_al │ │ │ -002308c0: 676f 2e78 6d6c df00 000b 523c 3f78 6d6c go.xml....R... < │ │ │ -00230c80: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. xenc │ │ │ -00230ca0: 5f67 6574 5f6b 6579 5f61 6c67 6f3c 2f72 _get_key_algo. │ │ │ -00230cc0: 2020 3c72 6566 6d69 7363 696e 666f 3e68 h │ │ │ -00230cd0: 6173 683c 2f72 6566 6d69 7363 696e 666f ash. . │ │ │ -00230cf0: 203c 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -00230d00: 2020 3c72 6566 6e61 6d65 3e78 656e 635f xenc_ │ │ │ -00230d10: 6765 745f 6b65 795f 616c 676f 3c2f 7265 get_key_algo. Determine │ │ │ -00230d40: 2058 4d4c 2073 6967 6e61 7475 7265 2061 XML signature a │ │ │ -00230d50: 6c67 6f72 6974 686d 206f 6620 6120 6b65 lgorithm of a ke │ │ │ -00230d60: 793c 2f72 6566 7075 7270 6f73 653e 0a20 y. │ │ │ -00230d70: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -00230d80: 203c 7265 6673 796e 6f70 7369 7364 6976 . │ │ │ -00230dc0: 0a20 2020 2020 203c 6675 6e63 7072 6f74 . . varchar xenc_get │ │ │ -00230e20: 5f6b 6579 5f61 6c67 6f3c 2f66 756e 6374 _key_algo.. │ │ │ -00230e40: 3c70 6172 616d 6465 663e 696e 203c 7061 in key_name │ │ │ -00230e60: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -00230e70: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -00230e80: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -00230ec0: 203c 7265 6673 6563 7431 2069 643d 2264 . Description. The function is │ │ │ -00230f20: 2075 7365 6420 746f 2064 6574 6572 6d69 used to determi │ │ │ -00230f30: 6e65 2073 6967 6e69 6e67 2061 6c67 6f72 ne signing algor │ │ │ -00230f40: 6974 686d 2073 7570 706f 7274 6564 2062 ithm supported b │ │ │ -00230f50: 7920 6769 7665 6e20 6b65 792e 3c2f 7061 y given key.. . . │ │ │ -00230fa0: 203c 7469 746c 653e 5061 7261 6d65 7465 Paramete │ │ │ -00230fb0: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -00230fc0: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -00230fd0: 6b65 795f 6e61 6d65 3c2f 7469 746c 653e key_name │ │ │ -00230fe0: 0a09 3c70 6172 613e 4e61 6d65 206f 6620 ..Name of │ │ │ -00230ff0: 6120 6b65 7920 6672 6f6d 2075 7365 7227 a key from user' │ │ │ -00231000: 7320 7370 6163 652e 3c2f 7061 7261 3e0a s space.. │ │ │ -00231010: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ -00231020: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00231030: 3c72 6566 7365 6374 3120 6964 3d22 7265 Retu │ │ │ -00231060: 726e 2054 7970 6573 3c2f 7469 746c 653e rn Types │ │ │ -00231070: 0a20 2020 2020 203c 7061 7261 3e54 6865 . The │ │ │ -00231080: 2066 756e 6374 696f 6e20 7265 7475 726e function return │ │ │ -00231090: 7320 7374 7269 6e67 2063 6f6e 7461 696e s string contain │ │ │ -002310a0: 696e 6720 616c 676f 7269 7468 6d20 6964 ing algorithm id │ │ │ -002310b0: 656e 7469 6669 6572 200a 0920 2076 616c entifier .. val │ │ │ -002310c0: 7565 2061 7320 6465 7363 7269 6265 6420 ue as described │ │ │ -002310d0: 696e 200a 0920 203c 756c 696e 6b20 7572 in .. http://ww │ │ │ -00231110: 772e 7733 2e6f 7267 2f54 522f 786d 6c64 w.w3.org/TR/xmld │ │ │ -00231120: 7369 672d 636f 7265 3c2f 756c 696e 6b3e sig-core │ │ │ -00231130: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .. . . E │ │ │ -00231180: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ -00231190: 2020 2020 3c65 7861 6d70 6c65 2069 643d De │ │ │ -002311c0: 7465 726d 696e 6520 7369 676e 696e 6720 termine signing │ │ │ -002311d0: 616c 676f 7269 7468 6d20 6f66 2061 206b algorithm of a k │ │ │ -002311e0: 6579 3c2f 7469 746c 653e 0a20 2020 2020 ey. │ │ │ -002311f0: 203c 7363 7265 656e 3e3c 215b 4344 4154 select x │ │ │ -00231210: 656e 635f 6765 745f 6b65 795f 616c 676f enc_get_key_algo │ │ │ -00231220: 2028 276d 794b 6579 2729 3b0a 6361 6c6c ('myKey');.call │ │ │ -00231230: 7265 740a 5641 5243 4841 520a 5f5f 5f5f ret.VARCHAR.____ │ │ │ -00231240: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00231250: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00231260: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00231270: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00231280: 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a 0a68 7474 ___________..htt │ │ │ -00231290: 703a 2f2f 7777 772e 7733 2e6f 7267 2f32 p://www.w3.org/2 │ │ │ -002312a0: 3030 302f 3039 2f78 6d6c 6473 6967 2364 000/09/xmldsig#d │ │ │ -002312b0: 7361 2d73 6861 310a 5d5d 3e0a 3c2f 7363 sa-sha1.]]>.. . . . │ │ │ -00231310: 2020 203c 7469 746c 653e 5365 6520 416c See Al │ │ │ -00231320: 736f 3c2f 7469 746c 653e 0a20 2020 203c so. < │ │ │ -00231330: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para>dsig_templat │ │ │ -00231370: 655f 6578 7428 293c 2f66 756e 6374 696f e_ext() │ │ │ -00231390: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -002313d0: 7865 6e63 5f67 6574 5f6b 6579 5f69 6465 xenc_get_key_ide │ │ │ -002313e0: 6e74 6966 6965 7228 293c 2f66 756e 6374 ntifier(). │ │ │ -00231410: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 ..... │ │ │ -00231420: 0024 6465 6d6f 2f64 6f63 7372 632f 6675 .$demo/docsrc/fu │ │ │ -00231430: 6e63 7265 662f 7865 6e63 5f65 6e63 7279 ncref/xenc_encry │ │ │ -00231440: 7074 2e78 6d6c df00 0010 b53c 3f78 6d6c pt.xml........ . xenc_encr │ │ │ -00231820: 7970 743c 2f72 6566 656e 7472 7974 6974 ypt. hash. . . xenc_encrypt. Encrypt │ │ │ -002318b0: 616e 6420 6f70 7469 6f6e 616c 6c79 2073 and optionally s │ │ │ -002318c0: 6967 6e20 6120 534f 4150 206d 6573 7361 ign a SOAP messa │ │ │ -002318d0: 6765 3c2f 7265 6670 7572 706f 7365 3e0a ge. │ │ │ -002318e0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -002318f0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . │ │ │ -00231930: 2020 203c 6675 6e63 7072 6f74 6f74 7970 . │ │ │ -00231960: 2020 2020 3c66 756e 6364 6566 3e76 6172 var │ │ │ -00231970: 6368 6172 203c 6675 6e63 7469 6f6e 3e78 char x │ │ │ -00231980: 656e 635f 656e 6372 7970 743c 2f66 756e enc_encrypt │ │ │ -002319a0: 0a09 3c70 6172 616d 6465 663e 696e 203c ..in < │ │ │ -002319b0: 7061 7261 6d65 7465 723e 6d65 7373 6167 parameter>messag │ │ │ -002319c0: 653c 2f70 6172 616d 6574 6572 3e20 2076 e v │ │ │ -002319d0: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar..in │ │ │ -002319f0: 3c70 6172 616d 6574 6572 3e73 6f61 705f soap_ │ │ │ -00231a00: 7665 723c 2f70 6172 616d 6574 6572 3e20 ver │ │ │ -00231a10: 696e 743c 2f70 6172 616d 6465 663e 0a09 int.. │ │ │ -00231a20: 3c70 6172 616d 6465 663e 696e 203c 7061 in template │ │ │ -00231a40: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -00231a50: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -00231a60: 093c 7061 7261 6d64 6566 3e69 6e20 3c70 .in

    ns any..in │ │ │ -00231ab0: 7870 2d6e 3c2f 7061 7261 6d65 7465 723e xp-n │ │ │ -00231ac0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar..i │ │ │ -00231ae0: 6e20 3c70 6172 616d 6574 6572 3e6b 692d n ki- │ │ │ -00231af0: 6e3c 2f70 6172 616d 6574 6572 3e20 616e n an │ │ │ -00231b00: 793c 2f70 6172 616d 6465 663e 0a09 3c70 y..

    in what-n varchar │ │ │ -00231b40: 3c2f 7061 7261 6d64 6566 3e0a 093c 7061 .. ... . │ │ │ -00231b80: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ -00231bc0: 3c72 6566 7365 6374 3120 6964 3d22 6465 . Des │ │ │ -00231bf0: 6372 6970 7469 6f6e 3c2f 7469 746c 653e cription │ │ │ -00231c00: 0a20 2020 203c 7061 7261 3e45 6e63 7279 . Encry │ │ │ -00231c10: 7074 2053 4f41 5020 6d65 7373 6167 6520 pt SOAP message │ │ │ -00231c20: 616e 6420 6f70 7469 6f6e 616c 6c79 2061 and optionally a │ │ │ -00231c30: 7474 6163 6820 616e 2058 4d4c 2073 6967 ttach an XML sig │ │ │ -00231c40: 6e61 7475 7265 2e20 5468 6520 6b65 7973 nature. The keys │ │ │ -00231c50: 2061 7265 2072 6574 7269 6576 6564 2066 are retrieved f │ │ │ -00231c60: 726f 6d20 7468 650a 6b65 7920 7374 6f72 rom the.key stor │ │ │ -00231c70: 6520 6f66 2074 6865 2063 616c 6c69 6e67 e of the calling │ │ │ -00231c80: 2075 7365 7220 6163 636f 756e 742e 3c2f user account.. . . Parameters< │ │ │ -00231ce0: 2f74 6974 6c65 3e0a 2020 2020 3c72 6566 /title>. mes │ │ │ -00231d00: 7361 6765 3c2f 7469 746c 653e 0a20 2020 sage. │ │ │ -00231d10: 2020 203c 7061 7261 3e41 2073 7472 696e A strin │ │ │ -00231d20: 6720 636f 6e74 6169 6e69 6e67 2053 4f41 g containing SOA │ │ │ -00231d30: 5020 6d65 7373 6167 653c 2f70 6172 613e P message │ │ │ -00231d40: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ -00231d50: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00231d60: 7469 746c 653e 736f 6170 5f76 6572 3c2f title>soap_ver..SO │ │ │ -00231d80: 4150 2076 6572 7369 6f6e 2028 3131 203d AP version (11 = │ │ │ -00231d90: 2031 2e31 2c20 3130 203d 2031 2e30 2065 1.1, 10 = 1.0 e │ │ │ -00231da0: 7463 2e29 3c2f 7061 7261 3e0a 2020 2020 tc.). │ │ │ -00231db0: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00231dc0: 3c72 6566 7365 6374 323e 3c74 6974 6c65 template. a │ │ │ -00231df0: 7374 7269 6e67 2063 6f6e 7461 696e 696e string containin │ │ │ -00231e00: 6720 4469 6769 7461 6c20 7369 676e 6174 g Digital signat │ │ │ -00231e10: 7572 6520 7465 6d70 6c61 7465 2e3c 2f70 ure template.

    . . ns</ti │ │ │ -00231e50: 746c 653e 0a09 3c70 6172 613e 616e 2061 tle>..<para>an a │ │ │ -00231e60: 7272 6179 206f 6620 7374 7269 6e67 7320 rray of strings │ │ │ -00231e70: 636f 6e74 6169 6e69 6e67 2057 532d 5365 containing WS-Se │ │ │ -00231e80: 6375 7269 7479 2065 7874 656e 7369 6f6e curity extension │ │ │ -00231e90: 2061 6e64 2057 532d 5574 696c 6974 790a and WS-Utility. │ │ │ -00231ea0: 0976 6572 7369 6f6e 2069 6e66 6f72 6d61 .version informa │ │ │ -00231eb0: 7469 6f6e 2e3c 2f70 6172 613e 0a20 2020 tion.</para>. │ │ │ -00231ec0: 203c 2f72 6566 7365 6374 323e 0a20 2020 </refsect2>. │ │ │ -00231ed0: 203c 7265 6673 6563 7432 3e3c 7469 746c <refsect2><titl │ │ │ -00231ee0: 653e 7870 2d6e 3c2f 7469 746c 653e 0a09 e>xp-n.. │ │ │ -00231ef0: 3c70 6172 613e 5850 6174 6820 6578 7072 XPath expr │ │ │ -00231f00: 6573 7369 6f6e 2074 6f20 6c6f 6361 7465 ession to locate │ │ │ -00231f10: 206e 2d74 6820 7061 7274 206f 6620 7468 n-th part of th │ │ │ -00231f20: 6520 6d65 7373 6167 6520 746f 2062 6520 e message to be │ │ │ -00231f30: 656e 6372 7970 7465 643c 2f70 6172 613e encrypted │ │ │ -00231f40: 0a20 2020 203c 2f72 6566 7365 6374 323e . │ │ │ -00231f50: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00231f60: 7469 746c 653e 6b69 2d6e 3c2f 7469 746c title>ki-n. K │ │ │ -00231f80: 6579 2069 6e73 7461 6e63 6520 746f 2065 ey instance to e │ │ │ -00231f90: 6e63 7279 7074 2074 6865 2070 6172 743c ncrypt the part< │ │ │ -00231fa0: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>.
    . what │ │ │ -00231fd0: 2d6e 3c2f 7469 746c 653e 0a09 3c70 6172 -n..'Content' - th │ │ │ -00231ff0: 6520 636f 6e74 656e 7420 756e 6465 7220 e content under │ │ │ -00232000: 6c6f 6361 7465 6420 656c 656d 656e 7420 located element │ │ │ -00232010: 7769 6c6c 2062 6520 656e 6372 7970 7465 will be encrypte │ │ │ -00232020: 643b 2027 456c 656d 656e 7427 2074 6865 d; 'Element' the │ │ │ -00232030: 206c 6f63 6174 6564 2065 6c65 6d65 6e74 located element │ │ │ -00232040: 2061 6e64 2063 6f6e 7465 6e74 2077 696c and content wil │ │ │ -00232050: 6c20 6265 2065 6e63 7279 7074 6564 2e3c l be encrypted.< │ │ │ -00232060: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>.
    . . Re │ │ │ -002320b0: 7475 726e 2054 7970 6573 3c2f 7469 746c turn Types</titl │ │ │ -002320c0: 653e 0a20 2020 2020 203c 7061 7261 3e0a e>. <para>. │ │ │ -002320d0: 0920 204f 6e20 7375 6363 6573 7320 7468 . On success th │ │ │ -002320e0: 6520 6675 6e63 7469 6f6e 2077 696c 6c20 e function will │ │ │ -002320f0: 7265 7475 726e 2061 2073 7472 696e 6720 return a string │ │ │ -00232100: 636f 6e74 6169 6e69 6e67 2065 6e63 7279 containing encry │ │ │ -00232110: 7074 6564 2061 6e64 200a 0920 206f 7074 pted and .. opt │ │ │ -00232120: 696f 6e61 6c6c 7920 7369 676e 6564 2053 ionally signed S │ │ │ -00232130: 4f41 5020 6d65 7373 6167 652e 0a20 2020 OAP message.. │ │ │ -00232140: 2020 203c 2f70 6172 613e 0a20 203c 2f72 </para>. </r │ │ │ -00232150: 6566 7365 6374 313e 0a20 203c 7265 6673 efsect1>. <refs │ │ │ -00232160: 6563 7431 2069 643d 2265 7861 6d70 6c65 ect1 id="example │ │ │ -00232170: 735f 7865 6e63 5f65 6e63 7279 7074 223e s_xenc_encrypt"> │ │ │ -00232180: 0a20 2020 203c 7469 746c 653e 4578 616d . <title>Exam │ │ │ -00232190: 706c 6573 3c2f 7469 746c 653e 0a20 2020 ples. │ │ │ -002321a0: 203c 6578 616d 706c 6520 6964 3d22 6578 < │ │ │ -002321c0: 7469 746c 653e 456e 6372 7970 7469 6e67 title>Encrypting │ │ │ -002321d0: 2061 6e64 2073 6967 6e69 6e67 2053 4f41 and signing SOA │ │ │ -002321e0: 5020 6d65 7373 6167 653c 2f74 6974 6c65 P message. │ │ │ -00232200: 3c21 5b43 4441 5441 5b0a 0920 202e 2e2e .. . . . │ │ │ -00232350: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ -00232360: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -00232370: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ -00232380: 2266 6e5f 656e 6372 7970 7422 3e3c 6675 "fn_encrypt"><fu │ │ │ -00232390: 6e63 7469 6f6e 3e65 6e63 7279 7074 2829 nction>encrypt() │ │ │ -002323a0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e </function></lin │ │ │ -002323b0: 6b3e 3c2f 7061 7261 3e20 2020 200a 2020 k></para> . │ │ │ -002323c0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 <para><link li │ │ │ -002323d0: 6e6b 656e 643d 2266 6e5f 6465 6372 7970 nkend="fn_decryp │ │ │ -002323e0: 7422 3e3c 6675 6e63 7469 6f6e 3e64 6563 t"><function>dec │ │ │ -002323f0: 7279 7074 2829 3c2f 6675 6e63 7469 6f6e rypt()</function │ │ │ -00232400: 3e3c 2f6c 696e 6b3e 3c2f 7061 7261 3e20 ></link></para> │ │ │ -00232410: 2020 200a 2020 2020 3c70 6172 613e 3c6c . <para><l │ │ │ -00232420: 696e 6b20 6c69 6e6b 656e 643d 2266 6e5f ink linkend="fn_ │ │ │ -00232430: 6473 6967 5f74 656d 706c 6174 655f 6578 dsig_template_ex │ │ │ -00232440: 7422 3e3c 6675 6e63 7469 6f6e 3e64 7369 t"><function>dsi │ │ │ -00232450: 675f 7465 6d70 6c61 7465 5f65 7874 2829 g_template_ext() │ │ │ -00232460: 3c2f 6675 6e63 7469 6f6e 3e3c 2f6c 696e </function></lin │ │ │ -00232470: 6b3e 3c2f 7061 7261 3e0a 2020 2020 3c70 k></para>. <p │ │ │ -00232480: 6172 613e 3c6c 696e 6b20 6c69 6e6b 656e ara><link linken │ │ │ -00232490: 643d 2266 6e5f 7865 6e63 5f6b 6579 5f69 d="fn_xenc_key_i │ │ │ -002324a0: 6e73 745f 6372 6561 7465 223e 3c66 756e nst_create"><fun │ │ │ -002324b0: 6374 696f 6e3e 7865 6e63 5f6b 6579 5f69 ction>xenc_key_i │ │ │ -002324c0: 6e73 745f 6372 6561 7465 2829 3c2f 6675 nst_create()</fu │ │ │ -002324d0: 6e63 7469 6f6e 3e3c 2f6c 696e 6b3e 3c2f nction></link></ │ │ │ -002324e0: 7061 7261 3e0a 2020 3c2f 7265 6673 6563 para>. </refsec │ │ │ -002324f0: 7431 3e0a 3c2f 7265 6665 6e74 7279 3e0a t1>.</refentry>. │ │ │ -00232500: b600 0000 2d64 656d 6f2f 646f 6373 7263 ....-demo/docsrc │ │ │ -00232510: 2f66 756e 6372 6566 2f78 656e 635f 6465 /funcref/xenc_de │ │ │ -00232520: 6c65 7465 5f74 656d 705f 6b65 7973 2e78 lete_temp_keys.x │ │ │ -00232530: 6d6c df00 000a d43c 3f78 6d6c 2076 6572 ml.....<?xml ver │ │ │ -00232540: 7369 6f6e 3d22 312e 3022 2065 6e63 6f64 sion="1.0" encod │ │ │ -00232550: 696e 673d 2249 534f 2d38 3835 392d 3122 ing="ISO-8859-1" │ │ │ -00232560: 3f3e 0a3c 212d 2d0a 202d 2020 0a20 2d20 ?>.<!--. - . - │ │ │ -00232570: 2054 6869 7320 6669 6c65 2069 7320 7061 This file is pa │ │ │ -00232580: 7274 206f 6620 7468 6520 4f70 656e 4c69 rt of the OpenLi │ │ │ -00232590: 6e6b 2053 6f66 7477 6172 6520 5669 7274 nk Software Virt │ │ │ -002325a0: 756f 736f 204f 7065 6e2d 536f 7572 6365 uoso Open-Source │ │ │ -002325b0: 2028 564f 5329 0a20 2d20 2070 726f 6a65 (VOS). - proje │ │ │ -002325c0: 6374 2e0a 202d 2020 0a20 2d20 2043 6f70 ct.. - . - Cop │ │ │ -002325d0: 7972 6967 6874 2028 4329 2031 3939 382d yright (C) 1998- │ │ │ -002325e0: 3230 3234 204f 7065 6e4c 696e 6b20 536f 2024 OpenLink So │ │ │ -002325f0: 6674 7761 7265 0a20 2d20 200a 202d 2020 ftware. - . - │ │ │ -00232600: 5468 6973 2070 726f 6a65 6374 2069 7320 This project is │ │ │ -00232610: 6672 6565 2073 6f66 7477 6172 653b 2079 free software; y │ │ │ -00232620: 6f75 2063 616e 2072 6564 6973 7472 6962 ou can redistrib │ │ │ -00232630: 7574 6520 6974 2061 6e64 2f6f 7220 6d6f ute it and/or mo │ │ │ -00232640: 6469 6679 2069 740a 202d 2020 756e 6465 dify it. - unde │ │ │ -00232650: 7220 7468 6520 7465 726d 7320 6f66 2074 r the terms of t │ │ │ -00232660: 6865 2047 4e55 2047 656e 6572 616c 2050 he GNU General P │ │ │ -00232670: 7562 6c69 6320 4c69 6365 6e73 6520 6173 ublic License as │ │ │ -00232680: 2070 7562 6c69 7368 6564 2062 7920 7468 published by th │ │ │ -00232690: 650a 202d 2020 4672 6565 2053 6f66 7477 e. - Free Softw │ │ │ -002326a0: 6172 6520 466f 756e 6461 7469 6f6e 3b20 are Foundation; │ │ │ -002326b0: 6f6e 6c79 2076 6572 7369 6f6e 2032 206f only version 2 o │ │ │ -002326c0: 6620 7468 6520 4c69 6365 6e73 652c 2064 f the License, d │ │ │ -002326d0: 6174 6564 204a 756e 6520 3139 3931 2e0a ated June 1991.. │ │ │ -002326e0: 202d 2020 0a20 2d20 2054 6869 7320 7072 - . - This pr │ │ │ -002326f0: 6f67 7261 6d20 6973 2064 6973 7472 6962 ogram is distrib │ │ │ -00232700: 7574 6564 2069 6e20 7468 6520 686f 7065 uted in the hope │ │ │ -00232710: 2074 6861 7420 6974 2077 696c 6c20 6265 that it will be │ │ │ -00232720: 2075 7365 6675 6c2c 2062 7574 0a20 2d20 useful, but. - │ │ │ -00232730: 2057 4954 484f 5554 2041 4e59 2057 4152 WITHOUT ANY WAR │ │ │ -00232740: 5241 4e54 593b 2077 6974 686f 7574 2065 RANTY; without e │ │ │ -00232750: 7665 6e20 7468 6520 696d 706c 6965 6420 ven the implied │ │ │ -00232760: 7761 7272 616e 7479 206f 660a 202d 2020 warranty of. - │ │ │ -00232770: 4d45 5243 4841 4e54 4142 494c 4954 5920 MERCHANTABILITY │ │ │ -00232780: 6f72 2046 4954 4e45 5353 2046 4f52 2041 or FITNESS FOR A │ │ │ -00232790: 2050 4152 5449 4355 4c41 5220 5055 5250 PARTICULAR PURP │ │ │ -002327a0: 4f53 452e 2053 6565 2074 6865 2047 4e55 OSE. See the GNU │ │ │ -002327b0: 0a20 2d20 2047 656e 6572 616c 2050 7562 . - General Pub │ │ │ -002327c0: 6c69 6320 4c69 6365 6e73 6520 666f 7220 lic License for │ │ │ -002327d0: 6d6f 7265 2064 6574 6169 6c73 2e0a 202d more details.. - │ │ │ -002327e0: 2020 0a20 2d20 2059 6f75 2073 686f 756c . - You shoul │ │ │ -002327f0: 6420 6861 7665 2072 6563 6569 7665 6420 d have received │ │ │ -00232800: 6120 636f 7079 206f 6620 7468 6520 474e a copy of the GN │ │ │ -00232810: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ -00232820: 204c 6963 656e 7365 2061 6c6f 6e67 0a20 License along. │ │ │ -00232830: 2d20 2077 6974 6820 7468 6973 2070 726f - with this pro │ │ │ -00232840: 6772 616d 3b20 6966 206e 6f74 2c20 7772 gram; if not, wr │ │ │ -00232850: 6974 6520 746f 2074 6865 2046 7265 6520 ite to the Free │ │ │ -00232860: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ -00232870: 696f 6e2c 2049 6e63 2e2c 0a20 2d20 2035 ion, Inc.,. - 5 │ │ │ -00232880: 3120 4672 616e 6b6c 696e 2053 742c 2046 1 Franklin St, F │ │ │ -00232890: 6966 7468 2046 6c6f 6f72 2c20 426f 7374 ifth Floor, Bost │ │ │ -002328a0: 6f6e 2c20 4d41 2030 3231 3130 2d31 3330 on, MA 02110-130 │ │ │ -002328b0: 3120 5553 410a 202d 2020 0a20 2d20 200a 1 USA. - . - . │ │ │ -002328c0: 2d2d 3e0a 3c72 6566 656e 7472 7920 6964 -->.<refentry id │ │ │ -002328d0: 3d22 666e 5f78 656e 635f 6465 6c65 7465 ="fn_xenc_delete │ │ │ -002328e0: 5f74 656d 705f 6b65 7973 223e 0a20 203c _temp_keys">. < │ │ │ -002328f0: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. <re │ │ │ -00232900: 6665 6e74 7279 7469 746c 653e 7865 6e63 fentrytitle>xenc │ │ │ -00232910: 5f64 656c 6574 655f 7465 6d70 5f6b 6579 _delete_temp_key │ │ │ -00232920: 733c 2f72 6566 656e 7472 7974 6974 6c65 s</refentrytitle │ │ │ -00232930: 3e0a 2020 2020 3c72 6566 6d69 7363 696e >. <refmiscin │ │ │ -00232940: 666f 3e68 6173 683c 2f72 6566 6d69 7363 fo>hash</refmisc │ │ │ -00232950: 696e 666f 3e0a 2020 3c2f 7265 666d 6574 info>. </refmet │ │ │ -00232960: 613e 0a20 203c 7265 666e 616d 6564 6976 a>. <refnamediv │ │ │ -00232970: 3e0a 2020 2020 3c72 6566 6e61 6d65 3e78 >. <refname>x │ │ │ -00232980: 656e 635f 6465 6c65 7465 5f74 656d 705f enc_delete_temp_ │ │ │ -00232990: 6b65 7973 3c2f 7265 666e 616d 653e 0a20 keys</refname>. │ │ │ -002329a0: 2020 203c 7265 6670 7572 706f 7365 3e52 <refpurpose>R │ │ │ -002329b0: 656d 6f76 6520 7468 6520 7465 6d70 6f72 emove the tempor │ │ │ -002329c0: 6172 7920 6b65 7973 2066 726f 6d20 7573 ary keys from us │ │ │ -002329d0: 6572 2773 2073 7061 6365 3c2f 7265 6670 er's space</refp │ │ │ -002329e0: 7572 706f 7365 3e0a 2020 3c2f 7265 666e urpose>. </refn │ │ │ -002329f0: 616d 6564 6976 3e0a 2020 3c72 6566 7379 amediv>. <refsy │ │ │ -00232a00: 6e6f 7073 6973 6469 763e 0a20 2020 203c nopsisdiv>. < │ │ │ -00232a10: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ -00232a20: 2266 7379 6e5f 7865 6e63 5f64 656c 6574 "fsyn_xenc_delet │ │ │ -00232a30: 655f 7465 6d70 5f6b 6579 7322 3e0a 2020 e_temp_keys">. │ │ │ -00232a40: 2020 2020 3c66 756e 6370 726f 746f 7479 <funcprototy │ │ │ -00232a50: 7065 2069 643d 2266 7072 6f74 6f5f 7865 pe id="fproto_xe │ │ │ -00232a60: 6e63 5f64 656c 6574 655f 7465 6d70 5f6b nc_delete_temp_k │ │ │ -00232a70: 6579 7322 3e0a 2020 2020 2020 2020 3c66 eys">. <f │ │ │ -00232a80: 756e 6364 6566 3e69 6e74 203c 6675 6e63 uncdef>int <func │ │ │ -00232a90: 7469 6f6e 3e78 656e 635f 6465 6c65 7465 tion>xenc_delete │ │ │ -00232aa0: 5f74 656d 705f 6b65 7973 3c2f 6675 6e63 _temp_keys</func │ │ │ -00232ab0: 7469 6f6e 3e3c 2f66 756e 6364 6566 3e0a tion></funcdef>. │ │ │ -00232ac0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 </funcprot │ │ │ -00232ad0: 6f74 7970 653e 0a20 2020 203c 2f66 756e otype>. </fun │ │ │ -00232ae0: 6373 796e 6f70 7369 733e 0a20 203c 2f72 csynopsis>. </r │ │ │ -00232af0: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ -00232b00: 203c 7265 6673 6563 7431 2069 643d 2264 <refsect1 id="d │ │ │ -00232b10: 6573 635f 7865 6e63 5f64 656c 6574 655f esc_xenc_delete_ │ │ │ -00232b20: 7465 6d70 5f6b 6579 7322 3e0a 2020 2020 temp_keys">. │ │ │ -00232b30: 3c74 6974 6c65 3e44 6573 6372 6970 7469 <title>Descripti │ │ │ -00232b40: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ -00232b50: 7061 7261 3e0a 0957 6865 6e20 7369 676e para>..When sign │ │ │ -00232b60: 696e 6720 616e 2058 4d4c 2064 6f63 756d ing an XML docum │ │ │ -00232b70: 656e 7420 6f72 2064 6f69 6e67 2074 6865 ent or doing the │ │ │ -00232b80: 2072 6576 6572 7365 2077 6f72 6b20 0a09 reverse work .. │ │ │ -00232b90: 6c69 6b65 2076 6572 6966 6963 6174 696f like verificatio │ │ │ -00232ba0: 6e20 6574 632e 206e 756d 6265 7220 6f66 n etc. number of │ │ │ -00232bb0: 2074 656d 706f 7261 7279 206b 6579 7320 temporary keys │ │ │ -00232bc0: 6172 6520 6372 6561 7465 640a 2020 2020 are created. │ │ │ -00232bd0: 2020 2020 696e 2075 7365 7227 7320 7370 in user's sp │ │ │ -00232be0: 6163 652e 2054 6865 7365 206b 6579 7320 ace. These keys │ │ │ -00232bf0: 6174 2073 6f6d 6520 706f 696e 7420 6d61 at some point ma │ │ │ -00232c00: 7920 6e6f 7420 6e65 6564 6564 200a 0961 y not needed ..a │ │ │ -00232c10: 6e79 6d6f 7265 2c20 736f 2074 6865 7920 nymore, so they │ │ │ -00232c20: 6361 6e20 6265 2072 656d 6f76 6564 2066 can be removed f │ │ │ -00232c30: 726f 6d20 6d65 6d6f 7279 2e09 0a20 2020 rom memory... │ │ │ -00232c40: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . . Return │ │ │ -00232c90: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ -00232ca0: 2020 2020 3c70 6172 613e 5468 6520 6675 The fu │ │ │ -00232cb0: 6e63 7469 6f6e 2072 6574 7572 6e73 206e nction returns n │ │ │ -00232cc0: 756d 6265 7220 6f66 2074 656d 7020 6b65 umber of temp ke │ │ │ -00232cd0: 7973 2072 656d 6f76 6564 2e3c 2f70 6172 ys removed.. │ │ │ -00232cf0: 0a20 203c 7265 6673 6563 7431 2069 643d . . Exa │ │ │ -00232d30: 6d70 6c65 733c 2f74 6974 6c65 3e0a 2020 mples. │ │ │ -00232d40: 2020 3c65 7861 6d70 6c65 2069 643d 2265 │ │ │ -00232d70: 4465 6c65 7465 2074 656d 706f 7261 7279 Delete temporary │ │ │ -00232d80: 206b 6579 733c 2f74 6974 6c65 3e0a 093c keys..< │ │ │ -00232d90: 7363 7265 656e 3e3c 215b 4344 4154 415b screen> select xen │ │ │ -00232db0: 635f 6465 6c65 7465 5f74 656d 705f 6b65 c_delete_temp_ke │ │ │ -00232dc0: 7973 2028 293b 0a63 616c 6c72 6574 0a56 ys ();.callret.V │ │ │ -00232dd0: 4152 4348 4152 0a5f 5f5f 5f5f 5f5f 5f5f ARCHAR._________ │ │ │ -00232de0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00232df0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00232e00: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00232e10: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -00232e20: 5f5f 5f5f 5f5f 0a0a 310a 5d5d 3e0a 3c2f ______..1.]]>.. . . . │ │ │ -00232e90: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ -00232ea0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -00232ed0: 3c66 756e 6374 696f 6e3e 7865 6e63 5f64 xenc_d │ │ │ -00232ee0: 6563 7279 7074 5f73 6f61 7028 293c 2f66 ecrypt_soap()< │ │ │ -00232f00: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. xenc_key │ │ │ -00232f50: 5f33 6465 735f 7261 6e64 5f63 7265 6174 _3des_rand_creat │ │ │ -00232f60: 6528 293c 2f66 756e 6374 696f 6e3e 3c2f e(). │ │ │ -00232f80: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e xen │ │ │ -00232fc0: 635f 6b65 795f 6165 735f 7261 6e64 5f63 c_key_aes_rand_c │ │ │ -00232fd0: 7265 6174 6528 293c 2f66 756e 6374 696f reate() │ │ │ -00232ff0: 0a20 203c 2f72 6566 7365 6374 313e 0a3c . .< │ │ │ -00233000: 2f72 6566 656e 7472 793e 0ab6 0000 0029 /refentry>.....) │ │ │ -00233010: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -00233020: 7265 662f 7865 6e63 5f64 6563 7279 7074 ref/xenc_decrypt │ │ │ -00233030: 5f73 6f61 702e 786d 6cdf 0000 12a9 3c3f _soap.xml........ │ │ │ -002333f0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ -00233400: 3c72 6566 656e 7472 7974 6974 6c65 3e78 x │ │ │ -00233410: 656e 635f 6465 6372 7970 745f 736f 6170 enc_decrypt_soap │ │ │ -00233420: 3c2f 7265 6665 6e74 7279 7469 746c 653e │ │ │ -00233430: 0a20 2020 203c 7265 666d 6973 6369 6e66 . hash. . │ │ │ -00233470: 0a20 2020 203c 7265 666e 616d 653e 7865 . xe │ │ │ -00233480: 6e63 5f64 6563 7279 7074 5f73 6f61 703c nc_decrypt_soap< │ │ │ -00233490: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Decryp │ │ │ -002334b0: 7420 616e 6420 7665 7269 6679 2061 2053 t and verify a S │ │ │ -002334c0: 4f41 5020 6d65 7373 6167 653c 2f72 6566 OAP message. . . │ │ │ -00233500: 3c66 756e 6373 796e 6f70 7369 7320 6964 . │ │ │ -00233530: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ -00233560: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ -00233570: 7661 7263 6861 7220 3c66 756e 6374 696f varchar xenc_decrypt_s │ │ │ -00233590: 6f61 703c 2f66 756e 6374 696f 6e3e 3c2f oap..in xml_text varchar..in soap_version< │ │ │ -00233610: 2f70 6172 616d 6574 6572 3e20 696e 743c /parameter> int< │ │ │ -00233620: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..in validate_fla │ │ │ -00233650: 673c 2f70 6172 616d 6574 6572 3e20 696e g in │ │ │ -00233660: 743c 2f70 6172 616d 6465 663e 0a09 3c70 t..

    in encoding varch │ │ │ -002336a0: 6172 3c2f 7061 7261 6d64 6566 3e0a 093c ar..< │ │ │ -002336b0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in lang varchar< │ │ │ -002336e0: 2f70 6172 616d 6465 663e 0a09 3c70 6172 /paramdef>..in opts any..o │ │ │ -00233730: 7574 203c 7061 7261 6d65 7465 723e 6b65 ut ke │ │ │ -00233740: 7973 3c2f 7061 7261 6d65 7465 723e 2061 ys a │ │ │ -00233750: 6e79 3c2f 7061 7261 6d64 6566 3e0a 2020 ny. │ │ │ -00233760: 2020 2020 3c2f 6675 6e63 7072 6f74 6f74 . . . < │ │ │ -002337a0: 7265 6673 6563 7431 2069 643d 2264 6573 refsect1 id="des │ │ │ -002337b0: 635f 7865 6e63 5f64 6563 7279 7074 5f73 c_xenc_decrypt_s │ │ │ -002337c0: 6f61 7022 3e0a 2020 2020 3c74 6974 6c65 oap">. Description</ti │ │ │ -002337e0: 746c 653e 0a20 2020 203c 7061 7261 3e0a tle>. <para>. │ │ │ -002337f0: 0954 6865 2066 756e 6374 696f 6e20 6973 .The function is │ │ │ -00233800: 2075 7365 6420 746f 2064 6563 7279 7074 used to decrypt │ │ │ -00233810: 2061 6e64 206f 7074 696f 6e61 6c6c 7920 and optionally │ │ │ -00233820: 7665 7269 6679 2073 6967 6e61 7475 7265 verify signature │ │ │ -00233830: 0a09 2864 6570 656e 6473 206f 6620 6120 ..(depends of a │ │ │ -00233840: 3c70 6172 616d 6574 6572 3e76 616c 6964 <parameter>valid │ │ │ -00233850: 6174 655f 666c 6167 3c2f 7061 7261 6d65 ate_flag</parame │ │ │ -00233860: 7465 723e 2070 6172 616d 6574 6572 2920 ter> parameter) │ │ │ -00233870: 6f66 2061 2053 4f41 5020 6d65 7373 6167 of a SOAP messag │ │ │ -00233880: 652e 0a20 2020 203c 2f70 6172 613e 0a20 e.. </para>. │ │ │ -00233890: 203c 2f72 6566 7365 6374 313e 0a20 203c </refsect1>. < │ │ │ -002338a0: 7265 6673 6563 7431 2069 643d 2270 6172 refsect1 id="par │ │ │ -002338b0: 616d 735f 7865 6e63 5f64 6563 7279 7074 ams_xenc_decrypt │ │ │ -002338c0: 5f73 6f61 7022 3e0a 2020 2020 3c74 6974 _soap">. <tit │ │ │ -002338d0: 6c65 3e50 6172 616d 6574 6572 733c 2f74 le>Parameters</t │ │ │ -002338e0: 6974 6c65 3e0a 2020 2020 3c72 6566 7365 itle>. <refse │ │ │ -002338f0: 6374 323e 3c74 6974 6c65 3e78 6d6c 5f74 ct2><title>xml_t │ │ │ -00233900: 6578 743c 2f74 6974 6c65 3e0a 2020 2020 ext. │ │ │ -00233910: 2020 3c70 6172 613e 4120 7374 7269 6e67 A string │ │ │ -00233920: 2063 6f6e 7461 696e 696e 6720 534f 4150 containing SOAP │ │ │ -00233930: 206d 6573 7361 6765 3c2f 7061 7261 3e0a message. │ │ │ -00233940: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ -00233950: 2020 2020 3c72 6566 7365 6374 323e 3c74 soap_versio │ │ │ -00233970: 6e3c 2f74 6974 6c65 3e0a 093c 7061 7261 n..An integer indi │ │ │ -00233990: 6361 7469 6f6e 2053 4f41 5020 7665 7273 cation SOAP vers │ │ │ -002339a0: 696f 6e20 2831 3120 666f 7220 7631 2e31 ion (11 for v1.1 │ │ │ -002339b0: 2c20 3130 2066 6f72 2031 2e30 2065 7463 , 10 for 1.0 etc │ │ │ -002339c0: 293c 2f70 6172 613e 0a20 2020 203c 2f72 ). . va │ │ │ -002339f0: 6c69 6461 7465 5f66 6c61 673c 2f74 6974 lidate_flag</tit │ │ │ -00233a00: 6c65 3e0a 093c 7061 7261 3e42 6974 206d le>..<para>Bit m │ │ │ -00233a10: 6173 6b20 666c 6167 2e20 5365 6520 6265 ask flag. See be │ │ │ -00233a20: 6c6f 7720 666f 7220 6465 7461 696c 732e low for details. │ │ │ -00233a30: 3c2f 7061 7261 3e0a 093c 7369 6d70 6c65 </para>..<simple │ │ │ -00233a40: 6c69 7374 3e0a 0920 2020 203c 6d65 6d62 list>.. <memb │ │ │ -00233a50: 6572 3e62 6974 2030 2061 6e64 2031 203a er>bit 0 and 1 : │ │ │ -00233a60: 2030 3020 2d20 646f 206e 6f74 2076 616c 00 - do not val │ │ │ -00233a70: 6964 6174 652c 2030 3120 2864 6563 696d idate, 01 (decim │ │ │ -00233a80: 616c 2031 2920 2d20 7661 6c69 6461 7465 al 1) - validate │ │ │ -00233a90: 2c20 3130 2028 6465 6369 6d61 6c20 3229 , 10 (decimal 2) │ │ │ -00233aa0: 202d 2076 616c 6964 6174 6520 6966 2073 - validate if s │ │ │ -00233ab0: 6967 6e61 7475 7265 2065 7869 7374 733c ignature exists< │ │ │ -00233ac0: 2f6d 656d 6265 723e 0a09 2020 2020 3c6d /member>.. <m │ │ │ -00233ad0: 656d 6265 723e 6269 7420 3220 3a20 3130 ember>bit 2 : 10 │ │ │ -00233ae0: 3020 2864 6563 696d 616c 2034 2920 2d20 0 (decimal 4) - │ │ │ -00233af0: 7472 7920 746f 2064 6563 6f64 652c 2064 try to decode, d │ │ │ -00233b00: 6f20 6e6f 7420 7369 676e 616c 2065 7272 o not signal err │ │ │ -00233b10: 6f72 2069 6620 5753 2d53 6563 7572 6974 or if WS-Securit │ │ │ -00233b20: 7920 6973 206e 6f74 2073 7570 706c 6965 y is not supplie │ │ │ -00233b30: 643c 2f6d 656d 6265 723e 0a09 3c2f 7369 d</member>..</si │ │ │ -00233b40: 6d70 6c65 6c69 7374 3e0a 0a20 2020 203c mplelist>.. < │ │ │ -00233b50: 2f72 6566 7365 6374 323e 0a20 2020 203c /refsect2>. < │ │ │ -00233b60: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2><title> │ │ │ -00233b70: 656e 636f 6469 6e67 3c2f 7469 746c 653e encoding │ │ │ -00233b80: 0a09 3c70 6172 613e 5468 6520 6d65 7373 ..The mess │ │ │ -00233b90: 6167 6520 283c 7061 7261 6d65 7465 723e age ( │ │ │ -00233ba0: 786d 6c5f 7465 7874 3c2f 7061 7261 6d65 xml_text) character │ │ │ -00233bc0: 656e 636f 6469 6e67 3c2f 7061 7261 3e0a encoding. │ │ │ -00233bd0: 2020 2020 3c2f 7265 6673 6563 7432 3e0a . │ │ │ -00233be0: 2020 2020 3c72 6566 7365 6374 323e 3c74 lang..The mes │ │ │ -00233c10: 7361 6765 2028 3c70 6172 616d 6574 6572 sage (xml_text) language< │ │ │ -00233c40: 2f70 6172 613e 0a20 2020 203c 2f72 6566 /para>. . opts │ │ │ -00233c70: 3c2f 7469 746c 653e 0a09 3c70 6172 613e .. │ │ │ -00233c80: 4120 7665 6374 6f72 2063 6f6e 7461 696e A vector contain │ │ │ -00233c90: 696e 6720 6f70 7469 6f6e 7320 666f 7220 ing options for │ │ │ -00233ca0: 5573 6572 204e 616d 6520 746f 6b65 6e20 User Name token │ │ │ -00233cb0: 7072 6f66 696c 652e 0a09 2020 2020 466f profile... Fo │ │ │ -00233cc0: 7220 6578 616d 706c 6520 3a20 7665 6374 r example : vect │ │ │ -00233cd0: 6f72 2028 2755 7365 726e 616d 6554 6f6b or ('UsernameTok │ │ │ -00233ce0: 656e 272c 2076 6563 746f 7220 2827 6c61 en', vector ('la │ │ │ -00233cf0: 6265 6c27 2c20 276c 6162 3127 2c20 276b bel', 'lab1', 'k │ │ │ -00233d00: 6579 416c 676f 7269 7468 6d27 202c 2027 eyAlgorithm' , ' │ │ │ -00233d10: 5b33 6465 7320 616c 676f 2075 7269 5d27 [3des algo uri]' │ │ │ -00233d20: 2929 0a09 3c2f 7061 7261 3e0a 2020 2020 ))... │ │ │ -00233d30: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00233d40: 3c72 6566 7365 6374 323e 3c74 6974 6c65 keys..< │ │ │ -00233d60: 7061 7261 3e69 6620 7375 7070 6c69 6564 para>if supplied │ │ │ -00233d70: 2074 6865 2070 6172 616d 6574 6572 2077 the parameter w │ │ │ -00233d80: 696c 6c20 6265 2073 6574 2077 6974 6820 ill be set with │ │ │ -00233d90: 6b65 7973 206e 616d 6573 2075 7365 6420 keys names used │ │ │ -00233da0: 666f 7220 6465 6372 7970 7469 6f6e 2061 for decryption a │ │ │ -00233db0: 6e64 2073 6967 6e61 7475 7265 2076 6572 nd signature ver │ │ │ -00233dc0: 6966 6963 6174 696f 6e2e 0a09 2020 2020 ification... │ │ │ -00233dd0: 5468 6520 7374 7275 6374 7572 6520 6973 The structure is │ │ │ -00233de0: 2061 7320 666f 6c6c 6f77 7320 3a20 7665 as follows : ve │ │ │ -00233df0: 6374 6f72 2028 7665 6374 6f72 2028 5b65 ctor (vector ([e │ │ │ -00233e00: 6e63 2d6b 6579 315d 2c5b 656e 632d 6b65 nc-key1],[enc-ke │ │ │ -00233e10: 7932 5d2c 2e2e 2e29 2c20 7665 6374 6f72 y2],...), vector │ │ │ -00233e20: 2028 275b 7369 676e 696e 6720 746f 6b65 ('[signing toke │ │ │ -00233e30: 6e20 6e61 6d65 5d27 2c20 275b 6d61 7463 n name]', '[matc │ │ │ -00233e40: 6869 6e67 2074 6f6b 656e 5d27 2929 2e20 hing token]')). │ │ │ -00233e50: 5768 6572 6520 656e 632d 6b65 7920 6973 Where enc-key is │ │ │ -00233e60: 2061 206b 6579 2075 7365 6420 746f 2064 a key used to d │ │ │ -00233e70: 6563 7279 7074 2074 6865 206d 6573 7361 ecrypt the messa │ │ │ -00233e80: 6765 2066 7261 676d 656e 743b 2027 5b73 ge fragment; '[s │ │ │ -00233e90: 6967 6e69 6e67 2074 6f6b 656e 206e 616d igning token nam │ │ │ -00233ea0: 655d 2720 6973 2074 6865 2074 656d 706f e]' is the tempo │ │ │ -00233eb0: 7261 7279 206b 6579 2075 7365 6420 746f rary key used to │ │ │ -00233ec0: 2076 616c 6964 6174 6520 7468 6520 7369 validate the si │ │ │ -00233ed0: 676e 6174 7572 6520 616e 6420 275b 6d61 gnature and '[ma │ │ │ -00233ee0: 7463 6869 6e67 2074 6f6b 656e 5d27 2069 tching token]' i │ │ │ -00233ef0: 7320 7468 6520 746f 6b65 6e20 286b 6579 s the token (key │ │ │ -00233f00: 2920 6672 6f6d 2075 7365 7227 7320 7370 ) from user's sp │ │ │ -00233f10: 6163 6520 7468 6174 206d 6174 6368 6573 ace that matches │ │ │ -00233f20: 2074 6865 2073 6967 6e69 6e67 2074 6f6b the signing tok │ │ │ -00233f30: 656e 2e0a 093c 2f70 6172 613e 0a20 2020 en.... │ │ │ -00233f40: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ -00233f50: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Return │ │ │ -00233f90: 5479 7065 733c 2f74 6974 6c65 3e0a 2020 Types. │ │ │ -00233fa0: 2020 2020 3c70 6172 613e 4f6e 2073 7563 On suc │ │ │ -00233fb0: 6365 7373 2074 6865 2066 756e 6374 696f cess the functio │ │ │ -00233fc0: 6e20 7265 7475 726e 7320 6465 6372 7970 n returns decryp │ │ │ -00233fd0: 7465 6420 534f 4150 206d 6573 7361 6765 ted SOAP message │ │ │ -00233fe0: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .. . . E │ │ │ -00234030: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ -00234040: 2020 2020 3c65 7861 6d70 6c65 2069 643d De │ │ │ -00234070: 6372 7970 7469 6e67 2053 4f41 5020 6d65 crypting SOAP me │ │ │ -00234080: 7373 6167 653c 2f74 6974 6c65 3e0a 2020 ssage. │ │ │ -00234090: 2020 2020 3c73 6372 6565 6e3e 3c21 5b43 .. │ │ │ -00234210: 3c2f 6578 616d 706c 653e 0a20 203c 2f72 . . . │ │ │ -00234260: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ -00234270: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . xenc_encryp │ │ │ -002342b0: 7428 293c 2f66 756e 6374 696f 6e3e 3c2f t(). < │ │ │ -002342d0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>......#demo │ │ │ -002342f0: 2f64 6f63 7372 632f 6675 6e63 7265 662f /docsrc/funcref/ │ │ │ -00234300: 7865 6e63 5f62 6e32 6465 632e 786d 6cdf xenc_bn2dec.xml. │ │ │ -00234310: 0000 0785 3c3f 786d 6c20 7665 7273 696f ..... │ │ │ -00234340: 3c21 2d2d 0a20 200a 2020 5468 6973 2066 .. . xenc_bn2d │ │ │ -002346f0: 6563 3c2f 7265 6665 6e74 7279 7469 746c ec. hash. . . │ │ │ -00234750: 7865 6e63 5f62 6e32 6465 633c 2f72 6566 xenc_bn2dec. Prints as │ │ │ -00234780: 6120 7374 7269 6e67 2061 2062 6967 206e a string a big n │ │ │ -00234790: 756d 6265 7220 7365 7269 616c 697a 6564 umber serialized │ │ │ -002347a0: 2061 7320 6269 6e61 7279 2075 7369 6e67 as binary using │ │ │ -002347b0: 2062 6173 6536 3420 656e 636f 6469 6e67 base64 encoding │ │ │ -002347c0: 2e3c 2f72 6566 7075 7270 6f73 653e 0a20 .. │ │ │ -002347d0: 203c 2f72 6566 6e61 6d65 6469 763e 0a20 . │ │ │ -002347e0: 203c 7265 6673 796e 6f70 7369 7364 6976 . . │ │ │ -00234820: 203c 6675 6e63 7072 6f74 6f74 7970 6520 . │ │ │ -00234850: 203c 6675 6e63 6465 663e 3c66 756e 6374 xenc_bn2dec< │ │ │ -00234870: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>.. │ │ │ -00234890: 696e 203c 7061 7261 6d65 7465 723e 6e75 in nu │ │ │ -002348a0: 6d3c 2f70 6172 616d 6574 6572 3e20 7661 m va │ │ │ -002348b0: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ -002348c0: 0a20 2020 2020 203c 2f66 756e 6370 726f . . . . │ │ │ -00234900: 2020 3c72 6566 7365 6374 3120 6964 3d22 . De │ │ │ -00234930: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. Prin │ │ │ -00234950: 7473 2061 7320 6120 7374 7269 6e67 2061 ts as a string a │ │ │ -00234960: 2062 6967 206e 756d 6265 7220 7365 7269 big number seri │ │ │ -00234970: 616c 697a 6564 2061 7320 6269 6e61 7279 alized as binary │ │ │ -00234980: 2075 7369 6e67 2062 6173 6536 3420 656e using base64 en │ │ │ -00234990: 636f 6469 6e67 3c2f 7061 7261 3e0a 2020 coding. │ │ │ -002349a0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . │ │ │ -002349d0: 0a20 2020 203c 7469 746c 653e 5061 7261 . Para │ │ │ -002349e0: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ -002349f0: 2020 203c 7265 6673 6563 7432 3e3c 7469 num. │ │ │ -00234a10: 2020 2020 2020 3c70 6172 613e 5468 6520 The │ │ │ -00234a20: 6261 7336 3420 656e 636f 6465 6420 7374 bas64 encoded st │ │ │ -00234a30: 7269 6e67 2063 6f6e 7461 696e 696e 6720 ring containing │ │ │ -00234a40: 6120 6269 6e61 7279 2072 6570 7265 7365 a binary represe │ │ │ -00234a50: 6e74 6174 696f 6e20 6f66 2061 2062 6967 ntation of a big │ │ │ -00234a60: 206e 756d 6265 723c 2f70 6172 613e 0a20 number. │ │ │ -00234a70: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ -00234a80: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 ......7de │ │ │ -00234aa0: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ -00234ab0: 662f 7865 6e63 5f58 3530 395f 6365 7274 f/xenc_X509_cert │ │ │ -00234ac0: 6966 6963 6174 655f 7365 7269 616c 697a ificate_serializ │ │ │ -00234ad0: 652e 786d 6cdf 0000 0ac3 3c3f 786d 6c20 e.xml........ . xenc_X5 │ │ │ -00234ec0: 3039 5f63 6572 7469 6669 6361 7465 5f73 09_certificate_s │ │ │ -00234ed0: 6572 6961 6c69 7a65 3c2f 7265 6665 6e74 erialize. hash. < │ │ │ -00234f10: 2f72 6566 6d65 7461 3e0a 2020 3c72 6566 /refmeta>. . xenc_X509_ │ │ │ -00234f40: 6365 7274 6966 6963 6174 655f 7365 7269 certificate_seri │ │ │ -00234f50: 616c 697a 653c 2f72 6566 6e61 6d65 3e0a alize. │ │ │ -00234f60: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -00234f70: 4578 706f 7274 7320 6120 582e 3530 3920 Exports a X.509 │ │ │ -00234f80: 6365 7274 6966 6963 6174 6520 6672 6f6d certificate from │ │ │ -00234f90: 2075 7365 7227 7320 7265 706f 7369 746f user's reposito │ │ │ -00234fa0: 7279 3c2f 7265 6670 7572 706f 7365 3e0a ry. │ │ │ -00234fb0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -00234fc0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . │ │ │ -00235010: 2020 2020 2020 3c66 756e 6370 726f 746f .. va │ │ │ -00235060: 7263 6861 7220 3c66 756e 6374 696f 6e3e rchar │ │ │ -00235070: 7865 6e63 5f58 3530 395f 6365 7274 6966 xenc_X509_certif │ │ │ -00235080: 6963 6174 655f 7365 7269 616c 697a 653c icate_serialize< │ │ │ -00235090: 2f66 756e 6374 696f 6e3e 3c2f 6675 6e63 /function>.. │ │ │ -002350b0: 696e 203c 7061 7261 6d65 7465 723e 6e61 in na │ │ │ -002350c0: 6d65 3c2f 7061 7261 6d65 7465 723e 2076 me v │ │ │ -002350d0: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. . . < │ │ │ -00235110: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -00235120: 0a20 203c 7265 6673 6563 7431 2069 643d . . Description. ..This function │ │ │ -00235190: 2069 7320 7573 6564 2074 6f20 6578 706f is used to expo │ │ │ -002351a0: 7274 2058 2e35 3039 2066 726f 6d20 7573 rt X.509 from us │ │ │ -002351b0: 6572 2773 2073 7061 6365 2e0a 2020 2020 er's space.. │ │ │ -002351c0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . . │ │ │ -00235210: 2020 203c 7469 746c 653e 5061 7261 6d65 Parame │ │ │ -00235220: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -00235230: 203c 7265 6673 6563 7432 3e3c 7469 746c name. │ │ │ -00235250: 2020 2020 203c 7061 7261 3e54 6865 206e The n │ │ │ -00235260: 616d 6520 6f66 2074 6865 206b 6579 2061 ame of the key a │ │ │ -00235270: 7373 6f63 6961 7465 6420 7769 7468 2058 ssociated with X │ │ │ -00235280: 2e35 3039 2063 6572 7469 6669 6361 7465 .509 certificate │ │ │ -00235290: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . Return Types< │ │ │ -00235300: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>.

    The function │ │ │ -00235320: 2072 6574 7572 6e73 2062 6173 6536 3420 returns base64 │ │ │ -00235330: 656e 636f 6465 6420 7374 7269 6e67 2063 encoded string c │ │ │ -00235340: 6f6e 7461 696e 696e 6720 582e 3530 3920 ontaining X.509 │ │ │ -00235350: 6365 7274 6966 6963 6174 6520 696e 2044 certificate in D │ │ │ -00235360: 4552 2028 7261 7729 2066 6f72 6d61 742e ER (raw) format. │ │ │ -00235370: 0a09 2020 416c 736f 2074 6865 2063 6572 .. Also the cer │ │ │ -00235380: 7469 6669 6361 7465 2077 696c 6c20 636f tificate will co │ │ │ -00235390: 6e74 6169 6e20 7468 6520 6b65 7920 6173 ntain the key as │ │ │ -002353a0: 736f 6369 6174 6564 2077 6974 6820 6974 sociated with it │ │ │ -002353b0: 2e0a 2020 2020 2020 3c2f 7061 7261 3e0a .. . │ │ │ -002353c0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -002353d0: 3c72 6566 7365 6374 3120 6964 3d22 6578 . Examples. Exporting a X.5 │ │ │ -00235470: 3039 2063 6572 7469 6669 6361 7465 3c2f 09 certificate</ │ │ │ -00235480: 7469 746c 653e 0a09 3c70 6172 613e 5468 title>..<para>Th │ │ │ -00235490: 6520 6578 616d 706c 6520 6578 706f 7274 e example export │ │ │ -002354a0: 7320 6120 582e 3530 3920 6365 7274 6966 s a X.509 certif │ │ │ -002354b0: 6963 6174 6520 6173 736f 6369 6174 6564 icate associated │ │ │ -002354c0: 2077 6974 6820 2764 7361 2d74 6573 7427 with 'dsa-test' │ │ │ -002354d0: 206b 6579 2066 726f 6d20 7573 6572 2773 key from user's │ │ │ -002354e0: 2073 7061 6365 2e3c 2f70 6172 613e 0a20 space.</para>. │ │ │ -002354f0: 2020 2020 203c 7363 7265 656e 3e3c 215b <screen><![ │ │ │ -00235500: 4344 4154 415b 0a09 2020 2e2e 2e0a 0920 CDATA[.. ..... │ │ │ -00235510: 2064 6563 6c61 7265 2078 3530 3920 7661 declare x509 va │ │ │ -00235520: 7263 6861 723b 0a09 2020 7835 3039 203a rchar;.. x509 : │ │ │ -00235530: 3d20 7865 6e63 5f58 3530 395f 6365 7274 = xenc_X509_cert │ │ │ -00235540: 6966 6963 6174 655f 7365 7269 616c 697a ificate_serializ │ │ │ -00235550: 6520 2827 6473 612d 7465 7374 2729 3b0a e ('dsa-test');. │ │ │ -00235560: 0920 202e 2e2e 0a5d 5d3e 3c2f 7363 7265 . ....]]></scre │ │ │ -00235570: 656e 3e0a 2020 2020 3c2f 6578 616d 706c en>. </exampl │ │ │ -00235580: 653e 0a20 203c 2f72 6566 7365 6374 313e e>. </refsect1> │ │ │ -00235590: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 .</refentry>.... │ │ │ -002355a0: 0026 6465 6d6f 2f64 6f63 7372 632f 6675 .&demo/docsrc/fu │ │ │ -002355b0: 6e63 7265 662f 7865 6e63 5f53 504b 495f ncref/xenc_SPKI_ │ │ │ -002355c0: 7265 6164 2e78 6d6c df00 000a 483c 3f78 read.xml....H<?x │ │ │ -002355d0: 6d6c 2076 6572 7369 6f6e 3d22 312e 3022 ml version="1.0" │ │ │ -002355e0: 2065 6e63 6f64 696e 673d 2249 534f 2d38 encoding="ISO-8 │ │ │ -002355f0: 3835 392d 3122 3f3e 0a3c 212d 2d0a 2020 859-1"?>.<!--. │ │ │ -00235600: 0a20 2054 6869 7320 6669 6c65 2069 7320 . This file is │ │ │ -00235610: 7061 7274 206f 6620 7468 6520 4f70 656e part of the Open │ │ │ -00235620: 4c69 6e6b 2053 6f66 7477 6172 6520 5669 Link Software Vi │ │ │ -00235630: 7274 756f 736f 204f 7065 6e2d 536f 7572 rtuoso Open-Sour │ │ │ -00235640: 6365 2028 564f 5329 0a20 2070 726f 6a65 ce (VOS). proje │ │ │ -00235650: 6374 2e0a 2020 0a20 2043 6f70 7972 6967 ct.. . Copyrig │ │ │ -00235660: 6874 2028 4329 2031 3939 382d 3230 3234 ht (C) 1998-2024 │ │ │ -00235670: 204f 7065 6e4c 696e 6b20 536f 6674 7761 OpenLink Softwa │ │ │ -00235680: 7265 0a20 200a 2020 5468 6973 2070 726f re. . This pro │ │ │ -00235690: 6a65 6374 2069 7320 6672 6565 2073 6f66 ject is free sof │ │ │ -002356a0: 7477 6172 653b 2079 6f75 2063 616e 2072 tware; you can r │ │ │ -002356b0: 6564 6973 7472 6962 7574 6520 6974 2061 edistribute it a │ │ │ -002356c0: 6e64 2f6f 7220 6d6f 6469 6679 2069 740a nd/or modify it. │ │ │ -002356d0: 2020 756e 6465 7220 7468 6520 7465 726d under the term │ │ │ -002356e0: 7320 6f66 2074 6865 2047 4e55 2047 656e s of the GNU Gen │ │ │ -002356f0: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ -00235700: 6e73 6520 6173 2070 7562 6c69 7368 6564 nse as published │ │ │ -00235710: 2062 7920 7468 650a 2020 4672 6565 2053 by the. Free S │ │ │ -00235720: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ -00235730: 6f6e 3b20 6f6e 6c79 2076 6572 7369 6f6e on; only version │ │ │ -00235740: 2032 206f 6620 7468 6520 4c69 6365 6e73 2 of the Licens │ │ │ -00235750: 652c 2064 6174 6564 204a 756e 6520 3139 e, dated June 19 │ │ │ -00235760: 3931 2e0a 2020 0a20 2054 6869 7320 7072 91.. . This pr │ │ │ -00235770: 6f67 7261 6d20 6973 2064 6973 7472 6962 ogram is distrib │ │ │ -00235780: 7574 6564 2069 6e20 7468 6520 686f 7065 uted in the hope │ │ │ -00235790: 2074 6861 7420 6974 2077 696c 6c20 6265 that it will be │ │ │ -002357a0: 2075 7365 6675 6c2c 2062 7574 0a20 2057 useful, but. W │ │ │ -002357b0: 4954 484f 5554 2041 4e59 2057 4152 5241 ITHOUT ANY WARRA │ │ │ -002357c0: 4e54 593b 2077 6974 686f 7574 2065 7665 NTY; without eve │ │ │ -002357d0: 6e20 7468 6520 696d 706c 6965 6420 7761 n the implied wa │ │ │ -002357e0: 7272 616e 7479 206f 660a 2020 4d45 5243 rranty of. MERC │ │ │ -002357f0: 4841 4e54 4142 494c 4954 5920 6f72 2046 HANTABILITY or F │ │ │ -00235800: 4954 4e45 5353 2046 4f52 2041 2050 4152 ITNESS FOR A PAR │ │ │ -00235810: 5449 4355 4c41 5220 5055 5250 4f53 452e TICULAR PURPOSE. │ │ │ -00235820: 2053 6565 2074 6865 2047 4e55 0a20 2047 See the GNU. G │ │ │ -00235830: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ -00235840: 6365 6e73 6520 666f 7220 6d6f 7265 2064 cense for more d │ │ │ -00235850: 6574 6169 6c73 2e0a 2020 0a20 2059 6f75 etails.. . You │ │ │ -00235860: 2073 686f 756c 6420 6861 7665 2072 6563 should have rec │ │ │ -00235870: 6569 7665 6420 6120 636f 7079 206f 6620 eived a copy of │ │ │ -00235880: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ -00235890: 5075 626c 6963 204c 6963 656e 7365 2061 Public License a │ │ │ -002358a0: 6c6f 6e67 0a20 2077 6974 6820 7468 6973 long. with this │ │ │ -002358b0: 2070 726f 6772 616d 3b20 6966 206e 6f74 program; if not │ │ │ -002358c0: 2c20 7772 6974 6520 746f 2074 6865 2046 , write to the F │ │ │ -002358d0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ -002358e0: 6e64 6174 696f 6e2c 2049 6e63 2e2c 0a20 ndation, Inc.,. │ │ │ -002358f0: 2035 3120 4672 616e 6b6c 696e 2053 742c 51 Franklin St, │ │ │ -00235900: 2046 6966 7468 2046 6c6f 6f72 2c20 426f Fifth Floor, Bo │ │ │ -00235910: 7374 6f6e 2c20 4d41 2030 3231 3130 2d31 ston, MA 02110-1 │ │ │ -00235920: 3330 3120 5553 410a 0a20 203a 2074 656d 301 USA.. : tem │ │ │ -00235930: 706c 6174 652e 7368 2c76 2031 2e35 2032 plate.sh,v 1.5 2 │ │ │ -00235940: 3030 362f 3034 2f31 3820 3231 3a35 393a 006/04/18 21:59: │ │ │ -00235950: 3133 2069 7661 6e20 4578 7020 240a 2d2d 13 ivan Exp $.-- │ │ │ -00235960: 3e0a 3c72 6566 656e 7472 7920 6964 3d22 >.<refentry id=" │ │ │ -00235970: 666e 5f78 656e 635f 5350 4b49 5f72 6561 fn_xenc_SPKI_rea │ │ │ -00235980: 6422 3e0a 2020 3c72 6566 6d65 7461 3e0a d">. <refmeta>. │ │ │ -00235990: 2020 2020 3c72 6566 656e 7472 7974 6974 <refentrytit │ │ │ -002359a0: 6c65 3e78 656e 635f 5350 4b49 5f72 6561 le>xenc_SPKI_rea │ │ │ -002359b0: 643c 2f72 6566 656e 7472 7974 6974 6c65 d</refentrytitle │ │ │ -002359c0: 3e0a 2020 2020 3c72 6566 6d69 7363 696e >. <refmiscin │ │ │ -002359d0: 666f 3e68 6173 683c 2f72 6566 6d69 7363 fo>hash</refmisc │ │ │ -002359e0: 696e 666f 3e0a 2020 3c2f 7265 666d 6574 info>. </refmet │ │ │ -002359f0: 613e 0a20 203c 7265 666e 616d 6564 6976 a>. <refnamediv │ │ │ -00235a00: 3e0a 2020 2020 3c72 6566 6e61 6d65 3e78 >. <refname>x │ │ │ -00235a10: 656e 635f 5350 4b49 5f72 6561 643c 2f72 enc_SPKI_read</r │ │ │ -00235a20: 6566 6e61 6d65 3e0a 2020 2020 3c72 6566 efname>. <ref │ │ │ -00235a30: 7075 7270 6f73 653e 496d 706f 7274 7320 purpose>Imports │ │ │ -00235a40: 6120 7075 626c 6963 206b 6579 2066 726f a public key fro │ │ │ -00235a50: 6d20 7369 6d70 6c65 2070 7562 6c69 6320 m simple public │ │ │ -00235a60: 6b65 7920 696e 6672 6173 7472 7563 7475 key infrastructu │ │ │ -00235a70: 7265 2028 5350 4b49 293c 2f72 6566 7075 re (SPKI)</refpu │ │ │ -00235a80: 7270 6f73 653e 0a20 203c 2f72 6566 6e61 rpose>. </refna │ │ │ -00235a90: 6d65 6469 763e 0a20 203c 7265 6673 796e mediv>. <refsyn │ │ │ -00235aa0: 6f70 7369 7364 6976 3e0a 2020 2020 3c66 opsisdiv>. <f │ │ │ -00235ab0: 756e 6373 796e 6f70 7369 7320 6964 3d22 uncsynopsis id=" │ │ │ -00235ac0: 6673 796e 5f78 656e 635f 5350 4b49 5f72 fsyn_xenc_SPKI_r │ │ │ -00235ad0: 6561 6422 3e0a 2020 2020 2020 3c66 756e ead">. <fun │ │ │ -00235ae0: 6370 726f 746f 7479 7065 2069 643d 2266 cprototype id="f │ │ │ -00235af0: 7072 6f74 6f5f 7865 6e63 5f53 504b 495f proto_xenc_SPKI_ │ │ │ -00235b00: 7265 6164 223e 0a20 2020 2020 2020 203c read">. < │ │ │ -00235b10: 6675 6e63 6465 663e 3c66 756e 6374 696f funcdef><functio │ │ │ -00235b20: 6e3e 7865 6e63 5f53 504b 495f 7265 6164 n>xenc_SPKI_read │ │ │ -00235b30: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e </function></fun │ │ │ -00235b40: 6364 6566 3e0a 093c 7061 7261 6d64 6566 cdef>..<paramdef │ │ │ -00235b50: 3e69 6e20 3c70 6172 616d 6574 6572 3e6b >in <parameter>k │ │ │ -00235b60: 6579 5f6e 616d 653c 2f70 6172 616d 6574 ey_name</paramet │ │ │ -00235b70: 6572 3e20 7661 7263 6861 723c 2f70 6172 er> varchar</par │ │ │ -00235b80: 616d 6465 663e 0a09 3c70 6172 616d 6465 amdef>..<paramde │ │ │ -00235b90: 663e 696e 203c 7061 7261 6d65 7465 723e f>in <parameter> │ │ │ -00235ba0: 6b65 795f 6461 7461 3c2f 7061 7261 6d65 key_data</parame │ │ │ -00235bb0: 7465 723e 2076 6172 6368 6172 3c2f 7061 ter> varchar</pa │ │ │ -00235bc0: 7261 6d64 6566 3e0a 2020 2020 2020 3c2f ramdef>. </ │ │ │ -00235bd0: 6675 6e63 7072 6f74 6f74 7970 653e 0a20 funcprototype>. │ │ │ -00235be0: 2020 203c 2f66 756e 6373 796e 6f70 7369 </funcsynopsi │ │ │ -00235bf0: 733e 0a20 203c 2f72 6566 7379 6e6f 7073 s>. </refsynops │ │ │ -00235c00: 6973 6469 763e 0a20 203c 7265 6673 6563 isdiv>. <refsec │ │ │ -00235c10: 7431 2069 643d 2264 6573 635f 7865 6e63 t1 id="desc_xenc │ │ │ -00235c20: 5f53 504b 495f 7265 6164 223e 0a20 2020 _SPKI_read">. │ │ │ -00235c30: 203c 7469 746c 653e 4465 7363 7269 7074 <title>Descript │ │ │ -00235c40: 696f 6e3c 2f74 6974 6c65 3e0a 2020 2020 ion. │ │ │ -00235c50: 3c70 6172 613e 5468 6973 2066 756e 6374 This funct │ │ │ -00235c60: 696f 6e20 6973 2075 7365 6420 746f 2072 ion is used to r │ │ │ -00235c70: 6561 6420 616e 2052 5341 2070 7562 6c69 ead an RSA publi │ │ │ -00235c80: 6320 6b65 7920 6672 6f6d 2053 504b 4920 c key from SPKI │ │ │ -00235c90: 636f 6e74 656e 742e 3c2f 7061 7261 3e0a content.. │ │ │ -00235ca0: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 . │ │ │ -00235cb0: 3c72 6566 7365 6374 3120 6964 3d22 7061 . Parameters</tit │ │ │ -00235cf0: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -00235d00: 323e 3c74 6974 6c65 3e6b 6579 5f6e 616d 2><title>key_nam │ │ │ -00235d10: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -00235d20: 3c70 6172 613e 5468 6520 6e61 6d65 206f The name o │ │ │ -00235d30: 6620 7468 6520 6b65 7920 746f 2062 6520 f the key to be │ │ │ -00235d40: 6372 6561 7465 642c 2069 6620 6e75 6c6c created, if null │ │ │ -00235d50: 2069 7320 6769 7665 6e20 6120 7465 6d70 is given a temp │ │ │ -00235d60: 206b 6579 2077 696c 6c20 6265 2063 7265 key will be cre │ │ │ -00235d70: 6174 6564 3c2f 7061 7261 3e0a 2020 2020 ated. │ │ │ -00235d80: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00235d90: 3c72 6566 7365 6374 323e 3c74 6974 6c65 key_data. Th │ │ │ -00235dc0: 6520 5350 4b49 2063 6f6e 7465 6e74 3c2f e SPKI content. . . . │ │ │ -00235e20: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 Example │ │ │ -00235e30: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. SPKI readin │ │ │ -00235e70: 673c 2f74 6974 6c65 3e0a 2020 2020 2020 g. │ │ │ -00235e80: 3c70 6172 613e 5468 6520 6578 616d 706c The exampl │ │ │ -00235e90: 6520 6265 6c6f 7720 6372 6561 7465 7320 e below creates │ │ │ -00235ea0: 6120 7465 6d70 206b 6579 2e3c 2f70 6172 a temp key.. .. . . │ │ │ -00235f50: 2020 3c72 6566 7365 6374 3120 6964 3d22 . See Also. < │ │ │ -00235fa0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -00235fb0: 5f78 656e 635f 7835 3039 5f67 656e 6572 _xenc_x509_gener │ │ │ -00235fc0: 6174 6522 3e3c 6675 6e63 7469 6f6e 3e78 ate">x │ │ │ -00235fd0: 656e 635f 7835 3039 5f67 656e 6572 6174 enc_x509_generat │ │ │ -00235fe0: 653c 2f66 756e 6374 696f 6e3e 3c2f 6c69 e. ....../demo/d │ │ │ -00236020: 6f63 7372 632f 6675 6e63 7265 662f 7835 ocsrc/funcref/x5 │ │ │ -00236030: 3039 5f63 6572 7469 6669 6361 7465 5f76 09_certificate_v │ │ │ -00236040: 6572 6966 792e 786d 6cdf 0000 17c1 3c3f erify.xml........ . x509_certif │ │ │ -00236430: 6963 6174 655f 7665 7269 6679 3c2f 7265 icate_verify. │ │ │ -00236450: 203c 7265 666d 6973 6369 6e66 6f3e 6861 ha │ │ │ -00236460: 7368 3c2f 7265 666d 6973 6369 6e66 6f3e sh │ │ │ -00236470: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ -00236480: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ -00236490: 203c 7265 666e 616d 653e 7835 3039 5f63 x509_c │ │ │ -002364a0: 6572 7469 6669 6361 7465 5f76 6572 6966 ertificate_verif │ │ │ -002364b0: 793c 2f72 6566 6e61 6d65 3e0a 2020 2020 y. │ │ │ -002364c0: 3c72 6566 7075 7270 6f73 653e 5665 7269 Veri │ │ │ -002364d0: 6669 6573 2058 2e35 3039 2063 6572 7469 fies X.509 certi │ │ │ -002364e0: 6669 6361 7465 3c2f 7265 6670 7572 706f ficate. . . . │ │ │ -00236550: 2020 3c66 756e 6370 726f 746f 7479 7065 . varchar < │ │ │ -002365a0: 6675 6e63 7469 6f6e 3e78 3530 395f 6365 function>x509_ce │ │ │ -002365b0: 7274 6966 6963 6174 655f 7665 7269 6679 rtificate_verify │ │ │ -002365c0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e ..in c │ │ │ -002365f0: 6572 743c 2f70 6172 616d 6574 6572 3e20 ert │ │ │ -00236600: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar. in cacerts any.

    in │ │ │ -00236680: 666c 6167 733c 2f70 6172 616d 6574 6572 flags varchar. │ │ │ -002366b0: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ -002366f0: 3c72 6566 7365 6374 3120 6964 3d22 6465 Description. .. This func │ │ │ -00236750: 7469 6f6e 2074 616b 6573 2061 2058 2e35 tion takes a X.5 │ │ │ -00236760: 3039 2063 6572 7469 6669 6361 7465 2061 09 certificate a │ │ │ -00236770: 6e64 2076 6572 6966 6965 7320 6974 2061 nd verifies it a │ │ │ -00236780: 6761 696e 7374 200a 0920 206c 6973 7420 gainst .. list │ │ │ -00236790: 6f66 2043 4120 6365 7274 6966 6963 6174 of CA certificat │ │ │ -002367a0: 6573 2e20 4974 2063 6865 636b 7320 666f es. It checks fo │ │ │ -002367b0: 7220 7661 7269 6f75 7320 6365 7274 6966 r various certif │ │ │ -002367c0: 6963 6174 6520 0a09 2020 6174 7472 6962 icate .. attrib │ │ │ -002367d0: 7574 6573 2073 7563 6820 6173 2073 656c utes such as sel │ │ │ -002367e0: 6620 7369 676e 6564 2c20 6578 7069 7261 f signed, expira │ │ │ -002367f0: 7469 6f6e 2064 6174 6520 6574 632e 0a09 tion date etc... │ │ │ -00236800: 2020 4966 2061 6e20 6572 726f 7220 6973 If an error is │ │ │ -00236810: 2064 6574 6563 7465 6420 6974 2077 696c detected it wil │ │ │ -00236820: 6c20 6265 2073 6967 6e61 6c6c 6564 2e20 l be signalled. │ │ │ -00236830: 200a 0a20 2020 2020 203c 2f70 6172 613e .. │ │ │ -00236840: 0a20 2020 2020 203c 7061 7261 3e0a 0920 . .. │ │ │ -00236850: 2054 6865 2063 6572 7469 6669 6361 7465 The certificate │ │ │ -00236860: 7320 6172 6520 7061 7373 6564 2061 7320 s are passed as │ │ │ -00236870: 6120 7374 7269 6e67 7320 636f 6e74 6169 a strings contai │ │ │ -00236880: 6e69 6e67 2058 2e35 3039 200a 0920 2063 ning X.509 .. c │ │ │ -00236890: 6572 7469 6669 6361 7465 2062 696e 6172 ertificate binar │ │ │ -002368a0: 7920 6461 7461 2069 6e20 4445 5220 2872 y data in DER (r │ │ │ -002368b0: 6177 2920 666f 726d 6174 2e20 0a20 2020 aw) format. . │ │ │ -002368c0: 2020 203c 2f70 6172 613e 0a3c 2f72 6566 .. Pa │ │ │ -00236910: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ -00236920: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -00236930: 7469 746c 653e 6365 7274 3c2f 7469 746c title>cert. T │ │ │ -00236950: 6865 2058 2e35 3039 2063 6572 7469 6669 he X.509 certifi │ │ │ -00236960: 6361 7465 2074 6f20 6265 2076 6572 6966 cate to be verif │ │ │ -00236970: 6965 643c 2f70 6172 613e 3c2f 7265 6673 ied. cace │ │ │ -002369a0: 7274 733c 2f74 6974 6c65 3e0a 2020 2020 rts. │ │ │ -002369b0: 2020 3c70 6172 613e 6172 7261 7920 6f66 array of │ │ │ -002369c0: 2073 7472 696e 6773 2063 6f6e 7461 696e strings contain │ │ │ -002369d0: 696e 6720 4341 2063 6572 7469 6669 6361 ing CA certifica │ │ │ -002369e0: 7465 733c 2f70 6172 613e 3c2f 7265 6673 tes. flags │ │ │ -00236a10: 3c2f 7469 746c 653e 0a09 3c70 6172 613e .. │ │ │ -00236a20: 4120 7374 7269 6e67 2063 6f6e 7461 696e A string contain │ │ │ -00236a30: 696e 6720 636f 6d6d 6120 7365 7061 7261 ing comma separa │ │ │ -00236a40: 7465 6420 6c69 7374 206f 6620 7665 7269 ted list of veri │ │ │ -00236a50: 6669 6361 7469 6f6e 206f 7074 696f 6e73 fication options │ │ │ -00236a60: 2e20 5365 6520 7461 626c 6520 6265 6c6f . See table belo │ │ │ -00236a70: 7720 666f 7220 7661 6c69 6420 7661 6c75 w for valid valu │ │ │ -00236a80: 6573 2e3c 2f70 6172 613e 0a20 2020 2020 es.. │ │ │ -00236a90: 203c 7461 626c 653e 3c74 6974 6c65 3e56 V │ │ │ -00236aa0: 616c 7565 7320 666f 7220 3c70 6172 616d alues for <param │ │ │ -00236ab0: 6574 6572 3e66 6c61 6773 3c2f 7061 7261 eter>flags</para │ │ │ -00236ac0: 6d65 7465 723e 3c2f 7469 746c 653e 0a20 meter>. │ │ │ -00236ad0: 2020 2020 2020 203c 7467 726f 7570 2063 . │ │ │ -00236af0: 2020 203c 7468 6561 643e 0a20 2020 2020 . │ │ │ -00236b00: 2020 2020 2020 203c 726f 773e 0a20 2020 . │ │ │ -00236b10: 2020 2020 2020 2020 2020 203c 656e 7472 Option │ │ │ -00236b30: 0a20 2020 2020 2020 2020 2020 2020 203c . < │ │ │ -00236b40: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ -00236b50: 6e3c 2f65 6e74 7279 3e0a 2020 2020 2020 n. │ │ │ -00236b60: 2020 2020 2020 3c2f 726f 773e 0a20 2020 . │ │ │ -00236b70: 2020 2020 2020 203c 2f74 6865 6164 3e0a . │ │ │ -00236b80: 0920 203c 7462 6f64 793e 0a09 2020 2020 . .. │ │ │ -00236b90: 3c72 6f77 3e0a 0920 2020 2020 203c 656e .. expired.. Do not check f │ │ │ -00236bd0: 6f72 2065 7870 6972 6174 696f 6e3c 2f65 or expiration.. .. .. │ │ │ -00236c00: 2020 2020 3c65 6e74 7279 3e73 656c 662d self- │ │ │ -00236c10: 7369 676e 6564 3c2f 656e 7472 793e 0a09 signed.. │ │ │ -00236c20: 2020 2020 2020 3c65 6e74 7279 3e44 6f20 Do │ │ │ -00236c30: 6e6f 7420 7472 6561 7420 7365 6c66 2073 not treat self s │ │ │ -00236c40: 6967 6e65 6420 6365 7274 6966 6963 6174 igned certificat │ │ │ -00236c50: 6520 6173 2065 7272 6f72 3c2f 656e 7472 e as error.. .. │ │ │ -00236c70: 2020 2020 3c72 6f77 3e0a 0920 2020 2020 .. │ │ │ -00236c80: 203c 656e 7472 793e 696e 7661 6c69 642d invalid- │ │ │ -00236c90: 6361 3c2f 656e 7472 793e 0a09 2020 2020 ca.. │ │ │ -00236ca0: 2020 3c65 6e74 7279 3e49 676e 6f72 6520 Ignore │ │ │ -00236cb0: 696e 7661 6c69 6420 4341 3c2f 656e 7472 invalid CA.. .. │ │ │ -00236cd0: 2020 2020 3c72 6f77 3e0a 0920 2020 2020 .. │ │ │ -00236ce0: 203c 656e 7472 793e 696e 7661 6c69 642d invalid- │ │ │ -00236cf0: 7075 7270 6f73 653c 2f65 6e74 7279 3e0a purpose. │ │ │ -00236d00: 0920 2020 2020 203c 656e 7472 793e 4967 . Ig │ │ │ -00236d10: 6e6f 7265 2069 6e76 616c 6964 2063 6572 nore invalid cer │ │ │ -00236d20: 7469 6669 6361 7465 2070 7572 706f 7365 tificate purpose │ │ │ -00236d30: 3c2f 656e 7472 793e 0a09 2020 2020 3c2f .. .. . │ │ │ -00236d50: 0920 2020 2020 203c 656e 7472 793e 756e . un │ │ │ -00236d60: 6861 6e64 6c65 642d 6578 7465 6e73 696f handled-extensio │ │ │ -00236d70: 6e3c 2f65 6e74 7279 3e0a 0920 2020 2020 n.. │ │ │ -00236d80: 203c 656e 7472 793e 4967 6e6f 7265 2075 Ignore u │ │ │ -00236d90: 6e68 616e 646c 6564 2063 7269 7469 6361 nhandled critica │ │ │ -00236da0: 6c20 6578 7465 6e73 696f 6e3c 2f65 6e74 l extension.. . │ │ │ -00236dc0: 0920 203c 2f74 626f 6479 3e0a 2020 2020 . . │ │ │ -00236dd0: 2020 2020 3c2f 7467 726f 7570 3e0a 2020 . │ │ │ -00236de0: 2020 2020 3c2f 7461 626c 653e 0a20 2020
    . │ │ │ -00236df0: 203c 2f72 6566 7365 6374 323e 0a20 203c
    . < │ │ │ -00236e00: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. R │ │ │ -00236e40: 6574 7572 6e20 5479 7065 733c 2f74 6974 eturn Types</tit │ │ │ -00236e50: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -00236e60: 4e6f 6e65 3c2f 7061 7261 3e0a 2020 3c2f None</para>. </ │ │ │ -00236e70: 7265 6673 6563 7431 3e0a 2020 3c72 6566 refsect1>. <ref │ │ │ -00236e80: 7365 6374 3120 6964 3d22 6572 726f 7273 sect1 id="errors │ │ │ -00236e90: 5f78 3530 395f 6365 7274 6966 6963 6174 _x509_certificat │ │ │ -00236ea0: 655f 7665 7269 6679 223e 3c74 6974 6c65 e_verify"><title │ │ │ -00236eb0: 3e45 7272 6f72 733c 2f74 6974 6c65 3e0a >Errors. │ │ │ -00236ec0: 2020 2020 3c74 6162 6c65 3e3c 7469 746c Errors signall │ │ │ -00236ee0: 6564 2062 7920 3c66 756e 6374 696f 6e3e ed by │ │ │ -00236ef0: 7835 3039 5f63 6572 7469 6669 6361 7465 x509_certificate │ │ │ -00236f00: 5f76 6572 6966 793c 2f66 756e 6374 696f _verify. │ │ │ -00236f20: 203c 7467 726f 7570 2063 6f6c 733d 2234 . . . < │ │ │ -00236f60: 656e 7472 793e 5351 4c53 7461 7465 3c2f entry>SQLState. │ │ │ -00236f80: 2020 203c 656e 7472 793e 4572 726f 7220 Error │ │ │ -00236f90: 436f 6465 3c2f 656e 7472 793e 0a20 2020 Code. │ │ │ -00236fa0: 2020 2020 2020 2020 203c 656e 7472 793e │ │ │ -00236fb0: 4572 726f 7220 5465 7874 3c2f 656e 7472 Error Text. < │ │ │ -00236fd0: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ -00236fe0: 6e3c 2f65 6e74 7279 3e0a 2020 2020 2020 n. │ │ │ -00236ff0: 2020 2020 3c2f 726f 773e 0a20 2020 2020 . │ │ │ -00237000: 2020 203c 2f74 6865 6164 3e0a 093c 7462 .... .. │ │ │ -00237020: 2020 203c 656e 7472 793e 3c65 7272 6f72 22023.. │ │ │ -00237050: 2020 2020 3c65 6e74 7279 3e3c 6572 726f CR014. │ │ │ -00237080: 0920 2020 203c 656e 7472 793e 3c65 7272 . Invalid c │ │ │ -002370a0: 6572 7469 6669 6361 7465 3c2f 6572 726f ertificate.. │ │ │ -002370c0: 2020 2020 3c65 6e74 7279 3e54 6865 2069 The i │ │ │ -002370d0: 6e70 7574 2063 616e 2774 2062 6520 6465 nput can't be de │ │ │ -002370e0: 636f 6465 6420 6173 2061 2058 2e35 3039 coded as a X.509 │ │ │ -002370f0: 2063 6572 7469 6669 6361 7465 3c2f 656e certificate.. .. │ │ │ -00237110: 2020 3c72 6f77 3e0a 0920 2020 203c 656e .. 2 │ │ │ -00237130: 3230 3233 3c2f 6572 726f 7263 6f64 653e 2023 │ │ │ -00237140: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 .. │ │ │ -00237160: 4352 3031 363c 2f65 7272 6f72 636f 6465 CR016.. < │ │ │ -00237180: 656e 7472 793e 3c65 7272 6f72 6e61 6d65 entry>Can not allocat │ │ │ -002371a0: 6520 6120 5835 3039 2073 746f 7265 3c2f e a X509 store.. < │ │ │ -002371d0: 2f65 6e74 7279 3e0a 0920 203c 2f72 6f77 /entry>.. .. .. │ │ │ -002371f0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 22023.. │ │ │ -00237220: 203c 656e 7472 793e 3c65 7272 6f72 636f CR019.. │ │ │ -00237250: 2020 3c65 6e74 7279 3e3c 6572 726f 726e Invalid CA c │ │ │ -00237270: 6572 7469 6669 6361 7465 3c2f 6572 726f ertificate.. │ │ │ -00237290: 2020 2020 3c65 6e74 7279 3e53 6f6d 6520 Some │ │ │ -002372a0: 6f66 2043 4120 6365 7274 6966 6963 6174 of CA certificat │ │ │ -002372b0: 6573 2063 616e 206e 6f74 2062 6520 6c6f es can not be lo │ │ │ -002372c0: 6164 6564 2064 7565 2074 6f20 6261 6420 aded due to bad │ │ │ -002372d0: 666f 726d 6174 3c2f 656e 7472 793e 0a09 format.. │ │ │ -002372e0: 2020 3c2f 726f 773e 0a09 2020 3c72 6f77 .. .. 22023.. < │ │ │ -00237330: 6572 726f 7263 6f64 653e 4352 3031 373c errorcode>CR017< │ │ │ -00237340: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode>.. │ │ │ -00237360: 3c65 7272 6f72 6e61 6d65 3e43 616e 206e Can n │ │ │ -00237370: 6f74 2061 6c6c 6f63 6174 6520 5835 3039 ot allocate X509 │ │ │ -00237380: 2076 6572 6966 6963 6174 696f 6e20 636f verification co │ │ │ -00237390: 6e74 6578 743c 2f65 7272 6f72 6e61 6d65 ntext.. < │ │ │ -002373b0: 656e 7472 793e 3c2f 656e 7472 793e 0a09 entry>.. │ │ │ -002373c0: 2020 3c2f 726f 773e 0a09 2020 3c72 6f77 .. .. 22023.. < │ │ │ -00237410: 6572 726f 7263 6f64 653e 4352 3031 383c errorcode>CR018< │ │ │ -00237420: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode>.. │ │ │ -00237440: 3c65 7272 6f72 6e61 6d65 3e43 616e 206e Can n │ │ │ -00237450: 6f74 2069 6e69 7469 616c 697a 6520 5835 ot initialize X5 │ │ │ -00237460: 3039 2076 6572 6966 6963 6174 696f 6e20 09 verification │ │ │ -00237470: 636f 6e74 6578 743c 2f65 7272 6f72 6e61 context.. │ │ │ -00237490: 203c 656e 7472 793e 3c2f 656e 7472 793e │ │ │ -002374a0: 0a09 2020 3c2f 726f 773e 0a09 2020 3c72 .. .. .. │ │ │ -002374c0: 3c65 7272 6f72 636f 6465 3e32 3230 3233 22023 │ │ │ -002374d0: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. CR01 │ │ │ -00237500: 353c 2f65 7272 6f72 636f 6465 3e3c 2f65 5.. X50 │ │ │ -00237530: 3920 6572 726f 723a 205b 7468 6520 7665 9 error: [the ve │ │ │ -00237540: 7269 6669 6361 7469 6f6e 2065 7272 6f72 rification error │ │ │ -00237550: 2074 6578 745d 3c2f 6572 726f 726e 616d text].. │ │ │ -00237570: 3c65 6e74 7279 3e3c 2f65 6e74 7279 3e0a . │ │ │ -00237580: 0920 203c 2f72 6f77 3e0a 093c 2f74 626f . ... .
    │ │ │ -002375b0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 .
    . │ │ │ -002375c0: 203c 7265 6673 6563 7431 2069 643d 2265 Examples │ │ │ -00237600: 3c2f 7469 746c 653e 0a20 2020 203c 6578 . Ver │ │ │ -00237640: 6966 6963 6174 696f 6e20 6f66 2061 2058 ification of a X │ │ │ -00237650: 2e35 3039 2063 6572 7469 6669 6361 7465 .509 certificate │ │ │ -00237660: 3c2f 7469 746c 653e 0a3c 7072 6f67 7261 . x509 │ │ │ -00237690: 5f63 6572 7469 6669 6361 7465 5f76 6572 _certificate_ver │ │ │ -002376a0: 6966 7920 2866 696c 655f 746f 5f73 7472 ify (file_to_str │ │ │ -002376b0: 696e 6720 2827 6b65 7973 2f73 7276 2f63 ing ('keys/srv/c │ │ │ -002376c0: 6572 742e 6365 7227 292c 2076 6563 746f ert.cer'), vecto │ │ │ -002376d0: 7220 2866 696c 655f 746f 5f73 7472 696e r (file_to_strin │ │ │ -002376e0: 6720 2827 6b65 7973 2f73 7276 2f63 612e g ('keys/srv/ca. │ │ │ -002376f0: 6365 7227 2929 2c20 2773 656c 662d 7369 cer')), 'self-si │ │ │ -00237700: 676e 6564 2729 3b0a 0a20 2020 2044 6f6e gned');.. Don │ │ │ -00237710: 652e 202d 2d20 3239 206d 7365 632e 0a20 e. -- 29 msec.. │ │ │ -00237720: 2020 205d 5d3e 3c2f 7072 6f67 7261 6d6c ]]>. . . See │ │ │ -00237790: 2041 6c73 6f3c 2f74 6974 6c65 3e0a 2020 Also. │ │ │ -002377a0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ -002377d0: 6765 745f 6365 7274 6966 6963 6174 655f get_certificate_ │ │ │ -002377e0: 696e 666f 2829 3c2f 6c69 6e6b 3e3c 2f70 info()

    .
    .
    ... │ │ │ -00237810: 0000 001f 6465 6d6f 2f64 6f63 7372 632f ....demo/docsrc/ │ │ │ -00237820: 6675 6e63 7265 662f 7773 745f 636c 692e funcref/wst_cli. │ │ │ -00237830: 786d 6cdf 0000 0cad 3c3f 786d 6c20 7665 xml........ │ │ │ -00237be0: 2020 3c72 6566 6d65 7461 3e0a 2020 2020 . │ │ │ -00237bf0: 3c72 6566 656e 7472 7974 6974 6c65 3e77 w │ │ │ -00237c00: 7374 5f63 6c69 3c2f 7265 6665 6e74 7279 st_cli. soap. . . wst_cli. Request a │ │ │ -00237c90: 7365 6375 7269 7479 2074 6f6b 656e 2066 security token f │ │ │ -00237ca0: 726f 6d20 5753 5420 656e 6470 6f69 6e74 rom WST endpoint │ │ │ -00237cb0: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ -00237cc0: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -00237cd0: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ -00237ce0: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . . │ │ │ -00237d30: 2020 2020 2020 2020 3c66 756e 6364 6566 token wst_cli..< │ │ │ -00237d70: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in req soap_clie │ │ │ -00237da0: 6e74 5f72 6571 3c2f 7061 7261 6d64 6566 nt_req..in │ │ │ -00237dc0: 3c70 6172 616d 6574 6572 3e70 6f6c 6963 polic │ │ │ -00237dd0: 793c 2f70 6172 616d 6574 6572 3e20 616e y an │ │ │ -00237de0: 793c 2f70 6172 616d 6465 663e 0a20 2020 y. │ │ │ -00237df0: 2020 203c 2f66 756e 6370 726f 746f 7479 . . . . < │ │ │ -00237e50: 7469 746c 653e 4465 7363 7269 7074 696f title>Descriptio │ │ │ -00237e60: 6e3c 2f74 6974 6c65 3e0a 2020 2020 3c70 n.

    This functio │ │ │ -00237e80: 6e20 6973 2066 6f72 2075 7365 2077 6974 n is for use wit │ │ │ -00237e90: 6820 6120 534f 4150 2063 6c69 656e 7420 h a SOAP client │ │ │ -00237ea0: 636f 6e74 6163 7469 6e67 2061 2057 532d contacting a WS- │ │ │ -00237eb0: 5472 7573 7420 0a09 656e 6470 6f69 6e74 Trust ..endpoint │ │ │ -00237ec0: 2066 6f72 2061 2073 6563 7572 6974 7920 for a security │ │ │ -00237ed0: 746f 6b65 6e2e 3c2f 7061 7261 3e0a 2020 token.. │ │ │ -00237ee0: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 . . │ │ │ -00237f10: 203c 7469 746c 653e 5061 7261 6d65 7465 Paramete │ │ │ -00237f20: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -00237f30: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -00237f40: 7265 713c 2f74 6974 6c65 3e0a 2020 2020 req. │ │ │ -00237f50: 2020 3c70 6172 613e 4120 5544 5420 636f A UDT co │ │ │ -00237f60: 6e74 6169 6e69 6e67 2073 6f61 705f 636c ntaining soap_cl │ │ │ -00237f70: 6965 6e74 2070 6172 616d 6574 6572 7320 ient parameters │ │ │ -00237f80: 6173 2064 6573 6372 6962 6564 2069 6e20 as described in │ │ │ -00237f90: 0a09 2020 5753 2d52 4d2e 3c2f 7061 7261 .. WS-RM.. . │ │ │ -00237fc0: 3c74 6974 6c65 3e70 6f6c 6963 793c 2f74 policy</t │ │ │ -00237fd0: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ -00237fe0: 613e 636f 6e74 6169 6e73 2070 6f6c 6963 a>contains polic │ │ │ -00237ff0: 7920 746f 2062 6520 6170 706c 6965 642c y to be applied, │ │ │ -00238000: 2061 6e20 6578 616d 706c 653a 3c2f 7061 an example:</pa │ │ │ -00238010: 7261 3e0a 3c70 726f 6772 616d 6c69 7374 ra>.<programlist │ │ │ -00238020: 696e 673e 3c21 5b43 4441 5441 5b0a 6372 ing><![CDATA[.cr │ │ │ -00238030: 6561 7465 2074 7970 6520 706f 6c69 6379 eate type policy │ │ │ -00238040: 5f73 7472 7563 7420 6173 200a 280a 2020 _struct as .(. │ │ │ -00238050: 7573 6167 6520 2d20 696e 7465 6772 6974 usage - integrit │ │ │ -00238060: 792f 636f 6e66 6964 656e 7469 616c 6974 y/confidentialit │ │ │ -00238070: 790a 2020 746f 6b65 6e5f 7479 7065 202d y. token_type - │ │ │ -00238080: 2077 7373 6520 746f 6b65 6e20 7479 7065 wsse token type │ │ │ -00238090: 3a20 7835 3039 3b20 636f 6e74 6578 7420 : x509; context │ │ │ -002380a0: 746f 6b65 6e20 6574 632e 0a20 2074 6f6b token etc.. tok │ │ │ -002380b0: 656e 5f69 7373 7565 7220 2d20 5552 4c20 en_issuer - URL │ │ │ -002380c0: 6f66 2074 6865 2069 7373 7565 720a 2020 of the issuer. │ │ │ -002380d0: 7573 6572 5f6e 616d 6520 2d20 7265 7072 user_name - repr │ │ │ -002380e0: 6573 656e 7420 746f 2069 7373 7565 722c esent to issuer, │ │ │ -002380f0: 0a20 2075 7365 725f 7061 7373 2c0a 2020 . user_pass,. │ │ │ -00238100: 6465 6275 6720 2d20 6475 6d70 2072 6571 debug - dump req │ │ │ -00238110: 2f72 6573 2e20 3120 2d20 666f 7220 5265 /res. 1 - for Re │ │ │ -00238120: 7175 6573 7453 6563 7572 6974 7954 6f6b questSecurityTok │ │ │ -00238130: 656e 2c20 3220 2d20 656e 6420 706f 696e en, 2 - end poin │ │ │ -00238140: 740a 2020 746f 6b65 6e20 2d20 6261 7365 t. token - base │ │ │ -00238150: 3634 2065 6e63 6f64 6564 2042 696e 6172 64 encoded Binar │ │ │ -00238160: 7920 5365 6375 7269 7479 2054 6f6b 656e y Security Token │ │ │ -00238170: 200a 290a 5d5d 3e3c 2f70 726f 6772 616d .).]]></program │ │ │ -00238180: 6c69 7374 696e 673e 0a20 2020 203c 2f72 listing>. </r │ │ │ -00238190: 6566 7365 6374 323e 0a20 203c 2f72 6566 efsect2>. </ref │ │ │ -002381a0: 7365 6374 313e 0a20 203c 7265 6673 6563 sect1>. <refsec │ │ │ -002381b0: 7431 2069 643d 2272 6574 5f77 7374 5f63 t1 id="ret_wst_c │ │ │ -002381c0: 6c69 223e 3c74 6974 6c65 3e52 6574 7572 li"><title>Retur │ │ │ -002381d0: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ -002381e0: 2020 2020 3c70 6172 613e 4120 7365 6375 A secu │ │ │ -002381f0: 7269 7479 2074 6f6b 656e 2e3c 2f70 6172 rity token.. │ │ │ -00238210: 0a3c 212d 2d20 2020 3c72 6566 7365 6374 .. . │ │ │ -00238470: 3c74 6974 6c65 3e53 6565 2041 6c73 6f3c See Also< │ │ │ -00238480: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -00238490: 613e 3c6c 696e 6b20 6c69 6e6b 656e 643d a><link linkend= │ │ │ -002384a0: 2277 6172 6d22 3e57 5320 5265 6c69 6162 "warm">WS Reliab │ │ │ -002384b0: 6c65 204d 6573 7361 6769 6e67 3c2f 6c69 le Messaging</li │ │ │ -002384c0: 6e6b 3e3c 2f70 6172 613e 0a20 203c 2f72 nk></para>. </r │ │ │ -002384d0: 6566 7365 6374 313e 0a3c 2f72 6566 656e efsect1>.</refen │ │ │ -002384e0: 7472 793e 0ab6 0000 0027 6465 6d6f 2f64 try>.....'demo/d │ │ │ -002384f0: 6f63 7372 632f 6675 6e63 7265 662f 7773 ocsrc/funcref/ws │ │ │ -00238500: 646c 5f69 6d70 6f72 745f 7564 742e 786d dl_import_udt.xm │ │ │ -00238510: 6cdf 0000 2602 3c3f 786d 6c20 7665 7273 l...&.<?xml vers │ │ │ -00238520: 696f 6e3d 2231 2e30 2220 656e 636f 6469 ion="1.0" encodi │ │ │ -00238530: 6e67 3d22 7574 662d 3822 203f 3e0a 3c21 ng="utf-8" ?>.<! │ │ │ -00238540: 2d2d 0a20 2d20 200a 202d 2020 5468 6973 --. - . - This │ │ │ -00238550: 2066 696c 6520 6973 2070 6172 7420 6f66 file is part of │ │ │ -00238560: 2074 6865 204f 7065 6e4c 696e 6b20 536f the OpenLink So │ │ │ -00238570: 6674 7761 7265 2056 6972 7475 6f73 6f20 ftware Virtuoso │ │ │ -00238580: 4f70 656e 2d53 6f75 7263 6520 2856 4f53 Open-Source (VOS │ │ │ -00238590: 290a 202d 2020 7072 6f6a 6563 742e 0a20 ). - project.. │ │ │ -002385a0: 2d20 200a 202d 2020 436f 7079 7269 6768 - . - Copyrigh │ │ │ -002385b0: 7420 2843 2920 3139 3938 2d32 3032 3420 t (C) 1998-2024 │ │ │ -002385c0: 4f70 656e 4c69 6e6b 2053 6f66 7477 6172 OpenLink Softwar │ │ │ -002385d0: 650a 202d 2020 0a20 2d20 2054 6869 7320 e. - . - This │ │ │ -002385e0: 7072 6f6a 6563 7420 6973 2066 7265 6520 project is free │ │ │ -002385f0: 736f 6674 7761 7265 3b20 796f 7520 6361 software; you ca │ │ │ -00238600: 6e20 7265 6469 7374 7269 6275 7465 2069 n redistribute i │ │ │ -00238610: 7420 616e 642f 6f72 206d 6f64 6966 7920 t and/or modify │ │ │ -00238620: 6974 0a20 2d20 2075 6e64 6572 2074 6865 it. - under the │ │ │ -00238630: 2074 6572 6d73 206f 6620 7468 6520 474e terms of the GN │ │ │ -00238640: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ -00238650: 204c 6963 656e 7365 2061 7320 7075 626c License as publ │ │ │ -00238660: 6973 6865 6420 6279 2074 6865 0a20 2d20 ished by the. - │ │ │ -00238670: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ -00238680: 6f75 6e64 6174 696f 6e3b 206f 6e6c 7920 oundation; only │ │ │ -00238690: 7665 7273 696f 6e20 3220 6f66 2074 6865 version 2 of the │ │ │ -002386a0: 204c 6963 656e 7365 2c20 6461 7465 6420 License, dated │ │ │ -002386b0: 4a75 6e65 2031 3939 312e 0a20 2d20 200a June 1991.. - . │ │ │ -002386c0: 202d 2020 5468 6973 2070 726f 6772 616d - This program │ │ │ -002386d0: 2069 7320 6469 7374 7269 6275 7465 6420 is distributed │ │ │ -002386e0: 696e 2074 6865 2068 6f70 6520 7468 6174 in the hope that │ │ │ -002386f0: 2069 7420 7769 6c6c 2062 6520 7573 6566 it will be usef │ │ │ -00238700: 756c 2c20 6275 740a 202d 2020 5749 5448 ul, but. - WITH │ │ │ -00238710: 4f55 5420 414e 5920 5741 5252 414e 5459 OUT ANY WARRANTY │ │ │ -00238720: 3b20 7769 7468 6f75 7420 6576 656e 2074 ; without even t │ │ │ -00238730: 6865 2069 6d70 6c69 6564 2077 6172 7261 he implied warra │ │ │ -00238740: 6e74 7920 6f66 0a20 2d20 204d 4552 4348 nty of. - MERCH │ │ │ -00238750: 414e 5441 4249 4c49 5459 206f 7220 4649 ANTABILITY or FI │ │ │ -00238760: 544e 4553 5320 464f 5220 4120 5041 5254 TNESS FOR A PART │ │ │ -00238770: 4943 554c 4152 2050 5552 504f 5345 2e20 ICULAR PURPOSE. │ │ │ -00238780: 5365 6520 7468 6520 474e 550a 202d 2020 See the GNU. - │ │ │ -00238790: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ -002387a0: 6963 656e 7365 2066 6f72 206d 6f72 6520 icense for more │ │ │ -002387b0: 6465 7461 696c 732e 0a20 2d20 200a 202d details.. - . - │ │ │ -002387c0: 2020 596f 7520 7368 6f75 6c64 2068 6176 You should hav │ │ │ -002387d0: 6520 7265 6365 6976 6564 2061 2063 6f70 e received a cop │ │ │ -002387e0: 7920 6f66 2074 6865 2047 4e55 2047 656e y of the GNU Gen │ │ │ -002387f0: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ -00238800: 6e73 6520 616c 6f6e 670a 202d 2020 7769 nse along. - wi │ │ │ -00238810: 7468 2074 6869 7320 7072 6f67 7261 6d3b th this program; │ │ │ -00238820: 2069 6620 6e6f 742c 2077 7269 7465 2074 if not, write t │ │ │ -00238830: 6f20 7468 6520 4672 6565 2053 6f66 7477 o the Free Softw │ │ │ -00238840: 6172 6520 466f 756e 6461 7469 6f6e 2c20 are Foundation, │ │ │ -00238850: 496e 632e 2c0a 202d 2020 3531 2046 7261 Inc.,. - 51 Fra │ │ │ -00238860: 6e6b 6c69 6e20 5374 2c20 4669 6674 6820 nklin St, Fifth │ │ │ -00238870: 466c 6f6f 722c 2042 6f73 746f 6e2c 204d Floor, Boston, M │ │ │ -00238880: 4120 3032 3131 302d 3133 3031 2055 5341 A 02110-1301 USA │ │ │ -00238890: 0a20 2d20 200a 202d 2020 0a2d 2d3e 0a20 . - . - .-->. │ │ │ -002388a0: 203c 7265 6665 6e74 7279 2069 643d 2266 <refentry id="f │ │ │ -002388b0: 6e5f 7773 646c 5f69 6d70 6f72 745f 7564 n_wsdl_import_ud │ │ │ -002388c0: 7422 3e0a 2020 3c72 6566 6d65 7461 3e0a t">. <refmeta>. │ │ │ -002388d0: 2020 2020 3c72 6566 656e 7472 7974 6974 <refentrytit │ │ │ -002388e0: 6c65 3e77 7364 6c5f 696d 706f 7274 5f75 le>wsdl_import_u │ │ │ -002388f0: 6474 3c2f 7265 6665 6e74 7279 7469 746c dt</refentrytitl │ │ │ -00238900: 653e 0a20 2020 203c 7265 666d 6973 6369 e>. <refmisci │ │ │ -00238910: 6e66 6f3e 7773 3c2f 7265 666d 6973 6369 nfo>ws</refmisci │ │ │ -00238920: 6e66 6f3e 0a20 203c 2f72 6566 6d65 7461 nfo>. </refmeta │ │ │ -00238930: 3e0a 2020 3c72 6566 6e61 6d65 6469 763e >. <refnamediv> │ │ │ -00238940: 0a20 2020 203c 7265 666e 616d 653e 5753 . <refname>WS │ │ │ -00238950: 444c 5f49 4d50 4f52 545f 5544 543c 2f72 DL_IMPORT_UDT</r │ │ │ -00238960: 6566 6e61 6d65 3e0a 2020 2020 3c72 6566 efname>. <ref │ │ │ -00238970: 7075 7270 6f73 653e 5265 7475 726e 7320 purpose>Returns │ │ │ -00238980: 6120 7374 7269 6e67 2063 6f6e 7461 696e a string contain │ │ │ -00238990: 696e 6720 6120 5544 5420 6465 6669 6e69 ing a UDT defini │ │ │ -002389a0: 7469 6f6e 3c2f 7265 6670 7572 706f 7365 tion</refpurpose │ │ │ -002389b0: 3e0a 2020 3c2f 7265 666e 616d 6564 6976 >. </refnamediv │ │ │ -002389c0: 3e0a 2020 3c72 6566 7379 6e6f 7073 6973 >. <refsynopsis │ │ │ -002389d0: 6469 763e 0a20 2020 203c 6675 6e63 7379 div>. <funcsy │ │ │ -002389e0: 6e6f 7073 6973 2069 643d 2266 7379 6e5f nopsis id="fsyn_ │ │ │ -002389f0: 7773 646c 5f69 6d70 6f72 745f 7564 7422 wsdl_import_udt" │ │ │ -00238a00: 3e0a 2020 2020 2020 3c66 756e 6370 726f >. <funcpro │ │ │ -00238a10: 746f 7479 7065 2069 643d 2266 7072 6f74 totype id="fprot │ │ │ -00238a20: 6f5f 7773 646c 5f69 6d70 6f72 745f 7564 o_wsdl_import_ud │ │ │ -00238a30: 7422 3e0a 2020 2020 2020 2020 3c66 756e t">. <fun │ │ │ -00238a40: 6364 6566 3e76 6172 6368 6172 203c 6675 cdef>varchar <fu │ │ │ -00238a50: 6e63 7469 6f6e 3e57 5344 4c5f 494d 504f nction>WSDL_IMPO │ │ │ -00238a60: 5254 5f55 4454 3c2f 6675 6e63 7469 6f6e RT_UDT</function │ │ │ -00238a70: 3e3c 2f66 756e 6364 6566 3e0a 2020 2020 ></funcdef>. │ │ │ -00238a80: 2020 2020 3c70 6172 616d 6465 663e 696e <paramdef>in │ │ │ -00238a90: 203c 7061 7261 6d65 7465 723e 7572 6c3c <parameter>url< │ │ │ -00238aa0: 2f70 6172 616d 6574 6572 3e20 7661 7263 /parameter> varc │ │ │ -00238ab0: 6861 723c 2f70 6172 616d 6465 663e 0a20 har</paramdef>. │ │ │ -00238ac0: 2020 2020 2020 203c 7061 7261 6d64 6566 <paramdef │ │ │ -00238ad0: 3e69 6e20 3c70 6172 616d 6574 6572 3e66 >in <parameter>f │ │ │ -00238ae0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 </parameter> var │ │ │ -00238af0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char</paramdef>. │ │ │ -00238b00: 2020 2020 2020 2020 3c70 6172 616d 6465 <paramde │ │ │ -00238b10: 663e 696e 203c 7061 7261 6d65 7465 723e f>in <parameter> │ │ │ -00238b20: 6578 6563 3c2f 7061 7261 6d65 7465 723e exec</parameter> │ │ │ -00238b30: 2061 6e79 3c2f 7061 7261 6d64 6566 3e0a any</paramdef>. │ │ │ -00238b40: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 </funcprot │ │ │ -00238b50: 6f74 7970 653e 0a20 2020 203c 2f66 756e otype>. </fun │ │ │ -00238b60: 6373 796e 6f70 7369 733e 0a20 203c 2f72 csynopsis>. </r │ │ │ -00238b70: 6566 7379 6e6f 7073 6973 6469 763e 0a20 efsynopsisdiv>. │ │ │ -00238b80: 203c 7265 6673 6563 7431 2069 643d 2264 <refsect1 id="d │ │ │ -00238b90: 6573 635f 7773 646c 5f69 6d70 6f72 745f esc_wsdl_import_ │ │ │ -00238ba0: 7564 7422 3e0a 2020 2020 3c74 6974 6c65 udt">. <title │ │ │ -00238bb0: 3e44 6573 6372 6970 7469 6f6e 3c2f 7469 >Description</ti │ │ │ -00238bc0: 746c 653e 0a20 2020 203c 7061 7261 3e54 tle>. <para>T │ │ │ -00238bd0: 6869 7320 6675 6e63 7469 6f6e 2069 7320 his function is │ │ │ -00238be0: 7573 6564 2074 6f20 6372 6561 7465 2061 used to create a │ │ │ -00238bf0: 2075 7365 7220 6465 6669 6e65 6420 7479 user defined ty │ │ │ -00238c00: 7065 2028 5544 5429 2064 6566 696e 6974 pe (UDT) definit │ │ │ -00238c10: 696f 6e20 0a20 2020 2061 7574 6f6d 6174 ion . automat │ │ │ -00238c20: 6963 616c 6c79 2062 6173 6564 206f 6e20 ically based on │ │ │ -00238c30: 6120 5753 444c 2066 696c 652e 2020 5468 a WSDL file. Th │ │ │ -00238c40: 6520 736f 7572 6365 2057 5344 4c20 6973 e source WSDL is │ │ │ -00238c50: 2073 7570 706c 6965 6420 7669 6120 6120 supplied via a │ │ │ -00238c60: 5552 4c2e 3c2f 7061 7261 3e0a 2020 2020 URL.</para>. │ │ │ -00238c70: 3c70 6172 613e 5468 6520 7265 7475 726e <para>The return │ │ │ -00238c80: 6564 2064 6566 696e 6974 696f 6e20 6361 ed definition ca │ │ │ -00238c90: 6e20 6265 2073 6176 6564 2074 6f20 6120 n be saved to a │ │ │ -00238ca0: 6669 6c65 2061 6e64 2f6f 7220 6578 6563 file and/or exec │ │ │ -00238cb0: 7574 6564 2061 7574 6f6d 6174 6963 616c uted automatical │ │ │ -00238cc0: 6c79 200a 2020 2020 746f 2070 726f 7669 ly . to provi │ │ │ -00238cd0: 6465 2069 6e73 7461 6e74 2061 6363 6573 de instant acces │ │ │ -00238ce0: 7320 746f 2074 6865 206e 6577 2055 4454 s to the new UDT │ │ │ -00238cf0: 2e3c 2f70 6172 613e 0a20 2020 203c 6e6f .</para>. <no │ │ │ -00238d00: 7465 3e3c 7469 746c 653e 4e6f 7465 3a3c te><title>Note:< │ │ │ -00238d10: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. <par │ │ │ -00238d20: 613e 546f 2073 6176 6520 7468 6520 6669 a>To save the fi │ │ │ -00238d30: 6c65 2079 6f75 206d 7573 7420 6861 7665 le you must have │ │ │ -00238d40: 2061 6e20 6170 7072 6f70 7269 6174 6520 an appropriate │ │ │ -00238d50: 4143 4c20 6465 6669 6e65 642e 3c2f 7061 ACL defined.</pa │ │ │ -00238d60: 7261 3e0a 2020 2020 3c2f 6e6f 7465 3e0a ra>. </note>. │ │ │ -00238d70: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -00238d80: 3c72 6566 7365 6374 3120 6964 3d22 7061 <refsect1 id="pa │ │ │ -00238d90: 7261 6d73 5f77 7364 6c5f 696d 706f 7274 rams_wsdl_import │ │ │ -00238da0: 5f75 6474 223e 3c74 6974 6c65 3e50 6172 _udt"><title>Par │ │ │ -00238db0: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -00238dc0: 2020 2020 3c72 6566 7365 6374 323e 3c74 url │ │ │ -00238de0: 0a20 2020 2020 203c 7061 7261 3e54 6865 . The │ │ │ -00238df0: 2055 5249 206f 6620 7468 6520 7461 7267 URI of the targ │ │ │ -00238e00: 6574 2057 5344 4c20 6669 6c65 2074 6f20 et WSDL file to │ │ │ -00238e10: 6275 696c 6420 6120 5544 5420 6465 6669 build a UDT defi │ │ │ -00238e20: 6e69 7469 6f6e 206f 662e 3c2f 7061 7261 nition of.. │ │ │ -00238e40: 203c 7265 6673 6563 7432 3e3c 7469 746c f. │ │ │ -00238e60: 2020 3c70 6172 613e 5468 6520 6e61 6d65 The name │ │ │ -00238e70: 206f 6620 7468 6520 6669 6c65 2069 6620 of the file if │ │ │ -00238e80: 7468 6520 6465 6669 6e69 7469 6f6e 2069 the definition i │ │ │ -00238e90: 7320 746f 2062 6520 7361 7665 642e 2020 s to be saved. │ │ │ -00238ea0: 5468 6973 2077 696c 6c20 7072 6f64 7563 This will produc │ │ │ -00238eb0: 6520 6120 0a20 2020 2020 2066 696c 6520 e a . file │ │ │ -00238ec0: 6f6e 2074 6865 2066 696c 6520 7379 7374 on the file syst │ │ │ -00238ed0: 656d 2075 6e64 6572 2074 6865 2073 6572 em under the ser │ │ │ -00238ee0: 7665 7220 726f 6f74 2064 6972 6563 746f ver root directo │ │ │ -00238ef0: 7279 2e3c 2f70 6172 613e 0a3c 7061 7261 ry..The default val │ │ │ -00238f10: 7565 2069 7320 4e55 4c4c 2c20 7768 6963 ue is NULL, whic │ │ │ -00238f20: 6820 7769 6c6c 206e 6f74 2063 7265 6174 h will not creat │ │ │ -00238f30: 6520 6120 6669 6c65 2e3c 2f70 6172 613e e a file. │ │ │ -00238f40: 3c2f 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ -00238f50: 3c72 6566 7365 6374 323e 3c74 6974 6c65 exec. │ │ │ -00238f70: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ -00238f80: 6c61 6720 696e 6469 6361 7465 7320 7768 lag indicates wh │ │ │ -00238f90: 6574 6865 7220 7468 6520 6465 6669 6e69 ether the defini │ │ │ -00238fa0: 7469 6f6e 2073 686f 756c 6420 6265 2069 tion should be i │ │ │ -00238fb0: 6d6d 6564 6961 7465 6c79 200a 2020 2020 mmediately . │ │ │ -00238fc0: 2020 6578 6563 7574 6564 2075 706f 6e20 executed upon │ │ │ -00238fd0: 696d 706f 7274 2e20 2054 6869 7320 7461 import. This ta │ │ │ -00238fe0: 6b65 7320 7468 6520 666f 726d 206f 6620 kes the form of │ │ │ -00238ff0: 3020 6f72 2031 2e20 2054 6865 2064 6566 0 or 1. The def │ │ │ -00239000: 6175 6c74 2076 616c 7565 0a20 2020 2020 ault value. │ │ │ -00239010: 206f 6620 3020 7769 6c6c 206e 6f74 2065 of 0 will not e │ │ │ -00239020: 7865 6375 7465 2074 6865 2064 6566 696e xecute the defin │ │ │ -00239030: 6974 696f 6e2e 3c2f 7061 7261 3e3c 2f72 ition.. . Return Types< │ │ │ -00239090: 2f74 6974 6c65 3e0a 2020 2020 3c70 6172 /title>. This function │ │ │ -002390b0: 7265 7475 726e 7320 7468 6520 7465 7874 returns the text │ │ │ -002390c0: 206f 6620 7468 6520 5544 5420 6465 6669 of the UDT defi │ │ │ -002390d0: 6e69 7469 6f6e 2061 7320 6120 7661 7263 nition as a varc │ │ │ -002390e0: 6861 722e 3c2f 7061 7261 3e0a 2020 3c2f har.. ... │ │ │ -0023aef0: 0a20 2020 203c 7265 6665 6e74 7279 7469 . week . dconv │ │ │ -0023af30: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -0023af40: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ -0023af50: 7469 6d65 3c2f 7265 666d 6973 6369 6e66 time. │ │ │ -0023af70: 0a20 203c 7265 666e 616d 6564 6976 3e20 . │ │ │ -0023af80: 0a20 2020 203c 7265 666e 616d 653e 7765 . we │ │ │ -0023af90: 656b 3c2f 7265 666e 616d 653e 200a 2020 ek . │ │ │ -0023afa0: 2020 3c72 6566 7075 7270 6f73 653e 6765 ge │ │ │ -0023afb0: 7420 6e75 6d62 6572 206f 6620 7765 656b t number of week │ │ │ -0023afc0: 2066 726f 6d20 6120 6461 7465 7469 6d65 from a datetime │ │ │ -0023afd0: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ -0023afe0: 3c2f 7265 666e 616d 6564 6976 3e20 0a20 . │ │ │ -0023aff0: 203c 7265 6673 796e 6f70 7369 7364 6976 . . . │ │ │ -0023b050: 2020 2020 203c 6675 6e63 6465 663e 3c66 week ..in │ │ │ -0023b090: 203c 7061 7261 6d65 7465 723e 6474 3c2f dt datet │ │ │ -0023b0b0: 696d 653c 2f70 6172 616d 6465 663e 0a20 ime. │ │ │ -0023b0c0: 2020 2020 203c 2f66 756e 6370 726f 746f . . . │ │ │ -0023b100: 3c72 6566 7365 6374 3120 6964 3d22 6465 │ │ │ -0023b120: 4465 7363 7269 7074 696f 6e3c 2f74 6974 Description</tit │ │ │ -0023b130: 6c65 3e0a 2020 2020 3c70 6172 613e 3c66 le>. <para><f │ │ │ -0023b140: 756e 6374 696f 6e3e 7765 656b 3c2f 6675 unction>week</fu │ │ │ -0023b150: 6e63 7469 6f6e 3e20 7461 6b65 7320 6120 nction> takes a │ │ │ -0023b160: 3c74 7970 653e 6461 7465 7469 6d65 3c2f <type>datetime</ │ │ │ -0023b170: 7479 7065 3e20 616e 6420 7265 7475 726e type> and return │ │ │ -0023b180: 7320 0a20 2020 2061 6e20 3c74 7970 653e s . an <type> │ │ │ -0023b190: 696e 7465 6765 723c 2f74 7970 653e 2063 integer</type> c │ │ │ -0023b1a0: 6f6e 7461 696e 696e 6720 6120 6e75 6d62 ontaining a numb │ │ │ -0023b1b0: 6572 2072 6570 7265 7365 6e74 696e 6720 er representing │ │ │ -0023b1c0: 7468 6520 7765 656b 206f 6620 7965 6172 the week of year │ │ │ -0023b1d0: 206f 6620 7468 6520 6461 7465 7469 6d65 of the datetime │ │ │ -0023b1e0: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .</para>. </ref │ │ │ -0023b1f0: 7365 6374 313e 0a20 203c 7265 6673 6563 sect1>. <refsec │ │ │ -0023b200: 7431 2069 643d 2270 6172 616d 735f 7765 t1 id="params_we │ │ │ -0023b210: 656b 223e 3c74 6974 6c65 3e50 6172 616d ek"><title>Param │ │ │ -0023b220: 6574 6572 733c 2f74 6974 6c65 3e0a 2020 eters. │ │ │ -0023b230: 2020 3c72 6566 7365 6374 323e 3c74 6974 dt. │ │ │ -0023b250: 2020 2020 3c70 6172 613e 4120 3c74 7970 A datetime.. . . Return │ │ │ -0023b2c0: 5661 6c75 6573 3c2f 7469 746c 653e 0a20 Values. │ │ │ -0023b2d0: 2020 203c 7061 7261 3e41 6e20 3c74 7970 An INTEGER │ │ │ -0023b2f0: 2063 6f6e 7461 696e 696e 6720 6e75 6d62 containing numb │ │ │ -0023b300: 6572 206f 6620 7468 6520 7765 656b 206f er of the week o │ │ │ -0023b310: 6620 7965 6172 2e3c 2f70 6172 613e 3c2f f year... │ │ │ -0023b520: 203c 7265 6673 6563 7431 2069 643d 2265 Examples. │ │ │ -0023b570: 3c74 6974 6c65 3e53 696d 706c 6520 6578 Simple ex │ │ │ -0023b580: 616d 706c 653c 2f74 6974 6c65 3e0a 2020 ample. │ │ │ -0023b590: 2020 2020 3c70 6172 613e 4765 7420 6375 Get cu │ │ │ -0023b5a0: 7272 656e 7420 7765 656b 206f 6620 7965 rrent week of ye │ │ │ -0023b5b0: 6172 2e3c 2f70 6172 613e 0a20 2020 2020 ar.. │ │ │ -0023b5c0: 203c 7363 7265 656e 3e53 514c 3e20 7365 SQL> se │ │ │ -0023b5d0: 6c65 6374 2077 6565 6b20 286e 6f77 2028 lect week (now ( │ │ │ -0023b5e0: 2929 3b0a 6361 6c6c 7265 740a 494e 5445 ));.callret.INTE │ │ │ -0023b5f0: 4745 520a 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f GER.____________ │ │ │ -0023b600: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0023b610: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0023b620: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0023b630: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ -0023b640: 5f5f 5f0a 0a34 320a 0a3c 2f73 6372 6565 ___..42... . . │ │ │ -0023b670: 2020 3c72 6566 7365 6374 3120 6964 3d22 │ │ │ -0023b690: 5365 6520 416c 736f 3c2f 7469 746c 653e See Also │ │ │ -0023b6a0: 0a20 2020 203c 7061 7261 3e3c 6c69 6e6b . │ │ │ -0023b6d0: 6461 796e 616d 653c 2f66 756e 6374 696f dayname,. < │ │ │ -0023b6f0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0023b700: 5f6d 6f6e 7468 6e61 6d65 223e 3c66 756e _monthname">monthname< │ │ │ -0023b720: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>,. d │ │ │ -0023b760: 6179 6f66 6d6f 6e74 683c 2f66 756e 6374 ayofmonth,. │ │ │ -0023b780: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 dayofwee │ │ │ -0023b7b0: 6b3c 2f66 756e 6374 696f 6e3e 3c2f 6c69 k,. │ │ │ -0023b7f0: 6461 796f 6679 6561 723c 2f66 756e 6374 dayofyear,. │ │ │ -0023b810: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 quarter, │ │ │ -0023b850: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . month, │ │ │ -0023b890: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . year,. │ │ │ -0023b8d0: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 hour,. │ │ │ -0023b910: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 minute,. │ │ │ -0023b950: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 second, │ │ │ -0023b990: 0a20 2020 203c 6c69 6e6b 206c 696e 6b65 . timez │ │ │ -0023b9c0: 6f6e 653c 2f66 756e 6374 696f 6e3e 3c2f one. < │ │ │ -0023b9e0: 2f72 6566 7365 6374 313e 0a3c 2f72 6566 /refsect1>..........# │ │ │ -0023ba00: 6465 6d6f 2f64 6f63 7372 632f 6675 6e63 demo/docsrc/func │ │ │ -0023ba10: 7265 662f 7674 5f69 735f 6e6f 6973 652e ref/vt_is_noise. │ │ │ -0023ba20: 786d 6cdf 0000 0afc 3c3f 786d 6c20 7665 xml........ . │ │ │ -0023bde0: 2020 2020 3c72 6566 656e 7472 7974 6974 vt_is_noise. │ │ │ -0023be10: 2020 203c 7265 666d 6973 6369 6e66 6f3e │ │ │ -0023be20: 6674 3c2f 7265 666d 6973 6369 6e66 6f3e ft │ │ │ -0023be30: 0a20 203c 2f72 6566 6d65 7461 3e0a 2020 . . │ │ │ -0023be40: 3c72 6566 6e61 6d65 6469 763e 0a20 2020 . │ │ │ -0023be50: 203c 7265 666e 616d 653e 7674 5f69 735f vt_is_ │ │ │ -0023be60: 6e6f 6973 653c 2f72 6566 6e61 6d65 3e0a noise. │ │ │ -0023be70: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ -0023be80: 6465 7465 726d 696e 6573 2077 6865 7468 determines wheth │ │ │ -0023be90: 6572 2069 6e70 7574 2069 7320 6120 6e6f er input is a no │ │ │ -0023bea0: 6973 6520 776f 7264 3c2f 7265 6670 7572 ise word. . . . . │ │ │ -0023bf30: 2020 2020 2020 2020 3c66 756e 6364 6566 vt_is │ │ │ -0023bf50: 5f6e 6f69 7365 3c2f 6675 6e63 7469 6f6e _noise. │ │ │ -0023bf70: 2020 2020 3c70 6172 616d 6465 663e 696e in │ │ │ -0023bf80: 203c 7061 7261 6d65 7465 723e 776f 7264 word │ │ │ -0023bf90: 3c2f 7061 7261 6d65 7465 723e 2020 7661 va │ │ │ -0023bfa0: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ -0023bfb0: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in encoding varchar. │ │ │ -0023c000: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -0023c010: 7061 7261 6d65 7465 723e 6c61 6e67 7561 parameter>langua │ │ │ -0023c020: 6765 3c2f 7061 7261 6d65 7465 723e 2076 ge v │ │ │ -0023c030: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. . . < │ │ │ -0023c070: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -0023c080: 0a20 203c 7265 6673 6563 7431 2069 643d . Descri │ │ │ -0023c0b0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -0023c0c0: 2020 3c70 6172 613e 4465 7465 726d 696e Determin │ │ │ -0023c0d0: 6573 2077 6865 7468 6572 2069 6e70 7574 es whether input │ │ │ -0023c0e0: 2069 7320 6120 6e6f 6973 6520 776f 7264 is a noise word │ │ │ -0023c0f0: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .. . Parameters. word</ │ │ │ -0023c160: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -0023c170: 7261 3e4e 6172 726f 7720 7374 7269 6e67 ra>Narrow string │ │ │ -0023c180: 206f 6620 7468 6520 776f 7264 2074 6f20 of the word to │ │ │ -0023c190: 6265 2063 6865 636b 6564 3c2f 7061 7261 be checked</para │ │ │ -0023c1a0: 3e0a 2020 2020 3c2f 7265 6673 6563 7432 >. </refsect2 │ │ │ -0023c1b0: 3e0a 2020 2020 3c72 6566 7365 6374 323e >. <refsect2> │ │ │ -0023c1c0: 3c74 6974 6c65 3e65 6e63 6f64 696e 673c <title>encoding< │ │ │ -0023c1d0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ -0023c1e0: 6172 613e 7661 6c69 6420 656e 636f 6469 ara>valid encodi │ │ │ -0023c1f0: 6e67 2073 7472 696e 673c 2f70 6172 613e ng string</para> │ │ │ -0023c200: 0a20 2020 203c 2f72 6566 7365 6374 323e . </refsect2> │ │ │ -0023c210: 0a20 2020 203c 7265 6673 6563 7432 3e3c . <refsect2>< │ │ │ -0023c220: 7469 746c 653e 6c61 6e67 7561 6765 3c2f title>language</ │ │ │ -0023c230: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -0023c240: 7261 3e76 616c 6964 206c 616e 6775 6167 ra>valid languag │ │ │ -0023c250: 6520 7374 7269 6e67 3c2f 7061 7261 3e0a e string</para>. │ │ │ -0023c260: 2020 2020 3c2f 7265 6673 6563 7432 3e0a </refsect2>. │ │ │ -0023c270: 2020 3c2f 7265 6673 6563 7431 3e0a 2020 </refsect1>. │ │ │ -0023c280: 3c72 6566 7365 6374 3120 6964 3d22 7265 <refsect1 id="re │ │ │ -0023c290: 745f 7674 5f69 735f 6e6f 6973 6522 3e3c t_vt_is_noise">< │ │ │ -0023c2a0: 7469 746c 653e 5265 7475 726e 2056 616c title>Return Val │ │ │ -0023c2b0: 7565 733c 2f74 6974 6c65 3e0a 2020 2020 ues. │ │ │ -0023c2c0: 3c70 6172 613e 3120 6f72 2030 2e20 2054 1 or 0. T │ │ │ -0023c2d0: 6869 7320 6675 6e63 7469 6f6e 2077 696c his function wil │ │ │ -0023c2e0: 6c20 7265 7475 726e 2031 2069 6620 7468 l return 1 if th │ │ │ -0023c2f0: 6520 656e 636f 6465 6420 776f 7264 2069 e encoded word i │ │ │ -0023c300: 6e20 7468 6520 7370 6563 6966 6965 6420 n the specified │ │ │ -0023c310: 6c61 6e67 7561 6765 2069 730a 636f 6e73 language is.cons │ │ │ -0023c320: 6964 6572 6564 2061 206e 6f69 7365 2077 idered a noise w │ │ │ -0023c330: 6f72 642c 206f 7220 3020 6966 206e 6f74 ord, or 0 if not │ │ │ -0023c340: 2e3c 2f70 6172 613e 0a20 203c 2f72 6566 .. . Examples. Det │ │ │ -0023c3c0: 6572 6d69 6e69 6e67 2069 6620 6120 776f ermining if a wo │ │ │ -0023c3d0: 7264 2069 7320 6120 4e6f 6973 6520 576f rd is a Noise Wo │ │ │ -0023c3e0: 7264 3c2f 7469 746c 653e 0a20 2020 2020 rd. │ │ │ -0023c3f0: 203c 7072 6f67 7261 6d6c 6973 7469 6e67 .select vt_is_n │ │ │ -0023c410: 6f69 7365 2028 2761 272c 2027 5554 462d oise ('a', 'UTF- │ │ │ -0023c420: 3827 2c20 2758 2d41 4e59 2729 3b0a 2020 8', 'X-ANY');. │ │ │ -0023c430: 2020 2020 3c2f 7072 6f67 7261 6d6c 6973 . .will return 1 │ │ │ -0023c460: 0a20 2020 2020 203c 2f70 6172 613e 0a20 . . │ │ │ -0023c470: 2020 2020 203c 7072 6f67 7261 6d6c 6973 .select vt_ │ │ │ -0023c490: 6973 5f6e 6f69 7365 2028 2765 6666 6563 is_noise ('effec │ │ │ -0023c4a0: 7469 7665 272c 2027 5554 462d 3827 2c20 tive', 'UTF-8', │ │ │ -0023c4b0: 2758 2d41 4e59 2729 3b0a 2020 2020 2020 'X-ANY');. │ │ │ -0023c4c0: 3c2f 7072 6f67 7261 6d6c 6973 7469 6e67 . .w │ │ │ -0023c4e0: 696c 6c20 7265 7475 726e 2030 0a20 2020 ill return 0. │ │ │ -0023c4f0: 2020 203c 2f70 6172 613e 0a20 2020 203c . < │ │ │ -0023c500: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. ......#demo/do │ │ │ -0023c530: 6373 7263 2f66 756e 6372 6566 2f76 745f csrc/funcref/vt_ │ │ │ -0023c540: 6472 6f70 5f66 7474 2e78 6d6c df00 000c drop_ftt.xml.... │ │ │ -0023c550: b43c 3f78 6d6c 2076 6572 7369 6f6e 3d22 .... < │ │ │ -0023c900: 7265 666d 6574 613e 0a20 2020 203c 7265 refmeta>. VT_D │ │ │ -0023c920: 524f 505f 4654 543c 2f72 6566 656e 7472 ROP_FTT. ft. . . VT_DROP_FTT. drop fr │ │ │ -0023c9b0: 6565 2074 6578 7420 7472 6967 6765 723c ee text trigger< │ │ │ -0023c9c0: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -0023c9d0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -0023c9e0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -0023c9f0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . < │ │ │ -0023ca20: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -0023ca30: 3d22 6670 726f 746f 5f76 745f 6472 6f70 ="fproto_vt_drop │ │ │ -0023ca40: 5f66 7474 223e 0a20 2020 2020 2020 203c _ftt">. < │ │ │ -0023ca50: 6675 6e63 6465 663e 4442 2e44 4241 2e3c funcdef>DB.DBA.< │ │ │ -0023ca60: 6675 6e63 7469 6f6e 3e56 545f 4452 4f50 function>VT_DROP │ │ │ -0023ca70: 5f46 5454 3c2f 6675 6e63 7469 6f6e 3e3c _FTT< │ │ │ -0023ca80: 2f66 756e 6364 6566 3e0a 2020 2020 2020 /funcdef>. │ │ │ -0023ca90: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -0023caa0: 7061 7261 6d65 7465 723e 7461 7267 6574 parameter>target │ │ │ -0023cab0: 5f74 6162 6c65 5f6e 616d 653c 2f70 6172 _table_name varchar< │ │ │ -0023cad0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ -0023cae0: 2020 203c 7061 7261 6d64 6566 3e69 6e20 in │ │ │ -0023caf0: 3c70 6172 616d 6574 6572 3e6f 7074 5f64 opt_d │ │ │ -0023cb00: 6174 615f 636f 6c75 6d6e 206f 7220 4e55 ata_column or NU │ │ │ -0023cb10: 4c4c 3c2f 7061 7261 6d65 7465 723e 2076 LL v │ │ │ -0023cb20: 6172 6368 6172 3c2f 7061 7261 6d64 6566 archar. . . < │ │ │ -0023cb60: 2f72 6566 7379 6e6f 7073 6973 6469 763e /refsynopsisdiv> │ │ │ -0023cb70: 0a20 203c 7265 6673 6563 7431 2069 643d . Descri │ │ │ -0023cba0: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -0023cbb0: 2020 3c70 6172 613e 4472 6f70 7320 6672 Drops fr │ │ │ -0023cbc0: 6565 2074 6578 7420 7472 6967 6765 722e ee text trigger. │ │ │ -0023cbd0: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . Parameters</tit │ │ │ -0023cc20: 6c65 3e0a 2020 2020 3c72 6566 7365 6374 le>. <refsect │ │ │ -0023cc30: 323e 3c74 6974 6c65 3e44 4154 415f 434f 2><title>DATA_CO │ │ │ -0023cc40: 4c55 4d4e 3c2f 7469 746c 653e 0a20 2020 LUMN. │ │ │ -0023cc50: 2020 203c 7061 7261 3e63 6f6c 756d 6e20 column │ │ │ -0023cc60: 7768 6572 6520 636f 6e74 656e 7420 6973 where content is │ │ │ -0023cc70: 2073 746f 7265 643c 2f70 6172 613e 3c2f stored. t │ │ │ -0023cca0: 6172 6765 745f 7461 626c 655f 6e61 6d65 arget_table_name │ │ │ -0023ccb0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0023ccc0: 7061 7261 3e74 6865 2074 6162 6c65 2063 para>the table c │ │ │ -0023ccd0: 6f6e 7461 696e 696e 6720 7468 6520 7472 ontaining the tr │ │ │ -0023cce0: 6967 6765 723c 2f70 6172 613e 3c2f 7265 igger. .. See Also │ │ │ -0023d060: 3c2f 7469 746c 653e 0a20 2020 203c 7061 . vt_create_t │ │ │ -0023d0b0: 6578 745f 696e 6465 7828 293c 2f66 756e ext_index()

    . < │ │ │ -0023d0e0: 6c69 6e6b 206c 696e 6b65 6e64 3d22 666e link linkend="fn │ │ │ -0023d0f0: 5f76 745f 6261 7463 6822 3e3c 6675 6e63 _vt_batch">vt_batch()< │ │ │ -0023d110: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. │ │ │ -0023d160: 7674 5f62 6174 6368 5f75 7064 6174 6528 vt_batch_update( │ │ │ -0023d170: 293c 2f66 756e 6374 696f 6e3e 3c2f 6c69 ). < │ │ │ -0023d190: 7061 7261 3e3c 6c69 6e6b 206c 696e 6b65 para> │ │ │ -0023d1c0: 7674 5f62 6174 6368 5f66 6565 6428 293c vt_batch_feed()< │ │ │ -0023d1d0: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. ........,demo/d │ │ │ -0023d210: 6f63 7372 632f 6675 6e63 7265 662f 7674 ocsrc/funcref/vt │ │ │ -0023d220: 5f63 7265 6174 655f 7465 7874 5f69 6e64 _create_text_ind │ │ │ -0023d230: 6578 2e78 6d6c df00 0028 723c 3f78 6d6c ex.xml...(r.. │ │ │ -0023d5f0: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -0023d600: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -0023d610: 7674 5f63 7265 6174 655f 7465 7874 5f69 vt_create_text_i │ │ │ -0023d620: 6e64 6578 3c2f 7265 6665 6e74 7279 7469 ndex. ft. . . │ │ │ -0023d680: 7674 5f63 7265 6174 655f 7465 7874 5f69 vt_create_text_i │ │ │ -0023d690: 6e64 6578 3c2f 7265 666e 616d 653e 0a20 ndex. │ │ │ -0023d6a0: 2020 203c 7265 6670 7572 706f 7365 3e41 A │ │ │ -0023d6b0: 6464 2074 6578 7420 696e 6465 7820 746f dd text index to │ │ │ -0023d6c0: 2061 6e20 6578 6973 7469 6e67 2074 6162 an existing tab │ │ │ -0023d6d0: 6c65 3c2f 7265 6670 7572 706f 7365 3e0a le. │ │ │ -0023d6e0: 2020 3c2f 7265 666e 616d 6564 6976 3e0a . │ │ │ -0023d6f0: 2020 3c72 6566 7379 6e6f 7073 6973 6469 . . . │ │ │ -0023d770: 2020 2020 203c 6675 6e63 6465 663e 3c66 vt_creat │ │ │ -0023d790: 655f 7465 7874 5f69 6e64 6578 3c2f 6675 e_text_index. in table varchar
    . < │ │ │ -0023d800: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in col varchar. │ │ │ -0023d840: 2020 3c70 6172 616d 6465 663e 696e 203c in < │ │ │ -0023d850: 7061 7261 6d65 7465 723e 6964 5f63 6f6c parameter>id_col │ │ │ -0023d860: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ -0023d870: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ -0023d880: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ -0023d8a0: 6973 5f78 6d6c 3c2f 7061 7261 6d65 7465 is_xml integer.

    in defer_gene │ │ │ -0023d8f0: 7261 7469 6f6e 3c2f 7061 7261 6d65 7465 ration integer.

    in clustered_ │ │ │ -0023d940: 636f 6c75 6d6e 733c 2f70 6172 616d 6574 columns any. in use_hook_func │ │ │ -0023d990: 7469 6f6e 3c2f 7061 7261 6d65 7465 723e tion │ │ │ -0023d9a0: 2069 6e74 6567 6572 3c2f 7061 7261 6d64 integer. │ │ │ -0023d9d0: 696e 203c 7061 7261 6d65 7465 723e 6c61 in la │ │ │ -0023d9e0: 6e67 7561 6765 5f6e 616d 653c 2f70 6172 nguage_name varchar< │ │ │ -0023da00: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>.

    in │ │ │ -0023da40: 656e 636f 6469 6e67 5f6e 616d 653c 2f70 encoding_name

    intege │ │ │ -0023da60: 723c 2f6f 7074 696f 6e61 6c3e 3c2f 7061 r
    . │ │ │ -0023da80: 3c70 6172 616d 6465 663e 3c6f 7074 696f in silent integer . │ │ │ -0023dae0: 203c 2f66 756e 6370 726f 746f 7479 7065 . . . │ │ │ -0023db30: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ -0023db40: 6f6e 3c2f 7469 746c 653e 0a20 2020 203c on. < │ │ │ -0023db50: 7061 7261 3e0a 5468 6520 7674 5f63 7265 para>.The vt_cre │ │ │ -0023db60: 6174 655f 7465 7874 5f69 6e64 6578 2070 ate_text_index p │ │ │ -0023db70: 726f 6365 6475 7265 2061 6464 7320 6120 rocedure adds a │ │ │ -0023db80: 7465 7874 2069 6e64 6578 2074 6f20 616e text index to an │ │ │ -0023db90: 2065 7869 7374 696e 6720 7461 626c 652e existing table. │ │ │ -0023dba0: 0a54 6865 7265 2063 616e 2061 7420 6d6f .There can at mo │ │ │ -0023dbb0: 7374 2062 6520 6f6e 6520 7465 7874 2069 st be one text i │ │ │ -0023dbc0: 6e64 6578 2070 6572 2074 6162 6c65 2c20 ndex per table, │ │ │ -0023dbd0: 696e 636c 7564 696e 6720 7375 7065 7220 including super │ │ │ -0023dbe0: 7461 626c 6573 2061 6e64 0a73 7562 7461 tables and.subta │ │ │ -0023dbf0: 626c 6573 2e0a 2020 3c2f 7061 7261 3e0a bles.. . │ │ │ -0023dc00: 2020 2020 3c70 6172 613e 0a54 6865 2074 .The t │ │ │ -0023dc10: 6162 6c65 2061 7267 756d 656e 7420 6973 able argument is │ │ │ -0023dc20: 2061 2073 7472 696e 6720 6e61 6d69 6e67 a string naming │ │ │ -0023dc30: 2074 6865 2074 6162 6c65 2e20 5468 6520 the table. The │ │ │ -0023dc40: 636f 6c75 6d6e 2069 7320 7468 6520 6e61 column is the na │ │ │ -0023dc50: 6d65 206f 6620 7468 6520 636f 6c75 6d6e me of the column │ │ │ -0023dc60: 0a74 6f20 696e 6465 782e 2054 6865 2069 .to index. The i │ │ │ -0023dc70: 645f 636f 6c20 7368 6f75 6c64 2062 6520 d_col should be │ │ │ -0023dc80: 7468 6520 6e61 6d65 206f 6620 6120 756e the name of a un │ │ │ -0023dc90: 6971 7565 2069 6e74 6567 6572 2072 6f77 ique integer row │ │ │ -0023dca0: 2069 6465 6e74 6966 6965 7220 636f 6c75 identifier colu │ │ │ -0023dcb0: 6d6e 2e20 2049 6620 6e75 6c6c 2c0a 7468 mn. If null,.th │ │ │ -0023dcc0: 6520 7379 7374 656d 2077 696c 6c20 6569 e system will ei │ │ │ -0023dcd0: 7468 6572 2061 6464 2073 7563 6820 6120 ther add such a │ │ │ -0023dce0: 636f 6c75 6d6e 206f 7220 7573 6520 616e column or use an │ │ │ -0023dcf0: 2065 7869 7374 696e 6720 696e 7465 6765 existing intege │ │ │ -0023dd00: 7220 7072 696d 6172 7920 6b65 7920 6966 r primary key if │ │ │ -0023dd10: 206f 6e65 0a69 7320 6176 6169 6c61 626c one.is availabl │ │ │ -0023dd20: 652e 2020 5468 6520 6973 5f78 6d6c 2061 e. The is_xml a │ │ │ -0023dd30: 7267 756d 656e 742c 2069 6620 6e6f 6e2d rgument, if non- │ │ │ -0023dd40: 302c 2073 7065 6369 6669 6573 2074 6861 0, specifies tha │ │ │ -0023dd50: 7420 7468 6520 7661 6c75 6573 206f 6620 t the values of │ │ │ -0023dd60: 7468 6520 696e 6465 7865 6420 636f 6c75 the indexed colu │ │ │ -0023dd70: 6d6e 0a73 686f 756c 6420 6265 2063 6865 mn.should be che │ │ │ -0023dd80: 636b 6564 2066 6f72 2058 4d4c 2077 656c cked for XML wel │ │ │ -0023dd90: 6c20 666f 726d 6564 6e65 7373 2061 6e64 l formedness and │ │ │ -0023dda0: 2074 6861 7420 7468 6520 584d 4c20 7374 that the XML st │ │ │ -0023ddb0: 7275 6374 7572 6520 7368 6f75 6c64 2062 ructure should b │ │ │ -0023ddc0: 6520 7461 6b65 6e20 696e 746f 2061 6363 e taken into acc │ │ │ -0023ddd0: 6f75 6e74 2069 6e20 696e 6465 7869 6e67 ount in indexing │ │ │ -0023dde0: 2074 6865 0a76 616c 7565 732e 0a20 203c the.values.. < │ │ │ -0023ddf0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. .Use the CREATE │ │ │ -0023de10: 2054 4558 5420 494e 4445 5820 7374 6174 TEXT INDEX stat │ │ │ -0023de20: 656d 656e 7420 6173 2061 6e20 616c 7465 ement as an alte │ │ │ -0023de30: 726e 6174 6976 6520 746f 2074 6865 2076 rnative to the v │ │ │ -0023de40: 745f 6372 6561 7465 5f74 6578 745f 696e t_create_text_in │ │ │ -0023de50: 6465 7820 6675 6e63 7469 6f6e 2e0a 2020 dex function.. │ │ │ -0023de60: 3c2f 7061 7261 3e0a 0909 0909 3c70 6172 ......In order for │ │ │ -0023de80: 6120 7461 626c 6520 746f 2062 6520 7265 a table to be re │ │ │ -0023de90: 6665 7265 6e63 6564 2069 6e20 6120 7465 ferenced in a te │ │ │ -0023dea0: 7874 2069 6e64 6578 2069 7420 6d75 7374 xt index it must │ │ │ -0023deb0: 2068 6176 650a 6120 756e 6971 7565 6c79 have.a uniquely │ │ │ -0023dec0: 2069 6465 6e74 6966 7969 6e67 2069 6e74 identifying int │ │ │ -0023ded0: 6567 6572 206b 6579 2e20 2049 6620 7468 eger key. If th │ │ │ -0023dee0: 6520 7461 626c 6520 696e 2071 7565 7374 e table in quest │ │ │ -0023def0: 696f 6e20 6861 7320 7375 6368 2061 200a ion has such a . │ │ │ -0023df00: 6b65 7920 7468 6973 2063 616e 2062 6520 key this can be │ │ │ -0023df10: 7573 6564 2061 7320 7468 6520 6964 2063 used as the id c │ │ │ -0023df20: 6f6c 756d 6e2e 2020 4966 2074 6865 7265 olumn. If there │ │ │ -0023df30: 2069 7320 6e6f 2073 7563 6820 636f 6c75 is no such colu │ │ │ -0023df40: 6d6e 2074 6869 7320 0a70 726f 6365 6475 mn this .procedu │ │ │ -0023df50: 7265 206d 616b 6573 206f 6e65 2e20 2055 re makes one. U │ │ │ -0023df60: 7369 6e67 2061 2070 7265 7669 6f75 736c sing a previousl │ │ │ -0023df70: 7920 6578 6973 7469 6e67 2069 6465 6e74 y existing ident │ │ │ -0023df80: 6966 6965 7220 636f 6c75 6d6e 2073 6176 ifier column sav │ │ │ -0023df90: 6573 200a 7370 6163 6520 616e 6420 6966 es .space and if │ │ │ -0023dfa0: 2074 6861 7420 6973 2074 6865 2070 7269 that is the pri │ │ │ -0023dfb0: 6d61 7279 206b 6579 206f 6620 7468 6520 mary key of the │ │ │ -0023dfc0: 7461 626c 6520 7468 6973 2061 6c73 6f20 table this also │ │ │ -0023dfd0: 7361 7665 7320 696e 200a 7265 7472 6965 saves in .retrie │ │ │ -0023dfe0: 7661 6c20 7469 6d65 2e0a 093c 2f70 6172 val time........If │ │ │ -0023e000: 7468 6520 7461 626c 6520 6265 696e 6720 the table being │ │ │ -0023e010: 696e 6465 7865 6420 6861 7320 6120 7369 indexed has a si │ │ │ -0023e020: 6e67 6c65 2070 6172 7420 696e 7465 6765 ngle part intege │ │ │ -0023e030: 7220 7072 696d 6172 7920 6b65 7920 0a76 r primary key .v │ │ │ -0023e040: 745f 6372 6561 7465 5f74 6578 745f 696e t_create_text_in │ │ │ -0023e050: 6465 7820 7769 6c6c 2061 7574 6f6d 6174 dex will automat │ │ │ -0023e060: 6963 616c 6c79 2075 7365 2074 6869 7320 ically use this │ │ │ -0023e070: 6173 2074 6865 2069 6465 6e74 6966 6965 as the identifie │ │ │ -0023e080: 722e 2020 4e6f 7465 200a 7468 6174 2074 r. Note .that t │ │ │ -0023e090: 6865 207a 6572 6f20 616e 6420 6e65 6761 he zero and nega │ │ │ -0023e0a0: 7469 7665 206e 756d 6265 7273 206d 6179 tive numbers may │ │ │ -0023e0b0: 206e 6f74 2062 6520 7573 6564 2061 7320 not be used as │ │ │ -0023e0c0: 6964 656e 7469 6669 6572 2076 616c 7565 identifier value │ │ │ -0023e0d0: 732e 0a09 3c2f 7061 7261 3e0a 0909 093c s.......< │ │ │ -0023e0e0: 7061 7261 3e0a 4372 6561 7469 6e67 2074 para>.Creating t │ │ │ -0023e0f0: 6865 2069 6e64 6578 2077 696c 6c20 7265 he index will re │ │ │ -0023e100: 6164 2074 6872 6f75 6768 2074 6865 2074 ad through the t │ │ │ -0023e110: 6162 6c65 2661 706f 733b 7320 636f 6e74 able's cont │ │ │ -0023e120: 656e 7473 2061 6e64 2067 656e 6572 6174 ents and generat │ │ │ -0023e130: 6520 0a74 6865 2069 6e64 6578 2e20 2057 e .the index. W │ │ │ -0023e140: 6865 6e20 7468 6520 7461 626c 6520 6973 hen the table is │ │ │ -0023e150: 2063 6861 6e67 6564 2074 6865 2069 6e64 changed the ind │ │ │ -0023e160: 6578 2063 616e 2065 6974 6865 7220 6265 ex can either be │ │ │ -0023e170: 2075 7064 6174 6564 2061 6674 6572 200a updated after . │ │ │ -0023e180: 6561 6368 2063 6861 6e67 6520 6f72 2070 each change or p │ │ │ -0023e190: 6572 696f 6469 6361 6c6c 792c 2064 6570 eriodically, dep │ │ │ -0023e1a0: 656e 6469 6e67 206f 6e20 7468 6520 6170 ending on the ap │ │ │ -0023e1b0: 706c 6963 6174 696f 6e20 6e65 6564 732e plication needs. │ │ │ -0023e1c0: 2020 5468 6520 7261 7469 6f6e 616c 6520 The rationale │ │ │ -0023e1d0: 0a66 6f72 2062 6163 6b67 726f 756e 6420 .for background │ │ │ -0023e1e0: 6d61 696e 7465 6e61 6e63 6520 6f66 2074 maintenance of t │ │ │ -0023e1f0: 6865 2074 6578 7420 696e 6465 7820 6973 he text index is │ │ │ -0023e200: 2074 6861 7420 6974 2069 7320 7570 2074 that it is up t │ │ │ -0023e210: 6f20 7365 7665 7261 6c20 7469 6d65 730a o several times. │ │ │ -0023e220: 6d6f 7265 2065 6666 6963 6965 6e74 2074 more efficient t │ │ │ -0023e230: 6f20 6d61 696e 7461 696e 2061 2074 6578 o maintain a tex │ │ │ -0023e240: 7420 696e 6465 7820 696e 2062 6174 6368 t index in batch │ │ │ -0023e250: 6573 206f 6620 7365 7665 7261 6c20 6368 es of several ch │ │ │ -0023e260: 616e 6765 6420 646f 6375 6d65 6e74 7320 anged documents │ │ │ -0023e270: 0a74 6861 6e20 6166 7465 7220 6561 6368 .than after each │ │ │ -0023e280: 2073 696e 676c 6520 646f 6375 6d65 6e74 single document │ │ │ -0023e290: 2063 6861 6e67 652e 2020 5468 6520 6465 change. The de │ │ │ -0023e2a0: 6661 756c 7420 6d61 696e 7465 6e61 6e63 fault maintenanc │ │ │ -0023e2b0: 6520 6d6f 6465 2069 7320 0a73 796e 6368 e mode is .synch │ │ │ -0023e2c0: 726f 6e6f 7573 2c20 6d65 616e 696e 6720 ronous, meaning │ │ │ -0023e2d0: 7468 6174 2065 6163 6820 696e 7365 7274 that each insert │ │ │ -0023e2e0: 2c20 6465 6c65 7465 206f 7220 7570 6461 , delete or upda │ │ │ -0023e2f0: 7465 206f 6620 7468 6520 696e 6465 7865 te of the indexe │ │ │ -0023e300: 6420 636f 6c75 6d6e 200a 7769 6c6c 2062 d column .will b │ │ │ -0023e310: 6520 696d 6d65 6469 6174 656c 7920 7265 e immediately re │ │ │ -0023e320: 666c 6563 7465 6420 696e 2074 6865 2069 flected in the i │ │ │ -0023e330: 6e64 6578 2e20 2054 6869 7320 6d6f 6465 ndex. This mode │ │ │ -0023e340: 2063 616e 2062 6520 7365 7420 7573 696e can be set usin │ │ │ -0023e350: 6720 0a74 6865 203c 6675 6e63 7469 6f6e g .the vt_batch_update │ │ │ -0023e370: 2829 3c2f 6675 6e63 7469 6f6e 3e20 7072 () pr │ │ │ -0023e380: 6f63 6564 7572 652e 0a54 6865 206d 6f64 ocedure..The mod │ │ │ -0023e390: 6520 7368 6f75 6c64 2062 6520 7365 7420 e should be set │ │ │ -0023e3a0: 746f 2062 6174 6368 2069 6620 7468 6572 to batch if ther │ │ │ -0023e3b0: 6520 6172 6520 0a61 6e79 206d 6173 7369 e are .any massi │ │ │ -0023e3c0: 7665 206f 7065 7261 7469 6f6e 7320 6f6e ve operations on │ │ │ -0023e3d0: 2074 6865 2074 6162 6c65 2e0a 093c 2f70 the table...

    .....I │ │ │ -0023e3f0: 7420 7769 6c6c 2063 7265 6174 6520 7477 t will create tw │ │ │ -0023e400: 6f20 6164 6469 7469 6f6e 616c 2074 6162 o additional tab │ │ │ -0023e410: 6c65 733a 0a09 3c2f 7061 7261 3e0a 0909 les:..... │ │ │ -0023e420: 093c 7363 7265 656e 3e0a 2026 6c74 3b64 .. <d │ │ │ -0023e430: 6174 6174 6162 6c65 2667 743b 5f26 6c74 atatable>_< │ │ │ -0023e440: 3b64 6174 6163 6f6c 756d 6e26 6774 3b5f ;datacolumn>_ │ │ │ -0023e450: 574f 5244 530a 093c 2f73 6372 6565 6e3e WORDS.. │ │ │ -0023e460: 0a09 0909 3c70 6172 613e 0a20 616e 640a ..... and. │ │ │ -0023e470: 093c 2f70 6172 613e 0a09 0909 3c73 6372 ......VTLOG_<d │ │ │ -0023e490: 6174 6174 6162 6c65 5f71 7561 6c69 6669 atatable_qualifi │ │ │ -0023e4a0: 6572 6926 6774 3b5f 266c 743b 6461 7461 eri>_<data │ │ │ -0023e4b0: 5f74 6162 6c65 5f6f 776e 6572 2667 743b _table_owner> │ │ │ -0023e4c0: 5f26 6c74 3b64 6174 615f 7461 626c 655f _<data_table_ │ │ │ -0023e4d0: 6e61 6d65 2667 743b 0a09 3c2f 7363 7265 name>....... a │ │ │ -0023e4f0: 6e64 2074 776f 2070 726f 6365 6475 7265 nd two procedure │ │ │ -0023e500: 733a 0a09 3c2f 7061 7261 3e0a 0909 093c s:......< │ │ │ -0023e510: 7363 7265 656e 3e0a 2076 745f 696e 6465 screen>. vt_inde │ │ │ -0023e520: 785f 266c 743b 6461 7461 7461 626c 655f x_<datatable_ │ │ │ -0023e530: 7175 616c 6966 6965 7226 6774 3b5f 266c qualifier>_&l │ │ │ -0023e540: 743b 6461 7461 5f74 6162 6c65 5f6f 776e t;data_table_own │ │ │ -0023e550: 6572 2667 743b 5f26 6c74 3b64 6174 615f er>_<data_ │ │ │ -0023e560: 7461 626c 655f 6e61 6d65 2667 743b 200a table_name> . │ │ │ -0023e570: 0909 2869 6e20 746f 5f64 656c 6574 6520 ..(in to_delete │ │ │ -0023e580: 696e 7465 6765 7229 0a09 3c2f 7363 7265 integer)....... a │ │ │ -0023e5a0: 6e64 0a09 3c2f 7061 7261 3e0a 0909 093c nd......< │ │ │ -0023e5b0: 7363 7265 656e 3e0a 2076 745f 696e 635f screen>. vt_inc_ │ │ │ -0023e5c0: 696e 6465 7826 6c74 3b64 6174 6174 6162 index<datatab │ │ │ -0023e5d0: 6c65 5f71 7561 6c69 6669 6572 6926 6774 le_qualifieri> │ │ │ -0023e5e0: 3b5f 266c 743b 6461 7461 5f74 6162 6c65 ;_<data_table │ │ │ -0023e5f0: 5f6f 776e 6572 2667 743b 5f26 6c74 3b64 _owner>_<d │ │ │ -0023e600: 6174 615f 7461 626c 655f 6e61 6d65 2667 ata_table_name&g │ │ │ -0023e610: 743b 2028 292e 0a3c 2f73 6372 6565 6e3e t; ().. │ │ │ -0023e620: 0a09 0909 3c70 6172 613e 0a54 6865 2074 .....The t │ │ │ -0023e630: 6162 6c65 2026 6c74 3b64 6174 6174 6162 able <datatab │ │ │ -0023e640: 6c65 2667 743b 5f26 6c74 3b64 6174 6166 le>_<dataf │ │ │ -0023e650: 6965 6c64 2667 743b 5f57 4f52 4453 2063 ield>_WORDS c │ │ │ -0023e660: 6f6e 7461 696e 7320 7468 6520 6675 6c6c ontains the full │ │ │ -0023e670: 2074 6578 7420 696e 6465 7820 6461 7461 text index data │ │ │ -0023e680: 2e0a 3c2f 7061 7261 3e0a 0909 093c 7061 .......The table VT │ │ │ -0023e6a0: 4c4f 475f 266c 743b 6461 7461 7461 626c LOG_<datatabl │ │ │ -0023e6b0: 6526 6774 3b5f 266c 743b 6461 7461 6669 e>_<datafi │ │ │ -0023e6c0: 656c 6426 6774 3b20 6973 2061 6e20 7570 eld> is an up │ │ │ -0023e6d0: 6461 7465 2074 7261 636b 696e 6720 7461 date tracking ta │ │ │ -0023e6e0: 626c 652c 2073 696d 696c 6172 2074 6f20 ble, similar to │ │ │ -0023e6f0: 7468 6520 736e 6170 7368 6f74 206c 6f67 the snapshot log │ │ │ -0023e700: 2074 6162 6c65 2062 7574 2075 7369 6e67 table but using │ │ │ -0023e710: 2074 6865 206b 6579 2063 6f6c 756d 6e20 the key column │ │ │ -0023e720: 696e 7374 6561 6420 6f66 2074 6865 2070 instead of the p │ │ │ -0023e730: 7269 6d61 7279 206b 6579 2e0a 3c2f 7061 rimary key.... < │ │ │ -0023e750: 7469 746c 653e 4e6f 7465 3a3c 2f74 6974 title>Note:. │ │ │ -0023e770: 696e 2074 6865 2074 7261 6e73 6163 7469 in the transacti │ │ │ -0023e780: 6f6e 2073 656d 616e 7469 6373 2073 6563 on semantics sec │ │ │ -0023e790: 7469 6f6e 2074 6861 7420 7468 6572 6520 tion that there │ │ │ -0023e7a0: 6973 2074 6865 2073 796e 6320 6d6f 6465 is the sync mode │ │ │ -0023e7b0: 2066 6f72 2074 6865 2070 7572 706f 7365 for the purpose │ │ │ -0023e7c0: 206f 6620 6372 6561 7469 6e67 2061 2074 of creating a t │ │ │ -0023e7d0: 6578 7420 696e 6465 782e 3c2f 7061 7261 ext index.... . Paramete │ │ │ -0023e820: 7273 3c2f 7469 746c 653e 0a20 2020 203c rs. < │ │ │ -0023e830: 7265 6673 6563 7432 3e3c 7469 746c 653e refsect2> │ │ │ -0023e840: 7461 626c 653c 2f74 6974 6c65 3e0a 2020 table. │ │ │ -0023e850: 2020 2020 3c70 6172 613e 7468 6520 7461 the ta │ │ │ -0023e860: 626c 6520 636f 6e74 6169 6e69 6e67 2074 ble containing t │ │ │ -0023e870: 6865 2064 6174 6120 746f 2069 6e64 6578 he data to index │ │ │ -0023e880: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .. col</ti │ │ │ -0023e8b0: 746c 653e 0a20 2020 2020 203c 7061 7261 tle>. <para │ │ │ -0023e8c0: 3e74 6865 2063 6f6c 756d 6e20 696e 2074 >the column in t │ │ │ -0023e8d0: 6865 2064 6174 6120 7461 626c 6520 636f he data table co │ │ │ -0023e8e0: 6e74 6169 6e69 6e67 2074 6865 2064 6174 ntaining the dat │ │ │ -0023e8f0: 6120 746f 2069 6e64 6578 2028 6120 6c6f a to index (a lo │ │ │ -0023e900: 6e67 2076 6172 6368 6172 2063 6f6c 756d ng varchar colum │ │ │ -0023e910: 6e29 2e3c 2f70 6172 613e 3c2f 7265 6673 n).</para></refs │ │ │ -0023e920: 6563 7432 3e0a 2020 2020 3c72 6566 7365 ect2>. <refse │ │ │ -0023e930: 6374 323e 3c74 6974 6c65 3e69 645f 636f ct2><title>id_co │ │ │ -0023e940: 6c3c 2f74 6974 6c65 3e0a 2020 2020 2020 l. │ │ │ -0023e950: 3c70 6172 613e 616e 2069 6e74 6567 6572 an integer │ │ │ -0023e960: 2075 6e69 7175 6520 696e 6465 7865 6420 unique indexed │ │ │ -0023e970: 636f 6c75 6d6e 2075 7365 6420 6279 2074 column used by t │ │ │ -0023e980: 6865 2066 7265 6520 7465 7874 2069 6e64 he free text ind │ │ │ -0023e990: 6578 2061 7320 6120 6b65 792e 2020 4966 ex as a key. If │ │ │ -0023e9a0: 2056 6972 7475 6f73 6f20 7472 6965 7320 Virtuoso tries │ │ │ -0023e9b0: 200a 746f 2063 686f 6f73 6520 7375 6368 .to choose such │ │ │ -0023e9c0: 2061 2063 6f6c 756d 6e20 616d 6f6e 6720 a column among │ │ │ -0023e9d0: 7468 6520 6578 6973 7469 6e67 2069 6e20 the existing in │ │ │ -0023e9e0: 7468 6520 7461 626c 6520 616e 6420 6966 the table and if │ │ │ -0023e9f0: 2069 7420 646f 6573 6e26 6170 6f73 3b74 it doesn't │ │ │ -0023ea00: 2066 696e 6420 6120 7375 6974 6162 6c65 find a suitable │ │ │ -0023ea10: 2063 6f6c 756d 6e20 6974 200a 6164 6473 column it .adds │ │ │ -0023ea20: 2073 7563 6820 6120 636f 6c75 6d6e 2077 such a column w │ │ │ -0023ea30: 6974 6820 7468 6520 6e61 6d65 2026 6c74 ith the name < │ │ │ -0023ea40: 3b64 6174 6163 6f6c 756d 6e26 6774 3b5f ;datacolumn>_ │ │ │ -0023ea50: 4944 2c20 6669 6c6c 7320 7468 6174 2075 ID, fills that u │ │ │ -0023ea60: 7020 616e 6420 6d61 6b65 7320 616e 2075 p and makes an u │ │ │ -0023ea70: 6e69 7175 6520 696e 6465 7820 6f6e 2069 nique index on i │ │ │ -0023ea80: 742e 3c2f 7061 7261 3e3c 2f72 6566 7365 t.. is_xml │ │ │ -0023eab0: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0023eac0: 7061 7261 3e69 6620 6772 6561 7465 7220 para>if greater │ │ │ -0023ead0: 7468 616e 2030 2069 6e73 7461 6c6c 7320 than 0 installs │ │ │ -0023eae0: 7477 6f20 6164 6469 7469 6f6e 616c 2074 two additional t │ │ │ -0023eaf0: 7269 6767 6572 7320 6265 666f 7265 2069 riggers before i │ │ │ -0023eb00: 6e73 6572 7420 616e 6420 6265 666f 7265 nsert and before │ │ │ -0023eb10: 2075 7064 6174 6520 6f6e 2074 6865 2064 update on the d │ │ │ -0023eb20: 6174 6120 7461 626c 6520 0a74 6f20 656e ata table .to en │ │ │ -0023eb30: 7375 7265 2074 6865 2064 6174 6120 6265 sure the data be │ │ │ -0023eb40: 696e 6720 696e 7365 7274 6564 2069 6e74 ing inserted int │ │ │ -0023eb50: 6f20 6974 2061 7265 2076 616c 6964 2058 o it are valid X │ │ │ -0023eb60: 4d4c 2064 6f63 756d 656e 7473 2e3c 2f70 ML documents.

    . │ │ │ -0023eb80: 2020 2020 3c72 6566 7365 6374 323e 3c74 defer_gener │ │ │ -0023eba0: 6174 696f 6e3c 2f74 6974 6c65 3e0a 2020 ation. │ │ │ -0023ebb0: 2020 2020 3c70 6172 613e 6966 206e 6f6e if non │ │ │ -0023ebc0: 7a65 726f 2074 6865 6e20 7468 6520 6672 zero then the fr │ │ │ -0023ebd0: 6565 2d74 6578 7420 696e 6465 7820 7769 ee-text index wi │ │ │ -0023ebe0: 6c6c 206e 6f74 2062 6520 6669 6c6c 6564 ll not be filled │ │ │ -0023ebf0: 2062 7920 6163 7475 616c 2064 6174 610a by actual data. │ │ │ -0023ec00: 696d 6d65 6469 6174 656c 7920 6166 7465 immediately afte │ │ │ -0023ec10: 7220 7468 6520 6372 6561 7469 6f6e 2e20 r the creation. │ │ │ -0023ec20: 4974 2077 696c 6c20 7265 6d61 696e 2065 It will remain e │ │ │ -0023ec30: 6d70 7479 2075 6e74 696c 2065 7870 6c69 mpty until expli │ │ │ -0023ec40: 6369 7420 7265 7175 6573 7420 666f 720a cit request for. │ │ │ -0023ec50: 2671 756f 743b 696e 6372 656d 656e 7461 "incrementa │ │ │ -0023ec60: 6c20 696e 6465 7869 6e67 2671 756f 743b l indexing" │ │ │ -0023ec70: 2e3c 2f70 6172 613e 3c2f 7265 6673 6563 .
    . cluster │ │ │ -0023eca0: 6564 5f63 6f6c 756d 6e73 3c2f 7469 746c ed_columns</titl │ │ │ -0023ecb0: 653e 0a20 2020 2020 203c 7061 7261 3e61 e>. <para>a │ │ │ -0023ecc0: 2076 6563 746f 7220 6f66 206e 616d 6573 vector of names │ │ │ -0023ecd0: 206f 6620 2671 756f 743b 636c 7573 7465 of "cluste │ │ │ -0023ece0: 7265 6420 636f 6c75 6d6e 7326 7175 6f74 red columns" │ │ │ -0023ecf0: 3b20 6f72 204e 554c 4c20 746f 206e 6f74 ; or NULL to not │ │ │ -0023ed00: 2073 746f 7265 2073 7563 6820 6461 7461 store such data │ │ │ -0023ed10: 2069 6e20 7468 6520 696e 6465 782e 3c2f in the index.</ │ │ │ -0023ed20: 7061 7261 3e3c 2f72 6566 7365 6374 323e para></refsect2> │ │ │ -0023ed30: 0a20 2020 203c 7265 6673 6563 7432 3e3c . <refsect2>< │ │ │ -0023ed40: 7469 746c 653e 7573 655f 686f 6f6b 5f66 title>use_hook_f │ │ │ -0023ed50: 756e 6374 696f 6e3c 2f74 6974 6c65 3e0a unction. │ │ │ -0023ed60: 2020 2020 2020 3c70 6172 613e 6966 206e if n │ │ │ -0023ed70: 6f6e 7a65 726f 2c20 7477 6f20 7573 6572 onzero, two user │ │ │ -0023ed80: 2d64 6566 696e 6564 2056 6972 7475 6f73 -defined Virtuos │ │ │ -0023ed90: 6f2f 504c 2066 756e 6374 696f 6e73 2077 o/PL functions w │ │ │ -0023eda0: 696c 6c20 6265 0a63 616c 6c65 6420 7768 ill be.called wh │ │ │ -0023edb0: 656e 2066 7265 652d 7465 7874 2064 6174 en free-text dat │ │ │ -0023edc0: 6120 6172 6520 7570 6461 7465 642c 206e a are updated, n │ │ │ -0023edd0: 6f74 2074 6865 2064 6566 6175 6c74 2073 ot the default s │ │ │ -0023ede0: 7973 7465 6d20 726f 7574 696e 652e 0a54 ystem routine..T │ │ │ -0023edf0: 6865 7365 2066 756e 6374 696f 6e73 2061 hese functions a │ │ │ -0023ee00: 7265 2072 6563 6f67 6e69 7a65 6420 6279 re recognized by │ │ │ -0023ee10: 2074 6865 6972 2073 7065 6369 616c 206e their special n │ │ │ -0023ee20: 616d 6573 3a0a 266c 743b 6461 7461 7461 ames:.<datata │ │ │ -0023ee30: 626c 6526 6774 3b5f 266c 743b 6461 7461 ble>_<data │ │ │ -0023ee40: 6669 656c 6426 6774 3b5f 494e 4445 585f field>_INDEX_ │ │ │ -0023ee50: 484f 4f4b 2077 696c 6c20 6265 2063 616c HOOK will be cal │ │ │ -0023ee60: 6c65 6420 746f 2069 6e64 6578 0a6e 6577 led to index.new │ │ │ -0023ee70: 2064 6f63 756d 656e 7473 2061 6e64 0a26 documents and.& │ │ │ -0023ee80: 6c74 3b64 6174 6174 6162 6c65 2667 743b lt;datatable> │ │ │ -0023ee90: 5f26 6c74 3b64 6174 6166 6965 6c64 2667 _<datafield&g │ │ │ -0023eea0: 743b 5f55 4e49 4e44 4558 5f48 4f4f 4b20 t;_UNINDEX_HOOK │ │ │ -0023eeb0: 7769 6c6c 2062 6520 6361 6c6c 6564 2074 will be called t │ │ │ -0023eec0: 6f0a 7265 6d6f 7665 206f 6273 6f6c 6574 o.remove obsolet │ │ │ -0023eed0: 6520 696e 6465 7820 696e 666f 726d 6174 e index informat │ │ │ -0023eee0: 696f 6e20 6162 6f75 7420 6465 6c65 7465 ion about delete │ │ │ -0023eef0: 6420 646f 6375 6d65 6e74 732e 3c2f 7061 d documents.. │ │ │ -0023ef10: 2020 203c 7265 6673 6563 7432 3e3c 7469 language_nam │ │ │ -0023ef30: 653c 2f74 6974 6c65 3e0a 2020 2020 2020 e. │ │ │ -0023ef40: 3c70 6172 613e 7468 6520 6e61 6d65 206f the name o │ │ │ -0023ef50: 6620 7468 6520 6c61 6e67 7561 6765 2074 f the language t │ │ │ -0023ef60: 6861 7420 6973 2075 7365 6420 666f 7220 hat is used for │ │ │ -0023ef70: 6275 696c 6469 6e67 2074 6865 2069 6e64 building the ind │ │ │ -0023ef80: 6578 2e0a 4966 2074 6865 2070 6172 616d ex..If the param │ │ │ -0023ef90: 6574 6572 2069 7320 6f6d 6974 7465 6420 eter is omitted │ │ │ -0023efa0: 6f72 2069 7320 6571 7561 6c20 746f 2027 or is equal to ' │ │ │ -0023efb0: 2a69 6e69 2a27 2073 7472 696e 672c 2069 *ini*' string, i │ │ │ -0023efc0: 6e64 6578 696e 6720 726f 7574 696e 6573 ndexing routines │ │ │ -0023efd0: 0a77 696c 6c20 7573 6520 7468 6520 6c61 .will use the la │ │ │ -0023efe0: 6e67 7561 6765 2073 7065 6369 6669 6564 nguage specified │ │ │ -0023eff0: 2069 6e20 7365 7276 6572 2773 2063 6f6e in server's con │ │ │ -0023f000: 6669 6775 7261 7469 6f6e 2e3c 2f70 6172 figuration.. │ │ │ -0023f020: 2020 3c72 6566 7365 6374 323e 3c74 6974 encoding_name │ │ │ -0023f040: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ -0023f050: 7061 7261 3e74 6865 206e 616d 6520 6f66 para>the name of │ │ │ -0023f060: 2074 6865 2065 6e63 6f64 696e 6720 7468 the encoding th │ │ │ -0023f070: 6174 2069 7320 7573 6564 2062 7920 6465 at is used by de │ │ │ -0023f080: 6661 756c 7420 746f 0a69 6e64 6578 2073 fault to.index s │ │ │ -0023f090: 6f75 7263 6520 7465 7874 732e 0a49 6620 ource texts..If │ │ │ -0023f0a0: 7468 6520 7061 7261 6d65 7465 7220 6973 the parameter is │ │ │ -0023f0b0: 206f 6d69 7474 6564 206f 7220 6973 2065 omitted or is e │ │ │ -0023f0c0: 7175 616c 2074 6f20 272a 696e 692a 2720 qual to '*ini*' │ │ │ -0023f0d0: 7374 7269 6e67 2c20 696e 6465 7869 6e67 string, indexing │ │ │ -0023f0e0: 2072 6f75 7469 6e65 730a 7769 6c6c 2075 routines.will u │ │ │ -0023f0f0: 7365 2074 6865 2065 6e63 6f64 696e 6720 se the encoding │ │ │ -0023f100: 7370 6563 6966 6965 6420 6279 2063 6861 specified by cha │ │ │ -0023f110: 7273 6574 206f 6620 7468 6520 5244 424d rset of the RDBM │ │ │ -0023f120: 5320 636f 6e6e 6563 7469 6f6e 2074 6861 S connection tha │ │ │ -0023f130: 7420 6973 0a69 6e20 7573 6520 7768 656e t is.in use when │ │ │ -0023f140: 2074 6865 2069 6e64 6578 2069 7320 6372 the index is cr │ │ │ -0023f150: 6561 7465 642e 3c2f 7061 7261 3e3c 2f72 eated.. si │ │ │ -0023f180: 6c65 6e74 3c2f 7469 746c 653e 0a20 2020 lent. │ │ │ -0023f190: 2020 203c 7061 7261 3e46 6c61 6720 7769 Flag wi │ │ │ -0023f1a0: 7468 2076 616c 7565 7320 312f 302e 2044 th values 1/0. D │ │ │ -0023f1b0: 6566 6175 6c74 2069 7320 302e 2057 6865 efault is 0. Whe │ │ │ -0023f1c0: 6e20 7365 7420 746f 2030 2c20 7468 6520 n set to 0, the │ │ │ -0023f1d0: 6675 6e63 7469 6f6e 2073 6967 6e61 6c73 function signals │ │ │ -0023f1e0: 2065 7272 6f72 2069 6620 7468 6520 7465 error if the te │ │ │ -0023f1f0: 7874 2069 6e64 6578 2065 7869 7374 732e xt index exists. │ │ │ -0023f200: 200a 2020 2020 2020 0949 6620 7365 7420 . .If set │ │ │ -0023f210: 746f 2031 2c20 7468 6520 6675 6e63 7469 to 1, the functi │ │ │ -0023f220: 6f6e 2073 6967 6e61 6c73 206e 6f20 6572 on signals no er │ │ │ -0023f230: 726f 7220 6966 2074 6865 2074 6578 7420 ror if the text │ │ │ -0023f240: 696e 6465 7820 6578 6973 7473 2e3c 2f70 index exists.

    . │ │ │ -0023f260: 2020 3c2f 7265 6673 6563 7431 3e0a 3c21 .Errors │ │ │ -0023f2a0: 0a20 2020 203c 7461 626c 653e 3c74 6974 . Errors signal │ │ │ -0023f2c0: 6c65 6420 6279 3c2f 7469 746c 653e 0a20 led by. │ │ │ -0023f2d0: 2020 2020 203c 7467 726f 7570 2063 6f6c . SQLStateError Co │ │ │ -0023f320: 6465 3c2f 656e 7472 793e 3c65 6e74 7279 deError TextDescri │ │ │ -0023f350: 7074 696f 6e3c 2f65 6e74 7279 3e3c 2f72 ption.... .. │ │ │ -0023f380: 2020 203c 656e 7472 793e 3c65 7272 6f72 .. < │ │ │ -0023f3b0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>.. .. .. │ │ │ -0023f420: 0a09 3c2f 7462 6f64 793e 0a20 2020 2020 ... │ │ │ -0023f430: 203c 2f74 6772 6f75 703e 0a20 2020 203c . < │ │ │ -0023f440: 2f74 6162 6c65 3e0a 2020 3c2f 7265 6673 /table>. . -->. Exa │ │ │ -0023f480: 6d70 6c65 733c 2f74 6974 6c65 3e0a 0909 mples... │ │ │ -0023f490: 093c 6578 616d 706c 6520 6964 3d22 6578 ......Creating A Te │ │ │ -0023f4d0: 7874 2049 6e64 6578 2055 7369 6e67 2046 xt Index Using F │ │ │ -0023f4e0: 5420 6675 6e63 7469 6f6e 733c 2f74 6974 T functions......create │ │ │ -0023f510: 7461 626c 6520 786d 6c5f 7465 7874 2028 table xml_text ( │ │ │ -0023f520: 7874 5f69 6420 696e 7465 6765 722c 2078 xt_id integer, x │ │ │ -0023f530: 745f 6669 6c65 2076 6172 6368 6172 2c0a t_file varchar,. │ │ │ -0023f540: 0909 0978 745f 7465 7874 206c 6f6e 6720 ...xt_text long │ │ │ -0023f550: 7661 7263 6861 722c 2070 7269 6d61 7279 varchar, primary │ │ │ -0023f560: 206b 6579 2028 7874 5f69 6429 293b 0a0a key (xt_id));.. │ │ │ -0023f570: 6372 6561 7465 2069 6e64 6578 2078 745f create index xt_ │ │ │ -0023f580: 6669 6c65 206f 6e20 786d 6c5f 7465 7874 file on xml_text │ │ │ -0023f590: 2028 7874 5f66 696c 6529 3b0a 0a76 745f (xt_file);..vt_ │ │ │ -0023f5a0: 6372 6561 7465 5f74 6578 745f 696e 6465 create_text_inde │ │ │ -0023f5b0: 7820 2826 6170 6f73 3b78 6d6c 5f74 6578 x ('xml_tex │ │ │ -0023f5c0: 7426 6170 6f73 3b2c 0a09 0909 2661 706f t',....&apo │ │ │ -0023f5d0: 733b 7874 5f74 6578 7426 6170 6f73 3b2c s;xt_text', │ │ │ -0023f5e0: 206e 756c 6c2c 2031 293b 0a3c 2f70 726f null, 1);..... │ │ │ -0023f600: 093c 7061 7261 3e2d 2d20 6372 6561 7465 .-- create │ │ │ -0023f610: 2061 2074 6578 7420 696e 6465 7820 6f6e a text index on │ │ │ -0023f620: 2078 745f 7465 7874 2077 6974 6820 584d xt_text with XM │ │ │ -0023f630: 4c20 7765 6c6c 2066 6f72 6d65 646e 6573 L well formednes │ │ │ -0023f640: 7320 6368 6563 6b69 6e67 206f 6e3c 2f70 s checking on

    ......VT_IND │ │ │ -0023f670: 4558 5f44 425f 4442 415f 584d 4c5f 5445 EX_DB_DBA_XML_TE │ │ │ -0023f680: 5854 2028 3029 3b0a 3c2f 7072 6f67 7261 XT (0);......

    -- populate │ │ │ -0023f6b0: 7468 6520 7465 7874 2069 6e64 6578 2062 the text index b │ │ │ -0023f6c0: 6173 6564 2069 6e20 7468 6520 6461 7461 ased in the data │ │ │ -0023f6d0: 2069 6e20 7468 6520 7461 626c 652e 3c2f in the table.......VT_in │ │ │ -0023f700: 635f 494e 4445 585f 4442 5f44 4241 5f58 c_INDEX_DB_DBA_X │ │ │ -0023f710: 4d4c 5f54 4558 5420 2829 3b0a 3c2f 7072 ML_TEXT ();.... │ │ │ -0023f730: 0909 3c70 6172 613e 0a2d 2d20 7265 6672 ...-- refr │ │ │ -0023f740: 6573 6820 7468 6520 696e 6465 7820 746f esh the index to │ │ │ -0023f750: 2072 6566 6c65 6374 2063 6861 6e67 6573 reflect changes │ │ │ -0023f760: 2074 6f20 7468 6520 6461 7461 2073 696e to the data sin │ │ │ -0023f770: 6365 2074 6865 206c 6173 7420 6361 6c6c ce the last call │ │ │ -0023f780: 0a3c 2f70 6172 613e 0a09 0909 093c 7061 ......-- to this fu │ │ │ -0023f7a0: 6e63 7469 6f6e 206f 7220 7468 6520 696e nction or the in │ │ │ -0023f7b0: 6974 6961 6c20 6361 6c6c 2074 6f20 5654 itial call to VT │ │ │ -0023f7c0: 5f49 4e44 4558 5f44 425f 4442 415f 584d _INDEX_DB_DBA_XM │ │ │ -0023f7d0: 4c5f 5445 5854 2e0a 3c2f 7061 7261 3e0a L_TEXT... │ │ │ -0023f7e0: 0909 0909 3c70 726f 6772 616d 6c69 7374 .....vt_batch_up │ │ │ -0023f800: 6461 7465 2028 2661 706f 733b 4442 2e44 date ('DB.D │ │ │ -0023f810: 4241 2e58 4d4c 5f54 4558 5426 6170 6f73 BA.XML_TEXT&apos │ │ │ -0023f820: 3b2c 2026 6170 6f73 3b6f 6e26 6170 6f73 ;, 'on&apos │ │ │ -0023f830: 3b2c 2031 3029 3b0a 3c2f 7072 6f67 7261 ;, 10);......

    -- sets the │ │ │ -0023f860: 696e 6465 7820 6d61 696e 7465 6e61 6e63 index maintenanc │ │ │ -0023f870: 6520 746f 2062 6520 6173 796e 6368 726f e to be asynchro │ │ │ -0023f880: 6e6f 7573 2c20 7265 6672 6573 6865 6420 nous, refreshed │ │ │ -0023f890: 6174 206d 6178 696d 756d 2069 6e74 6572 at maximum inter │ │ │ -0023f8a0: 7661 6c73 0a6f 6620 3130 206d 696e 7574 vals.of 10 minut │ │ │ -0023f8b0: 6573 206f 7220 6174 2065 7665 7279 2073 es or at every s │ │ │ -0023f8c0: 6368 6564 756c 6572 2063 7963 6c65 2069 cheduler cycle i │ │ │ -0023f8d0: 6620 7468 6520 6c61 7474 6572 2069 7320 f the latter is │ │ │ -0023f8e0: 6c6f 6e67 6572 2074 6861 6e20 3130 206d longer than 10 m │ │ │ -0023f8f0: 696e 7574 6573 2e0a 3c2f 7061 7261 3e0a inutes... │ │ │ -0023f900: 0909 0909 3c70 726f 6772 616d 6c69 7374 .....vt_batch_up │ │ │ -0023f920: 6461 7465 2028 2661 706f 733b 4442 2e44 date ('DB.D │ │ │ -0023f930: 4241 2e58 4d4c 5f54 4558 5426 6170 6f73 BA.XML_TEXT&apos │ │ │ -0023f940: 3b2c 2026 6170 6f73 3b6f 6666 2661 706f ;, 'off&apo │ │ │ -0023f950: 733b 2c20 6e75 6c6c 293b 0a3c 2f70 726f s;, null);..... │ │ │ -0023f970: 093c 7061 7261 3e0a 2d2d 2073 6574 7320 ..-- sets │ │ │ -0023f980: 7468 6520 696e 6465 7820 6d61 696e 7465 the index mainte │ │ │ -0023f990: 6e61 6e63 6520 746f 2062 6520 7379 6e63 nance to be sync │ │ │ -0023f9a0: 6872 6f6e 6f75 732c 2077 6974 6869 6e20 hronous, within │ │ │ -0023f9b0: 7468 6520 7361 6d65 2074 7261 6e73 6163 the same transac │ │ │ -0023f9c0: 7469 6f6e 0a3c 2f70 6172 613e 0a09 0909 tion..... │ │ │ -0023f9d0: 093c 7061 7261 3e0a 2d2d 2061 7320 7468 ..-- as th │ │ │ -0023f9e0: 6520 6f70 6572 6174 696f 6e20 6368 616e e operation chan │ │ │ -0023f9f0: 6769 6e67 2074 6865 2069 6e64 6578 6564 ging the indexed │ │ │ -0023fa00: 2064 6174 612e 0a3c 2f70 6172 613e 0a09 data.... │ │ │ -0023fa10: 0909 3c2f 6578 616d 706c 653e 0a20 203c ... < │ │ │ -0023fa20: 2f72 6566 7365 6374 313e 0a3c 212d 2d20 /refsect1>......... │ │ │ -0023fab0: 0027 6465 6d6f 2f64 6f63 7372 632f 6675 .'demo/docsrc/fu │ │ │ -0023fac0: 6e63 7265 662f 7674 5f62 6174 6368 5f75 ncref/vt_batch_u │ │ │ -0023fad0: 7064 6174 652e 786d 6cdf 0000 0e96 3c3f pdate.xml........ │ │ │ -0023fe90: 3c72 6566 6d65 7461 3e0a 2020 2020 3c72 . VT_ │ │ │ -0023feb0: 4241 5443 485f 5550 4441 5445 3c2f 7265 BATCH_UPDATE. │ │ │ -0023fed0: 203c 7265 666d 6973 6369 6e66 6f3e 6674 ft │ │ │ -0023fee0: 3c2f 7265 666d 6973 6369 6e66 6f3e 0a20 . │ │ │ -0023fef0: 203c 2f72 6566 6d65 7461 3e0a 2020 3c72 . . < │ │ │ -0023ff10: 7265 666e 616d 653e 5654 5f42 4154 4348 refname>VT_BATCH │ │ │ -0023ff20: 5f55 5044 4154 453c 2f72 6566 6e61 6d65 _UPDATE. Set batch mod │ │ │ -0023ff50: 6520 7570 6461 7465 206f 6620 6672 6565 e update of free │ │ │ -0023ff60: 2074 6578 7420 696e 6465 7869 6e67 2e3c text indexing.< │ │ │ -0023ff70: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ -0023ff80: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ -0023ff90: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ -0023ffa0: 2020 2020 3c66 756e 6373 796e 6f70 7369 . │ │ │ -0023ffd0: 2020 203c 6675 6e63 7072 6f74 6f74 7970 . │ │ │ -00240000: 2020 2020 2020 203c 6675 6e63 6465 663e │ │ │ -00240010: 696e 7465 6765 7220 4442 2e44 4241 2e3c integer DB.DBA.< │ │ │ -00240020: 6675 6e63 7469 6f6e 3e56 545f 4241 5443 function>VT_BATC │ │ │ -00240030: 485f 5550 4441 5445 3c2f 6675 6e63 7469 H_UPDATE. │ │ │ -00240050: 2020 2020 2020 3c70 6172 616d 6465 663e │ │ │ -00240060: 696e 203c 7061 7261 6d65 7465 723e 7461 in ta │ │ │ -00240070: 626c 653c 2f70 6172 616d 6574 6572 3e20 ble │ │ │ -00240080: 7661 7263 6861 723c 2f70 6172 616d 6465 varchar. in flag varchar. < │ │ │ -002400e0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in interval_ │ │ │ -00240100: 6d69 6e75 7465 733c 2f70 6172 616d 6574 minutes integer. . │ │ │ -00240140: 2020 3c2f 6675 6e63 7379 6e6f 7073 6973 . . Description...T │ │ │ -002401b0: 6869 7320 6675 6e63 7469 6f6e 2063 6f6e his function con │ │ │ -002401c0: 7472 6f6c 7320 7468 6520 7469 6d65 206f trols the time o │ │ │ -002401d0: 6620 7570 6461 7465 206f 6620 6120 7465 f update of a te │ │ │ -002401e0: 7874 2069 6e64 6578 2e20 4966 2066 6c61 xt index. If fla │ │ │ -002401f0: 6720 6973 204f 4e2c 2063 6861 6e67 6573 g is ON, changes │ │ │ -00240200: 2061 7265 2061 6363 756d 756c 6174 6564 are accumulated │ │ │ -00240210: 0a69 6e74 6f20 6120 6368 616e 6765 2074 .into a change t │ │ │ -00240220: 7261 636b 696e 6720 7461 626c 6520 616e racking table an │ │ │ -00240230: 6420 6170 706c 6965 6420 6173 2061 2062 d applied as a b │ │ │ -00240240: 6174 6368 2e20 4966 2066 6c61 6720 6973 atch. If flag is │ │ │ -00240250: 204f 4646 2c20 7468 6520 7465 7874 2069 OFF, the text i │ │ │ -00240260: 6e64 6578 2069 7320 7570 6461 7465 640a ndex is updated. │ │ │ -00240270: 696e 2074 6865 2073 616d 6520 7472 616e in the same tran │ │ │ -00240280: 7361 6374 696f 6e20 6173 2074 6865 2069 saction as the i │ │ │ -00240290: 6e64 6578 6564 2064 6174 6120 6974 7365 ndexed data itse │ │ │ -002402a0: 6c66 2e20 5468 6520 6368 616e 6765 2074 lf. The change t │ │ │ -002402b0: 7261 636b 696e 6720 7461 626c 6520 6973 racking table is │ │ │ -002402c0: 2061 7574 6f6d 6174 6963 616c 6c79 0a63 automatically.c │ │ │ -002402d0: 7265 6174 6564 2061 6e64 2069 7320 6e61 reated and is na │ │ │ -002402e0: 6d65 6420 5654 4c4f 475f 266c 743b 7126 med VTLOG_<q& │ │ │ -002402f0: 6774 3b5f 266c 743b 6f26 6774 3b5f 266c gt;_<o>_&l │ │ │ -00240300: 743b 7461 626c 6526 6774 3b2c 2069 6e20 t;table>, in │ │ │ -00240310: 7468 6520 7175 616c 6966 6965 7220 616e the qualifier an │ │ │ -00240320: 6420 6f77 6e65 7220 6f66 0a74 6865 2069 d owner of.the i │ │ │ -00240330: 6e64 6578 6564 2074 6162 6c65 2c20 7768 ndexed table, wh │ │ │ -00240340: 6572 6520 712c 206f 2061 6e64 2074 6162 ere q, o and tab │ │ │ -00240350: 6c65 2061 7265 2074 6865 2071 7561 6c69 le are the quali │ │ │ -00240360: 6669 6572 2c20 6f77 6e65 7220 616e 6420 fier, owner and │ │ │ -00240370: 6e61 6d65 206f 6620 7468 6520 7461 626c name of the tabl │ │ │ -00240380: 652e 0a54 6865 2063 6861 6e67 6573 2061 e..The changes a │ │ │ -00240390: 6363 756d 756c 6174 6564 2069 6e74 6f20 ccumulated into │ │ │ -002403a0: 7468 6174 2074 6162 6c65 2063 616e 2062 that table can b │ │ │ -002403b0: 6520 6578 706c 6963 6974 6c79 2061 7070 e explicitly app │ │ │ -002403c0: 6c69 6564 2074 6f20 7468 650a 696e 6465 lied to the.inde │ │ │ -002403d0: 7820 7573 696e 6720 7468 6520 5654 5f49 x using the VT_I │ │ │ -002403e0: 4e43 5f49 4e44 4558 5f26 6c74 3b71 2667 NC_INDEX_<q&g │ │ │ -002403f0: 743b 5f26 6c74 3b6f 2667 743b 5f26 6c74 t;_<o>_< │ │ │ -00240400: 3b74 6162 6c65 2667 743b 2066 756e 6374 ;table> funct │ │ │ -00240410: 696f 6e2e 0a3c 2f70 6172 613e 0a20 203c ion... < │ │ │ -00240420: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. Parame │ │ │ -00240460: 7465 7273 3c2f 7469 746c 653e 0a20 2020 ters. │ │ │ -00240470: 203c 7265 6673 6563 7432 3e3c 7469 746c table. │ │ │ -00240490: 2020 2020 2020 3c70 6172 613e 7468 6520 the │ │ │ -002404a0: 6e61 6d65 206f 6620 7468 6520 7461 626c name of the tabl │ │ │ -002404b0: 6520 746f 2070 6572 666f 726d 2062 6174 e to perform bat │ │ │ -002404c0: 6368 2075 7064 6174 696e 6720 6f66 2e3c ch updating of.< │ │ │ -002404d0: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ -002404f0: 3c74 6974 6c65 3e66 6c61 673c 2f74 6974 flag</tit │ │ │ -00240500: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ -00240510: 4966 204f 4e2c 2075 7064 6174 6573 2061 If ON, updates a │ │ │ -00240520: 7265 2069 6e20 6261 7463 6820 6d6f 6465 re in batch mode │ │ │ -00240530: 2c20 6966 204f 4646 2c20 7468 6579 2061 , if OFF, they a │ │ │ -00240540: 7265 2073 796e 6368 726f 6e6f 7573 2e3c re synchronous.< │ │ │ -00240550: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para></refsect2 │ │ │ -00240560: 3e0a 0a20 2020 203c 7265 6673 6563 7432 >.. <refsect2 │ │ │ -00240570: 3e3c 7469 746c 653e 696e 7465 7276 616c ><title>interval │ │ │ -00240580: 5f6d 696e 7574 6573 3c2f 7469 746c 653e _minutes │ │ │ -00240590: 0a20 2020 2020 203c 7061 7261 3e74 6865 . the │ │ │ -002405a0: 2075 7064 6174 6520 696e 7465 7276 616c update interval │ │ │ -002405b0: 2e20 204e 554c 4c20 6d65 616e 7320 7468 . NULL means th │ │ │ -002405c0: 6174 2075 7064 6174 6573 2061 7265 206e at updates are n │ │ │ -002405d0: 6f74 2020 7363 6865 6475 6c65 642e 3c2f ot scheduled. │ │ │ -002405f0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . . │ │ │ -00240600: 203c 7265 6673 6563 7431 2069 643d 2265 Er │ │ │ -00240630: 726f 7273 3c2f 7469 746c 653e 0a20 2020 rors. │ │ │ -00240640: 203c 7461 626c 653e 3c74 6974 6c65 3e45

    E │ │ │ -00240650: 7272 6f72 7320 7369 676e 616c 6c65 6420 rrors signalled │ │ │ -00240660: 6279 3c2f 7469 746c 653e 0a20 2020 2020 by. │ │ │ -00240670: 203c 7467 726f 7570 2063 6f6c 733d 2234 . SQL │ │ │ -002406a0: 5374 6174 653c 2f65 6e74 7279 3e3c 656e StateError CodeErr │ │ │ -002406d0: 6f72 2054 6578 743c 2f65 6e74 7279 3e3c or Text< │ │ │ -002406e0: 656e 7472 793e 4465 7363 7269 7074 696f entry>Descriptio │ │ │ -002406f0: 6e3c 2f65 6e74 7279 3e3c 2f72 6f77 3e3c n< │ │ │ -00240700: 2f74 6865 6164 3e0a 093c 7462 6f64 793e /thead>.. │ │ │ -00240710: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. .. < │ │ │ -00240720: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>.. .. .. │ │ │ -002407a0: 2020 203c 656e 7472 793e 3c2f 656e 7472 .. ... . . . See Also.
  • vt_d │ │ │ -00240860: 726f 705f 6674 7428 293c 2f6c 696e 6b3e rop_ftt() │ │ │ -00240870: 3c2f 7061 7261 3e0a 2020 2020 3c70 6172 . vt │ │ │ -002408a0: 5f62 6174 6368 2829 3c2f 6c69 6e6b 3e3c _batch()< │ │ │ -002408b0: 2f70 6172 613e 0a20 2020 203c 7061 7261 /para>. vt_crea │ │ │ -002408f0: 7465 5f74 6578 745f 696e 6465 7828 293c te_text_index()< │ │ │ -00240900: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -00240910: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 vt_batc │ │ │ -00240940: 685f 6665 6564 2829 3c2f 6c69 6e6b 3e3c h_feed()< │ │ │ -00240950: 2f70 6172 613e 0a20 203c 2f72 6566 7365 /para>. . │ │ │ -00240970: 0a0a 0a0a b600 0000 2d64 656d 6f2f 646f ........-demo/do │ │ │ -00240980: 6373 7263 2f66 756e 6372 6566 2f76 745f csrc/funcref/vt_ │ │ │ -00240990: 6261 7463 685f 6665 6564 5f6f 6666 6261 batch_feed_offba │ │ │ -002409a0: 6e64 2e78 6d6c df00 0019 623c 3f78 6d6c nd.xml....b.. │ │ │ -00240d60: 0a20 203c 7265 666d 6574 613e 0a20 2020 . . │ │ │ -00240d70: 203c 7265 6665 6e74 7279 7469 746c 653e │ │ │ -00240d80: 7674 5f62 6174 6368 5f66 6565 645f 6f66 vt_batch_feed_of │ │ │ -00240d90: 6662 616e 643c 2f72 6566 656e 7472 7974 fband. ft. . . vt_batch_feed_o │ │ │ -00240e00: 6666 6261 6e64 3c2f 7265 666e 616d 653e ffband │ │ │ -00240e10: 0a20 2020 203c 7265 6670 7572 706f 7365 . Add offband inf │ │ │ -00240e30: 6f72 6d61 7469 6f6e 2074 6f20 6120 6672 ormation to a fr │ │ │ -00240e40: 6565 2074 6578 7420 7570 6461 7465 2062 ee text update b │ │ │ -00240e50: 6174 6368 2e3c 2f72 6566 7075 7270 6f73 atch.. . . . . │ │ │ -00240ef0: 2020 203c 6675 6e63 6465 663e 3c66 756e vt_batch_f │ │ │ -00240f10: 6565 645f 6f66 6662 616e 643c 2f66 756e eed_offband │ │ │ -00240f30: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in vt_batch any. in clustered_v │ │ │ -00240fa0: 616c 7565 733c 2f70 6172 616d 6574 6572 alues string. in is_del integer. │ │ │ -00241010: 3c2f 6675 6e63 7072 6f74 6f74 7970 653e │ │ │ -00241020: 0a20 2020 203c 2f66 756e 6373 796e 6f70 . . . Desc │ │ │ -00241080: 7269 7074 696f 6e3c 2f74 6974 6c65 3e0a ription. │ │ │ -00241090: 2020 2020 3c70 6172 613e 5468 6973 2066 This f │ │ │ -002410a0: 756e 6374 696f 6e20 616c 6c6f 7773 2079 unction allows y │ │ │ -002410b0: 6f75 2074 6f20 6164 6420 6f66 6662 616e ou to add offban │ │ │ -002410c0: 6420 696e 666f 726d 6174 696f 6e20 746f d information to │ │ │ -002410d0: 2061 2066 7265 6520 7465 7874 2075 7064 a free text upd │ │ │ -002410e0: 6174 6520 6261 7463 682e 0a54 6869 7320 ate batch..This │ │ │ -002410f0: 7368 6f75 6c64 2062 6520 646f 6e65 2062 should be done b │ │ │ -00241100: 7920 696e 6465 7820 616e 6420 756e 696e y index and unin │ │ │ -00241110: 6465 7820 686f 6f6b 2066 756e 6374 696f dex hook functio │ │ │ -00241120: 6e73 206f 6620 7468 6520 6672 6565 2074 ns of the free t │ │ │ -00241130: 6578 7420 696e 6465 780a 6966 2061 6e64 ext index.if and │ │ │ -00241140: 206f 6e6c 7920 6966 2074 6865 2069 6e64 only if the ind │ │ │ -00241150: 6578 2069 7320 6372 6561 7465 6420 7769 ex is created wi │ │ │ -00241160: 7468 2062 6f74 6820 2671 756f 743b 434c th both "CL │ │ │ -00241170: 5553 5445 5245 4420 5749 5448 2028 2e2e USTERED WITH (.. │ │ │ -00241180: 2e29 2671 756f 743b 0a61 6e64 2026 7175 .)".and &qu │ │ │ -00241190: 6f74 3b55 5349 4e47 2046 554e 4354 494f ot;USING FUNCTIO │ │ │ -002411a0: 4e26 7175 6f74 3b20 6f70 7469 6f6e 7320 N" options │ │ │ -002411b0: 616e 6420 7468 6520 686f 6f6b 2066 756e and the hook fun │ │ │ -002411c0: 6374 696f 6e20 7265 7475 726e 7320 6e6f ction returns no │ │ │ -002411d0: 6e2d 7a65 726f 0a76 616c 7565 2c20 692e n-zero.value, i. │ │ │ -002411e0: 652e 2064 6973 6162 6c65 7320 7374 616e e. disables stan │ │ │ -002411f0: 6461 7264 2069 6e64 6578 696e 6720 6f66 dard indexing of │ │ │ -00241200: 2074 6865 2064 6f63 756d 656e 742e 0a20 the document.. │ │ │ -00241210: 2020 203c 2f70 6172 613e 0a20 2020 203c . < │ │ │ -00241220: 7061 7261 3e54 6869 7320 6675 6e63 7469 para>This functi │ │ │ -00241230: 6f6e 2069 7320 6e65 6564 6564 206f 6e6c on is needed onl │ │ │ -00241240: 7920 666f 7220 7665 7279 2075 6e75 7375 y for very unusu │ │ │ -00241250: 616c 2066 7265 6520 7465 7874 2069 6e64 al free text ind │ │ │ -00241260: 6578 6573 2e3c 2f70 6172 613e 0a3c 2f72 exes... Pa │ │ │ -002412b0: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ -002412c0: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ -002412d0: 7469 746c 653e 7674 5f62 6174 6368 3c2f title>vt_batch. must be an ob │ │ │ -00241300: 6a65 6374 2072 6574 7572 6e65 6420 6279 ject returned by │ │ │ -00241310: 203c 6675 6e63 7469 6f6e 3e76 745f 6261 vt_ba │ │ │ -00241320: 7463 683c 2f66 756e 6374 696f 6e3e 206f tch o │ │ │ -00241330: 6e20 7768 6963 680a 3c66 756e 6374 696f n which.vt_batch_d_id< │ │ │ -00241350: 2f66 756e 6374 696f 6e3e 2068 6173 2062 /function> has b │ │ │ -00241360: 6565 6e20 6361 6c6c 6564 2e3c 2f70 6172 een called.. │ │ │ -00241380: 2020 3c72 6566 7365 6374 323e 3c74 6974 clustered_val │ │ │ -002413a0: 7565 733c 2f74 6974 6c65 3e0a 2020 2020 ues. │ │ │ -002413b0: 2020 3c70 6172 613e 6d75 7374 2062 6520 must be │ │ │ -002413c0: 6120 7374 7269 6e67 2074 6861 7420 6973 a string that is │ │ │ -002413d0: 206d 6164 6520 6279 2073 6572 6961 6c69 made by seriali │ │ │ -002413e0: 7a61 7469 6f6e 206f 6620 6120 7665 6374 zation of a vect │ │ │ -002413f0: 6f72 206f 6620 6f66 6662 616e 6420 7661 or of offband va │ │ │ -00241400: 6c75 6573 3a0a 7468 6520 6c65 6e67 7468 lues:.the length │ │ │ -00241410: 206f 6620 7665 6374 6f72 2069 7320 6571 of vector is eq │ │ │ -00241420: 7561 6c20 746f 206e 756d 6265 7220 6f66 ual to number of │ │ │ -00241430: 2063 6f6c 756d 6e73 206c 6973 7465 6420 columns listed │ │ │ -00241440: 696e 0a26 7175 6f74 3b43 4c55 5354 4552 in."CLUSTER │ │ │ -00241450: 4544 2057 4954 4820 282e 2e2e 2926 7175 ED WITH (...)&qu │ │ │ -00241460: 6f74 3b20 6f70 7469 6f6e 206f 6620 2671 ot; option of &q │ │ │ -00241470: 756f 743b 4352 4541 5445 2054 4558 5420 uot;CREATE TEXT │ │ │ -00241480: 494e 4445 5826 7175 6f74 3b20 7374 6174 INDEX" stat │ │ │ -00241490: 656d 656e 7420 616e 640a 656c 656d 656e ement and.elemen │ │ │ -002414a0: 7473 206f 6620 7468 6520 7665 6374 6f72 ts of the vector │ │ │ -002414b0: 2073 686f 756c 6420 6265 2076 616c 7565 should be value │ │ │ -002414c0: 7320 6f66 2074 6865 206c 6973 7465 6420 s of the listed │ │ │ -002414d0: 6669 656c 6473 2066 6f72 2074 6865 2063 fields for the c │ │ │ -002414e0: 7572 7265 6e74 2064 6f63 756d 656e 742e urrent document. │ │ │ -002414f0: 3c2f 7061 7261 3e3c 2f72 6566 7365 6374 . is_del</ │ │ │ -00241520: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ -00241530: 7261 3e69 6620 3020 6d65 616e 7320 7468 ra>if 0 means th │ │ │ -00241540: 6174 2074 6865 2064 6174 6120 6973 2074 at the data is t │ │ │ -00241550: 6f20 6265 2061 6464 6564 2c20 3120 6d65 o be added, 1 me │ │ │ -00241560: 616e 7320 7468 6520 6461 7461 2069 7320 ans the data is │ │ │ -00241570: 746f 0a62 6520 6465 6c65 7465 642e 3c2f to.be deleted.</ │ │ │ -00241580: 7061 7261 3e3c 2f72 6566 7365 6374 323e para></refsect2> │ │ │ -00241590: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ -002415a0: 203c 7265 6673 6563 7431 2069 643d 2272 <refsect1 id="r │ │ │ -002415b0: 6574 5f76 745f 6261 7463 685f 6665 6564 et_vt_batch_feed │ │ │ -002415c0: 5f6f 6666 6261 6e64 223e 3c74 6974 6c65 _offband"><title │ │ │ -002415d0: 3e52 6574 7572 6e20 5479 7065 733c 2f74 >Return Types</t │ │ │ -002415e0: 6974 6c65 3e3c 7061 7261 3e54 6865 2072 itle><para>The r │ │ │ -002415f0: 6574 7572 6e65 6420 7661 6c75 6520 6d61 eturned value ma │ │ │ -00241600: 7920 7661 7279 2066 726f 6d20 7665 7273 y vary from vers │ │ │ -00241610: 696f 6e20 746f 2076 6572 7369 6f6e 2061 ion to version a │ │ │ -00241620: 6e64 2073 686f 756c 6420 6e6f 7420 6265 nd should not be │ │ │ -00241630: 2075 7365 7220 6279 2061 7070 6c69 6361 user by applica │ │ │ -00241640: 7469 6f6e 2063 6f64 653c 2f70 6172 613e tion code</para> │ │ │ -00241650: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ -00241660: 6566 7365 6374 3120 6964 3d22 6578 616d efsect1 id="exam │ │ │ -00241670: 706c 6573 5f76 745f 6261 7463 685f 6665 ples_vt_batch_fe │ │ │ -00241680: 6564 5f6f 6666 6261 6e64 223e 3c74 6974 ed_offband"><tit │ │ │ -00241690: 6c65 3e45 7861 6d70 6c65 733c 2f74 6974 le>Examples</tit │ │ │ -002416a0: 6c65 3e0a 2020 2020 3c65 7861 6d70 6c65 le>. <example │ │ │ -002416b0: 2069 643d 2265 785f 7674 5f62 6174 6368 id="ex_vt_batch │ │ │ -002416c0: 5f66 6565 645f 6f66 6662 616e 6422 3e3c _feed_offband">< │ │ │ -002416d0: 7469 746c 653e 4672 6565 2074 6578 7420 title>Free text │ │ │ -002416e0: 696e 6465 7869 6e67 206f 6620 636f 6d70 indexing of comp │ │ │ -002416f0: 6f73 6564 2074 6578 7420 636c 7573 7465 osed text cluste │ │ │ -00241700: 7265 6420 7769 7468 206f 6666 6261 6e64 red with offband │ │ │ -00241710: 2063 6f6c 756d 6e73 3c2f 7469 746c 653e columns │ │ │ -00241720: 0a20 2020 2020 203c 7061 7261 3e54 6162 . Tab │ │ │ -00241730: 6c65 204c 4541 4453 2063 6f6e 7461 696e le LEADS contain │ │ │ -00241740: 7320 6465 7363 7269 7074 696f 6e73 206f s descriptions o │ │ │ -00241750: 6620 6172 7469 636c 6573 206f 6620 736f f articles of so │ │ │ -00241760: 6d65 2073 6574 206f 6620 6e65 7773 7061 me set of newspa │ │ │ -00241770: 7065 7273 2e0a 486f 6f6b 2066 756e 6374 pers..Hook funct │ │ │ -00241780: 696f 6e73 2063 6f6d 706f 7365 2074 6578 ions compose tex │ │ │ -00241790: 7420 7468 6174 2063 6f6e 7461 696e 7320 t that contains │ │ │ -002417a0: 6e6f 7420 6f6e 6c79 2073 7562 6a65 6374 not only subject │ │ │ -002417b0: 206f 6620 6172 7469 636c 652c 2062 7574 of article, but │ │ │ -002417c0: 2061 6c73 6f20 7469 746c 6520 616e 6420 also title and │ │ │ -002417d0: 6669 7273 7420 6e61 6d65 206f 6620 7468 first name of th │ │ │ -002417e0: 6520 6175 7468 6f72 2e0a 5468 6520 686f e author..The ho │ │ │ -002417f0: 6f6b 2066 756e 6374 696f 6e20 7368 6f75 ok function shou │ │ │ -00241800: 6c64 2072 6574 7572 6e20 6e6f 6e2d 7a65 ld return non-ze │ │ │ -00241810: 726f 2076 616c 7565 2074 6f20 6469 7361 ro value to disa │ │ │ -00241820: 626c 6520 6465 6661 756c 7420 2070 726f ble default pro │ │ │ -00241830: 6365 7373 696e 6720 6f66 2074 6578 7420 cessing of text │ │ │ -00241840: 6f66 2053 5542 4a45 4354 2066 6965 6c64 of SUBJECT field │ │ │ -00241850: 2062 7574 2069 740a 616c 736f 2064 6973 but it.also dis │ │ │ -00241860: 6162 6c65 7320 7468 6520 6465 6661 756c ables the defaul │ │ │ -00241870: 7420 2070 726f 6365 7373 696e 6720 6f66 t processing of │ │ │ -00241880: 206f 6666 6261 6e64 2076 616c 7565 732e offband values. │ │ │ -00241890: 0a49 6620 7468 6520 6361 6c6c 206f 6620 .If the call of │ │ │ -002418a0: 3c66 756e 6374 696f 6e3e 7674 5f62 6174 vt_bat │ │ │ -002418b0: 6368 5f66 6565 645f 6f66 6662 616e 643c ch_feed_offband< │ │ │ -002418c0: 2f66 756e 6374 696f 6e3e 2069 7320 6d69 /function> is mi │ │ │ -002418d0: 7373 696e 6720 7468 656e 2066 7265 6520 ssing then free │ │ │ -002418e0: 7465 7874 2073 6561 7263 6820 6f66 2064 text search of d │ │ │ -002418f0: 6f63 756d 656e 7473 2069 7320 7374 696c ocuments is stil │ │ │ -00241900: 6c20 4f4b 0a62 7574 2074 6865 2063 616c l OK.but the cal │ │ │ -00241910: 6c20 6c69 6b65 2053 454c 4543 5420 4f52 l like SELECT OR │ │ │ -00241920: 475f 4944 2046 524f 4d20 4c45 4144 535f G_ID FROM LEADS_ │ │ │ -00241930: 5445 5354 2057 4845 5245 2043 4f4e 5441 TEST WHERE CONTA │ │ │ -00241940: 494e 5320 2853 5542 4a45 4354 2c20 2773 INS (SUBJECT, 's │ │ │ -00241950: 616d 706c 6520 6c65 6164 272c 204f 4646 ample lead', OFF │ │ │ -00241960: 4241 4e44 2c20 4f52 475f 4944 290a 7769 BAND, ORG_ID).wi │ │ │ -00241970: 6c6c 2072 6574 7572 6e20 4e55 4c4c 7320 ll return NULLs │ │ │ -00241980: 696e 7374 6561 6420 6f66 2063 6f72 7265 instead of corre │ │ │ -00241990: 6374 2076 616c 7565 7320 6672 6f6d 204f ct values from O │ │ │ -002419a0: 5247 5f49 4420 636f 6c75 6d6e 2062 6563 RG_ID column bec │ │ │ -002419b0: 6175 7365 2074 6865 7920 7769 6c6c 206e ause they will n │ │ │ -002419c0: 6f74 2062 6520 7265 7472 6965 7665 6420 ot be retrieved │ │ │ -002419d0: 6672 6f6d 0a66 7265 6520 7465 7874 2069 from.free text i │ │ │ -002419e0: 6e64 6578 2062 7920 2671 756f 743b 4f46 ndex by "OF │ │ │ -002419f0: 4642 414e 442c 204f 5247 5f49 4426 7175 FBAND, ORG_ID&qu │ │ │ -00241a00: 6f74 3b2e 0a3c 2f70 6172 613e 0a20 2020 ot;... │ │ │ -00241a10: 2020 203c 7363 7265 656e 3e0a 3c21 5b43 ... . . See A │ │ │ -00242180: 6c73 6f3c 2f74 6974 6c65 3e0a 2020 2020 lso. │ │ │ -00242190: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b vt_drop_ftt │ │ │ -002421c0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ -002421d0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c vt_batch. │ │ │ -00242210: 3c70 6172 613e 3c6c 696e 6b20 6c69 6e6b vt_batch_ │ │ │ -00242240: 6665 6564 3c2f 6c69 6e6b 3e3c 2f70 6172 feed.
  • │ │ │ -00242280: 7674 5f62 6174 6368 5f75 7064 6174 653c vt_batch_update< │ │ │ -00242290: 2f6c 696e 6b3e 3c2f 7061 7261 3e0a 2020 /link>. │ │ │ -002422a0: 2020 3c70 6172 613e 3c6c 696e 6b20 6c69 │ │ │ -002422d0: 7674 5f63 7265 6174 655f 7465 7874 5f69 vt_create_text_i │ │ │ -002422e0: 6e64 6578 3c2f 6c69 6e6b 3e3c 2f70 6172 ndex. │ │ │ -00242300: 0a3c 2f72 6566 656e 7472 793e 0ab6 0000 ..... │ │ │ -00242310: 0025 6465 6d6f 2f64 6f63 7372 632f 6675 .%demo/docsrc/fu │ │ │ -00242320: 6e63 7265 662f 7674 5f62 6174 6368 5f66 ncref/vt_batch_f │ │ │ -00242330: 6565 642e 786d 6cdf 0000 125c 3c3f 786d eed.xml....\... . vt_batc │ │ │ -00242710: 685f 6665 6564 3c2f 7265 6665 6e74 7279 h_feed. ft. . . vt_batch_feed< │ │ │ -00242780: 2f72 6566 6e61 6d65 3e0a 2020 2020 3c72 /refname>. Add wo │ │ │ -002427a0: 7264 7320 746f 2061 2066 7265 6520 7465 rds to a free te │ │ │ -002427b0: 7874 2075 7064 6174 6520 6261 7463 682e xt update batch. │ │ │ -002427c0: 3c2f 7265 6670 7572 706f 7365 3e0a 2020 . │ │ │ -002427d0: 3c2f 7265 666e 616d 6564 6976 3e0a 2020 . │ │ │ -002427e0: 3c72 6566 7379 6e6f 7073 6973 6469 763e │ │ │ -002427f0: 0a20 2020 203c 6675 6e63 7379 6e6f 7073 . . < │ │ │ -00242820: 6675 6e63 7072 6f74 6f74 7970 6520 6964 funcprototype id │ │ │ -00242830: 3d22 6670 726f 746f 5f62 6174 6368 5f66 ="fproto_batch_f │ │ │ -00242840: 6565 6422 3e0a 2020 2020 2020 2020 3c66 eed">. vt_batch_feed. in vt_batch any. │ │ │ -002428d0: 3c70 6172 616d 6465 663e 696e 203c 7061 in text_or_ │ │ │ -002428f0: 786d 6c3c 2f70 6172 616d 6574 6572 3e20 xml │ │ │ -00242900: 616e 793c 2f70 6172 616d 6465 663e 0a20 any. │ │ │ -00242910: 2020 2020 2020 203c 7061 7261 6d64 6566 in i │ │ │ -00242930: 735f 6465 6c3c 2f70 6172 616d 6574 6572 s_del integer. in i │ │ │ -00242980: 735f 786d 6c3c 2f70 6172 616d 6574 6572 s_xml integer. │ │ │ -002429b0: 2020 2020 2020 3c2f 6675 6e63 7072 6f74 . . . │ │ │ -002429f0: 203c 7265 6673 6563 7431 2069 643d 2264 Descri │ │ │ -00242a20: 7074 696f 6e3c 2f74 6974 6c65 3e0a 2020 ption. │ │ │ -00242a30: 2020 3c70 6172 613e 5468 6973 2066 756e This fun │ │ │ -00242a40: 6374 696f 6e20 616c 6c6f 7773 2079 6f75 ction allows you │ │ │ -00242a50: 2074 6f20 6164 6420 776f 7264 7320 746f to add words to │ │ │ -00242a60: 2061 2066 7265 6520 7465 7874 2075 7064 a free text upd │ │ │ -00242a70: 6174 6520 6261 7463 682e 0a49 7420 6361 ate batch..It ca │ │ │ -00242a80: 6e20 6265 2063 616c 6c65 6420 696e 2073 n be called in s │ │ │ -00242a90: 6571 7565 6e63 6520 746f 2066 6565 6420 equence to feed │ │ │ -00242aa0: 6772 6f75 7020 6f66 2064 6f63 756d 656e group of documen │ │ │ -00242ab0: 7473 2074 6861 7420 7368 6172 6520 6120 ts that share a │ │ │ -00242ac0: 636f 6d6d 6f6e 2064 6f63 756d 656e 7420 common document │ │ │ -00242ad0: 4944 0a61 6e64 2074 6865 2072 6573 756c ID.and the resul │ │ │ -00242ae0: 7420 6973 2073 696d 696c 6172 2074 6f20 t is similar to │ │ │ -00242af0: 7468 6520 7369 6e67 6c65 2063 616c 6c20 the single call │ │ │ -00242b00: 7768 6f73 6520 3c70 6172 616d 6574 6572 whose text_or_xml.paramet │ │ │ -00242b30: 6572 2069 7320 636f 6e63 6174 656e 6174 er is concatenat │ │ │ -00242b40: 696f 6e20 6f66 2064 6f63 756d 656e 7473 ion of documents │ │ │ -00242b50: 206f 6620 7468 6174 2067 726f 7570 2e20 of that group. │ │ │ -00242b60: 4974 2069 7320 6576 656e 2061 6c6c 6f77 It is even allow │ │ │ -00242b70: 6564 2074 6f20 6d69 780a 584d 4c20 616e ed to mix.XML an │ │ │ -00242b80: 6420 6e6f 6e2d 584d 4c20 646f 6375 6d65 d non-XML docume │ │ │ -00242b90: 6e74 7320 6279 2066 6565 6469 6e67 2061 nts by feeding a │ │ │ -00242ba0: 6e20 584d 4c20 646f 6375 6d65 6e74 2061 n XML document a │ │ │ -00242bb0: 6e64 2073 6f6d 6520 7465 7874 2064 6f63 nd some text doc │ │ │ -00242bc0: 756d 656e 7473 3a0a 7468 6520 6669 7273 uments:.the firs │ │ │ -00242bd0: 7420 646f 6375 6d65 6e74 2074 6f20 6665 t document to fe │ │ │ -00242be0: 6564 206d 6179 2062 6520 616e 2058 4d4c ed may be an XML │ │ │ -00242bf0: 2064 6f63 756d 656e 742c 206f 7468 6572 document, other │ │ │ -00242c00: 2064 6f63 756d 656e 7473 2073 686f 756c documents shoul │ │ │ -00242c10: 6420 6265 206f 6e6c 7920 7465 7874 732e d be only texts. │ │ │ -00242c20: 3c2f 7061 7261 3e0a 3c70 6172 613e 0a49 ..I │ │ │ -00242c30: 6620 6f6e 6520 7769 7368 6573 2074 6f20 f one wishes to │ │ │ -00242c40: 6d69 7820 584d 4c20 616e 6420 6e6f 6e2d mix XML and non- │ │ │ -00242c50: 584d 4c20 646f 6375 6d65 6e74 732c 206b XML documents, k │ │ │ -00242c60: 6e6f 776c 6564 6765 206f 6620 6465 7461 nowledge of deta │ │ │ -00242c70: 696c 7320 6f66 2074 6865 2069 6e64 6578 ils of the index │ │ │ -00242c80: 696e 6720 6d65 7468 6f64 2069 7320 6e65 ing method is ne │ │ │ -00242c90: 6564 6564 2e20 0a3c 6675 6e63 7469 6f6e eded. .vt_batch_feed assign │ │ │ -00242cc0: 7320 6120 7365 7175 656e 6365 2020 6e75 s a sequence nu │ │ │ -00242cd0: 6d62 6572 2074 6f20 6576 6572 7920 776f mber to every wo │ │ │ -00242ce0: 7264 206f 6620 7468 6520 7072 6f76 6964 rd of the provid │ │ │ -00242cf0: 6564 2064 6f63 756d 656e 740a 7573 696e ed document.usin │ │ │ -00242d00: 6720 616e 2069 6e74 6572 6e61 6c20 636f g an internal co │ │ │ -00242d10: 756e 7465 722e 0a54 6865 2063 616c 6c20 unter..The call │ │ │ -00242d20: 6f66 203c 6675 6e63 7469 6f6e 3e76 745f of vt_ │ │ │ -00242d30: 6261 7463 685f 645f 6964 3c2f 6675 6e63 batch_d_id not only s │ │ │ -00242d50: 6574 7320 646f 6375 6d65 6e74 2069 6420 ets document id │ │ │ -00242d60: 6275 7420 616c 736f 2072 6573 6574 7320 but also resets │ │ │ -00242d70: 7468 6973 2063 6f75 6e74 6572 2074 6f20 this counter to │ │ │ -00242d80: 302e 0a54 6865 2066 6972 7374 2065 6c65 0..The first ele │ │ │ -00242d90: 6d65 6e74 206f 6620 616e 2058 4d4c 2064 ment of an XML d │ │ │ -00242da0: 6f63 756d 656e 7420 7368 6f75 6c64 2068 ocument should h │ │ │ -00242db0: 6176 6520 6e75 6d62 6572 2030 2073 6f20 ave number 0 so │ │ │ -00242dc0: 6974 2069 7320 696d 706f 7373 6962 6c65 it is impossible │ │ │ -00242dd0: 2074 6f20 6665 6564 2061 6e20 584d 4c20 to feed an XML │ │ │ -00242de0: 646f 6375 6d65 6e74 2069 660a 7468 6572 document if.ther │ │ │ -00242df0: 6520 7765 7265 206f 7468 6572 2063 616c e were other cal │ │ │ -00242e00: 6c73 206f 6620 3c66 756e 6374 696f 6e3e ls of │ │ │ -00242e10: 7674 5f62 6174 6368 5f66 6565 643c 2f66 vt_batch_feed after t │ │ │ -00242e30: 6865 206c 6173 7420 3c66 756e 6374 696f he last vt_batch_d_id< │ │ │ -00242e50: 2f66 756e 6374 696f 6e3e 2e0a 4d6f 7265 /function>..More │ │ │ -00242e60: 6f76 6572 2c20 3c66 756e 6374 696f 6e3e over, │ │ │ -00242e70: 7863 6f6e 7461 696e 733c 2f66 756e 6374 xcontains will ignore │ │ │ -00242e90: 2077 6f72 6473 2066 726f 6d20 7465 7874 words from text │ │ │ -00242ea0: 2064 6f63 756d 656e 7473 0a74 6861 7420 documents.that │ │ │ -00242eb0: 7765 7265 2066 6564 2061 6674 6572 2074 were fed after t │ │ │ -00242ec0: 6865 2066 6972 7374 2058 4d4c 2064 6f63 he first XML doc │ │ │ -00242ed0: 756d 656e 742c 206f 6e6c 7920 3c66 756e ument, only contains will u │ │ │ -00242f00: 7365 2061 6c6c 2064 6174 612e 3c2f 7061 se all data... │ │ │ -00242f20: 2020 3c72 6566 7365 6374 3120 6964 3d22 Par │ │ │ -00242f50: 616d 6574 6572 733c 2f74 6974 6c65 3e0a ameters. │ │ │ -00242f60: 2020 2020 3c72 6566 7365 6374 323e 3c74 vt_batch. must be an obj │ │ │ -00242fa0: 6563 7420 7265 7475 726e 6564 2062 7920 ect returned by │ │ │ -00242fb0: 3c66 756e 6374 696f 6e3e 7674 5f62 6174 vt_bat │ │ │ -00242fc0: 6368 3c2f 6675 6e63 7469 6f6e 3e20 6f6e ch on │ │ │ -00242fd0: 2077 6869 6368 0a3c 6675 6e63 7469 6f6e which.vt_batch_d_id has be │ │ │ -00243000: 656e 2063 616c 6c65 643b 2065 2e67 2e20 en called; e.g. │ │ │ -00243010: 6974 2063 616e 2062 6520 6361 6c6c 6564 it can be called │ │ │ -00243020: 2069 6e73 6964 6520 7468 6520 696e 6465 inside the inde │ │ │ -00243030: 7820 686f 6f6b 2066 756e 6374 696f 6e3c x hook function< │ │ │ -00243040: 2f70 6172 613e 3c2f 7265 6673 6563 7432 /para>. │ │ │ -00243060: 3c74 6974 6c65 3e74 6578 745f 6f72 5f78 text_or_x │ │ │ -00243070: 6d6c 3c2f 7469 746c 653e 0a20 2020 2020 ml. │ │ │ -00243080: 203c 7061 7261 3e6d 7573 7420 6265 2061 must be a │ │ │ -00243090: 2062 6c6f 622c 2077 6964 6520 626c 6f62 blob, wide blob │ │ │ -002430a0: 2c20 7661 7263 6861 722c 206e 7661 7263 , varchar, nvarc │ │ │ -002430b0: 6861 7220 6f72 2058 4d4c 2065 6e74 6974 har or XML entit │ │ │ -002430c0: 7920 6f62 6a65 6374 2e3c 2f70 6172 613e y object. │ │ │ +00227df0: 5f5f 5f5f 5f5f 5f5f 0a0a 310a 0a31 2052 ________..1..1 R │ │ │ +00227e00: 6f77 732e 202d 2d20 3020 6d73 6563 2e0a ows. -- 0 msec.. │ │ │ +00227e10: 0a53 514c 3e73 656c 6563 7420 414e 4e5f .SQL>select ANN_ │ │ │ +00227e20: 5048 5241 5345 5f43 4c41 5353 5f41 4444 PHRASE_CLASS_ADD │ │ │ +00227e30: 2028 2750 6169 6420 6164 7327 2c20 6e75 ('Paid ads', nu │ │ │ +00227e40: 6c6c 2c20 6e75 6c6c 2c20 6e75 6c6c 2c20 ll, null, null, │ │ │ +00227e50: 2750 6169 6420 6164 7320 656e 7627 2c20 'Paid ads env', │ │ │ +00227e60: 2772 6570 6c61 6369 6e67 272c 2027 6462 'replacing', 'db │ │ │ +00227e70: 6127 2c20 2764 6261 2729 3b0a 6361 6c6c a', 'dba');.call │ │ │ +00227e80: 7265 740a 5641 5243 4841 520a 5f5f 5f5f ret.VARCHAR.____ │ │ │ +00227e90: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00227ea0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00227eb0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00227ec0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f 5f5f ________________ │ │ │ +00227ed0: 5f5f 5f5f 5f5f 5f5f 5f5f 5f0a 0a32 0a0a ___________..2.. │ │ │ +00227ee0: 3120 526f 7773 2e20 2d2d 2032 3631 206d 1 Rows. -- 261 m │ │ │ +00227ef0: 7365 632e 0a5d 5d3e 3c2f 7072 6f67 7261 sec..]]>. . . . See Also. DB │ │ │ +00227fb0: 2e44 4241 2e41 4e4e 5f50 4852 4153 455f .DBA.ANN_PHRASE_ │ │ │ +00227fc0: 434c 4153 535f 4445 4c3c 2f66 756e 6374 CLASS_DEL.
  • AP │ │ │ +00228020: 5f42 5549 4c44 5f4d 4154 4348 5f4c 4953 _BUILD_MATCH_LIS │ │ │ +00228030: 543c 2f66 756e 6374 696f 6e3e 3c2f 6c69 T
  • . ......'demo/d │ │ │ +00228070: 6f63 7372 632f 6675 6e63 7265 662f 7564 ocsrc/funcref/ud │ │ │ +00228080: 745f 696e 7374 616e 6365 5f6f 662e 786d t_instance_of.xm │ │ │ +00228090: 6cdf 0000 1133 3c3f 786d 6c20 7665 7273 l....3.. │ │ │ +00228c80: 2020 3c72 6566 7365 6374 3120 6964 3d22 . < │ │ │ +00228cb0: 7469 746c 653e 4578 616d 706c 6573 3c2f title>Examples. Using udt_ins │ │ │ +00228d00: 7461 6e63 655f 6f66 2829 3c2f 7469 746c tance_of(). .returns DB.DBA. │ │ │ +00228d80: 5345 525f 5544 543c 2f63 6f6d 7075 7465 SER_UDT (if the │ │ │ +00228da0: 200a 3c63 6f6d 7075 7465 726f 7574 7075 .SER_UDT type │ │ │ +00228dd0: 7761 7320 6372 6561 7465 6420 6279 2044 was created by D │ │ │ +00228de0: 4241 2069 6e20 7468 6520 4442 200a 6461 BA in the DB .da │ │ │ +00228df0: 7461 6261 7365 292e 3c2f 7061 7261 3e0a tabase).. │ │ │ +00228e00: 2020 2020 2020 3c73 6372 6565 6e3e 3c21 .returns DB.DBA │ │ │ +00228e70: 2e53 4552 5f55 4454 3c2f 636f 6d70 7574 .SER_UDT (if th │ │ │ +00228e90: 6520 0a3c 636f 6d70 7574 6572 6f75 7470 e .SER_UDT type │ │ │ +00228ec0: 2077 6173 2063 7265 6174 6564 2062 7920 was created by │ │ │ +00228ed0: 4442 4120 696e 2074 6865 2044 4220 0a64 DBA in the DB .d │ │ │ +00228ee0: 6174 6162 6173 6529 2e3c 2f70 6172 613e atabase). │ │ │ +00228ef0: 0a20 2020 2020 203c 7363 7265 656e 3e3c . < │ │ │ +00228f00: 215b 4344 4154 415b 0a73 656c 6563 7420 ![CDATA[.select │ │ │ +00228f10: 7564 745f 696e 7374 616e 6365 5f6f 6620 udt_instance_of │ │ │ +00228f20: 2827 5345 525f 5544 545f 5355 4227 2c20 ('SER_UDT_SUB', │ │ │ +00228f30: 2753 4552 5f55 4454 2729 3b0a 5d5d 3e3c 'SER_UDT');.]]>< │ │ │ +00228f40: 2f73 6372 6565 6e3e 0a3c 7061 7261 3e52 /screen>.R │ │ │ +00228f50: 6574 7572 6e73 2031 3c2f 7061 7261 3e0a eturns 1. │ │ │ +00228f60: 2020 2020 2020 3c73 6372 6565 6e3e 3c21 .Returns 0;. . │ │ │ +00228ff0: 0a20 203c 7265 6673 6563 7431 2069 643d . . < │ │ │ +00229020: 7469 746c 653e 5365 6520 416c 736f 3c2f title>See Also. udt_get()< │ │ │ +00229070: 2f66 756e 6374 696f 6e3e 3c2f 6c69 6e6b /function>. udt_defines_fi │ │ │ +002290d0: 656c 6428 293c 2f66 756e 6374 696f 6e3e eld() │ │ │ +002290e0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +002290f0: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c udt_ │ │ │ +00229130: 696d 706c 656d 656e 7473 5f6d 6574 686f implements_metho │ │ │ +00229140: 6428 293c 2f66 756e 6374 696f 6e3e 3c2f d(). │ │ │ +00229160: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e udt_ │ │ │ +00229190: 7365 7428 293c 2f66 756e 6374 696f 6e3e set() │ │ │ +002291a0: 3c2f 6c69 6e6b 3e3c 2f70 6172 613e 0a20 . │ │ │ +002291b0: 203c 2f72 6566 7365 6374 313e 0a3c 2f72 .......de │ │ │ +002291d0: 6d6f 2f64 6f63 7372 632f 6675 6e63 7265 mo/docsrc/funcre │ │ │ +002291e0: 662f 636c 5f65 7865 632e 786d 6cdf 0000 f/cl_exec.xml... │ │ │ +002291f0: 0c4b 3c3f 786d 6c20 7665 7273 696f 6e3d .K. │ │ │ +00229570: 0a3c 7265 6665 6e74 7279 2069 643d 2266 .. . cl_ex │ │ │ +002295b0: 6563 3c2f 7265 6665 6e74 7279 7469 746c ec. sql. . . c │ │ │ +00229610: 6c5f 6578 6563 3c2f 7265 666e 616d 653e l_exec │ │ │ +00229620: 0a20 2020 203c 7265 6670 7572 706f 7365 . executes things │ │ │ +00229640: 206f 6e20 616c 6c20 6e6f 6465 7320 6f66 on all nodes of │ │ │ +00229650: 2061 2063 6c75 7374 6572 3c2f 7265 6670 a cluster. . . < │ │ │ +00229690: 6675 6e63 7379 6e6f 7073 6973 2069 643d funcsynopsis id= │ │ │ +002296a0: 2266 7379 6e5f 636c 5f65 7865 6322 3e0a "fsyn_cl_exec">. │ │ │ +002296b0: 2020 2020 2020 3c66 756e 6370 726f 746f . │ │ │ +002296e0: 2020 3c66 756e 6364 6566 3e3c 6675 6e63 cl_exec. in cmd varchar.

    in │ │ │ +00229780: 7061 7261 6d73 203c 2f70 6172 616d 6574 params any := NULL< │ │ │ +002297a0: 2f6f 7074 696f 6e61 6c3e 3c2f 7061 7261 /optional>.

    in │ │ │ +002297e0: 6973 5f74 786e 203c 2f70 6172 616d 6574 is_txn int := 0. . . │ │ │ +00229840: 3c2f 7265 6673 796e 6f70 7369 7364 6976 . │ │ │ +00229870: 3c74 6974 6c65 3e44 6573 6372 6970 7469 Descripti │ │ │ +00229880: 6f6e 3c2f 7469 746c 653e 0a09 3c70 6172 on..The cl_exec SQ │ │ │ +002298a0: 4c20 6675 6e63 7469 6f6e 2063 616e 2062 L function can b │ │ │ +002298b0: 6520 7573 6564 2066 6f72 2065 7865 6375 e used for execu │ │ │ +002298c0: 7469 6e67 2074 6869 6e67 7320 6f6e 2061 ting things on a │ │ │ +002298d0: 6c6c 206e 6f64 6573 206f 6620 6120 636c ll nodes of a cl │ │ │ +002298e0: 7573 7465 722e 3c2f 7061 7261 3e0a 093c uster...< │ │ │ +002298f0: 2f72 6566 7365 6374 313e 0a09 3c72 6566 /refsect1>... < │ │ │ +00229920: 7469 746c 653e 5061 7261 6d65 7465 7273 title>Parameters │ │ │ +00229930: 3c2f 7469 746c 653e 0a20 2020 203c 7265 . cm │ │ │ +00229950: 643c 2f74 6974 6c65 3e0a 2020 2020 2020 d. │ │ │ +00229960: 3c70 6172 613e 4120 5351 4c20 7374 7269 A SQL stri │ │ │ +00229970: 6e67 2e20 4966 2069 7420 636f 6e74 6169 ng. If it contai │ │ │ +00229980: 6e73 2070 6172 616d 6574 6572 206d 6172 ns parameter mar │ │ │ +00229990: 6b65 7273 2028 3f29 2c20 7468 6520 7061 kers (?), the pa │ │ │ +002299a0: 7261 6d73 2061 7272 6179 2069 7320 7573 rams array is us │ │ │ +002299b0: 6564 2066 6f72 2061 7373 6967 6e69 6e67 ed for assigning │ │ │ +002299c0: 2076 616c 7565 732c 206c 6566 7420 746f values, left to │ │ │ +002299d0: 2072 6967 6874 2e3c 2f70 6172 613e 0a20 right.. │ │ │ +002299e0: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +002299f0: 2020 203c 7265 6673 6563 7432 3e3c 7469 params. A │ │ │ +00229a20: 6e79 2070 6172 616d 732e 3c2f 7061 7261 ny params.. . │ │ │ +00229a50: 3c74 6974 6c65 3e69 735f 7478 6e3c 2f74 is_txn</t │ │ │ +00229a60: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +00229a70: 613e 4966 2073 6574 2074 6f20 312c 2074 a>If set to 1, t │ │ │ +00229a80: 6865 2063 6c5f 6578 6563 206d 616b 6573 he cl_exec makes │ │ │ +00229a90: 2061 2064 6973 7472 6962 7574 6564 2074 a distributed t │ │ │ +00229aa0: 7261 6e73 6163 7469 6f6e 2061 6e64 2064 ransaction and d │ │ │ +00229ab0: 6f65 7320 6e6f 7420 6175 746f 6d61 7469 oes not automati │ │ │ +00229ac0: 6361 6c6c 7920 636f 6d6d 6974 206f 6e20 cally commit on │ │ │ +00229ad0: 6c6f 6361 6c6c 7920 6f6e 2065 6163 6820 locally on each │ │ │ +00229ae0: 6e6f 6465 2e0a 2020 2020 2020 0954 6875 node.. .Thu │ │ │ +00229af0: 7320 636c 5f65 7865 6320 6361 6e20 6265 s cl_exec can be │ │ │ +00229b00: 2075 7365 6420 6173 2070 6172 7420 6f66 used as part of │ │ │ +00229b10: 2061 2063 6f6e 7461 696e 696e 6720 6469 a containing di │ │ │ +00229b20: 7374 7269 6275 7465 6420 7472 616e 7361 stributed transa │ │ │ +00229b30: 6374 696f 6e2e 3c2f 7061 7261 3e0a 2020 ction.</para>. │ │ │ +00229b40: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 </refsect2>. │ │ │ +00229b50: 3c2f 7265 6673 6563 7431 3e0a 2020 3c72 </refsect1>. <r │ │ │ +00229b60: 6566 7365 6374 3120 6964 3d22 6578 616d efsect1 id="exam │ │ │ +00229b70: 706c 6573 5f63 6c5f 6578 6563 223e 0a20 ples_cl_exec">. │ │ │ +00229b80: 2020 3c74 6974 6c65 3e45 7861 6d70 6c65 <title>Example │ │ │ +00229b90: 733c 2f74 6974 6c65 3e0a 2020 2020 3c65 s. Si │ │ │ +00229bc0: 6d70 6c65 2065 7861 6d70 6c65 3c2f 7469 mple example</ti │ │ │ +00229bd0: 746c 653e 0a3c 7363 7265 656e 3e3c 215b tle>.<screen><![ │ │ │ +00229be0: 4344 4154 415b 0a53 514c 3e20 636c 5f65 CDATA[.SQL> cl_e │ │ │ +00229bf0: 7865 6320 2827 7368 7574 646f 776e 2729 xec ('shutdown') │ │ │ +00229c00: 0a2d 2d77 696c 6c20 7368 7574 2061 6c6c .--will shut all │ │ │ +00229c10: 206e 6f64 6573 2e0a 0a53 514c 3e20 636c nodes...SQL> cl │ │ │ +00229c20: 5f65 7865 6320 2827 6462 675f 6f62 6a5f _exec ('dbg_obj_ │ │ │ +00229c30: 7072 696e 7420 283f 2927 2c20 7665 6374 print (?)', vect │ │ │ +00229c40: 6f72 2028 2768 656c 6c6f 2729 293b 0a2d or ('hello'));.- │ │ │ +00229c50: 2d77 696c 6c20 7072 696e 7420 6865 6c6c -will print hell │ │ │ +00229c60: 6f20 746f 2074 6865 2073 7461 6e64 6172 o to the standar │ │ │ +00229c70: 6420 6f75 7470 7574 206f 6620 616c 6c20 d output of all │ │ │ +00229c80: 7468 6520 7072 6f63 6573 7365 7320 6f66 the processes of │ │ │ +00229c90: 2074 6865 2063 6c75 7374 6572 2e0a 5d5d the cluster..]] │ │ │ +00229ca0: 3e3c 2f73 6372 6565 6e3e 0a20 2020 203c ></screen>. < │ │ │ +00229cb0: 2f65 7861 6d70 6c65 3e0a 2020 3c2f 7265 /example>. </re │ │ │ +00229cc0: 6673 6563 7431 3e0a 2020 2020 3c72 6566 fsect1>. <ref │ │ │ +00229cd0: 7365 6374 3120 6964 3d22 7365 6561 6c73 sect1 id="seeals │ │ │ +00229ce0: 6f5f 7264 665f 6c6f 6164 6572 5f72 756e o_rdf_loader_run │ │ │ +00229cf0: 223e 0a20 2020 203c 7469 746c 653e 5365 ">. <title>Se │ │ │ +00229d00: 6520 416c 736f 3c2f 7469 746c 653e 0a20 e Also. │ │ │ +00229d10: 2020 203c 7061 7261 3e3c 6c69 6e6b 206c C │ │ │ +00229d60: 6c75 7374 6572 2049 6e73 7461 6c6c 6174 luster Installat │ │ │ +00229d70: 696f 6e20 616e 6420 436f 6e66 6967 3c2f ion and Config. │ │ │ +00229d90: 203c 7061 7261 3e3c 6c69 6e6b 206c 696e Backup an │ │ │ +00229e00: 6420 5265 7374 6f72 6520 4578 616d 706c d Restore Exampl │ │ │ +00229e10: 653c 2f6c 696e 6b3e 3c2f 7061 7261 3e0a e. │ │ │ +00229e20: 2020 3c2f 7265 6673 6563 7431 3e0a 3c2f ........ │ │ │ +00229e40: 0025 6465 6d6f 2f64 6f63 7372 632f 6675 .%demo/docsrc/fu │ │ │ +00229e50: 6e63 7265 662f 6e6e 7470 5f61 7574 685f ncref/nntp_auth_ │ │ │ +00229e60: 6765 742e 786d 6cdf 0000 12f9 3c3f 786d get.xml........ . nntp_a │ │ │ +0022a240: 7574 685f 6765 743c 2f72 6566 656e 7472 uth_get. mail. . . nntp_auth_g │ │ │ +0022a2b0: 6574 3c2f 7265 666e 616d 653e 0a20 2020 et. │ │ │ +0022a2c0: 203c 7265 6670 7572 706f 7365 3e72 6574 ret │ │ │ +0022a2d0: 7572 6e73 2069 6e66 6f72 6d61 7469 6f6e urns information │ │ │ +0022a2e0: 2061 626f 7574 2061 6e20 4e4e 5450 2073 about an NNTP s │ │ │ +0022a2f0: 6572 7665 7220 7769 7468 2061 7574 686f erver with autho │ │ │ +0022a300: 7269 7a61 7469 6f6e 3c2f 7265 6670 7572 rization. . . . . arraynntp_auth_ge │ │ │ +0022a3c0: 743c 2f66 756e 6374 696f 6e3e 3c2f 6675 t. < │ │ │ +0022a3e0: 7061 7261 6d64 6566 3e69 6e20 3c70 6172 paramdef>in server

    varcha │ │ │ +0022a410: 723c 2f70 6172 616d 6465 663e 0a20 2020 r. │ │ │ +0022a420: 2020 2020 203c 7061 7261 6d64 6566 3e69 i │ │ │ +0022a430: 6e20 3c70 6172 616d 6574 6572 3e75 7365 n use │ │ │ +0022a440: 723c 2f70 6172 616d 6574 6572 3e20 7661 r va │ │ │ +0022a450: 7263 6861 723c 2f70 6172 616d 6465 663e rchar │ │ │ +0022a460: 0a20 2020 2020 2020 203c 7061 7261 6d64 . in password varchar

    . │ │ │ +0022a4b0: 203c 7061 7261 6d64 6566 3e69 6e20 3c70 in

    command │ │ │ +0022a4d0: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +0022a4e0: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +0022a4f0: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +0022a510: 6772 6f75 703c 2f70 6172 616d 6574 6572 group varchar. in f │ │ │ +0022a560: 6972 7374 5f6d 6573 7361 6765 3c2f 7061 irst_message integer │ │ │ +0022a580: 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 6172 . < │ │ │ +0022a5a0: 7061 7261 6d64 6566 3e3c 6f70 7469 6f6e paramdef>

    intege │ │ │ +0022a5e0: 723c 2f6f 7074 696f 6e61 6c3e 3c2f 7061 r. . │ │ │ +0022a610: 2020 203c 2f66 756e 6373 796e 6f70 7369 . . Description.The │ │ │ +0022a680: 3c66 756e 6374 696f 6e3e 6e6e 7470 5f61 nntp_a │ │ │ +0022a690: 7574 685f 6765 7428 293c 2f66 756e 6374 uth_get() is used to │ │ │ +0022a6b0: 7265 7472 6965 7665 206d 6573 7361 6765 retrieve message │ │ │ +0022a6c0: 7320 6672 6f6d 2061 200a 7365 7276 6572 s from a .server │ │ │ +0022a6d0: 2072 6571 7569 7269 6e67 2061 7574 686f requiring autho │ │ │ +0022a6e0: 7269 7a61 7469 6f6e 2e20 2053 6565 206e rization. See n │ │ │ +0022a6f0: 6e74 705f 6765 7420 666f 7220 6d6f 7265 ntp_get for more │ │ │ +0022a700: 2069 6e66 6f72 6d61 7469 6f6e 2e3c 2f70 information.

    ..
    .. │ │ │ +0022a750: 5061 7261 6d65 7465 7273 3c2f 7469 746c Parameters</titl │ │ │ +0022a760: 653e 0a20 2020 203c 7265 6673 6563 7432 e>. <refsect2 │ │ │ +0022a770: 3e0a 2020 2020 2020 3c74 6974 6c65 3e73 >. <title>s │ │ │ +0022a780: 6572 7665 723c 2f74 6974 6c65 3e0a 2020 erver. │ │ │ +0022a790: 2020 2020 3c70 6172 613e 5468 6520 686f The ho │ │ │ +0022a7a0: 7374 2074 6f20 636f 6e6e 6563 7420 7769 st to connect wi │ │ │ +0022a7b0: 7468 2e20 4950 2061 6464 7265 7373 206f th. IP address o │ │ │ +0022a7c0: 7220 686f 7374 6e61 6d65 3a70 6f72 742e r hostname:port. │ │ │ +0022a7d0: 2020 5468 6572 6520 6973 206e 6f20 6465 There is no de │ │ │ +0022a7e0: 6661 756c 7420 666f 7220 0a20 2020 2020 fault for . │ │ │ +0022a7f0: 2070 6f72 742c 2073 6f20 746f 2063 6f6e port, so to con │ │ │ +0022a800: 6e65 6374 2074 6f20 7468 6520 7374 616e nect to the stan │ │ │ +0022a810: 6461 7264 2070 6f72 7420 666f 7220 4e4e dard port for NN │ │ │ +0022a820: 5450 2c20 7573 6520 266c 743b 686f 7374 TP, use <host │ │ │ +0022a830: 6e61 6d65 2f49 5020 6164 6472 6573 7326 name/IP address& │ │ │ +0022a840: 6774 3b3a 3131 393c 2f70 6172 613e 0a20 gt;:119. │ │ │ +0022a850: 2020 203c 2f72 6566 7365 6374 323e 0a20 . │ │ │ +0022a860: 2020 203c 7265 6673 6563 7432 3e0a 2020 . │ │ │ +0022a870: 2020 3c72 6566 7365 6374 323e 0a20 2020 . │ │ │ +0022a880: 2020 203c 7469 746c 653e 7573 6572 3c2f user</ │ │ │ +0022a890: 7469 746c 653e 0a20 2020 2020 203c 7061 title>. <pa │ │ │ +0022a8a0: 7261 3e54 6865 2075 7365 726e 616d 652e ra>The username. │ │ │ +0022a8b0: 0a20 2020 2020 203c 2f70 6172 613e 0a20 . </para>. │ │ │ +0022a8c0: 2020 203c 2f72 6566 7365 6374 323e 0a20 </refsect2>. │ │ │ +0022a8d0: 2020 203c 7265 6673 6563 7432 3e0a 2020 <refsect2>. │ │ │ +0022a8e0: 2020 2020 3c74 6974 6c65 3e70 6173 7377 <title>passw │ │ │ +0022a8f0: 6f72 643c 2f74 6974 6c65 3e0a 2020 2020 ord. │ │ │ +0022a900: 2020 3c70 6172 613e 5468 6520 7573 6572 The user │ │ │ +0022a910: 2070 6173 7377 6f72 642e 0a20 2020 2020 password.. │ │ │ +0022a920: 203c 2f70 6172 613e 0a20 2020 203c 2f72 . . < │ │ │ +0022a940: 7469 746c 653e 636f 6d6d 616e 643c 2f74 title>command. Command │ │ │ +0022a970: 7374 7269 6e67 3c2f 7479 7065 3e2e 2020 string. │ │ │ +0022a980: 5661 6c69 6420 7661 6c75 6573 2061 7265 Valid values are │ │ │ +0022a990: 3a3c 2f70 6172 613e 0a20 2020 2020 203c :. < │ │ │ +0022a9a0: 7369 6d70 6c65 6c69 7374 3e0a 2020 2020 simplelist>. │ │ │ +0022a9b0: 2020 2020 3c6d 656d 6265 723e 6172 7469 arti │ │ │ +0022a9c0: 636c 653c 2f6d 656d 6265 723e 0a20 2020 cle. │ │ │ +0022a9d0: 2020 2020 203c 6d65 6d62 6572 3e62 6f64 bod │ │ │ +0022a9e0: 793c 2f6d 656d 6265 723e 0a20 2020 2020 y. │ │ │ +0022a9f0: 2020 203c 6d65 6d62 6572 3e68 6561 643c head< │ │ │ +0022aa00: 2f6d 656d 6265 723e 0a20 2020 2020 2020 /member>. │ │ │ +0022aa10: 203c 6d65 6d62 6572 3e73 7461 743c 2f6d stat. < │ │ │ +0022aa30: 6d65 6d62 6572 3e6c 6973 743c 2f6d 656d member>list. group. xover. . . . group │ │ │ +0022aad0: 0a20 2020 2020 203c 7061 7261 3e41 203c . A < │ │ │ +0022aae0: 7479 7065 3e73 7472 696e 673c 2f74 7970 type>string containing na │ │ │ +0022ab00: 6d65 206f 6620 7468 6520 6e65 7773 2067 me of the news g │ │ │ +0022ab10: 726f 7570 2e3c 2f70 6172 613e 0a20 2020 roup.. │ │ │ +0022ab20: 203c 2f72 6566 7365 6374 323e 0a20 203c . < │ │ │ +0022ab30: 2f72 6566 7365 6374 313e 0a20 203c 7265 /refsect1>. │ │ │ +0022ab50: 3c74 6974 6c65 3e52 6574 7572 6e20 5479 Return Ty │ │ │ +0022ab60: 7065 733c 2f74 6974 6c65 3e0a 2020 2020 pes. │ │ │ +0022ab70: 3c70 6172 613e 4120 7665 6374 6f72 206f A vector o │ │ │ +0022ab80: 6620 7665 6374 6f72 7320 7468 6520 636f f vectors the co │ │ │ +0022ab90: 6e74 656e 7420 6465 7065 6e64 7320 6f66 ntent depends of │ │ │ +0022aba0: 2063 6f6d 6d61 6e64 2e3c 2f70 6172 613e command. │ │ │ +0022abb0: 0a20 203c 2f72 6566 7365 6374 313e 0a0a . .. │ │ │ +0022abc0: 2020 3c72 6566 7365 6374 3120 6964 3d22 Err │ │ │ +0022abf0: 6f72 733c 2f74 6974 6c65 3e0a 2020 2020 ors. │ │ │ +0022ac00: 3c74 6162 6c65 3e3c 7469 746c 653e 4572
    Er │ │ │ +0022ac10: 726f 7273 2073 6967 6e61 6c6c 6564 2062 rors signalled b │ │ │ +0022ac20: 7920 6e6e 7470 5f61 7574 685f 6765 743c y nntp_auth_get< │ │ │ +0022ac30: 2f74 6974 6c65 3e0a 2020 2020 2020 3c74 /title>. <t │ │ │ +0022ac40: 6772 6f75 7020 636f 6c73 3d22 3422 3e0a group cols="4">. │ │ │ +0022ac50: 2020 2020 2020 203c 7468 6561 643e 3c72 <thead><r │ │ │ +0022ac60: 6f77 3e3c 656e 7472 793e 5351 4c53 7461 ow><entry>SQLSta │ │ │ +0022ac70: 7465 3c2f 656e 7472 793e 3c65 6e74 7279 te</entry><entry │ │ │ +0022ac80: 3e45 7272 6f72 2043 6f64 653c 2f65 6e74 >Error Code</ent │ │ │ +0022ac90: 7279 3e3c 656e 7472 793e 4572 726f 7220 ry><entry>Error │ │ │ +0022aca0: 5465 7874 3c2f 656e 7472 793e 3c65 6e74 Text</entry><ent │ │ │ +0022acb0: 7279 3e44 6573 6372 6970 7469 6f6e 3c2f ry>Description</ │ │ │ +0022acc0: 656e 7472 793e 3c2f 726f 773e 3c2f 7468 entry></row></th │ │ │ +0022acd0: 6561 643e 0a09 3c74 626f 6479 3e0a 0920 ead>..<tbody>.. │ │ │ +0022ace0: 203c 726f 773e 0a09 2020 2020 3c65 6e74 <row>.. <ent │ │ │ +0022acf0: 7279 3e3c 6572 726f 7263 6f64 653e 3232 ry><errorcode>22 │ │ │ +0022ad00: 3032 333c 2f65 7272 6f72 636f 6465 3e3c 023</errorcode>< │ │ │ +0022ad10: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ +0022ad20: 7472 793e 3c65 7272 6f72 636f 6465 3e4e try><errorcode>N │ │ │ +0022ad30: 4e30 3038 3c2f 6572 726f 7263 6f64 653e N008</errorcode> │ │ │ +0022ad40: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 </entry>.. <e │ │ │ +0022ad50: 6e74 7279 3e3c 6572 726f 726e 616d 653e ntry><errorname> │ │ │ +0022ad60: 7468 6520 636f 6d6d 616e 6420 6973 206e the command is n │ │ │ +0022ad70: 6f74 2072 6563 6f67 6e69 7a65 643c 2f65 ot recognized</e │ │ │ +0022ad80: 7272 6f72 6e61 6d65 3e3c 2f65 6e74 7279 rrorname></entry │ │ │ +0022ad90: 3e0a 0920 2020 203c 656e 7472 793e 3c2f >.. <entry></ │ │ │ +0022ada0: 656e 7472 793e 0a09 2020 3c2f 726f 773e entry>.. </row> │ │ │ +0022adb0: 0a09 2020 3c72 6f77 3e0a 0920 2020 203c .. <row>.. < │ │ │ +0022adc0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ +0022add0: 3e32 4530 3030 3c2f 6572 726f 7263 6f64 >2E000</errorcod │ │ │ +0022ade0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ +0022adf0: 3c65 6e74 7279 3e3c 6572 726f 7263 6f64 <entry><errorcod │ │ │ +0022ae00: 653e 4e4e 3030 323c 2f65 7272 6f72 636f e>NN002</errorco │ │ │ +0022ae10: 6465 3e3c 2f65 6e74 7279 3e0a 0920 2020 de></entry>.. │ │ │ +0022ae20: 203c 656e 7472 793e 3c65 7272 6f72 6e61 <entry><errorna │ │ │ +0022ae30: 6d65 3e49 6e76 616c 6964 2061 6464 7265 me>Invalid addre │ │ │ +0022ae40: 7373 2066 6f72 204e 6577 7320 5365 7276 ss for News Serv │ │ │ +0022ae50: 6572 2061 7420 5b68 6f73 745d 3c2f 6572 er at [host]</er │ │ │ +0022ae60: 726f 726e 616d 653e 3c2f 656e 7472 793e rorname></entry> │ │ │ +0022ae70: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. <entry></e │ │ │ +0022ae80: 6e74 7279 3e0a 0920 203c 2f72 6f77 3e0a ntry>.. </row>. │ │ │ +0022ae90: 0920 203c 726f 773e 0a09 2020 2020 3c65 . <row>.. <e │ │ │ +0022aea0: 6e74 7279 3e3c 6572 726f 7263 6f64 653e ntry><errorcode> │ │ │ +0022aeb0: 3038 3030 313c 2f65 7272 6f72 636f 6465 08001</errorcode │ │ │ +0022aec0: 3e3c 2f65 6e74 7279 3e0a 0920 2020 203c ></entry>.. < │ │ │ +0022aed0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry><errorcode │ │ │ +0022aee0: 3e4e 4e30 3033 3c2f 6572 726f 7263 6f64 >NN003</errorcod │ │ │ +0022aef0: 653e 3c2f 656e 7472 793e 0a09 2020 2020 e></entry>.. │ │ │ +0022af00: 3c65 6e74 7279 3e3c 6572 726f 726e 616d <entry><errornam │ │ │ +0022af10: 653e 556e 6162 6c65 2074 6f20 436f 6e74 e>Unable to Cont │ │ │ +0022af20: 6163 7420 4e65 7773 2053 6572 7665 7220 act News Server │ │ │ +0022af30: 6174 205b 686f 7374 5d3c 2f65 7272 6f72 at [host]</error │ │ │ +0022af40: 6e61 6d65 3e3c 2f65 6e74 7279 3e0a 0920 name></entry>.. │ │ │ +0022af50: 2020 203c 656e 7472 793e 3c2f 656e 7472 <entry></entr │ │ │ +0022af60: 793e 0a09 2020 3c2f 726f 773e 0a09 2020 y>.. </row>.. │ │ │ +0022af70: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 <row>.. <entr │ │ │ +0022af80: 793e 3c65 7272 6f72 636f 6465 3e30 3830 y><errorcode>080 │ │ │ +0022af90: 3036 3c2f 6572 726f 7263 6f64 653e 3c2f 06</errorcode></ │ │ │ +0022afa0: 656e 7472 793e 0a09 2020 2020 3c65 6e74 entry>.. <ent │ │ │ +0022afb0: 7279 3e3c 6572 726f 7263 6f64 653e 4e4e ry><errorcode>NN │ │ │ +0022afc0: 3030 343c 2f65 7272 6f72 636f 6465 3e3c 004</errorcode>< │ │ │ +0022afd0: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. <en │ │ │ +0022afe0: 7472 793e 3c65 7272 6f72 6e61 6d65 3e4c try><errorname>L │ │ │ +0022aff0: 6f73 7420 636f 6e6e 6563 7469 6f6e 2077 ost connection w │ │ │ +0022b000: 6974 6820 4e4e 5450 2073 6572 7665 723c ith NNTP server< │ │ │ +0022b010: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ +0022b020: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ +0022b030: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f </entry>.. </ro │ │ │ +0022b040: 773e 0a09 2020 3c72 6f77 3e0a 0920 2020 w>.. <row>.. │ │ │ +0022b050: 203c 656e 7472 793e 3c65 7272 6f72 636f <entry><errorco │ │ │ +0022b060: 6465 3e30 3830 3036 3c2f 6572 726f 7263 de>08006</errorc │ │ │ +0022b070: 6f64 653e 3c2f 656e 7472 793e 0a09 2020 ode></entry>.. │ │ │ +0022b080: 2020 3c65 6e74 7279 3e3c 6572 726f 7263 <entry><errorc │ │ │ +0022b090: 6f64 653e 4e4e 3030 383c 2f65 7272 6f72 ode>NN008</error │ │ │ +0022b0a0: 636f 6465 3e3c 2f65 6e74 7279 3e0a 0920 code></entry>.. │ │ │ +0022b0b0: 2020 203c 656e 7472 793e 3c65 7272 6f72 <entry><error │ │ │ +0022b0c0: 6e61 6d65 3e4d 6973 632e 2065 7272 6f72 name>Misc. error │ │ │ +0022b0d0: 2069 6e20 636f 6e6e 6563 7469 6f6e 2069 in connection i │ │ │ +0022b0e0: 6e20 6e6e 7470 5f61 7574 685f 6765 743c n nntp_auth_get< │ │ │ +0022b0f0: 2f65 7272 6f72 6e61 6d65 3e3c 2f65 6e74 /errorname></ent │ │ │ +0022b100: 7279 3e0a 0920 2020 203c 656e 7472 793e ry>.. <entry> │ │ │ +0022b110: 3c2f 656e 7472 793e 0a09 2020 3c2f 726f </entry>.. </ro │ │ │ +0022b120: 773e 0a09 3c2f 7462 6f64 793e 0a20 2020 w>..</tbody>. │ │ │ +0022b130: 2020 203c 2f74 6772 6f75 703e 0a20 2020 </tgroup>. │ │ │ +0022b140: 203c 2f74 6162 6c65 3e0a 2020 3c2f 7265 </table>. </re │ │ │ +0022b150: 6673 6563 7431 3e0a 3c2f 7265 6665 6e74 fsect1>.</refent │ │ │ +0022b160: 7279 3e0a 0ab6 0000 0020 6465 6d6f 2f64 ry>...... demo/d │ │ │ +0022b170: 6f63 7372 632f 6675 6e63 7265 662f 6874 ocsrc/funcref/ht │ │ │ +0022b180: 7470 5f75 726c 2e78 6d6c df00 0014 a63c tp_url.xml.....< │ │ │ +0022b190: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +0022b1a0: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +0022b1b0: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>.<!--. │ │ │ +0022b1c0: 202d 2020 0a20 2d20 2054 6869 7320 6669 - . - This fi │ │ │ +0022b1d0: 6c65 2069 7320 7061 7274 206f 6620 7468 le is part of th │ │ │ +0022b1e0: 6520 4f70 656e 4c69 6e6b 2053 6f66 7477 e OpenLink Softw │ │ │ +0022b1f0: 6172 6520 5669 7274 756f 736f 204f 7065 are Virtuoso Ope │ │ │ +0022b200: 6e2d 536f 7572 6365 2028 564f 5329 0a20 n-Source (VOS). │ │ │ +0022b210: 2d20 2070 726f 6a65 6374 2e0a 202d 2020 - project.. - │ │ │ +0022b220: 0a20 2d20 2043 6f70 7972 6967 6874 2028 . - Copyright ( │ │ │ +0022b230: 4329 2031 3939 382d 3230 3234 204f 7065 C) 1998-2024 Ope │ │ │ +0022b240: 6e4c 696e 6b20 536f 6674 7761 7265 0a20 nLink Software. │ │ │ +0022b250: 2d20 200a 202d 2020 5468 6973 2070 726f - . - This pro │ │ │ +0022b260: 6a65 6374 2069 7320 6672 6565 2073 6f66 ject is free sof │ │ │ +0022b270: 7477 6172 653b 2079 6f75 2063 616e 2072 tware; you can r │ │ │ +0022b280: 6564 6973 7472 6962 7574 6520 6974 2061 edistribute it a │ │ │ +0022b290: 6e64 2f6f 7220 6d6f 6469 6679 2069 740a nd/or modify it. │ │ │ +0022b2a0: 202d 2020 756e 6465 7220 7468 6520 7465 - under the te │ │ │ +0022b2b0: 726d 7320 6f66 2074 6865 2047 4e55 2047 rms of the GNU G │ │ │ +0022b2c0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ +0022b2d0: 6365 6e73 6520 6173 2070 7562 6c69 7368 cense as publish │ │ │ +0022b2e0: 6564 2062 7920 7468 650a 202d 2020 4672 ed by the. - Fr │ │ │ +0022b2f0: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ +0022b300: 6461 7469 6f6e 3b20 6f6e 6c79 2076 6572 dation; only ver │ │ │ +0022b310: 7369 6f6e 2032 206f 6620 7468 6520 4c69 sion 2 of the Li │ │ │ +0022b320: 6365 6e73 652c 2064 6174 6564 204a 756e cense, dated Jun │ │ │ +0022b330: 6520 3139 3931 2e0a 202d 2020 0a20 2d20 e 1991.. - . - │ │ │ +0022b340: 2054 6869 7320 7072 6f67 7261 6d20 6973 This program is │ │ │ +0022b350: 2064 6973 7472 6962 7574 6564 2069 6e20 distributed in │ │ │ +0022b360: 7468 6520 686f 7065 2074 6861 7420 6974 the hope that it │ │ │ +0022b370: 2077 696c 6c20 6265 2075 7365 6675 6c2c will be useful, │ │ │ +0022b380: 2062 7574 0a20 2d20 2057 4954 484f 5554 but. - WITHOUT │ │ │ +0022b390: 2041 4e59 2057 4152 5241 4e54 593b 2077 ANY WARRANTY; w │ │ │ +0022b3a0: 6974 686f 7574 2065 7665 6e20 7468 6520 ithout even the │ │ │ +0022b3b0: 696d 706c 6965 6420 7761 7272 616e 7479 implied warranty │ │ │ +0022b3c0: 206f 660a 202d 2020 4d45 5243 4841 4e54 of. - MERCHANT │ │ │ +0022b3d0: 4142 494c 4954 5920 6f72 2046 4954 4e45 ABILITY or FITNE │ │ │ +0022b3e0: 5353 2046 4f52 2041 2050 4152 5449 4355 SS FOR A PARTICU │ │ │ +0022b3f0: 4c41 5220 5055 5250 4f53 452e 2053 6565 LAR PURPOSE. See │ │ │ +0022b400: 2074 6865 2047 4e55 0a20 2d20 2047 656e the GNU. - Gen │ │ │ +0022b410: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ +0022b420: 6e73 6520 666f 7220 6d6f 7265 2064 6574 nse for more det │ │ │ +0022b430: 6169 6c73 2e0a 202d 2020 0a20 2d20 2059 ails.. - . - Y │ │ │ +0022b440: 6f75 2073 686f 756c 6420 6861 7665 2072 ou should have r │ │ │ +0022b450: 6563 6569 7665 6420 6120 636f 7079 206f eceived a copy o │ │ │ +0022b460: 6620 7468 6520 474e 5520 4765 6e65 7261 f the GNU Genera │ │ │ +0022b470: 6c20 5075 626c 6963 204c 6963 656e 7365 l Public License │ │ │ +0022b480: 2061 6c6f 6e67 0a20 2d20 2077 6974 6820 along. - with │ │ │ +0022b490: 7468 6973 2070 726f 6772 616d 3b20 6966 this program; if │ │ │ +0022b4a0: 206e 6f74 2c20 7772 6974 6520 746f 2074 not, write to t │ │ │ +0022b4b0: 6865 2046 7265 6520 536f 6674 7761 7265 he Free Software │ │ │ +0022b4c0: 2046 6f75 6e64 6174 696f 6e2c 2049 6e63 Foundation, Inc │ │ │ +0022b4d0: 2e2c 0a20 2d20 2035 3120 4672 616e 6b6c .,. - 51 Frankl │ │ │ +0022b4e0: 696e 2053 742c 2046 6966 7468 2046 6c6f in St, Fifth Flo │ │ │ +0022b4f0: 6f72 2c20 426f 7374 6f6e 2c20 4d41 2030 or, Boston, MA 0 │ │ │ +0022b500: 3231 3130 2d31 3330 3120 5553 410a 202d 2110-1301 USA. - │ │ │ +0022b510: 2020 0a20 2d20 200a 2d2d 3e0a 3c72 6566 . - .-->.<ref │ │ │ +0022b520: 656e 7472 7920 6964 3d22 666e 5f68 7474 entry id="fn_htt │ │ │ +0022b530: 705f 7572 6c22 3e0a 2020 3c72 6566 6d65 p_url">. <refme │ │ │ +0022b540: 7461 3e0a 2020 2020 3c72 6566 656e 7472 ta>. <refentr │ │ │ +0022b550: 7974 6974 6c65 3e68 7474 705f 7572 6c3c ytitle>http_url< │ │ │ +0022b560: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +0022b570: 2020 2020 3c72 6566 6d69 7363 696e 666f <refmiscinfo │ │ │ +0022b580: 3e77 733c 2f72 6566 6d69 7363 696e 666f >ws</refmiscinfo │ │ │ +0022b590: 3e0a 2020 3c2f 7265 666d 6574 613e 0a20 >. </refmeta>. │ │ │ +0022b5a0: 203c 7265 666e 616d 6564 6976 3e0a 2020 <refnamediv>. │ │ │ +0022b5b0: 2020 3c72 6566 6e61 6d65 3e68 7474 705f <refname>http_ │ │ │ +0022b5c0: 7572 6c3c 2f72 6566 6e61 6d65 3e0a 2020 url</refname>. │ │ │ +0022b5d0: 2020 3c72 6566 7075 7270 6f73 653e 7772 <refpurpose>wr │ │ │ +0022b5e0: 6974 6520 746f 2048 5454 5020 636c 6965 ite to HTTP clie │ │ │ +0022b5f0: 6e74 206f 7220 7374 7269 6e67 206f 7574 nt or string out │ │ │ +0022b600: 7075 7420 7374 7265 616d 2077 6974 6820 put stream with │ │ │ +0022b610: 5552 4c20 6573 6361 7065 733c 2f72 6566 URL escapes</ref │ │ │ +0022b620: 7075 7270 6f73 653e 0a20 203c 2f72 6566 purpose>. </ref │ │ │ +0022b630: 6e61 6d65 6469 763e 0a20 203c 7265 6673 namediv>. <refs │ │ │ +0022b640: 796e 6f70 7369 7364 6976 3e0a 2020 2020 ynopsisdiv>. │ │ │ +0022b650: 3c66 756e 6373 796e 6f70 7369 7320 6964 <funcsynopsis id │ │ │ +0022b660: 3d22 6673 796e 5f68 7474 705f 7572 6c22 ="fsyn_http_url" │ │ │ +0022b670: 3e0a 2020 2020 2020 3c66 756e 6370 726f >. <funcpro │ │ │ +0022b680: 746f 7479 7065 2069 643d 2266 7072 6f74 totype id="fprot │ │ │ +0022b690: 6f5f 6874 7470 5f75 726c 223e 0a20 2020 o_http_url">. │ │ │ +0022b6a0: 2020 2020 203c 6675 6e63 6465 663e 3c66 <funcdef><f │ │ │ +0022b6b0: 756e 6374 696f 6e3e 6874 7470 5f75 726c unction>http_url │ │ │ +0022b6c0: 3c2f 6675 6e63 7469 6f6e 3e3c 2f66 756e </function></fun │ │ │ +0022b6d0: 6364 6566 3e0a 2020 2020 2020 2020 3c70 cdef>. <p │ │ │ +0022b6e0: 6172 616d 6465 663e 696e 203c 7061 7261 aramdef>in <para │ │ │ +0022b6f0: 6d65 7465 723e 7661 6c5f 6578 7072 3c2f meter>val_expr</ │ │ │ +0022b700: 7061 7261 6d65 7465 723e 2061 6e79 3c2f parameter> any</ │ │ │ +0022b710: 7061 7261 6d64 6566 3e0a 2020 2020 2020 paramdef>. │ │ │ +0022b720: 2020 3c70 6172 616d 6465 663e 3c6f 7074 <paramdef><opt │ │ │ +0022b730: 696f 6e61 6c3e 696e 203c 7061 7261 6d65 ional>in <parame │ │ │ +0022b740: 7465 723e 7461 673c 2f70 6172 616d 6574 ter>tag</paramet │ │ │ +0022b750: 6572 3e20 7661 7263 6861 723c 2f6f 7074 er> varchar</opt │ │ │ +0022b760: 696f 6e61 6c3e 3c2f 7061 7261 6d64 6566 ional></paramdef │ │ │ +0022b770: 3e0a 2020 2020 2020 2020 3c70 6172 616d >. <param │ │ │ +0022b780: 6465 663e 3c6f 7074 696f 6e61 6c3e 696e def><optional>in │ │ │ +0022b790: 203c 7061 7261 6d65 7465 723e 7374 7265 <parameter>stre │ │ │ +0022b7a0: 616d 3c2f 7061 7261 6d65 7465 723e 2061 am</parameter> a │ │ │ +0022b7b0: 6e79 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 ny</optional></p │ │ │ +0022b7c0: 6172 616d 6465 663e 0a20 2020 2020 203c aramdef>. < │ │ │ +0022b7d0: 2f66 756e 6370 726f 746f 7479 7065 3e0a /funcprototype>. │ │ │ +0022b7e0: 2020 2020 3c2f 6675 6e63 7379 6e6f 7073 </funcsynops │ │ │ +0022b7f0: 6973 3e0a 2020 3c2f 7265 6673 796e 6f70 is>. </refsynop │ │ │ +0022b800: 7369 7364 6976 3e0a 2020 3c72 6566 7365 sisdiv>. <refse │ │ │ +0022b810: 6374 3120 6964 3d22 6465 7363 5f68 7474 ct1 id="desc_htt │ │ │ +0022b820: 705f 7572 6c22 3e3c 7469 746c 653e 4465 p_url"><title>De │ │ │ +0022b830: 7363 7269 7074 696f 6e3c 2f74 6974 6c65 scription. The │ │ │ +0022b850: 3c66 756e 6374 696f 6e3e 6874 7470 5f75 http_u │ │ │ +0022b860: 726c 3c2f 6675 6e63 7469 6f6e 3e20 6973 rl is │ │ │ +0022b870: 2075 7365 6420 746f 2077 7269 7465 2074 used to write t │ │ │ +0022b880: 6f20 616e 2048 5454 500a 2020 2020 636c o an HTTP. cl │ │ │ +0022b890: 6965 6e74 2028 7768 656e 2069 6e20 6120 ient (when in a │ │ │ +0022b8a0: 5653 5020 636f 6e74 6578 7429 206f 7220 VSP context) or │ │ │ +0022b8b0: 6120 7370 6563 6966 6965 6420 7374 7269 a specified stri │ │ │ +0022b8c0: 6e67 206f 7574 7075 7420 7374 7265 616d ng output stream │ │ │ +0022b8d0: 2e0a 2020 2020 3c66 756e 6374 696f 6e3e .. │ │ │ +0022b8e0: 6874 7470 5f75 726c 3c2f 6675 6e63 7469 http_url uses URL esc │ │ │ +0022b900: 6170 6573 2066 6f72 2073 7065 6369 616c apes for special │ │ │ +0022b910: 0a20 2020 2063 6861 7261 6374 6572 732e . characters. │ │ │ +0022b920: 3c2f 7061 7261 3e0a 2020 3c2f 7265 6673 . . Pa │ │ │ +0022b960: 7261 6d65 7465 7273 3c2f 7469 746c 653e rameters │ │ │ +0022b970: 0a20 2020 203c 7265 6673 6563 7432 3e3c . < │ │ │ +0022b980: 7469 746c 653e 7661 6c5f 6578 7072 3c2f title>val_expr. A value expre │ │ │ +0022b9b0: 7373 696f 6e2e 204d 6179 2062 6520 616e ssion. May be an │ │ │ +0022b9c0: 7920 7363 616c 6172 2065 7870 7265 7373 y scalar express │ │ │ +0022b9d0: 696f 6e2e 2049 660a 2020 2020 2020 3c70 ion. If.

    val_exp │ │ │ +0022b9f0: 723c 2f70 6172 616d 6574 6572 3e20 6973 r is │ │ │ +0022ba00: 2061 6e20 584d 4c20 656e 7469 7479 2c20 an XML entity, │ │ │ +0022ba10: 6120 7365 7269 616c 697a 6174 696f 6e20 a serialization │ │ │ +0022ba20: 6f66 0a20 2020 2020 2074 6865 2065 6e74 of. the ent │ │ │ +0022ba30: 6974 7920 6973 2077 7269 7474 656e 2074 ity is written t │ │ │ +0022ba40: 6f20 7468 6520 3c70 6172 616d 6574 6572 o the stream. This is not │ │ │ +0022ba70: 0a20 2020 2020 2074 6865 2058 4d4c 2061 . the XML a │ │ │ +0022ba80: 7320 6120 7465 7874 2073 7472 696e 672c s a text string, │ │ │ +0022ba90: 2062 7574 2061 2073 6572 6961 6c69 7a61 but a serializa │ │ │ +0022baa0: 7469 6f6e 206f 6620 7468 6520 696e 7465 tion of the inte │ │ │ +0022bab0: 726e 616c 0a20 2020 2020 2072 6570 7265 rnal. repre │ │ │ +0022bac0: 7365 6e74 6174 696f 6e20 6f66 2070 6172 sentation of par │ │ │ +0022bad0: 7365 6420 584d 4c20 6461 7461 2e3c 2f70 sed XML data.

    . . tag</t │ │ │ +0022bb10: 6974 6c65 3e0a 2020 2020 2020 3c70 6172 itle>. <par │ │ │ +0022bb20: 613e 4f70 7469 6f6e 616c 2e20 4966 2070 a>Optional. If p │ │ │ +0022bb30: 7265 7365 6e74 2061 6e64 2069 7320 6120 resent and is a │ │ │ +0022bb40: 7374 7269 6e67 2c20 7468 6520 6f75 7470 string, the outp │ │ │ +0022bb50: 7574 2077 696c 6c20 6265 2065 6e63 6c6f ut will be enclo │ │ │ +0022bb60: 7365 640a 2020 2020 2020 696e 2074 6167 sed. in tag │ │ │ +0022bb70: 7320 6e61 6d65 6420 6279 2074 6865 2073 s named by the s │ │ │ +0022bb80: 7472 696e 6720 636f 6e74 656e 7420 6f66 tring content of │ │ │ +0022bb90: 203c 7061 7261 6d65 7465 723e 7461 673c <parameter>tag< │ │ │ +0022bba0: 2f70 6172 616d 6574 6572 3e2e 0a20 2020 /parameter>.. │ │ │ +0022bbb0: 2020 2049 6620 7468 6520 6578 7072 6573 If the expres │ │ │ +0022bbc0: 7369 6f6e 2065 7661 6c75 6174 6573 2074 sion evaluates t │ │ │ +0022bbd0: 6f20 3020 6f72 206e 756c 6c2c 2069 7420 o 0 or null, it │ │ │ +0022bbe0: 7769 6c6c 2062 6520 6967 6e6f 7265 642e will be ignored. │ │ │ +0022bbf0: 3c2f 7061 7261 3e0a 2020 2020 3c2f 7265 </para>. </re │ │ │ +0022bc00: 6673 6563 7432 3e0a 2020 2020 3c72 6566 fsect2>. <ref │ │ │ +0022bc10: 7365 6374 323e 3c74 6974 6c65 3e73 7472 sect2><title>str │ │ │ +0022bc20: 6561 6d3c 2f74 6974 6c65 3e0a 2020 2020 eam. │ │ │ +0022bc30: 2020 3c70 6172 613e 4f70 7469 6f6e 616c Optional │ │ │ +0022bc40: 2070 6172 616d 6574 6572 2e20 4966 206f parameter. If o │ │ │ +0022bc50: 6d69 7474 6564 206f 7220 6973 2030 2061 mitted or is 0 a │ │ │ +0022bc60: 6e64 2074 6865 2066 756e 6374 696f 6e20 nd the function │ │ │ +0022bc70: 6973 0a20 2020 2020 2065 7865 6375 7465 is. execute │ │ │ +0022bc80: 6420 7769 7468 696e 2056 5350 2063 6f6e d within VSP con │ │ │ +0022bc90: 7465 7874 2c20 7468 6520 3c70 6172 616d text, the val_expr

    will. │ │ │ +0022bcc0: 2020 2020 2062 6520 7772 6974 7465 6e20 be written │ │ │ +0022bcd0: 746f 2074 6865 2048 5454 5020 636c 6965 to the HTTP clie │ │ │ +0022bce0: 6e74 2e20 4966 2070 7265 7365 6e74 2061 nt. If present a │ │ │ +0022bcf0: 6e64 206e 6f6e 2d7a 6572 6f2c 0a20 2020 nd non-zero,. │ │ │ +0022bd00: 2020 203c 7061 7261 6d65 7465 723e 7661 va │ │ │ +0022bd10: 6c5f 6578 7072 3c2f 7061 7261 6d65 7465 l_expr will be writt │ │ │ +0022bd30: 656e 2074 6f20 7468 6520 7370 6563 6966 en to the specif │ │ │ +0022bd40: 6965 6420 7374 7265 616d 2e0a 2020 2020 ied stream.. │ │ │ +0022bd50: 2020 4966 206e 6f6e 2d7a 6572 6f2c 2074 If non-zero, t │ │ │ +0022bd60: 6865 2076 616c 7565 206d 7573 7420 6265 he value must be │ │ │ +0022bd70: 2061 2076 616c 6964 2073 7472 6561 6d20 a valid stream │ │ │ +0022bd80: 6f62 7461 696e 6564 0a20 2020 2020 2066 obtained. f │ │ │ +0022bd90: 726f 6d20 6675 6e63 7469 6f6e 0a20 2020 rom function. │ │ │ +0022bda0: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 st │ │ │ +0022bdd0: 7269 6e67 5f6f 7574 7075 743c 2f66 756e ring_output.
    . │ │ │ +0022be00: 3c2f 7265 6673 6563 7432 3e0a 2020 3c2f
    . . R │ │ │ +0022be40: 6574 7572 6e20 5661 6c75 6573 3c2f 7469 eturn Values</ti │ │ │ +0022be50: 746c 653e 0a20 2020 203c 7061 7261 3e4e tle>. <para>N │ │ │ +0022be60: 6f6e 653c 2f70 6172 613e 0a20 203c 2f72 one</para>. </r │ │ │ +0022be70: 6566 7365 6374 313e 0a20 2020 3c72 6566 efsect1>. <ref │ │ │ +0022be80: 7365 6374 3120 6964 3d22 6572 726f 7273 sect1 id="errors │ │ │ +0022be90: 5f68 7474 705f 7572 6c22 3e3c 7469 746c _http_url"><titl │ │ │ +0022bea0: 653e 4572 726f 7273 3c2f 7469 746c 653e e>Errors │ │ │ +0022beb0: 0a20 2020 203c 7461 626c 653e 3c74 6974 .
    Errors signal │ │ │ +0022bed0: 6c65 6420 6279 203c 6675 6e63 7469 6f6e led by http_url. │ │ │ +0022bf00: 2020 203c 7467 726f 7570 2063 6f6c 733d .... │ │ │ +0022bf20: 203c 726f 773e 0a09 2020 2020 3c65 6e74 .. SQLStateError │ │ │ +0022bf50: 436f 6465 3c2f 656e 7472 793e 3c65 6e74 CodeError TextDesc │ │ │ +0022bf80: 7269 7074 696f 6e3c 2f65 6e74 7279 3e0a ription. │ │ │ +0022bf90: 0920 203c 2f72 6f77 3e0a 093c 2f74 6865 . ...... │ │ │ +0022bfb0: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 .. 370 │ │ │ +0022bfd0: 3030 3c2f 6572 726f 7263 6f64 653e 3c2f 00.. HT │ │ │ +0022c000: 3030 363c 2f65 7272 6f72 636f 6465 3e3c 006< │ │ │ +0022c010: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. h │ │ │ +0022c030: 7474 7020 6f75 7470 7574 2066 756e 6374 ttp output funct │ │ │ +0022c040: 696f 6e20 6f75 7473 6964 6520 6f66 2068 ion outside of h │ │ │ +0022c050: 7474 7020 636f 6e74 6578 740a 0920 2020 ttp context.. │ │ │ +0022c060: 2061 6e64 206e 6f20 7374 7265 616d 2073 and no stream s │ │ │ +0022c070: 7065 6369 6669 6564 3a20 2573 3c2f 6572 pecified: %s │ │ │ +0022c090: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ +0022c0b0: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ +0022c0d0: 3232 3032 333c 2f65 7272 6f72 636f 6465 22023.. < │ │ │ +0022c0f0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>SR066.. │ │ │ +0022c120: 3c65 6e74 7279 3e3c 6572 726f 726e 616d Unsupported ca │ │ │ +0022c140: 7365 2069 6e20 434f 4e56 4552 5420 2825 se in CONVERT (% │ │ │ +0022c150: 7320 2d3e 2056 4152 4348 4152 293c 2f65 s -> VARCHAR).. .. │ │ │ +0022c190: 0a09 3c2f 7462 6f64 793e 0a20 2020 2020 ... │ │ │ +0022c1a0: 203c 2f74 6772 6f75 703e 0a20 2020 203c . < │ │ │ +0022c1b0: 2f74 6162 6c65 3e0a 2020 3c2f 7265 6673 /table>. . │ │ │ +0022c1f0: 4578 616d 706c 6573 3c2f 7469 746c 653e Examples │ │ │ +0022c200: 0a20 2020 203c 6578 616d 706c 6520 6964 . < │ │ │ +0022c220: 7469 746c 653e 4854 5450 206f 7574 7075 title>HTTP outpu │ │ │ +0022c230: 743c 2f74 6974 6c65 3e0a 2020 2020 2020 t. │ │ │ +0022c240: 3c70 6172 613e 4f75 7470 7574 206f 6620 Output of │ │ │ +0022c250: 7661 7269 6f75 7320 666c 6176 6f75 7273 various flavours │ │ │ +0022c260: 206f 6620 3c66 756e 6374 696f 6e3e 6874 of ht │ │ │ +0022c270: 7470 3c2f 6675 6e63 7469 6f6e 3e2e 2053 tp. S │ │ │ +0022c280: 6565 0a09 3c6c 696e 6b20 6c69 6e6b 656e ee..s │ │ │ +0022c2b0: 7472 696e 675f 6f75 7470 7574 3c2f 6675 tring_output.. │ │ │ +0022c2d0: 2061 6e64 0a09 3c6c 696e 6b20 6c69 6e6b and..string_o │ │ │ +0022c310: 7574 7075 745f 7374 7269 6e67 0a09 3c2f utput_string.. │ │ │ +0022c330: 2066 6f72 2065 7861 6d70 6c65 7320 686f for examples ho │ │ │ +0022c340: 7720 746f 2075 7365 2068 7474 7020 746f w to use http to │ │ │ +0022c350: 2077 7269 7465 2074 6f20 7374 7265 616d write to stream │ │ │ +0022c360: 730a 096f 7468 6572 2074 6861 6e20 7468 s..other than th │ │ │ +0022c370: 6520 4854 5450 206f 7574 7075 742e 3c2f e HTTP output.. .http (&apos │ │ │ +0022c3a0: 3b20 2520 266c 743b 6226 6774 3b26 6170 ; % <b>&ap │ │ │ +0022c3b0: 6f73 3b29 2020 2020 2026 6170 6f73 3b20 os;) ' │ │ │ +0022c3c0: 266c 743b 6226 6774 3b0a 6874 7470 5f76 <b>.http_v │ │ │ +0022c3d0: 616c 7565 2028 2661 706f 733b 2025 2026 alue (' % & │ │ │ +0022c3e0: 6c74 3b62 2667 743b 2661 706f 733b 2920 lt;b>') │ │ │ +0022c3f0: 2020 2520 2661 6d70 3b6c 743b 6226 616d % &lt;b&am │ │ │ +0022c400: 703b 6774 3b0a 6874 7470 5f75 726c 2028 p;gt;.http_url ( │ │ │ +0022c410: 2661 706f 733b 2025 2026 6c74 3b62 2667 ' % <b&g │ │ │ +0022c420: 743b 2661 706f 733b 2920 202b 2532 352b t;') +%25+ │ │ │ +0022c430: 266c 743b 6226 6774 3b0a 6874 7470 5f76 <b>.http_v │ │ │ +0022c440: 616c 7565 2028 3132 2c20 2661 706f 733b alue (12, ' │ │ │ +0022c450: 6c69 2661 706f 733b 2920 2026 6c74 3b6c li') <l │ │ │ +0022c460: 6926 6774 3b31 3226 6c74 3b2f 6c69 2667 i>12</li&g │ │ │ +0022c470: 743b 0a3c 2f73 6372 6565 6e3e 0a20 2020 t;.. │ │ │ +0022c480: 203c 2f65 7861 6d70 6c65 3e0a 2020 3c2f . . See Also. . │ │ │ +0022c4e0: 2020 2020 203c 6c69 6e6b 206c 696e 6b65 http,. │ │ │ +0022c520: 2020 2020 203c 6c69 6e6b 206c 696e 6b65 htt │ │ │ +0022c550: 705f 7661 6c75 653c 2f66 756e 6374 696f p_value,. │ │ │ +0022c570: 203c 6c69 6e6b 206c 696e 6b65 6e64 3d22 stri │ │ │ +0022c5a0: 6e67 5f6f 7574 7075 743c 2f66 756e 6374 ng_output,. │ │ │ +0022c5c0: 2020 203c 6c69 6e6b 206c 696e 6b65 6e64 htt │ │ │ +0022c5f0: 705f 7265 7772 6974 653c 2f66 756e 6374 p_rewrite.. │ │ │ +0022c610: 203c 2f70 6172 613e 0a20 203c 2f72 6566 . ........ demo/d │ │ │ +0022c640: 6f63 7372 632f 6675 6e63 7265 662f 706f ocsrc/funcref/po │ │ │ +0022c650: 7033 5f67 6574 2e78 6d6c df00 0026 e33c p3_get.xml...&.< │ │ │ +0022c660: 3f78 6d6c 2076 6572 7369 6f6e 3d22 312e ?xml version="1. │ │ │ +0022c670: 3022 2065 6e63 6f64 696e 673d 2249 534f 0" encoding="ISO │ │ │ +0022c680: 2d38 3835 392d 3122 3f3e 0a3c 212d 2d0a -8859-1"?>... . pop3_get< │ │ │ +0022ca30: 2f72 6566 656e 7472 7974 6974 6c65 3e0a /refentrytitle>. │ │ │ +0022ca40: 2020 2020 3c72 6566 6d69 7363 696e 666f mail. │ │ │ +0022ca70: 0a20 203c 7265 666e 616d 6564 6976 3e0a . . │ │ │ +0022ca80: 2020 2020 3c72 6566 6e61 6d65 3e70 6f70 pop │ │ │ +0022ca90: 335f 6765 743c 2f72 6566 6e61 6d65 3e0a 3_get. │ │ │ +0022caa0: 2020 2020 3c72 6566 7075 7270 6f73 653e │ │ │ +0022cab0: 6765 7420 6d65 7373 6167 6573 2066 726f get messages fro │ │ │ +0022cac0: 6d20 6120 504f 5033 2073 6572 7665 723c m a POP3 server< │ │ │ +0022cad0: 2f72 6566 7075 7270 6f73 653e 0a20 203c /refpurpose>. < │ │ │ +0022cae0: 2f72 6566 6e61 6d65 6469 763e 0a20 203c /refnamediv>. < │ │ │ +0022caf0: 7265 6673 796e 6f70 7369 7364 6976 3e0a refsynopsisdiv>. │ │ │ +0022cb00: 2020 2020 3c66 756e 6373 796e 6f70 7369 . │ │ │ +0022cb50: 0a20 2020 2020 2020 203c 6675 6e63 6465 . array pop3_get. │ │ │ +0022cb90: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +0022cbb0: 686f 7374 3c2f 7061 7261 6d65 7465 723e host │ │ │ +0022cbc0: 2076 6172 6368 6172 3c2f 7061 7261 6d64 varchar. in user varchar. │ │ │ +0022cc20: 3c70 6172 616d 6465 663e 696e 203c 7061 in password │ │ │ +0022cc40: 3c2f 7061 7261 6d65 7465 723e 2076 6172 var │ │ │ +0022cc50: 6368 6172 3c2f 7061 7261 6d64 6566 3e0a char. │ │ │ +0022cc60: 2020 2020 2020 2020 3c70 6172 616d 6465 in │ │ │ +0022cc80: 6275 6666 6572 5f73 697a 653c 2f70 6172 buffer_size integer< │ │ │ +0022cca0: 2f70 6172 616d 6465 663e 0a20 2020 2020 /paramdef>. │ │ │ +0022ccb0: 2020 203c 7061 7261 6d64 6566 3e3c 6f70 in command varchar │ │ │ +0022ccf0: 3c2f 6f70 7469 6f6e 616c 3e3c 2f70 6172 . < │ │ │ +0022cd10: 7061 7261 6d64 6566 3e3c 6f70 7469 6f6e paramdef>. │ │ │ +0022cd70: 2020 3c2f 6675 6e63 7072 6f74 6f74 7970 . . . Description</ti │ │ │ +0022cde0: 746c 653e 0a20 2020 203c 7061 7261 3e3c tle>. <para>< │ │ │ +0022cdf0: 6675 6e63 7469 6f6e 3e50 6f70 335f 6765 function>Pop3_ge │ │ │ +0022ce00: 743c 2f66 756e 6374 696f 6e3e 2069 7320 t</function> is │ │ │ +0022ce10: 7573 6564 2074 6f20 7265 7472 6965 7665 used to retrieve │ │ │ +0022ce20: 2061 6e64 2064 656c 6574 6520 6d65 7373 and delete mess │ │ │ +0022ce30: 6167 6573 2066 726f 6d20 6120 7365 7276 ages from a serv │ │ │ +0022ce40: 6572 0a20 2020 2072 756e 6e69 6e67 2074 er. running t │ │ │ +0022ce50: 6865 2050 6f73 7420 4f66 6669 6365 2050 he Post Office P │ │ │ +0022ce60: 726f 746f 636f 6c20 7665 7273 696f 6e20 rotocol version │ │ │ +0022ce70: 3320 6173 2064 6566 696e 6564 2069 6e20 3 as defined in │ │ │ +0022ce80: 7266 6331 3732 352e 2049 6e20 6974 7320 rfc1725. In its │ │ │ +0022ce90: 6465 6661 756c 7420 666f 726d 2069 740a default form it. │ │ │ +0022cea0: 2020 2020 7265 7475 726e 7320 6120 7665 returns a ve │ │ │ +0022ceb0: 6374 6f72 206f 6620 7665 6374 6f72 7320 ctor of vectors │ │ │ +0022cec0: 636f 6e74 6169 6e69 6e67 206d 6573 7361 containing messa │ │ │ +0022ced0: 6765 7320 7265 7472 6965 7665 6420 6672 ges retrieved fr │ │ │ +0022cee0: 6f6d 2074 6865 2050 4f50 3320 7365 7276 om the POP3 serv │ │ │ +0022cef0: 6572 2e0a 2020 2020 4561 6368 2076 6563 er.. Each vec │ │ │ +0022cf00: 746f 7220 7769 7468 696e 2074 6865 2076 tor within the v │ │ │ +0022cf10: 6563 746f 7220 636f 6e74 6169 6e73 2061 ector contains a │ │ │ +0022cf20: 2070 6169 7220 6f66 203c 7479 7065 3e56 pair of <type>V │ │ │ +0022cf30: 4152 4348 4152 3c2f 7479 7065 3e20 5549 ARCHAR</type> UI │ │ │ +0022cf40: 444c 2061 6e64 0a20 2020 203c 7479 7065 DL and. <type │ │ │ +0022cf50: 3e56 4152 4348 4152 3c2f 7479 7065 3e20 >VARCHAR</type> │ │ │ +0022cf60: 4d65 7373 6167 6520 626f 6479 2c20 692e Message body, i. │ │ │ +0022cf70: 652e 2074 6f20 6765 7420 7468 6520 6d65 e. to get the me │ │ │ +0022cf80: 7373 6167 6520 626f 6479 206f 6620 7468 ssage body of th │ │ │ +0022cf90: 6520 7365 636f 6e64 206d 6573 7361 6765 e second message │ │ │ +0022cfa0: 2072 6574 7269 6576 6564 2c0a 2020 2020 retrieved,. │ │ │ +0022cfb0: 6f6e 6520 776f 756c 6420 7573 6520 3c63 one would use <c │ │ │ +0022cfc0: 6f6d 7075 7465 726f 7574 7075 743e 6172 omputeroutput>ar │ │ │ +0022cfd0: 6566 2028 6172 6566 2028 6d73 675f 7665 ef (aref (msg_ve │ │ │ +0022cfe0: 632c 2031 292c 2031 293c 2f63 6f6d 7075 c, 1), 1)</compu │ │ │ +0022cff0: 7465 726f 7574 7075 743e 2e0a 2020 2020 teroutput>.. │ │ │ +0022d000: 546f 7461 6c20 6c65 6e67 7468 206f 6620 Total length of │ │ │ +0022d010: 6d65 7373 6167 6573 2072 6574 7269 6576 messages retriev │ │ │ +0022d020: 6564 2077 696c 6c20 6e6f 7420 6578 6365 ed will not exce │ │ │ +0022d030: 6564 2074 6865 2076 616c 7565 206f 6620 ed the value of │ │ │ +0022d040: 3c70 6172 616d 6574 6572 3e62 7566 6665 <parameter>buffe │ │ │ +0022d050: 725f 7369 7a65 3c2f 7061 7261 6d65 7465 r_size</paramete │ │ │ +0022d060: 723e 0a20 2020 2070 6172 616d 6574 6572 r>. parameter │ │ │ +0022d070: 2069 6e20 6279 7465 732e 3c2f 7061 7261 in bytes.</para │ │ │ +0022d080: 3e0a 2020 2020 3c70 6172 613e 5468 6520 >. <para>The │ │ │ +0022d090: 6f70 7469 6f6e 616c 2070 6172 616d 6574 optional paramet │ │ │ +0022d0a0: 6572 203c 7061 7261 6d65 7465 723e 636f er <parameter>co │ │ │ +0022d0b0: 6d6d 616e 643c 2f70 6172 616d 6574 6572 mmand</parameter │ │ │ +0022d0c0: 3e20 6361 6e20 6265 2075 7365 6420 746f > can be used to │ │ │ +0022d0d0: 2063 6f6e 7472 6f6c 206f 7574 7075 740a control output. │ │ │ +0022d0e0: 2020 2020 6f72 2064 656c 6574 6520 6d65 or delete me │ │ │ +0022d0f0: 7373 6167 6573 2e20 5768 656e 203c 7061 ssages. When <pa │ │ │ +0022d100: 7261 6d65 7465 723e 636f 6d6d 616e 643c rameter>command< │ │ │ +0022d110: 2f70 6172 616d 6574 6572 3e0a 2020 2020 /parameter>. │ │ │ +0022d120: 6973 2070 6173 7365 6420 6120 3c74 7970 is passed a <typ │ │ │ +0022d130: 653e 5641 5243 4841 523c 2f74 7970 653e e>VARCHAR</type> │ │ │ +0022d140: 2026 6170 6f73 3b75 6964 6c26 6170 6f73 'uidl&apos │ │ │ +0022d150: 3b2c 203c 6675 6e63 7469 6f6e 3e70 6f70 ;, <function>pop │ │ │ +0022d160: 335f 6765 743c 2f66 756e 6374 696f 6e3e 3_get</function> │ │ │ +0022d170: 206f 7574 7075 7473 2073 696e 676c 650a outputs single. │ │ │ +0022d180: 2020 2020 7665 6374 6f72 2063 6f6e 7461 vector conta │ │ │ +0022d190: 696e 696e 6720 3c74 7970 653e 5641 5243 ining <type>VARC │ │ │ +0022d1a0: 4841 523c 2f74 7970 653e 2055 4944 4c73 HAR</type> UIDLs │ │ │ +0022d1b0: 2e20 5468 6520 3c70 6172 616d 6574 6572 . The <parameter │ │ │ +0022d1c0: 3e62 7566 6665 725f 7369 7a65 3c2f 7061 >buffer_size</pa │ │ │ +0022d1d0: 7261 6d65 7465 723e 2063 6f6e 7374 7261 rameter> constra │ │ │ +0022d1e0: 696e 740a 2020 2020 6973 2065 6666 6563 int. is effec │ │ │ +0022d1f0: 7469 7665 2068 6572 652e 2054 6875 732c tive here. Thus, │ │ │ +0022d200: 2074 6865 2076 6563 746f 7220 7769 6c6c the vector will │ │ │ +0022d210: 206f 6e6c 7920 636f 6e74 6169 6e20 5549 only contain UI │ │ │ +0022d220: 444c 7320 6f66 206d 6573 7361 6765 7320 DLs of messages │ │ │ +0022d230: 7768 6f73 6520 746f 7461 6c20 6d65 7373 whose total mess │ │ │ +0022d240: 6167 6520 7465 7874 0a20 2020 206c 656e age text. len │ │ │ +0022d250: 6774 6820 646f 6573 206e 6f74 2065 7863 gth does not exc │ │ │ +0022d260: 6565 6420 3c70 6172 616d 6574 6572 3e62 eed <parameter>b │ │ │ +0022d270: 7566 6665 725f 7369 7a65 3c2f 7061 7261 uffer_size</para │ │ │ +0022d280: 6d65 7465 723e 2062 7974 6573 2e20 5468 meter> bytes. Th │ │ │ +0022d290: 6573 6520 6d65 7373 6167 6520 6c65 6e67 ese message leng │ │ │ +0022d2a0: 7468 7320 6172 650a 2020 2020 6163 6375 ths are. accu │ │ │ +0022d2b0: 6d75 6c61 7465 6420 696e 2074 6865 206f mulated in the o │ │ │ +0022d2c0: 7264 6572 2072 6574 7572 6e65 6420 6279 rder returned by │ │ │ +0022d2d0: 2074 6865 2050 4f50 3320 7365 7276 6572 the POP3 server │ │ │ +0022d2e0: 2e3c 2f70 6172 613e 0a20 2020 203c 7061 .</para>. <pa │ │ │ +0022d2f0: 7261 3e43 6f6d 6d61 6e64 2026 6170 6f73 ra>Command &apos │ │ │ +0022d300: 3b64 656c 6574 6526 6170 6f73 3b20 7769 ;delete' wi │ │ │ +0022d310: 6c6c 2063 6175 7365 2072 6574 7269 6576 ll cause retriev │ │ │ +0022d320: 6564 206d 6573 7361 6765 7320 746f 2062 ed messages to b │ │ │ +0022d330: 6520 6465 6c65 7465 6420 6672 6f6d 2074 e deleted from t │ │ │ +0022d340: 6865 2073 6572 7665 720a 2020 2020 6166 he server. af │ │ │ +0022d350: 7465 7220 7265 7472 6965 7661 6c2e 3c2f ter retrieval.</ │ │ │ +0022d360: 7061 7261 3e0a 2020 3c2f 7265 6673 6563 para>. </refsec │ │ │ +0022d370: 7431 3e0a 2020 3c72 6566 7365 6374 3120 t1>. <refsect1 │ │ │ +0022d380: 6964 3d22 7061 7261 6d73 5f70 6f70 335f id="params_pop3_ │ │ │ +0022d390: 6765 7422 3e3c 7469 746c 653e 5061 7261 get"><title>Para │ │ │ +0022d3a0: 6d65 7465 7273 3c2f 7469 746c 653e 0a20 meters. │ │ │ +0022d3b0: 2020 203c 7265 6673 6563 7432 3e0a 2020 . │ │ │ +0022d3c0: 2020 2020 3c74 6974 6c65 3e68 6f73 743c host< │ │ │ +0022d3d0: 2f74 6974 6c65 3e0a 2020 2020 2020 3c70 /title>. <p │ │ │ +0022d3e0: 6172 613e 5468 6520 686f 7374 2074 6f20 ara>The host to │ │ │ +0022d3f0: 636f 6e6e 6563 7420 7769 7468 2e20 4950 connect with. IP │ │ │ +0022d400: 2061 6464 7265 7373 206f 7220 686f 7374 address or host │ │ │ +0022d410: 6e61 6d65 3a70 6f72 742e 2054 6865 7265 name:port. There │ │ │ +0022d420: 2069 7320 6e6f 2064 6566 6175 6c74 2066 is no default f │ │ │ +0022d430: 6f72 2070 6f72 742c 2073 6f20 746f 2063 or port, so to c │ │ │ +0022d440: 6f6e 6e65 6374 2074 6f20 7468 6520 7374 onnect to the st │ │ │ +0022d450: 616e 6461 7264 2070 6f72 7420 666f 7220 andard port for │ │ │ +0022d460: 504f 5033 2c20 7573 6520 266c 743b 686f POP3, use <ho │ │ │ +0022d470: 7374 6e61 6d65 2f49 5020 6164 6472 6573 stname/IP addres │ │ │ +0022d480: 7326 6774 3b3a 3131 303c 2f70 6172 613e s>:110</para> │ │ │ +0022d490: 0a20 2020 203c 2f72 6566 7365 6374 323e . </refsect2> │ │ │ +0022d4a0: 0a20 2020 203c 7265 6673 6563 7432 3e0a . <refsect2>. │ │ │ +0022d4b0: 2020 2020 2020 3c74 6974 6c65 3e75 7365 <title>use │ │ │ +0022d4c0: 723c 2f74 6974 6c65 3e0a 2020 2020 2020 r. │ │ │ +0022d4d0: 3c70 6172 613e 3c74 7970 653e 7374 7269 stri │ │ │ +0022d4e0: 6e67 3c2f 7479 7065 3e20 7573 6572 2069 ng user i │ │ │ +0022d4f0: 6420 696e 2072 656d 6f74 6520 686f 7374 d in remote host │ │ │ +0022d500: 2e3c 2f70 6172 613e 0a20 2020 203c 2f72 .. . . password. string password i │ │ │ +0022d570: 6e20 7265 6d6f 7465 2068 6f73 742e 3c2f n remote host.. . . buffer_size. integer< │ │ │ +0022d5e0: 2f74 7970 653e 206d 6178 696d 756d 2074 /type> maximum t │ │ │ +0022d5f0: 6f74 616c 206c 656e 6774 6820 6f66 206d otal length of m │ │ │ +0022d600: 6573 7361 6765 2074 6578 7420 666f 720a essage text for. │ │ │ +0022d610: 2020 2020 2020 6d65 7373 6167 6573 2f75 messages/u │ │ │ +0022d620: 6964 6c73 2074 6f20 6265 2072 6574 7269 idls to be retri │ │ │ +0022d630: 6576 6564 2e3c 2f70 6172 613e 0a20 2020 eved.. │ │ │ +0022d640: 203c 2f72 6566 7365 6374 323e 0a20 2020 . │ │ │ +0022d650: 203c 7265 6673 6563 7432 3e0a 2020 2020 . │ │ │ +0022d660: 2020 3c74 6974 6c65 3e63 6f6d 6d61 6e64 command │ │ │ +0022d670: 3c2f 7469 746c 653e 0a20 2020 2020 203c . < │ │ │ +0022d680: 7061 7261 3e43 6f6d 6d61 6e64 203c 7479 para>Command string │ │ │ +0022d6a0: 2e20 5661 6c69 6420 7661 6c75 6573 2061 . Valid values a │ │ │ +0022d6b0: 7265 2065 6d70 7479 2c20 2661 706f 733b re empty, ' │ │ │ +0022d6c0: 7569 646c 2661 706f 733b 0a20 2020 2020 uidl'. │ │ │ +0022d6d0: 206f 7220 2661 706f 733b 6465 6c65 7465 or 'delete │ │ │ +0022d6e0: 2661 706f 733b 3c2f 7061 7261 3e0a 2020 '. │ │ │ +0022d6f0: 2020 3c2f 7265 6673 6563 7432 3e0a 2020 . │ │ │ +0022d700: 2020 3c72 6566 7365 6374 323e 0a20 2020 . │ │ │ +0022d710: 2020 203c 7469 746c 653e 6578 636c 7564 exclud │ │ │ +0022d720: 655f 7569 646c 5f6c 6973 743c 2f74 6974 e_uidl_list</tit │ │ │ +0022d730: 6c65 3e0a 2020 2020 2020 3c70 6172 613e le>. <para> │ │ │ +0022d740: 4120 3c74 7970 653e 7665 6374 6f72 3c2f A <type>vector</ │ │ │ +0022d750: 7479 7065 3e20 636f 6e74 6169 6e69 6e67 type> containing │ │ │ +0022d760: 2055 4944 4c73 2e20 4120 6d65 7373 6167 UIDLs. A messag │ │ │ +0022d770: 6520 7768 6f73 6520 5549 444c 2061 7070 e whose UIDL app │ │ │ +0022d780: 6561 7273 2069 6e20 7468 6973 0a20 2020 ears in this. │ │ │ +0022d790: 2020 206c 6973 7420 7769 6c6c 206e 6f74 list will not │ │ │ +0022d7a0: 2062 6520 7265 7472 6965 7665 6420 6f72 be retrieved or │ │ │ +0022d7b0: 2064 656c 6574 6564 2e3c 2f70 6172 613e deleted.</para> │ │ │ +0022d7c0: 0a20 2020 203c 2f72 6566 7365 6374 323e . </refsect2> │ │ │ +0022d7d0: 0a20 203c 2f72 6566 7365 6374 313e 0a20 . </refsect1>. │ │ │ +0022d7e0: 203c 7265 6673 6563 7431 2069 643d 2272 <refsect1 id="r │ │ │ +0022d7f0: 6574 223e 3c74 6974 6c65 3e52 6574 7572 et"><title>Retur │ │ │ +0022d800: 6e20 5479 7065 733c 2f74 6974 6c65 3e0a n Types. │ │ │ +0022d810: 2020 2020 3c70 6172 613e 4120 7665 6374 A vect │ │ │ +0022d820: 6f72 206f 6620 7665 6374 6f72 7320 636f or of vectors co │ │ │ +0022d830: 6e74 6169 6e69 6e67 2055 4944 4c2f 4d65 ntaining UIDL/Me │ │ │ +0022d840: 7373 6167 6520 7465 7874 203c 7479 7065 ssage text strings │ │ │ +0022d860: 6f72 0a20 2020 2020 6120 2661 706f 733b or. a ' │ │ │ +0022d870: 666c 6174 2661 706f 733b 2076 6563 746f flat' vecto │ │ │ +0022d880: 7220 636f 6e74 6169 6e69 6e67 2055 4944 r containing UID │ │ │ +0022d890: 4c20 3c74 7970 653e 7374 7269 6e67 733c L strings< │ │ │ +0022d8a0: 2f74 7970 653e 2e3c 2f70 6172 613e 0a20 /type>.. │ │ │ +0022d8b0: 203c 2f72 6566 7365 6374 313e 0a20 203c . < │ │ │ +0022d8c0: 7265 6673 6563 7431 2069 643d 2265 7272 refsect1 id="err │ │ │ +0022d8d0: 6f72 735f 706f 7033 5f67 6574 223e 3c74 ors_pop3_get">Errors.
    < │ │ │ +0022d900: 7469 746c 653e 4572 726f 7273 2073 6967 title>Errors sig │ │ │ +0022d910: 6e61 6c6c 6564 2062 793c 2f74 6974 6c65 nalled by. . │ │ │ +0022d940: 203c 7468 6561 643e 3c72 6f77 3e3c 656e SQLStateError │ │ │ +0022d970: 2043 6f64 653c 2f65 6e74 7279 3e3c 656e CodeError TextDes │ │ │ +0022d9a0: 6372 6970 7469 6f6e 3c2f 656e 7472 793e cription │ │ │ +0022d9b0: 3c2f 726f 773e 3c2f 7468 6561 643e 0a09 .. │ │ │ +0022d9c0: 3c74 626f 6479 3e0a 0920 203c 726f 773e .. │ │ │ +0022d9d0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. 2E000.. PO001.. < │ │ │ +0022da40: 6572 726f 726e 616d 653e 4361 6e6e 6f74 errorname>Cannot │ │ │ +0022da50: 2072 6573 6f6c 7665 2068 6f73 7420 696e resolve host in │ │ │ +0022da60: 2070 6f70 335f 6765 743c 2f65 7272 6f72 pop3_get.. │ │ │ +0022da80: 2020 203c 656e 7472 793e 3c2f 656e 7472 .. .. │ │ │ +0022daa0: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 .. 080 │ │ │ +0022dac0: 3031 3c2f 6572 726f 7263 6f64 653e 3c2f 01.. PO │ │ │ +0022daf0: 3030 323c 2f65 7272 6f72 636f 6465 3e3c 002< │ │ │ +0022db00: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. C │ │ │ +0022db20: 616e 6e6f 7420 636f 6e6e 6563 7420 696e annot connect in │ │ │ +0022db30: 2070 6f70 335f 6765 743c 2f65 7272 6f72 pop3_get.. │ │ │ +0022db50: 2020 203c 656e 7472 793e 3c2f 656e 7472 .. .. │ │ │ +0022db70: 3c72 6f77 3e0a 0920 2020 203c 656e 7472 .. 080 │ │ │ +0022db90: 3036 3c2f 6572 726f 7263 6f64 653e 3c2f 06.. PO │ │ │ +0022dbc0: 3030 333c 2f65 7272 6f72 636f 6465 3e3c 003< │ │ │ +0022dbd0: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. N │ │ │ +0022dbf0: 6f20 7265 7370 6f6e 7365 2066 726f 6d20 o response from │ │ │ +0022dc00: 7265 6d6f 7465 2050 4f50 3320 7365 7276 remote POP3 serv │ │ │ +0022dc10: 6572 3c2f 6572 726f 726e 616d 653e 3c2f er.. .. < │ │ │ +0022dc40: 2f72 6f77 3e0a 0920 203c 726f 773e 0a09 /row>.. .. │ │ │ +0022dc50: 2020 2020 3c65 6e74 7279 3e3c 6572 726f 08006. │ │ │ +0022dc80: 0920 2020 203c 656e 7472 793e 3c65 7272 . PO004 │ │ │ +0022dcb0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. Not vali │ │ │ +0022dcd0: 6420 7573 6572 2069 6e20 7265 6d6f 7465 d user in remote │ │ │ +0022dce0: 2050 4f50 3320 7365 7276 6572 3c2f 6572 POP3 server │ │ │ +0022dd00: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ +0022dd20: 0920 203c 726f 773e 0a09 2020 2020 3c65 . .. │ │ │ +0022dd40: 3038 3030 363c 2f65 7272 6f72 636f 6465 08006.. < │ │ │ +0022dd60: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>PO005.. │ │ │ +0022dd90: 3c65 6e74 7279 3e3c 6572 726f 726e 616d UIDL command t │ │ │ +0022ddb0: 6f20 7265 6d6f 7465 2050 4f50 3320 7365 o remote POP3 se │ │ │ +0022ddc0: 7276 6572 2066 6169 6c65 643c 2f65 7272 rver failed. │ │ │ +0022dde0: 0920 2020 203c 656e 7472 793e 3c2f 656e . .. .. │ │ │ +0022de00: 2020 3c72 6f77 3e0a 0920 2020 203c 656e .. 0 │ │ │ +0022de20: 3830 3036 3c2f 6572 726f 7263 6f64 653e 8006 │ │ │ +0022de30: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 .. │ │ │ +0022de50: 504f 3030 363c 2f65 7272 6f72 636f 6465 PO006.. < │ │ │ +0022de70: 656e 7472 793e 3c65 7272 6f72 6e61 6d65 entry>Could not get o │ │ │ +0022de90: 7574 7075 7420 6f66 2055 4944 4c20 6672 utput of UIDL fr │ │ │ +0022dea0: 6f6d 2072 656d 6f74 6520 504f 5033 2073 om remote POP3 s │ │ │ +0022deb0: 6572 7665 722e 3c2f 6572 726f 726e 616d erver... │ │ │ +0022ded0: 3c65 6e74 7279 3e3c 2f65 6e74 7279 3e0a . │ │ │ +0022dee0: 0920 203c 2f72 6f77 3e0a 0920 203c 726f . .. .. < │ │ │ +0022df00: 6572 726f 7263 6f64 653e 3038 3030 363c errorcode>08006< │ │ │ +0022df10: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode>.. │ │ │ +0022df30: 3c65 7272 6f72 636f 6465 3e50 4f30 3037 PO007 │ │ │ +0022df40: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. LIST │ │ │ +0022df70: 2063 6f6d 6d61 6e64 2074 6f20 7265 6d6f command to remo │ │ │ +0022df80: 7465 2050 4f50 3320 7365 7276 6572 2066 te POP3 server f │ │ │ +0022df90: 6169 6c65 642e 3c2f 6572 726f 726e 616d ailed... │ │ │ +0022dfb0: 3c65 6e74 7279 3e3c 2f65 6e74 7279 3e0a . │ │ │ +0022dfc0: 0920 203c 2f72 6f77 3e0a 0920 203c 726f . .. .. < │ │ │ +0022dfe0: 6572 726f 7263 6f64 653e 3038 3030 363c errorcode>08006< │ │ │ +0022dff0: 2f65 7272 6f72 636f 6465 3e3c 2f65 6e74 /errorcode>.. │ │ │ +0022e010: 3c65 7272 6f72 636f 6465 3e50 4f30 3038 PO008 │ │ │ +0022e020: 3c2f 6572 726f 7263 6f64 653e 3c2f 656e .. Coul │ │ │ +0022e050: 6420 6e6f 7420 6765 7420 6f75 7470 7574 d not get output │ │ │ +0022e060: 206f 6620 4c49 5354 2066 726f 6d20 7265 of LIST from re │ │ │ +0022e070: 6d6f 7465 2050 4f50 3320 7365 7276 6572 mote POP3 server │ │ │ +0022e080: 2e3c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 ... .. .. .. │ │ │ +0022e0c0: 2020 203c 656e 7472 793e 3c65 7272 6f72 .. < │ │ │ +0022e0f0: 656e 7472 793e 3c65 7272 6f72 636f 6465 entry>PO009.. │ │ │ +0022e120: 3c65 6e74 7279 3e3c 6572 726f 726e 616d .. .. < │ │ │ +0022e160: 2f72 6f77 3e0a 0920 203c 726f 773e 0a09 /row>.. .. │ │ │ +0022e170: 2020 2020 3c65 6e74 7279 3e3c 6572 726f 08006. │ │ │ +0022e1a0: 0920 2020 203c 656e 7472 793e 3c65 7272 . PO010 │ │ │ +0022e1d0: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. Failed r │ │ │ +0022e1f0: 6561 6469 6e67 206f 7574 7075 7420 6f66 eading output of │ │ │ +0022e200: 204c 4953 5420 636f 6d6d 616e 6420 6f6e LIST command on │ │ │ +0022e210: 2072 656d 6f74 6520 504f 5033 2073 6572 remote POP3 ser │ │ │ +0022e220: 7665 723c 2f65 7272 6f72 6e61 6d65 3e3c ver< │ │ │ +0022e230: 2f65 6e74 7279 3e0a 0920 2020 203c 656e /entry>.. .. │ │ │ +0022e250: 3c2f 726f 773e 0a09 2020 3c72 6f77 3e0a .. . │ │ │ +0022e260: 0920 2020 203c 656e 7472 793e 3c65 7272 . 08006 │ │ │ +0022e290: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. PO011.. Could n │ │ │ +0022e2e0: 6f74 2044 454c 4520 6d65 7373 6167 6573 ot DELE messages │ │ │ +0022e2f0: 2066 726f 6d20 7265 6d6f 7465 2050 4f50 from remote POP │ │ │ +0022e300: 3320 7365 7276 6572 3c2f 6572 726f 726e 3 server.. │ │ │ +0022e320: 2020 3c65 6e74 7279 3e3c 2f65 6e74 7279 .. .. < │ │ │ +0022e340: 726f 773e 0a09 2020 2020 3c65 6e74 7279 row>.. 0800 │ │ │ +0022e360: 363c 2f65 7272 6f72 636f 6465 3e3c 2f65 6.. PO0 │ │ │ +0022e390: 3132 3c2f 6572 726f 7263 6f64 653e 3c2f 12.. Co │ │ │ +0022e3c0: 756c 6420 6e6f 7420 5155 4954 2066 726f uld not QUIT fro │ │ │ +0022e3d0: 6d20 7265 6d6f 7465 2050 4f50 3320 7365 m remote POP3 se │ │ │ +0022e3e0: 7276 6572 3c2f 6572 726f 726e 616d 653e rver │ │ │ +0022e3f0: 3c2f 656e 7472 793e 0a09 2020 2020 3c65 .. .. │ │ │ +0022e410: 203c 2f72 6f77 3e0a 0920 203c 726f 773e .. │ │ │ +0022e420: 0a09 2020 2020 3c65 6e74 7279 3e3c 6572 .. 08000.. PO013.. < │ │ │ +0022e490: 6572 726f 726e 616d 653e 4172 6775 6d65 errorname>Argume │ │ │ +0022e4a0: 6e74 2036 2074 6f20 706f 7033 5f67 6574 nt 6 to pop3_get │ │ │ +0022e4b0: 206d 7573 7420 6265 2061 2076 6563 746f must be a vecto │ │ │ +0022e4c0: 723c 2f65 7272 6f72 6e61 6d65 3e3c 2f65 r.. .. .. .. │ │ │ +0022e500: 2020 203c 656e 7472 793e 3c65 7272 6f72 08006.. │ │ │ +0022e530: 2020 2020 3c65 6e74 7279 3e3c 6572 726f PO014. │ │ │ +0022e560: 0920 2020 203c 656e 7472 793e 3c65 7272 . Misc. err │ │ │ +0022e580: 6f72 2069 6e20 636f 6e6e 6563 7469 6f6e or in connection │ │ │ +0022e590: 2069 6e20 706f 7033 5f67 6574 3c2f 6572 in pop3_get │ │ │ +0022e5b0: 0a09 2020 2020 3c65 6e74 7279 3e3c 2f65 .. .. . │ │ │ +0022e5d0: 093c 2f74 626f 6479 3e0a 2020 2020 2020 .. │ │ │ +0022e5e0: 3c2f 7467 726f 7570 3e0a 2020 2020 3c2f . . . E │ │ │ +0022e630: 7861 6d70 6c65 733c 2f74 6974 6c65 3e0a xamples. │ │ │ +0022e640: 2020 2020 3c65 7861 6d70 6c65 2069 643d │ │ │ +0022e660: 3c74 6974 6c65 3e47 6574 206d 6573 7361 Get messa │ │ │ +0022e670: 6765 7320 6672 6f6d 2072 656d 6f74 6520 ges from remote │ │ │ +0022e680: 504f 5033 3c2f 7469 746c 653e 0a20 2020 POP3. │ │ │ +0022e690: 2020 203c 7061 7261 3e54 6869 7320 6578 This ex │ │ │ +0022e6a0: 616d 706c 6520 7265 7472 6965 7665 7320 ample retrieves │ │ │ +0022e6b0: 6d65 7373 6167 6573 2066 726f 6d20 6120 messages from a │ │ │ +0022e6c0: 7265 6d6f 7465 2050 4f50 3320 7365 7276 remote POP3 serv │ │ │ +0022e6d0: 6572 2061 6e64 2073 746f 7265 7320 7468 er and stores th │ │ │ +0022e6e0: 656d 2069 6e20 6120 7461 626c 652e 3c2f em in a table.