[deliverable/binutils-gdb.git] / libdecnumber / decDouble.h

/* decDouble module header for the decNumber C Library.
   Copyright (C) 2007-2018 Free Software Foundation, Inc.
   Contributed by IBM Corporation.  Author Mike Cowlishaw.

   This file is part of GCC.

   GCC is free software; you can redistribute it and/or modify it under
   the terms of the GNU General Public License as published by the Free
   Software Foundation; either version 3, or (at your option) any later
   version.

   GCC is distributed in the hope that it will be useful, but WITHOUT ANY
   WARRANTY; without even the implied warranty of MERCHANTABILITY or
   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
   for more details.

Under Section 7 of GPL version 3, you are granted additional
permissions described in the GCC Runtime Library Exception, version
3.1, as published by the Free Software Foundation.

You should have received a copy of the GNU General Public License and
a copy of the GCC Runtime Library Exception along with this program;
see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
<http://www.gnu.org/licenses/>.  */

/* ------------------------------------------------------------------ */
/* decDouble.h -- Decimal 64-bit format module header		      */
/* ------------------------------------------------------------------ */

#if !defined(DECDOUBLE)
  #define DECDOUBLE

  #define DECDOUBLENAME       "decimalDouble"	      /* Short name   */
  #define DECDOUBLETITLE      "Decimal 64-bit datum"  /* Verbose name */
  #define DECDOUBLEAUTHOR     "Mike Cowlishaw"	      /* Who to blame */

  /* parameters for decDoubles */
  #define DECDOUBLE_Bytes   8	   /* length			      */
  #define DECDOUBLE_Pmax    16	   /* maximum precision (digits)      */
  #define DECDOUBLE_Emin   -383    /* minimum adjusted exponent       */
  #define DECDOUBLE_Emax    384    /* maximum adjusted exponent       */
  #define DECDOUBLE_EmaxD   3	   /* maximum exponent digits	      */
  #define DECDOUBLE_Bias    398    /* bias for the exponent	      */
  #define DECDOUBLE_String  25	   /* maximum string length, +1       */
  #define DECDOUBLE_EconL   8	   /* exponent continuation length    */
  #define DECDOUBLE_Declets 5	   /* count of declets		      */
  /* highest biased exponent (Elimit-1) */
  #define DECDOUBLE_Ehigh (DECDOUBLE_Emax + DECDOUBLE_Bias - (DECDOUBLE_Pmax-1))

  /* Required includes						      */
  #include "decContext.h"
  #include "decQuad.h"

  /* The decDouble decimal 64-bit type, accessible by all sizes */
  typedef union {
    uint8_t   bytes[DECDOUBLE_Bytes];	/* fields: 1, 5, 8, 50 bits */
    uint16_t shorts[DECDOUBLE_Bytes/2];
    uint32_t  words[DECDOUBLE_Bytes/4];
    #if DECUSE64
    uint64_t  longs[DECDOUBLE_Bytes/8];
    #endif
    } decDouble;

  /* ---------------------------------------------------------------- */
  /* Routines -- implemented as decFloat routines in common files     */
  /* ---------------------------------------------------------------- */

  #include "decDoubleSymbols.h"

  /* Utilities and conversions, extractors, etc.) */
  extern decDouble * decDoubleFromBCD(decDouble *, int32_t, const uint8_t *, int32_t);
  extern decDouble * decDoubleFromInt32(decDouble *, int32_t);
  extern decDouble * decDoubleFromPacked(decDouble *, int32_t, const uint8_t *);
  extern decDouble * decDoubleFromPackedChecked(decDouble *, int32_t, const uint8_t *);
  extern decDouble * decDoubleFromString(decDouble *, const char *, decContext *);
  extern decDouble * decDoubleFromUInt32(decDouble *, uint32_t);
  extern decDouble * decDoubleFromWider(decDouble *, const decQuad *, decContext *);
  extern int32_t     decDoubleGetCoefficient(const decDouble *, uint8_t *);
  extern int32_t     decDoubleGetExponent(const decDouble *);
  extern decDouble * decDoubleSetCoefficient(decDouble *, const uint8_t *, int32_t);
  extern decDouble * decDoubleSetExponent(decDouble *, decContext *, int32_t);
  extern void	     decDoubleShow(const decDouble *, const char *);
  extern int32_t     decDoubleToBCD(const decDouble *, int32_t *, uint8_t *);
  extern char	   * decDoubleToEngString(const decDouble *, char *);
  extern int32_t     decDoubleToInt32(const decDouble *, decContext *, enum rounding);
  extern int32_t     decDoubleToInt32Exact(const decDouble *, decContext *, enum rounding);
  extern int32_t     decDoubleToPacked(const decDouble *, int32_t *, uint8_t *);
  extern char	   * decDoubleToString(const decDouble *, char *);
  extern uint32_t    decDoubleToUInt32(const decDouble *, decContext *, enum rounding);
  extern uint32_t    decDoubleToUInt32Exact(const decDouble *, decContext *, enum rounding);
  extern decQuad   * decDoubleToWider(const decDouble *, decQuad *);
  extern decDouble * decDoubleZero(decDouble *);

  /* Computational (result is a decDouble) */
  extern decDouble * decDoubleAbs(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleAdd(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleAnd(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleDivide(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleDivideInteger(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleFMA(decDouble *, const decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleInvert(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleLogB(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMax(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMaxMag(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMin(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMinMag(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMinus(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleMultiply(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleNextMinus(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleNextPlus(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleNextToward(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleOr(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoublePlus(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleQuantize(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleReduce(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleRemainder(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleRemainderNear(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleRotate(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleScaleB(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleShift(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleSubtract(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleToIntegralValue(decDouble *, const decDouble *, decContext *, enum rounding);
  extern decDouble * decDoubleToIntegralExact(decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleXor(decDouble *, const decDouble *, const decDouble *, decContext *);

  /* Comparisons */
  extern decDouble * decDoubleCompare(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleCompareSignal(decDouble *, const decDouble *, const decDouble *, decContext *);
  extern decDouble * decDoubleCompareTotal(decDouble *, const decDouble *, const decDouble *);
  extern decDouble * decDoubleCompareTotalMag(decDouble *, const decDouble *, const decDouble *);

  /* Copies */
  extern decDouble * decDoubleCanonical(decDouble *, const decDouble *);
  extern decDouble * decDoubleCopy(decDouble *, const decDouble *);
  extern decDouble * decDoubleCopyAbs(decDouble *, const decDouble *);
  extern decDouble * decDoubleCopyNegate(decDouble *, const decDouble *);
  extern decDouble * decDoubleCopySign(decDouble *, const decDouble *, const decDouble *);

  /* Non-computational */
  extern enum decClass decDoubleClass(const decDouble *);
  extern const char *  decDoubleClassString(const decDouble *);
  extern uint32_t      decDoubleDigits(const decDouble *);
  extern uint32_t      decDoubleIsCanonical(const decDouble *);
  extern uint32_t      decDoubleIsFinite(const decDouble *);
  extern uint32_t      decDoubleIsInfinite(const decDouble *);
  extern uint32_t      decDoubleIsInteger(const decDouble *);
  extern uint32_t      decDoubleIsNaN(const decDouble *);
  extern uint32_t      decDoubleIsNormal(const decDouble *);
  extern uint32_t      decDoubleIsSignaling(const decDouble *);
  extern uint32_t      decDoubleIsSignalling(const decDouble *);
  extern uint32_t      decDoubleIsSigned(const decDouble *);
  extern uint32_t      decDoubleIsSubnormal(const decDouble *);
  extern uint32_t      decDoubleIsZero(const decDouble *);
  extern uint32_t      decDoubleRadix(const decDouble *);
  extern uint32_t      decDoubleSameQuantum(const decDouble *, const decDouble *);
  extern const char *  decDoubleVersion(void);

  /* decNumber conversions; these are implemented as macros so as not  */
  /* to force a dependency on decimal64 and decNumber in decDouble.    */
  /* decDoubleFromNumber returns a decimal64 * to avoid warnings.      */
  #define decDoubleToNumber(dq, dn) decimal64ToNumber((decimal64 *)(dq), dn)
  #define decDoubleFromNumber(dq, dn, set) decimal64FromNumber((decimal64 *)(dq), dn, set)

#endif
Commit	Line	Data
f5bc1778	1	/* decDouble module header for the decNumber C Library.
f57a3bca	2	Copyright (C) 2007-2018 Free Software Foundation, Inc.
f5bc1778 DJ	3	Contributed by IBM Corporation. Author Mike Cowlishaw.
	4
	5	This file is part of GCC.
	6
	7	GCC is free software; you can redistribute it and/or modify it under
	8	the terms of the GNU General Public License as published by the Free
168a2f77	9	Software Foundation; either version 3, or (at your option) any later
f5bc1778 DJ	10	version.
f5bc1778 DJ	11
f5bc1778 DJ	12	GCC is distributed in the hope that it will be useful, but WITHOUT ANY
	13	WARRANTY; without even the implied warranty of MERCHANTABILITY or
	14	FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	15	for more details.
	16
168a2f77 DD	17	Under Section 7 of GPL version 3, you are granted additional
	18	permissions described in the GCC Runtime Library Exception, version
	19	3.1, as published by the Free Software Foundation.
	20
	21	You should have received a copy of the GNU General Public License and
	22	a copy of the GCC Runtime Library Exception along with this program;
	23	see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
	24	<http://www.gnu.org/licenses/>. */
f5bc1778 DJ	25
	26	/* ------------------------------------------------------------------ */
	27	/* decDouble.h -- Decimal 64-bit format module header */
	28	/* ------------------------------------------------------------------ */
f5bc1778 DJ	29
	30	#if !defined(DECDOUBLE)
	31	#define DECDOUBLE
	32
87d32bb7	33	#define DECDOUBLENAME "decimalDouble" /* Short name */
f5bc1778 DJ	34	#define DECDOUBLETITLE "Decimal 64-bit datum" /* Verbose name */
	35	#define DECDOUBLEAUTHOR "Mike Cowlishaw" /* Who to blame */
	36
	37	/* parameters for decDoubles */
	38	#define DECDOUBLE_Bytes 8 /* length */
	39	#define DECDOUBLE_Pmax 16 /* maximum precision (digits) */
87d32bb7 DD	40	#define DECDOUBLE_Emin -383 /* minimum adjusted exponent */
87d32bb7 DD	41	#define DECDOUBLE_Emax 384 /* maximum adjusted exponent */
f5bc1778	42	#define DECDOUBLE_EmaxD 3 /* maximum exponent digits */
87d32bb7 DD	43	#define DECDOUBLE_Bias 398 /* bias for the exponent */
87d32bb7 DD	44	#define DECDOUBLE_String 25 /* maximum string length, +1 */
f5bc1778 DJ	45	#define DECDOUBLE_EconL 8 /* exponent continuation length */
	46	#define DECDOUBLE_Declets 5 /* count of declets */
	47	/* highest biased exponent (Elimit-1) */
	48	#define DECDOUBLE_Ehigh (DECDOUBLE_Emax + DECDOUBLE_Bias - (DECDOUBLE_Pmax-1))
	49
	50	/* Required includes */
	51	#include "decContext.h"
	52	#include "decQuad.h"
	53
87d32bb7	54	/* The decDouble decimal 64-bit type, accessible by all sizes */
aed1add3	55	typedef union {
87d32bb7	56	uint8_t bytes[DECDOUBLE_Bytes]; /* fields: 1, 5, 8, 50 bits */
aed1add3	57	uint16_t shorts[DECDOUBLE_Bytes/2];
87d32bb7 DD	58	uint32_t words[DECDOUBLE_Bytes/4];
	59	#if DECUSE64
	60	uint64_t longs[DECDOUBLE_Bytes/8];
	61	#endif
f5bc1778 DJ	62	} decDouble;
	63
	64	/* ---------------------------------------------------------------- */
	65	/* Routines -- implemented as decFloat routines in common files */
	66	/* ---------------------------------------------------------------- */
	67
	68	#include "decDoubleSymbols.h"
	69
	70	/* Utilities and conversions, extractors, etc.) */
	71	extern decDouble * decDoubleFromBCD(decDouble , int32_t, const uint8_t , int32_t);
	72	extern decDouble * decDoubleFromInt32(decDouble *, int32_t);
	73	extern decDouble * decDoubleFromPacked(decDouble , int32_t, const uint8_t );
87d32bb7	74	extern decDouble * decDoubleFromPackedChecked(decDouble , int32_t, const uint8_t );
f5bc1778 DJ	75	extern decDouble * decDoubleFromString(decDouble , const char , decContext *);
	76	extern decDouble * decDoubleFromUInt32(decDouble *, uint32_t);
	77	extern decDouble * decDoubleFromWider(decDouble , const decQuad , decContext *);
	78	extern int32_t decDoubleGetCoefficient(const decDouble , uint8_t );
	79	extern int32_t decDoubleGetExponent(const decDouble *);
	80	extern decDouble * decDoubleSetCoefficient(decDouble , const uint8_t , int32_t);
	81	extern decDouble * decDoubleSetExponent(decDouble , decContext , int32_t);
	82	extern void decDoubleShow(const decDouble , const char );
	83	extern int32_t decDoubleToBCD(const decDouble , int32_t , uint8_t *);
	84	extern char * decDoubleToEngString(const decDouble , char );
	85	extern int32_t decDoubleToInt32(const decDouble , decContext , enum rounding);
	86	extern int32_t decDoubleToInt32Exact(const decDouble , decContext , enum rounding);
	87	extern int32_t decDoubleToPacked(const decDouble , int32_t , uint8_t *);
	88	extern char * decDoubleToString(const decDouble , char );
	89	extern uint32_t decDoubleToUInt32(const decDouble , decContext , enum rounding);
	90	extern uint32_t decDoubleToUInt32Exact(const decDouble , decContext , enum rounding);
	91	extern decQuad * decDoubleToWider(const decDouble , decQuad );
	92	extern decDouble * decDoubleZero(decDouble *);
	93
	94	/* Computational (result is a decDouble) */
	95	extern decDouble * decDoubleAbs(decDouble , const decDouble , decContext *);
	96	extern decDouble * decDoubleAdd(decDouble , const decDouble , const decDouble , decContext );
	97	extern decDouble * decDoubleAnd(decDouble , const decDouble , const decDouble , decContext );
	98	extern decDouble * decDoubleDivide(decDouble , const decDouble , const decDouble , decContext );
	99	extern decDouble * decDoubleDivideInteger(decDouble , const decDouble , const decDouble , decContext );
	100	extern decDouble * decDoubleFMA(decDouble , const decDouble , const decDouble , const decDouble , decContext *);
	101	extern decDouble * decDoubleInvert(decDouble , const decDouble , decContext *);
	102	extern decDouble * decDoubleLogB(decDouble , const decDouble , decContext *);
	103	extern decDouble * decDoubleMax(decDouble , const decDouble , const decDouble , decContext );
	104	extern decDouble * decDoubleMaxMag(decDouble , const decDouble , const decDouble , decContext );
	105	extern decDouble * decDoubleMin(decDouble , const decDouble , const decDouble , decContext );
	106	extern decDouble * decDoubleMinMag(decDouble , const decDouble , const decDouble , decContext );
	107	extern decDouble * decDoubleMinus(decDouble , const decDouble , decContext *);
	108	extern decDouble * decDoubleMultiply(decDouble , const decDouble , const decDouble , decContext );
	109	extern decDouble * decDoubleNextMinus(decDouble , const decDouble , decContext *);
	110	extern decDouble * decDoubleNextPlus(decDouble , const decDouble , decContext *);
	111	extern decDouble * decDoubleNextToward(decDouble , const decDouble , const decDouble , decContext );
	112	extern decDouble * decDoubleOr(decDouble , const decDouble , const decDouble , decContext );
	113	extern decDouble * decDoublePlus(decDouble , const decDouble , decContext *);
	114	extern decDouble * decDoubleQuantize(decDouble , const decDouble , const decDouble , decContext );
	115	extern decDouble * decDoubleReduce(decDouble , const decDouble , decContext *);
	116	extern decDouble * decDoubleRemainder(decDouble , const decDouble , const decDouble , decContext );
	117	extern decDouble * decDoubleRemainderNear(decDouble , const decDouble , const decDouble , decContext );
	118	extern decDouble * decDoubleRotate(decDouble , const decDouble , const decDouble , decContext );
	119	extern decDouble * decDoubleScaleB(decDouble , const decDouble , const decDouble , decContext );
	120	extern decDouble * decDoubleShift(decDouble , const decDouble , const decDouble , decContext );
	121	extern decDouble * decDoubleSubtract(decDouble , const decDouble , const decDouble , decContext );
	122	extern decDouble * decDoubleToIntegralValue(decDouble , const decDouble , decContext *, enum rounding);
	123	extern decDouble * decDoubleToIntegralExact(decDouble , const decDouble , decContext *);
	124	extern decDouble * decDoubleXor(decDouble , const decDouble , const decDouble , decContext );
	125
	126	/* Comparisons */
	127	extern decDouble * decDoubleCompare(decDouble , const decDouble , const decDouble , decContext );
	128	extern decDouble * decDoubleCompareSignal(decDouble , const decDouble , const decDouble , decContext );
	129	extern decDouble * decDoubleCompareTotal(decDouble , const decDouble , const decDouble *);
	130	extern decDouble * decDoubleCompareTotalMag(decDouble , const decDouble , const decDouble *);
	131
	132	/* Copies */
	133	extern decDouble * decDoubleCanonical(decDouble , const decDouble );
	134	extern decDouble * decDoubleCopy(decDouble , const decDouble );
	135	extern decDouble * decDoubleCopyAbs(decDouble , const decDouble );
	136	extern decDouble * decDoubleCopyNegate(decDouble , const decDouble );
	137	extern decDouble * decDoubleCopySign(decDouble , const decDouble , const decDouble *);
	138
139	/* Non-computational */
140	extern enum decClass decDoubleClass(const decDouble *);
141	extern const char * decDoubleClassString(const decDouble *);
142	extern uint32_t decDoubleDigits(const decDouble *);
143	extern uint32_t decDoubleIsCanonical(const decDouble *);
144	extern uint32_t decDoubleIsFinite(const decDouble *);
145	extern uint32_t decDoubleIsInfinite(const decDouble *);
146	extern uint32_t decDoubleIsInteger(const decDouble *);
147	extern uint32_t decDoubleIsNaN(const decDouble *);
148	extern uint32_t decDoubleIsNormal(const decDouble *);
149	extern uint32_t decDoubleIsSignaling(const decDouble *);
150	extern uint32_t decDoubleIsSignalling(const decDouble *);
151	extern uint32_t decDoubleIsSigned(const decDouble *);
152	extern uint32_t decDoubleIsSubnormal(const decDouble *);
153	extern uint32_t decDoubleIsZero(const decDouble *);
154	extern uint32_t decDoubleRadix(const decDouble *);
155	extern uint32_t decDoubleSameQuantum(const decDouble , const decDouble );
156	extern const char * decDoubleVersion(void);
157
158	/* decNumber conversions; these are implemented as macros so as not */
159	/* to force a dependency on decimal64 and decNumber in decDouble. */
87d32bb7	160	/* decDoubleFromNumber returns a decimal64 * to avoid warnings. */
f5bc1778	161	#define decDoubleToNumber(dq, dn) decimal64ToNumber((decimal64 *)(dq), dn)
87d32bb7	162	#define decDoubleFromNumber(dq, dn, set) decimal64FromNumber((decimal64 *)(dq), dn, set)
f5bc1778 DJ	163
f5bc1778 DJ	164	#endif