bionic (3) unicode::iconvert::convert_tocase.3.gz

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