NAME

       unicode::iconvert::convert_tocase - unicode uppercase, lowercase, and titlecase conversion

SYNOPSIS

       #include <courier-unicode.h>

       std::string unicode::iconvert::convert_tocase(const std::string &text,
                                                     const std::string &charset,
                                                     char32_t (*first_char_func)(char32_t),
                                                     char32_t (*char_func)(char32_t));

       std::string unicode::iconvert::convert_tocase(const std::string &text,
                                                     const std::string &charset, bool &err,
                                                     char32_t (*first_char_func)(char32_t),
                                                     char32_t (*char_func)(char32_t));

DESCRIPTION

       The overloaded unicode::convert::convert_tocase() function converts the text parameter, in
       the charset characters to lowercase, uppercase, and titlecase.  text gets converted,
       internally, into unicode.  first_char_func and char_func are either: unicode_lc,
       unicode_uc, or unicode_tc. If the converted text string is not empty, first_char_func
       converts the first unicode character in the text string, and char_func converts any
       remaining characters.  unicode_lc converts its character to lowercase, unicode_uc to
       uppercase, and unicode_tc to titlecase. Finally, the unicode string gets converted back to
       charset, which gets returned.

       The optional err parameter gets set to true if an error was encounted converting the text
       string to or from unicode.

SEE ALSO

       courier-unicode(7), unicode::convert::convert(3), unicode_convert(3), iconv(3)[1].

AUTHOR

       Sam Varshavchik
           Author

NOTES

        1.

                      iconv(3)
           http://manpages.courier-mta.org/htmlman3/iconv.3.html