Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <S32BUF.H>

Class TStreamPos

class TStreamPos;

Description

Holds the position of the read or write mark within a seekable stream.

Position is the offset from the beginning of a seekable stream. The class provides convenient operators for performing arithmetic on the offset value and for doing comparisons between stream position objects.

It can be considered as an absolute stream position.

Objects of this type are usually created as a result of calling MStreamBuf::SeekL(TMark,TStreamPos) or MStreamBuf::TellL(TRead)const; they allow a program to remember the current read position in a stream buffer and reset it to the same location later.

Members

Defined in TStreamPos:

See also:


Construction and destruction


TStreamPos()

inline TStreamPos();

Description

Constructs an empty stream position object.


TStreamPos(TInt)

inline TStreamPos(TInt anOffset);

Description

Constructs the stream position object from the specified value.

Parameters

TInt anOffset

The position value.

[Top]


Member functions


operator==(TStreamPos)const

inline TBool operator==(TStreamPos aPos) const;

Description

Tests whether the stream position is equal to the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is equal to the specified stream position's value; false, otherwise.


operator!=(TStreamPos)const

inline TBool operator!=(TStreamPos aPos) const;

Description

Tests whether the stream position is not equal to the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is not equal to the specified stream position's value; false, otherwise.


operator<(TStreamPos)const

inline TBool operator<(TStreamPos aPos) const;

Description

Tests whether the stream position is less than the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is less than the specified stream position's value; false, otherwise.


operator<=(TStreamPos)const

inline TBool operator<=(TStreamPos aPos) const;

Description

Tests whether the stream position is less than or equal to the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is less than or equal to the specified stream position's value; false, otherwise.


operator>(TStreamPos)const

inline TBool operator>(TStreamPos aPos) const;

Description

Tests whether the stream position is greater than the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is greater than the specified stream position's value; false, otherwise.


operator>=(TStreamPos)const

inline TBool operator>=(TStreamPos aPos) const;

Description

Tests whether the stream position is greater than or equal to the specified stream position.

Parameters

TStreamPos aPos

The stream position to be compared.

Return value

TBool

True, if this object's stream position value is greater than or equal to the specified stream position's value; false, otherwise.


operator-(TStreamPos)const

inline TInt operator-(TStreamPos aPos) const;

Description

Gets the result of subtracting the specified stream position value from this object's stream position value.

Parameters

TStreamPos aPos

The stream position whose value is to be subtracted.

Return value

TInt

The result of the calculation.


operator+(TInt)const

inline TStreamPos operator+(TInt anOffset) const;

Description

Gets a stream position object that holds the result of adding the specified value to this object's stream position value.

Parameters

TInt anOffset

The value to be added.

Return value

TStreamPos

The stream position object holding the result of the calculation.


operator-(TInt)const

inline TStreamPos operator-(TInt anOffset) const;

Description

Gets a stream position object that holds the result of subtracting the specified value from this object's stream position value.

Parameters

TInt anOffset

The value to be subtracted.

Return value

TStreamPos

The stream position object holding the result of the calculation.


operator+=(TInt)

inline TStreamPos& operator+=(TInt anOffset);

Description

Adds the specified value to this stream position object.

Parameters

TInt anOffset

The value to be added.

Return value

TStreamPos &

A reference to this stream position object.


operator-=(TInt)

inline TStreamPos& operator-=(TInt anOffset);

Description

Subtracts the specified value from this stream position object.

Parameters

TInt anOffset

The value to be subtracted.

Return value

TStreamPos &

A reference to this stream position object.


Offset()const

inline TInt Offset() const;

Description

Gets the stream position value.

Return value

TInt

The stream position value.