1 /*************************************************************************
2  *
3  * $Id$
4  *
5  * Copyright (C) 2001 Bjorn Reese and Daniel Stenberg.
6  *
7  * Permission to use, copy, modify, and distribute this software for any
8  * purpose with or without fee is hereby granted, provided that the above
9  * copyright notice and this permission notice appear in all copies.
10  *
11  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
12  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
13  * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
14  * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
15  *
16  ************************************************************************/
17 
18 #ifndef TRIO_TRIOSTR_H
19 #define TRIO_TRIOSTR_H
20 
21 #include <assert.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <time.h>
25 #include "triodef.h"
26 #include "triop.h"
27 
28 enum {
29   TRIO_HASH_NONE = 0,
30   TRIO_HASH_PLAIN,
31   TRIO_HASH_TWOSIGNED
32 };
33 
34 #if !defined(TRIO_STRING_PUBLIC)
35 # if !defined(TRIO_PUBLIC)
36 #  define TRIO_PUBLIC
37 # endif
38 # define TRIO_STRING_PUBLIC TRIO_PUBLIC
39 #endif
40 
41 /*************************************************************************
42  * String functions
43  */
44 
45 TRIO_STRING_PUBLIC int trio_copy_max TRIO_PROTO((char *target, size_t max, const char *source));
46 TRIO_STRING_PUBLIC char *trio_create TRIO_PROTO((size_t size));
47 TRIO_STRING_PUBLIC void trio_destroy TRIO_PROTO((char *string));
48 TRIO_STRING_PUBLIC char *trio_duplicate TRIO_PROTO((const char *source));
49 TRIO_STRING_PUBLIC int trio_equal TRIO_PROTO((const char *first, const char *second));
50 TRIO_STRING_PUBLIC int trio_equal_case TRIO_PROTO((const char *first, const char *second));
51 TRIO_STRING_PUBLIC int trio_equal_locale TRIO_PROTO((const char *first, const char *second));
52 TRIO_STRING_PUBLIC int trio_equal_max TRIO_PROTO((const char *first, size_t max, const char *second));
53 TRIO_STRING_PUBLIC TRIO_CONST char *trio_error TRIO_PROTO((int));
54 TRIO_STRING_PUBLIC size_t trio_length TRIO_PROTO((const char *string));
55 TRIO_STRING_PUBLIC double trio_to_double TRIO_PROTO((const char *source, char **endp));
56 TRIO_STRING_PUBLIC long trio_to_long TRIO_PROTO((const char *source, char **endp, int base));
57 TRIO_STRING_PUBLIC trio_long_double_t trio_to_long_double TRIO_PROTO((const char *source, char **endp));
58 TRIO_STRING_PUBLIC int trio_to_upper TRIO_PROTO((int source));
59 
60 #if !defined(TRIO_MINIMAL)
61 
62 TRIO_STRING_PUBLIC int trio_append TRIO_PROTO((char *target, const char *source));
63 TRIO_STRING_PUBLIC int trio_append_max TRIO_PROTO((char *target, size_t max, const char *source));
64 TRIO_STRING_PUBLIC int trio_contains TRIO_PROTO((const char *string, const char *substring));
65 TRIO_STRING_PUBLIC int trio_copy TRIO_PROTO((char *target, const char *source));
66 TRIO_STRING_PUBLIC char *trio_duplicate_max TRIO_PROTO((const char *source, size_t max));
67 TRIO_STRING_PUBLIC int trio_equal_case_max TRIO_PROTO((const char *first, size_t max, const char *second));
68 #if !defined(_WIN32_WCE)
69 TRIO_STRING_PUBLIC size_t trio_format_date_max TRIO_PROTO((char *target, size_t max, const char *format, const struct tm *datetime));
70 #endif
71 TRIO_STRING_PUBLIC unsigned long trio_hash TRIO_PROTO((const char *string, int type));
72 TRIO_STRING_PUBLIC char *trio_index TRIO_PROTO((const char *string, int character));
73 TRIO_STRING_PUBLIC char *trio_index_last TRIO_PROTO((const char *string, int character));
74 TRIO_STRING_PUBLIC int trio_lower TRIO_PROTO((char *target));
75 TRIO_STRING_PUBLIC int trio_match TRIO_PROTO((const char *string, const char *pattern));
76 TRIO_STRING_PUBLIC int trio_match_case TRIO_PROTO((const char *string, const char *pattern));
77 TRIO_STRING_PUBLIC size_t trio_span_function TRIO_PROTO((char *target, const char *source, int (*Function) TRIO_PROTO((int))));
78 TRIO_STRING_PUBLIC char *trio_substring TRIO_PROTO((const char *string, const char *substring));
79 TRIO_STRING_PUBLIC char *trio_substring_max TRIO_PROTO((const char *string, size_t max, const char *substring));
80 TRIO_STRING_PUBLIC float trio_to_float TRIO_PROTO((const char *source, char **endp));
81 TRIO_STRING_PUBLIC int trio_to_lower TRIO_PROTO((int source));
82 TRIO_STRING_PUBLIC unsigned long trio_to_unsigned_long TRIO_PROTO((const char *source, char **endp, int base));
83 TRIO_STRING_PUBLIC char *trio_tokenize TRIO_PROTO((char *string, const char *delimiters));
84 TRIO_STRING_PUBLIC int trio_upper TRIO_PROTO((char *target));
85 
86 #endif /* !defined(TRIO_MINIMAL) */
87 
88 /*************************************************************************
89  * Dynamic string functions
90  */
91 
92 /*
93  * Opaque type for dynamic strings
94  */
95 
96 typedef struct _trio_string_t trio_string_t;
97 
98 TRIO_STRING_PUBLIC void trio_string_destroy TRIO_PROTO((trio_string_t *self));
99 TRIO_STRING_PUBLIC char *trio_string_extract TRIO_PROTO((trio_string_t *self));
100 TRIO_STRING_PUBLIC int trio_string_size TRIO_PROTO((trio_string_t *self));
101 TRIO_STRING_PUBLIC void trio_string_terminate TRIO_PROTO((trio_string_t *self));
102 TRIO_STRING_PUBLIC int trio_xstring_append_char TRIO_PROTO((trio_string_t *self, char character));
103 TRIO_STRING_PUBLIC trio_string_t *trio_xstring_duplicate TRIO_PROTO((const char *other));
104 
105 #if !defined(TRIO_MINIMAL)
106 
107 TRIO_STRING_PUBLIC trio_string_t *trio_string_create TRIO_PROTO((int initial_size));
108 TRIO_STRING_PUBLIC char *trio_string_get TRIO_PROTO((trio_string_t *self, int offset));
109 TRIO_STRING_PUBLIC void trio_xstring_set TRIO_PROTO((trio_string_t *self, char *buffer));
110 
111 TRIO_STRING_PUBLIC int trio_string_append TRIO_PROTO((trio_string_t *self, trio_string_t *other));
112 TRIO_STRING_PUBLIC int trio_string_contains TRIO_PROTO((trio_string_t *self, trio_string_t *other));
113 TRIO_STRING_PUBLIC int trio_string_copy TRIO_PROTO((trio_string_t *self, trio_string_t *other));
114 TRIO_STRING_PUBLIC trio_string_t *trio_string_duplicate TRIO_PROTO((trio_string_t *other));
115 TRIO_STRING_PUBLIC int trio_string_equal TRIO_PROTO((trio_string_t *self, trio_string_t *other));
116 TRIO_STRING_PUBLIC int trio_string_equal_max TRIO_PROTO((trio_string_t *self, size_t max, trio_string_t *second));
117 TRIO_STRING_PUBLIC int trio_string_equal_case TRIO_PROTO((trio_string_t *self, trio_string_t *other));
118 TRIO_STRING_PUBLIC int trio_string_equal_case_max TRIO_PROTO((trio_string_t *self, size_t max, trio_string_t *other));
119 #if !defined(_WIN32_WCE)
120 TRIO_STRING_PUBLIC size_t trio_string_format_date_max TRIO_PROTO((trio_string_t *self, size_t max, const char *format, const struct tm *datetime));
121 #endif
122 TRIO_STRING_PUBLIC char *trio_string_index TRIO_PROTO((trio_string_t *self, int character));
123 TRIO_STRING_PUBLIC char *trio_string_index_last TRIO_PROTO((trio_string_t *self, int character));
124 TRIO_STRING_PUBLIC int trio_string_length TRIO_PROTO((trio_string_t *self));
125 TRIO_STRING_PUBLIC int trio_string_lower TRIO_PROTO((trio_string_t *self));
126 TRIO_STRING_PUBLIC int trio_string_match TRIO_PROTO((trio_string_t *self, trio_string_t *other));
127 TRIO_STRING_PUBLIC int trio_string_match_case TRIO_PROTO((trio_string_t *self, trio_string_t *other));
128 TRIO_STRING_PUBLIC char *trio_string_substring TRIO_PROTO((trio_string_t *self, trio_string_t *other));
129 TRIO_STRING_PUBLIC int trio_string_upper TRIO_PROTO((trio_string_t *self));
130 
131 TRIO_STRING_PUBLIC int trio_xstring_append TRIO_PROTO((trio_string_t *self, const char *other));
132 TRIO_STRING_PUBLIC int trio_xstring_contains TRIO_PROTO((trio_string_t *self, const char *other));
133 TRIO_STRING_PUBLIC int trio_xstring_copy TRIO_PROTO((trio_string_t *self, const char *other));
134 TRIO_STRING_PUBLIC int trio_xstring_equal TRIO_PROTO((trio_string_t *self, const char *other));
135 TRIO_STRING_PUBLIC int trio_xstring_equal_max TRIO_PROTO((trio_string_t *self, size_t max, const char *other));
136 TRIO_STRING_PUBLIC int trio_xstring_equal_case TRIO_PROTO((trio_string_t *self, const char *other));
137 TRIO_STRING_PUBLIC int trio_xstring_equal_case_max TRIO_PROTO((trio_string_t *self, size_t max, const char *other));
138 TRIO_STRING_PUBLIC int trio_xstring_match TRIO_PROTO((trio_string_t *self, const char *other));
139 TRIO_STRING_PUBLIC int trio_xstring_match_case TRIO_PROTO((trio_string_t *self, const char *other));
140 TRIO_STRING_PUBLIC char *trio_xstring_substring TRIO_PROTO((trio_string_t *self, const char *other));
141 
142 #endif /* !defined(TRIO_MINIMAL) */
143 
144 #endif /* TRIO_TRIOSTR_H */
145