

String

All string operations in the Boden Framework are based on UTF-8 std::strings. The String.h header file is provided to make working with std::string more convenient.

Types

The following types are deprecated and should no longer be used.

namespace bdn {
    using String [[deprecated("Use std::string instead")]] = std::string;
    using StringView [[deprecated("Use std::string_view instead")]] = std::string_view;
}

C++20 Polyfills

• inline bool starts_with(const std::string &haystack, const std::string &needle)

  Returns whether haystack starts with needle.

  Implements a polyfill emulating the std::basic_string::starts_with() function which will be part of the C++20 standard.

• inline bool ends_with(const std::string &haystack, const std::string &needle)

  Returns whether haystack ends with needle.

  Implements a polyfill emulating the std::basic_string::ends_with() function which will be part of the C++20 standard.

Conversion Functions

• std::string stringFromAny(const std::any& anyString)

  Converts an std::any to std::string. Throws std::bad_any_cast if no conversion possible.

  std::any type	calls
  std::string	std::string(std::any_cast<std::string>(any))
  json	(std::string)std::any_cast<json>(any)

Convenience Functions

• std::string fromUtf32(const std::u32string &utf32String)

  Converts the given UTF-32 string to an UTF-8 string.

• std::string fromUtf16(const std::u16string &utf16String)

  Converts the given UTF-16 string to an UTF-8 string.

• std::tuple split(const StringView &view, std::string::value_type token)

  Splits the given string view using the specified token as a delimiter.

• void ltrim(std::string &s)

  Trims whitespace from the start of the given string. The trim operation is performed in place and modifies the given string.

• void rtrim(std::string &s)

  Trims whitespace from the end of the given string. The trim operation is performed in place and modifies the given string.

• void trim(std::string &s)

  Trims whitespace from the start and end of the given string. The trim operation is performed in place and modifies the given string.

• std::string ltrim_copy(std::string s)

  Trims whitespace from the start of the given string. The trim operation does not modify the given string, but returns a trimmed copy instead.

• std::string rtrim_copy(std::string s)

  Trims whitespace from the end of the given string. The trim operation does not modify the given string, but returns a trimmed copy instead.

• std::string trim_copy(std::string s)

  Trims whitespace from the start and end of the given string. The trim operation does not modify the given string, but returns a trimmed copy instead.

Source

String.h