xieite::toupper()

`xieite::toupper()`

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

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

Declarations

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

Makes a single character uppercase. 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> toupper(std::basic_string_view<Ch, Traits> strv, Alloc&& alloc = {}) noexcept(false);

Makes an entire string uppercase. Internally calls #0.

#2

template<typename Ch, typename Traits = std::char_traits<Ch>, typename Alloc = std::allocator<Ch>>
[[nodiscard]] constexpr auto toupper(const std::basic_string<Ch, Traits, Alloc>& str, Alloc&& alloc = {})
	XIEITE_ARROW(xieite::toupper(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 toupper(const Ch(& str)[n], Alloc&& alloc = {})
	XIEITE_ARROW(xieite::toupper(xieite::str_view<Ch, Traits>(str), XIEITE_FWD(alloc)))

Defers to #1 after deducing Ch and possibly Alloc.

Example

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

Output:

HELLO, WORLD!

[View in Compiler Explorer]