xieite::tolower()

`xieite::tolower()`

Defined in header <xieite/ctnr/tolower.hpp>

Converts every character of a string (or a single character) to lowercase.
Only handles the English alphabet.

Declarations

template<xieite::is_ch Ch>
[[nodiscard]] constexpr Ch tolower(Ch c) noexcept;

Makes a single character lowercase. Internally uses a lookup table.

#1

template<typename Ch, typename Traits = std::char_traits<Ch>, typename Alloc = std::allocator<Ch>>
[[nodiscard]] constexpr std::basic_string<Ch, Traits, Alloc> tolower(std::basic_string_view<Ch, Traits> strv, Alloc&& alloc = {}) noexcept(false);

Makes an entire string lowercase. Internally calls #0.

#2

template<typename Ch, typename Traits = std::char_traits<Ch>, typename Alloc = std::allocator<Ch>>
[[nodiscard]] constexpr auto tolower(const std::basic_string<Ch, Traits, Alloc>& str, Alloc&& alloc = {})
	XIEITE_ARROW(xieite::tolower(xieite::str_view(str), XIEITE_FWD(alloc)))

Defers to #1 after deducing Ch, Traits, and Alloc.

#3

template<xieite::is_ch Ch, typename Traits = std::char_traits<Ch>, typename Alloc = std::allocator<Ch>, std::size_t n>
[[nodiscard]] constexpr auto tolower(const Ch(& str)[n], Alloc&& alloc = {})
	XIEITE_ARROW(xieite::tolower(xieite::str_view<Ch, Traits>(str), XIEITE_FWD(alloc)))

Defers to #1 after deducing Ch and possibly Alloc.

Example

int main() {
	xieite::dump(xieite::tolower("HeLlO, wOrLd!"));
}

Output:

hello, world!

[View in Compiler Explorer]