Novell Documentation: NLM & NetWare Libraries for C - Case, Collation, and Normalization Conversion

2.5 Case, Collation, and Normalization Conversion

The following sections explain how to convert the case of the Unicode string:

If you have not already done so, call NWUSStandardUnicodeInit.
Supply a buffer of sufficient length to receive the lower or upper case Unicode string.
Call NWUSUnicodeToLowerCase or NWUSUnicodeToUpperCase for the actual conversion.
- For the lowerCaseOutput or upperCaseOutput parameter, pass a pointer to the output buffer.
- For the outputBufferLen parameter, pass a pointer to the length of the output buffer.
- For the unicodeInput parameter, pass a pointer to the Unicode string input buffer.
After all standard Unicode conversion operations are completed, call NWUSStandardUnicodeRelease.

If you have not already done so, call NWUXLoadCaseConverter to initialize the converter and obtain a converter handle.

NOTE:You must specify the case to which the converter is to convert in the caseFlag parameter of NWUXLoadCaseConverter. If an initialized converter is not set to the desired case, initialize another case converter. It is possible to have multiple converters, each set to a different option (upper case, lower case, title case).
Supply a buffer of sufficient size to hold the output monocased Unicode string. In some languages, changing the case of a string may change the string length.
Call NWUXUnicodeToCase with the following parameter stipulations:
- For the caseHandle parameter, pass the handle returned from appropriate call to NWUXLoadCaseConverter.
- For the monocaseOutput parameter, pass the address of the output buffer for the Unicode monocase string.
- For the outputBufferLen parameter, pass the length of the output buffer.
- For the unicodeInput parameter, pass a pointer to the input string buffer.
Use the monocased output string as needed.
When the converter is no longer needed, call NWUXUnloadConverter, passing the handle returned when the converter was loaded.