1 | /*************************************************************************
|
---|
2 | *
|
---|
3 | * $Id: triostr.h 6076 2007-12-14 19:23:03Z vboxsync $
|
---|
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 */
|
---|