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.