michael@0: /*
michael@0: ******************************************************************************
michael@0: *
michael@0: *   Copyright (C) 1997-2012, International Business Machines
michael@0: *   Corporation and others.  All Rights Reserved.
michael@0: *
michael@0: ******************************************************************************
michael@0: *
michael@0: * File CSTRING.H
michael@0: *
michael@0: * Contains CString interface
michael@0: *
michael@0: * @author       Helena Shih
michael@0: *
michael@0: * Modification History:
michael@0: *
michael@0: *   Date        Name        Description
michael@0: *   6/17/98     hshih       Created.
michael@0: *  05/03/99     stephen     Changed from functions to macros.
michael@0: *  06/14/99     stephen     Added icu_strncat, icu_strncmp, icu_tolower
michael@0: *
michael@0: ******************************************************************************
michael@0: */
michael@0: 
michael@0: #ifndef CSTRING_H
michael@0: #define CSTRING_H 1
michael@0: 
michael@0: #include "unicode/utypes.h"
michael@0: #include "cmemory.h"
michael@0: #include <string.h>
michael@0: #include <stdlib.h>
michael@0: #include <ctype.h>
michael@0: 
michael@0: #define uprv_strcpy(dst, src) U_STANDARD_CPP_NAMESPACE  strcpy(dst, src)
michael@0: #define uprv_strlen(str) U_STANDARD_CPP_NAMESPACE strlen(str)
michael@0: #define uprv_strcmp(s1, s2) U_STANDARD_CPP_NAMESPACE strcmp(s1, s2)
michael@0: #define uprv_strcat(dst, src) U_STANDARD_CPP_NAMESPACE strcat(dst, src)
michael@0: #define uprv_strchr(s, c) U_STANDARD_CPP_NAMESPACE strchr(s, c)
michael@0: #define uprv_strstr(s, c) U_STANDARD_CPP_NAMESPACE strstr(s, c)
michael@0: #define uprv_strrchr(s, c) U_STANDARD_CPP_NAMESPACE strrchr(s, c)
michael@0: 
michael@0: #if U_DEBUG
michael@0: 
michael@0: #define uprv_strncpy(dst, src, size) ( \
michael@0:     uprv_checkValidMemory(src, 1), \
michael@0:     U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size))
michael@0: #define uprv_strncmp(s1, s2, n) ( \
michael@0:     uprv_checkValidMemory(s1, 1), \
michael@0:     uprv_checkValidMemory(s2, 1), \
michael@0:     U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n))
michael@0: #define uprv_strncat(dst, src, n) ( \
michael@0:     uprv_checkValidMemory(src, 1), \
michael@0:     U_STANDARD_CPP_NAMESPACE strncat(dst, src, n))
michael@0: 
michael@0: #else
michael@0: 
michael@0: #define uprv_strncpy(dst, src, size) U_STANDARD_CPP_NAMESPACE strncpy(dst, src, size)
michael@0: #define uprv_strncmp(s1, s2, n) U_STANDARD_CPP_NAMESPACE strncmp(s1, s2, n)
michael@0: #define uprv_strncat(dst, src, n) U_STANDARD_CPP_NAMESPACE strncat(dst, src, n)
michael@0: 
michael@0: #endif  /* U_DEBUG */
michael@0: 
michael@0: /**
michael@0:  * Is c an ASCII-repertoire letter a-z or A-Z?
michael@0:  * Note: The implementation is specific to whether ICU is compiled for
michael@0:  * an ASCII-based or EBCDIC-based machine. There just does not seem to be a better name for this.
michael@0:  */
michael@0: U_CAPI UBool U_EXPORT2
michael@0: uprv_isASCIILetter(char c);
michael@0: 
michael@0: U_CAPI char U_EXPORT2
michael@0: uprv_toupper(char c);
michael@0: 
michael@0: 
michael@0: U_CAPI char U_EXPORT2
michael@0: uprv_asciitolower(char c);
michael@0: 
michael@0: U_CAPI char U_EXPORT2
michael@0: uprv_ebcdictolower(char c);
michael@0: 
michael@0: #if U_CHARSET_FAMILY==U_ASCII_FAMILY
michael@0: #   define uprv_tolower uprv_asciitolower
michael@0: #elif U_CHARSET_FAMILY==U_EBCDIC_FAMILY
michael@0: #   define uprv_tolower uprv_ebcdictolower
michael@0: #else
michael@0: #   error U_CHARSET_FAMILY is not valid
michael@0: #endif
michael@0: 
michael@0: #define uprv_strtod(source, end) U_STANDARD_CPP_NAMESPACE strtod(source, end)
michael@0: #define uprv_strtoul(str, end, base) U_STANDARD_CPP_NAMESPACE strtoul(str, end, base)
michael@0: #define uprv_strtol(str, end, base) U_STANDARD_CPP_NAMESPACE strtol(str, end, base)
michael@0: 
michael@0: /* Conversion from a digit to the character with radix base from 2-19 */
michael@0: /* May need to use U_UPPER_ORDINAL*/
michael@0: #define T_CString_itosOffset(a) ((a)<=9?('0'+(a)):('A'+(a)-10))
michael@0: 
michael@0: U_CAPI char* U_EXPORT2
michael@0: uprv_strdup(const char *src);
michael@0: 
michael@0: /**
michael@0:  * uprv_malloc n+1 bytes, and copy n bytes from src into the new string.
michael@0:  * Terminate with a null at offset n.   If n is -1, works like uprv_strdup
michael@0:  * @param src
michael@0:  * @param n length of the input string, not including null.
michael@0:  * @return new string (owned by caller, use uprv_free to free).
michael@0:  * @internal
michael@0:  */
michael@0: U_CAPI char* U_EXPORT2
michael@0: uprv_strndup(const char *src, int32_t n);
michael@0: 
michael@0: U_CAPI char* U_EXPORT2
michael@0: T_CString_toLowerCase(char* str);
michael@0: 
michael@0: U_CAPI char* U_EXPORT2
michael@0: T_CString_toUpperCase(char* str);
michael@0: 
michael@0: U_CAPI int32_t U_EXPORT2
michael@0: T_CString_integerToString(char *buffer, int32_t n, int32_t radix);
michael@0: 
michael@0: U_CAPI int32_t U_EXPORT2
michael@0: T_CString_int64ToString(char *buffer, int64_t n, uint32_t radix);
michael@0: 
michael@0: U_CAPI int32_t U_EXPORT2
michael@0: T_CString_stringToInteger(const char *integerString, int32_t radix);
michael@0: 
michael@0: /**
michael@0:  * Case-insensitive, language-independent string comparison
michael@0:  * limited to the ASCII character repertoire.
michael@0:  */
michael@0: U_CAPI int U_EXPORT2
michael@0: uprv_stricmp(const char *str1, const char *str2);
michael@0: 
michael@0: /**
michael@0:  * Case-insensitive, language-independent string comparison
michael@0:  * limited to the ASCII character repertoire.
michael@0:  */
michael@0: U_CAPI int U_EXPORT2
michael@0: uprv_strnicmp(const char *str1, const char *str2, uint32_t n);
michael@0: 
michael@0: #endif /* ! CSTRING_H */