Annotation of 43BSDTahoe/man/man3/bstring.3, revision 1.1.1.1

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

unix.superglobalmegacorp.com

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