Period attribute of CandleSymbol defines aggregation period of the candles. More...

#include <CandlePeriod.hpp>

Inheritance diagram for CandlePeriod:

Public Member Functions
std::int64_t	getPeriodIntervalMillis () const noexcept
	Returns aggregation period in milliseconds as closely as possible.

std::string	changeAttributeForSymbol (const dxfcpp::StringLikeWrapper &symbol) const override
	Returns candle event symbol string with this aggregation period set.

double	getValue () const noexcept
	Returns aggregation period value.

const CandleType &	getType () const &noexcept
	Returns aggregation period type.

const std::string &	toString () const &
	Returns string representation of this aggregation period.

Static Public Member Functions
static CandlePeriod	parse (const dxfcpp::StringLikeWrapper &s)
	Parses string representation of aggregation period into object.

static CandlePeriod	valueOf (double value, const CandleType &type) noexcept
	Returns candle period with the given value and type.

static CandlePeriod	getAttributeForSymbol (const dxfcpp::StringLikeWrapper &symbol) noexcept
	Returns candle period of the given candle symbol string.

static std::string	normalizeAttributeForSymbol (const dxfcpp::StringLikeWrapper &symbol)
	Returns candle symbol string with the normalized representation of the candle period attribute.

Static Public Attributes
static const CandlePeriod	TICK {1, CandleType::TICK}
	Tick aggregation where each candle represents an individual tick.

static const CandlePeriod	DAY {1, CandleType::DAY}
	Day aggregation where each candle represents a day.

static const CandlePeriod	DEFAULT = TICK
	Default period is CandlePeriod::TICK.

static const std::string	ATTRIBUTE_KEY {}
	The attribute key that is used to store the value of `CandlePeriod` in a symbol string using methods of MarketEventSymbols class.

Detailed Description

Period attribute of CandleSymbol defines aggregation period of the candles.

Aggregation period is defined as pair of a value and type.

Implementation details

This attribute is encoded in a symbol string with MarketEventSymbols.getAttributeStringByKey, changeAttributeStringByKey, and removeAttributeStringByKey methods. The key to use with these methods is available via CandlePeriod::ATTRIBUTE_KEY constant. The value that this key shall be set to is equal to the corresponding CandlePeriod::toString() "CandlePeriod.toString()"

Member Function Documentation

◆ changeAttributeForSymbol()

std::string CandlePeriod::changeAttributeForSymbol ( const dxfcpp::StringLikeWrapper & symbol ) const

inlineoverridevirtual

Returns candle event symbol string with this aggregation period set.

Parameters

symbol original candle event symbol.

Returns: candle event symbol string with this aggregation period set.

Implements CandleSymbolAttribute.

References ATTRIBUTE_KEY, MarketEventSymbols::changeAttributeStringByKey(), DEFAULT, MarketEventSymbols::removeAttributeStringByKey(), and toString().

◆ getAttributeForSymbol()

static CandlePeriod CandlePeriod::getAttributeForSymbol ( const dxfcpp::StringLikeWrapper & symbol )

inlinestaticnoexcept

Returns candle period of the given candle symbol string.

The result is CandlePeriod::DEFAULT if the symbol does not have candle period attribute.

Parameters

symbol candle symbol string.

Returns: candle period of the given candle symbol string

References ATTRIBUTE_KEY, DEFAULT, and parse().

◆ getPeriodIntervalMillis()

std::int64_t CandlePeriod::getPeriodIntervalMillis ( ) const

inlinenoexcept

Returns aggregation period in milliseconds as closely as possible.

Certain aggregation types like SECOND and DAY span a specific number of milliseconds. CandleType::MONTH, CandleType::OPTEXP and CandleType::YEAR are approximate. Candle period of CandleType::TICK, CandleType::VOLUME, CandleType::PRICE, CandleType::PRICE_MOMENTUM and CandleType::PRICE_RENKO is not defined and this method returns 0. The result of this method is equal to static_cast<std::int64_t>(this->getType().getPeriodIntervalMillis() * this->getValue())

See also: CandleType::getPeriodIntervalMillis()

Returns: aggregation period in milliseconds.

References CandleType::getPeriodIntervalMillis().

◆ getType()

const CandleType & CandlePeriod::getType ( ) const &

inlinenoexcept

Returns aggregation period type.

Returns: aggregation period type.

◆ getValue()

double CandlePeriod::getValue ( ) const

inlinenoexcept

Returns aggregation period value.

For example, the value of 5 with the candle type of MINUTE represents 5 minute aggregation period.

Returns: aggregation period value.

◆ normalizeAttributeForSymbol()

static std::string CandlePeriod::normalizeAttributeForSymbol ( const dxfcpp::StringLikeWrapper & symbol )

inlinestatic

Returns candle symbol string with the normalized representation of the candle period attribute.

Parameters

symbol candle symbol string.

Returns: candle symbol string with the normalized representation of the the candle period attribute.

References ATTRIBUTE_KEY, MarketEventSymbols::changeAttributeStringByKey(), DEFAULT, parse(), and MarketEventSymbols::removeAttributeStringByKey().

◆ parse()

static CandlePeriod CandlePeriod::parse ( const dxfcpp::StringLikeWrapper & s )

inlinestatic

Parses string representation of aggregation period into object.

Any string that was returned by CandlePeriod::toString() can be parsed. This method is flexible in the way candle types can be specified. See CandleType::parse() for details.

Parameters

s	The string representation of aggregation period.

Returns: The aggregation period.

References DAY, CandleType::DAY, TICK, CandleType::TICK, CandleType::toString(), and valueOf().

Referenced by getAttributeForSymbol(), and normalizeAttributeForSymbol().

◆ toString()

const std::string & CandlePeriod::toString ( ) const &

inline

Returns string representation of this aggregation period.

The string representation is composed of value and type string. For example, 5 minute aggregation is represented as "5m". The value of 1 is omitted in the string representation, so CandlePeriod::DAY (one day) is represented as "d". This string representation can be converted back into object with CandlePeriod::parse() method.

Returns: string representation of this aggregation period.

References CandleType::toString().

Referenced by changeAttributeForSymbol().

◆ valueOf()

static CandlePeriod CandlePeriod::valueOf	(	double	value,
		const CandleType &	type )

inlinestaticnoexcept

Returns candle period with the given value and type.

Parameters

value	candle period value.
type	candle period type.

Returns: candle period with the given value and type.

References DAY, CandleType::DAY, TICK, and CandleType::TICK.

Referenced by parse().

Member Data Documentation

◆ ATTRIBUTE_KEY

const std::string CandlePeriod::ATTRIBUTE_KEY {}

static

The attribute key that is used to store the value of CandlePeriod in a symbol string using methods of MarketEventSymbols class.

The value of this constant is an empty string, because this is the main attribute that every CandleSymbol must have. The value that this key shall be set to is equal to the corresponding CandlePeriod::toString()

Referenced by changeAttributeForSymbol(), getAttributeForSymbol(), and normalizeAttributeForSymbol().

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Implementation details

Member Function Documentation

◆ changeAttributeForSymbol()

◆ getAttributeForSymbol()

◆ getPeriodIntervalMillis()

◆ getType()

◆ getValue()

◆ normalizeAttributeForSymbol()

◆ parse()

◆ toString()

◆ valueOf()

Member Data Documentation

◆ ATTRIBUTE_KEY