/* ******************************************************************************* * * * COPYRIGHT: * * (C) Copyright Taligent, Inc., 1997 * * (C) Copyright International Business Machines Corporation, 1997-1999 * * Licensed Material - Program-Property of IBM - All Rights Reserved. * * US Government Users Restricted Rights - Use, duplication, or disclosure * * restricted by GSA ADP Schedule Contract with IBM Corp. * * * ******************************************************************************* * * FILE NAME : putil.h * * Date Name Description * 05/14/98 nos Creation (content moved here from utypes.h). * 06/17/99 erm Added IEEE_754 * 07/22/98 stephen Added IEEEremainder, max, min, trunc * 08/13/98 stephen Added isNegativeInfinity, isPositiveInfinity * 08/24/98 stephen Added longBitsFromDouble * 03/02/99 stephen Removed openFile(). Added AS400 support. * 04/15/99 stephen Converted to C * 11/15/99 helena Integrated S/390 changes for IEEE support. ******************************************************************************* */ #ifndef PUTIL_H #define PUTIL_H #include "utypes.h" /* Define this if your platform supports IEEE 754 floating point */ #define IEEE_754 /*===========================================================================*/ /* Platform utilities */ /*===========================================================================*/ /** * Platform utilities isolates the platform dependencies of the * libarary. For each platform which this code is ported to, these * functions may have to be re-implemented. */ /* Floating point utilities */ U_CAPI bool_t U_EXPORT2 icu_isNaN(double); U_CAPI bool_t U_EXPORT2 icu_isInfinite(double); U_CAPI bool_t U_EXPORT2 icu_isPositiveInfinity(double); U_CAPI bool_t U_EXPORT2 icu_isNegativeInfinity(double); U_CAPI double U_EXPORT2 icu_getNaN(void); U_CAPI double U_EXPORT2 icu_getInfinity(void); U_CAPI double U_EXPORT2 icu_floor(double x); U_CAPI double U_EXPORT2 icu_ceil(double x); U_CAPI double U_EXPORT2 icu_fabs(double x); U_CAPI double U_EXPORT2 icu_modf(double x, double* y); U_CAPI double U_EXPORT2 icu_fmod(double x, double y); U_CAPI double U_EXPORT2 icu_pow10(int32_t x); U_CAPI double U_EXPORT2 icu_IEEEremainder(double x, double y); U_CAPI double U_EXPORT2 icu_fmax(double x, double y); U_CAPI double U_EXPORT2 icu_fmin(double x, double y); U_CAPI int32_t U_EXPORT2 icu_max(int32_t x, int32_t y); U_CAPI int32_t U_EXPORT2 icu_min(int32_t x, int32_t y); U_CAPI double U_EXPORT2 icu_trunc(double d); U_CAPI void U_EXPORT2 icu_longBitsFromDouble(double d, int32_t *hi, uint32_t *lo); #if U_IS_BIG_ENDIAN # define icu_isNegative(number) (*((signed char *)&(number))<0) #else # define icu_isNegative(number) (*((signed char *)&(number)+sizeof(number)-1)<0) #endif /* Conversion from a digit to the character with radix base from 2-19 */ #ifndef OS390 #define T_CString_itosOffset(a) a<=9?(0x30+a):(0x30+a+7) #else #define T_CString_itosOffset(a) a<=9?(0xF0+a):(0xC1+a-10) /* C1 is EBCDIC 'A' */ #endif /* * Return the floor of the log base 10 of a given double. * This method compensates for inaccuracies which arise naturally when * computing logs, and always gives the correct value. The parameter * must be positive and finite. * (Thanks to Alan Liu for supplying this function.) */ /** * Returns the common log of the double value d. * * @param d the double value to apply the common log function for. * @return the log of value d. */ U_CAPI int16_t U_EXPORT2 icu_log10(double d); /** * Returns the number of digits after the decimal point in a double number x. * * @param x the double number */ U_CAPI int32_t U_EXPORT2 icu_digitsAfterDecimal(double x); /** * Time zone utilities * * Wrappers for C runtime library functions relating to timezones. * The t_tzset() function (similar to tzset) uses the current setting * of the environment variable TZ to assign values to three global * variables: daylight, timezone, and tzname. These variables have the * following meanings, and are declared in <time.h>. * * daylight Nonzero if daylight-saving-time zone (DST) is specified * in TZ; otherwise, 0. Default value is 1. * timezone Difference in seconds between coordinated universal * time and local time. E.g., -28,800 for PST (GMT-8hrs) * tzname(0) Three-letter time-zone name derived from TZ environment * variable. E.g., "PST". * tzname(1) Three-letter DST zone name derived from TZ environment * variable. E.g., "PDT". If DST zone is omitted from TZ, * tzname(1) is an empty string. * * Notes: For example, to set the TZ environment variable to correspond * to the current time zone in Germany, you can use one of the * following statements: * * set TZ=GST1GDT * set TZ=GST+1GDT * * If the TZ value is not set, t_tzset() attempts to use the time zone * information specified by the operating system. Under Windows NT * and Windows 95, this information is specified in the Control Panel’s * Date/Time application. */ U_CAPI void U_EXPORT2 icu_tzset(void); U_CAPI int32_t U_EXPORT2 icu_timezone(void); U_CAPI char* U_EXPORT2 icu_tzname(int index); /* Get UTC (GMT) time measured in seconds since 0:00 on 1/1/70. */ U_CAPI int32_t U_EXPORT2 icu_getUTCtime(void); /* Return the data directory for this platform. */ U_CAPI const char* U_EXPORT2 u_getDataDirectory(void); /* Set the data directory. */ U_CAPI void U_EXPORT2 u_setDataDirectory(const char *directory); /* Return the default codepage for this platform and locale */ U_CAPI const char* U_EXPORT2 icu_getDefaultCodepage(void); /* Return the default locale ID string by querying ths system, or zero if one cannot be found. */ U_CAPI const char* U_EXPORT2 icu_getDefaultLocaleID(void); /* * Finds the least double greater than d (if positive == true), * or the greatest double less than d (if positive == false). * * This is a special purpose function defined by the ChoiceFormat API * documentation. * It is not a general purpose function and not defined for NaN or Infinity */ U_CAPI double U_EXPORT2 icu_nextDouble(double d, bool_t positive); /* * Filesystem file and path separator characters. * Example: '/' and ':' on Unix, '\\' and ';' on Windows. */ #ifdef XP_MAC # define U_FILE_SEP_CHAR ':' # define U_PATH_SEP_CHAR ';' # define U_FILE_SEP_STRING ":" # define U_PATH_SEP_STRING ";" #elif defined(WIN32) || defined(OS2) # define U_FILE_SEP_CHAR '\\' # define U_PATH_SEP_CHAR ';' # define U_FILE_SEP_STRING "\\" # define U_PATH_SEP_STRING ";" #else # define U_FILE_SEP_CHAR '/' # define U_PATH_SEP_CHAR ':' # define U_FILE_SEP_STRING "/" # define U_PATH_SEP_STRING ":" #endif #endif