This class converts a floating number (Real) to a string It can be used if the standard C-C++ output functions (sprintf or std::cout<<) are not convenient. That is to say : More...

#include <Interface_FloatWriter.hxx>

Public Member Functions
	Interface_FloatWriter (const Standard_Integer chars=0)
	Creates a FloatWriter ready to work, with default options -. More...

void	SetFormat (const Standard_CString form, const Standard_Boolean reset=Standard_True)
	Sets a specific Format for Sending Reals (main format) (Default from Creation is "%E") If <reset> is given True (default), this call clears effects of former calls to SetFormatForRange and SetZeroSuppress. More...

void	SetFormatForRange (const Standard_CString form, const Standard_Real R1, const Standard_Real R2)
	Sets a secondary Format for Real, to be applied between R1 and R2 (in absolute values). A Call to SetRealForm cancels this secondary form if <reset> is True. (Default from Creation is "%f" between 0.1 and 1000.) Warning : if the condition (0. <= R1 < R2) is not fulfilled, this secondary form is canceled. More...

void	SetZeroSuppress (const Standard_Boolean mode)
	Sets Sending Real Parameters to suppress trailing Zeros and Null Exponent ("E+00"), if <mode> is given True, Resets this mode if <mode> is False (in addition to Real Forms) A call to SetRealFrom resets this mode to False ig <reset> is given True (Default from Creation is True) More...

void	SetDefaults (const Standard_Integer chars=0)
	Sets again options to the defaults given by Create. More...

void	Options (Standard_Boolean &zerosup, Standard_Boolean &range, Standard_Real &R1, Standard_Real &R2) const
	Returns active options : <zerosup> is the option ZeroSuppress, <range> is True if a range is set, False else R1,R2 give the range (if it is set) More...

Standard_CString	MainFormat () const
	Returns the main format was C++ : return const. More...

Standard_CString	FormatForRange () const
	Returns the format for range, if set Meaningful only if <range> from Options is True was C++ : return const. More...

Standard_Integer	Write (const Standard_Real val, const Standard_CString text) const
	Writes a Real value <val> to a string <text> by using the options. Returns the useful Length of produced string. It calls the class method Convert. Warning : <text> is assumed to be wide enough (20-30 is correct) And, even if declared in, its content will be modified. More...

Static Public Member Functions
static Standard_Integer	Convert (const Standard_Real val, const Standard_CString text, const Standard_Boolean zerosup, const Standard_Real Range1, const Standard_Real Range2, const Standard_CString mainform, const Standard_CString rangeform)
	This class method converts a Real Value to a string, given options given as arguments. It can be called independently. Warning : even if declared in, content of <text> will be modified. More...

Detailed Description

This class converts a floating number (Real) to a string It can be used if the standard C-C++ output functions (sprintf or std::cout<<) are not convenient. That is to say :

to suppress trailing '0' and 'E+00' (if desired)
to control exponent output and floating point output

Formats are given in the form used by printf-sprintf

Constructor & Destructor Documentation

◆ Interface_FloatWriter()

Interface_FloatWriter::Interface_FloatWriter ( const Standard_Integer chars = 0 )

Creates a FloatWriter ready to work, with default options -.

zero suppress option is set
main format is set to "%E"
secondary format is set to "%f" for values between 0.1 and

in absolute values If <chars> is given (and positive), it will produce options to produce this count of characters : "%<chars>f","%<chars>%E"

Member Function Documentation

◆ Convert()

static Standard_Integer Interface_FloatWriter::Convert	(	const Standard_Real	val,
		const Standard_CString	text,
		const Standard_Boolean	zerosup,
		const Standard_Real	Range1,
		const Standard_Real	Range2,
		const Standard_CString	mainform,
		const Standard_CString	rangeform
	)

static

This class method converts a Real Value to a string, given options given as arguments. It can be called independently. Warning : even if declared in, content of <text> will be modified.

◆ FormatForRange()

Standard_CString Interface_FloatWriter::FormatForRange ( ) const

Returns the format for range, if set Meaningful only if <range> from Options is True was C++ : return const.

◆ MainFormat()

Standard_CString Interface_FloatWriter::MainFormat ( ) const

Returns the main format was C++ : return const.

◆ Options()

void Interface_FloatWriter::Options	(	Standard_Boolean &	zerosup,
		Standard_Boolean &	range,
		Standard_Real &	R1,
		Standard_Real &	R2
	)		const

Returns active options : <zerosup> is the option ZeroSuppress, <range> is True if a range is set, False else R1,R2 give the range (if it is set)

◆ SetDefaults()

void Interface_FloatWriter::SetDefaults ( const Standard_Integer chars = 0 )

Sets again options to the defaults given by Create.

◆ SetFormat()

void Interface_FloatWriter::SetFormat	(	const Standard_CString	form,
		const Standard_Boolean	reset = `Standard_True`
	)

Sets a specific Format for Sending Reals (main format) (Default from Creation is "%E") If <reset> is given True (default), this call clears effects of former calls to SetFormatForRange and SetZeroSuppress.

◆ SetFormatForRange()

void Interface_FloatWriter::SetFormatForRange	(	const Standard_CString	form,
		const Standard_Real	R1,
		const Standard_Real	R2
	)

Sets a secondary Format for Real, to be applied between R1 and R2 (in absolute values). A Call to SetRealForm cancels this secondary form if <reset> is True. (Default from Creation is "%f" between 0.1 and 1000.) Warning : if the condition (0. <= R1 < R2) is not fulfilled, this secondary form is canceled.

◆ SetZeroSuppress()

void Interface_FloatWriter::SetZeroSuppress ( const Standard_Boolean mode )

Sets Sending Real Parameters to suppress trailing Zeros and Null Exponent ("E+00"), if <mode> is given True, Resets this mode if <mode> is False (in addition to Real Forms) A call to SetRealFrom resets this mode to False ig <reset> is given True (Default from Creation is True)

◆ Write()

Standard_Integer Interface_FloatWriter::Write	(	const Standard_Real	val,
		const Standard_CString	text
	)		const

Writes a Real value <val> to a string <text> by using the options. Returns the useful Length of produced string. It calls the class method Convert. Warning : <text> is assumed to be wide enough (20-30 is correct) And, even if declared in, its content will be modified.

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

Interface_FloatWriter.hxx

Interface_FloatWriter Class Reference

Public Member Functions

Static Public Member Functions