Value-Data.xml 1.2 KB

1234567891011121314151617181920212223242526272829303132
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
  4. <sect1 id="DATA">
  5. <title>DATA<indexterm>
  6. <primary>DATA</primary>
  7. </indexterm><indexterm>
  8. <primary>DATA value type</primary>
  9. </indexterm></title>
  10. <para><emphasis role="bold">DATA[</emphasis><emphasis>n</emphasis><emphasis
  11. role="bold">]</emphasis></para>
  12. <para>A "packed hexadecimal<indexterm>
  13. <primary>packed hexadecimal</primary>
  14. </indexterm>" data block of <emphasis>n</emphasis> bytes, zero padded (not
  15. space-padded). If <emphasis>n </emphasis>is omitted, the DATA is variable
  16. length to the size needed to contain the result of the cast or passed
  17. parameter. Type casting is allowed but only to a STRING or UNICODE of the
  18. same number of bytes.</para>
  19. <para>This type is particularly useful for containing BLOB (Binary Large
  20. OBject) data. See the Programmer's Guide article <emphasis
  21. role="bold">Working with BLOBs</emphasis> for more information on this
  22. subject.</para>
  23. <para>Example:</para>
  24. <programlisting>DATA8 MyHexString := x'1234567890ABCDEF';
  25. // an 8-byte data block - hex values 12 34 56 78 90 AB CD EF</programlisting>
  26. </sect1>