Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ bstring(3) — sys5 — Apollo Domain/IX SR9.5

Media Vault

Software Library

Restoration Projects

Artifacts Sought



BSTRING(3)               DOMAIN/IX SYS5                BSTRING(3)



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

USAGE
     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 string b2.

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

     Bzero places length zero bytes in the string b1.

     Ffs returns the index of the first bit set in its argument.
     A zero return indicates a zero argument.  Bits are numbered
     starting at 1.

NOTES
     The bcmp and bcopy routines take parameters in reverse order
     from strcmp and strcpy.  For example,

       strcpy (foo, bar)

     copies foo to bar, while

       bcpy (foo, bar, 3)

     copies bar to foo.





Printed 12/4/86                                         BSTRING-1





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