Index

PowerDoc Objects

Standard Format Identifiers

PD_BYTE_SIGNED — a string converted to a single signed byte

Operating Range:
-128 to 127
Valid Examples:
"80",  "-50",  "0",  "100",  "-100"
Invalid Examples:
"-500",  "130",  "3.8",  "0.002",  "5E4"

PD_ARR_BYTE_SIGNED — a string converted to an array of signed bytes

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
-128 to 127 for each array element
Valid Examples:
"20, 40, 60, 80",  "-10 -20 -30 0 50 80 90"
Invalid Examples:
"-500, 130, 3.8",  "0.00 5E4 -2"

PD_BYTE_UNSIGNED — a string converted to a single unsigned byte

Operating Range:
0 to 255
Valid Examples:
"120",  "50",  "0",  "100"
Invalid Examples:
"-2",  "350",  "3.8",  "0.002",  "5E4"

PD_ARR_BYTE_UNSIGNED — a string converted to an array of unsigned bytes

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
0 to 255 for each array element
Valid Examples:
"20, 40, 160, 220",  "100 200 250 180"
Invalid Examples:
"0 -20 0 520 50 280 -90",  "0.00 5E4 -2"

PD_WORD_SIGNED — a string converted to a signed 2-byte integer

Operating Range:
-32,768 to 32,767
Valid Examples:
"1000",  "-30150",  "0",  "-100"
Invalid Examples:
"-40000",  "40000",  "3.8",  "0.002",  "5E4"

PD_ARR_WORD_SIGNED — a string converted to an array of signed 2-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
-32,768 to 32,767 for each array element
Valid Examples:
"0, 600, 25000, -30000, -50 31000",  "-200 20000"
Invalid Examples:
"0 60000 2e2 -0.6",  "33000, -33000"

PD_WORD_UNSIGNED — a string converted to an unsigned 2-byte integer

Operating Range:
0 to 65,535
Valid Examples:
"20000",  "50",  "0",  "100"
Invalid Examples:
"-50",  "150000",  "3.8",  "0.002",  "5E4"

PD_ARR_WORD_UNSIGNED — a string converted to an array of unsigned 2-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
0 to 65,535 for each array element
Valid Examples:
"1, 2, 3",  "50000 60000 120 5000"
Invalid Examples:
"-1, -2, -3, -4",  "0.5 -2E2 70000"

PD_TRIO_SIGNED — a string converted to a signed 3-byte integer

Operating Range:
-8,388,608 to 8,388,607
Valid Examples:
"10000",  "-300800",  "0",  "-100"
Invalid Examples:
"-9000000",  "9000000",  "3.8",  "0.002",  "5E4"

PD_ARR_TRIO_SIGNED — a string converted to an array of signed 3-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
-8,388,608 to 8,388,607 for each array element
Valid Examples:
"0, 600, 25000, -30000, -50 31000",  "-200 20000"
Invalid Examples:
"0 15000000 2e2 -0.6",  "9000000, -9000000"

PD_TRIO_UNSIGNED — a string converted to an unsigned 3-byte integer

Operating Range:
0 to 16,777,216
Valid Examples:
"14000000",  "50",  "0",  "100"
Invalid Examples:
"-50",  "17000000",  "3.8",  "0.002",  "5E4"

PD_ARR_TRIO_UNSIGNED — a string converted to an array of unsigned 3-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
0 to 16,777,216 for each array element
Valid Examples:
"1, 2, 3",  "50000 60000 120 5000"
Invalid Examples:
"-1, -2, -3, -4",  "0.5 -2E2 17000000"

PD_LONG_SIGNED — a string converted to a signed 4-byte integer

Operating Range:
-2,147,483,648 to 2,147,483,647
Valid Examples:
"1555000",  "-4110000",  "0",  "-100"
Invalid Examples:
"-5000000000",  "3000000000",  "3.8",  "0.002",  "5E4"

PD_ARR_LONG_SIGNED — a string converted to an array of signed 4-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
-2,147,483,648 to 2,147,483,647 for each array element
Valid Examples:
"-1500400200, 2000000000, 80",  "0 0 0 0 0"
Invalid Examples:
"2147483648, 0",  "0.001 -3.2 5E7 2000"

PD_LONG_UNSIGNED — a string converted to an unsigned 4-byte integer

Operating Range:
0 to 4,294,967,295
Valid Examples:
"120",  "50",  "0",  "4000000000"
Invalid Examples:
"-50",  "5000000000",  "3.8",  "0.002",  "5E4"

PD_ARR_LONG_UNSIGNED — a string converted to an array of unsigned 4-byte integers

Individual elements of the array should be seprated by a single comma and/or space character.

Operating Range:
0 to 4,294,967,295 for each array element
Valid Examples:
"500, 4294967295, 0",  "100 100 100 100 100 100 100 100 100"
Invalid Examples:
"-1, -2, -3",  "0.2 abc 8123222100",  "500, 4294967296, 0"

PD_ASC — a string of ASCII characters converted to an array of bytes

Valid Examples:
"test",  "1e345fg6",  "x y z",  "- / $ \ +"

PD_HEX — a string of 2-digit HEX values converted to an array of bytes.
(when applicable, the expected length of the array will be indicated)

Although PD_HEX is a general purpose format, it is used as the default storage format only for properties whose value strings cannot be conveniently represented in any other way (for example: bitmap's pixels or other binary data).

Valid Examples:
"23A4E8",  "23 A4 E8",  "23 a4 e8",  "F2 e5 14 C4 e8"
Invalid Examples:
"23 A4 E",  "12mk34",  "-50 e8",  "a2.05"

PD_DEFAULT — a string converted to the property's default storage format.

Depending on the property in question, this can be any of the above format identifiers.

Note: When PD_DEFAULT is used, the property's value string will be stored in the property's default storage format. This is particularly useful in PowerDoc For ASP because the format identifier is an optional parameter that can be omitted. In such cases, PD_DEFAULT is used by default. This means that ASP applications do not have to specify the property's identifier at all. ASP applications should only ensure that the property's value string is correctly supplied and does not exceed the operating range.

 

Index