The MNConcatenate method

This method appends one or more multibyte characters in the from multibyte string to the end of the multibyte string to. If from and to overlap, the results of this method are undefined.

int MNConcatenate(char *to, const char *from, int limit, 
            int ntobytes = ITLocale::ScanToNul, 
            int nfrombytes = ITLocale::ScanToNul) const

Use limit to specify the maximum number of characters to read from the from string.

The ntobytes and nfrombytes parameters specify the length of the to and from strings. You can provide an integer to specify the number of bytes in the corresponding string. Or you can use the constant ITLocale::ScanToNul (the default) to specify that the corresponding string is null-terminated.

This method returns the number of bytes in the resulting string.

If there is an error, the method returns -1. Call ITLocale::GetError() to retrieve a specific error message.