Handling of program parameters

In addition to transcoding routines the library also provides an operating system independent method for retrieving program parameters (namely argc and argv of the main function of the C program) encoded as UTF-8. The procedure requires the main program to be named XNLS_MAIN and the argv parameter to be of type XNLSargv. The function XNLSconvargv can then be called to get the converted arguments. The following example shows how to organise the main function of a program using this feature:

int XNLS_MAIN(int argc,XNLSargv sargv[])
{
 char **argv;

 argv=XNLSconvargv(&argc,sargv);   /* 'argv' is encoded in UTF-8 */

 /* Insert here the body of the function using 'argc' and 'argv' as usual */

 XNLSfreeargv(argv);
 return 0;
}