Syntax

   #include <nunicode.h> 
    
   N_EXTERN_LIBRARY(nint) NWUSUnicodeToLowerCase ( 
      punicode               lowerCaseOutput,  
      nuint                  outputBufferLen,  
      const unicode N_FAR   *unicodeInput,  
      pnuint                 actualLength);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUSUnicodeToLowerCase 
     (lowerCaseOutput : punicode;
     outputBufferLen : nuint;
     unicodeInput : const unicode;
     actualLength : pnuint              
   ): nint;
   

Parameters

lowerCaseOutput

(OUT) Points to the output buffer to receive the resulting lower case string (optional).

outputBufferLen

(IN) Specifies the maximum size of the output buffer in Unicode characters.

unicodeInput

(IN) Points to the input buffer containing the Unicode string to convert.

actualLength

(OUT) Points to the returned length (in Unicode characters) of the converted string (optional). Does not include the NULL terminator.

Return Values

Remarks

Lower case conversions are preferred for most operations since there are more lower case characters than upper case characters in the Unicode environment.

Call NWUSUnicodeToLowerCase to determine the size of the string before it is converted by setting the lowerCaseOutput parameter to NULL. The outputBufferLen parameter will be ignored, a converted string will not be returned, and the length of the string if it were converted will be returned in the actualLength parameter.

See esunilow.c for sample code.