_CP_iconv is equivalent to the result = iconv(string1, string2) BASIC statement.
Syntax
int _CP_iconv(CPSTR** result, CPSTR* string1, CPSTR* string2)
Description
This function returns -1 if
an error occurs. The error code is contained in _CP_errno.
Note: This function is provided for convenience only. It requires
considerable amounts of CPU, as it must parse the format string (string2) at run time (which is also true of the UNIX printf() function). Unless contact with the D3 environment
is absolutely required for the conversion, it is suggested that users
write their own formatting routines to address their specific requirements
in a more efficient manner.
Example(s)
/* Prints "a". */
CPSTR * s = _CP_mkstr("a2");
CPSTR * t = _CP_mkstr("mca");
_CP_iconv(&s,s,t);
_CP_print(s);