1#ifndef SOURCEMETA_CORE_TEXT_H_
2#define SOURCEMETA_CORE_TEXT_H_
4#ifndef SOURCEMETA_CORE_TEXT_EXPORT
5#include <sourcemeta/core/text_export.h>
9#include <sourcemeta/core/text_static_string.h>
39namespace sourcemeta::core {
54SOURCEMETA_CORE_TEXT_EXPORT
70template <
typename Character>
71 requires std::same_as<Character, char> ||
72 std::same_as<Character, signed char> ||
73 std::same_as<Character, unsigned char> ||
74 std::same_as<Character, wchar_t>
75constexpr auto to_lowercase(
const Character character)
noexcept -> Character {
76 return (character >=
'A' && character <=
'Z')
77 ?
static_cast<Character
>(character + (
'a' -
'A'))
94template <
typename Character,
typename Traits,
typename Allocator>
95 requires requires(Character character) {
98inline auto to_lowercase(std::basic_string<Character, Traits, Allocator> &value)
100 for (
auto &character : value) {
118SOURCEMETA_CORE_TEXT_EXPORT
133template <
typename Character>
134 requires std::same_as<Character, char> ||
135 std::same_as<Character, signed char> ||
136 std::same_as<Character, unsigned char> ||
137 std::same_as<Character, wchar_t>
138constexpr auto is_lowercase(
const Character character)
noexcept ->
bool {
139 return character <
'A' || character >
'Z';
155template <
typename String>
156 requires requires(
const String &value) {
160 for (
const auto character : value) {
181SOURCEMETA_CORE_TEXT_EXPORT
196template <
typename Character>
197 requires std::same_as<Character, char> ||
198 std::same_as<Character, signed char> ||
199 std::same_as<Character, unsigned char> ||
200 std::same_as<Character, wchar_t>
201constexpr auto is_alpha(
const Character character)
noexcept ->
bool {
202 return (character >=
'a' && character <=
'z') ||
203 (character >=
'A' && character <=
'Z');
219constexpr auto is_alpha(
const std::string_view value)
noexcept ->
bool {
223 for (
const auto character : value) {
242template <
typename Character>
243 requires std::same_as<Character, char> ||
244 std::same_as<Character, signed char> ||
245 std::same_as<Character, unsigned char> ||
246 std::same_as<Character, wchar_t>
247constexpr auto is_digit(
const Character character)
noexcept ->
bool {
248 return character >=
'0' && character <=
'9';
264constexpr auto is_digit(
const std::string_view value)
noexcept ->
bool {
268 for (
const auto character : value) {
288template <
typename Character>
289 requires std::same_as<Character, char> ||
290 std::same_as<Character, signed char> ||
291 std::same_as<Character, unsigned char> ||
292 std::same_as<Character, wchar_t>
293constexpr auto is_alphanum(
const Character character)
noexcept ->
bool {
310constexpr auto is_alphanum(
const std::string_view value)
noexcept ->
bool {
314 for (
const auto character : value) {
337template <
typename Character>
338 requires std::same_as<Character, char> ||
339 std::same_as<Character, signed char> ||
340 std::same_as<Character, unsigned char> ||
341 std::same_as<Character, wchar_t>
343 return (character >=
'!' && character <=
'/') ||
344 (character >=
':' && character <=
'@') ||
345 (character >=
'[' && character <=
'`') ||
346 (character >=
'{' && character <=
'~');
364SOURCEMETA_CORE_TEXT_EXPORT
365auto truncate(std::string &input,
const std::size_t maximum_length,
366 const std::string_view marker) -> void;
379SOURCEMETA_CORE_TEXT_EXPORT
380auto replace(
const std::string_view input,
const std::string_view target,
381 const std::string_view replacement) -> std::string;
396SOURCEMETA_CORE_TEXT_EXPORT
397auto trim(
const std::string_view input)
noexcept -> std::string_view;
411SOURCEMETA_CORE_TEXT_EXPORT
412auto strip_left(
const std::string_view input,
const char character)
noexcept
427SOURCEMETA_CORE_TEXT_EXPORT
428auto strip_right(
const std::string_view input,
const char character)
noexcept
443template <
typename Predicate>
444 requires std::predicate<Predicate &, char>
446strip_left(
const std::string_view input, Predicate predicate)
noexcept(
447 std::is_nothrow_invocable_r_v<bool, Predicate &, char> &&
448 std::is_nothrow_copy_constructible_v<Predicate>) -> std::string_view {
449 std::string_view result{input};
450 while (!result.empty() && predicate(result.front())) {
451 result.remove_prefix(1);
469template <
typename Predicate>
470 requires std::predicate<Predicate &, char>
472strip_right(
const std::string_view input, Predicate predicate)
noexcept(
473 std::is_nothrow_invocable_r_v<bool, Predicate &, char> &&
474 std::is_nothrow_copy_constructible_v<Predicate>) -> std::string_view {
475 std::string_view result{input};
476 while (!result.empty() && predicate(result.back())) {
477 result.remove_suffix(1);
496template <
typename Predicate>
497 requires std::predicate<Predicate &, char>
498constexpr auto trim(
const std::string_view input, Predicate predicate)
noexcept(
499 std::is_nothrow_invocable_r_v<bool, Predicate &, char> &&
500 std::is_nothrow_copy_constructible_v<Predicate>) -> std::string_view {
518constexpr auto unquote(
const std::string_view input,
const char quote)
noexcept
519 -> std::string_view {
520 if (input.size() < 2 || input.front() != quote || input.back() != quote) {
525 inner.remove_prefix(1);
526 inner.remove_suffix(1);
542SOURCEMETA_CORE_TEXT_EXPORT
543auto pad_left(
const std::string_view input,
const std::size_t width,
544 const char character) -> std::string;
559SOURCEMETA_CORE_TEXT_EXPORT
560auto take_until(
const std::string_view input,
const char marker)
noexcept
579SOURCEMETA_CORE_TEXT_EXPORT
580auto split_once(
const std::string_view input,
const char delimiter)
noexcept
581 -> std::optional<std::pair<std::string_view, std::string_view>>;
598SOURCEMETA_CORE_TEXT_EXPORT
600 const std::string_view delimiter)
noexcept
601 -> std::optional<std::pair<std::string_view, std::string_view>>;
619SOURCEMETA_CORE_TEXT_EXPORT
620auto rsplit_once(
const std::string_view input,
const char delimiter)
noexcept
621 -> std::optional<std::pair<std::string_view, std::string_view>>;
637template <
typename Callback>
638auto split(
const std::string_view input,
const char delimiter,
639 Callback callback) ->
void {
640 std::string_view rest{input};
643 if (!next.has_value()) {
647 callback(next->first);
667inline auto split(
const std::string_view input,
const char delimiter)
668 -> std::vector<std::string_view> {
669 std::vector<std::string_view> parts;
672 [&parts](
const std::string_view part) ->
void { parts.push_back(part); });
690template <
typename Range>
691auto join(
const Range &items,
const std::string_view separator) -> std::string {
694 for (
const auto &item : items) {
696 result.append(separator);
720template <
typename Range>
721auto join_to(std::ostream &stream,
const Range &items,
722 const std::string_view separator) ->
void {
724 for (
const auto &item : items) {
738template <
typename Type>
740 std::integral<Type> && !std::same_as<std::remove_cv_t<Type>,
bool> &&
741 sizeof(
Type) <=
sizeof(std::uint64_t);
748template <
typename Integer>
751 static_cast<std::size_t
>(std::numeric_limits<Integer>::digits10) + 1 +
752 (std::numeric_limits<Integer>::is_signed ? 1U : 0U)};
784template <
typename Integer, std::
size_t Capacity>
788 std::array<char, Capacity> &buffer)
noexcept
789 -> std::string_view {
791 std::to_chars(buffer.data(), buffer.data() + buffer.size(), value)};
792 return {buffer.data(),
static_cast<std::size_t
>(result.ptr - buffer.data())};
809template <
typename Output,
typename Integer>
810 requires text_spellable_integer<Integer>
812 std::array<char, DIGITS_CAPACITY<Integer>> buffer;
814 output.append(digits.data(), digits.size());
833template <
typename CharT,
typename Traits,
typename Integer>
834 requires text_spellable_integer<Integer>
836 const Integer value) ->
void {
837 std::array<char, DIGITS_CAPACITY<Integer>> buffer;
839 stream.write(digits.data(),
static_cast<std::streamsize
>(digits.size()));
858 static constexpr std::array<std::int8_t, 256> TABLE{
859 {-1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
860 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
861 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 0, 1, 2, 3, 4, 5,
862 6, 7, 8, 9, -1, -1, -1, -1, -1, -1, -1, 10, 11, 12, 13, 14, 15, -1,
863 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
864 -1, -1, -1, -1, -1, -1, -1, 10, 11, 12, 13, 14, 15, -1, -1, -1, -1, -1,
865 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
866 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
867 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
868 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
869 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
870 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
871 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
872 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
874 return TABLE[
static_cast<unsigned char>(character)];
907 const std::size_t position)
noexcept ->
bool {
908 return input.size() >= 3 && position < input.size() - 2 &&
909 input[position] ==
'%' &&
is_hex_digit(input[position + 1]) &&
928SOURCEMETA_CORE_TEXT_EXPORT
930 const bool allow_odd_length =
false)
931 -> std::optional<std::string>;
943SOURCEMETA_CORE_TEXT_EXPORT
967SOURCEMETA_CORE_TEXT_EXPORT
969 const std::span<char> output)
noexcept -> void;
987 const std::string_view right)
noexcept ->
bool {
988 if (left.size() != right.size()) {
992 for (std::size_t index{0}; index < left.size(); ++index) {
1016 const std::string_view prefix)
noexcept
1018 if (value.size() < prefix.size()) {
1022 for (std::size_t index{0}; index < prefix.size(); ++index) {
1046 const std::string_view right)
noexcept ->
bool {
1047 const auto length{left.size() < right.size() ? left.size() : right.size()};
1048 for (std::size_t index{0}; index < length; ++index) {
1051 if (left_lower != right_lower) {
1052 return left_lower < right_lower;
1056 return left.size() < right.size();
1070SOURCEMETA_CORE_TEXT_EXPORT
1071auto squeeze(
const std::string_view input,
const char character) -> std::string;
1088template <
typename Output>
1089auto squeeze(
const std::string_view input,
const char character, Output &output)
1092 for (
const auto value : input) {
1093 if (value == character) {
1095 output.push_back(value);
1100 output.push_back(value);
1121SOURCEMETA_CORE_TEXT_EXPORT
1123 const std::string_view suffix)
noexcept
1124 -> std::string_view;
@ Type
The token type does not match the expected media type.
Definition jose_verify.h:216
constexpr auto is_digit(const char character) -> bool
Definition numeric_util.h:51
SOURCEMETA_CORE_TEXT_EXPORT auto truncate(std::string &input, const std::size_t maximum_length, const std::string_view marker) -> void
auto digits_write(std::basic_ostream< CharT, Traits > &stream, const Integer value) -> void
Definition text.h:835
constexpr auto is_alphanum(const Character character) noexcept -> bool
Definition text.h:293
SOURCEMETA_CORE_TEXT_EXPORT auto to_title_case(std::string &value) -> void
auto digits_append(Output &output, const Integer value) -> void
Definition text.h:811
auto join_to(std::ostream &stream, const Range &items, const std::string_view separator) -> void
Definition text.h:721
constexpr auto to_lowercase(const Character character) noexcept -> Character
Definition text.h:75
SOURCEMETA_CORE_TEXT_EXPORT auto bytes_to_hex(const std::string_view input) -> std::string
auto less_ignore_case(const std::string_view left, const std::string_view right) noexcept -> bool
Definition text.h:1045
auto is_hex_digit(const char character) noexcept -> bool
Definition text.h:889
std::array< char, std::max(DIGITS_CAPACITY< std::uint64_t >, DIGITS_CAPACITY< std::int64_t >)> DigitsBuffer
Definition text.h:759
constexpr auto is_punctuation(const Character character) noexcept -> bool
Definition text.h:342
constexpr auto is_alpha(const Character character) noexcept -> bool
Definition text.h:201
auto split(const std::string_view input, const char delimiter, Callback callback) -> void
Definition text.h:638
SOURCEMETA_CORE_TEXT_EXPORT auto hex_to_bytes(const std::string_view input, const bool allow_odd_length=false) -> std::optional< std::string >
auto digits_view(const Integer value, std::array< char, Capacity > &buffer) noexcept -> std::string_view
Definition text.h:787
auto equals_ignore_case(const std::string_view left, const std::string_view right) noexcept -> bool
Definition text.h:986
SOURCEMETA_CORE_TEXT_EXPORT auto strip_left(const std::string_view input, const char character) noexcept -> std::string_view
constexpr auto unquote(const std::string_view input, const char quote) noexcept -> std::string_view
Definition text.h:518
SOURCEMETA_CORE_TEXT_EXPORT auto replace(const std::string_view input, const std::string_view target, const std::string_view replacement) -> std::string
auto hex_digit_value(const char character) noexcept -> std::int8_t
Definition text.h:855
SOURCEMETA_CORE_TEXT_EXPORT auto remove_suffix_ignore_case(const std::string_view input, const std::string_view suffix) noexcept -> std::string_view
auto join(const Range &items, const std::string_view separator) -> std::string
Definition text.h:691
SOURCEMETA_CORE_TEXT_EXPORT auto strip_right(const std::string_view input, const char character) noexcept -> std::string_view
SOURCEMETA_CORE_TEXT_EXPORT auto trim(const std::string_view input) noexcept -> std::string_view
constexpr auto is_lowercase(const Character character) noexcept -> bool
Definition text.h:138
SOURCEMETA_CORE_TEXT_EXPORT auto squeeze(const std::string_view input, const char character) -> std::string
SOURCEMETA_CORE_TEXT_EXPORT auto take_until(const std::string_view input, const char marker) noexcept -> std::string_view
SOURCEMETA_CORE_TEXT_EXPORT auto rsplit_once(const std::string_view input, const char delimiter) noexcept -> std::optional< std::pair< std::string_view, std::string_view > >
SOURCEMETA_CORE_TEXT_EXPORT auto pad_left(const std::string_view input, const std::size_t width, const char character) -> std::string
auto is_percent_triplet(const std::string_view input, const std::size_t position) noexcept -> bool
Definition text.h:906
SOURCEMETA_CORE_TEXT_EXPORT auto split_once(const std::string_view input, const char delimiter) noexcept -> std::optional< std::pair< std::string_view, std::string_view > >
constexpr std::size_t DIGITS_CAPACITY
Definition text.h:750
auto starts_with_ignore_case(const std::string_view value, const std::string_view prefix) noexcept -> bool
Definition text.h:1015