SlHelpers::String Class Reference

Various helpers on strings. More...

#include <String.h>

Classes
struct	Eq
	Equality test for string and string_view to be used in containers. More...
struct	Hash
	Hash for string and string_view to be used in hashing containers. More...

Public Member Functions
template<std::ranges::input_range Range, typename Output >
requires	requires (std::ostream &out, Output output, std::ranges::range_reference_t< Range > e)
	Join iterable into out using separator sep, calling output. More...

Static Public Member Functions
template<typename I = unsigned>
requires static std::is_integral_v< I > std::optional< I >	toNum (std::string_view str, int base=10) noexcept
	Convert str to a number.
static bool constexpr	iEqual (unsigned char a, unsigned char b) noexcept
	Compare two characters ignoring case.
static constexpr std::string_view::size_type	iFind (std::string_view str, std::string_view sub) noexcept
	Like string::find() but ignoring case. More...
static constexpr bool	iStartsWith (std::string_view str, std::string_view prefix) noexcept
	Like string::starts_with() but ignoring case. More...
static constexpr bool	iEndsWith (std::string_view str, std::string_view suffix) noexcept
	Like string::ends_with() but ignoring case. More...
static std::vector< std::string_view >	splitSV (std::string_view str, std::string_view delim, std::optional< char > comment=std::nullopt) noexcept
	Split str by delim into a vector, ignoring everything after comment. More...
template<typename T >
static constexpr T	trim (const T &line) noexcept
	Trim string (remove surrounding whitespace) More...
static constexpr bool	isHex (std::string_view s) noexcept
	Is the string consisting of hex number? More...
static void	join (std::ostream &out, Range &&iterable, Output output, std::string_view sep=", ")
template<std::ranges::input_range Range>
static void	join (std::ostream &out, Range &&iterable, std::string_view sep=", ", std::string_view quote="")
	Join iterable into out using separator sep and quoting quote. More...

Static Public Attributes
static constinit const auto	npos = std::string_view::npos
	A local alias for std::string_view::npos.

Detailed Description

Various helpers on strings.

Member Function Documentation

iEndsWith()

static constexpr bool SlHelpers::String::iEndsWith ( std::string_view  str, std::string_view  suffix  )

inlinestaticnoexcept

Like string::ends_with() but ignoring case.

Parameters

str	string to search in
suffix	string to search for

Returns

true if str ends with suffix, false otherwise

iFind()

static constexpr std::string_view::size_type SlHelpers::String::iFind ( std::string_view  str, std::string_view  sub  )

inlinestaticnoexcept

Like string::find() but ignoring case.

Parameters

str	string to search in
sub	string to search for

Returns

position of sub in str if found, npos otherwise

isHex()

static constexpr bool SlHelpers::String::isHex ( std::string_view  s )

inlinestaticnoexcept

Is the string consisting of hex number?

Parameters

s	String to inspect

Returns

true if all characters are hex numbers

iStartsWith()

static constexpr bool SlHelpers::String::iStartsWith ( std::string_view  str, std::string_view  prefix  )

inlinestaticnoexcept

Like string::starts_with() but ignoring case.

Parameters

str	string to search in
prefix	string to search for

Returns

true if str starts with prefix, false otherwise

join()

template<std::ranges::input_range Range>

static void SlHelpers::String::join ( std::ostream &  out, Range &&  iterable, std::string_view  sep = ", ", std::string_view  quote = ""  )

inlinestatic

Join iterable into out using separator sep and quoting quote.

Parameters

out	Output stream
iterable	Input container
sep	Separator
quote	Quoting string, it is put before and after each value in iterable

requires()

template<std::ranges::input_range Range, typename Output >

requires SlHelpers::String::requires ( std::ostream &  out, Output  output, std::ranges::range_reference_t< Range >  e  )

inline

Join iterable into out using separator sep, calling output.

Parameters

out	Output stream
iterable	Input container
output	Called for every member; it should output the member to out
sep	Separator

splitSV()

static std::vector<std::string_view> SlHelpers::String::splitSV ( std::string_view  str, std::string_view  delim, std::optional< char >  comment = std::nullopt  )

inlinestaticnoexcept

Split str by delim into a vector, ignoring everything after comment.

Parameters

str	String to parse
delim	Delimeter to split by
comment	Ignore string after character

Returns

Vector built of str.

Note str must outlive the use of the return value!

trim()

template<typename T >

static constexpr T SlHelpers::String::trim ( const T &  line )

inlinestaticnoexcept

Trim string (remove surrounding whitespace)

Parameters

line	String to trim

Returns

Trimmed string.

---

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

• /home/abuild/rpmbuild/BUILD/slhelpers-20260626.4928fc7/include/helpers/String.h