An 8 bit string that is assuredly encoded in UTF8, and supplies special conversion support to and from wxString, to and from std::string, and has non-mutating iteration over Unicode characters. More...

#include <utf8.h>

Classes
class	uni_iter
	uni_iter is a non-mutating iterator that walks through unicode code points in the UTF8 encoded string. More...

Public Member Functions
	UTF8 (const wxString &o)

	UTF8 (const char *txt)
	This is a constructor for which you could end up with non-UTF8 encoding, but that would be your fault.

	UTF8 (const wchar_t *txt)
	For use with _() function on wx 2.8.

	UTF8 (const std::string &o)

	UTF8 (const UTF8 &o)

	UTF8 ()

	~UTF8 ()

const char *	c_str () const

bool	empty () const

std::string::size_type	find (char c) const

std::string::size_type	find (char c, size_t s) const

void	clear ()

std::string::size_type	length () const

std::string::size_type	size () const

int	compare (const std::string &s) const

bool	operator== (const UTF8 &rhs) const

bool	operator== (const std::string &rhs) const

bool	operator== (const char *s) const

bool	operator!= (const UTF8 &rhs) const

bool	operator< (const UTF8 &rhs) const

bool	operator> (const UTF8 &rhs) const

std::string::size_type	find_first_of (const std::string &str, std::string::size_type pos=0) const

UTF8 &	operator+= (const UTF8 &str)

UTF8 &	operator+= (char ch)

UTF8 &	operator+= (const char *s)

UTF8 &	operator+= (unsigned w_ch)
	Append a wide (unicode) char to the UTF8 string.

UTF8 &	operator= (const wxString &o)

UTF8 &	operator= (const std::string &o)

UTF8 &	operator= (const char *s)

UTF8 &	operator= (char c)

UTF8 &	operator= (const UTF8 &aOther)

UTF8 &	operator= (UTF8 &&aOther) noexcept

std::string	substr (size_t pos=0, size_t len=npos) const

	operator const std::string & () const

wxString	wx_str () const

	operator wxString () const

std::string::const_iterator	begin () const

std::string::const_iterator	end () const

uni_iter	ubegin () const
	Returns a uni_iter initialized to the start of "this" UTF8 byte sequence.

uni_iter	uend () const
	Return a uni_iter initialized to the end of "this" UTF8 byte sequence.

Static Public Member Functions
static int	uni_forward (const unsigned char aSequence, unsigned aResult=nullptr)
	Advance over a single UTF8 encoded multibyte character, capturing the Unicode character as it goes, and returning the number of bytes consumed.

Static Public Attributes
static constexpr std::string::size_type	npos = -1

Protected Attributes
std::string	m_s

Detailed Description

An 8 bit string that is assuredly encoded in UTF8, and supplies special conversion support to and from wxString, to and from std::string, and has non-mutating iteration over Unicode characters.

I've been careful to supply only conversion facilities and not try and duplicate wxString() with many member functions. There are multiple ways to create text into a std::string without the need of too many member functions:

std::ostringstream.

Because this class uses no virtuals, it should be possible to cast any std::string into a UTF8 using this kind of cast: (UTF8 &) without construction or copying being the effect of the cast. Be sure the source std::string holds UTF8 encoded text before you do that.

Definition at line 66 of file utf8.h.

Constructor & Destructor Documentation

◆ UTF8() [1/6]

UTF8::UTF8 ( const wxString & o )

Definition at line 35 of file utf8.cpp.

References m_s.

Referenced by operator!=(), operator+=(), operator+=(), operator+=(), operator+=(), operator<(), operator=(), operator=(), operator=(), operator=(), operator=(), operator=(), operator==(), operator>(), and UTF8().

◆ UTF8() [2/6]

UTF8::UTF8 ( const char * txt )

inline

This is a constructor for which you could end up with non-UTF8 encoding, but that would be your fault.

Definition at line 73 of file utf8.h.

References c_str(), m_s, and MAYBE_VERIFY_UTF8.

◆ UTF8() [3/6]

UTF8::UTF8 ( const wchar_t * txt )

For use with _() function on wx 2.8.

BTW _() on wx >= 2.9 returns wxString, not wchar_t* like on 2.8.

Definition at line 203 of file utf8.cpp.

References m_s.

◆ UTF8() [4/6]

UTF8::UTF8 ( const std::string & o )

inline

Definition at line 83 of file utf8.h.

References c_str(), m_s, and MAYBE_VERIFY_UTF8.

◆ UTF8() [5/6]

UTF8::UTF8 ( const UTF8 & o )

inline

Definition at line 89 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ UTF8() [6/6]

UTF8::UTF8 ( )

inline

Definition at line 95 of file utf8.h.

◆ ~UTF8()

UTF8::~UTF8 ( )

inline

Definition at line 99 of file utf8.h.

Member Function Documentation

◆ begin()

std::string::const_iterator UTF8::begin ( ) const

inline

Definition at line 215 of file utf8.h.

References m_s.

Referenced by LIBRARY_TABLE::FormatOptions().

◆ c_str()

const char * UTF8::c_str ( ) const

inline

◆ clear()

void UTF8::clear ( )

inline

Definition at line 110 of file utf8.h.

References m_s.

◆ compare()

int UTF8::compare ( const std::string & s ) const

inline

Definition at line 113 of file utf8.h.

References m_s.

◆ empty()

bool UTF8::empty ( ) const

inline

Definition at line 105 of file utf8.h.

References m_s.

Referenced by PCB_IO_EAGLE::centerBoard(), SCH_SCREENS::GetLibNicknames(), SCH_SCREENS::HasNoFullyDefinedLibIds(), FOOTPRINT_EDITOR_CONTROL::Init(), SYMBOL_EDITOR_CONTROL::Init(), PCB_IO_CADSTAR_ARCHIVE::LoadBoard(), PCB_EDIT_FRAME::OpenProjectFiles(), DIALOG_SYMBOL_REMAP::remapSymbolToLibTable(), PCBNEW_JOBS_HANDLER::runFpLibMerge(), LIB_TREE::setState(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), SYMBOL_EDIT_FRAME::setupUIConditions(), FOOTPRINT_EDITOR_CONTROL::tryToSaveFootprintInLibrary(), and FOOTPRINT_EDIT_FRAME::UpdateTitle().

◆ end()

std::string::const_iterator UTF8::end ( ) const

inline

Definition at line 216 of file utf8.h.

References m_s.

Referenced by LIBRARY_TABLE::FormatOptions().

◆ find() [1/2]

std::string::size_type UTF8::find ( char c ) const

inline

Definition at line 107 of file utf8.h.

References m_s.

Referenced by LIB_ID::Parse().

◆ find() [2/2]

std::string::size_type UTF8::find	(	char	c,
		size_t	s ) const

inline

Definition at line 108 of file utf8.h.

References m_s.

◆ find_first_of()

std::string::size_type UTF8::find_first_of	(	const std::string &	str,
		std::string::size_type	pos = 0 ) const

inline

Definition at line 123 of file utf8.h.

References m_s.

Referenced by checkLibNickname().

◆ length()

std::string::size_type UTF8::length ( ) const

inline

Definition at line 111 of file utf8.h.

References m_s.

Referenced by PLACE_FILE_EXPORTER::GenPositionData().

◆ operator const std::string &()

UTF8::operator const std::string & ( ) const

inline

Definition at line 206 of file utf8.h.

References m_s.

◆ operator wxString()

UTF8::operator wxString ( ) const

Definition at line 47 of file utf8.cpp.

References c_str().

◆ operator!=()

bool UTF8::operator!= ( const UTF8 & rhs ) const

inline

Definition at line 119 of file utf8.h.

References operator==(), and UTF8().

◆ operator+=() [1/4]

UTF8 & UTF8::operator+= ( char ch )

inline

Definition at line 136 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator+=() [2/4]

UTF8 & UTF8::operator+= ( const char * s )

inline

Definition at line 143 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator+=() [3/4]

UTF8 & UTF8::operator+= ( const UTF8 & str )

inline

Definition at line 129 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator+=() [4/4]

UTF8 & UTF8::operator+= ( unsigned w_ch )

Append a wide (unicode) char to the UTF8 string.

if this wide char is not a ASCII7 char, it will be added as a UTF8 multibyte sequence

Parameters

w_ch	is a UTF-16 value (can be a UTF-32 on Linux)

Definition at line 221 of file utf8.cpp.

References m_s, substr(), and UTF8().

◆ operator<()

bool UTF8::operator< ( const UTF8 & rhs ) const

inline

Definition at line 120 of file utf8.h.

References m_s, and UTF8().

◆ operator=() [1/6]

UTF8 & UTF8::operator= ( char c )

inline

Definition at line 175 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator=() [2/6]

UTF8 & UTF8::operator= ( const char * s )

inline

Definition at line 168 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator=() [3/6]

UTF8 & UTF8::operator= ( const std::string & o )

inline

Definition at line 161 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator=() [4/6]

UTF8 & UTF8::operator= ( const UTF8 & aOther )

inline

Definition at line 182 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator=() [5/6]

UTF8 & UTF8::operator= ( const wxString & o )

Definition at line 53 of file utf8.cpp.

References m_s, and UTF8().

◆ operator=() [6/6]

UTF8 & UTF8::operator= ( UTF8 && aOther )

inlinenoexcept

Definition at line 190 of file utf8.h.

References c_str(), m_s, MAYBE_VERIFY_UTF8, and UTF8().

◆ operator==() [1/3]

bool UTF8::operator== ( const char * s ) const

inline

Definition at line 117 of file utf8.h.

References m_s.

◆ operator==() [2/3]

bool UTF8::operator== ( const std::string & rhs ) const

inline

Definition at line 116 of file utf8.h.

References m_s.

◆ operator==() [3/3]

bool UTF8::operator== ( const UTF8 & rhs ) const

inline

Definition at line 115 of file utf8.h.

References m_s, and UTF8().

Referenced by operator!=().

◆ operator>()

bool UTF8::operator> ( const UTF8 & rhs ) const

inline

Definition at line 121 of file utf8.h.

References m_s, and UTF8().

◆ size()

std::string::size_type UTF8::size ( ) const

inline

Definition at line 112 of file utf8.h.

References m_s.

Referenced by LIB_ID::Format(), LIBRARY_TABLE::FormatOptions(), guessNickname(), and LoadNetlistFootprints().

◆ substr()

std::string UTF8::substr	(	size_t	pos = 0,
		size_t	len = npos ) const

inline

Definition at line 201 of file utf8.h.

References m_s, and npos.

Referenced by PDF_OUTLINE_FONT_MANAGER::EncodeString(), operator+=(), LIB_ID::Parse(), PDF_OUTLINE_FONT_SUBSET::sanitizeFontName(), and PDF_PLOTTER::Text().

◆ ubegin()

uni_iter UTF8::ubegin ( ) const

inline

Returns a uni_iter initialized to the start of "this" UTF8 byte sequence.

Definition at line 301 of file utf8.h.

References m_s.

Referenced by KIGFX::OPENGL_GAL::computeBitmapTextSize(), and LIB_ID::FixIllegalChars().

◆ uend()

uni_iter UTF8::uend ( ) const

inline

Return a uni_iter initialized to the end of "this" UTF8 byte sequence.

Definition at line 309 of file utf8.h.

References m_s.

Referenced by KIGFX::OPENGL_GAL::computeBitmapTextSize(), and LIB_ID::FixIllegalChars().

◆ uni_forward()

int UTF8::uni_forward	(	const unsigned char *	aSequence,
		unsigned *	aResult = nullptr )

static

Advance over a single UTF8 encoded multibyte character, capturing the Unicode character as it goes, and returning the number of bytes consumed.

Parameters

aSequence	is the UTF8 byte sequence, must be aligned on start of character.
aResult	is where to put the unicode character, and may be NULL if no interest.

Returns: the count of bytes consumed.

Definition at line 63 of file utf8.cpp.

Referenced by IsUTF8(), UTF8::uni_iter::operator*(), UTF8::uni_iter::operator++(), UTF8::uni_iter::operator++(), and UTF8::uni_iter::operator->().

◆ wx_str()

wxString UTF8::wx_str ( ) const

Definition at line 41 of file utf8.cpp.

References c_str().

Referenced by COMPONENTS_MANAGER::AddComponent(), SCH_SCREEN::AddLibSymbol(), BOARD_NETLIST_UPDATER::addNewFootprint(), CVPCB_ASSOCIATION_TOOL::Associate(), CVPCB_MAINFRAME::AssociateFootprint(), BASIC_FOOTPRINT_INFO::BASIC_FOOTPRINT_INFO(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), PANEL_DESIGN_BLOCK_LIB_TABLE::browseLibrariesHandler(), PANEL_FP_LIB_TABLE::browseLibrariesHandler(), SCH_SCREENS::ChangeSymbolLibNickname(), DIPTRACE::SCH_PARSER::componentSymbolName(), CADSTAR_SCH_ARCHIVE_LOADER::CreateLibName(), SYMBOL_PREVIEW_WIDGET::DisplaySymbol(), PCBNEW_JOBS_HANDLER::doFpExportSvg(), SYMBOL_SAVE_AS_HANDLER::DoSave(), BOARD::ExchangeFootprint(), LIB_TREE_MODEL_ADAPTER::FindItem(), LEGACY_SYMBOL_LIBS::FindLibSymbol(), RESCUE_SYMBOL_LIB_TABLE_CANDIDATE::FindRescues(), LEGACY_SYMBOL_LIB::FindSymbol(), SCH_IO_KICAD_SEXPR::Format(), DESIGN_BLOCK_TREE_MODEL_ADAPTER::GenerateInfo(), DESIGN_BLOCK_PANE::GetDesignBlock(), DIPTRACE::SCH_PARSER::getLibName(), SCH_IO_ALTIUM::getLibName(), SCH_IO_EAGLE::getLibName(), SCH_IO_GEDA::getLibName(), GetSafeRootSymbol(), PCB_IO_KICAD_LEGACY::loadFOOTPRINT(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromLibrary(), PCB_IO_KICAD_LEGACY::loadFP_SHAPE(), LoadNetlistFootprints(), PCB_IO_KICAD_LEGACY::loadPAD(), SCH_IO_DATABASE::loadSymbolFromRow(), SCH_EDIT_FRAME::OpenProjectFiles(), PANEL_SYMBOL_CHOOSER::populateFootprintSelector(), CVPCB_MAINFRAME::readNetListAndFpFiles(), DIALOG_SYMBOL_REMAP::remapSymbolsToLibTable(), DIALOG_SYMBOL_REMAP::remapSymbolToLibTable(), BOARD_NETLIST_UPDATER::replaceFootprint(), SYMBOL_EDIT_FRAME::Revert(), PCBNEW_JOBS_HANDLER::runFpLibMerge(), SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol(), SCH_IO_KICAD_SEXPR::saveSymbol(), SchGetLibSymbol(), PCB_BASE_FRAME::SelectFootprintFromLibrary(), LIB_SYMBOL::SetLibId(), DIALOG_EDIT_SYMBOLS_LIBID::setLibIdByBrowser(), LIB_SYMBOL::SetName(), FOOTPRINTS_LISTBOX::SetSelectedFootprint(), PANEL_SYMBOL_CHOOSER::showFootprintFor(), BOARD_NETLIST_UPDATER::testConnectivity(), DIALOG_PLUGIN_OPTIONS::TransferDataFromWindow(), and BOARD_NETLIST_UPDATER::UpdateNetlist().

Member Data Documentation

◆ m_s

std::string UTF8::m_s

protected

Definition at line 325 of file utf8.h.

Referenced by begin(), c_str(), clear(), compare(), empty(), end(), find(), find(), find_first_of(), length(), operator const std::string &(), operator+=(), operator+=(), operator+=(), operator+=(), operator<(), operator=(), operator=(), operator=(), operator=(), operator=(), operator=(), operator==(), operator==(), operator==(), operator>(), size(), substr(), ubegin(), uend(), UTF8(), UTF8(), UTF8(), UTF8(), and UTF8().

◆ npos

std::string::size_type UTF8::npos = -1

staticconstexpr

Definition at line 157 of file utf8.h.

Referenced by LIB_ID::Parse(), and substr().

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

Classes

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ UTF8() [1/6]

◆ UTF8() [2/6]

◆ UTF8() [3/6]

◆ UTF8() [4/6]

◆ UTF8() [5/6]

◆ UTF8() [6/6]

◆ ~UTF8()

Member Function Documentation

◆ begin()

◆ c_str()

◆ clear()

◆ compare()

◆ empty()

◆ end()

◆ find() [1/2]

◆ find() [2/2]

◆ find_first_of()

◆ length()

◆ operator const std::string &()

◆ operator wxString()

◆ operator!=()

◆ operator+=() [1/4]

◆ operator+=() [2/4]

◆ operator+=() [3/4]

◆ operator+=() [4/4]

◆ operator<()

◆ operator=() [1/6]

◆ operator=() [2/6]

◆ operator=() [3/6]

◆ operator=() [4/6]

◆ operator=() [5/6]

◆ operator=() [6/6]

◆ operator==() [1/3]

◆ operator==() [2/3]

◆ operator==() [3/3]

◆ operator>()

◆ size()

◆ substr()

◆ ubegin()

◆ uend()

◆ uni_forward()

◆ wx_str()

Member Data Documentation

◆ m_s

◆ npos