ticc_string(1)

🌸 NAME 🌸

Okay bestie, welcome to ticc_string(1) from the General Commands Manual — it's giving “C++ string utilities that ate.” 💅 ticc_string is literally a collection of C++ string manipulating utilities. Periodt. 🫶

✨ SYNOPSIS ✨

#include ticcutils/StringOps.h

using namespace TiCC;

💖 DESCRIPTION 💖

Ticc String Utilities serves up a few convenient functions for manipulating C++ string objects. These functions are widely used in the TiCC software stack , but they are of general use too. No gatekeeping, bestie. 🌈

🎀 List of Functions 🎀

• string trim( const string& in, const string& filter= " \t\r\n" ); — Removes from in all leading and trailing characters that are present in filter. Embedded characters are retained. ✨
• string trim_front( const string& in, const string& filter = " \t\r\n" ); — Removes from in all leading characters that are present in filter. Embedded characters are retained. 🦋
• string trim_back( const string& in, const string& filter = " \t\r\n" ); — Removes from in all trailing characters that are present in filter. Embedded characters are retained. 🎀
• void to_lower( string& s ); — Converts all characters in s to lowercase filter. 😭
• void to_upper( string& s ); — Converts all characters in s to uppercase filter. 💜
• string lowercase( const string& in ); — Returns a string that contains the lowercase of the characters in in. 🌸
• string uppercase( const string& in ); — Returns a string that contains the uppercase of the characters in in. 🌸
• size_t split_at( const string& s, vector<string>& vec, const string& sep, bool exact=false ); — Splits the input string s at every position of the string sep and returns the parts in the string vector vec. Consecutive occurrences of sep are all skipped, so vec will never contain empty strings, except when exact is set to true. Return value: the size of vec. 🔥
• size_t split_at_first_of( const string& s, vector<string>& vec, const string& filter, bool exact=false ); — Splits the input string s at every occurrence of one of the characters from filter and returns the parts in the string vector vec. Consecutive occurrences of filter characters are all skipped, so vec will never contain empty strings, except when exact is set to true. Return value: the size of vec. 🔥
• inline size_t split( const string& s, vector<string>& vec, bool exact=false return split_at_first_of( s, vec, " \t\r\n" ); } — Splits the input string s at every occurrence of a whitespace character, and returns the parts in the string vector vec. Consecutive occurrences of filter characters are all skipped, so vec will never contain empty strings, except when exact is set to true. Return value: the size of vec. 💀
• bool match_front( const string& s, const string& f ); — Does the string s start with the string f? 👑
• bool match_back( const string& s, const string& b ); — Does the string s end with the string b? 👑
• template< typename T > T stringTo( const std::string& s ) — Converts the string s into a value of type T. Might throw when the conversion fails. 😭
• template< typename T > bool stringTo( const std::string& s, T& result ) — Converts the string s into a result value of type T; returns false when the conversion fails, otherwise returns true. ✅
• template<> bool stringTo( const std::string& s ) — Converts the string s into a value of type bool. The string values: YES, TRUE, 1 yield true (case insensitive). The string values: NO, FALSE, 0 yield false (case insensitive). Will throw when conversion fails. 🚨
• template< typename T > string toString ( const T& obj ); — Converts the obj of type T to a string. It uses the << output operator for obj, so it will fail if that operator is unavailable. 📝
• string basename( const string& f ); — Returns the basename for filename f. The basename is defined as the string after the last / in f. If there is no / present, it will return the input string f. 🗂️
• string dirname( const string& f ); — Returns the pathname for filename f. The pathname is defined as the string before the last / in f. If there is no / present, it will return .. 🗂️
• string format_nonascii( const string& s ); — Given a string s with possibly unprintable (non-ascii) characters, produces a string where these are replaced by hexadecimal representations. Useful for debugging Unicode stuff. 🧚

🌟 AUTHORS 🌟

Ko van der Sloot — lamasoftware@science.ru.nl 👑

xoxo 💖 — this page is from the General Commands Manual, dated 2015 November 26, and it's ticc_string(1) in all its iconic glory. 💅