1 /* 2 ****************************************************************************** 3 * 4 * Copyright (C) 1997-2012, International Business Machines 5 * Corporation and others. All Rights Reserved. 6 * 7 ****************************************************************************** 8 * 9 * File CSTRING.H 10 * 11 * Contains CString interface 12 * 13 * @author Helena Shih 14 * 15 * Modification History: 16 * 17 * Date Name Description 18 * 6/17/98 hshih Created. 19 * 05/03/99 stephen Changed from functions to macros. 20 * 06/14/99 stephen Added icu_strncat, icu_strncmp, icu_tolower 21 * 22 ****************************************************************************** 23 */ 24 25 #ifndef CSTRING_H 26 #define CSTRING_H 1 27 28 #include "unicode/utypes.h" 29 #include "cmemory.h" 30 #include <string.h> 31 #include <stdlib.h> 32 #include <ctype.h> 33 34 #define uprv_strcpy(dst, src) U_STANDARD_CPP_NAMESPACE strcpy(dst, src) 35 #define uprv_strlen(str) U_STANDARD_CPP_NAMESPACE strlen(str) 36 #define uprv_strcmp(s1, s2) U_STANDARD_CPP_NAMESPACE strcmp(s1, s2) 37 #define uprv_strcat(dst, src) U_STANDARD_CPP_NAMESPACE strcat(dst, src) 38 #define uprv_strchr(s, c) U_STANDARD_CPP_NAMESPACE strchr(s, c) 39 #define uprv_strstr(s, c) U_STANDARD_CPP_NAMESPACE strstr(s, c) 40 #define uprv_strrchr(s, c) U_STANDARD_CPP_NAMESPACE strrchr(s, c) 41 42 #if U_DEBUG 43 44 #define uprv_strncpy(dst, src, size) ( \ 45 uprv_checkValidMemory(src, 1), \ 46 U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size)) 47 #define uprv_strncmp(s1, s2, n) ( \ 48 uprv_checkValidMemory(s1, 1), \ 49 uprv_checkValidMemory(s2, 1), \ 50 U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n)) 51 #define uprv_strncat(dst, src, n) ( \ 52 uprv_checkValidMemory(src, 1), \ 53 U_STANDARD_CPP_NAMESPACE strncat(dst, src, n)) 54 55 #else 56 57 #define uprv_strncpy(dst, src, size) U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size) 58 #define uprv_strncmp(s1, s2, n) U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n) 59 #define uprv_strncat(dst, src, n) U_STANDARD_CPP_NAMESPACE strncat(dst, src, n) 60 61 #endif /* U_DEBUG */ 62 63 /** 64 * Is c an ASCII-repertoire letter a-z or A-Z? 65 * Note: The implementation is specific to whether ICU is compiled for 66 * an ASCII-based or EBCDIC-based machine. There just does not seem to be a better name for this. 67 */ 68 U_CAPI UBool U_EXPORT2 69 uprv_isASCIILetter(char c); 70 71 U_CAPI char U_EXPORT2 72 uprv_toupper(char c); 73 74 75 U_CAPI char U_EXPORT2 76 uprv_asciitolower(char c); 77 78 U_CAPI char U_EXPORT2 79 uprv_ebcdictolower(char c); 80 81 #if U_CHARSET_FAMILY==U_ASCII_FAMILY 82 # define uprv_tolower uprv_asciitolower 83 #elif U_CHARSET_FAMILY==U_EBCDIC_FAMILY 84 # define uprv_tolower uprv_ebcdictolower 85 #else 86 # error U_CHARSET_FAMILY is not valid 87 #endif 88 89 #define uprv_strtod(source, end) U_STANDARD_CPP_NAMESPACE strtod(source, end) 90 #define uprv_strtoul(str, end, base) U_STANDARD_CPP_NAMESPACE strtoul(str, end, base) 91 #define uprv_strtol(str, end, base) U_STANDARD_CPP_NAMESPACE strtol(str, end, base) 92 93 /* Conversion from a digit to the character with radix base from 2-19 */ 94 /* May need to use U_UPPER_ORDINAL*/ 95 #define T_CString_itosOffset(a) ((a)<=9?('0'+(a)):('A'+(a)-10)) 96 97 U_CAPI char* U_EXPORT2 98 uprv_strdup(const char *src); 99 100 /** 101 * uprv_malloc n+1 bytes, and copy n bytes from src into the new string. 102 * Terminate with a null at offset n. If n is -1, works like uprv_strdup 103 * @param src 104 * @param n length of the input string, not including null. 105 * @return new string (owned by caller, use uprv_free to free). 106 * @internal 107 */ 108 U_CAPI char* U_EXPORT2 109 uprv_strndup(const char *src, int32_t n); 110 111 U_CAPI char* U_EXPORT2 112 T_CString_toLowerCase(char* str); 113 114 U_CAPI char* U_EXPORT2 115 T_CString_toUpperCase(char* str); 116 117 U_CAPI int32_t U_EXPORT2 118 T_CString_integerToString(char *buffer, int32_t n, int32_t radix); 119 120 U_CAPI int32_t U_EXPORT2 121 T_CString_int64ToString(char *buffer, int64_t n, uint32_t radix); 122 123 U_CAPI int32_t U_EXPORT2 124 T_CString_stringToInteger(const char *integerString, int32_t radix); 125 126 /** 127 * Case-insensitive, language-independent string comparison 128 * limited to the ASCII character repertoire. 129 */ 130 U_CAPI int U_EXPORT2 131 uprv_stricmp(const char *str1, const char *str2); 132 133 /** 134 * Case-insensitive, language-independent string comparison 135 * limited to the ASCII character repertoire. 136 */ 137 U_CAPI int U_EXPORT2 138 uprv_strnicmp(const char *str1, const char *str2, uint32_t n); 139 140 #endif /* ! CSTRING_H */ 141