Syntax

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

Pascal Syntax

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

Parameters

s1

(OUT) Points to the destination string.

s2

(IN) Points to the source string.

Return Values

Returns a pointer to the s1 parameter plus the return value of unilen( s2).

Remarks

unipcpy copies the string pointed to by the s2 parameter to the destination string pointed to by the s1 parameter and stops after moving the terminating NULL character.

unipcpy has no corresponding C function.

unipcpy is identical to the unicpy function except for the return value.

unipcpy returns a pointer to the NULL terminating character of the resulting destination string. This pointer can be used in subsequent calling unipcpy to concatenate a series of strings without having to scan the entire string each time.

For sample code, see Section 3.22, Example: unipcpy.

See Also

unicpy, unincpy