Tarball tree for barry-0.17.0.tar.bz2
[barry.git] / doc / www / doxygen / html / vcard_8h-source.html
blobb98c85a417530575b2a573a162c6b44d97361dc9
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3 <title>Barry: vcard.h Source File</title>
4 <link href="doxygen.css" rel="stylesheet" type="text/css">
5 <link href="tabs.css" rel="stylesheet" type="text/css">
6 </head><body>
7 <!-- Generated by Doxygen 1.5.6 -->
8 <div class="navigation" id="top">
9 <div class="tabs">
10 <ul>
11 <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
12 <li><a href="modules.html"><span>Modules</span></a></li>
13 <li><a href="namespaces.html"><span>Namespaces</span></a></li>
14 <li><a href="classes.html"><span>Classes</span></a></li>
15 <li class="current"><a href="files.html"><span>Files</span></a></li>
16 <li><a href="dirs.html"><span>Directories</span></a></li>
17 </ul>
18 </div>
19 <div class="navpath"><a class="el" href="dir_edc0f428e3eefcfdce9c25befd901c57.html">src</a>
20 </div>
21 </div>
22 <div class="contents">
23 <h1>vcard.h</h1><a href="vcard_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">///</span>
24 <a name="l00002"></a>00002 <span class="comment"></span><span class="comment">/// \file vcard.h</span>
25 <a name="l00003"></a>00003 <span class="comment"></span><span class="comment">/// Conversion routines for vcards</span>
26 <a name="l00004"></a>00004 <span class="comment"></span><span class="comment">///</span>
27 <a name="l00005"></a>00005 <span class="comment"></span>
28 <a name="l00006"></a>00006 <span class="comment">/*</span>
29 <a name="l00007"></a>00007 <span class="comment"> Copyright (C) 2006-2011, Net Direct Inc. (http://www.netdirect.ca/)</span>
30 <a name="l00008"></a>00008 <span class="comment"></span>
31 <a name="l00009"></a>00009 <span class="comment"> This program is free software; you can redistribute it and/or modify</span>
32 <a name="l00010"></a>00010 <span class="comment"> it under the terms of the GNU General Public License as published by</span>
33 <a name="l00011"></a>00011 <span class="comment"> the Free Software Foundation; either version 2 of the License, or</span>
34 <a name="l00012"></a>00012 <span class="comment"> (at your option) any later version.</span>
35 <a name="l00013"></a>00013 <span class="comment"></span>
36 <a name="l00014"></a>00014 <span class="comment"> This program is distributed in the hope that it will be useful,</span>
37 <a name="l00015"></a>00015 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
38 <a name="l00016"></a>00016 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</span>
39 <a name="l00017"></a>00017 <span class="comment"></span>
40 <a name="l00018"></a>00018 <span class="comment"> See the GNU General Public License in the COPYING file at the</span>
41 <a name="l00019"></a>00019 <span class="comment"> root directory of this project for more details.</span>
42 <a name="l00020"></a>00020 <span class="comment">*/</span>
43 <a name="l00021"></a>00021
44 <a name="l00022"></a>00022 <span class="preprocessor">#ifndef __BARRY_SYNC_VCARD_H__</span>
45 <a name="l00023"></a>00023 <span class="preprocessor"></span><span class="preprocessor">#define __BARRY_SYNC_VCARD_H__</span>
46 <a name="l00024"></a>00024 <span class="preprocessor"></span>
47 <a name="l00025"></a>00025 <span class="preprocessor">#include "<a class="code" href="dll_8h.html" title="Macros for handling DLL/library API visibility.">dll.h</a>"</span>
48 <a name="l00026"></a>00026 <span class="preprocessor">#include "<a class="code" href="vbase_8h.html" title="Base class for vformat support.">vbase.h</a>"</span>
49 <a name="l00027"></a>00027 <span class="preprocessor">#include "<a class="code" href="r__contact_8h.html" title="Blackberry database record parser class for contact records.">r_contact.h</a>"</span>
50 <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;stdint.h&gt;</span>
51 <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;string&gt;</span>
52 <a name="l00030"></a>00030
53 <a name="l00031"></a>00031 <span class="keyword">namespace </span>Barry { <span class="keyword">namespace </span>Sync {
54 <a name="l00032"></a>00032
55 <a name="l00033"></a>00033 <span class="comment">//</span>
56 <a name="l00034"></a>00034 <span class="comment">// vCard</span>
57 <a name="l00035"></a>00035 <span class="comment">//</span><span class="comment"></span>
58 <a name="l00036"></a>00036 <span class="comment">/// Class for converting between RFC 2425/2426 vCard data format,</span>
59 <a name="l00037"></a>00037 <span class="comment">/// and the Barry::Contact class.</span>
60 <a name="l00038"></a>00038 <span class="comment">///</span>
61 <a name="l00039"></a><a class="code" href="classBarry_1_1Sync_1_1vCard.html">00039</a> <span class="comment"></span><span class="keyword">class </span>BXEXPORT <a class="code" href="classBarry_1_1Sync_1_1vCard.html" title="Class for converting between RFC 2425/2426 vCard data format, and the Barry::Contact...">vCard</a> : <span class="keyword">public</span> <a class="code" href="classBarry_1_1Sync_1_1vBase.html" title="Base class containing vformat helper API.">vBase</a>
62 <a name="l00040"></a>00040 {
63 <a name="l00041"></a>00041 <span class="comment">// data to pass to external requests</span>
64 <a name="l00042"></a>00042 <span class="keywordtype">char</span> *m_gCardData; <span class="comment">// dynamic memory returned by vformat()... can</span>
65 <a name="l00043"></a>00043 <span class="comment">// be used directly by the plugin, without</span>
66 <a name="l00044"></a>00044 <span class="comment">// overmuch allocation and freeing (see Extract())</span>
67 <a name="l00045"></a>00045 std::string m_vCardData;<span class="comment">// copy of m_gCardData, for C++ use</span>
68 <a name="l00046"></a>00046 <a class="code" href="classBarry_1_1Contact.html" title="Represents a single record in the Address Book Blackberry database.">Barry::Contact</a> m_BarryContact;
69 <a name="l00047"></a>00047
70 <a name="l00048"></a>00048 <span class="keyword">protected</span>:
71 <a name="l00049"></a>00049 <span class="keywordtype">void</span> AddAddress(<span class="keyword">const</span> <span class="keywordtype">char</span> *rfc_type, <span class="keyword">const</span> Barry::PostalAddress &amp;addr);
72 <a name="l00050"></a>00050 <span class="keywordtype">void</span> AddCategories(<span class="keyword">const</span> Barry::CategoryList &amp;categories);
73 <a name="l00051"></a>00051 <span class="keywordtype">void</span> AddPhoneCond(<span class="keyword">const</span> std::string &amp;phone);
74 <a name="l00052"></a>00052 <span class="keywordtype">void</span> AddPhoneCond(<span class="keyword">const</span> <span class="keywordtype">char</span> *rfc_type, <span class="keyword">const</span> std::string &amp;phone);
75 <a name="l00053"></a>00053
76 <a name="l00054"></a>00054 <span class="keywordtype">void</span> ParseAddress(<a class="code" href="classBarry_1_1Sync_1_1vAttr.html" title="Class for reading a b_VFormatAttribute.">vAttr</a> &amp;adr, Barry::PostalAddress &amp;address);
77 <a name="l00055"></a>00055 <span class="keywordtype">void</span> ParseCategories(<a class="code" href="classBarry_1_1Sync_1_1vAttr.html" title="Class for reading a b_VFormatAttribute.">vAttr</a> &amp;cat, Barry::CategoryList &amp;cats);
78 <a name="l00056"></a>00056
79 <a name="l00057"></a>00057 <span class="keyword">public</span>:
80 <a name="l00058"></a>00058 <a class="code" href="classBarry_1_1Sync_1_1vCard.html" title="Class for converting between RFC 2425/2426 vCard data format, and the Barry::Contact...">vCard</a>();
81 <a name="l00059"></a>00059 ~<a class="code" href="classBarry_1_1Sync_1_1vCard.html" title="Class for converting between RFC 2425/2426 vCard data format, and the Barry::Contact...">vCard</a>();
82 <a name="l00060"></a>00060
83 <a name="l00061"></a>00061 <span class="keyword">const</span> std::string&amp; ToVCard(<span class="keyword">const</span> <a class="code" href="classBarry_1_1Contact.html" title="Represents a single record in the Address Book Blackberry database.">Barry::Contact</a> &amp;con);
84 <a name="l00062"></a>00062 <span class="keyword">const</span> <a class="code" href="classBarry_1_1Contact.html" title="Represents a single record in the Address Book Blackberry database.">Barry::Contact</a>&amp; ToBarry(<span class="keyword">const</span> <span class="keywordtype">char</span> *vcal, uint32_t RecordId);
85 <a name="l00063"></a>00063
86 <a name="l00064"></a>00064 <span class="keyword">const</span> std::string&amp; GetVCard()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> m_vCardData; }
87 <a name="l00065"></a>00065 <span class="keyword">const</span> <a class="code" href="classBarry_1_1Contact.html" title="Represents a single record in the Address Book Blackberry database.">Barry::Contact</a>&amp; GetBarryContact()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> m_BarryContact; }
88 <a name="l00066"></a>00066
89 <a name="l00067"></a>00067 <span class="keywordtype">char</span>* ExtractVCard();
90 <a name="l00068"></a>00068
91 <a name="l00069"></a>00069 <span class="keywordtype">void</span> Clear();
92 <a name="l00070"></a>00070
93 <a name="l00071"></a>00071 <span class="comment">// This is the v-name of the innermost BEGIN/END block</span>
94 <a name="l00072"></a>00072 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* GetVName() { <span class="keywordflow">return</span> <span class="stringliteral">"VCARD"</span>; }
95 <a name="l00073"></a>00073 };
96 <a name="l00074"></a>00074
97 <a name="l00075"></a>00075 }} <span class="comment">// namespace Barry::Sync</span>
98 <a name="l00076"></a>00076
99 <a name="l00077"></a>00077 <span class="preprocessor">#endif</span>
100 <a name="l00078"></a>00078 <span class="preprocessor"></span>
101 </pre></div></div>
102 <hr size="1"><address style="text-align: right;"><small>Generated on Thu Feb 10 16:13:59 2011 for Barry by&nbsp;
103 <a href="http://www.doxygen.org/index.html">
104 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
105 </body>
106 </html>