to_string


Description:

public string to_string (uint maxlen)

Converts all the non printable characters of bin->data into the "\xyz" representation where "xyz" is the octal representation of the byte, and the '\' (backslash) character is converted to "\\".

Printable characters (defined by isprint) as well as newline character are not converted.

Note that the backslash and newline characters are considered as printable characters and will not be represented by the "\xyz" representation.

Use this function to get a representation as much readable by humans as possible of a binary chunk. Note that this function is internally called when transforming a binary value to a string for example when using transform or value_stringify.

Parameters:

this

a correctly filled GdaBinary structure

maxlen

a maximum len used to truncate, or typeof ( unichar2)0 for no maximum length

Returns:

a new string from this