<?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.cpp 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.cpp</div> </div> </div><!--header--> <div class="contents"> <a href="kmime__codecs_8cpp.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"></span></div> <div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> Copyright (c) 2001-2002 Marc Mutz <mutz@kde.org></span></div> <div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"></span></div> <div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> This library is free software; you can redistribute it and/or</span></div> <div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> modify it under the terms of the GNU Library General Public</span></div> <div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> License as published by the Free Software Foundation; either</span></div> <div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"> version 2 of the License, or (at your option) any later version.</span></div> <div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"></span></div> <div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> This library is distributed in the hope that it will be useful,</span></div> <div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div> <div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div> <div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"> Library General Public License for more details.</span></div> <div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"></span></div> <div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> You should have received a copy of the GNU Library General Public License</span></div> <div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span></div> <div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span></div> <div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> Boston, MA 02110-1301, USA.</span></div> <div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">*/</span></div> <div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include "<a class="code" href="kmime__codecs_8h.html" title="This file is part of the API for handling MIME data and defines the Codec class.">kmime_codecs.h</a>"</span></div> <div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include "kmime_util.h"</span></div> <div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include "<a class="code" href="kmime__codec__base64_8h.html" title="This file is part of the API for handling MIME data and defines the Base64 and RFC2047B Codec classes...">kmime_codec_base64.h</a>"</span></div> <div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include "<a class="code" href="kmime__codec__qp_8h.html" title="This file is part of the API for handling MIME data and defines the QuotedPrintable, RFC2047Q, and RFC2231 Codec classes.">kmime_codec_qp.h</a>"</span></div> <div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include "<a class="code" href="kmime__codec__uuencode_8h.html" title="This file is part of the API for handling MIME data and defines a uuencode Codec class.">kmime_codec_uuencode.h</a>"</span></div> <div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#include "<a class="code" href="kmime__codec__identity_8h.html" title="This file is part of the API for handling MIME data and defines the Identity, seven-bit-text, eight-bit-text, and eight-bit-binary Codec classes.">kmime_codec_identity.h</a>"</span></div> <div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div> <div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#include "kautodeletehash.h"</span></div> <div class="line"><a name="l00041"></a><span class="lineno"> 41</span> </div> <div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor">#include <kascii.h></span></div> <div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="preprocessor">#include <kdebug.h></span></div> <div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="preprocessor">#include <kglobal.h></span></div> <div class="line"><a name="l00045"></a><span class="lineno"> 45</span> </div> <div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="preprocessor">#include <QtCore/QCoreApplication></span></div> <div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor">#include <QtCore/QMutex></span></div> <div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div> <div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor">#include <cassert></span></div> <div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">#include <cstring></span></div> <div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">#include <string.h></span></div> <div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div> <div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="keyword">using namespace </span>KMime;</div> <div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div> <div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keyword">namespace </span>KMime {</div> <div class="line"><a name="l00056"></a><span class="lineno"> 56</span> </div> <div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// global list of KMime::Codec's</span></div> <div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment">//@cond PRIVATE</span></div> <div class="line"><a name="l00059"></a><span class="lineno"> 59</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> *Codec::all = 0;</div> <div class="line"><a name="l00060"></a><span class="lineno"> 60</span> K_GLOBAL_STATIC( QMutex, dictLock )</div> <div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">//@endcond</span></div> <div class="line"><a name="l00062"></a><span class="lineno"> 62</span> </div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span> void <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a>::cleanupCodec()</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="keyword">delete</span> all;</div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  all = 0;</div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</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="keywordtype">void</span> Codec::fillDictionary()</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="comment">//all->insert( "7bit", new SevenBitCodec() );</span></div> <div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="comment">//all->insert( "8bit", new EightBitCodec() );</span></div> <div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  all->insert( <span class="stringliteral">"base64"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1Base64Codec.html" title="A class representing the codec for Base64 as specified in RFC2045.">Base64Codec</a>() );</div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  all->insert( <span class="stringliteral">"quoted-printable"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1QuotedPrintableCodec.html" title="A class representing the codec for QuotedPrintable as specified in RFC2045 (section 6...">QuotedPrintableCodec</a>() );</div> <div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  all->insert( <span class="stringliteral">"b"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1Rfc2047BEncodingCodec.html" title="A class representing the codec for the B encoding as specified in RFC2047B.">Rfc2047BEncodingCodec</a>() );</div> <div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  all->insert( <span class="stringliteral">"q"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1Rfc2047QEncodingCodec.html" title="A class representing the codec for the Q encoding as specified in RFC2047Q.">Rfc2047QEncodingCodec</a>() );</div> <div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  all->insert( <span class="stringliteral">"x-kmime-rfc2231"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1Rfc2231EncodingCodec.html" title="A class representing the codec for RFC2231.">Rfc2231EncodingCodec</a>() );</div> <div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  all->insert( <span class="stringliteral">"x-uuencode"</span>, <span class="keyword">new</span> <a class="code" href="classKMime_1_1UUCodec.html" title="A class representing the UUEncode codec.">UUCodec</a>() );</div> <div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="comment">//all->insert( "binary", new BinaryCodec() );</span></div> <div class="line"><a name="l00080"></a><span class="lineno"> 80</span> }</div> <div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div> <div class="line"><a name="l00082"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#a035da12d2d178cd69413a5e25c940a3f"> 82</a></span> <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a> *<a class="code" href="classKMime_1_1Codec.html#a035da12d2d178cd69413a5e25c940a3f" title="Returns a codec associated with the specified name.">Codec::codecForName</a>( <span class="keyword">const</span> <span class="keywordtype">char</span> *name )</div> <div class="line"><a name="l00083"></a><span class="lineno"> 83</span> {</div> <div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="keyword">const</span> QByteArray ba( name );</div> <div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <span class="keywordflow">return</span> codecForName( ba );</div> <div class="line"><a name="l00086"></a><span class="lineno"> 86</span> }</div> <div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div> <div class="line"><a name="l00088"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#a06c049392a39610e9325a84dbc27940a"> 88</a></span> <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a> *<a class="code" href="classKMime_1_1Codec.html#a035da12d2d178cd69413a5e25c940a3f" title="Returns a codec associated with the specified name.">Codec::codecForName</a>( <span class="keyword">const</span> QByteArray &name )</div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span> {</div> <div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  dictLock->lock(); <span class="comment">// protect "all"</span></div> <div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keywordflow">if</span> ( !all ) {</div> <div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  all = <span class="keyword">new</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>();</div> <div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  qAddPostRoutine( cleanupCodec );</div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  fillDictionary();</div> <div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  }</div> <div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  QByteArray lowerName = name;</div> <div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  kAsciiToLower( lowerName.data() );</div> <div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <a class="code" href="classKMime_1_1Codec.html" title="An abstract base class of codecs for common mail transfer encodings.">Codec</a> *codec = ( *all )[ lowerName ]; <span class="comment">// FIXME: operator[] adds an entry into the hash</span></div> <div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  dictLock->unlock();</div> <div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div> <div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordflow">if</span> ( !codec ) {</div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  kDebug() << <span class="stringliteral">"Unknown codec \""</span> << name << <span class="stringliteral">"\" requested!"</span>;</div> <div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  }</div> <div class="line"><a name="l00104"></a><span class="lineno"> 104</span> </div> <div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="keywordflow">return</span> codec;</div> <div class="line"><a name="l00106"></a><span class="lineno"> 106</span> }</div> <div class="line"><a name="l00107"></a><span class="lineno"> 107</span> </div> <div class="line"><a name="l00108"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#a21b8ace8ab58d92408ab901f0171c7b6"> 108</a></span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Codec.html#a21b8ace8ab58d92408ab901f0171c7b6" title="Convenience wrapper that can be used for small chunks of data when you can provide a large enough buf...">Codec::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="l00109"></a><span class="lineno"> 109</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="l00110"></a><span class="lineno"> 110</span>  <span class="keywordtype">bool</span> withCRLF )<span class="keyword"> const</span></div> <div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="keyword"></span>{</div> <div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="comment">// get an encoder:</span></div> <div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <a class="code" href="classKMime_1_1Encoder.html" title="Stateful encoder class.">Encoder</a> *enc = makeEncoder( withCRLF );</div> <div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  assert( enc );</div> <div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div> <div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="comment">// encode and check for output buffer overflow:</span></div> <div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="keywordflow">while</span> ( !enc-><a class="code" href="classKMime_1_1Encoder.html#aaa2eefa0dbf49272c1ec09b8a4b99ae9" title="Encodes a chunk of data, maintaining state information between calls.">encode</a>( scursor, send, dcursor, dend ) ) {</div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="keywordflow">if</span> ( dcursor == dend ) {</div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keyword">delete</span> enc;</div> <div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// not enough space in output buffer</span></div> <div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  }</div> <div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  }</div> <div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div> <div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="comment">// finish and check for output buffer overflow:</span></div> <div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keywordflow">while</span> ( !enc-><a class="code" href="classKMime_1_1Encoder.html#a044de80fc6464e793e8951d282b9c9c0" title="Call this method to finalize the output stream.">finish</a>( dcursor, dend ) ) {</div> <div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordflow">if</span> ( dcursor == dend ) {</div> <div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="keyword">delete</span> enc;</div> <div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// not enough space in output buffer</span></div> <div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  }</div> <div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  }</div> <div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div> <div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="comment">// cleanup and return:</span></div> <div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="keyword">delete</span> enc;</div> <div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// successfully encoded.</span></div> <div class="line"><a name="l00135"></a><span class="lineno"> 135</span> }</div> <div class="line"><a name="l00136"></a><span class="lineno"> 136</span> </div> <div class="line"><a name="l00137"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#a23b4ec5b0f01efaa2f2fd4c34d826142"> 137</a></span> QByteArray <a class="code" href="classKMime_1_1Codec.html#a21b8ace8ab58d92408ab901f0171c7b6" title="Convenience wrapper that can be used for small chunks of data when you can provide a large enough buf...">Codec::encode</a>( <span class="keyword">const</span> QByteArray &src, <span class="keywordtype">bool</span> withCRLF )<span class="keyword"> const</span></div> <div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="keyword"></span>{</div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="comment">// allocate buffer for the worst case:</span></div> <div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  QByteArray result;</div> <div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  result.resize( maxEncodedSizeFor( src.size(), withCRLF ) );</div> <div class="line"><a name="l00142"></a><span class="lineno"> 142</span> </div> <div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="comment">// set up iterators:</span></div> <div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  QByteArray::ConstIterator iit = src.begin();</div> <div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  QByteArray::ConstIterator iend = src.end();</div> <div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  QByteArray::Iterator oit = result.begin();</div> <div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  QByteArray::ConstIterator oend = result.end();</div> <div class="line"><a name="l00148"></a><span class="lineno"> 148</span> </div> <div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="comment">// encode</span></div> <div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  <span class="keywordflow">if</span> ( !encode( iit, iend, oit, oend, withCRLF ) ) {</div> <div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  kFatal() << name() << <span class="stringliteral">"codec lies about it's mEncodedSizeFor()"</span>;</div> <div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  }</div> <div class="line"><a name="l00153"></a><span class="lineno"> 153</span> </div> <div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <span class="comment">// shrink result to actual size:</span></div> <div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  result.truncate( oit - result.begin() );</div> <div class="line"><a name="l00156"></a><span class="lineno"> 156</span> </div> <div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <span class="keywordflow">return</span> result;</div> <div class="line"><a name="l00158"></a><span class="lineno"> 158</span> }</div> <div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div> <div class="line"><a name="l00160"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#ab2c4e5f9af08175a309955f01e2166ae"> 160</a></span> QByteArray <a class="code" href="classKMime_1_1Codec.html#a1cebe7f90ca045f907641203854d994f" title="Convenience wrapper that can be used for small chunks of data when you can provide a large enough buf...">Codec::decode</a>( <span class="keyword">const</span> QByteArray &src, <span class="keywordtype">bool</span> withCRLF )<span class="keyword"> const</span></div> <div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="keyword"></span>{</div> <div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// allocate buffer for the worst case:</span></div> <div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  QByteArray result;</div> <div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  result.resize( maxDecodedSizeFor( src.size(), withCRLF ) );</div> <div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div> <div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="comment">// set up iterators:</span></div> <div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  QByteArray::ConstIterator iit = src.begin();</div> <div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  QByteArray::ConstIterator iend = src.end();</div> <div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  QByteArray::Iterator oit = result.begin();</div> <div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  QByteArray::ConstIterator oend = result.end();</div> <div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div> <div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="comment">// decode</span></div> <div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="keywordflow">if</span> ( !decode( iit, iend, oit, oend, withCRLF ) ) {</div> <div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  kFatal() << name() << <span class="stringliteral">"codec lies about it's maxDecodedSizeFor()"</span>;</div> <div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  }</div> <div class="line"><a name="l00176"></a><span class="lineno"> 176</span> </div> <div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="comment">// shrink result to actual size:</span></div> <div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  result.truncate( oit - result.begin() );</div> <div class="line"><a name="l00179"></a><span class="lineno"> 179</span> </div> <div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="keywordflow">return</span> result;</div> <div class="line"><a name="l00181"></a><span class="lineno"> 181</span> }</div> <div class="line"><a name="l00182"></a><span class="lineno"> 182</span> </div> <div class="line"><a name="l00183"></a><span class="lineno"><a class="code" href="classKMime_1_1Codec.html#a1cebe7f90ca045f907641203854d994f"> 183</a></span> <span class="keywordtype">bool</span> <a class="code" href="classKMime_1_1Codec.html#a1cebe7f90ca045f907641203854d994f" title="Convenience wrapper that can be used for small chunks of data when you can provide a large enough buf...">Codec::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="l00184"></a><span class="lineno"> 184</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="l00185"></a><span class="lineno"> 185</span>  <span class="keywordtype">bool</span> withCRLF )<span class="keyword"> const</span></div> <div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="keyword"></span>{</div> <div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="comment">// get a decoder:</span></div> <div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <a class="code" href="classKMime_1_1Decoder.html" title="Stateful CTE decoder class.">Decoder</a> *dec = makeDecoder( withCRLF );</div> <div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  assert( dec );</div> <div class="line"><a name="l00190"></a><span class="lineno"> 190</span> </div> <div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="comment">// decode and check for output buffer overflow:</span></div> <div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keywordflow">while</span> ( !dec-><a class="code" href="classKMime_1_1Decoder.html#a1991c45377e59be92f31284e473e3514" title="Decodes a chunk of data, maintaining state information between calls.">decode</a>( scursor, send, dcursor, dend ) ) {</div> <div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keywordflow">if</span> ( dcursor == dend ) {</div> <div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keyword">delete</span> dec;</div> <div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// not enough space in output buffer</span></div> <div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  }</div> <div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  }</div> <div class="line"><a name="l00198"></a><span class="lineno"> 198</span> </div> <div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <span class="comment">// finish and check for output buffer overflow:</span></div> <div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keywordflow">while</span> ( !dec-><a class="code" href="classKMime_1_1Decoder.html#ab6cdf12608bb645002e72209507cf7d5" title="Call this method to finalize the output stream.">finish</a>( dcursor, dend ) ) {</div> <div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="keywordflow">if</span> ( dcursor == dend ) {</div> <div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="keyword">delete</span> dec;</div> <div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// not enough space in output buffer</span></div> <div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  }</div> <div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  }</div> <div class="line"><a name="l00206"></a><span class="lineno"> 206</span> </div> <div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// cleanup and return:</span></div> <div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keyword">delete</span> dec;</div> <div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// successfully encoded.</span></div> <div class="line"><a name="l00210"></a><span class="lineno"> 210</span> }</div> <div class="line"><a name="l00211"></a><span class="lineno"> 211</span> </div> <div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="comment">// write as much as possible off the output buffer. Return true if</span></div> <div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment">// flushing was complete, false if some chars could not be flushed.</span></div> <div class="line"><a name="l00214"></a><span class="lineno"><a class="code" href="classKMime_1_1Encoder.html#ad2fe0ddc878eede44f9c43b88b81ae3b"> 214</a></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.">Encoder::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="l00215"></a><span class="lineno"> 215</span> {</div> <div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="keywordtype">int</span> i;</div> <div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="comment">// copy output buffer to output stream:</span></div> <div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <span class="keywordflow">for</span> ( i = 0 ; dcursor != dend && i < mOutputBufferCursor ; ++i ) {</div> <div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  *dcursor++ = mOutputBuffer[i];</div> <div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  }</div> <div class="line"><a name="l00221"></a><span class="lineno"> 221</span> </div> <div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="comment">// calculate the number of missing chars:</span></div> <div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <span class="keywordtype">int</span> numCharsLeft = mOutputBufferCursor - i;</div> <div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <span class="comment">// push the remaining chars to the begin of the buffer:</span></div> <div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="keywordflow">if</span> ( numCharsLeft ) {</div> <div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  ::memmove( mOutputBuffer, mOutputBuffer + i, numCharsLeft );</div> <div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  }</div> <div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="comment">// adjust cursor:</span></div> <div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  mOutputBufferCursor = numCharsLeft;</div> <div class="line"><a name="l00230"></a><span class="lineno"> 230</span> </div> <div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordflow">return</span> !numCharsLeft;</div> <div class="line"><a name="l00232"></a><span class="lineno"> 232</span> }</div> <div class="line"><a name="l00233"></a><span class="lineno"> 233</span> </div> <div class="line"><a name="l00234"></a><span class="lineno"> 234</span> } <span class="comment">// namespace KMime</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>