Syntax

   #include <unicode.h> 
    
   N_EXTERN_LIBRARY(punicode) unincat  ( 
      punicode              s1,  
      const unicode N_FAR  *s2,  
      size_t                n);
   

Pascal Syntax

   uses netwin32 
    
   Function unincat 
     (s1 : punicode;         
      s2 : const unicode;        
      n  : size_t        
   ) : punicode;
   

Parameters

s1

(OUT) Points to the original string.

s2

(IN) Points to the string to be appended.

n

(IN) Specifies the maximum number of characters to be appended.

Return Values

Pointer to s1.

Remarks

unincat copies at most n characters of s2 to the end of s1, then appends a null character. The maximum length of the resulting string is:

   unilen(s1)+ n
   

unincat corresponds to the C strncat function.

For sample code, see Section 3.18, Example: unincat.

See Also

unicat