sf::Time Class Reference

Represents a time value. More...

#include <SFML/System/Time.hpp>

Public Member Functions
	Time ()
	Default constructor.
float	asSeconds () const
	Return the time value as a number of seconds.
Int32	asMilliseconds () const
	Return the time value as a number of milliseconds.
Int64	asMicroseconds () const
	Return the time value as a number of microseconds.

Static Public Attributes
static const Time	Zero
	Predefined "zero" time value.

Friends
Time	seconds (float)
Time	milliseconds (Int32)
Time	microseconds (Int64)

Related Functions
(Note that these are not member functions.)
Time	seconds (float amount)
	Construct a time value from a number of seconds.
Time	milliseconds (Int32 amount)
	Construct a time value from a number of milliseconds.
Time	microseconds (Int64 amount)
	Construct a time value from a number of microseconds.
bool	operator== (Time left, Time right)
	Overload of == operator to compare two time values.
bool	operator!= (Time left, Time right)
	Overload of != operator to compare two time values.
bool	operator< (Time left, Time right)
	Overload of < operator to compare two time values.
bool	operator> (Time left, Time right)
	Overload of > operator to compare two time values.
bool	operator<= (Time left, Time right)
	Overload of <= operator to compare two time values.
bool	operator>= (Time left, Time right)
	Overload of >= operator to compare two time values.
Time	operator- (Time right)
	Overload of unary - operator to negate a time value.
Time	operator+ (Time left, Time right)
	Overload of binary + operator to add two time values.
Time &	operator+= (Time &left, Time right)
	Overload of binary += operator to add/assign two time values.
Time	operator- (Time left, Time right)
	Overload of binary - operator to subtract two time values.
Time &	operator-= (Time &left, Time right)
	Overload of binary -= operator to subtract/assign two time values.
Time	operator* (Time left, float right)
	Overload of binary * operator to scale a time value.
Time	operator* (Time left, Int64 right)
	Overload of binary * operator to scale a time value.
Time	operator* (float left, Time right)
	Overload of binary * operator to scale a time value.
Time	operator* (Int64 left, Time right)
	Overload of binary * operator to scale a time value.
Time &	operator*= (Time &left, float right)
	Overload of binary *= operator to scale/assign a time value.
Time &	operator*= (Time &left, Int64 right)
	Overload of binary *= operator to scale/assign a time value.
Time	operator/ (Time left, float right)
	Overload of binary / operator to scale a time value.
Time	operator/ (Time left, Int64 right)
	Overload of binary / operator to scale a time value.
Time &	operator/= (Time &left, float right)
	Overload of binary /= operator to scale/assign a time value.
Time &	operator/= (Time &left, Int64 right)
	Overload of binary /= operator to scale/assign a time value.
float	operator/ (Time left, Time right)
	Overload of binary / operator to compute the ratio of two time values.
Time	operator% (Time left, Time right)
	Overload of binary % operator to compute remainder of a time value.
Time &	operator%= (Time &left, Time right)
	Overload of binary %= operator to compute/assign remainder of a time value.

Detailed Description

Represents a time value.

sf::Time encapsulates a time value in a flexible way.

It allows to define a time value either as a number of seconds, milliseconds or microseconds. It also works the other way round: you can read a time value as either a number of seconds, milliseconds or microseconds.

By using such a flexible interface, the API doesn't impose any fixed type or resolution for time values, and let the user choose its own favorite representation.

Time values support the usual mathematical operations: you can add or subtract two times, multiply or divide a time by a number, compare two times, etc.

Since they represent a time span and not an absolute time value, times can also be negative.

Usage example:

sf::Time t1 = sf::seconds(0.1f);
Int32 milli = t1.asMilliseconds(); // 100
 
sf::Time t2 = sf::milliseconds(30);
Int64 micro = t2.asMicroseconds(); // 30000
 
sf::Time t3 = sf::microseconds(-800000);
float sec = t3.asSeconds(); // -0.8

void update(sf::Time elapsed)
{
   position += speed * elapsed.asSeconds();
}
 
update(sf::milliseconds(100));

See also

sf::Clock

Definition at line 40 of file Time.hpp.

Constructor & Destructor Documentation

Time()

sf::Time::Time

(

)

Default constructor.

Sets the time value to zero.

Member Function Documentation

asMicroseconds()

Int64 sf::Time::asMicroseconds

(

)

const

Return the time value as a number of microseconds.

Returns

Time in microseconds

See also

asSeconds, asMilliseconds

asMilliseconds()

Int32 sf::Time::asMilliseconds

(

)

const

Return the time value as a number of milliseconds.

Returns

Time in milliseconds

See also

asSeconds, asMicroseconds

asSeconds()

float sf::Time::asSeconds

(

)

const

Return the time value as a number of seconds.

Returns

Time in seconds

See also

asMilliseconds, asMicroseconds

Friends And Related Function Documentation

microseconds()

Time microseconds ( Int64  amount )

related

Construct a time value from a number of microseconds.

Parameters

amount

Number of microseconds

Returns

Time value constructed from the amount of microseconds

See also

seconds, milliseconds

milliseconds()

Time milliseconds ( Int32  amount )

related

Construct a time value from a number of milliseconds.

Parameters

amount

Number of milliseconds

Returns

Time value constructed from the amount of milliseconds

See also

seconds, microseconds

operator!=()

bool operator!= ( Time  left, Time  right  )

related

Overload of != operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if both time values are different

operator%()

Time operator% ( Time  left, Time  right  )

related

Overload of binary % operator to compute remainder of a time value.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

left modulo right

operator%=()

Time & operator%= ( Time &  left, Time  right  )

related

Overload of binary %= operator to compute/assign remainder of a time value.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

left modulo right

operator*() [1/4]

Time operator* ( float  left, Time  right  )

related

Overload of binary * operator to scale a time value.

Parameters

left	Left operand (a number)
right	Right operand (a time)

Returns

left multiplied by right

operator*() [2/4]

Time operator* ( Int64  left, Time  right  )

related

Overload of binary * operator to scale a time value.

Parameters

left	Left operand (a number)
right	Right operand (a time)

Returns

left multiplied by right

operator*() [3/4]

Time operator* ( Time  left, float  right  )

related

Overload of binary * operator to scale a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left multiplied by right

operator*() [4/4]

Time operator* ( Time  left, Int64  right  )

related

Overload of binary * operator to scale a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left multiplied by right

operator*=() [1/2]

Time & operator*= ( Time &  left, float  right  )

related

Overload of binary *= operator to scale/assign a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left multiplied by right

operator*=() [2/2]

Time & operator*= ( Time &  left, Int64  right  )

related

Overload of binary *= operator to scale/assign a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left multiplied by right

operator+()

Time operator+ ( Time  left, Time  right  )

related

Overload of binary + operator to add two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

Sum of the two times values

operator+=()

Time & operator+= ( Time &  left, Time  right  )

related

Overload of binary += operator to add/assign two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

Sum of the two times values

operator-() [1/2]

Time operator- ( Time  left, Time  right  )

related

Overload of binary - operator to subtract two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

Difference of the two times values

operator-() [2/2]

Time operator- ( Time  right )

related

Overload of unary - operator to negate a time value.

Parameters

right

Right operand (a time)

Returns

Opposite of the time value

operator-=()

Time & operator-= ( Time &  left, Time  right  )

related

Overload of binary -= operator to subtract/assign two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

Difference of the two times values

operator/() [1/3]

Time operator/ ( Time  left, float  right  )

related

Overload of binary / operator to scale a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left divided by right

operator/() [2/3]

Time operator/ ( Time  left, Int64  right  )

related

Overload of binary / operator to scale a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left divided by right

operator/() [3/3]

float operator/ ( Time  left, Time  right  )

related

Overload of binary / operator to compute the ratio of two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

left divided by right

operator/=() [1/2]

Time & operator/= ( Time &  left, float  right  )

related

Overload of binary /= operator to scale/assign a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left divided by right

operator/=() [2/2]

Time & operator/= ( Time &  left, Int64  right  )

related

Overload of binary /= operator to scale/assign a time value.

Parameters

left	Left operand (a time)
right	Right operand (a number)

Returns

left divided by right

operator<()

bool operator< ( Time  left, Time  right  )

related

Overload of < operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if left is lesser than right

operator<=()

bool operator<= ( Time  left, Time  right  )

related

Overload of <= operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if left is lesser or equal than right

operator==()

bool operator== ( Time  left, Time  right  )

related

Overload of == operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if both time values are equal

operator>()

bool operator> ( Time  left, Time  right  )

related

Overload of > operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if left is greater than right

operator>=()

bool operator>= ( Time  left, Time  right  )

related

Overload of >= operator to compare two time values.

Parameters

left	Left operand (a time)
right	Right operand (a time)

Returns

True if left is greater or equal than right

seconds()

Time seconds ( float  amount )

related

Construct a time value from a number of seconds.

Parameters

amount

Number of seconds

Returns

Time value constructed from the amount of seconds

See also

milliseconds, microseconds

Member Data Documentation

Zero

const Time sf::Time::Zero

static

Predefined "zero" time value.

Definition at line 85 of file Time.hpp.

---

The documentation for this class was generated from the following file:

• Time.hpp