4.3BSD-Tahoe/usr/man/cat3/bstring.0

BSTRING(3)	    UNIX Programmer's Manual	       BSTRING(3)



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

SSYYNNOOPPSSIISS
     bbccooppyy((ssrrcc,, ddsstt,, lleennggtthh))
     cchhaarr **ssrrcc,, **ddsstt;;
     iinntt lleennggtthh;;

     bbccmmpp((bb11,, bb22,, lleennggtthh))
     cchhaarr **bb11,, **bb22;;
     iinntt lleennggtthh;;

     bbzzeerroo((bb,, lleennggtthh))
     cchhaarr **bb;;
     iinntt lleennggtthh;;

     ffffss((ii))
     iinntt ii;;

DDEESSCCRRIIPPTTIIOONN
     The functions _b_c_o_p_y, _b_c_m_p, and _b_z_e_r_o operate on variable
     length strings of bytes.  They do not check for null bytes
     as the routines in _s_t_r_i_n_g(3) do.

     _B_c_o_p_y copies _l_e_n_g_t_h bytes from string _s_r_c to the string _d_s_t.

     _B_c_m_p compares byte string _b_1 against byte string _b_2, return-
     ing zero if they are identical, non-zero otherwise.  Both
     strings are assumed to be _l_e_n_g_t_h bytes long.  BBccmmpp of _l_e_n_g_t_h
     zero bytes always returns zero.

     _B_z_e_r_o places _l_e_n_g_t_h 0 bytes in the string _b_1.

     _F_f_s 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 0 indicates the
     value passed is zero.

BBUUGGSS
     The _b_c_o_p_y routine take parameters backwards from _s_t_r_c_p_y.















Printed 7/9/88		November 18, 1987			1