unicat

Appends a copy of a specified string to the end of another 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) unicat  ( 
      punicode               s1,  
      const unicode N_FAR   *s2);
   

Pascal Syntax

   uses netwin32 
    
   Function unicat 
     (s1 : punicode;         
      s2 : const unicode          
   ) : punicode;
   

Parameters

s1
(OUT) Points to the original string.
s2
(IN) Points to the string to be appended.

Return Values

Pointer to concatenated s1.

Remarks

unicat corresponds to the C strcat function.

The length of the resulting string is:

   unilen (s1) + unilen (s2)
   

For sample code, see Section 3.11, Example: unicat.

See Also

unincat