<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <head> <title>kmime_codecs.h Source File</title> <style type="text/css"> .cp-doNotDisplay { display: none; } @media aural, braille, handheld, tty { .cp-doNotDisplay { display: inline; speak: normal; }} .cp-edit { text-align: right; } @media print, embossed { .cp-edit { display: none; }} </style> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <link rel="meta" href="http://www.kde.org/labels.rdf" type="application/rdf+xml" title="ICRA labels" /> <meta name="trademark" content="KDE e.V." /> <meta name="description" content="K Desktop Environment Homepage, KDE.org" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="robots" content="all" /> <meta name="no-email-collection" content="http://www.unspam.com/noemailcollection" /> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link rel="shortcut icon" href="../../favicon.ico" /><link rel="icon" href="../../favicon.ico" /> <link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../../kde.css" /> <link rel="stylesheet" media="print, embossed" type="text/css" href="../../print.css" /> <link rel="stylesheet" media="screen, aural, handheld, tty, braille" type="text/css" title="Flat" href="../../flat.css" /> <link rel="stylesheet" type="text/css" href="../../doxygen.css" /> <link rel="stylesheet" type="text/css" href="../../tabs.css" /> </head> <body> <ul class="cp-doNotDisplay"> <li><a href="#cp-content" accesskey="2">Skip to content</a></li> <li><a href="#cp-menu" accesskey="5">Skip to link menu</a></li> </ul> <div id="container"> <div id="header"> <div id="header_top"><div><div> <img alt ="" src="../../top-kde.jpg"/> </div></div></div> <div id="header_bottom"> <div id="location"> <ul> <li><a href="http://api.kde.org">KDE API Reference</a></li> <li><a href="../../index.html">kdepimlibs-4.10.5 API Reference</a></li> </ul> </div> <div id="menu"> <ul> <li><a href="http://www.kde.org/">KDE Home</a></li> <li><a href="http://kde.org/contact/">Contact Us</a></li> </ul> </div> </div> </div> <!-- End page header --> <div id="body_wrapper"> <div id="body"> <!-- begin main content --> <div id="right"> <div class="content"> <div id="main"> <div class="clearer"> </div> <h2><a name="content"></a>KMIME Library</h2> <!-- BC --> <div id="top"> <!-- Generated by Doxygen 1.8.3.1 --> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_639a08b2adffb175aad3ef3fe4337a5f.html">kmime</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">kmime_codecs.h</div> </div> </div><!--header--> <div class="contents"> <a href="kmime__codecs_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/* -*- c++ -*-</span></div> <div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"></span></div> <div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> KMime, the KDE Internet mail/usenet news message library.</span></div> <div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> Copyright (c) 2001-2002 Marc Mutz <mutz@kde.org></span></div> <div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"></span></div> <div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> This library is free software; you can redistribute it and/or</span></div> <div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> modify it under the terms of the GNU Library General Public</span></div> <div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> License as published by the Free Software Foundation; either</span></div> <div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> version 2 of the License, or (at your option) any later version.</span></div> <div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"></span></div> <div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> This library is distributed in the hope that it will be useful,</span></div> <div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div> <div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div> <div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> Library General Public License for more details.</span></div> <div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"></span></div> <div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> You should have received a copy of the GNU Library General Public License</span></div> <div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span></div> <div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span></div> <div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> Boston, MA 02110-1301, USA.</span></div> <div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">*/</span></div> <div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="preprocessor">#ifndef __KMIME_CODECS__</span></div> <div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor"></span><span class="preprocessor">#define __KMIME_CODECS__</span></div> <div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="preprocessor">#include <QtCore/QByteArray></span></div> <div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div> <div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#include <kdebug.h></span> <span class="comment">// for kFatal()</span></div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span> </div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="preprocessor">#include "kmime_export.h"</span></div> <div class="line"><a name="l00068"></a><span class="lineno"> 68</span> </div> <div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="keyword">namespace </span>KMime {</div> <div class="line"><a name="l00070"></a><span class="lineno"> 70</span> </div> <div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="keyword">template</span> <<span class="keyword">class</span> Key, <span class="keyword">class</span> T> <span class="keyword">class </span>KAutoDeleteHash;</div> <div class="line"><a name="l00072"></a><span class="lineno"> 72</span> </div> <div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="keyword">class </span>Encoder;</div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="keyword">class </span>Decoder;</div> <div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div> <div class="line"><a name="l00083"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html"> 83</a></span> <span class="keyword">class </span>KMIME_EXPORT <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a></div> <div class="line"><a name="l00084"></a><span class="lineno"> 84</span> {</div> <div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="comment">//@cond PRIVATE</span></div> <div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="keyword">static</span> <a class="code" href="classKMime_1_1KAutoDeleteHash.html" title="The KAutoDeleteHash class is a convenience QHash subclass that provides automatic deletion of the val...">KAutoDeleteHash<QByteArray, Codec></a> *all;</div> <div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> cleanupCodec();</div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">//@endcond</span></div> <div class="line"><a name="l00093"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#ab34dfd225933156197cfaeaadfadb3ba"> 93</a></span> <span class="comment"></span> <a class="code" href="classKMime_1_1Codec.html#ab34dfd225933156197cfaeaadfadb3ba" title="Contructs the codec.">Codec</a>() {}</div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span> </div> <div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keyword">public</span>:</div> <div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keyword">static</span> <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a> *codecForName( <span class="keyword">const</span> <span class="keywordtype">char</span> *name );</div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div> <div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keyword">static</span> <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a> *codecForName( <span class="keyword">const</span> QByteArray &name );</div> <div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="keyword">virtual</span> <span class="keywordtype">int</span> maxEncodedSizeFor( <span class="keywordtype">int</span> insize, <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span> = 0;</div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span> </div> <div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="keyword">virtual</span> <span class="keywordtype">int</span> maxDecodedSizeFor( <span class="keywordtype">int</span> insize, <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span> = 0;</div> <div class="line"><a name="l00129"></a><span class="lineno"> 129</span> </div> <div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="keyword">virtual</span> <a class="code" href="classKMime_1_1Encoder.html" title="Stateful encoder class.">Encoder</a> *makeEncoder( <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span> = 0;</div> <div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div> <div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="keyword">virtual</span> <a class="code" href="classKMime_1_1Decoder.html" title="Stateful CTE decoder class.">Decoder</a> *makeDecoder( <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span> = 0;</div> <div class="line"><a name="l00147"></a><span class="lineno"> 147</span> </div> <div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> encode( <span class="keyword">const</span> <span class="keywordtype">char</span>* &scursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> send,</div> <div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend,</div> <div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span>;</div> <div class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div> <div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> decode( <span class="keyword">const</span> <span class="keywordtype">char</span>* &scursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> send,</div> <div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend,</div> <div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span>;</div> <div class="line"><a name="l00223"></a><span class="lineno"> 223</span> </div> <div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="keyword">virtual</span> QByteArray encode( <span class="keyword">const</span> QByteArray &src, <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span>;</div> <div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div> <div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keyword">virtual</span> QByteArray decode( <span class="keyword">const</span> QByteArray &src, <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> ) <span class="keyword">const</span>;</div> <div class="line"><a name="l00247"></a><span class="lineno"> 247</span> </div> <div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *name() <span class="keyword">const</span> = 0;</div> <div class="line"><a name="l00252"></a><span class="lineno"> 252</span> </div> <div class="line"><a name="l00256"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#aa2c1ef7dad961661236589112b8ec9d2"> 256</a></span>  <span class="keyword">virtual</span> <a class="code" href="classKMime_1_1Codec.html#aa2c1ef7dad961661236589112b8ec9d2" title="Destroys the codec.">~Codec</a>() {}</div> <div class="line"><a name="l00257"></a><span class="lineno"> 257</span> </div> <div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <span class="keyword">private</span>:</div> <div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> fillDictionary();</div> <div class="line"><a name="l00263"></a><span class="lineno"> 263</span> };</div> <div class="line"><a name="l00264"></a><span class="lineno"> 264</span> </div> <div class="line"><a name="l00341"></a><span class="lineno"><a class="code" href="classKMime_1_1Decoder.html"> 341</a></span> <span class="keyword">class </span><a class="code" href="classKMime_1_1Decoder.html" title="Stateful CTE decoder class.">Decoder</a></div> <div class="line"><a name="l00342"></a><span class="lineno"> 342</span> {</div> <div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a>;</div> <div class="line"><a name="l00351"></a><span class="lineno"><a class="code" href="classKMime_1_1Decoder.html#af4ee1d10c38a201fc62fc57029047e53"> 351</a></span>  <a class="code" href="classKMime_1_1Decoder.html#af4ee1d10c38a201fc62fc57029047e53" title="Protected constructor.">Decoder</a>( <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> )</div> <div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  : mWithCRLF( withCRLF ) {}</div> <div class="line"><a name="l00353"></a><span class="lineno"> 353</span> </div> <div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <span class="keyword">public</span>:</div> <div class="line"><a name="l00358"></a><span class="lineno"><a class="code" href="classKMime_1_1Decoder.html#ad636d0d51e08848b08bc9c3d5fce1735"> 358</a></span>  <span class="keyword">virtual</span> <a class="code" href="classKMime_1_1Decoder.html#ad636d0d51e08848b08bc9c3d5fce1735" title="Destroys the decoder.">~Decoder</a>() {}</div> <div class="line"><a name="l00359"></a><span class="lineno"> 359</span> </div> <div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Decoder.html#a1991c45377e59be92f31284e473e3514" title="Decodes a chunk of data, maintaining state information between calls.">decode</a>( <span class="keyword">const</span> <span class="keywordtype">char</span>* &scursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> send,</div> <div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend ) = 0;</div> <div class="line"><a name="l00371"></a><span class="lineno"> 371</span> </div> <div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Decoder.html#ab6cdf12608bb645002e72209507cf7d5" title="Call this method to finalize the output stream.">finish</a>( <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend ) = 0;</div> <div class="line"><a name="l00381"></a><span class="lineno"> 381</span> </div> <div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  <span class="comment">//@cond PRIVATE</span></div> <div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> mWithCRLF;</div> <div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="comment">//@endcond</span></div> <div class="line"><a name="l00386"></a><span class="lineno"> 386</span> };</div> <div class="line"><a name="l00387"></a><span class="lineno"> 387</span> </div> <div class="line"><a name="l00394"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html"> 394</a></span> <span class="keyword">class </span><a class="code" href="classKMime_1_1Encoder.html" title="Stateful encoder class.">Encoder</a></div> <div class="line"><a name="l00395"></a><span class="lineno"> 395</span> {</div> <div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a>;</div> <div class="line"><a name="l00403"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#a3e97ead65c0a1d49b4e2289033ecb06e"> 403</a></span>  <span class="keyword">explicit</span> <a class="code" href="classKMime_1_1Encoder.html#a3e97ead65c0a1d49b4e2289033ecb06e" title="Protected constructor.">Encoder</a>( <span class="keywordtype">bool</span> withCRLF=<span class="keyword">false</span> )</div> <div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  : mOutputBufferCursor( 0 ), mWithCRLF( withCRLF ) {}</div> <div class="line"><a name="l00405"></a><span class="lineno"> 405</span> </div> <div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="keyword">public</span>:</div> <div class="line"><a name="l00410"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#a6cd0969c35f713245971bd561e614d2f"> 410</a></span>  <span class="keyword">virtual</span> <a class="code" href="classKMime_1_1Encoder.html#a6cd0969c35f713245971bd561e614d2f" title="Destroys the encoder.">~Encoder</a>() {}</div> <div class="line"><a name="l00411"></a><span class="lineno"> 411</span> </div> <div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Encoder.html#aaa2eefa0dbf49272c1ec09b8a4b99ae9" title="Encodes a chunk of data, maintaining state information between calls.">encode</a>( <span class="keyword">const</span> <span class="keywordtype">char</span>* &scursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> send,</div> <div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend ) = 0;</div> <div class="line"><a name="l00423"></a><span class="lineno"> 423</span> </div> <div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Encoder.html#a044de80fc6464e793e8951d282b9c9c0" title="Call this method to finalize the output stream.">finish</a>( <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend ) = 0;</div> <div class="line"><a name="l00432"></a><span class="lineno"> 432</span> </div> <div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="keyword">enum</span> {</div> <div class="line"><a name="l00438"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#a785adbf497f35cd6bb5eb424021964eea0be67f9431bb19d945b7b904046c74e5"> 438</a></span>  <a class="code" href="classKMime_1_1Encoder.html#a785adbf497f35cd6bb5eb424021964eea0be67f9431bb19d945b7b904046c74e5" title="Eight.">maxBufferedChars</a> = 8 </div> <div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  };</div> <div class="line"><a name="l00440"></a><span class="lineno"> 440</span> </div> <div class="line"><a name="l00451"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#a4273a7e52f4fa2a22f64770b6145b4b7"> 451</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Encoder.html#a4273a7e52f4fa2a22f64770b6145b4b7" title="Writes character ch to the output stream or the output buffer, depending on whether or not the output...">write</a>( <span class="keywordtype">char</span> ch, <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend )</div> <div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  {</div> <div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <span class="keywordflow">if</span> ( dcursor != dend ) {</div> <div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  <span class="comment">// if there's space in the output stream, write there:</span></div> <div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  *dcursor++ = ch;</div> <div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> <div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  } <span class="keywordflow">else</span> {</div> <div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">// else buffer the output:</span></div> <div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  kFatal( mOutputBufferCursor >= <a class="code" href="classKMime_1_1Encoder.html#a785adbf497f35cd6bb5eb424021964eea0be67f9431bb19d945b7b904046c74e5" title="Eight.">maxBufferedChars</a> )</div> <div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  << <span class="stringliteral">"KMime::Encoder: internal buffer overflow!"</span>;</div> <div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  mOutputBuffer[ mOutputBufferCursor++ ] = ch;</div> <div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> <div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  }</div> <div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  }</div> <div class="line"><a name="l00465"></a><span class="lineno"> 465</span> </div> <div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Encoder.html#ad2fe0ddc878eede44f9c43b88b81ae3b" title="Writes characters from the output buffer to the output stream.">flushOutputBuffer</a>( <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend );</div> <div class="line"><a name="l00477"></a><span class="lineno"> 477</span> </div> <div class="line"><a name="l00485"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#ac9b23d63b7c1cfa0108b4d3d552e72bf"> 485</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Encoder.html#ac9b23d63b7c1cfa0108b4d3d552e72bf" title="Convenience function.">writeCRLF</a>( <span class="keywordtype">char</span>* &dcursor, <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> dend )</div> <div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  {</div> <div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="keywordflow">if</span> ( mWithCRLF ) {</div> <div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="classKMime_1_1Encoder.html#a4273a7e52f4fa2a22f64770b6145b4b7" title="Writes character ch to the output stream or the output buffer, depending on whether or not the output...">write</a>( <span class="charliteral">'\r'</span>, dcursor, dend );</div> <div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  }</div> <div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="keywordflow">return</span> <a class="code" href="classKMime_1_1Encoder.html#a4273a7e52f4fa2a22f64770b6145b4b7" title="Writes character ch to the output stream or the output buffer, depending on whether or not the output...">write</a>( <span class="charliteral">'\n'</span>, dcursor, dend );</div> <div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  }</div> <div class="line"><a name="l00492"></a><span class="lineno"> 492</span> </div> <div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <span class="keyword">private</span>:</div> <div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <span class="comment">//@cond PRIVATE</span></div> <div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  <span class="keywordtype">char</span> mOutputBuffer[ <a class="code" href="classKMime_1_1Encoder.html#a785adbf497f35cd6bb5eb424021964eea0be67f9431bb19d945b7b904046c74e5" title="Eight.">maxBufferedChars</a> ];</div> <div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <span class="comment">//@endcond</span></div> <div class="line"><a name="l00501"></a><span class="lineno"> 501</span> </div> <div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <span class="keyword">protected</span>:</div> <div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <span class="comment">//@cond PRIVATE</span></div> <div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  uchar mOutputBufferCursor;</div> <div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> mWithCRLF;</div> <div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <span class="comment">//@endcond</span></div> <div class="line"><a name="l00507"></a><span class="lineno"> 507</span> };</div> <div class="line"><a name="l00508"></a><span class="lineno"> 508</span> </div> <div class="line"><a name="l00509"></a><span class="lineno"> 509</span> } <span class="comment">// namespace KMime</span></div> <div class="line"><a name="l00510"></a><span class="lineno"> 510</span> </div> <div class="line"><a name="l00511"></a><span class="lineno"> 511</span> <span class="preprocessor">#endif // __KMIME_CODECS__</span></div> </div><!-- fragment --></div><!-- contents --> <div class="copyrights"> This file is part of the KDE documentation.<br/> Documentation copyright © 1996-2013 The KDE developers.<br/> Generated on Fri Jul 12 2013 16:48:18 by <a href="http://www.doxygen.org/index.html">doxygen</a> 1.8.3.1 written by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>, © 1997-2006 <p> KDE's <a href="http://techbase.kde.org/Policies/Library_Documentation_Policy">Doxygen guidelines</a> are available online. </p> </div> </div> </div> </div> <div id="left"> <div class="menu_box"> <a name="cp-menu" /><div class="menutitle"><div> <h2 id="cp-menu-project">KMIME Library</h2> <a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "KMIME Library"</a> </div></div> <ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="functions.html">Class Members</a></li><li><a href="files.html">File List</a></li><li><a href="pages.html">Related Pages</a></li></ul> <!-- <h2>Class Picker</h2> <div style="text-align: center;"> <form name="guideform"> <select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value"> <option value="annotated.html">-- Choose --</option> <option value="classKMime_1_1Base64Codec.html">kmime::base64codec</option>, <option value="classKMime_1_1BinaryCodec.html">kmime::binarycodec</option>, <option value="classKMime_1_1BoolFlags.html">kmime::boolflags</option>, <option value="classKMime_1_1CharFreq.html">kmime::charfreq</option>, <option value="classKMime_1_1Codec.html">kmime::codec</option>, <option value="classKMime_1_1Content.html">kmime::content</option>, <option value="classKMime_1_1ContentIndex.html">kmime::contentindex</option>, <option value="classKMime_1_1DateFormatter.html">kmime::dateformatter</option>, <option value="classKMime_1_1Decoder.html">kmime::decoder</option>, <option value="classKMime_1_1EightBitCodec.html">kmime::eightbitcodec</option>, <option value="classKMime_1_1Encoder.html">kmime::encoder</option>, <option value="classKMime_1_1HeaderFactory.html">kmime::headerfactory</option>, <option value="classKMime_1_1Headers_1_1Base.html">kmime::headers::base</option>, <option value="classKMime_1_1Headers_1_1Bcc.html">kmime::headers::bcc</option>, <option value="classKMime_1_1Headers_1_1Cc.html">kmime::headers::cc</option>, <option value="classKMime_1_1Headers_1_1ContentDescription.html">kmime::headers::contentdescription</option>, <option value="classKMime_1_1Headers_1_1ContentDisposition.html">kmime::headers::contentdisposition</option>, <option value="classKMime_1_1Headers_1_1ContentID.html">kmime::headers::contentid</option>, <option value="classKMime_1_1Headers_1_1ContentLocation.html">kmime::headers::contentlocation</option>, <option value="classKMime_1_1Headers_1_1ContentTransferEncoding.html">kmime::headers::contenttransferencoding</option>, <option value="classKMime_1_1Headers_1_1ContentType.html">kmime::headers::contenttype</option>, <option value="classKMime_1_1Headers_1_1Control.html">kmime::headers::control</option>, <option value="classKMime_1_1Headers_1_1Date.html">kmime::headers::date</option>, <option value="classKMime_1_1Headers_1_1FollowUpTo.html">kmime::headers::followupto</option>, <option value="classKMime_1_1Headers_1_1From.html">kmime::headers::from</option>, <option value="classKMime_1_1Headers_1_1Generic.html">kmime::headers::generic</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Address.html">kmime::headers::generics::address</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1AddressList.html">kmime::headers::generics::addresslist</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1DotAtom.html">kmime::headers::generics::dotatom</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Ident.html">kmime::headers::generics::ident</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1MailboxList.html">kmime::headers::generics::mailboxlist</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Parametrized.html">kmime::headers::generics::parametrized</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1PhraseList.html">kmime::headers::generics::phraselist</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1SingleIdent.html">kmime::headers::generics::singleident</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1SingleMailbox.html">kmime::headers::generics::singlemailbox</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Structured.html">kmime::headers::generics::structured</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Token.html">kmime::headers::generics::token</option>, <option value="classKMime_1_1Headers_1_1Generics_1_1Unstructured.html">kmime::headers::generics::unstructured</option>, <option value="classKMime_1_1Headers_1_1InReplyTo.html">kmime::headers::inreplyto</option>, <option value="classKMime_1_1Headers_1_1Keywords.html">kmime::headers::keywords</option>, <option value="classKMime_1_1Headers_1_1Lines.html">kmime::headers::lines</option>, <option value="classKMime_1_1Headers_1_1MailCopiesTo.html">kmime::headers::mailcopiesto</option>, <option value="classKMime_1_1Headers_1_1MessageID.html">kmime::headers::messageid</option>, <option value="classKMime_1_1Headers_1_1MIMEVersion.html">kmime::headers::mimeversion</option>, <option value="classKMime_1_1Headers_1_1Newsgroups.html">kmime::headers::newsgroups</option>, <option value="classKMime_1_1Headers_1_1Organization.html">kmime::headers::organization</option>, <option value="classKMime_1_1Headers_1_1References.html">kmime::headers::references</option>, <option value="classKMime_1_1Headers_1_1ReplyTo.html">kmime::headers::replyto</option>, <option value="classKMime_1_1Headers_1_1ReturnPath.html">kmime::headers::returnpath</option>, <option value="classKMime_1_1Headers_1_1Sender.html">kmime::headers::sender</option>, <option value="classKMime_1_1Headers_1_1Subject.html">kmime::headers::subject</option>, <option value="classKMime_1_1Headers_1_1Supersedes.html">kmime::headers::supersedes</option>, <option value="classKMime_1_1Headers_1_1To.html">kmime::headers::to</option>, <option value="classKMime_1_1Headers_1_1UserAgent.html">kmime::headers::useragent</option>, <option value="classKMime_1_1IdentityCodec.html">kmime::identitycodec</option>, <option value="classKMime_1_1KAutoDeleteHash.html">kmime::kautodeletehash</option>, <option value="classKMime_1_1Message.html">kmime::message</option>, <option value="classKMime_1_1Parser_1_1MultiPart.html">kmime::parser::multipart</option>, <option value="classKMime_1_1Parser_1_1NonMimeParser.html">kmime::parser::nonmimeparser</option>, <option value="classKMime_1_1Parser_1_1UUEncoded.html">kmime::parser::uuencoded</option>, <option value="classKMime_1_1Parser_1_1YENCEncoded.html">kmime::parser::yencencoded</option>, <option value="classKMime_1_1QuotedPrintableCodec.html">kmime::quotedprintablecodec</option>, <option value="classKMime_1_1Rfc2047BEncodingCodec.html">kmime::rfc2047bencodingcodec</option>, <option value="classKMime_1_1Rfc2047QEncodingCodec.html">kmime::rfc2047qencodingcodec</option>, <option value="classKMime_1_1Rfc2231EncodingCodec.html">kmime::rfc2231encodingcodec</option>, <option value="classKMime_1_1SevenBitCodec.html">kmime::sevenbitcodec</option>, <option value="classKMime_1_1Types_1_1Mailbox.html">kmime::types::mailbox</option>, <option value="classKMime_1_1UUCodec.html">kmime::uucodec</option>, </select> </form> </div> --> <div class="menu_box"> <a name="cp-menu" /><div class="menutitle"><div> <h2 id="cp-menu-project">kdepimlibs-4.10.5 API Reference</h2> <a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "kdepimlibs-4.10.5 API Reference"</a> </div></div> <div class="nav_list"> <ul> <li><a href="../../akonadi/html/index.html">akonadi</a></li><li> <a href="../../akonadi/contact/html/index.html">contact</a></li><li> <a href="../../akonadi/kmime/html/index.html">kmime</a></li><li> <a href="../../akonadi/socialutils/html/index.html">socialutils</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kalarmcal/html/index.html">kalarmcal</a></li><li><a href="../../kblog/html/index.html">kblog</a></li><li><a href="../../kcal/html/index.html">kcal</a></li><li><a href="../../kcalcore/html/index.html">kcalcore</a></li><li><a href="../../kcalutils/html/index.html">kcalutils</a></li><li><a href="../../kholidays/html/index.html">kholidays</a></li><li><a href="../../kimap/html/index.html">kimap</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/imap4/html/index.html">imap4</a></li><li> <a href="../../kioslave/mbox/html/index.html">mbox</a></li><li> <a href="../../kioslave/nntp/html/index.html">nntp</a></li><li><a href="../../kldap/html/index.html">kldap</a></li><li><a href="../../kmbox/html/index.html">kmbox</a></li><li><a href="../../kmime/html/index.html">kmime</a></li><li><a href="../../kontactinterface/html/index.html">kontactinterface</a></li><li><a href="../../kpimidentities/html/index.html">kpimidentities</a></li><li><a href="../../kpimtextedit/html/index.html">kpimtextedit</a></li><li><a href="../../kpimutils/html/index.html">kpimutils</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../ktnef/html/index.html">ktnef</a></li><li><a href="../../kxmlrpcclient/html/index.html">kxmlrpcclient</a></li><li><a href="../../mailtransport/html/index.html">mailtransport</a></li><li><a href="../../microblog/html/index.html">microblog</a></li><li><a href="../../qgpgme/html/index.html">qgpgme</a></li><li><a href="../../syndication/html/index.html">syndication</a></li><li> <a href="../../syndication/atom/html/index.html">atom</a></li><li> <a href="../../syndication/rdf/html/index.html">rdf</a></li><li> <a href="../../syndication/rss2/html/index.html">rss2</a></li> </ul></div></div> <!-- api_searchbox --> </div> </div> <div class="clearer"></div> </div> <div class="clearer"></div> </div> <div id="end_body"></div> <div id="footer"><div id="footer_text"> Report problems with this website to <a href="https://bugs.kde.org/enter_sysadmin_request.cgi?component=api.kde.org">our bug tracking system</a>.<br> Contact the specific authors with questions and comments about the page contents.<p> KDE<sup>®</sup> and <a href="/media/images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> | <a href="http://www.kde.org/contact/impressum.php">Legal</a></p> </div></div> </div> <!-- WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL BE BLOCKED INSTANTLY AND PERMANENTLY! <a href="mailto:aaaatrap-45abe0e0c3bebc77@kde.org">Block me</a> WARNING END --> </body> </html>