Return to bstring.3 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/bstring.3, revision 1.1.1.1

1.1       root        1: .TH BSTRING 3  "4 March 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: bcopy, bcmp, bzero, ffs \- bit and byte string operations
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B bcopy(b1, b2, length)
                      8: .B char *b1, *b2;
                      9: .B int length;
                     10: .PP
                     11: .B bcmp(b1, b2, length)
                     12: .B char *b1, *b2;
                     13: .B int length;
                     14: .PP
                     15: .B bzero(b, length)
                     16: .B char *b;
                     17: .B int length;
                     18: .PP
                     19: .B ffs(i)
                     20: .B int i;
                     21: .fi
                     22: .SH DESCRIPTION
                     23: The functions
                     24: .IR bcopy ,
                     25: .IR bcmp ,
                     26: and
                     27: .I bzero
                     28: operate on variable length strings of bytes.
                     29: They do not check for null bytes as the routines in
                     30: .IR string (3)
                     31: do.
                     32: .PP
                     33: .I Bcopy
                     34: copies 
                     35: .I length
                     36: bytes from string
                     37: .I b1
                     38: to the string
                     39: .IR b2 .
                     40: .PP
                     41: .I Bcmp
                     42: compares byte string
                     43: .I b1
                     44: against byte string
                     45: .IR b2 ,
                     46: returning zero if they are identical,
                     47: non-zero otherwise.  Both strings are
                     48: assumed to be
                     49: .I length
                     50: bytes long.
                     51: .PP
                     52: .I Bzero
                     53: places
                     54: .I length
                     55: 0 bytes in the string
                     56: .IR b1 .
                     57: .PP
                     58: .I Ffs
                     59: find the first bit set in the argument passed it and
                     60: returns the index of that bit.  Bits are numbered
                     61: starting at 1.  A return value of \-1 indicates the
                     62: value passed is zero.
                     63: .SH BUGS
                     64: The
                     65: .I bcmp
                     66: and 
                     67: .I bcopy
                     68: routines take parameters backwards from
                     69: .I strcmp
                     70: and
                     71: .IR strcpy .

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.