The ToUpper—Multibyte Character method

This method converts the multibyte characters in from to uppercase. If the characters in from have no uppercase equivalent, they are copied unchanged.

unsigned short ToUpper(char *to, 
               const char *from, 
               unsigned short &nfrombytes, 
               int nbytes = ITLocale::ScanNoLimit)const

This method returns in the nfrombytes parameter the number of bytes read from the location pointed to by from. You must pass the address of an unsigned short for this parameter.

The nbytes parameter specifies the length of the multibyte characters in from. You can provide an integer to specify the number of bytes, in which case this method reads up to this many bytes from from when trying to form a complete character. Or you can set nbytes to ITLocale::ScanNoLimit (the default), in which case this method reads as many bytes as necessary to form a complete character.

This method returns the number of bytes actually copied to the buffer pointed to by to.

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