The MConcatenate method

This method appends multibyte character string s2 to the end of multibyte character string s1. If the two strings overlap, the results are undefined.

int MConcatenate(char *s1, const char *s2, 
   int nbytes1 = ITLocale::ScanToNul, 
   int nbytes2 = ITLocale::ScanToNul) const

The nbytes1 and nbytes2 parameters specify the length of the s1 and s2 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 length in bytes of the resulting concatenated string, not including the null terminator if there is one.

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