_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); |
See Also