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         @since 2.7.0
 138     */
 139     wxLongLong& operator operator=(const wxULongLong& ll);
 140 };
 141
 142
 143
 144 // ============================================================================
 145 // Global functions/macros
 146 // ============================================================================
 147
 148 /** @ingroup group_funcmacro_misc */
 149 //@{
 150
 151 /**
 152     This macro is defined to contain the @c printf() format specifier using
 153     which 64 bit integer numbers (i.e. those of type @c wxLongLong_t) can be
 154     printed. Example of using it:
 155
 156     @code
 157     #ifdef wxLongLong_t
 158         wxLongLong_t ll = wxLL(0x1234567890abcdef);
 159         printf("Long long = %" wxLongLongFmtSpec "x\n", ll);
 160     #endif
 161     @endcode
 162
 163     @see wxLL()
 164
 165     @header{wx/longlong.h}
 166 */
 167 #define wxLongLongFmtSpec
 168
 169 /**
 170     This macro is defined for the platforms with a native 64 bit integer type
 171     and allow the use of 64 bit compile time constants:
 172
 173     @code
 174     #ifdef wxLongLong_t
 175         wxLongLong_t ll = wxLL(0x1234567890abcdef);
 176     #endif
 177     @endcode
 178
 179     @see wxULL(), wxLongLong
 180
 181     @header{wx/longlong.h}
 182 */
 183 wxLongLong_t wxLL(number);
 184
 185 /**
 186     This macro is defined for the platforms with a native 64 bit integer type
 187     and allow the use of 64 bit compile time constants:
 188
 189     @code
 190     #ifdef wxLongLong_t
 191         unsigned wxLongLong_t ll = wxULL(0x1234567890abcdef);
 192     #endif
 193     @endcode
 194
 195     @see wxLL(), wxLongLong
 196
 197     @header{wx/longlong.h}
 198 */
 199 wxLongLong_t wxULL(number);
 200
 201 //@}
 202