ICELIB0.NLM → ICE_ConvertASCIIToBinary()

ICE_ConvertASCIIToBinary

Description:

Converts an ASCIIZ value to a binary value of any number of bits.

Syntax for C:

void *ICE_ConvertASCIIToBinary (
char *value,
unsigned int binaryBytes,
unsigned int flags
);

Syntax for Assembly:

Call ICE_ConvertASCIIToBinary C, offset value, [binaryBytes], [flags]

Parameters:

value: (IN) Points to the null-terminated string containing the numeric value to be converted.
binaryBytes: (IN) Size, in bytes, of binary value to convert to. To determine the number of bytes needed, divide the number of bits by eight and round up to the next integer (eight bits per byte). This value is limited by the amount of available memory.
flags: (IN) Some rules to be enforced during conversion. All undocumented bit flags are considered reserved for future use, and should remain cleared (0) to ensure upward compatibility with newer versions of ICELIB0.NLM. Currently supported flags are as follows:
No flags present.

Returns:

Pointer to buffer (created by malloc()) that holds the binary value.

0 = No buffer created

Remarks:

At this point in time, negative values and decimal points are not supported. Values that are too large for the destination data type won't appear to convert correctly.

Remember to use NetWare's free() function when you no longer need the string.

Resource files:

icelib0.imp