1 files changed, 52 insertions, 0 deletions
diff --git a/libj2_fls_j2u.3 b/libj2_fls_j2u.3
new file mode 100644
index 0000000..9b63423
--- /dev/null
+++ b/libj2_fls_j2u.3
@@ -0,0 +1,52 @@
+.TH LIBJ2_FLS_J2U 3 LIBJ2
+.SH NAME
+libj2_fls_j2u \- Find last set bit
+
+.SH SYNOPSIS
+.nf
+#include <libj2.h>
+
+unsigned \fBlibj2_fls_j2u\fP(const struct libj2_j2u *\fIa\fP);
+.fi
+.PP
+Link with
+.IR -lj2 .
+
+.SH DESCRIPTION
+The
+.BR libj2_fls_j2u ()
+function returns the index of the most
+significant set bit in
+.IR a ,
+where the index is counted from 1,
+and from the the least significant bit.
+.PP
+In the case that no bit in
+.I a
+is set, 0 is returned.
+.PP
+.I a
+is assumed to be
+.RI non- NULL .
+
+.SH RETURN VALUE
+The
+.BR libj2_fls_j2u ()
+function returns the one-based index of
+the last set bit in
+.IR a ,
+or 0 if no bit is set.
+
+.SH ERRORS
+The
+.BR libj2_fls_j2u ()
+function cannot fail.
+
+.SH SEE ALSO
+.BR libj2 (7),
+.BR libj2_flc_j2u (3),
+.BR libj2_ffs_j2u (3),
+.BR libj2_clz_j2u (3),
+.BR libj2_kls_j2u (3),
+.BR libj2_cls_j2u (3),
+.BR libj2_slc_j2u (3)