1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
4 ******************************************************************************
6 * Copyright (C) 1997-2016, International Business Machines
7 * Corporation and others. All Rights Reserved.
9 ******************************************************************************
11 * FILE NAME : putilimp.h
13 * Date Name Description
14 * 10/17/04 grhoten Move internal functions from putil.h to this file.
15 ******************************************************************************
21 #include "unicode/utypes.h"
22 #include "unicode/putil.h"
25 * \def U_SIGNED_RIGHT_SHIFT_IS_ARITHMETIC
26 * Nearly all CPUs and compilers implement a right-shift of a signed integer
27 * as an Arithmetic Shift Right which copies the sign bit (the Most Significant Bit (MSB))
28 * into the vacated bits (sign extension).
29 * For example, (int32_t)0xfff5fff3>>4 becomes 0xffff5fff and -1>>1=-1.
31 * This can be useful for storing a signed value in the upper bits
32 * and another bit field in the lower bits.
33 * The signed value can be retrieved by simple right-shifting.
35 * This is consistent with the Java language.
37 * However, the C standard allows compilers to implement a right-shift of a signed integer
38 * as a Logical Shift Right which copies a 0 into the vacated bits.
39 * For example, (int32_t)0xfff5fff3>>4 becomes 0x0fff5fff and -1>>1=0x7fffffff.
41 * Code that depends on the natural behavior should be guarded with this macro,
42 * with an alternate path for unusual platforms.
45 #ifdef U_SIGNED_RIGHT_SHIFT_IS_ARITHMETIC
46 /* Use the predefined value. */
49 * Nearly all CPUs & compilers implement a right-shift of a signed integer
50 * as an Arithmetic Shift Right (with sign extension).
52 # define U_SIGNED_RIGHT_SHIFT_IS_ARITHMETIC 1
55 /** Define this to 1 if your platform supports IEEE 754 floating point,
56 to 0 if it does not. */
62 * uintptr_t is an optional part of the standard definitions in stdint.h.
63 * The opengroup.org documentation for stdint.h says
64 * "On XSI-conformant systems, the intptr_t and uintptr_t types are required;
65 * otherwise, they are optional."
66 * We assume that when uintptr_t is defined, UINTPTR_MAX is defined as well.
68 * Do not use ptrdiff_t since it is signed. size_t is unsigned.
70 /* TODO: This check fails on some z environments. Filed a ticket #9357 for this. */
71 #if !defined(__intptr_t_defined) && !defined(UINTPTR_MAX) && (U_PLATFORM != U_PF_OS390)
72 typedef size_t uintptr_t;
75 /*===========================================================================*/
76 /** @{ Information about POSIX support */
77 /*===========================================================================*/
79 #ifdef U_HAVE_NL_LANGINFO_CODESET
80 /* Use the predefined value. */
81 #elif U_PLATFORM_USES_ONLY_WIN32_API || U_PLATFORM == U_PF_ANDROID || U_PLATFORM == U_PF_QNX
82 # define U_HAVE_NL_LANGINFO_CODESET 0
84 # define U_HAVE_NL_LANGINFO_CODESET 1
87 #ifdef U_NL_LANGINFO_CODESET
88 /* Use the predefined value. */
89 #elif !U_HAVE_NL_LANGINFO_CODESET
90 # define U_NL_LANGINFO_CODESET -1
91 #elif U_PLATFORM == U_PF_OS400
94 # define U_NL_LANGINFO_CODESET CODESET
98 /* Use the predefined value. */
99 #elif U_PLATFORM_USES_ONLY_WIN32_API
100 // UWP doesn't support tzset or environment variables for tz
101 #if U_PLATFORM_HAS_WINUWP_API == 0
102 # define U_TZSET _tzset
104 #elif U_PLATFORM == U_PF_OS400
107 # define U_TZSET tzset
110 #if defined(U_TIMEZONE) || defined(U_HAVE_TIMEZONE)
111 /* Use the predefined value. */
112 #elif U_PLATFORM == U_PF_ANDROID
113 # define U_TIMEZONE timezone
114 #elif defined(__UCLIBC__)
115 // uClibc does not have __timezone or _timezone.
116 #elif defined(_NEWLIB_VERSION)
117 # define U_TIMEZONE _timezone
118 #elif defined(__GLIBC__)
120 # define U_TIMEZONE __timezone
121 #elif U_PLATFORM_IS_LINUX_BASED
123 #elif U_PLATFORM_USES_ONLY_WIN32_API
124 # define U_TIMEZONE _timezone
125 #elif U_PLATFORM == U_PF_BSD && !defined(__NetBSD__)
127 #elif U_PLATFORM == U_PF_OS400
129 #elif U_PLATFORM == U_PF_IPHONE
132 # define U_TIMEZONE timezone
136 /* Use the predefined value. */
137 #elif U_PLATFORM_USES_ONLY_WIN32_API
138 /* not usable on all windows platforms */
139 #if U_PLATFORM_HAS_WINUWP_API == 0
140 # define U_TZNAME _tzname
142 #elif U_PLATFORM == U_PF_OS400
145 # define U_TZNAME tzname
149 /* Use the predefined value. */
150 #elif U_PLATFORM_USES_ONLY_WIN32_API
151 # define U_HAVE_MMAP 0
153 # define U_HAVE_MMAP 1
157 /* Use the predefined value. */
158 #elif U_PLATFORM_USES_ONLY_WIN32_API
159 # define U_HAVE_POPEN 0
160 #elif U_PLATFORM == U_PF_OS400
161 # define U_HAVE_POPEN 0
163 # define U_HAVE_POPEN 1
167 * \def U_HAVE_DIRENT_H
168 * Defines whether dirent.h is available.
171 #ifdef U_HAVE_DIRENT_H
172 /* Use the predefined value. */
173 #elif U_PLATFORM_USES_ONLY_WIN32_API
174 # define U_HAVE_DIRENT_H 0
176 # define U_HAVE_DIRENT_H 1
181 /*===========================================================================*/
182 /** @{ GCC built in functions for atomic memory operations */
183 /*===========================================================================*/
186 * \def U_HAVE_GCC_ATOMICS
189 #ifdef U_HAVE_GCC_ATOMICS
190 /* Use the predefined value. */
191 #elif U_PLATFORM == U_PF_MINGW
192 #define U_HAVE_GCC_ATOMICS 0
193 #elif U_GCC_MAJOR_MINOR >= 404 || defined(__clang__)
194 /* TODO: Intel icc and IBM xlc on AIX also support gcc atomics. (Intel originated them.)
195 * Add them for these compilers.
196 * Note: Clang sets __GNUC__ defines for version 4.2, so misses the 4.4 test here.
198 # define U_HAVE_GCC_ATOMICS 1
200 # define U_HAVE_GCC_ATOMICS 0
206 * \def U_HAVE_STD_ATOMICS
207 * Defines whether the standard C++11 <atomic> is available.
208 * ICU will use this when available,
209 * otherwise will fall back to compiler or platform specific alternatives.
212 #ifdef U_HAVE_STD_ATOMICS
213 /* Use the predefined value. */
214 #elif U_CPLUSPLUS_VERSION < 11
215 /* Not C++11, disable use of atomics */
216 # define U_HAVE_STD_ATOMICS 0
217 #elif __clang__ && __clang_major__==3 && __clang_minor__<=1
218 /* Clang 3.1, has atomic variable initializer bug. */
219 # define U_HAVE_STD_ATOMICS 0
221 /* U_HAVE_ATOMIC is typically set by an autoconf test of #include <atomic> */
222 /* Can be set manually, or left undefined, on platforms without autoconf. */
223 # if defined(U_HAVE_ATOMIC) && U_HAVE_ATOMIC
224 # define U_HAVE_STD_ATOMICS 1
226 # define U_HAVE_STD_ATOMICS 0
232 * \def U_HAVE_CLANG_ATOMICS
233 * Defines whether Clang c11 style built-in atomics are available.
234 * These are used in preference to gcc atomics when both are available.
236 #ifdef U_HAVE_CLANG_ATOMICS
237 /* Use the predefined value. */
238 #elif __has_builtin(__c11_atomic_load) && \
239 __has_builtin(__c11_atomic_store) && \
240 __has_builtin(__c11_atomic_fetch_add) && \
241 __has_builtin(__c11_atomic_fetch_sub)
242 # define U_HAVE_CLANG_ATOMICS 1
244 # define U_HAVE_CLANG_ATOMICS 0
247 /*===========================================================================*/
248 /** @{ Programs used by ICU code */
249 /*===========================================================================*/
252 * \def U_MAKE_IS_NMAKE
253 * Defines whether the "make" program is Windows nmake.
255 #ifdef U_MAKE_IS_NMAKE
256 /* Use the predefined value. */
257 #elif U_PLATFORM == U_PF_WINDOWS
258 # define U_MAKE_IS_NMAKE 1
260 # define U_MAKE_IS_NMAKE 0
265 /*==========================================================================*/
266 /* Platform utilities */
267 /*==========================================================================*/
270 * Platform utilities isolates the platform dependencies of the
271 * library. For each platform which this code is ported to, these
272 * functions may have to be re-implemented.
276 * Floating point utility to determine if a double is Not a Number (NaN).
279 U_INTERNAL UBool U_EXPORT2
uprv_isNaN(double d
);
281 * Floating point utility to determine if a double has an infinite value.
284 U_INTERNAL UBool U_EXPORT2
uprv_isInfinite(double d
);
286 * Floating point utility to determine if a double has a positive infinite value.
289 U_INTERNAL UBool U_EXPORT2
uprv_isPositiveInfinity(double d
);
291 * Floating point utility to determine if a double has a negative infinite value.
294 U_INTERNAL UBool U_EXPORT2
uprv_isNegativeInfinity(double d
);
296 * Floating point utility that returns a Not a Number (NaN) value.
299 U_INTERNAL
double U_EXPORT2
uprv_getNaN(void);
301 * Floating point utility that returns an infinite value.
304 U_INTERNAL
double U_EXPORT2
uprv_getInfinity(void);
307 * Floating point utility to truncate a double.
310 U_INTERNAL
double U_EXPORT2
uprv_trunc(double d
);
312 * Floating point utility to calculate the floor of a double.
315 U_INTERNAL
double U_EXPORT2
uprv_floor(double d
);
317 * Floating point utility to calculate the ceiling of a double.
320 U_INTERNAL
double U_EXPORT2
uprv_ceil(double d
);
322 * Floating point utility to calculate the absolute value of a double.
325 U_INTERNAL
double U_EXPORT2
uprv_fabs(double d
);
327 * Floating point utility to calculate the fractional and integer parts of a double.
330 U_INTERNAL
double U_EXPORT2
uprv_modf(double d
, double* pinteger
);
332 * Floating point utility to calculate the remainder of a double divided by another double.
335 U_INTERNAL
double U_EXPORT2
uprv_fmod(double d
, double y
);
337 * Floating point utility to calculate d to the power of exponent (d^exponent).
340 U_INTERNAL
double U_EXPORT2
uprv_pow(double d
, double exponent
);
342 * Floating point utility to calculate 10 to the power of exponent (10^exponent).
345 U_INTERNAL
double U_EXPORT2
uprv_pow10(int32_t exponent
);
347 * Floating point utility to calculate the maximum value of two doubles.
350 U_INTERNAL
double U_EXPORT2
uprv_fmax(double d
, double y
);
352 * Floating point utility to calculate the minimum value of two doubles.
355 U_INTERNAL
double U_EXPORT2
uprv_fmin(double d
, double y
);
357 * Private utility to calculate the maximum value of two integers.
360 U_INTERNAL
int32_t U_EXPORT2
uprv_max(int32_t d
, int32_t y
);
362 * Private utility to calculate the minimum value of two integers.
365 U_INTERNAL
int32_t U_EXPORT2
uprv_min(int32_t d
, int32_t y
);
368 # define uprv_isNegative(number) (*((signed char *)&(number))<0)
370 # define uprv_isNegative(number) (*((signed char *)&(number)+sizeof(number)-1)<0)
374 * Return the largest positive number that can be represented by an integer
375 * type of arbitrary bit length.
378 U_INTERNAL
double U_EXPORT2
uprv_maxMantissa(void);
381 * Floating point utility to calculate the logarithm of a double.
384 U_INTERNAL
double U_EXPORT2
uprv_log(double d
);
387 * Does common notion of rounding e.g. uprv_floor(x + 0.5);
388 * @param x the double number
389 * @return the rounded double
392 U_INTERNAL
double U_EXPORT2
uprv_round(double x
);
395 * Adds the signed integers a and b, storing the result in res.
396 * Checks for signed integer overflow.
397 * Similar to the GCC/Clang extension __builtin_add_overflow
399 * @param a The first operand.
400 * @param b The second operand.
402 * @return true if overflow occurred; false if no overflow occurred.
405 U_INTERNAL UBool U_EXPORT2
uprv_add32_overflow(int32_t a
, int32_t b
, int32_t* res
);
408 * Multiplies the signed integers a and b, storing the result in res.
409 * Checks for signed integer overflow.
410 * Similar to the GCC/Clang extension __builtin_mul_overflow
412 * @param a The first multiplicand.
413 * @param b The second multiplicand.
415 * @return true if overflow occurred; false if no overflow occurred.
418 U_INTERNAL UBool U_EXPORT2
uprv_mul32_overflow(int32_t a
, int32_t b
, int32_t* res
);
422 * Returns the number of digits after the decimal point in a double number x.
424 * @param x the double number
425 * @return the number of digits after the decimal point in a double number x.
428 /*U_INTERNAL int32_t U_EXPORT2 uprv_digitsAfterDecimal(double x);*/
431 #if !U_CHARSET_IS_UTF8
433 * Please use ucnv_getDefaultName() instead.
434 * Return the default codepage for this platform and locale.
435 * This function can call setlocale() on Unix platforms. Please read the
436 * platform documentation on setlocale() before calling this function.
437 * @return the default codepage for this platform
440 U_INTERNAL
const char* U_EXPORT2
uprv_getDefaultCodepage(void);
444 * Please use uloc_getDefault() instead.
445 * Return the default locale ID string by querying the system, or
446 * zero if one cannot be found.
447 * This function can call setlocale() on Unix platforms. Please read the
448 * platform documentation on setlocale() before calling this function.
449 * @return the default locale ID string
452 U_INTERNAL
const char* U_EXPORT2
uprv_getDefaultLocaleID(void);
455 * Time zone utilities
457 * Wrappers for C runtime library functions relating to timezones.
458 * The t_tzset() function (similar to tzset) uses the current setting
459 * of the environment variable TZ to assign values to three global
460 * variables: daylight, timezone, and tzname. These variables have the
461 * following meanings, and are declared in <time.h>.
463 * daylight Nonzero if daylight-saving-time zone (DST) is specified
464 * in TZ; otherwise, 0. Default value is 1.
465 * timezone Difference in seconds between coordinated universal
466 * time and local time. E.g., -28,800 for PST (GMT-8hrs)
467 * tzname(0) Three-letter time-zone name derived from TZ environment
468 * variable. E.g., "PST".
469 * tzname(1) Three-letter DST zone name derived from TZ environment
470 * variable. E.g., "PDT". If DST zone is omitted from TZ,
471 * tzname(1) is an empty string.
473 * Notes: For example, to set the TZ environment variable to correspond
474 * to the current time zone in Germany, you can use one of the
475 * following statements:
480 * If the TZ value is not set, t_tzset() attempts to use the time zone
481 * information specified by the operating system. Under Windows NT
482 * and Windows 95, this information is specified in the Control Panel's
483 * Date/Time application.
486 U_INTERNAL
void U_EXPORT2
uprv_tzset(void);
489 * Difference in seconds between coordinated universal
490 * time and local time. E.g., -28,800 for PST (GMT-8hrs)
491 * @return the difference in seconds between coordinated universal time and local time.
494 U_INTERNAL
int32_t U_EXPORT2
uprv_timezone(void);
497 * tzname(0) Three-letter time-zone name derived from TZ environment
498 * variable. E.g., "PST".
499 * tzname(1) Three-letter DST zone name derived from TZ environment
500 * variable. E.g., "PDT". If DST zone is omitted from TZ,
501 * tzname(1) is an empty string.
504 U_INTERNAL
const char* U_EXPORT2
uprv_tzname(int n
);
507 * Reset the global tzname cache.
510 U_INTERNAL
void uprv_tzname_clear_cache();
513 * Get UTC (GMT) time measured in milliseconds since 0:00 on 1/1/1970.
514 * This function is affected by 'faketime' and should be the bottleneck for all user-visible ICU time functions.
515 * @return the UTC time measured in milliseconds
518 U_INTERNAL UDate U_EXPORT2
uprv_getUTCtime(void);
521 * Get UTC (GMT) time measured in milliseconds since 0:00 on 1/1/1970.
522 * This function is not affected by 'faketime', so it should only be used by low level test functions- not by anything that
523 * exposes time to the end user.
524 * @return the UTC time measured in milliseconds
527 U_INTERNAL UDate U_EXPORT2
uprv_getRawUTCtime(void);
530 * Determine whether a pathname is absolute or not, as defined by the platform.
531 * @param path Pathname to test
532 * @return TRUE if the path is absolute
533 * @internal (ICU 3.0)
535 U_INTERNAL UBool U_EXPORT2
uprv_pathIsAbsolute(const char *path
);
538 * Use U_MAX_PTR instead of this function.
539 * @param void pointer to test
540 * @return the largest possible pointer greater than the base
541 * @internal (ICU 3.8)
543 U_INTERNAL
void * U_EXPORT2
uprv_maximumPtr(void *base
);
546 * Maximum value of a (void*) - use to indicate the limit of an 'infinite' buffer.
547 * In fact, buffer sizes must not exceed 2GB so that the difference between
548 * the buffer limit and the buffer start can be expressed in an int32_t.
550 * The definition of U_MAX_PTR must fulfill the following conditions:
551 * - return the largest possible pointer greater than base
552 * - return a valid pointer according to the machine architecture (AS/400, 64-bit, etc.)
553 * - avoid wrapping around at high addresses
554 * - make sure that the returned pointer is not farther from base than 0x7fffffff bytes
556 * @param base The beginning of a buffer to find the maximum offset from
560 # if U_PLATFORM == U_PF_OS390 && !defined(_LP64)
561 /* We have 31-bit pointers. */
562 # define U_MAX_PTR(base) ((void *)0x7fffffff)
563 # elif U_PLATFORM == U_PF_OS400
564 # define U_MAX_PTR(base) uprv_maximumPtr((void *)base)
567 * For platforms where pointers are scalar values (which is normal, but unlike i5/OS)
568 * but that do not define uintptr_t.
570 * However, this does not work on modern compilers:
571 * The C++ standard does not define pointer overflow, and allows compilers to
572 * assume that p+u>p for any pointer p and any integer u>0.
573 * Thus, modern compilers optimize away the ">" comparison.
574 * (See ICU tickets #7187 and #8096.)
576 # define U_MAX_PTR(base) \
577 ((void *)(((char *)(base)+0x7fffffffu) > (char *)(base) \
578 ? ((char *)(base)+0x7fffffffu) \
581 /* Default version. C++ standard compliant for scalar pointers. */
582 # define U_MAX_PTR(base) \
583 ((void *)(((uintptr_t)(base)+0x7fffffffu) > (uintptr_t)(base) \
584 ? ((uintptr_t)(base)+0x7fffffffu) \
589 /* Dynamic Library Functions */
591 typedef void (UVoidFunction
)(void);
596 * @internal (ICU 4.4)
598 U_INTERNAL
void * U_EXPORT2
uprv_dl_open(const char *libName
, UErrorCode
*status
);
602 * @internal (ICU 4.4)
604 U_INTERNAL
void U_EXPORT2
uprv_dl_close( void *lib
, UErrorCode
*status
);
607 * Extract a symbol from a library (function)
608 * @internal (ICU 4.8)
610 U_INTERNAL UVoidFunction
* U_EXPORT2
uprv_dlsym_func( void *lib
, const char *symbolName
, UErrorCode
*status
);
613 * Extract a symbol from a library (function)
614 * Not implemented, no clients.
617 /* U_INTERNAL void * U_EXPORT2 uprv_dlsym_data( void *lib, const char *symbolName, UErrorCode *status); */
622 * Define malloc and related functions
625 #if U_PLATFORM == U_PF_OS400
626 # define uprv_default_malloc(x) _C_TS_malloc(x)
627 # define uprv_default_realloc(x,y) _C_TS_realloc(x,y)
628 # define uprv_default_free(x) _C_TS_free(x)
629 /* also _C_TS_calloc(x) */
632 # define uprv_default_malloc(x) malloc(x)
633 # define uprv_default_realloc(x,y) realloc(x,y)
634 # define uprv_default_free(x) free(x)