ExchangeFileContents
Lade ...
Suche ...
Keine Treffer
eut::StdStringFunctions-Namensbereichsreferenz

Hilfsfunktionen für die Verarbeitung von Strings. Mehr ...

Aufzählungen

enum  EnCoutColor {
  eCOLOR_DEFAULT = 0 , eCOLOR_BLACK = 1 , eCOLOR_BLUE = 2 , eCOLOR_GREEN = 3 ,
  eCOLOR_LIGHTBLUE = 4 , eCOLOR_RED = 5 , eCOLOR_MAGENTA = 6 , eCOLOR_YELLOW = 7 ,
  eCOLOR_LIGHTGRAY = 8 , eCOLOR_GRAY = 9 , eCOLOR_WHITE = 10
}
 
enum  EnStrPos { eBEFORE , eBEHIND , eBOTH }
 

Funktionen

template<typename T >
std::string toHexstr (const T &rValue, std::size_t hex_len=sizeof(T)<< 1)
 
__tool_export_dll bool isAnInteger (const std::string &rstr)
 
__tool_export_dll void fillString (std::string &rstr, char cFillItem, std::size_t nNumber, EnStrPos ePos)
 
__tool_export_dll char * getFilledString (const char *pch, char cFillItem, std::size_t nNumber, EnStrPos ePos)
 
__tool_export_dll std::string getFilledString (const std::string &rstr, char cFillItem, std::size_t nNumber, EnStrPos ePos)
 
__tool_export_dll void tokenizeString (const std::string &rstrSource, std::vector< std::string > &rTokensVector, const std::string &rstrDelimiters=" ")
 
__tool_export_dll void tokenizeString (const std::string &rstrSource, std::vector< std::string > &rTokensVector, const char &rcDelimiters=' ')
 
__tool_export_dll void tokenizeString (const std::wstring &rwsSource, std::vector< std::wstring > &rTokensVector, wchar_t wcDelimiters=L' ')
 
__tool_export_dll std::size_t replaceAll (std::string &rstrText, const char pzOriginal, const char pzNew)
 
__tool_export_dll std::size_t replaceAll (std::string &rstrText, std::vector< std::size_t > &rPosVector, const char pzOriginal, const char pzNew)
 
__tool_export_dll std::wstring string2wstring (const std::string &rsSourceString)
 
__tool_export_dll std::string wstring2string (const std::wstring &rwsSourceString)
 
__tool_export_dll WORD setColorConsoleCout (EnCoutColor eForeGroundColor, EnCoutColor eBackGroundColor)
 
__tool_export_dll void resetColorConsoleCout (WORD wScreenBufferInfo)
 
__tool_export_dll std::string toLower (const std::string &rstr)
 Wandelt alle Großbuchstaben der übergebenen Zeichenkette in Kleinbuchstaben.
 
__tool_export_dll std::wstring toLower (const std::wstring &rstr)
 Wandelt alle Großbuchstaben der übergebenen Zeichenkette in Kleinbuchstaben.
 
__tool_export_dll std::string toUpper (const std::string &rstr)
 Wandelt alle Kleinbuchstaben der übergebenen Zeichenkette in Großbuchstaben.
 
__tool_export_dll std::wstring toUpper (const std::wstring &rstr)
 Wandelt alle Kleinbuchstaben der übergebenen Zeichenkette in Großbuchstaben.
 
__tool_export_dll void trimString (std::string &rstr, char c=' ', EnStrPos ePos=eBEFORE)
 Trim für std::string inspiriert durch:
 
__tool_export_dll void trimString (std::wstring &rstr, wchar_t c=' ', EnStrPos ePos=eBEFORE)
 Trim für std::string inspiriert durch:
 
__tool_export_dll bool insertIfNotAvailable (std::string &rsText, std::size_t nPos, const std::string &rsIns)
 Fügt eine Zeichenkette an übergebener Position ein, wenn noch nicht vorhanden.
 
__tool_export_dll bool insertIfNotAvailable (std::wstring &rsText, std::size_t nPos, const std::wstring &rsIns)
 Fügt eine Zeichenkette an übergebener Position ein, wenn noch nicht vorhanden.
 
__tool_export_dll std::size_t replaceAll (std::string &rsText, const std::string &rsFnd, const std::string &rsRep)
 Tauscht in einem String alle gesuchten Teilstrings mit einem anderen übergebenen String aus.
 
__tool_export_dll std::size_t replaceAll (std::wstring &rsText, const std::wstring &rsFnd, const std::wstring &rsRep)
 Tauscht in einem String alle gesuchten Teilstrings mit einem anderen übergebenen String aus.
 
__tool_export_dll bool compareWildcardString (const std::string &rsSearchString, const std::string &rsString)
 Vergleicht zwei std::string's.
 
__tool_export_dll bool compareWildcardString (const std::wstring &rsSearchString, const std::wstring &rsString)
 Vergleicht zwei std::string's.
 
__tool_export_dll void colorConsoleCout (const std::string &rsCoutText, EnCoutColor eForeGroundColor, EnCoutColor eBackGroundColor)
 Gibt auf der Konsole einen String farbig aus.
 
__tool_export_dll void colorConsoleCout (const std::wstring &rsCoutText, EnCoutColor eForeGroundColor, EnCoutColor eBackGroundColor)
 Gibt auf der Konsole einen String farbig aus.
 

Ausführliche Beschreibung

Hilfsfunktionen für die Verarbeitung von Strings.

Autor
Helmut Jakoby

Dokumentation der Aufzählungstypen

◆ EnCoutColor

Farbcodes für std::cout Ausgaben in der Konsole.

Aufzählungswerte
eCOLOR_DEFAULT 
eCOLOR_BLACK 
eCOLOR_BLUE 
eCOLOR_GREEN 
eCOLOR_LIGHTBLUE 
eCOLOR_RED 
eCOLOR_MAGENTA 
eCOLOR_YELLOW 
eCOLOR_LIGHTGRAY 
eCOLOR_GRAY 
eCOLOR_WHITE 

◆ EnStrPos

Positionierung im String für StdStringFunctions::fillString(std::string&, char, std::size_t, EnStrPos)

Aufzählungswerte
eBEFORE 

Es soll am Anfang eingefügt bzw. entfernt werden.

eBEHIND 

Es soll am Ende eingefügt bzw. entfernt werden.

eBOTH 

Es soll am Anfang und am Ende eingefügt bzw. entfernt werden.

Dokumentation der Funktionen

◆ colorConsoleCout() [1/2]

__tool_export_dll void eut::StdStringFunctions::colorConsoleCout ( const std::string & rsCoutText,
EnCoutColor eForeGroundColor,
EnCoutColor eBackGroundColor )

Gibt auf der Konsole einen String farbig aus.

Parameter
[in]rsCoutTextDer auszugebende Text.
[in]eForeGroundColorDie Vordergrund- sprich Textfarbe.
[in]eBackGroundColorDie Hinterdergrundfarbe.

◆ colorConsoleCout() [2/2]

__tool_export_dll void eut::StdStringFunctions::colorConsoleCout ( const std::wstring & rsCoutText,
EnCoutColor eForeGroundColor,
EnCoutColor eBackGroundColor )

Gibt auf der Konsole einen String farbig aus.

Parameter
[in]rsCoutTextDer auszugebende Text.
[in]eForeGroundColorDie Vordergrund- sprich Textfarbe.
[in]eBackGroundColorDie Hinterdergrundfarbe.

◆ compareWildcardString() [1/2]

__tool_export_dll bool eut::StdStringFunctions::compareWildcardString ( const std::string & rsSearchString,
const std::string & rsString )

Vergleicht zwei std::string's.

Der Suchstring kann Platzhaltern (wildcards '*' und '?') enthalten.

Geschrieben von Jack Handy - jakkhandy@hotmail.com

Siehe auch
https://www.codeproject.com/Articles/1088/Wildcard-string-compare-globbing

Beispiele:

Parameter
[in]rsSearchStringDer Suchstring ggf. mit Platzhaltern.
[in]rsStringDer Vergleichsstring, mit dem der Suchstring verglichen wird.
Rückgabe
Wenn true, entspricht der Suchestring dem übergebenen Vergleichsstring.
Autor
Jack Handy

◆ compareWildcardString() [2/2]

__tool_export_dll bool eut::StdStringFunctions::compareWildcardString ( const std::wstring & rsSearchString,
const std::wstring & rsString )

Vergleicht zwei std::string's.

Der Suchstring kann Platzhaltern (wildcards '*' und '?') enthalten.

Geschrieben von Jack Handy - jakkhandy@hotmail.com

Siehe auch
https://www.codeproject.com/Articles/1088/Wildcard-string-compare-globbing

Beispiele:

Parameter
[in]rsSearchStringDer Suchstring ggf. mit Platzhaltern.
[in]rsStringDer Vergleichsstring, mit dem der Suchstring verglichen wird.
Rückgabe
Wenn true, entspricht der Suchestring dem übergebenen Vergleichsstring.
Autor
Jack Handy

◆ fillString()

__tool_export_dll void eut::StdStringFunctions::fillString ( std::string & rstr,
char cFillItem,
std::size_t nNumber,
EnStrPos ePos )

Füllt übergebenen String am Anfang oder am Ende mit Zeichen auf.

Parameter
[in,out]rstrReferenz auf den String, der aufgefüllt werden soll.
[in]cFillItemDas Zeichen mit dem aufgefüllt werden soll.
[in]nNumberDie angestrebte Stringlänge.
[in]ePosGibt an ob am Anfang und/oder am Ende aufgefüllt werden soll.
Zu beachten
StdStringFunctions::eBOTH wird als StdStringFunctions::eBEHIND interpretiert!

◆ getFilledString() [1/2]

__tool_export_dll char * eut::StdStringFunctions::getFilledString ( const char * pch,
char cFillItem,
std::size_t nNumber,
EnStrPos ePos )

Füllt ein übergebenes 0-terminiertes Char-Array am Anfang oder am Ende mit Zeichen auf.

Parameter
[in,out]pchZeiger auf das 0-terminierte Char-Array, welches aufgefüllt werden soll.
[in]cFillItemDas Zeichen mit dem aufgefüllt werden soll.
[in]nNumberDie angestrebte Stringlänge.
[in]ePosGibt an ob am Anfang oder am Ende aufgefüllt werden soll.
Rückgabe
Das rsultierende 0-terminierte Char-Array.
Zu beachten
StdStringFunctions::rBOTH wird als StdStringFunctions::eBEHIND interpretiert!.
Achtung
Wenn ein gültiger Zeiger geliefert wird, muss die aufrufende Instanz das gelieferteChar-Array mittels delete[] aus dem Speicher entfernen!

◆ getFilledString() [2/2]

__tool_export_dll std::string eut::StdStringFunctions::getFilledString ( const std::string & rstr,
char cFillItem,
std::size_t nNumber,
EnStrPos ePos )

Füllt ein übergebenen std::string am Anfang oder am Ende mit Zeichen auf.

Parameter
[in,out]rstrZeichenkett, welches aufgefüllt werden soll.
[in]cFillItemDas Zeichen mit dem aufgefüllt werden soll.
[in]nNumberDie angestrebte Stringlänge.
[in]ePosGibt an ob am Anfang oder am Ende aufgefüllt werden soll.
Rückgabe
Das rsultierende 0-terminierte Char-Array.
Zu beachten
StdStringFunctions::rBOTH wird als StdStringFunctions::eBEHIND interpretiert!.

◆ insertIfNotAvailable() [1/2]

__tool_export_dll bool eut::StdStringFunctions::insertIfNotAvailable ( std::string & rsText,
std::size_t nPos,
const std::string & rsIns )

Fügt eine Zeichenkette an übergebener Position ein, wenn noch nicht vorhanden.

Parameter
[in,out]rsTextIn diesem String wird an übergebener Position nPos die übergebene Zeichenkette rsIns eingefügt, wenn noch nicht vorhanden.
[in]nPosDie Position in rsText wo geprüft und ggf. eingefügt wird.
[in]rsInsDie zu prüfende und ggf. einzufügende Zeichenfolge.
Rückgabe
Wenn true, wurde rsIns eingefügt, ansonsten passierte nichts.

◆ insertIfNotAvailable() [2/2]

__tool_export_dll bool eut::StdStringFunctions::insertIfNotAvailable ( std::wstring & rsText,
std::size_t nPos,
const std::wstring & rsIns )

Fügt eine Zeichenkette an übergebener Position ein, wenn noch nicht vorhanden.

Parameter
[in,out]rsTextIn diesem String wird an übergebener Position nPos die übergebene Zeichenkette rsIns eingefügt, wenn noch nicht vorhanden.
[in]nPosDie Position in rsText wo geprüft und ggf. eingefügt wird.
[in]rsInsDie zu prüfende und ggf. einzufügende Zeichenfolge.
Rückgabe
Wenn true, wurde rsIns eingefügt, ansonsten passierte nichts.

◆ isAnInteger()

__tool_export_dll bool eut::StdStringFunctions::isAnInteger ( const std::string & rstr)

Überprüft die übergebene Zeichenkette, ob sie eine ganze Zahl darstellt.

Parameter
[in]rstrReferenz auf die zu prüfende Zeichenkette.
Rückgabe
Wenn 'true', stellt die übergebene Zeichenkette eine ganze Zahl dar.

◆ replaceAll() [1/4]

__tool_export_dll std::size_t eut::StdStringFunctions::replaceAll ( std::string & rsText,
const std::string & rsFnd,
const std::string & rsRep )

Tauscht in einem String alle gesuchten Teilstrings mit einem anderen übergebenen String aus.

Parameter
[in,out]rsTextIn diesem String werden alle Zeichenfolgen aus strFnd entfernt und anstelle dieser die Zeichenfolge aus strRep eingefügt.
[in]rsFndDie auszutauschende Zeichenfolge.
[in]rsRepDie einzufügende Zeichenfolge.
Rückgabe
Ein Rückgabwert > 0 ist die Anzahl der getauschten Zeichenfolgen. Ein Rückgabwert == 0 bedeutet, dass nichts getauscht wurde.

◆ replaceAll() [2/4]

__tool_export_dll std::size_t eut::StdStringFunctions::replaceAll ( std::string & rstrText,
const char pzOriginal,
const char pzNew )

Tauscht in einem String alle gesuchten Zeichen mit einem anderen übergebenen Zeichen aus.

Parameter
[in,out]rstrTextIn diesem String werden alle Zeichen aus pzOriginal entfernt und anstelle dieses die Zeichenfolge aus pzNew eingefügt.
[in]pzOriginalDas auszutauschende Zeichen.
[in]pzNewDas einzufügende Zeichen.
Rückgabe
Ein Rückgabwert > 0 ist die Anzahl der getauschten Zeichen. Ein Rückgabwert == 0 bedeutet, dass nichts getauscht wurde.

◆ replaceAll() [3/4]

__tool_export_dll std::size_t eut::StdStringFunctions::replaceAll ( std::string & rstrText,
std::vector< std::size_t > & rPosVector,
const char pzOriginal,
const char pzNew )

Tauscht in einem String alle gesuchten Zeichen mit einem anderen übergebenen Zeichen aus und trägt die jeweiligen Positionen in übergebenen Vector ein.

Parameter
[in,out]rstrTextIn diesem String werden alle Zeichen aus pzOriginal entfernt und anstelle dieses die Zeichenfolge aus pzNew eingefügt.
[in,out]rPosVectorDie Positionen mit den ausgetauschten Zeichen.
[in]pzOriginalDas auszutauschende Zeichen.
[in]pzNewDas einzufügende Zeichen.
Rückgabe
Ein Rückgabwert > 0 ist die Anzahl der getauschten Zeichen. Ein Rückgabwert == 0 bedeutet, dass nichts getauscht wurde.

◆ replaceAll() [4/4]

__tool_export_dll std::size_t eut::StdStringFunctions::replaceAll ( std::wstring & rsText,
const std::wstring & rsFnd,
const std::wstring & rsRep )

Tauscht in einem String alle gesuchten Teilstrings mit einem anderen übergebenen String aus.

Parameter
[in,out]rsTextIn diesem String werden alle Zeichenfolgen aus strFnd entfernt und anstelle dieser die Zeichenfolge aus strRep eingefügt.
[in]rsFndDie auszutauschende Zeichenfolge.
[in]rsRepDie einzufügende Zeichenfolge.
Rückgabe
Ein Rückgabwert > 0 ist die Anzahl der getauschten Zeichenfolgen. Ein Rückgabwert == 0 bedeutet, dass nichts getauscht wurde.

◆ resetColorConsoleCout()

__tool_export_dll void eut::StdStringFunctions::resetColorConsoleCout ( WORD wScreenBufferInfo)

Setzt die Schriftfarbe der Konsole auf Standardfarbe für die nächste Ausgabe.

Parameter
[in]wScreenBufferInfoDas CONSOLE_SCREEN_BUFFER_INFO Attribut.

◆ setColorConsoleCout()

__tool_export_dll WORD eut::StdStringFunctions::setColorConsoleCout ( EnCoutColor eForeGroundColor,
EnCoutColor eBackGroundColor )

Setzt die Schriftfarbe der Konsole auf eine Farbe für die nächste Ausgabe.

Parameter
[in]eForeGroundColorDie Vordergrund- sprich Textfarbe.
[in]eBackGroundColorDie Hinterdergrundfarbe.
Rückgabe
Das ursprüngliche CONSOLE_SCREEN_BUFFER_INFO Attribute, wird benötigt um den ursprünglichen Zustand wieder herzustellen.

◆ string2wstring()

__tool_export_dll std::wstring eut::StdStringFunctions::string2wstring ( const std::string & rsSourceString)

Konvertiert einen std::string in einen std::wstring.

Parameter
[in]rsSourceStringDer zu konvertierende std::string.
Rückgabe
Der resulrierende std::wstring.
Ausnahmebehandlung
Eskann bei Übergabe von UTF-16 Zeichen ein "range_error" geworfen werden

◆ toHexstr()

template<typename T >
std::string eut::StdStringFunctions::toHexstr ( const T & rValue,
std::size_t hex_len = sizeof(T) << 1 )

Liefert übergebenen Ganzzahl-Wert in eine Hex-String um.
Gefunden: https://newbedev.com/integer-to-hex-string-in-c

Parameter
[in]rValueDer Zahlwert.
[in]hex_lenDie Größe des Zahlwerts.
Rückgabe
Die übergebene Zahlwert in der hexadezimalen Darstellung in einem std::string.

◆ tokenizeString() [1/3]

__tool_export_dll void eut::StdStringFunctions::tokenizeString ( const std::string & rstrSource,
std::vector< std::string > & rTokensVector,
const char & rcDelimiters = ' ' )

Liefert aus einem String alle Teilstrings, welche durch ein Zeichen getrennt sind, in einem Vector.

Parameter
[in]rstrSourceDer Quellstring aus dem Teistrings geliefert werden.
[in,out]rTokensVectorDer Vector, in dem die Teistrings geliefert werden.
[in]rcDelimitersDas Zeichen, welche den Quellstring in Teistrings gliedert.
Siehe auch
Aus https://stackoverflow.com/questions/9823263/string-tokenization-in-c-including-delimiter-characters übernommen.

◆ tokenizeString() [2/3]

__tool_export_dll void eut::StdStringFunctions::tokenizeString ( const std::string & rstrSource,
std::vector< std::string > & rTokensVector,
const std::string & rstrDelimiters = " " )

Liefert aus einem String alle Teilstrings, welche durch ein Zeichen getrennt sind, in einem Vector.

Parameter
[in]rstrSourceDer Quellstring aus dem Teistrings geliefert werden.
[in,out]rTokensVectorDer Vector, in dem die Teilstrings geliefert werden.
[in]rstrDelimitersDas Zeichen, welche den Quellstring in Teistrings gliedert.
Siehe auch
Aus https://stackoverflow.com/questions/9823263/string-tokenization-in-c-including-delimiter-characters übernommen.

◆ tokenizeString() [3/3]

__tool_export_dll void eut::StdStringFunctions::tokenizeString ( const std::wstring & rwsSource,
std::vector< std::wstring > & rTokensVector,
wchar_t wcDelimiters = L' ' )

Liefert aus einem WString alle Teilstrings, welche durch ein Zeichen getrennt sind, in einem Vector.

Parameter
[in]rwsSourceDer Quellstring aus dem Teistrings geliefert werden.
[in,out]rTokensVectorDer Vector, in dem die Teistrings geliefert werden.
[in]wcDelimitersDas Zeichen, welche den Quellstring in Teistrings gliedert.

◆ toLower() [1/2]

__tool_export_dll std::string eut::StdStringFunctions::toLower ( const std::string & rstr)

Wandelt alle Großbuchstaben der übergebenen Zeichenkette in Kleinbuchstaben.

Parameter
[in,out]rstrDie Referenz auf die zu verarbeitende Zeichenkette.
Rückgabe
Das Kleinbuchstaben-Äquivalent von rstr.

◆ toLower() [2/2]

__tool_export_dll std::wstring eut::StdStringFunctions::toLower ( const std::wstring & rstr)

Wandelt alle Großbuchstaben der übergebenen Zeichenkette in Kleinbuchstaben.

Parameter
[in,out]rstrDie Referenz auf die zu verarbeitende Zeichenkette.
Rückgabe
Das Kleinbuchstaben-Äquivalent von rstr.

◆ toUpper() [1/2]

__tool_export_dll std::string eut::StdStringFunctions::toUpper ( const std::string & rstr)

Wandelt alle Kleinbuchstaben der übergebenen Zeichenkette in Großbuchstaben.

Parameter
[in,out]rstrDie Referenz auf die zu verarbeitende Zeichenkette.
Rückgabe
Das Großbuchstaben-Äquivalent von rstr.

◆ toUpper() [2/2]

__tool_export_dll std::wstring eut::StdStringFunctions::toUpper ( const std::wstring & rstr)

Wandelt alle Kleinbuchstaben der übergebenen Zeichenkette in Großbuchstaben.

Parameter
[in,out]rstrDie Referenz auf die zu verarbeitende Zeichenkette.
Rückgabe
Das Großbuchstaben-Äquivalent von rstr.

◆ trimString() [1/2]

__tool_export_dll void eut::StdStringFunctions::trimString ( std::string & rstr,
char c = ' ',
EnStrPos ePos = eBEFORE )

Trim für std::string inspiriert durch:

Rodrigo C F Dias

Software Engineering Degree

Living in Natal, Brazil

Siehe auch
http://www.codeproject.com/Articles/10880/A-trim-implementation-for-std-string
Parameter
[in,out]rstrReferenz auf den String, der von führenden und anhängenden Zeichen befreit werden soll.
[in]cDas Zeichen welches entfernt werden soll. Wenn rstr == "XXXTestX" und c =='X' und ePos == eBOTH, wird aus rstr == "Test".
[in]ePosGibt an ob am Anfang und/oder am Ende entfernt werden soll.
Autor
Rodrigo C F Dias

◆ trimString() [2/2]

__tool_export_dll void eut::StdStringFunctions::trimString ( std::wstring & rstr,
wchar_t c = ' ',
EnStrPos ePos = eBEFORE )

Trim für std::string inspiriert durch:

Rodrigo C F Dias

Software Engineering Degree

Living in Natal, Brazil

Siehe auch
http://www.codeproject.com/Articles/10880/A-trim-implementation-for-std-string
Parameter
[in,out]rstrReferenz auf den String, der von führenden und anhängenden Zeichen befreit werden soll.
[in]cDas Zeichen welches entfernt werden soll. Wenn rstr == "XXXTestX" und c =='X' und ePos == eBOTH, wird aus rstr == "Test".
[in]ePosGibt an ob am Anfang und/oder am Ende entfernt werden soll.
Autor
Rodrigo C F Dias

◆ wstring2string()

__tool_export_dll std::string eut::StdStringFunctions::wstring2string ( const std::wstring & rwsSourceString)

Konvertiert einen std::wstring in einen std::string.

Parameter
[in]rwsSourceStringDer zu konvertierende std::wstring.
Rückgabe
Der resulrierende std::string.
Zu beachten
Es wird n icht in UTF-8 oder sonstige Code-Page gewandelt, sondern nur die Bytes übertragen.