1  /* Output stream that converts the output to another encoding.
       2     Copyright (C) 2006, 2020 Free Software Foundation, Inc.
       3     Written by Bruno Haible <bruno@clisp.org>, 2006.
       4  
       5     This program is free software: you can redistribute it and/or modify
       6     it under the terms of the GNU General Public License as published by
       7     the Free Software Foundation; either version 3 of the License, or
       8     (at your option) any later version.
       9  
      10     This program is distributed in the hope that it will be useful,
      11     but WITHOUT ANY WARRANTY; without even the implied warranty of
      12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      13     GNU General Public License for more details.
      14  
      15     You should have received a copy of the GNU General Public License
      16     along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
      17  
      18  #ifndef _ICONV_OSTREAM_H
      19  #define _ICONV_OSTREAM_H
      20  
      21  /* Note that this stream does not provide accurate error messages with line
      22     and column number when the conversion fails.  */
      23  
      24  #include <stdbool.h>
      25  
      26  #include "ostream.h"
      27  
      28  
      29  struct iconv_ostream : struct ostream
      30  {
      31  methods:
      32    /* Accessors.  */
      33    const char * get_from_encoding (iconv_ostream_t stream);
      34    const char * get_to_encoding (iconv_ostream_t stream);
      35    ostream_t    get_destination (iconv_ostream_t stream);
      36  };
      37  
      38  
      39  #ifdef __cplusplus
      40  extern "C" {
      41  #endif
      42  
      43  
      44  #if HAVE_ICONV
      45  
      46  /* Create an output stream that converts from FROM_ENCODING to TO_ENCODING,
      47     writing the result to DESTINATION.  */
      48  extern iconv_ostream_t iconv_ostream_create (const char *from_encoding,
      49                                               const char *to_encoding,
      50                                               ostream_t destination);
      51  
      52  #endif /* HAVE_ICONV */
      53  
      54  
      55  /* Test whether a given output stream is an iconv_ostream.  */
      56  extern bool is_instance_of_iconv_ostream (ostream_t stream);
      57  
      58  
      59  #ifdef __cplusplus
      60  }
      61  #endif
      62  
      63  #endif /* _ICONV_OSTREAM_H */