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

NAME

       unicode::iconvert::fromu - template for converting text sequence from unicode

SYNOPSIS

       #include <courier-unicode.h>

       output_iter_t unicode::iconvert::fromu::convert(input_iter_t beg_iter, input_iter_t end_iter,
                                                       const std::string &charset, output_iter_t output_iter,
                                                       bool &errflag);

       void unicode::iconvert::fromu::convert(input_iter_t beg_iter, input_iter_t end_iter,
                                              const std::string &charset, std::string &out_buf, bool &errflag);

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

DESCRIPTION

       These template functions convert unicode characters to text in the given character set.  beg_iter and
       end_iter define an input sequence of char32_ts. They get converted to unicode characters.  output_iter is
       an output iterator that convert() iterates over chars in the specified character set.  convert() returns
       the value of the output iterator after iterating over the converted character sequence.  err_flag gets
       set to true if unicode text could not be converted to the requested character set, or false for a
       successful conversion.

       An overloaded convert() puts the text string into a std::string, instead of using an output iterator.
       Finally, a single std::u32string specifies the character string, instead of a beginning and an ending
       iterator.

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