Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (s) strncat64(3)

NAME

strncat64 - Appends bytes to a string

LIBRARY

H-series and J-series native Guardian processes: implicit libraries

H-series and J-series OSS processes: implicit libraries

SYNOPSIS

#include <string.h>

char _ptr64 *strncat64(

char _ptr64 *s1,

const char _ptr64 *s2,

unsigned long long n);

PARAMETERS

s1 Points to a location containing ﬁrst string.

s2 Points to a location containing the second of two strings referenced.

n Speciﬁes the maximum number of bytes in a string to append.

DESCRIPTION

The strncat64() function appends n bytes in the string pointed to by the s2 parameter to the end

of the string pointed to by the s1 parameter. The initial byte of the string pointed to by s2

overwrites the null character at the end of the string pointed to by s1. The strncat64() function

appends at most the number of bytes speciﬁed by the value of the n parameter minus 1. It then

appends a null byte to the result, and returns s1.

NOTES

When operating on overlapping strings, the behavior of this function is unreliable.

RETURN VALUES

Upon successful completion, the strncat64() function returns a pointer to the resulting string.

Otherwise, this function returns a null pointer.

RELATED INFORMATION

Functions: strcat64(3), strcmp64(3), strcpy64(3), strncmp64(3), strncpy64(3).

527192-018 Hewlett-Packard Company 6−107