»
Symbian OS v6.1 Edition for C++ »
API Reference »
Basic Types »
TInt64
Location:
e32std.h
Link against: euser.lib
 TInt64
Support
Supported from 5.0
Description
A 64-bit integer.
The class represents the 64 bit integer with a pair of unsigned 32
bit values.
Defined in TInt64:
DivMod(), GetTInt(), GetTReal(), High(), Low(), Lsr(), Mul10(), MulTop(), Set(), TInt64(), operator!=(), operator%(), operator%=(), operator*(), operator*=(), operator+(), operator++(), operator+=(), operator-(), operator--(), operator-=(), operator/(), operator/=(), operator<(), operator<<(), operator<<=(), operator<=(), operator=(), operator==(), operator>(), operator>=(), operator>>(), operator>>=()
Construction
TInt64(TInt aVal);
Description
Constructs the 64 bit integer from the specified signed
integer.
Parameters
| 
| TInt aVal | The signed integer. |  | 
TInt64(TUint aVal);
Description
Constructs the 64 bit integer from the specified unsigned
integer.
Parameters
| 
| TUint aVal | The unsigned integer. |  | 
TInt64(TUint aHigh,TUint aLow);
Description
Constructs the 64 bit integer from two unsigned integers
representing the high value 32 bits and the low value 32
bits.
Parameters
| 
| TUint aHigh | The high value 32 bits forming the 64 bit integer. |  
| TUint aLow | The low value 32 bits forming the 64 bit integer. |  | 
TInt64(TReal aVal);
Description
Constructs the 64 bit integer from the specified double-precision
floating point number.
Parameters
| 
| TReal aVal | The double-precision floating point number. |  | 
void Set(TUint aHigh,TUint aLow);
Description
Sets the 64 bit integer from two unsigned integers representing the
high value 32 bits and the low value 32 bits.
Parameters
| 
| TUint aHigh | The high value 32 bits. |  
| TUint aLow | The low value 32 bits. |  | 
TInt64& operator=(TInt aVal);
TInt64& operator=(TUint aVal);
TInt64& operator=(TReal aVal);
Description
Assigns the 64 bit integer.
Parameters
| 
| TInt aVal | A signed integer. |  
| TUint aVal | An unsigned integer. |  
| TReal aVal | A double-precision floating point number. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TUint Low() const;
Description
Returns the low value 32 bits which form this 64 bit
integer.
Return value
| 
| TUint | The low value 32 bits. |  | 
TUint High() const;
Description
Returns the high value 32 bits which form this 64 bit
integer.
Return value
| 
| TUint | The high value 32 bits. |  | 
TInt GetTInt() const;
Description
Returns the 64 bit integer as a signed integer.
Return value
TReal GetTReal() const;
Description
Returns the 64 bit integer as a double-precision floating point
number.
Return value
| 
| TReal | The double-precision floating point number. |  | 
TInt64& operator+=(const TInt64& aVal);
Description
Adds the specified 64 bit integer to this 64 bit integer and assigns the
result back into this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The value to be added. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator-=(const TInt64& aVal);
Description
Subtracts the specified 64 bit integer from this 64 bit integer and
assigns the result back into this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The value to be subtracted. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator*=(const TInt64& aVal);
Description
Multiplies this 64 bit integer by the specified 64 bit integer and
assigns the result back into this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The multiplier. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator/=(const TInt64& aVal);
Description
Divides this 64 bit integer by the specified 64 bit integer and assigns
the quotient back into this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The divisor. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator%=(const TInt64& aVal);
Description
Modulo (divides) this 64 bit integer by the specified 64 bit integer and
assigns the remainder back into this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The divisor. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator>>=(TInt aShift);
Description
Arithmetically shifts the 64 bit integer to the right by the specified
number of bit positions and assigns the result back into this 64 bit
integer.
Parameters
| 
| TInt aShift | The number of bit positions. to be shifted. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64& operator<<=(TInt aShift);
Description
Arithmetically shifts the 64 bit integer to the left by the specified
number of bit positions and assigns the result back into this 64 bit
integer.
Parameters
| 
| TInt aShift | The number of bit positions to be shifted. |  | 
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64 operator+() const;
Description
Returns the value of this 64 bit integer
Return value
| 
| TInt64 | The 64 bit integer value. |  | 
TInt64 operator-() const;
Description
Returns the negative of this 64 bit integer.
Return value
| 
| TInt64 | The negated 64 bit integer. |  | 
TInt64& operator++();
Description
Adds one to the value of this 64 bit integer and returns a reference to
it.
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64 operator++(TInt);
Description
Returns the value of this 64 bit integer before incrementing it by
one.
Return value
| 
| TInt64 | The value of the 64 bit integer before being incremented. |  | 
TInt64& operator--();
Description
Subtracts one from the value of this 64 bit integer and returns a
reference to it.
Return value
| 
| TInt64& | A reference to this 64 bit integer. |  | 
TInt64 operator--(TInt);
Description
Returns the value of this 64 bit integer before decrementing it by
one.
Return value
| 
| TInt64 | The value of the 64 bit integer before being decremented. |  | 
TInt64 operator+(const TInt64& aVal) const;
Description
Returns the sum of this 64 bit integer and the specified 64 bit
integer.
Parameters
| 
| const TInt64 &aVal | The 64 bit integer value to be added. |  | 
Return value
| 
| TInt64 | The result of the addition. |  | 
TInt64 operator-(const TInt64& aVal) const;
Description
Returns the result of subtracting the specified 64 bit integer from this
64 bit integer.
Parameters
| 
| const TInt64 &aVal | The 64 bit integer value to be subtracted. |  | 
Return value
| 
| TInt64 | The result of the subtraction. |  | 
TInt64 operator*(const TInt64& aVal) const;
Description
Returns the result of multiplying this 64 bit integer by the specified 64
bit integer.
Parameters
| 
| const TInt64 &aVal | The 64 bit integer multiplier. |  | 
Return value
| 
| TInt64 | The result of the multiplication. |  | 
TInt64 operator/(const TInt64& aVal) const;
Description
Returns the result of dividing this 64 bit integer by the specified 64
bit integer.
Parameters
| 
| const TInt64 &aVal | The 64 bit integer divisor. |  | 
Return value
| 
| TInt64 | The quotient from the division. |  | 
TInt64 operator%(const TInt64& aVal) const;
Description
Returns the result of modulo dividing this 64 bit integer by the
specified 64 bit integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer divisor. |  | 
Return value
| 
| TInt64 | The remainder from the division. |  | 
TInt64 operator>>(TInt aShift) const;
Description
Returns the result of arithmetically shifting this 64 bit integer to the
right by the specified number of bit positions.
Parameters
| 
| TInt aShift | The number of bit positions to be shifted. |  | 
Return value
| 
| TInt64 | The result of the right shift. |  | 
TInt64 operator<<(TInt aShift) const;
Description
Returns the result of arithmetically shifting this 64 bit integer to the
left by the specified number of bit positions.
Parameters
| 
| TInt aShift | The number of bit positions to be shifted. |  | 
Return value
| 
| TInt64 | The result of the right shift. |  | 
void Lsr(TInt aShift);
Description
Logically shifts this 64 bit integer to the right by the specified number
of bit positions.
Parameters
| 
| TInt aShift | The number of bit positions to be shifted. |  | 
void Mul10();
Description
Multiplies this 64 bit integer by 10.
TInt MulTop(const TInt64& aVal);
Description
Multiply this 64 bit integer by the specified 64 bit integer to generate
a 128 bit result and return the high order 64 bits of this
calculation.
Parameters
| 
| const TInt64& aVal | The 64 bit integer multiplier. |  | 
Return value
| 
| TInt | -2 if the low order 64 bits = 0. -1 if the low order 64 bits <
0x8000000000000000. 0 if the low order 64 bits = 0x8000000000000000 +1 if the
low order 64 bits > 0x8000000000000000 |  | 
void DivMod(const TInt64& aVal,TInt64& aRemainder);
Description
Divides this 64 bit integer by the specified 64 bit integer value. The
operation returns the quotient in this 64 bit integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer divisor. |  
| TInt64& aRemainder | The 64 bit integer remainder. |  | 
TInt operator==(const TInt64& aVal) const;
Description
Compares this 64 bit integer for equality with the specified 64 bit
integer.
Parameters
| 
| const TInt64 &aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is equal to the specified 64 bit integer;
false, otherwise. |  | 
TInt operator!=(const TInt64& aVal) const;
Description
Compares this 64 bit integer for inequality with the specified 64 bit
integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is not equal to the specified 64 bit
integer; false, otherwise. |  | 
TInt operator>=(const TInt64& aVal) const;
Description
Compares this 64 bit integer for being greater than or equal to the
specified 64 bit integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is greater than or equal to the specified 64
bit integer; false, otherwise. |  | 
TInt operator<=(const TInt64& aVal) const;
Description
Compares this 64 bit integer for being less than or equal to the
specified 64 bit integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is less than or equal to the specified 64
bit integer; false, otherwise. |  | 
TInt operator>(const TInt64& aVal) const;
Description
Compares this 64 bit integer for being greater than the specified 64 bit
integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is greater than the specified 64 bit
integer; false, otherwise. |  | 
TInt operator<(const TInt64& aVal) const;
Description
Compares this 64 bit integer for being less than the specified 64 bit
integer.
Parameters
| 
| const TInt64& aVal | The 64 bit integer to be compared |  | 
Return value
| 
| TInt | True, if this 64 bit integer is less than the specified 64 bit integer;
false, otherwise. |  |