1ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru/* 2ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru****************************************************************************** 3ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 454dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius* Copyright (C) 1997-2012, International Business Machines 5ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* Corporation and others. All Rights Reserved. 6ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 7ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru****************************************************************************** 8ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 9ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* File CSTRING.H 10ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 11ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* Contains CString interface 12ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 13ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* @author Helena Shih 14ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 15ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* Modification History: 16ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 17ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* Date Name Description 18ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 6/17/98 hshih Created. 19ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 05/03/99 stephen Changed from functions to macros. 20ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 06/14/99 stephen Added icu_strncat, icu_strncmp, icu_tolower 21ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru* 22ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru****************************************************************************** 23ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru*/ 24ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 25ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#ifndef CSTRING_H 26ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define CSTRING_H 1 27ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 28ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#include "unicode/utypes.h" 2954dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#include "cmemory.h" 30ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#include <string.h> 31ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#include <stdlib.h> 32ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#include <ctype.h> 33ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 34ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strcpy(dst, src) U_STANDARD_CPP_NAMESPACE strcpy(dst, src) 35ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strlen(str) U_STANDARD_CPP_NAMESPACE strlen(str) 36ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strcmp(s1, s2) U_STANDARD_CPP_NAMESPACE strcmp(s1, s2) 37ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strcat(dst, src) U_STANDARD_CPP_NAMESPACE strcat(dst, src) 38ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strchr(s, c) U_STANDARD_CPP_NAMESPACE strchr(s, c) 39ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strstr(s, c) U_STANDARD_CPP_NAMESPACE strstr(s, c) 40ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strrchr(s, c) U_STANDARD_CPP_NAMESPACE strrchr(s, c) 41ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 4254dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#if U_DEBUG 4354dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius 4454dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncpy(dst, src, size) ( \ 4554dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius uprv_checkValidMemory(src, 1), \ 4654dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size)) 4754dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncmp(s1, s2, n) ( \ 4854dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius uprv_checkValidMemory(s1, 1), \ 4954dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius uprv_checkValidMemory(s2, 1), \ 5054dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n)) 5154dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncat(dst, src, n) ( \ 5254dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius uprv_checkValidMemory(src, 1), \ 5354dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius U_STANDARD_CPP_NAMESPACE strncat(dst, src, n)) 5454dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius 5554dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#else 5654dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius 5754dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncpy(dst, src, size) U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size) 5854dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncmp(s1, s2, n) U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n) 5954dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#define uprv_strncat(dst, src, n) U_STANDARD_CPP_NAMESPACE strncat(dst, src, n) 6054dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius 6154dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#endif /* U_DEBUG */ 6254dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius 63103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius/** 64103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * Is c an ASCII-repertoire letter a-z or A-Z? 65103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * Note: The implementation is specific to whether ICU is compiled for 66103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * an ASCII-based or EBCDIC-based machine. There just does not seem to be a better name for this. 67103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius */ 68103e9ffba2cba345d0078eb8b8db33249f81840aCraig CorneliusU_CAPI UBool U_EXPORT2 69103e9ffba2cba345d0078eb8b8db33249f81840aCraig Corneliusuprv_isASCIILetter(char c); 70103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius 71ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char U_EXPORT2 72ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruuprv_toupper(char c); 73ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 74ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 75ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char U_EXPORT2 76ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruuprv_asciitolower(char c); 77ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 78ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char U_EXPORT2 79ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruuprv_ebcdictolower(char c); 80ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 81ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#if U_CHARSET_FAMILY==U_ASCII_FAMILY 82ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru# define uprv_tolower uprv_asciitolower 83ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#elif U_CHARSET_FAMILY==U_EBCDIC_FAMILY 84ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru# define uprv_tolower uprv_ebcdictolower 85ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#else 86ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru# error U_CHARSET_FAMILY is not valid 87ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#endif 88ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 89ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strtod(source, end) U_STANDARD_CPP_NAMESPACE strtod(source, end) 90ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strtoul(str, end, base) U_STANDARD_CPP_NAMESPACE strtoul(str, end, base) 91ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define uprv_strtol(str, end, base) U_STANDARD_CPP_NAMESPACE strtol(str, end, base) 92ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 93ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru/* Conversion from a digit to the character with radix base from 2-19 */ 94ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru/* May need to use U_UPPER_ORDINAL*/ 95ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#define T_CString_itosOffset(a) ((a)<=9?('0'+(a)):('A'+(a)-10)) 96ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 97ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char* U_EXPORT2 98ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruuprv_strdup(const char *src); 99ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 100ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru/** 101ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * uprv_malloc n+1 bytes, and copy n bytes from src into the new string. 102ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * Terminate with a null at offset n. If n is -1, works like uprv_strdup 103ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * @param src 104ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * @param n length of the input string, not including null. 105ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * @return new string (owned by caller, use uprv_free to free). 106ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru * @internal 107ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru */ 108ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char* U_EXPORT2 109ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruuprv_strndup(const char *src, int32_t n); 110ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 111ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char* U_EXPORT2 112ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruT_CString_toLowerCase(char* str); 113ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 114ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI char* U_EXPORT2 115ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruT_CString_toUpperCase(char* str); 116ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 117ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI int32_t U_EXPORT2 118ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruT_CString_integerToString(char *buffer, int32_t n, int32_t radix); 119ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 120ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI int32_t U_EXPORT2 121ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruT_CString_int64ToString(char *buffer, int64_t n, uint32_t radix); 122ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 123ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI int32_t U_EXPORT2 124ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruT_CString_stringToInteger(const char *integerString, int32_t radix); 125ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 126103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius/** 127103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * Case-insensitive, language-independent string comparison 128103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * limited to the ASCII character repertoire. 129103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius */ 130ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI int U_EXPORT2 131103e9ffba2cba345d0078eb8b8db33249f81840aCraig Corneliusuprv_stricmp(const char *str1, const char *str2); 132ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 133103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius/** 134103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * Case-insensitive, language-independent string comparison 135103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius * limited to the ASCII character repertoire. 136103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius */ 137ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruU_CAPI int U_EXPORT2 138103e9ffba2cba345d0078eb8b8db33249f81840aCraig Corneliusuprv_strnicmp(const char *str1, const char *str2, uint32_t n); 139ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru 140ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru#endif /* ! CSTRING_H */ 141