Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

BSTRING(3)  —  C LIBRARY FUNCTIONS

NAME

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

SYNOPSIS

bcopy(b1, b2, length)
char ∗b1, ∗b2;
int length;

bcmp(b1, b2, length)
char ∗b1, ∗b2;
int length;

bzero(b, length)
char ∗b;
int length;

ffs(i)
int i;

DESCRIPTION

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

Bcopy copies length bytes from string b1 to the string b2. Overlapping strings are handled correctly.

Bcmp compares byte string b1 against byte string b2, returning zero if they are identical, non-zero otherwise.  Both strings are assumed to be length bytes long. 

Bzero places length 0 bytes in the string b.

Ffs finds the first bit set in the argument passed it and returns the index of that bit.  Bits are numbered starting at 1 from the right.  A return value of zero indicates that the value passed is zero. 

CAVEAT

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

Sun Release 3.4  —  Last change: 7 November 1984

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026