itpp::Fixed< w, e, o, q > Class Template Reference
[Fixed-Point Data Types]

Templated fixed-point data type. More...

#include <itpp/fixedpoint/fixed.h>

Inheritance diagram for itpp::Fixed< w, e, o, q >:


Public Member Functions
	Fixed (double x=0.0, int s=0, Stat *ptr=0)
	Default constructor.
	Fixed (Stat *ptr)
	Constructor.
	Fixed (const Fix &x, Stat *ptr=0)
	Constructor.
virtual	~Fixed ()
	Destructor.
Fixed &	operator= (const Fix &x)
	Assignment from Fix.
Fixed &	operator= (int x)
	Assignment from int.
Fix &	operator+= (const Fix &x)
	Addition of Fix.
Fix &	operator+= (const int x)
	Addition of int.
Fix &	operator-= (const Fix &x)
	Subtraction of Fix.
Fix &	operator-= (const int x)
	Subtraction of int.
Fix &	operator *= (const Fix &x)
	Multiplication with Fix.
Fix &	operator *= (const int x)
	Multiplication with int.
Fix &	operator/= (const Fix &x)
	Division with Fix using quantization mode `TRN`.
Fix &	operator/= (const int x)
	Division with int using quantization mode `TRN`.
Fix	operator- () const
	Unary negative of Fix.
Fix &	operator<<= (const int n)
	Left shift `n` bits.
Fix &	operator>>= (const int n)
	Right shift `n` bits using quantization mode `qmode` (constructor argument).
void	set (double x, int n)
	Set to `x * pow2(n)` using quantization mode `qmode` (constructor argument).
void	set (double x, int n, q_mode q)
	Set to `x * pow2(n)` using quantization mode `q` (function argument).
void	set_re (fixrep x)
	Set data representation (mainly for internal use since it reveals the representation type).
void	lshift (int n)
	Left shift `n` bits.
void	rshift (int n)
	Right shift `n` bits using quantization mode `qmode` (constructor argument).
void	rshift (int n, q_mode q)
	Right shift `n` bits using quantization mode `q` (function argument).
virtual void	print () const
	Print restrictions.
fixrep	get_re () const
	Get data representation (mainly for internal use since it reveals the representation type).
double	unfix () const
	Conversion to double.
	operator double () const
	Conversion to double.
void	set_shift (int s)
	Set shift (without shifting).
int	get_shift () const
	Get shift.
int	get_wordlen () const
	Get word length.
e_mode	get_e_mode () const
	Get sign encoding mode.
o_mode	get_o_mode () const
	Get overflow mode.
q_mode	get_q_mode () const
	Get quantization mode.
output_mode	get_output_mode () const
	Get output mode.
fixrep	get_max () const
	Get maximum value of data representation.
fixrep	get_min () const
	Get minimum value of data representation.
Static Public Member Functions
void	set_output_mode (output_mode o)
	Set output mode to OUTPUT_FIX, OUTPUT_FIX_SHIFT, OUTPUT_FLOAT or OUTPUT_FLOAT_SHIFT. Static member function.
void	set_output_mode (std::string o)
	Set output mode to "OUTPUT_FIX", "OUTPUT_FIX_SHIFT", "OUTPUT_FLOAT" or "OUTPUT_FLOAT_SHIFT". Static member function.
Protected Member Functions
void	init ()
	Calculate help variables min, max and n_unused_bits.
fixrep	apply_o_mode (fixrep x) const
	Handle overflows using overflow mode `omode` and make call to statistics object (if any).
fixrep	scale_and_apply_modes (double x) const
	Convert from `double` to `fixrep` using `shift` and quantization mode `qmode`, then call `limit()`.
fixrep	scale_and_apply_modes (double x, q_mode q) const
	Convert from `double` to `fixrep` using `shift` and quantization mode `q`, then call `limit()`.
fixrep	rshift_and_apply_q_mode (fixrep x, int n) const
	Right shift `n` bits using quantization mode `qmode` and make call to statistics object (if any).
fixrep	rshift_and_apply_q_mode (fixrep x, int n, q_mode q) const
	Right shift `n` bits using quantization mode `q` and make call to statistics object (if any).
Protected Attributes
fixrep	re
	Data representation.
int	shift
	Accumulated bitshift (positive means left-shifted, negative means right-shifted).
int	wordlen
	Word length.
e_mode	emode
	Sign encoding mode.
o_mode	omode
	Overflow mode.
q_mode	qmode
	Quantization mode.
Stat *	stat_ptr
	Pointer to statistics object.
fixrep	min
	Minimum allowed value (help variable to speed up calculations).
fixrep	max
	Maximum allowed value (help variable to speed up calculations).
int	n_unused_bits
	Number of unused (MSB) bits (help variable to speed up calculations).
Friends
int	assert_shifts (const CFix &x, const Fix &y)
	Check that x.shift==y.shift OR x==0 OR y==0 and return the shift (for the non-zero argument).
int	assert_shifts (const Fix &x, const Fix &y)
	Check that x.shift==y.shift OR x==0 OR y==0 and return the shift (for the non-zero argument).
int	assert_shifts (const Fix &x, int y)
	Check that x.shift==0 OR x==0 OR y==0 and return x.shift.

Detailed Description

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>
class itpp::Fixed< w, e, o, q >

Templated fixed-point data type.

See the Detailed Description in the Fixed-Point Data Types module.

Definition at line 50 of file fixed.h.

Constructor & Destructor Documentation

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

itpp::Fixed< w, e, o, q >::Fixed ( double x = 0.0,

int s = 0,

Stat * ptr = 0

) [inline]

Default constructor.

Definition at line 53 of file fixed.h.

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

itpp::Fixed< w, e, o, q >::Fixed ( Stat * ptr ) [inline, explicit]

Constructor.

Definition at line 56 of file fixed.h.

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

itpp::Fixed< w, e, o, q >::Fixed ( const Fix & x,

Stat * ptr = 0

) [inline]

Constructor.

Definition at line 59 of file fixed.h.

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

virtual itpp::Fixed< w, e, o, q >::~Fixed ( ) [inline, virtual]

Destructor.

Definition at line 62 of file fixed.h.

Member Function Documentation

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

Fixed& itpp::Fixed< w, e, o, q >::operator= ( const Fix & x ) [inline]

Assignment from Fix.

Reimplemented from itpp::Fix.
Definition at line 65 of file fixed.h.
References itpp::Fix::re, and itpp::Fix_Base::shift.

template<int w, e_mode e = TC, o_mode o = WRAP, q_mode q = TRN>

Fixed& itpp::Fixed< w, e, o, q >::operator= ( int x ) [inline]

Assignment from int.

Reimplemented from itpp::Fix.
Definition at line 72 of file fixed.h.

Fix & itpp::Fix::operator+= ( const Fix & x ) [inherited]

Addition of Fix.

Definition at line 54 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::assert_shifts, and itpp::Fix::re.

Fix & itpp::Fix::operator+= ( const int x ) [inherited]

Addition of int.

Definition at line 61 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::assert_shifts, and itpp::Fix::re.

Fix & itpp::Fix::operator-= ( const Fix & x ) [inherited]

Subtraction of Fix.

Definition at line 68 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::assert_shifts, and itpp::Fix::re.

Fix & itpp::Fix::operator-= ( const int x ) [inherited]

Subtraction of int.

Definition at line 75 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::assert_shifts, and itpp::Fix::re.

Fix & itpp::Fix::operator *= ( const Fix & x ) [inherited]

Multiplication with Fix.

Definition at line 82 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::re, and itpp::Fix_Base::shift.

Fix & itpp::Fix::operator *= ( const int x ) [inherited]

Multiplication with int.

Definition at line 89 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), and itpp::Fix::re.

Fix & itpp::Fix::operator/= ( const Fix & x ) [inherited]

Division with Fix using quantization mode TRN.

Definition at line 95 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::Fix::re, and itpp::Fix_Base::shift.

Fix & itpp::Fix::operator/= ( const int x ) [inherited]

Division with int using quantization mode TRN.

Definition at line 102 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), and itpp::Fix::re.

Fix itpp::Fix::operator- ( ) const [inherited]

Unary negative of Fix.

Definition at line 108 of file fix.cpp.
References itpp::Fix::Fix(), and itpp::Fix::re.

Fix & itpp::Fix::operator<<= ( const int n ) [inherited]

Left shift n bits.

Definition at line 113 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), it_assert1, and itpp::Fix::re.

Fix & itpp::Fix::operator>>= ( const int n ) [inherited]

Right shift n bits using quantization mode qmode (constructor argument).

Definition at line 121 of file fix.cpp.
References itpp::Fix::re, and itpp::Fix_Base::rshift_and_apply_q_mode().

void itpp::Fix::set ( double x,

int n

) [inherited]

Set to x * pow2(n) using quantization mode qmode (constructor argument).

Definition at line 128 of file fix.cpp.
References itpp::Fix::re, and itpp::Fix_Base::scale_and_apply_modes().
Referenced by itpp::operator>>().

void itpp::Fix::set ( double x,

int n,

q_mode q

) [inherited]

Set to x * pow2(n) using quantization mode q (function argument).

Definition at line 134 of file fix.cpp.
References itpp::Fix::re, and itpp::Fix_Base::scale_and_apply_modes().

void itpp::Fix::set_re ( fixrep x ) [inline, inherited]

Set data representation (mainly for internal use since it reveals the representation type).

Definition at line 106 of file fix.h.
Referenced by itpp::operator>>().

void itpp::Fix::lshift ( int n ) [inherited]

Left shift n bits.

Definition at line 140 of file fix.cpp.
References itpp::Fix_Base::apply_o_mode(), it_assert1, and itpp::Fix::re.

void itpp::Fix::rshift ( int n ) [inherited]

Right shift n bits using quantization mode qmode (constructor argument).

Definition at line 147 of file fix.cpp.
References itpp::Fix::re, and itpp::Fix_Base::rshift_and_apply_q_mode().

void itpp::Fix::rshift ( int n,

q_mode q

) [inherited]

Right shift n bits using quantization mode q (function argument).

Definition at line 153 of file fix.cpp.
References itpp::Fix::re, and itpp::Fix_Base::rshift_and_apply_q_mode().

void itpp::Fix::print ( ) const [virtual, inherited]

Print restrictions.

Reimplemented from itpp::Fix_Base.
Definition at line 165 of file fix.cpp.
References itpp::Fix::re.

fixrep itpp::Fix::get_re ( ) const [inline, inherited]

Get data representation (mainly for internal use since it reveals the representation type).

Definition at line 118 of file fix.h.
References itpp::fixrep.
Referenced by itpp::operator<<().

double itpp::Fix::unfix ( ) const [inherited]

Conversion to double.

Definition at line 159 of file fix.cpp.
References itpp::DOUBLE_POW2, it_assert1, and itpp::Fix::re.

itpp::Fix::operator double ( ) const [inline, inherited]

Conversion to double.

Definition at line 124 of file fix.h.
References itpp::DOUBLE_POW2, and it_assert1.

void itpp::Fix_Base::set_shift ( int s ) [inline, inherited]

Set shift (without shifting).

Definition at line 1005 of file fix_base.h.
Referenced by itpp::operator>>().

void itpp::Fix_Base::set_output_mode ( output_mode o ) [inline, static, inherited]

Set output mode to OUTPUT_FIX, OUTPUT_FIX_SHIFT, OUTPUT_FLOAT or OUTPUT_FLOAT_SHIFT. Static member function.

Definition at line 1007 of file fix_base.h.

void itpp::Fix_Base::set_output_mode ( std::string o ) [static, inherited]

Set output mode to "OUTPUT_FIX", "OUTPUT_FIX_SHIFT", "OUTPUT_FLOAT" or "OUTPUT_FLOAT_SHIFT". Static member function.

Definition at line 43 of file fix_base.cpp.
References it_error.

int itpp::Fix_Base::get_shift ( ) const [inline, inherited]

Get shift.

Definition at line 1012 of file fix_base.h.
Referenced by itpp::operator<<().

int itpp::Fix_Base::get_wordlen ( ) const [inline, inherited]

Get word length.

Definition at line 1014 of file fix_base.h.

e_mode itpp::Fix_Base::get_e_mode ( ) const [inline, inherited]

Get sign encoding mode.

Definition at line 1016 of file fix_base.h.
References itpp::e_mode.

o_mode itpp::Fix_Base::get_o_mode ( ) const [inline, inherited]

Get overflow mode.

Definition at line 1018 of file fix_base.h.
References itpp::o_mode.

q_mode itpp::Fix_Base::get_q_mode ( ) const [inline, inherited]

Get quantization mode.

Definition at line 1020 of file fix_base.h.
References itpp::q_mode.

output_mode itpp::Fix_Base::get_output_mode ( ) const [inline, inherited]

Get output mode.

Definition at line 1022 of file fix_base.h.
References itpp::output_mode.

fixrep itpp::Fix_Base::get_max ( ) const [inline, inherited]

Get maximum value of data representation.

Definition at line 1024 of file fix_base.h.
References itpp::fixrep.

fixrep itpp::Fix_Base::get_min ( ) const [inline, inherited]

Get minimum value of data representation.

Definition at line 1026 of file fix_base.h.
References itpp::fixrep.

void itpp::Fix_Base::init ( ) [protected, inherited]

Calculate help variables min, max and n_unused_bits.

Definition at line 70 of file fix_base.cpp.
References itpp::fixrep, it_assert1, it_error, itpp::Fix_Base::max, itpp::MAX_WORDLEN, itpp::Fix_Base::min, itpp::Fix_Base::n_unused_bits, itpp::TC, itpp::UINT64_POW2, itpp::US, and itpp::Fix_Base::wordlen.

fixrep itpp::Fix_Base::apply_o_mode ( fixrep x ) const [protected, inherited]

Handle overflows using overflow mode omode and make call to statistics object (if any).

Definition at line 91 of file fix_base.cpp.
References itpp::fixrep, itpp::int64, it_error, itpp::Fix_Base::n_unused_bits, itpp::Stat::sample(), itpp::SAT, itpp::Fix_Base::stat_ptr, and itpp::WRAP.
Referenced by itpp::Fix::lshift(), itpp::CFix::lshift(), itpp::Fix::operator *=(), itpp::CFix::operator *=(), itpp::Fix::operator+=(), itpp::CFix::operator+=(), itpp::Fix::operator-=(), itpp::CFix::operator-=(), itpp::Fix::operator/=(), itpp::CFix::operator/=(), itpp::Fix::operator<<=(), itpp::CFix::operator<<=(), itpp::Fix::operator=(), itpp::CFix::operator=(), and itpp::Fix_Base::scale_and_apply_modes().

fixrep itpp::Fix_Base::scale_and_apply_modes ( double x ) const [inline, protected, inherited]

Convert from double to fixrep using shift and quantization mode qmode, then call limit().

Definition at line 1055 of file fix_base.h.
References itpp::fixrep.
Referenced by itpp::Fix::set(), and itpp::CFix::set().

fixrep itpp::Fix_Base::scale_and_apply_modes ( double x,

q_mode q

) const [protected, inherited]

Convert from double to fixrep using shift and quantization mode q, then call limit().

Definition at line 131 of file fix_base.cpp.
References itpp::Fix_Base::apply_o_mode(), itpp::DOUBLE_POW2, itpp::fixrep, itpp::floor(), it_assert1, it_error, itpp::RND, itpp::RND_CONV, itpp::RND_CONV_ODD, itpp::RND_INF, itpp::RND_MIN_INF, itpp::RND_ZERO, itpp::round(), itpp::Fix_Base::shift, itpp::TRN, and itpp::TRN_ZERO.

fixrep itpp::Fix_Base::rshift_and_apply_q_mode ( fixrep x,

int n

) const [inline, protected, inherited]

Right shift n bits using quantization mode qmode and make call to statistics object (if any).

Definition at line 1059 of file fix_base.h.
References itpp::fixrep.
Referenced by itpp::Fix::operator>>=(), itpp::CFix::operator>>=(), itpp::Fix::rshift(), and itpp::CFix::rshift().

fixrep itpp::Fix_Base::rshift_and_apply_q_mode ( fixrep x,

int n,

q_mode q

) const [protected, inherited]

Right shift n bits using quantization mode q and make call to statistics object (if any).

Definition at line 185 of file fix_base.cpp.
References itpp::fixrep, it_assert1, it_error, itpp::RND, itpp::RND_CONV, itpp::RND_CONV_ODD, itpp::RND_INF, itpp::RND_MIN_INF, itpp::RND_ZERO, itpp::Stat::sample(), itpp::Fix_Base::stat_ptr, itpp::TRN, and itpp::TRN_ZERO.

Friends And Related Function Documentation

int assert_shifts ( const CFix & x,

const Fix & y

) [friend, inherited]

Check that x.shift==y.shift OR x==0 OR y==0 and return the shift (for the non-zero argument).

Definition at line 267 of file cfix.cpp.
Referenced by itpp::Fix::operator+=(), and itpp::Fix::operator-=().

int assert_shifts ( const Fix & x,

const Fix & y

) [friend, inherited]

Check that x.shift==y.shift OR x==0 OR y==0 and return the shift (for the non-zero argument).

Definition at line 171 of file fix.cpp.

int assert_shifts ( const Fix & x,

int y

) [friend, inherited]

Check that x.shift==0 OR x==0 OR y==0 and return x.shift.

Definition at line 187 of file fix.cpp.

Member Data Documentation

int itpp::Fix_Base::shift [protected, inherited]

Accumulated bitshift (positive means left-shifted, negative means right-shifted).

Definition at line 1032 of file fix_base.h.
Referenced by itpp::Fix::operator *=(), itpp::CFix::operator *=(), itpp::Fix::operator/=(), itpp::CFix::operator/=(), itpp::Fixed< w, e, o, q >::operator=(), itpp::Fix::operator=(), itpp::CFixed< w, e, o, q >::operator=(), itpp::CFix::operator=(), itpp::Fix_Base::print(), and itpp::Fix_Base::scale_and_apply_modes().

int itpp::Fix_Base::wordlen [protected, inherited]

Word length.

Definition at line 1034 of file fix_base.h.
Referenced by itpp::Fix_Base::init(), and itpp::Fix_Base::print().

e_mode itpp::Fix_Base::emode [protected, inherited]

Sign encoding mode.

Definition at line 1036 of file fix_base.h.
Referenced by itpp::Fix_Base::print().

o_mode itpp::Fix_Base::omode [protected, inherited]

Overflow mode.

Definition at line 1038 of file fix_base.h.
Referenced by itpp::Fix_Base::print().

q_mode itpp::Fix_Base::qmode [protected, inherited]

Quantization mode.

Definition at line 1040 of file fix_base.h.
Referenced by itpp::Fix_Base::print().

Stat* itpp::Fix_Base::stat_ptr [protected, inherited]

Pointer to statistics object.

Definition at line 1042 of file fix_base.h.
Referenced by itpp::Fix_Base::apply_o_mode(), itpp::Fix_Base::print(), and itpp::Fix_Base::rshift_and_apply_q_mode().

fixrep itpp::Fix_Base::min [protected, inherited]

Minimum allowed value (help variable to speed up calculations).

Definition at line 1044 of file fix_base.h.
Referenced by itpp::Fix_Base::init(), and itpp::Fix_Base::print().

fixrep itpp::Fix_Base::max [protected, inherited]

Maximum allowed value (help variable to speed up calculations).

Definition at line 1046 of file fix_base.h.
Referenced by itpp::Fix_Base::init(), and itpp::Fix_Base::print().

int itpp::Fix_Base::n_unused_bits [protected, inherited]

Number of unused (MSB) bits (help variable to speed up calculations).

Definition at line 1048 of file fix_base.h.
Referenced by itpp::Fix_Base::apply_o_mode(), itpp::Fix_Base::init(), and itpp::Fix_Base::print().

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

itpp/fixedpoint/fixed.h

Generated on Fri Jan 11 08:17:32 2008 for IT++ by Doxygen 1.3.9.1

itpp::Fixed< w, e, o, q > Class Template Reference [Fixed-Point Data Types]

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends