summaryrefslogtreecommitdiff
path: root/doc/misc_functions.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/misc_functions.rst')
-rw-r--r--doc/misc_functions.rst35
1 files changed, 35 insertions, 0 deletions
diff --git a/doc/misc_functions.rst b/doc/misc_functions.rst
new file mode 100644
index 0000000..0f1bdaf
--- /dev/null
+++ b/doc/misc_functions.rst
@@ -0,0 +1,35 @@
+=======================
+Miscellaneous functions
+=======================
+
+.. code-block:: c
+
+ #include <libHX/misc.h>
+
+ int HX_ffs(unsigned long z);
+ int HX_fls(unsigned long z);
+ void HX_hexdump(FILE *fp, const void *ptr, unsigned int len);
+
+ void HX_zvecfree(char **);
+ unsigned int HX_zveclen(const char *const *);
+
+``HX_ffs``
+ Finds the first (lowest-significant) bit in a value and returns its
+ position, or ``-1`` to indicate failure.
+
+``HX_fls``
+ Finds the last (most-significant) bit in a value and returns its
+ position, or ``-1`` to indicate failure.
+
+``HX_hexdump``
+ Outputs a nice pretty-printed hex and ASCII dump to the filedescriptor
+ ``fp``. ``ptr`` is the memory area, of which ``len`` bytes will be
+ dumped.
+
+``HX_zvecfree``
+ Frees the supplied Z-vector array. (Frees all array elements from the
+ first element to (excluding) the first ``NULL`` element.)
+
+``HX_zveclen``
+ Counts the number of array elements until the first ``NULL`` array
+ element is seen, and returns this number.