bstring(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | NOTES | ATTRIBUTES | SEE ALSO

NAME

bstring, bcopy, bcmp, bzero, ffs- bit and byte string operations

SYNOPSIS

#include <string.h>

void bcopy(const void * b1, void * b2, size_t length);
int bcmp(const void * b1, const void * b2, size_t length);
void bzero(void * b, size_t length);
int ffs(int value);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The bcopy() , bcmp() , and bzero() functions operate on variable length strings of bytes. They do not check for null bytes as the routines in string (3STDC) do.

The bcopy() function copies length bytes from string b1 to the string b2 . Overlapping strings are handled correctly.

The bcmp() function compares byte string b1 to byte string b2 , returning 0 if they are identical, non-zero otherwise. Both strings are assumed to be length bytes long. A bcmp() zero bytes long always returns 0.

The bzero() function places a length of 0 bytes in the string b .

The ffs() function finds the first bit set in value and returns the index of that bit. Bits are numbered starting at 1 from the right. A return of zero indicates that the value passed is zero.

NOTES

The bcmp() and bcopy() routines take parameters backwards from strcmp() and strcpy() .

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

string(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | NOTES | ATTRIBUTES | SEE ALSO