uninset

Copies a given character into the first specified number of characters of a string

Local Servers:nonblocking
Remote Servers:N/A
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows95, Windows 98
Library:Cross-Platform Localization (LOC*.*)
Service:Unicode

Syntax

   #include <unicode.h> 
    
   N_EXTERN_LIBRARY(punicode) uninset  ( 
      punicode   s,  
      unicode    c,  
      size_t     n);
   

Pascal Syntax

   uses netwin32 
    
   Function uninset 
     (s : punicode;           
      c : unicode;        
      n : size_t              
   ) : punicode;
   

Parameters

s
(OUT) Points to the string to modify.
c
(IN) Specifies the fill character.
n
(IN) Specifies the maximum number of characters (not bytes).

Return Values

Returns a pointer to the s parameter.

Remarks

uninset copies the character specified by the c parameter into the first number of characters specified by the n parameter of the string pointed to by the s parameter. If the number specified by the n parameter is greater than the return value of unilen( s), the return value of strlen( s) replaces the n parameter.

uninset stops after (1) setting the number of characters specified by the n parameter, or (2) finding a NULL character.

uninset corresponds to the C memset function.

For sample code, see Section 3.21, Example: uninset.

See Also

uniset