icuSources/common/cstring.h

   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 */