ICELIB0.NLM   →   ICE_ConvertBinaryToASCII()

ICE_ConvertBinaryToASCII

Description:

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

Syntax for C:

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

Syntax for Assembly:

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

Parameters:

value

(IN) Points to the binary value to be converted.
 

binaryBytes

(IN) Size, in bytes, of binary value to convert from.  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:

1 = Insert comma separators.
 

Returns:

Pointer to buffer (created by malloc()) that holds the ASCIIZ string.

0 = No buffer created
 

Remarks:

At this point in time, negative values and declimal points are not supported.
 

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

Resource files:

icelib0.imp