unincpy(3nw)

unincpy -- copies specified number of characters from one string to another

Synopsis

   #include <unicode.h> 
    
   unicode N_FAR N_API unincpy 
     (unicode N_FAR    s1, 
      unicode N_FAR    s2, 
      size_t            n);

Description

The parameters are as follows:

s1: (OUT) Points to the destination string.
s2: (IN) Points to the source string.
n: (IN) Specifies the maximum length in characters (not bytes).

Return values

Pointer to s1.

Notices

unincpy copies up to n characters from s2 to s1, truncating or null-padding s1. The target s1 might not be null-terminated if the length of s2 is n or more.

unincpy corresponds to C strncpy.

Services

Unicode

NCP calls

None

References

unicpy(3nw), unipcpy(3nw)