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