Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: e32std.h
Link against: euser.lib

Class TInt64

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()

TInt64(TInt aVal);

Description

Constructs the 64 bit integer from the specified signed integer.

Parameters

TInt aVal

The signed integer.


TInt64()

TInt64(TUint aVal);

Description

Constructs the 64 bit integer from the specified unsigned integer.

Parameters

TUint aVal

The unsigned integer.


TInt64()

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()

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.

[Top]


Setting and assigning


Set()

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.


operator=()

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.

[Top]


Accessing


Low()

TUint Low() const;

Description

Returns the low value 32 bits which form this 64 bit integer.

Return value

TUint

The low value 32 bits.


High()

TUint High() const;

Description

Returns the high value 32 bits which form this 64 bit integer.

Return value

TUint

The high value 32 bits.


GetTInt()

TInt GetTInt() const;

Description

Returns the 64 bit integer as a signed integer.

Return value

TInt

The signed integer.


GetTReal()

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.

[Top]


Arithmetic operations


operator+=()

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.


operator-=()

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.


operator*=()

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.


operator/=()

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.


operator%=()

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.


operator>>=()

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.


operator<<=()

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.


operator+()

TInt64 operator+() const;

Description

Returns the value of this 64 bit integer

Return value

TInt64

The 64 bit integer value.


operator-()

TInt64 operator-() const;

Description

Returns the negative of this 64 bit integer.

Return value

TInt64

The negated 64 bit integer.


operator++()

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.


operator++()

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.


operator--()

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.


operator--()

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.


operator+()

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.


operator-()

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.


operator*()

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.


operator/()

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.


operator%()

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.


operator>>()

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.


operator<<()

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.


Lsr()

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.


Mul10()

void Mul10();

Description

Multiplies this 64 bit integer by 10.


MulTop()

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


DivMod()

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.

[Top]


Comparison operators


operator==()

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.


operator!=()

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.


operator>=()

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.


operator<=()

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.


operator>()

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.


operator<()

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.