/*
*******************************************************************************
* *
* 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
/**
* Convert char characters to UChar characters.
* This utility function is useful only for "invariant characters"
* that are encoded in the platform default encoding.
* They are a small, constant subset of the encoding and include
* just the latin letters, digits, and some punctuation.
* For details, see utypes.h .
*
* @param cs Input string, points to length
* character bytes from a subset of the platform encoding.
* @param us Output string, points to memory for length
* Unicode characters.
* @param length The number of characters to convert; this may
* include the terminating NUL.
*/
U_CAPI void U_EXPORT2
u_charsToUChars(const char *cs, UChar *us, UTextOffset length);
/**
* Convert UChar characters to char characters.
* This utility function is useful only for "invariant characters"
* that can be encoded in the platform default encoding.
* They are a small, constant subset of the encoding and include
* just the latin letters, digits, and some punctuation.
* For details, see utypes.h .
*
* @param us Input string, points to length
* Unicode characters that can be encoded with the
* codepage-invariant subset of the platform encoding.
* @param cs Output string, points to memory for length
* character bytes.
* @param length The number of characters to convert; this may
* include the terminating NUL.
*/
U_CAPI void U_EXPORT2
u_UCharsToChars(const UChar *us, char *cs, UTextOffset length);
#endif