PRETTIFIED_FILE_OUTPUTFORMATTER Class Reference

#include <richio.h>

Inheritance diagram for PRETTIFIED_FILE_OUTPUTFORMATTER:

Public Member Functions
	PRETTIFIED_FILE_OUTPUTFORMATTER (const wxString &aFileName, KICAD_FORMAT::FORMAT_MODE aFormatMode=KICAD_FORMAT::FORMAT_MODE::NORMAL, const wxChar *aMode=wxT("wt"), char aQuoteChar='"' )
	~PRETTIFIED_FILE_OUTPUTFORMATTER ()
bool	Finish () override
	Runs prettification over the buffered bytes, writes them to the sibling temp file, fsyncs, and atomically renames the temp file over the final target.
virtual const char *	GetQuoteChar (const char *wrapee) const
	Perform quote character need determination.
int PRINTF_FUNC_N	Print (int nestLevel, const char *fmt,...)
	Format and write text to the output stream.
int PRINTF_FUNC	Print (const char *fmt,...)
	Format and write text to the output stream.
int	Indent (int aNestLevel)
	Write the leading whitespace for a nesting level, with no other output.
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

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.

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

Private Attributes
std::unique_ptr< SIBLING_TEMP_FILE >	m_tempFile
	< sibling temp file, committed by Finish()
std::string	m_buf
KICAD_FORMAT::FORMAT_MODE	m_mode
std::vector< char >	m_buffer
char	quoteChar [2]

Detailed Description

Definition at line 522 of file richio.h.

Constructor & Destructor Documentation

PRETTIFIED_FILE_OUTPUTFORMATTER()

PRETTIFIED_FILE_OUTPUTFORMATTER::PRETTIFIED_FILE_OUTPUTFORMATTER	(	const wxString &	aFileName,
		KICAD_FORMAT::FORMAT_MODE	aFormatMode = KICAD_FORMAT::FORMAT_MODE::NORMAL,
		const wxChar *	aMode = wxT( "wt" ),
		char	aQuoteChar = '"' )

Definition at line 695 of file richio.cpp.

References ADVANCED_CFG::GetCfg(), IO, m_mode, m_tempFile, OUTPUTFMTBUFZ, and OUTPUTFORMATTER::OUTPUTFORMATTER().

~PRETTIFIED_FILE_OUTPUTFORMATTER()

PRETTIFIED_FILE_OUTPUTFORMATTER::~PRETTIFIED_FILE_OUTPUTFORMATTER ( )

default

References Finish(), and write().

Member Function Documentation

Finish()

bool PRETTIFIED_FILE_OUTPUTFORMATTER::Finish ( )

overridevirtual

Runs prettification over the buffered bytes, writes them to the sibling temp file, fsyncs, and atomically renames the temp file over the final target.

A crash or power loss anywhere in this sequence leaves the final target byte-identical to its prior contents. A failure before the rename leaves the original contents intact; a directory-flush failure after the rename throws even though the new contents are already visible, because only their durability is in doubt.

Finish() must be called at most once. Calling it again (whether the commit succeeded or failed) is a programming error.

Returns

true on successful commit.

Exceptions

IO_ERROR

if prettification, fwrite, fsync, close, rename, or the directory flush fails.

Reimplemented from OUTPUTFORMATTER.

Definition at line 710 of file richio.cpp.

References _, m_buf, m_mode, m_tempFile, KICAD_FORMAT::Prettify(), and THROW_IO_ERRORF.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), CopySexprFile(), LIBRARY_MANAGER::CreateGlobalTable(), PCBNEW_JOBS_HANDLER::runFpLibMerge(), FP_CACHE::Save(), LIBRARY_TABLE::Save(), PCB_IO_KICAD_SEXPR::SaveBoard(), SCH_IO_KICAD_SEXPR::SaveSchematicFile(), NETLIST_EXPORTER_KICAD::writeNetlist(), and ~PRETTIFIED_FILE_OUTPUTFORMATTER().

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 372 of file richio.cpp.

References GetQuoteChar(), and 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 338 of file richio.cpp.

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

Indent()

int OUTPUTFORMATTER::Indent ( int aNestLevel )

inherited

Write the leading whitespace for a nesting level, with no other output.

Parameters

aNestLevel

The multiple of spaces to write.

Returns

int - the number of characters output.

Exceptions

IO_ERROR,if

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

Definition at line 416 of file richio.cpp.

References NESTWIDTH, and sprint().

Referenced by BOOST_AUTO_TEST_CASE(), DSN::WIRE::Format(), and Print().

Print() [1/2]

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

inherited

Format and write text to the output stream.

Parameters

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 449 of file richio.cpp.

References result, and vprint().

Print() [2/2]

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 432 of file richio.cpp.

References Indent(), and vprint().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), CopySexprFile(), COMPONENT::Format(), COMPONENT_NET::Format(), DSN::ANCESTOR::Format(), DSN::BOUNDARY::Format(), DSN::CIRCLE::Format(), DSN::CLASS::Format(), DSN::COMP_ORDER::Format(), DSN::COMPONENT::Format(), DSN::CONTROL::Format(), DSN::ELEM::Format(), DSN::FROMTO::Format(), DSN::GRID::Format(), DSN::IMAGE::Format(), DSN::KEEPOUT::Format(), DSN::LAYER::Format(), DSN::LAYER_NOISE_WEIGHT::Format(), DSN::LAYER_RULE::Format(), DSN::NET::Format(), DSN::NET_OUT::Format(), DSN::PADSTACK::Format(), DSN::PATH::Format(), DSN::PCB::Format(), DSN::PIN::Format(), DSN::PLACE::Format(), DSN::POINT::Format(), DSN::PROPERTY::Format(), DSN::QARC::Format(), DSN::RECTANGLE::Format(), DSN::RULE::Format(), DSN::SESSION::Format(), DSN::SHAPE::Format(), DSN::SPECCTRA_LAYER_PAIR::Format(), DSN::STRINGPROP::Format(), DSN::SUPPLY_PIN::Format(), DSN::TOKPROP::Format(), DSN::UNIT_RES::Format(), DSN::VIA::Format(), DSN::WINDOW::Format(), DSN::WIRE::Format(), DSN::WIRE_VIA::Format(), EDA_TEXT::Format(), LINE_ENDING::Format(), NETLIST::Format(), PAGE_INFO::Format(), PCB_CALCULATOR_DATAFILE::Format(), PCB_PLOT_PARAMS::Format(), STROKE_PARAMS::Format(), TEMPLATE_FIELDNAME::Format(), TEMPLATES::Format(), TITLE_BLOCK::Format(), XNODE::Format(), formatArc(), formatBezier(), BOARD_STACKUP::FormatBoardStackup(), KICAD_FORMAT::FormatBool(), formatCircle(), DSN::CLASSES::FormatContents(), DSN::HISTORY::FormatContents(), DSN::IMAGE::FormatContents(), DSN::PADSTACK::FormatContents(), DSN::PARSER::FormatContents(), DSN::PLACEMENT::FormatContents(), DSN::REGION::FormatContents(), DSN::ROUTE::FormatContents(), DSN::WAS_IS::FormatContents(), XNODE::FormatContents(), KICAD_FORMAT::FormatCustomProperties(), formatDrillSpan(), formatEllipse(), formatEllipseArc(), formatFill(), DSN::PIN_REF::FormatIt(), SCH_IO_KICAD_SEXPR_LIB_CACHE::formatLibraryHeader(), formatNode(), KICAD_FORMAT::FormatOptBool(), formatPinMapOverride(), formatPoly(), formatRect(), KICAD_FORMAT::FormatStreamData(), KICAD_FORMAT::FormatUuid(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveArc(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveBezier(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveCircle(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveDocFile(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::savePin(), SCH_IO_KICAD_SEXPR_LIB_CACHE::savePin(), SCH_IO_KICAD_SEXPR_LIB_CACHE::savePinMapData(), SCH_IO_KICAD_LEGACY_LIB_CACHE::savePolyLine(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveRectangle(), SCH_IO_KICAD_LEGACY_LIB_CACHE::SaveSymbol(), SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveText(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveTextBox(), PANEL_REGULATOR::WriteDataFile(), NETLIST_EXPORTER_SPICE::WriteDirectives(), SPICE_CIRCUIT_MODEL::WriteDirectives(), EMBEDDED_FILES::WriteEmbeddedFiles(), NETLIST_EXPORTER_SPICE::WriteHead(), NETLIST_EXPORTER_SPICE_MODEL::WriteHead(), PCB_CALCULATOR_DATAFILE::WriteHeader(), NETLIST_EXPORTER_SPICE::writeInclude(), NETLIST_EXPORTER_SPICE::writeItems(), NETLIST_EXPORTER_SPICE::writeModels(), NETLIST_EXPORTER_SPICE::WriteTail(), and NETLIST_EXPORTER_SPICE_MODEL::WriteTail().

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 466 of file richio.cpp.

Referenced by BOOST_AUTO_TEST_CASE(), formatNode(), Quotew(), and SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol().

Quotew()

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

inherited

Definition at line 505 of file richio.cpp.

References Quotes().

Referenced by COMPONENT::Format(), COMPONENT_NET::Format(), EDA_TEXT::Format(), PAGE_INFO::Format(), PCB_CALCULATOR_DATAFILE::Format(), PCB_PLOT_PARAMS::Format(), TEMPLATE_FIELDNAME::Format(), TITLE_BLOCK::Format(), formatArc(), formatBezier(), BOARD_STACKUP::FormatBoardStackup(), formatCircle(), XNODE::FormatContents(), KICAD_FORMAT::FormatCustomProperties(), formatDrillSpan(), formatEllipse(), formatEllipseArc(), formatPinMapOverride(), formatPoly(), formatRect(), KICAD_FORMAT::FormatUuid(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveField(), SCH_IO_KICAD_SEXPR_LIB_CACHE::savePin(), SCH_IO_KICAD_SEXPR_LIB_CACHE::savePinMapData(), SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveText(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveTextBox(), EMBEDDED_FILES::WriteEmbeddedFiles(), and PCB_CALCULATOR_DATAFILE::WriteHeader().

sprint()

int OUTPUTFORMATTER::sprint ( const char * fmt, ... )

privateinherited

Definition at line 404 of file richio.cpp.

References vprint().

Referenced by Indent().

vprint()

int OUTPUTFORMATTER::vprint ( const char * fmt, va_list ap )

privateinherited

Definition at line 378 of file richio.cpp.

References m_buffer, and write().

Referenced by Print(), Print(), and sprint().

write()

void PRETTIFIED_FILE_OUTPUTFORMATTER::write ( const char * aOutBuf, int aCount )

overrideprotectedvirtual

Should be coded in the interface implementation (derived) classes.

Parameters

aOutBuf	is the start of a byte buffer to write.
aCount	tells how many bytes to write.

Exceptions

IO_ERROR,if

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

Implements OUTPUTFORMATTER.

Definition at line 733 of file richio.cpp.

References m_buf.

Referenced by ~PRETTIFIED_FILE_OUTPUTFORMATTER().

Member Data Documentation

m_buf

std::string PRETTIFIED_FILE_OUTPUTFORMATTER::m_buf

private

Definition at line 554 of file richio.h.

Referenced by Finish(), and write().

m_buffer

std::vector<char> OUTPUTFORMATTER::m_buffer

privateinherited

Definition at line 415 of file richio.h.

Referenced by OUTPUTFORMATTER(), and vprint().

m_mode

KICAD_FORMAT::FORMAT_MODE PRETTIFIED_FILE_OUTPUTFORMATTER::m_mode

private

Definition at line 555 of file richio.h.

Referenced by Finish(), and PRETTIFIED_FILE_OUTPUTFORMATTER().

m_tempFile

std::unique_ptr<SIBLING_TEMP_FILE> PRETTIFIED_FILE_OUTPUTFORMATTER::m_tempFile

private

< sibling temp file, committed by Finish()

Definition at line 553 of file richio.h.

Referenced by Finish(), and PRETTIFIED_FILE_OUTPUTFORMATTER().

quoteChar

char OUTPUTFORMATTER::quoteChar[2]

privateinherited

Definition at line 416 of file richio.h.

Referenced by GetQuoteChar(), and OUTPUTFORMATTER().

---

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

• richio.h
• richio.cpp