Loading...
string/ffs.3 Libc-262 Libc-594.9.4
--- Libc/Libc-262/string/ffs.3
+++ Libc/Libc-594.9.4/string/ffs.3
@@ -32,29 +32,50 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)ffs.3	8.2 (Berkeley) 4/19/94
-.\" $FreeBSD: src/lib/libc/string/ffs.3,v 1.5 2001/10/01 16:09:00 ru Exp $
+.\" $FreeBSD: src/lib/libc/string/ffs.3,v 1.9 2004/06/30 20:09:09 ru Exp $
 .\"
-.Dd April 19, 1994
+.Dd January 13, 2004
 .Dt FFS 3
 .Os
 .Sh NAME
-.Nm ffs
-.Nd find first bit set in a bit string
+.Nm ffs ,
+.Nm ffsl ,
+.Nm fls ,
+.Nm flsl
+.Nd find first or last bit set in a bit string
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In string.h
+.In strings.h
 .Ft int
-.Fn ffs "int value"
+.Fn ffs "int i"
+.Ft int
+.Fn ffsl "long i"
+.Ft int
+.Fn fls "int i"
+.Ft int
+.Fn flsl "long i"
 .Sh DESCRIPTION
 The
 .Fn ffs
-function finds the first bit set in
-.Fa value
-and returns the index of that bit.
+and
+.Fn ffsl
+functions find the first bit set in
+.Fa i
+and return the index of that bit.
+.Pp
+The
+.Fn fls
+and
+.Fn flsl
+functions find the last bit set in
+.Fa i
+and return the index of that bit.
+.Pp
 Bits are numbered starting from 1, starting at the right-most
-bit.
-A return value of 0 means that the argument was zero.
+(least significant) bit.
+A return value of zero from any of these functions means that the
+argument was zero.
 .Sh SEE ALSO
 .Xr bitstring 3
 .Sh HISTORY
@@ -62,3 +83,18 @@
 .Fn ffs
 function appeared in
 .Bx 4.3 .
+Its prototype existed previously in
+.In string.h
+before it was moved to
+.In strings.h
+for
+.St -p1003.1-2001
+compliance.
+.Pp
+The
+.Fn ffsl ,
+.Fn fls ,
+and
+.Fn flsl
+functions appeared in
+.Fx 5.3 .