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

memchr64(3) Guardian Native C Library Calls Reference Manual

NAME

memchr64 - Finds a character byte in memory

LIBRARY

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

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

SYNOPSIS

#include <string.h>

void _ptr64 *memchr64(

const void _ptr64 *s,

int c,

unsigned long long n);

PARAMETERS

s Points to the location of a string.

c Speciﬁes a byte for which to search.

n Speciﬁes the number of bytes to search.

DESCRIPTION

The memchr64() function operates on strings in memory areas. A memory area is a group of

contiguous bytes bound by a count and not terminated by a null character.

The memchr64() function sequentially searches the string at the location pointed to by the s

parameter until one of the following occurs:

• The byte speciﬁed by the c parameter, which is converted to an unsigned char,is

encountered.

• The number of bytes speciﬁed by the n parameter have been copied to the string at loca-

tion s.

RETURN VALUES

The memchr64() function returns a pointer to byte c in the string pointed to by s. When byte c

is not encountered after n bytes have been copied to the string at location s, a null pointer is

returned.

RELATED INFORMATION

Functions: memcmp64(3), memcpy64(3), memmove64(3), memset64(3), strcat64(3).

4−98 Hewlett-Packard Company 527192-018