MJSulib C functions for utility programs

• Overview
• The command-line, and what to do with it...
• String Utilities
• Portable Hashing
• Formatted Notice Messages
• Programmer-Friendly Memory Allocation
• Byte-Order Conversion
• Bitmaps
• Patterm-Matching

Note: manpages that fall into several categories are listed in all categories that apply.

Overview

mjsu

the MJSulib API

The command-line, and what to do with it...

getflags

collect flag arguments from command-line

usage

print formatted usage message and exit

whatami

return the name of the calling process

String Utilities

cpystr

copy multiple strings

strtos

convert numeric string to short integer, with range-checking

str_dup

duplicate a string onto the heap

vec_buy

create or extend a vector of strings

vec_dup

duplicate a vector of strings

vec_free

deallocate a vector of strings

Portable Hashing

rtw_short_hash, rtw_long_hash, rtw_longlong_hash, strhash

compute integer hash value of a sequence of bytes

Formatted Notice Messages

error,  verror

display formatted error notification and exit

remark,  vremark

display formatted informational notification

usage

display formatted usage notification and exit

warning,  vwarning

display formatted warning notification

notifier

install callback function to display notification-messages

Programmer-Friendly Memory Allocation

mem_buy

(re)allocate storage space on the heap, optionally failing hard

mem_free

deallocate storage space on the heap, returning a sentinel

str_dup

duplicate a string onto the heap

vec_buy

create or extend a vector of strings

vec_dup

duplicate a vector of strings

vec_free

deallocate a vector of strings

Byte-Order Conversion

lstol

convert 32-bit quantum from LSB-first into native byte-order

lstos

convert 16-bit quantum from LSB-first into native byte-order

ltols

convert 32-bit quantum from native into LSB-first byte-order

stols

convert 16-bit quantum from native into LSB-first byte-order

Bitmaps

mbm

format of MBITMAP files and structures

mbm_bits,  mbm_clr,  mbm_clrb,  mbm_rev,  mbm_revb,  mbm_set,  mbm_setb,  mbm_tstb

bitmap manipulations

mbm_load

load a bitmap from a file

mbm_mem,  mbm_buy,  mbm_free

allocate or deallocate bitmaps on the heap

mbm_save

save a bitmap into a file

mbm_size,  mbm_height,  mbm_width

return the height or width of a bitmap

Pattern-Matching

amatch

look for anchored match of regular expression

match

match a regular expression

pattern

build a regular expression pattern