putilimp.h revision 27f654740f2a26ad62a5c155af9199af9e69b889
1b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/* 2b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru****************************************************************************** 3b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* 450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho* Copyright (C) 1997-2010, International Business Machines 5b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* Corporation and others. All Rights Reserved. 6b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* 7b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru****************************************************************************** 8b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* 9b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* FILE NAME : putilimp.h 10b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* 11b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* Date Name Description 12b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* 10/17/04 grhoten Move internal functions from putil.h to this file. 13b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru****************************************************************************** 14b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*/ 15b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 16b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#ifndef PUTILIMP_H 17b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#define PUTILIMP_H 18b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 19b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/utypes.h" 20b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/putil.h" 21b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 22b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/*==========================================================================*/ 23b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/* Platform utilities */ 24b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/*==========================================================================*/ 25b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 26b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 27b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Platform utilities isolates the platform dependencies of the 28b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * libarary. For each platform which this code is ported to, these 29b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * functions may have to be re-implemented. 30b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 31b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 32b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 33b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to determine if a double is Not a Number (NaN). 34b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 35b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 36b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UBool U_EXPORT2 uprv_isNaN(double d); 37b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 38b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to determine if a double has an infinite value. 39b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 40b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 41b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UBool U_EXPORT2 uprv_isInfinite(double d); 42b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 43b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to determine if a double has a positive infinite value. 44b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 45b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 46b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UBool U_EXPORT2 uprv_isPositiveInfinity(double d); 47b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 48b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to determine if a double has a negative infinite value. 49b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 50b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 51b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UBool U_EXPORT2 uprv_isNegativeInfinity(double d); 52b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 53b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility that returns a Not a Number (NaN) value. 54b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 55b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 56b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_getNaN(void); 57b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 58b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility that returns an infinite value. 59b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 60b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 61b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_getInfinity(void); 62b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 63b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 64b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to truncate a double. 65b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 66b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 67b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_trunc(double d); 68b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 69b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the floor of a double. 70b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 71b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 72b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_floor(double d); 73b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 74b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the ceiling of a double. 75b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 76b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 77b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_ceil(double d); 78b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 79b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the absolute value of a double. 80b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 81b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 82b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_fabs(double d); 83b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 84b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the fractional and integer parts of a double. 85b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 86b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 87b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_modf(double d, double* pinteger); 88b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 89b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the remainder of a double divided by another double. 90b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 91b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 92b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_fmod(double d, double y); 93b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 94b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate d to the power of exponent (d^exponent). 95b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 96b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 97b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_pow(double d, double exponent); 98b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 99b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate 10 to the power of exponent (10^exponent). 100b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 101b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 102b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_pow10(int32_t exponent); 103b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 104b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the maximum value of two doubles. 105b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 106b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 107b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_fmax(double d, double y); 108b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 109b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the minimum value of two doubles. 110b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 111b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 112b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_fmin(double d, double y); 113b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 114b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Private utility to calculate the maximum value of two integers. 115b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 116b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 117b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL int32_t U_EXPORT2 uprv_max(int32_t d, int32_t y); 118b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 119b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Private utility to calculate the minimum value of two integers. 120b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 121b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 122b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL int32_t U_EXPORT2 uprv_min(int32_t d, int32_t y); 123b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 124b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#if U_IS_BIG_ENDIAN 125b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define uprv_isNegative(number) (*((signed char *)&(number))<0) 126b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#else 127b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define uprv_isNegative(number) (*((signed char *)&(number)+sizeof(number)-1)<0) 128b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif 129b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 130b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 131b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Return the largest positive number that can be represented by an integer 132b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * type of arbitrary bit length. 133b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 134b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 135b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_maxMantissa(void); 136b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 137b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 138b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Floating point utility to calculate the logarithm of a double. 139b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 140b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 141b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_log(double d); 142b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 143b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 144b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Does common notion of rounding e.g. uprv_floor(x + 0.5); 145b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @param x the double number 146b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @return the rounded double 147b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 148b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 149b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL double U_EXPORT2 uprv_round(double x); 150b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 151b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#if 0 152b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 153b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Returns the number of digits after the decimal point in a double number x. 154b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 155b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @param x the double number 156b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @return the number of digits after the decimal point in a double number x. 157b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 158b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 159b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/*U_INTERNAL int32_t U_EXPORT2 uprv_digitsAfterDecimal(double x);*/ 160b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif 161b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 162b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 163b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Time zone utilities 164b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 165b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Wrappers for C runtime library functions relating to timezones. 166b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru * The t_tzset() function (similar to tzset) uses the current setting 167b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru * of the environment variable TZ to assign values to three global 168b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru * variables: daylight, timezone, and tzname. These variables have the 169b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * following meanings, and are declared in <time.h>. 170b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 171b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * daylight Nonzero if daylight-saving-time zone (DST) is specified 172b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * in TZ; otherwise, 0. Default value is 1. 173b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * timezone Difference in seconds between coordinated universal 174b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * time and local time. E.g., -28,800 for PST (GMT-8hrs) 175b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(0) Three-letter time-zone name derived from TZ environment 176b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * variable. E.g., "PST". 177b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(1) Three-letter DST zone name derived from TZ environment 178b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * variable. E.g., "PDT". If DST zone is omitted from TZ, 179b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(1) is an empty string. 180b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 181b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Notes: For example, to set the TZ environment variable to correspond 182b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * to the current time zone in Germany, you can use one of the 183b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * following statements: 184b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 185b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * set TZ=GST1GDT 186b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * set TZ=GST+1GDT 187b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 188b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * If the TZ value is not set, t_tzset() attempts to use the time zone 189b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * information specified by the operating system. Under Windows NT 190b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * and Windows 95, this information is specified in the Control Panel's 191b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Date/Time application. 192b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 193b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 194b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL void U_EXPORT2 uprv_tzset(void); 195b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 196b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 197b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Difference in seconds between coordinated universal 198b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * time and local time. E.g., -28,800 for PST (GMT-8hrs) 199b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @return the difference in seconds between coordinated universal time and local time. 200b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 201b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 202b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL int32_t U_EXPORT2 uprv_timezone(void); 203b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 204b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 205b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(0) Three-letter time-zone name derived from TZ environment 206b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * variable. E.g., "PST". 207b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(1) Three-letter DST zone name derived from TZ environment 208b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * variable. E.g., "PDT". If DST zone is omitted from TZ, 209b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * tzname(1) is an empty string. 210b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 211b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 212b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL const char* U_EXPORT2 uprv_tzname(int n); 213b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 214b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 215b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Get UTC (GMT) time measured in milliseconds since 0:00 on 1/1/1970. 21627f654740f2a26ad62a5c155af9199af9e69b889claireho * This function is affected by 'faketime' and should be the bottleneck for all user-visible ICU time functions. 217b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru * @return the UTC time measured in milliseconds 218b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 219b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 220b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UDate U_EXPORT2 uprv_getUTCtime(void); 221b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 222b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 22327f654740f2a26ad62a5c155af9199af9e69b889claireho * Get UTC (GMT) time measured in milliseconds since 0:00 on 1/1/1970. 22427f654740f2a26ad62a5c155af9199af9e69b889claireho * This function is not affected by 'faketime', so it should only be used by low level test functions- not by anything that 22527f654740f2a26ad62a5c155af9199af9e69b889claireho * exposes time to the end user. 22627f654740f2a26ad62a5c155af9199af9e69b889claireho * @return the UTC time measured in milliseconds 22727f654740f2a26ad62a5c155af9199af9e69b889claireho * @internal 22827f654740f2a26ad62a5c155af9199af9e69b889claireho */ 22927f654740f2a26ad62a5c155af9199af9e69b889clairehoU_INTERNAL UDate U_EXPORT2 uprv_getRawUTCtime(void); 23027f654740f2a26ad62a5c155af9199af9e69b889claireho 23127f654740f2a26ad62a5c155af9199af9e69b889claireho/** 232b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Determine whether a pathname is absolute or not, as defined by the platform. 233b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @param path Pathname to test 234b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @return TRUE if the path is absolute 235b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal (ICU 3.0) 236b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 237b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL UBool U_EXPORT2 uprv_pathIsAbsolute(const char *path); 238b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 239b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 240b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Use U_MAX_PTR instead of this function. 241b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @param void pointer to test 242b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @return the largest possible pointer greater than the base 243b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal (ICU 3.8) 244b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 245b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_INTERNAL void * U_EXPORT2 uprv_maximumPtr(void *base); 246b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 247b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/** 248b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Maximum value of a (void*) - use to indicate the limit of an 'infinite' buffer. 249b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * In fact, buffer sizes must not exceed 2GB so that the difference between 250b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * the buffer limit and the buffer start can be expressed in an int32_t. 251b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 252b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * The definition of U_MAX_PTR must fulfill the following conditions: 253b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * - return the largest possible pointer greater than base 254b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * - return a valid pointer according to the machine architecture (AS/400, 64-bit, etc.) 255b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * - avoid wrapping around at high addresses 256b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * - make sure that the returned pointer is not farther from base than 0x7fffffff 257b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * 258b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @param base The beginning of a buffer to find the maximum offset from 259b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * @internal 260b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 261b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#ifndef U_MAX_PTR 262b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# if defined(OS390) && !defined(_LP64) 263b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru /* We have 31-bit pointers. */ 264b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define U_MAX_PTR(base) ((void *)0x7fffffff) 265b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# elif defined(OS400) 266b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define U_MAX_PTR(base) uprv_maximumPtr((void *)base) 267b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# elif defined(__GNUC__) && __GNUC__ >= 4 268b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/* 269b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Due to a compiler optimization bug, gcc 4 causes test failures when doing 270b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * this math arithmetic on pointers on some platforms. It seems like the 271b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * pointers are considered signed instead of unsigned. The uintptr_t type 272b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * isn't available on all platforms (i.e MSVC 6) and pointers aren't always 273b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * a scalar value (i.e. i5/OS see uprv_maximumPtr function). 274b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */ 275b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define U_MAX_PTR(base) \ 276b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru ((void *)(((uintptr_t)(base)+0x7fffffffu) > (uintptr_t)(base) \ 277b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru ? ((uintptr_t)(base)+0x7fffffffu) \ 278b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru : (uintptr_t)-1)) 279b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# else 280b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# define U_MAX_PTR(base) \ 281b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru ((char *)(((char *)(base)+0x7fffffffu) > (char *)(base) \ 282b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru ? ((char *)(base)+0x7fffffffu) \ 283b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru : (char *)-1)) 284b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru# endif 285b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif 286b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru 28750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho#if U_ENABLE_DYLOAD 28850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho/* Dynamic Library Functions */ 28950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho 29050294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho/** 29150294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * Load a library 29250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * @internal (ICU 4.4) 29350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho */ 29450294ead5e5d23f5bbfed76e00e6b510bd41eee1clairehoU_INTERNAL void * U_EXPORT2 uprv_dl_open(const char *libName, UErrorCode *status); 29550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho 29650294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho/** 29750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * Close a library 29850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * @internal (ICU 4.4) 29950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho */ 30050294ead5e5d23f5bbfed76e00e6b510bd41eee1clairehoU_INTERNAL void U_EXPORT2 uprv_dl_close( void *lib, UErrorCode *status); 30150294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho 30250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho/** 30350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * Extract a symbol from a library 30450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho * @internal (ICU 4.4) 30550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho */ 30650294ead5e5d23f5bbfed76e00e6b510bd41eee1clairehoU_INTERNAL void * U_EXPORT2 uprv_dl_sym( void *lib, const char *symbolName, UErrorCode *status); 30750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho 30850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho#endif 30950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho 310b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif 311