The ToLower—Multibyte Character method

This method converts the multibyte characters in from to lowercase.

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

The nfrombytes parameter specifies the number of bytes to copy.

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.

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