NWLstrbcpy(3nw)


NWLstrbcpy -- copies a locale-sensitive string for a specified number of bytes (not characters)

Synopsis

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

char NWFAR *NWAPI NWstrbcpy (char NWFAR *target_string, char NWFAR *source_string, int numBytes);

Description

The parameters are as follows:

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

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

numBytes
(IN) Specifies the number of bytes to copy including the NULL terminator.

Return values

NULL
target string and/or source string is NULL

Non-NULL
Pointer to target string

Notices

NWLstrbcpy is similar to the ANSI standard strncpy.

NWLstrbcpy is similar to NWstrncpy, except it copies a specified number of BYTES, not characters.

NWLstrbcpy null terminates the result string, so a maximum of n-1 bytes will be copied.

Services

Internationalization

NCP calls

None

References

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