1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
libHX is a C library (with some C++ bindings available) that provides data
structures and functions commonly needed, such as maps, deques, linked lists,
string formatting and autoresizing, option and config file parsing, type
checking casts and more.
libHX aids in quickly writing up C and C++ data processing programs, by
consolidating tasks that often happen to be open-coded, such as (simple) config
file reading, option parsing, directory traversal, and others, into a library.
The focus is on reducing the amount of time (and secondarily, the amount of
code) a developer has to spend for otherwise implementing such.
Components (by all means not all)
• Documentation (see doc/libHX_Documentation.pdf)
• maps/sets (HXmap_*)
Originally created to provide a data structure like Perl's associative
arrays. Multiple models and underlying storage data structures are
available (unordered hash-based map, ordered rbtree).
• linked lists (HXdeque_*, HXlist_*, HXclist_*)
Doubly-linked lists are suitable for both providing stack and queue
functionality. Different implementations are available for use, depending
on situation.
• directory handling (HXdir_*)
HXdir provides for opendir-readdir-closedir semantics. Windows uses a
different kind, so it had to be naturally covered up. On the other hand,
Solaris's readdir() implementation is nasty in terms of memory management.
HXdir covers up these discrepancies and provides a sane Linux-style
readdir.
Convenience functions mkdir (create all missing parents), rrmdir (rm -Rf)
are also available.
• string formatter with placeholders (HXformat_*)
HXformat is something in the direction of printf(), but the argument list
is not implemented by means of varargs, so is flexible even beyond compile
time. You can change the format string — in fact, just let the user
configuration provide it — without having to worry about argument
evaluation problems. Positional and optional arguments are simply freely
choosable.
• memory containers, auto-sizing string ops (HXmc_*)
At the cost of slightly increased number memory allocations as you work
with the buffers, the hmc collection of functions provide scripting-level
semantics for strings. Appending to a string is simply hmc_strcat(&s,
"123") [cf. $s .= "123"], without having to worry about overflowing a
buffer.
• option parsing (HXoption_*)
Put blunt, libpopt failed to do some elementary things and there was no
maintainer to fix it. Well, it's packaged with rpm which already diverged
in all distros.
HXoption is table- and callback-based, much like popt.
• shellconfig parser (HXshconfig_*)
Parsers shconfig files. Their format is a subset of shell code. Files in /
etc/sysconfig are commonly shconfig-style.
• common string operations
basename, chomp, dirname, getl(ine), split, strlower/-upper, str*trim,
strsep, strsep2, etc.
This page was last modified: 2011-01-15 16:41 UTC libHX.sf.net
# Generated using `w3m -dump libhx.sf.net` and slightly editing it.
|
