annotate th_util.h @ 19:bbb243eba688

Cosmetics.
author Matti Hamalainen <ccr@tnsp.org>
date Wed, 20 Apr 2011 14:57:42 +0300
parents c0d5c825894a
children a4f894105953
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
1 /*
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
2 * Generic utility-functions, macros and defaults
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3 * Programmed and designed by Matti 'ccr' Hamalainen
16
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
4 * (C) Copyright 2002-2010 Tecnic Software productions (TNSP)
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
5 *
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
6 * Please read file 'COPYING' for information on license and distribution.
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
7 */
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
8 #ifndef _TH_UTIL_H
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
9 #define _TH_UTIL_H
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
10
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
11 #ifdef __cplusplus
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
12 extern "C" {
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
13 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
14
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
15 #include "th_types.h"
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
16 #include <stdarg.h>
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
17 #include <stdlib.h>
16
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
18 #include <sys/types.h>
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
19 #ifndef HAVE_NO_ASSERT
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
20 #include <assert.h>
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
21 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
22
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
23 #ifdef HAVE_STRING_H
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
24 #include <string.h>
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
25 #define HAVE_MEMSET 1
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
26 #else
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
27 #ifdef HAVE_STRINGS_H
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
28 #include <strings.h>
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
29 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
30 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
31
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
32 #ifdef HAVE_MEMORY_H
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
33 #include <memory.h>
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
34 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
35
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
36
4
67f4a4233372 Move defaults to header file.
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
37 #ifdef TH_NO_DEFAULTS
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
38 #define TH_PROG_AUTHOR NULL
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
39 #define TH_PROG_LICENSE NULL
4
67f4a4233372 Move defaults to header file.
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
40 #else
18
c0d5c825894a Update copyright year.
Matti Hamalainen <ccr@tnsp.org>
parents: 16
diff changeset
41 #define TH_PROG_AUTHOR "By Matti 'ccr' Hämäläinen (C) Copyright 2011 TNSP"
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
42 #define TH_PROG_LICENSE "This software is licensed under GNU GPL version 2"
4
67f4a4233372 Move defaults to header file.
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
43 #endif
67f4a4233372 Move defaults to header file.
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
44
67f4a4233372 Move defaults to header file.
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
45
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
46 /* Replacement for assert() */
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
47 #ifdef HAVE_NO_ASSERT
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
48 # ifdef NDEBUG
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
49 # define assert(NEXPR) /* stub */
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
50 # else
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
51 # define assert(NEXPR) do { if (!(NEXPR)) { fprintf(stderr, "[%s:%d] assert(" # NEXPR ") failed!\n", __FILE__, __LINE__); abort(); } } while (0)
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
52 # endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
53 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
54
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
55 /* Global variables
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
56 */
19
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
57 extern int th_verbosityLevel;
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
58 extern char *th_prog_name,
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
59 *th_prog_fullname,
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
60 *th_prog_version,
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
61 *th_prog_author,
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
62 *th_prog_license;
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
63
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
64 /* Functions
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
65 */
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
66 void th_init(char *progName, char *progFullName, char *progVersion,
19
bbb243eba688 Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
67 char *progAuthor, char *progLicense);
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
68 void THERR(const char *, ...);
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
69 void THMSG(int, const char *, ...);
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
70 void THPRINT(int, const char *, ...);
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
71
11
e467b3586e4d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 10
diff changeset
72 void THERR_V(const char *, va_list);
e467b3586e4d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 10
diff changeset
73 void THMSG_V(int, const char *, va_list);
e467b3586e4d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 10
diff changeset
74 void THPRINT_V(int, const char *, va_list);
e467b3586e4d Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 10
diff changeset
75
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
76 void *th_malloc(size_t);
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
77 void *th_calloc(size_t, size_t);
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
78 void *th_realloc(void *, size_t);
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
79 void th_free(void *);
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
80
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
81 #ifdef HAVE_MEMSET
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
82 #define th_memset memset
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
83 #else
6
2f92373537b5 Indentation cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 4
diff changeset
84 void *th_memset(void *, int, size_t);
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
85 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
86
16
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
87
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
88 /* Doubly linked list handling
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
89 */
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
90 typedef struct _qlist_t {
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
91 void *data;
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
92 size_t num;
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
93 struct _qlist_t *prev, *next;
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
94 } qlist_t;
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
95
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
96
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
97 qlist_t * th_llist_new(void *data);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
98 void th_llist_free(qlist_t *list);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
99 void th_llist_free_func(qlist_t *list, void (*freefunc)(void *data));
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
100
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
101 qlist_t * th_llist_append(qlist_t **list, void *data);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
102 qlist_t * th_llist_prepend(qlist_t **list, void *data);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
103 void th_llist_delete(qlist_t **list, const void *data);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
104 void th_llist_delete_node(qlist_t **list, qlist_t *node);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
105
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
106 qlist_t * th_llist_get_nth(qlist_t *list, const size_t n);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
107 size_t th_llist_length(const qlist_t *list);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
108 ssize_t th_llist_position(const qlist_t *list, const qlist_t *node);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
109
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
110 qlist_t * th_llist_find(qlist_t *list, const void *data);
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
111 qlist_t * th_llist_find_func(qlist_t *list, const void *userdata, int (compare)(const void *, const void *));
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
112
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
113
0
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
114 #ifdef __cplusplus
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
115 }
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
116 #endif
bd61a80a6c54 Initial import into Mercurial repository. Discarding old cvs/svn history
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
117 #endif /* _TH_UTIL_H */