NWstrncpy(3nw)


NWstrncpy -- copies locale-sensitive string for characters (not bytes)

Synopsis

   #include <time.h> or #define NWL_EXCLUDE_TIME 
   #include <stdio.h> or #define NWL_EXCLUDE_FILE 
   #include <nwlocale.h> 
   

char NWFAR *NWAPI NWstrncpy (char NWFAR *target_string, char NWFAR *source_string, int numChars);

Description

The parameters are as follows:

target_string
(OUT) Points to the string to which to copy.

source_string
(IN) Points to the string to be copied.

numChars
(IN) Specifies the number of characters to copy.

Return values

NULL
target string and/or source string is NULL.

Non-NULL
Pointer to target string.

Notices

NWstrncpy is similar to the ANSI standard strncpy.

To guarantee a null-terminated string, set

   numChars = length of target_string-1, 
and set
   last element of target_string = 0. 

Services

Internationalization

NCP calls

None

References

NWLsetlocale(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.