Used for text file output. More...

#include <richio.h>

Inheritance diagram for FILE_OUTPUTFORMATTER:

Public Member Functions
	FILE_OUTPUTFORMATTER (const wxString &aFileName, const wxChar *aMode=wxT("wt"), char aQuoteChar='"' )

	~FILE_OUTPUTFORMATTER ()

virtual const char *	GetQuoteChar (const char *wrapee) const
	Perform quote character need determination.

int PRINTF_FUNC	Print (int nestLevel, const char *fmt,...)
	Format and write text to the output stream.

virtual std::string	Quotes (const std::string &aWrapee) const
	Check aWrapee input string for a need to be quoted (e.g.

std::string	Quotew (const wxString &aWrapee) const

virtual bool	Finish ()
	Performs any cleanup needed at the end of a write.

Protected Member Functions
void	write (const char *aOutBuf, int aCount) override
	Should be coded in the interface implementation (derived) classes.

Static Protected Member Functions
static const char *	GetQuoteChar (const char wrapee, const char quote_char)
	Perform quote character need determination according to the Specctra DSN specification.

Protected Attributes
FILE *	m_fp
	takes ownership

wxString	m_filename

Private Member Functions
int	sprint (const char *fmt,...)

int	vprint (const char *fmt, va_list ap)

Private Attributes
std::vector< char >	m_buffer

char	quoteChar [2]

Detailed Description

Used for text file output.

It is about 8 times faster than STREAM_OUTPUTFORMATTER for file streams.

Definition at line 477 of file richio.h.

Constructor & Destructor Documentation

◆ FILE_OUTPUTFORMATTER()

FILE_OUTPUTFORMATTER::FILE_OUTPUTFORMATTER	(	const wxString &	aFileName,
		const wxChar *	aMode = `wxT( "wt" )`,
		char	aQuoteChar = `'"'`
	)

Parameters

aFileName	is the full filename to open and save to as a text file.
aMode	is what you would pass to wxFopen()'s mode, defaults to wxT( "wt" ) for text files that are to be created here and now.
aQuoteChar	is a char used for quoting problematic strings (with whitespace or special characters in them).

Exceptions

IO_ERROR if the file cannot be opened.

Definition at line 560 of file richio.cpp.

References m_fp, and THROW_IO_ERROR.

◆ ~FILE_OUTPUTFORMATTER()

FILE_OUTPUTFORMATTER::~FILE_OUTPUTFORMATTER ( )

Definition at line 572 of file richio.cpp.

References m_fp.

Member Function Documentation

◆ Finish()

virtual bool OUTPUTFORMATTER::Finish ( )

inlinevirtualinherited

Performs any cleanup needed at the end of a write.

Returns: true if all is well

Reimplemented in PRETTIFIED_FILE_OUTPUTFORMATTER.

Definition at line 418 of file richio.h.

Referenced by PCB_IO_KICAD_SEXPR::SaveBoard().

◆ GetQuoteChar() [1/2]

const char * OUTPUTFORMATTER::GetQuoteChar ( const char * wrapee ) const

virtualinherited

Perform quote character need determination.

It returns the quote character as a single character string for a given input wrapee string. If the wrappee does not need to be quoted, the return value is "" (the null string), such as when there are no delimiters in the input wrapee string. If you want the quote_char to be assuredly not "", then pass in "(" as the wrappee.

Implementations are free to override the default behavior, which is to call the static function of the same name.

Parameters

wrapee A string that might need wrapping on each end.

Returns: the quote_char as a single character string, or "" if the wrapee does not need to be wrapped.

Definition at line 414 of file richio.cpp.

References OUTPUTFORMATTER::GetQuoteChar(), and OUTPUTFORMATTER::quoteChar.

◆ GetQuoteChar() [2/2]

const char * OUTPUTFORMATTER::GetQuoteChar	(	const char *	wrapee,
		const char *	quote_char
	)

staticprotectedinherited

Perform quote character need determination according to the Specctra DSN specification.

Parameters

wrapee	A string that might need wrapping on each end.
quote_char	A single character C string which provides the current quote character, should it be needed by the wrapee.

Returns: the quote_char as a single character string, or "" if the wrapee does not need to be wrapped.

Definition at line 380 of file richio.cpp.

Referenced by DSN::PROPERTY::Format(), DSN::RECTANGLE::Format(), DSN::LAYER_RULE::Format(), DSN::PATH::Format(), DSN::CIRCLE::Format(), DSN::QARC::Format(), DSN::KEEPOUT::Format(), DSN::VIA::Format(), DSN::LAYER::Format(), DSN::SPECCTRA_LAYER_PAIR::Format(), DSN::STRINGPROP::Format(), DSN::PLACE::Format(), DSN::COMPONENT::Format(), DSN::PIN::Format(), DSN::IMAGE::Format(), DSN::PADSTACK::Format(), DSN::FROMTO::Format(), DSN::COMP_ORDER::Format(), DSN::NET::Format(), DSN::CLASS::Format(), DSN::WIRE::Format(), DSN::WIRE_VIA::Format(), DSN::PCB::Format(), DSN::ANCESTOR::Format(), DSN::SUPPLY_PIN::Format(), DSN::NET_OUT::Format(), DSN::SESSION::Format(), DSN::PARSER::FormatContents(), DSN::CLASSES::FormatContents(), DSN::REGION::FormatContents(), DSN::PADSTACK::FormatContents(), DSN::HISTORY::FormatContents(), DSN::PIN_REF::FormatIt(), and OUTPUTFORMATTER::GetQuoteChar().

◆ Print()

int OUTPUTFORMATTER::Print	(	int	nestLevel,
		const char *	fmt,
			...
	)

inherited

Format and write text to the output stream.

Parameters

nestLevel	The multiple of spaces to precede the output with.
fmt	A printf() style format string.
...	a variable list of parameters that will get blended into the output under control of the format string.

Returns: int - the number of characters output.

Exceptions

IO_ERROR,if there is a problem outputting, such as a full disk.

Definition at line 458 of file richio.cpp.

References NESTWIDTH, OUTPUTFORMATTER::sprint(), and OUTPUTFORMATTER::vprint().

◆ Quotes()

std::string OUTPUTFORMATTER::Quotes ( const std::string & aWrapee ) const

virtualinherited

Check aWrapee input string for a need to be quoted (e.g.

contains a ')' character or a space), and for " double quotes within the string that need to be escaped such that the DSNLEXER will correctly parse the string from a file later.

Parameters

aWrapee is a string that might need wrapping in double quotes, and it might need to have its internal content escaped, or not.

Returns: a std::string- whose c_str() function can be called for passing to printf() style functions that output UTF8 encoded s-expression streams.

Exceptions

IO_ERROR,if there is any kind of problem with the input string.

Definition at line 487 of file richio.cpp.

Referenced by PCB_IO_KICAD_SEXPR::format(), formatNode(), OUTPUTFORMATTER::Quotew(), and SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol().