STRING_FORMATTER implements OUTPUTFORMATTER to a memory buffer. More...

#include <richio.h>

Inheritance diagram for STRING_FORMATTER:

Public Member Functions
	STRING_FORMATTER (int aReserve=OUTPUTFMTBUFZ, char aQuoteChar='"' )
	Constructor STRING_FORMATTER reserves space in the buffer. More...

void	Clear ()
	Function Clear clears the buffer and empties the internal string. More...

void	StripUseless ()
	Function StripUseless removes whitespace, '(', and ')' from the mystring. More...

const std::string &	GetString ()

virtual const char *	GetQuoteChar (const char *wrapee)
	Function GetQuoteChar performs quote character need determination. More...

int PRINTF_FUNC	Print (int nestLevel, const char *fmt,...)
	Function Print formats and writes text to the output stream. More...

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

std::string	Quotew (const wxString &aWrapee)

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

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

Private Attributes
std::string	m_mystring

Detailed Description

STRING_FORMATTER implements OUTPUTFORMATTER to a memory buffer.

After Print()ing the string is available through GetString()

Definition at line 446 of file richio.h.

Constructor & Destructor Documentation

◆ STRING_FORMATTER()

STRING_FORMATTER::STRING_FORMATTER	(	int	aReserve = `OUTPUTFMTBUFZ`,
		char	aQuoteChar = `'"'`
	)

inline

Constructor STRING_FORMATTER reserves space in the buffer.

Definition at line 456 of file richio.h.

                                                                             :
         OUTPUTFORMATTER( aReserve, aQuoteChar )
     {
     }

Member Function Documentation

◆ Clear()

void STRING_FORMATTER::Clear ( )

inline

Function Clear clears the buffer and empties the internal string.

Definition at line 465 of file richio.h.

     {
         m_mystring.clear();
     }

References m_mystring.

Referenced by PCB_IO::GetStringOutput(), and DSN::ELEM::makeHash().

◆ GetQuoteChar() [1/2]

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

staticprotectedinherited

Function GetQuoteChar performs 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: const char* - the quote_char as a single character string, or "" if the wrapee does not need to be wrapped.

Definition at line 331 of file richio.cpp.

 {
     // Include '#' so a symbol is not confused with a comment.  We intend
     // to wrap any symbol starting with a '#'.
     // Our LEXER class handles comments, and comments appear to be an extension
     // to the SPECCTRA DSN specification.
     if( *wrapee == '#' )
         return quote_char;
 
     if( strlen( wrapee ) == 0 )
         return quote_char;
 
     bool isFirst = true;
 
     for(  ; *wrapee;  ++wrapee, isFirst = false )
     {
         static const char quoteThese[] = "\t ()"
             "%"     // per Alfons of freerouting.net, he does not like this unquoted as of 1-Feb-2008
             "{}"    // guessing that these are problems too
             ;
 
         // if the string to be wrapped (wrapee) has a delimiter in it,
         // return the quote_char so caller wraps the wrapee.
         if( strchr( quoteThese, *wrapee ) )
             return quote_char;
 
         if( !isFirst  &&  '-' == *wrapee )
             return quote_char;
     }
 
     return "";  // caller does not need to wrap, can use an unwrapped string.
 }

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().

◆ GetQuoteChar() [2/2]

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

virtualinherited

Function GetQuoteChar performs 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: const char* - the quote_char as a single character string, or "" if the wrapee does not need to be wrapped.

Definition at line 365 of file richio.cpp.

 {
     return GetQuoteChar( wrapee, quoteChar );
 }

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

◆ GetString()

const std::string& STRING_FORMATTER::GetString ( )

inline

Definition at line 476 of file richio.h.

     {
         return m_mystring;
     }

References m_mystring.

Referenced by LIB_EDIT_TOOL::Copy(), SYMBOL_EDIT_FRAME::CopyPartToClipboard(), SCH_EDITOR_CONTROL::doCopy(), PCB_IO::GetStringOutput(), SCH_EDIT_FRAME::KiwayMailIn(), PCB_EDIT_FRAME::KiwayMailIn(), DSN::ELEM::makeHash(), DIALOG_BOARD_REANNOTATE::ReannotateBoard(), CLIPBOARD_IO::Save(), CVPCB_MAINFRAME::SaveFootprintAssociation(), CLIPBOARD_IO::SaveSelection(), SCH_EDIT_FRAME::sendNetlistToCvpcb(), FOOTPRINT_ASYNC_LOADER::Start(), SIM_PLOT_FRAME::StartSimulation(), PANEL_EESCHEMA_TEMPLATE_FIELDNAMES::TransferDataFromWindow(), PANEL_SETUP_BOARD_STACKUP::TransferDataFromWindow(), DIALOG_BOM::~DIALOG_BOM(), and WS_DATA_MODEL_STRINGIO::~WS_DATA_MODEL_STRINGIO().

◆ Print()

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

inherited

Function Print formats and writes 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 408 of file richio.cpp.

 {
 #define NESTWIDTH           2   
 
     va_list     args;
 
     va_start( args, fmt );
 
     int result = 0;
     int total  = 0;
 
     for( int i=0; i<nestLevel;  ++i )
     {
         // no error checking needed, an exception indicates an error.
         result = sprint( "%*c", NESTWIDTH, ' ' );
 
         total += result;
     }
 
     // no error checking needed, an exception indicates an error.
     result = vprint( fmt, args );
 
     va_end( args );
 
     total += result;
     return total;
 }

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

◆ Quotes()

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

virtualinherited

Function Quotes checks 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 wraping in double quotes, and it might need to have its internal content escaped, or not.

Returns: 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 437 of file richio.cpp.

 {
     std::string ret;
 
     ret.reserve( aWrapee.size()*2 + 2 );
 
     ret += '"';
 
     for( std::string::const_iterator it = aWrapee.begin(); it!=aWrapee.end(); ++it )
     {
         switch( *it )
         {
         case '\n':
             ret += '\\';
             ret += 'n';
             break;
         case '\r':
             ret += '\\';
             ret += 'r';
             break;
         case '\\':
             ret += '\\';
             ret += '\\';
             break;
         case '"':
             ret += '\\';
             ret += '"';
             break;
         default:
             ret += *it;
         }
     }
 
     ret += '"';
 
     return ret;
 }

Referenced by PCB_IO::format(), formatNode(), OUTPUTFORMATTER::Quotew(), and SCH_SEXPR_PLUGIN_CACHE::SaveSymbol().

◆ Quotew()

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

inherited

Definition at line 476 of file richio.cpp.

 {
     // wxStrings are always encoded as UTF-8 as we convert to a byte sequence.
     // The non-virutal function calls the virtual workhorse function, and if
     // a different quoting or escaping strategy is desired from the standard,
     // a derived class can overload Quotes() above, but
     // should never be a reason to overload this Quotew() here.
     return Quotes( (const char*) aWrapee.utf8_str() );
 }

References OUTPUTFORMATTER::Quotes().

Referenced by PCB_CALCULATOR_DATAFILE::Format(), COMPONENT_NET::Format(), TEMPLATE_FIELDNAME::Format(), TITLE_BLOCK::Format(), COMPONENT::Format(), LIB_TABLE_ROW::Format(), PAGE_INFO::Format(), PCB_IO::format(), PCB_IO::formatBoardLayers(), BOARD_STACKUP::FormatBoardStackup(), XNODE::FormatContents(), PCB_IO::formatLayer(), PCB_IO::formatLayers(), PCB_IO::formatNetInformation(), PCB_IO::formatProperties(), SCH_SEXPR_PLUGIN_CACHE::saveField(), SCH_SEXPR_PLUGIN_CACHE::savePin(), SCH_SEXPR_PLUGIN_CACHE::SaveSymbol(), SCH_SEXPR_PLUGIN_CACHE::saveText(), PCB_CALCULATOR_DATAFILE::WriteHeader(), and DIALOG_BOM::~DIALOG_BOM().

◆ StripUseless()

void STRING_FORMATTER::StripUseless ( )

Function StripUseless removes whitespace, '(', and ')' from the mystring.

Definition at line 494 of file richio.cpp.

 {
     std::string  copy = m_mystring;
 
     m_mystring.clear();
 
     for( std::string::iterator i=copy.begin();  i!=copy.end();  ++i )
     {
         if( !isspace( *i ) && *i!=')' && *i!='(' && *i!='"' )
         {
             m_mystring += *i;
         }
     }
 }

References m_mystring.

Referenced by DSN::ELEM::makeHash().

◆ write()

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

overrideprotectedvirtual

Function write 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 489 of file richio.cpp.

 {
     m_mystring.append( aOutBuf, aCount );
 }

References m_mystring.

Member Data Documentation

◆ m_mystring

std::string STRING_FORMATTER::m_mystring

private

Definition at line 448 of file richio.h.

Referenced by Clear(), GetString(), StripUseless(), and write().

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

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ STRING_FORMATTER()

Member Function Documentation

◆ Clear()

◆ GetQuoteChar() [1/2]

◆ GetQuoteChar() [2/2]

◆ GetString()

◆ Print()

◆ Quotes()

◆ Quotew()

◆ StripUseless()

◆ write()

Member Data Documentation

◆ m_mystring