interface/longlong.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        longlong.h
   3 // Purpose:     interface of wxLongLong
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10     @class wxLongLong
  11     @wxheader{longlong.h}
  12
  13     This class represents a signed 64 bit long number. It is implemented using the
  14     native 64 bit type where available (machines with 64 bit longs or compilers
  15     which have (an analog of) @e long long type) and uses the emulation code in
  16     the other cases which ensures that it is the most efficient solution for
  17     working with 64 bit integers independently of the architecture.
  18
  19     wxLongLong defines all usual arithmetic operations such as addition,
  20     subtraction, bitwise shifts and logical operations as well as multiplication
  21     and division (not yet for the machines without native @e long long). It
  22     also has operators for implicit construction from and conversion to the native
  23     @e long long type if it exists and @e long.
  24
  25     You would usually use this type in exactly the same manner as any other
  26     (built-in) arithmetic type. Note that wxLongLong is a signed type, if you
  27     want unsigned values use wxULongLong which has exactly the same API as
  28     wxLongLong except when explicitly mentioned otherwise.
  29
  30     If a native (i.e. supported directly by the compiler) 64 bit integer type was
  31     found to exist, @e wxLongLong_t macro will be defined to correspond to it.
  32     Also, in this case only, two additional macros will be defined:
  33     wxLongLongFmtSpec() for printing 64 bit integers
  34     using the standard @c printf() function (but see also
  35     wxLongLong::ToString for a more portable solution) and
  36     wxLL() for defining 64 bit integer compile-time constants.
  37
  38     @library{wxbase}
  39     @category{data}
  40 */
  41 class wxLongLong
  42 {
  43 public:
  44     /**
  45         Constructor from 2 longs: the high and low part are combined into one
  46         wxLongLong.
  47     */
  48     wxLongLong(long hi, unsigned long lo);
  49
  50     //@{
  51     /**
  52         Returns an absolute value of wxLongLong - either making a copy (const version)
  53         or modifying it in place (the second one).  Not in wxULongLong.
  54     */
  55     wxLongLong Abs();
  56     const wxLongLong&  Abs();
  57     //@}
  58
  59     /**
  60         This allows to convert a double value to wxLongLong type. Such conversion is
  61         not always possible in which case the result will be silently truncated in a
  62         platform-dependent way.  Not in wxULongLong.
  63     */
  64     wxLongLong Assign(double d);
  65
  66     /**
  67         Returns the high 32 bits of 64 bit integer.
  68     */
  69     long GetHi() const;
  70
  71     /**
  72         Returns the low 32 bits of 64 bit integer.
  73     */
  74     unsigned long GetLo() const;
  75
  76     /**
  77         Convert to native long long (only for compilers supporting it)
  78     */
  79     wxLongLong_t GetValue() const;
  80
  81     /**
  82         Returns the value as @c double.
  83     */
  84     double ToDouble() const;
  85
  86     /**
  87         Truncate wxLongLong to long. If the conversion loses data (i.e. the wxLongLong
  88         value is outside the range of built-in long type), an assert will be triggered
  89         in debug mode.
  90     */
  91     long ToLong() const;
  92
  93     /**
  94         Returns the string representation of a wxLongLong.
  95     */
  96     wxString ToString() const;
  97
  98     /**
  99         Adds 2 wxLongLongs together and returns the result.
 100     */
 101     wxLongLong operator+(const wxLongLong& ll) const;
 102
 103     //@{
 104     /**
 105         Pre/post increment operator.
 106     */
 107     wxLongLong operator++();
 108     wxLongLong operator++(int );
 109     //@}
 110
 111     /**
 112         Add another wxLongLong to this one.
 113     */
 114     wxLongLong operator+(const wxLongLong& ll);
 115
 116     /**
 117         Subtracts 2 wxLongLongs and returns the result.
 118     */
 119     wxLongLong operator-(const wxLongLong& ll) const;
 120
 121     //@{
 122     /**
 123         Pre/post decrement operator.
 124     */
 125     wxLongLong operator--();
 126     wxLongLong operator--(int );
 127     //@}
 128
 129     /**
 130         Subtracts another wxLongLong from this one.
 131     */
 132     wxLongLong operator-(const wxLongLong& ll);
 133
 134     /**
 135         Assignment operator from unsigned long long. The sign bit will be copied too.
 136
 137         @wxsince{2.7.0}
 138     */
 139     wxLongLong& operator operator=(const wxULongLong& ll);
 140 };
 141
 142
 143
 144 // ============================================================================
 145 // Global functions/macros
 146 // ============================================================================
 147
 148 /**
 149     This macro is defined to contain the @c printf() format specifier using
 150     which 64 bit integer numbers (i.e. those of type @c wxLongLong_t) can be
 151     printed. Example of using it:
 152
 153     @code
 154     #ifdef wxLongLong_t
 155             wxLongLong_t ll = wxLL(0x1234567890abcdef);
 156             printf("Long long = %" wxLongLongFmtSpec "x\n", ll);
 157         #endif
 158     @endcode
 159
 160     @see wxLL()
 161 */
 162
 163
 164 /**
 165     This macro is defined for the platforms with a native 64 bit integer type and
 166     allows to define unsigned 64 bit compile time constants:
 167
 168     @code
 169     #ifdef wxLongLong_t
 170             unsigned wxLongLong_t ll = wxULL(0x1234567890abcdef);
 171         #endif
 172     @endcode
 173
 174     @see wxLL(), wxLongLong
 175 */
 176 wxLongLong_t wxULL(number);
 177
 178 /**
 179     This macro is defined for the platforms with a native 64 bit integer type and
 180     allows to define 64 bit compile time constants:
 181
 182     @code
 183     #ifdef wxLongLong_t
 184             wxLongLong_t ll = wxLL(0x1234567890abcdef);
 185         #endif
 186     @endcode
 187
 188     @see wxULL(), wxLongLong
 189 */
 190 wxLongLong_t wxLL(number);
 191