nihil.core/next_word.ccm


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

// This source code is released into the public domain.
export module nihil.core:next_word;

import nihil.std;

import :ctype;
import :skipws;

namespace nihil {

// Return the next word from a string_view.  Skips leading whitespace, so
// calling this repeatedly will return each word from the string.
export template <typename Char>
[[nodiscard]]
auto next_word(std::basic_string_view<Char> text, std::locale const &locale = std::locale())
	-> std::pair<std::basic_string_view<Char>, std::basic_string_view<Char>>
{
	text = skipws(text, locale);

	auto is_space = ctype_is(std::ctype_base::space, locale);
	auto split_pos = std::ranges::find_if(text, is_space);

	return {{std::ranges::begin(text), split_pos}, {split_pos, std::ranges::end(text)}};
}

export template <typename Char>
auto next_word(std::basic_string_view<Char> *text, std::locale const &locale = std::locale())
	-> std::basic_string_view<Char>
{
	auto [word, rest] = next_word(*text, locale);
	*text = rest;
	return word;
}

} // namespace nihil