Syntax

   #include <unicode.h> 
    
   N_EXTERN_LIBRARY(nint) NWUnicodeToMonocase ( 
      nptr                   ruleHandle,  
      punicode               dest,  
      nuint32                maxLen,  
      const unicode N_FAR   *src,  
      pnuint32               len);
   

Pascal Syntax

   uses netwin32 
    
   Function NWUnicodeToMonocase 
     (ruleHandle : nptr;              
      dest : punicode;          
      maxLen  : size_t;           
      src : punicode;        
      len : psize_t         
   ) : nint;
   

Parameters

ruleHandle

(IN) Points to the rule table handle for unicode-to-monocase conversion.

dest

(OUT) Points to the buffer for the resulting monocase Unicode string.

maxLen

(IN) Specifies the maximum number of Unicode characters in the dest parameter, including the NULL terminator.

src

(IN) Points to the buffer with source Unicode.

len

(OUT) Points to the number of characters copied to the dest parameter including the NULL terminator.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

NWUnicodeToMonocase converts a Unicode string having a mixture of upper/lower case characters to a Unicode string consistently having only one case, according to the monocase rule table.

For Windows 95, NWUnicodeToMonocase is limited to a 256-character string.

For sample code, see Section 3.5, Example: NWGetUnicodeToMonocaseHandle.

See Also

NWGetMonocaseHandle