Syntax

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

Pascal Syntax

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

Parameters

upperCaseOutput

(OUT) Points to the output buffer to receive the resulting upper 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 NWUSUnicodeToUpperCase to determine the size of the string before it is converted by setting the upperCaseOutput 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 esuniup.c for sample code.