\hypertarget{class_qore_1_1_encoding_conversion_output_stream}{}\doxysection{Qore\+::Encoding\+Conversion\+Output\+Stream Class Reference}
\label{class_qore_1_1_encoding_conversion_output_stream}\index{Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}}


An \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} implementation that performs on-\/the-\/fly conversion between two character encodings.  




Inheritance diagram for Qore\+::Encoding\+Conversion\+Output\+Stream\+:
\nopagebreak
\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=225pt]{class_qore_1_1_encoding_conversion_output_stream__inherit__graph}
\end{center}
\end{figure}
\doxysubsection*{Public Member Functions}
\begin{DoxyCompactItemize}
\item 
nothing \mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream_ae46c9f9987f43b585c0b79f67b698a12}{close}} ()
\begin{DoxyCompactList}\small\item\em Flushes any buffered (unwritten) bytes, closes the output stream and releases all resources. \end{DoxyCompactList}\item 
\mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream_adc11259814f1b833a773ef8ef0310e50}{constructor}} (\mbox{\hyperlink{class_qore_1_1_output_stream}{Qore\+::\+Output\+Stream}} os, \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} source\+Encoding, \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} dest\+Encoding)
\begin{DoxyCompactList}\small\item\em Creates the \mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream}{Encoding\+Conversion\+Output\+Stream}} based on the \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} given. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream_a0b8b4433ed50a89b3b1b44d7305abb48}{write}} (\mbox{\hyperlink{group__type__conversion__functions_gaf11c7f5c43ced1e9b95bd2270ee87ed9}{binary}} data)
\begin{DoxyCompactList}\small\item\em Writes bytes to the output stream. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
An \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} implementation that performs on-\/the-\/fly conversion between two character encodings. 

\begin{DoxyParagraph}{Example\+: Encoding\+Conversion\+Output\+Stream basic usage}

\begin{DoxyCode}{0}
\DoxyCodeLine{EncodingConversionOutputStream latin2Stream(destUtf8Stream, \textcolor{stringliteral}{"{}ISO-\/8859-\/2"{}}, \textcolor{stringliteral}{"{}UTF-\/8"{}});}
\DoxyCodeLine{latin2Stream.write(latin2Data);     \textcolor{comment}{\#writes UTF-\/8 equivalents to destUtf8Stream}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
stream classes are not designed to be accessed from multiple threads; they have been implemented without locking for fast and efficient use when used from a single thread. For methods that would be unsafe to use in another thread, any use of such methods in threads other than the thread where the constructor was called will cause a {\ttfamily STREAM-\/\+THREAD-\/\+ERROR} to be thrown, unless the stream is handed off to another thread using the \mbox{\hyperlink{class_qore_1_1_stream_base_a017fc847a42d5c670cb9640a94522666}{Stream\+Base\+::unassign\+Thread()}} method in the thread that currently owns the stream, and the \mbox{\hyperlink{class_qore_1_1_stream_base_ab6b33cb1944c46aca8e9984ddfd65452}{Stream\+Base\+::reassign\+Thread()}} method in the new thread.
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{class_qore_1_1_stream_writer}{Stream\+Writer}} for a class that can be used to \mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream_a0b8b4433ed50a89b3b1b44d7305abb48}{write}} various kinds of data to an \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+13 
\end{DoxySince}


\doxysubsection{Member Function Documentation}
\mbox{\Hypertarget{class_qore_1_1_encoding_conversion_output_stream_ae46c9f9987f43b585c0b79f67b698a12}\label{class_qore_1_1_encoding_conversion_output_stream_ae46c9f9987f43b585c0b79f67b698a12}} 
\index{Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}!close@{close}}
\index{close@{close}!Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}}
\doxysubsubsection{\texorpdfstring{close()}{close()}}
{\footnotesize\ttfamily nothing Qore\+::\+Encoding\+Conversion\+Output\+Stream\+::close (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [virtual]}}



Flushes any buffered (unwritten) bytes, closes the output stream and releases all resources. 

Any methods called on a closed output stream will throw an exception.


\begin{DoxyExceptions}{Exceptions}
{\em OUTPUT-\/\+STREAM-\/\+CLOSED-\/\+ERROR} & the output stream has already been closed \\
\hline
{\em STREAM-\/\+THREAD-\/\+ERROR} & this exception is thrown if this method is called from any thread other than the thread that created the object \\
\hline
\end{DoxyExceptions}


Implements \mbox{\hyperlink{class_qore_1_1_output_stream_a2125e17612767b9636554b282638e883}{Qore\+::\+Output\+Stream}}.

\mbox{\Hypertarget{class_qore_1_1_encoding_conversion_output_stream_adc11259814f1b833a773ef8ef0310e50}\label{class_qore_1_1_encoding_conversion_output_stream_adc11259814f1b833a773ef8ef0310e50}} 
\index{Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}!constructor@{constructor}}
\index{constructor@{constructor}!Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}}
\doxysubsubsection{\texorpdfstring{constructor()}{constructor()}}
{\footnotesize\ttfamily Qore\+::\+Encoding\+Conversion\+Output\+Stream\+::constructor (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{class_qore_1_1_output_stream}{Qore\+::\+Output\+Stream}}}]{os,  }\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{source\+Encoding,  }\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{dest\+Encoding }\end{DoxyParamCaption})}



Creates the \mbox{\hyperlink{class_qore_1_1_encoding_conversion_output_stream}{Encoding\+Conversion\+Output\+Stream}} based on the \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} given. 


\begin{DoxyParams}{Parameters}
{\em os} & the destination \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} to write bytes to \\
\hline
{\em source\+Encoding} & the encoding of the characters that will be written to this stream \\
\hline
{\em dest\+Encoding} & the destination character encoding that will be written to the underlying \mbox{\hyperlink{class_qore_1_1_output_stream}{Output\+Stream}} os \\
\hline
\end{DoxyParams}

\begin{DoxyExceptions}{Exceptions}
{\em ENCODING-\/\+CONVERSION-\/\+ERROR} & if either of the encodings is unsupported \\
\hline
\end{DoxyExceptions}
\mbox{\Hypertarget{class_qore_1_1_encoding_conversion_output_stream_a0b8b4433ed50a89b3b1b44d7305abb48}\label{class_qore_1_1_encoding_conversion_output_stream_a0b8b4433ed50a89b3b1b44d7305abb48}} 
\index{Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}!write@{write}}
\index{write@{write}!Qore::EncodingConversionOutputStream@{Qore::EncodingConversionOutputStream}}
\doxysubsubsection{\texorpdfstring{write()}{write()}}
{\footnotesize\ttfamily nothing Qore\+::\+Encoding\+Conversion\+Output\+Stream\+::write (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gaf11c7f5c43ced1e9b95bd2270ee87ed9}{binary}}}]{data }\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [virtual]}}



Writes bytes to the output stream. 


\begin{DoxyParams}{Parameters}
{\em data} & the data to write\\
\hline
\end{DoxyParams}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{EncodingConversionOutputStream ecos();}
\DoxyCodeLine{bos.write(<6162>);}
\DoxyCodeLine{bos.write(<63>);}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em OUTPUT-\/\+STREAM-\/\+CLOSED-\/\+ERROR} & the output stream has already been closed \\
\hline
{\em STREAM-\/\+THREAD-\/\+ERROR} & this exception is thrown if this method is called from any thread other than the thread that created the object \\
\hline
\end{DoxyExceptions}


Implements \mbox{\hyperlink{class_qore_1_1_output_stream_a9054b0475c4829d10f956d8f6df6f2ac}{Qore\+::\+Output\+Stream}}.