<!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"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.5"/> <title>Exiv2: Exiv2::IptcData Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="search/search.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="search/search.js"></script> <script type="text/javascript"> $(document).ready(function() { searchBox.OnSelectItem(0); }); </script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">Exiv2 </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <script type="text/javascript"> var searchBox = new SearchBox("searchBox", "search",false,'Search'); </script> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> <li><a href="examples.html"><span>Examples</span></a></li> <li> <div id="MSearchBox" class="MSearchBoxInactive"> <span class="left"> <img id="MSearchSelect" src="search/mag_sel.png" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()" alt=""/> <input type="text" id="MSearchField" value="Search" accesskey="S" onfocus="searchBox.OnSearchFieldFocus(true)" onblur="searchBox.OnSearchFieldFocus(false)" onkeyup="searchBox.OnSearchFieldChange(event)"/> </span><span class="right"> <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a> </span> </div> </li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <!-- window showing the filter options --> <div id="MSearchSelectWindow" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()" onkeydown="return searchBox.OnSearchSelectKey(event)"> <a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(11)"><span class="SelectionMark"> </span>Pages</a></div> <!-- iframe showing the search results (closed by default) --> <div id="MSearchResultsWindow"> <iframe src="javascript:void(0)" frameborder="0" name="MSearchResults" id="MSearchResults"> </iframe> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="namespaceExiv2.html">Exiv2</a></li><li class="navelem"><a class="el" href="classExiv2_1_1IptcData.html">IptcData</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-types">Public Types</a> | <a href="classExiv2_1_1IptcData-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">Exiv2::IptcData Class Reference</div> </div> </div><!--header--> <div class="contents"> <p>A container for IPTC data. This is a top-level class of the Exiv2 library. <a href="classExiv2_1_1IptcData.html#details">More...</a></p> <p><code>#include <iptc.hpp></code></p> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> Public Types</h2></td></tr> <tr class="memitem:a0d53776cd2f36e63fff78c8f142a7caf"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0d53776cd2f36e63fff78c8f142a7caf"></a> typedef IptcMetadata::iterator </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a></td></tr> <tr class="memdesc:a0d53776cd2f36e63fff78c8f142a7caf"><td class="mdescLeft"> </td><td class="mdescRight">IptcMetadata iterator type. <br/></td></tr> <tr class="separator:a0d53776cd2f36e63fff78c8f142a7caf"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a683257be46a446865ca5f4e81b8e88d9"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a683257be46a446865ca5f4e81b8e88d9"></a> typedef <br class="typebreak"/> IptcMetadata::const_iterator </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a683257be46a446865ca5f4e81b8e88d9">const_iterator</a></td></tr> <tr class="memdesc:a683257be46a446865ca5f4e81b8e88d9"><td class="mdescLeft"> </td><td class="mdescRight">IptcMetadata const iterator type. <br/></td></tr> <tr class="separator:a683257be46a446865ca5f4e81b8e88d9"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr><td colspan="2"><div class="groupHeader">Manipulators</div></td></tr> <tr class="memitem:ab2b58c6eda595eee09ac5f61e93070f7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classExiv2_1_1Iptcdatum.html">Iptcdatum</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#ab2b58c6eda595eee09ac5f61e93070f7">operator[]</a> (const std::string &key)</td></tr> <tr class="memdesc:ab2b58c6eda595eee09ac5f61e93070f7"><td class="mdescLeft"> </td><td class="mdescRight">Returns a reference to the Iptcdatum that is associated with a particular <em>key</em>. If IptcData does not already contain such an Iptcdatum, operator[] adds object <em>Iptcdatum(key)</em>. <a href="#ab2b58c6eda595eee09ac5f61e93070f7">More...</a><br/></td></tr> <tr class="separator:ab2b58c6eda595eee09ac5f61e93070f7"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6c209bd981fc5073ae5effaa56d07310"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a6c209bd981fc5073ae5effaa56d07310">add</a> (const <a class="el" href="classExiv2_1_1IptcKey.html">IptcKey</a> &key, <a class="el" href="classExiv2_1_1Value.html">Value</a> *value)</td></tr> <tr class="memdesc:a6c209bd981fc5073ae5effaa56d07310"><td class="mdescLeft"> </td><td class="mdescRight">Add an Iptcdatum from the supplied key and value pair. This method copies (clones) the value. A check for non-repeatable datasets is performed. <a href="#a6c209bd981fc5073ae5effaa56d07310">More...</a><br/></td></tr> <tr class="separator:a6c209bd981fc5073ae5effaa56d07310"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2d843afb1f9c0978b8845c741148ed27"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a2d843afb1f9c0978b8845c741148ed27">add</a> (const <a class="el" href="classExiv2_1_1Iptcdatum.html">Iptcdatum</a> &iptcdatum)</td></tr> <tr class="memdesc:a2d843afb1f9c0978b8845c741148ed27"><td class="mdescLeft"> </td><td class="mdescRight">Add a copy of the <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> to the IPTC metadata. A check for non-repeatable datasets is performed. <a href="#a2d843afb1f9c0978b8845c741148ed27">More...</a><br/></td></tr> <tr class="separator:a2d843afb1f9c0978b8845c741148ed27"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a56782cedd228be37bf5d1c3df77b6435"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a56782cedd228be37bf5d1c3df77b6435"></a> <a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a56782cedd228be37bf5d1c3df77b6435">erase</a> (<a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> pos)</td></tr> <tr class="memdesc:a56782cedd228be37bf5d1c3df77b6435"><td class="mdescLeft"> </td><td class="mdescRight">Delete the <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> at iterator position pos, return the position of the next <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a>. Note that iterators into the metadata, including pos, are potentially invalidated by this call. <br/></td></tr> <tr class="separator:a56782cedd228be37bf5d1c3df77b6435"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aee7392b0585be4916c56f08e3c9e7be5"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aee7392b0585be4916c56f08e3c9e7be5"></a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#aee7392b0585be4916c56f08e3c9e7be5">clear</a> ()</td></tr> <tr class="memdesc:aee7392b0585be4916c56f08e3c9e7be5"><td class="mdescLeft"> </td><td class="mdescRight">Delete all <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> instances resulting in an empty container. <br/></td></tr> <tr class="separator:aee7392b0585be4916c56f08e3c9e7be5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3db828436ee87c6d4d1d4a450b0c3c10"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3db828436ee87c6d4d1d4a450b0c3c10"></a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a3db828436ee87c6d4d1d4a450b0c3c10">sortByKey</a> ()</td></tr> <tr class="memdesc:a3db828436ee87c6d4d1d4a450b0c3c10"><td class="mdescLeft"> </td><td class="mdescRight">Sort metadata by key. <br/></td></tr> <tr class="separator:a3db828436ee87c6d4d1d4a450b0c3c10"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a622ff967f192b898e05920dfbc63aabe"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a622ff967f192b898e05920dfbc63aabe"></a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a622ff967f192b898e05920dfbc63aabe">sortByTag</a> ()</td></tr> <tr class="memdesc:a622ff967f192b898e05920dfbc63aabe"><td class="mdescLeft"> </td><td class="mdescRight">Sort metadata by tag (aka dataset) <br/></td></tr> <tr class="separator:a622ff967f192b898e05920dfbc63aabe"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a03385c128b29d262ade837093fddc0d2"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a03385c128b29d262ade837093fddc0d2"></a> <a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a03385c128b29d262ade837093fddc0d2">begin</a> ()</td></tr> <tr class="memdesc:a03385c128b29d262ade837093fddc0d2"><td class="mdescLeft"> </td><td class="mdescRight">Begin of the metadata. <br/></td></tr> <tr class="separator:a03385c128b29d262ade837093fddc0d2"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6753e8a713ab2b42a3bdc7b3d9eab401"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6753e8a713ab2b42a3bdc7b3d9eab401"></a> <a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a6753e8a713ab2b42a3bdc7b3d9eab401">end</a> ()</td></tr> <tr class="memdesc:a6753e8a713ab2b42a3bdc7b3d9eab401"><td class="mdescLeft"> </td><td class="mdescRight">End of the metadata. <br/></td></tr> <tr class="separator:a6753e8a713ab2b42a3bdc7b3d9eab401"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ae53fdfabd295de29b971e51cd1fa9347"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae53fdfabd295de29b971e51cd1fa9347"></a> <a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#ae53fdfabd295de29b971e51cd1fa9347">findKey</a> (const <a class="el" href="classExiv2_1_1IptcKey.html">IptcKey</a> &key)</td></tr> <tr class="memdesc:ae53fdfabd295de29b971e51cd1fa9347"><td class="mdescLeft"> </td><td class="mdescRight">Find the first <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> with the given key, return an iterator to it. <br/></td></tr> <tr class="separator:ae53fdfabd295de29b971e51cd1fa9347"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a3218fa1e8cc6a8f6c75982f3fd554507"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3218fa1e8cc6a8f6c75982f3fd554507"></a> <a class="el" href="classExiv2_1_1IptcData.html#a0d53776cd2f36e63fff78c8f142a7caf">iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a3218fa1e8cc6a8f6c75982f3fd554507">findId</a> (uint16_t dataset, uint16_t record=IptcDataSets::application2)</td></tr> <tr class="memdesc:a3218fa1e8cc6a8f6c75982f3fd554507"><td class="mdescLeft"> </td><td class="mdescRight">Find the first <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> with the given record and dataset it, return a const iterator to it. <br/></td></tr> <tr class="separator:a3218fa1e8cc6a8f6c75982f3fd554507"><td class="memSeparator" colspan="2"> </td></tr> <tr><td colspan="2"><div class="groupHeader">Accessors</div></td></tr> <tr class="memitem:aeee89e2ea157cb1e3739ccbbf239cce5"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeee89e2ea157cb1e3739ccbbf239cce5"></a> <a class="el" href="classExiv2_1_1IptcData.html#a683257be46a446865ca5f4e81b8e88d9">const_iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#aeee89e2ea157cb1e3739ccbbf239cce5">begin</a> () const </td></tr> <tr class="memdesc:aeee89e2ea157cb1e3739ccbbf239cce5"><td class="mdescLeft"> </td><td class="mdescRight">Begin of the metadata. <br/></td></tr> <tr class="separator:aeee89e2ea157cb1e3739ccbbf239cce5"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ac209f133796a4811776e3fe85b432506"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ac209f133796a4811776e3fe85b432506"></a> <a class="el" href="classExiv2_1_1IptcData.html#a683257be46a446865ca5f4e81b8e88d9">const_iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#ac209f133796a4811776e3fe85b432506">end</a> () const </td></tr> <tr class="memdesc:ac209f133796a4811776e3fe85b432506"><td class="mdescLeft"> </td><td class="mdescRight">End of the metadata. <br/></td></tr> <tr class="separator:ac209f133796a4811776e3fe85b432506"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:acf7cb48fe542d615efaedd3175d5e541"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acf7cb48fe542d615efaedd3175d5e541"></a> <a class="el" href="classExiv2_1_1IptcData.html#a683257be46a446865ca5f4e81b8e88d9">const_iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#acf7cb48fe542d615efaedd3175d5e541">findKey</a> (const <a class="el" href="classExiv2_1_1IptcKey.html">IptcKey</a> &key) const </td></tr> <tr class="memdesc:acf7cb48fe542d615efaedd3175d5e541"><td class="mdescLeft"> </td><td class="mdescRight">Find the first <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> with the given key, return a const iterator to it. <br/></td></tr> <tr class="separator:acf7cb48fe542d615efaedd3175d5e541"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af56ada8ee4ab77c6f5a1b0924ee85be6"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af56ada8ee4ab77c6f5a1b0924ee85be6"></a> <a class="el" href="classExiv2_1_1IptcData.html#a683257be46a446865ca5f4e81b8e88d9">const_iterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#af56ada8ee4ab77c6f5a1b0924ee85be6">findId</a> (uint16_t dataset, uint16_t record=IptcDataSets::application2) const </td></tr> <tr class="memdesc:af56ada8ee4ab77c6f5a1b0924ee85be6"><td class="mdescLeft"> </td><td class="mdescRight">Find the first <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> with the given record and dataset number, return a const iterator to it. <br/></td></tr> <tr class="separator:af56ada8ee4ab77c6f5a1b0924ee85be6"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:afda626e27ebecd599005c68022db9c1c"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afda626e27ebecd599005c68022db9c1c"></a> bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#afda626e27ebecd599005c68022db9c1c">empty</a> () const </td></tr> <tr class="memdesc:afda626e27ebecd599005c68022db9c1c"><td class="mdescLeft"> </td><td class="mdescRight">Return true if there is no IPTC metadata. <br/></td></tr> <tr class="separator:afda626e27ebecd599005c68022db9c1c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ab0b73759b3483b94deec4dac32e1a591"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab0b73759b3483b94deec4dac32e1a591"></a> long </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#ab0b73759b3483b94deec4dac32e1a591">count</a> () const </td></tr> <tr class="memdesc:ab0b73759b3483b94deec4dac32e1a591"><td class="mdescLeft"> </td><td class="mdescRight">Get the number of metadata entries. <br/></td></tr> <tr class="separator:ab0b73759b3483b94deec4dac32e1a591"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a96def22b723dfabe9ec5decfdae8574e"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a96def22b723dfabe9ec5decfdae8574e"></a> long </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a96def22b723dfabe9ec5decfdae8574e">size</a> () const </td></tr> <tr class="memdesc:a96def22b723dfabe9ec5decfdae8574e"><td class="mdescLeft"> </td><td class="mdescRight">Return the exact size of all contained IPTC metadata. <br/></td></tr> <tr class="separator:a96def22b723dfabe9ec5decfdae8574e"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1119fc7d0dbec8ea03fa34204672ace9"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1119fc7d0dbec8ea03fa34204672ace9"></a> const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1IptcData.html#a1119fc7d0dbec8ea03fa34204672ace9">detectCharset</a> () const </td></tr> <tr class="memdesc:a1119fc7d0dbec8ea03fa34204672ace9"><td class="mdescLeft"> </td><td class="mdescRight">Return the metadata charset name or 0. <br/></td></tr> <tr class="separator:a1119fc7d0dbec8ea03fa34204672ace9"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>A container for IPTC data. This is a top-level class of the Exiv2 library. </p> <p>Provide high-level access to the IPTC data of an image:</p> <ul> <li>read IPTC information from JPEG files</li> <li>access metadata through keys and standard C++ iterators</li> <li>add, modify and delete metadata</li> <li>write IPTC data to JPEG files</li> <li>extract IPTC metadata to files, insert from these files </li> </ul> <dl><dt><b>Examples: </b></dt><dd><a class="el" href="iptceasy_8cpp-example.html#_a1">iptceasy.cpp</a>, and <a class="el" href="iptcprint_8cpp-example.html#_a1">iptcprint.cpp</a>.</dd> </dl></div><h2 class="groupheader">Member Function Documentation</h2> <a class="anchor" id="a6c209bd981fc5073ae5effaa56d07310"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Exiv2::IptcData::add </td> <td>(</td> <td class="paramtype">const <a class="el" href="classExiv2_1_1IptcKey.html">IptcKey</a> & </td> <td class="paramname"><em>key</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="classExiv2_1_1Value.html">Value</a> * </td> <td class="paramname"><em>value</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Add an Iptcdatum from the supplied key and value pair. This method copies (clones) the value. A check for non-repeatable datasets is performed. </p> <dl class="section return"><dt>Returns</dt><dd>0 if successful;<br/> 6 if the dataset already exists and is not repeatable </dd></dl> <p>Referenced by <a class="el" href="classExiv2_1_1Converter.html#aaa7c55b0481e6469d3195b0f99f70d5d">Exiv2::Converter::cnvXmpValueToIptc()</a>, and <a class="el" href="classExiv2_1_1IptcData.html#ab2b58c6eda595eee09ac5f61e93070f7">operator[]()</a>.</p> </div> </div> <a class="anchor" id="a2d843afb1f9c0978b8845c741148ed27"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Exiv2::IptcData::add </td> <td>(</td> <td class="paramtype">const <a class="el" href="classExiv2_1_1Iptcdatum.html">Iptcdatum</a> & </td> <td class="paramname"><em>iptcdatum</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Add a copy of the <a class="el" href="classExiv2_1_1Iptcdatum.html" title="An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these...">Iptcdatum</a> to the IPTC metadata. A check for non-repeatable datasets is performed. </p> <dl class="section return"><dt>Returns</dt><dd>0 if successful;<br/> 6 if the dataset already exists and is not repeatable;<br/> </dd></dl> <p>References <a class="el" href="classExiv2_1_1IptcDataSets.html#aec65e226142ca1cc42d500d2975339f7">Exiv2::IptcDataSets::dataSetRepeatable()</a>, <a class="el" href="classExiv2_1_1IptcData.html#a6753e8a713ab2b42a3bdc7b3d9eab401">end()</a>, <a class="el" href="classExiv2_1_1IptcData.html#a3218fa1e8cc6a8f6c75982f3fd554507">findId()</a>, <a class="el" href="classExiv2_1_1Iptcdatum.html#ae0c9a888c38f17689e14b38baef0fe9b">Exiv2::Iptcdatum::record()</a>, and <a class="el" href="classExiv2_1_1Iptcdatum.html#a2b3bc419980b4a9375a1c225e3851b89">Exiv2::Iptcdatum::tag()</a>.</p> </div> </div> <a class="anchor" id="ab2b58c6eda595eee09ac5f61e93070f7"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classExiv2_1_1Iptcdatum.html">Iptcdatum</a> & Exiv2::IptcData::operator[] </td> <td>(</td> <td class="paramtype">const std::string & </td> <td class="paramname"><em>key</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Returns a reference to the Iptcdatum that is associated with a particular <em>key</em>. If IptcData does not already contain such an Iptcdatum, operator[] adds object <em>Iptcdatum(key)</em>. </p> <dl class="section note"><dt>Note</dt><dd>Since operator[] might insert a new element, it can't be a const member function. </dd></dl> <p>References <a class="el" href="classExiv2_1_1IptcData.html#a6c209bd981fc5073ae5effaa56d07310">add()</a>, <a class="el" href="classExiv2_1_1IptcData.html#a6753e8a713ab2b42a3bdc7b3d9eab401">end()</a>, and <a class="el" href="classExiv2_1_1IptcData.html#ae53fdfabd295de29b971e51cd1fa9347">findKey()</a>.</p> </div> </div> <hr/>The documentation for this class was generated from the following files:<ul> <li><a class="el" href="iptc_8hpp.html">iptc.hpp</a></li> <li>iptc.cpp</li> </ul> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Fri Oct 18 2013 00:15:41 for Exiv2 by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>