Formatter for integral types. More...

#include <number.hpp>

Public Member Functions
FormatNumber< Number > &	align (ecl::Alignment a)
FormatNumber< Number > &	base (ecl::IntegralBase b)
	FormatNumber (int w=-1, ecl::Alignment a=NoAlign, ecl::IntegralBase b=Dec)
FormatNumber< Number > &	operator() (int w, ecl::Alignment a, ecl::IntegralBase b)
FormatNumber< Number > &	operator() (Number n)
FormatNumber< Number > &	operator() (Number n, int w, ecl::IntegralBase b)
FormatNumber< Number > &	operator() (Number n, int w, ecl::Alignment a, ecl::IntegralBase b)
FormatNumber< Number > &	width (int w)
virtual	~FormatNumber ()
Protected Member Functions
template<typename OutputStream >
void	formatBin (OutputStream &ostream) const
template<typename OutputStream >
void	formatDec (OutputStream &ostream) const
template<typename OutputStream >
void	formatHex (OutputStream &ostream) const
template<typename OutputStream >
void	pad (int n, OutputStream &ostream) const
template<typename OutputStream >
void	postPad (int n, OutputStream &ostream) const
template<typename OutputStream >
void	prePad (int n, OutputStream &ostream) const
Protected Attributes
ecl::Alignment *	alignment_
IntegralBase *	base_
ecl::Alignment	prm_alignment
ecl::IntegralBase	prm_base
int	prm_width
bool	ready_to_format
ecl::Alignment	tmp_alignment
ecl::IntegralBase	tmp_base
int	tmp_width
Number	value_
int *	width_
Friends
template<typename OutputStream , typename N >
OutputStream &	operator<< (OutputStream &ostream, FormatNumber< N > &formatter) ecl_assert_throw_decl(StandardException)

Detailed Description

template<typename Number>
class ecl::interfaces::FormatNumber< Number >

Formatter for integral types.

Default formatter for integral types. For convenience, use the individual Format classes that inherit this one instead.

Definition at line 57 of file number.hpp.

Constructor & Destructor Documentation

template<typename Number>

ecl::interfaces::FormatNumber< Number >::FormatNumber	(	int	w = `-1`,
		ecl::Alignment	a = `NoAlign`,
		ecl::IntegralBase	b = `Dec`
	)		`[inline]`

Default constructor. Initialises the format tags for width, alignment and base.

Parameters:

w	: width (default - no width constraints)
a	: the textual alignment (default - no alignment constraints)
b	: the base format for the integral representation (default - decimal)

Definition at line 68 of file number.hpp.

template<typename Number>

virtual ecl::interfaces::FormatNumber< Number >::~FormatNumber ( ) [inline, virtual]

Definition at line 70 of file number.hpp.

Member Function Documentation

template<typename Number >

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::align ( ecl::Alignment a )

Sets the alignment format parameter. This aligns the text output in the text window which has a width specified by the width parameter.

Parameters:

a	: the aligning property for the output text.

See also:: ecl::formatters::Alignment

Definition at line 203 of file number.hpp.

template<typename Number >

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::base ( ecl::IntegralBase b )

Sets the base format. For integral types, this can be binary, hexadecimal or decimal.

Parameters:

b	: the base representation used for the output.

See also:: IntegralBase

Definition at line 186 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::formatBin ( OutputStream & ostream ) const [protected]

Definition at line 226 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::formatDec ( OutputStream & ostream ) const [protected]

Definition at line 257 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::formatHex ( OutputStream & ostream ) const [protected]

Definition at line 240 of file number.hpp.

template<typename Number >

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::operator()	(	int	w,
		ecl::Alignment	a,
		ecl::IntegralBase	b
	)

Convenient stream format parameter setter. This one permanently configures the width alignment and base as specified.

Parameters:

w	: the total width of the text output.
a	: the aligning property for the output text.
b	: the base representation used for the output.

Returns:: FormatNumber& : this formatter readied for use by a stream.

Definition at line 213 of file number.hpp.

template<typename Number>

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::operator() ( Number n )

Convenient stream formatter. This function directly formats the specified input value with the stored settings.

Parameters:

n	: the input value to be formatted.

Returns:: FormatNumber& : this formatter readied for use by a stream.

Insert an input value to be formatted when passed to a stream.

Definition at line 313 of file number.hpp.

template<typename Number>

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::operator()	(	Number	n,
		int	w,
		ecl::IntegralBase	b
	)

Convenient stream formatter. This member directly formats the specified input value with the supplied/temporary parameters.

Parameters:

n	: the input value to be formatted.
w	: the total width of the text output.
b	: the base representation used for the output.

Returns:: FormatNumber& : this formatter readied for use by a stream.

Temporarily configure the formatter with a width, base combination along with a value to be formatted.

Definition at line 328 of file number.hpp.

template<typename Number>

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::operator()	(	Number	n,
		int	w,
		ecl::Alignment	a,
		ecl::IntegralBase	b
	)

Convenient stream formatter. This member directly formats the specified input value with the supplied/temporary parameters.

Parameters:

n	: the input value to be formatted.
w	: the total width of the text output.
a	: the aligning property for the output text.
b	: the base representation used for the output.

Returns:: FormatNumber& : this formatter readied for use by a stream.

Temporarily configure the formatter with a complete parameter set along with a value to be formatted.

Definition at line 343 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::pad	(	int	n,
		OutputStream &	ostream
	)		const `[protected]`

Definition at line 299 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::postPad	(	int	n,
		OutputStream &	ostream
	)		const `[protected]`

Definition at line 284 of file number.hpp.

template<typename Number >

template<typename OutputStream >

void ecl::interfaces::FormatNumber< Number >::prePad	(	int	n,
		OutputStream &	ostream
	)		const `[protected]`

Definition at line 269 of file number.hpp.

template<typename Number >

FormatNumber< Number > & ecl::interfaces::FormatNumber< Number >::width ( int w )

Sets the width format parameter. Setting this to -1 will turn off width formatting constraints.

Parameters:

w	: the total width of the text output.

Definition at line 193 of file number.hpp.

Friends And Related Function Documentation

template<typename Number>

template<typename OutputStream , typename N >

OutputStream& operator<<	(	OutputStream &	ostream,
		FormatNumber< N > &	formatter
	)		`[friend]`

Friend function which allows a stream to act on the formatter to produce the formatted result. This works on normal c++ streams as well as TextStreams.

Parameters: