UNICODE::ICONVERT::T(3)

💖 UNICODE::ICONVERT::T(3) 💖

okay bestie, so this one lives in the Courier Unicode Library and it's literally the template that takes your text and turns it into unicode. it's giving ✨glow-up✨ but for bytes. no cap.

---

🌈 NAME 🌈

unicode::iconvert::tou — the template for converting a text sequence to unicode 💅

---

🎀 SYNOPSIS 🎀

#include <courier-unicode.h>

auto convert(beg_iter_t &&beg_iter, end_iter_t &&end_iter,
             const std::string &charset, bool &errflag,
             output_iter_t &&output_iter);

bool convert(input_iter_t beg_iter, input_iter_t end_iter,
             const std::string &charset, std::u32string &out_buf);

std::pair<std::u32string, bool> convert(const std::string_view &text,
                                        const std::string &charset);

---

✨ DESCRIPTION ✨

so basically, these template functions take text that's chillin' in some given character set and convert it to unicode characters. it's their whole personality 🦋

beg_iter and end_iter define an input sequence of chars in the charset character set. they get converted to unicode characters, periodt. and output_iter is an output iterator that convert() iterates over char32_ts.

now here's the cute little fork in the road, pay attention 👀:

• if output_iter is an lvalue, then convert()'s parameter is a reference to the output iterator, and that iterator gets updated in place — and convert() returns void.
• if output_iter is an rvalue, then convert() returns the value of the output iterator after it's done iterating over the converted character sequence. slay.

errflag is passed by reference (iykyk), and it gets set to true if some character could not be converted to unicode from the specified character set. it gets set to false if the conversion completed without errors. that's the vibe check right there 😌

there's also an overloaded convert() that skips the output sequence entirely and drops the unicode character sequence into a vector of char32_ts, and it returns the error flag instead.

and finally — last but absolutely not least — there's one where a single std::string specifies the character string, instead of a beginning and an ending iterator. that one returns a std::pair with the converted unicode text in a vector, plus the error flag. two for one, we love to see it 🫶

---

👑 SEE ALSO 👑

• courier-unicode(7)
• unicode::convert::convert(3)
• unicode_convert(3)
• iconv(3)

---

🌸 AUTHOR 🌸

Sam Varshavchik — Author 💜

---

okay that's the whole thing, bestie, we ate and left no crumbs 🔥 this was the Courier Unicode Library, dated 04/12/2026, mwah 💋 go convert something cute 🎀