<!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.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>EXIF library (libexif) API: libexif/exif-entry.h File 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="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</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 id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">EXIF library (libexif) API
 <span id="projectnumber">0.6.21</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('exif-entry_8h.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#define-members">Macros</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">exif-entry.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>Handling EXIF entries.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include <<a class="el" href="exif-content_8h_source.html">libexif/exif-content.h</a>></code><br />
<code>#include <<a class="el" href="exif-format_8h_source.html">libexif/exif-format.h</a>></code><br />
<code>#include <<a class="el" href="exif-mem_8h_source.html">libexif/exif-mem.h</a>></code><br />
</div>
<p><a href="exif-entry_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="struct__ExifEntry.html">_ExifEntry</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Data found in one EXIF tag. <a href="struct__ExifEntry.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ae12a25769109d2339461b48c65637a64"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#ae12a25769109d2339461b48c65637a64">exif_entry_get_ifd</a>(e)   ((e)?<a class="el" href="exif-content_8h.html#a102270386bc7fdc7296e243967f1a2f4">exif_content_get_ifd</a>((e)->parent):EXIF_IFD_COUNT)</td></tr>
<tr class="memdesc:ae12a25769109d2339461b48c65637a64"><td class="mdescLeft"> </td><td class="mdescRight">Return the IFD number of the given <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. <a href="#ae12a25769109d2339461b48c65637a64">More...</a><br /></td></tr>
<tr class="separator:ae12a25769109d2339461b48c65637a64"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:a1629f9c1b9c17765f4e5b297f91a6e45"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="struct__ExifEntry.html">_ExifEntry</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a></td></tr>
<tr class="memdesc:a1629f9c1b9c17765f4e5b297f91a6e45"><td class="mdescLeft"> </td><td class="mdescRight">Data found in one EXIF tag. <a href="#a1629f9c1b9c17765f4e5b297f91a6e45">More...</a><br /></td></tr>
<tr class="separator:a1629f9c1b9c17765f4e5b297f91a6e45"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a53b9c2327db6cd1852e0ea3ab8c44c0d"><td class="memItemLeft" align="right" valign="top"><a id="a53b9c2327db6cd1852e0ea3ab8c44c0d"></a>
typedef struct _ExifEntryPrivate </td><td class="memItemRight" valign="bottom"><b>ExifEntryPrivate</b></td></tr>
<tr class="separator:a53b9c2327db6cd1852e0ea3ab8c44c0d"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a81d54ed31654fc76331ca493a2a35633"><td class="memItemLeft" align="right" valign="top"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a81d54ed31654fc76331ca493a2a35633">exif_entry_new</a> (void)</td></tr>
<tr class="memdesc:a81d54ed31654fc76331ca493a2a35633"><td class="mdescLeft"> </td><td class="mdescRight">Reserve memory for and initialize a new <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. <a href="#a81d54ed31654fc76331ca493a2a35633">More...</a><br /></td></tr>
<tr class="separator:a81d54ed31654fc76331ca493a2a35633"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3f8eb4f2fce7c69d0897cb35261a70f6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a3f8eb4f2fce7c69d0897cb35261a70f6">exif_entry_new_mem</a> (<a class="el" href="exif-mem_8h.html#aab8aacbc0ed6f11a1f022b7b1bf4750e">ExifMem</a> *)</td></tr>
<tr class="memdesc:a3f8eb4f2fce7c69d0897cb35261a70f6"><td class="mdescLeft"> </td><td class="mdescRight">Reserve memory for and initialize new <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> using the specified memory allocator. <a href="#a3f8eb4f2fce7c69d0897cb35261a70f6">More...</a><br /></td></tr>
<tr class="separator:a3f8eb4f2fce7c69d0897cb35261a70f6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a83995c571cabed5171d6193bbef111bc"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a83995c571cabed5171d6193bbef111bc">exif_entry_ref</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry)</td></tr>
<tr class="memdesc:a83995c571cabed5171d6193bbef111bc"><td class="mdescLeft"> </td><td class="mdescRight">Increase reference counter for <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. <a href="#a83995c571cabed5171d6193bbef111bc">More...</a><br /></td></tr>
<tr class="separator:a83995c571cabed5171d6193bbef111bc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad983a948211cb7de95c8fc52049f1bab"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab">exif_entry_unref</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry)</td></tr>
<tr class="memdesc:ad983a948211cb7de95c8fc52049f1bab"><td class="mdescLeft"> </td><td class="mdescRight">Decrease reference counter for <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. <a href="#ad983a948211cb7de95c8fc52049f1bab">More...</a><br /></td></tr>
<tr class="separator:ad983a948211cb7de95c8fc52049f1bab"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3ed3eba673475efc0625741cf5bf6d33"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a3ed3eba673475efc0625741cf5bf6d33">exif_entry_free</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry)</td></tr>
<tr class="memdesc:a3ed3eba673475efc0625741cf5bf6d33"><td class="mdescLeft"> </td><td class="mdescRight">Actually free the <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. <a href="#a3ed3eba673475efc0625741cf5bf6d33">More...</a><br /></td></tr>
<tr class="separator:a3ed3eba673475efc0625741cf5bf6d33"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad7f9e3fd0fde760c332dfbef208589ed"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#ad7f9e3fd0fde760c332dfbef208589ed">exif_entry_initialize</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *e, <a class="el" href="exif-tag_8h.html#a1a0ded93d47585f6889eb546915d0f41">ExifTag</a> tag)</td></tr>
<tr class="memdesc:ad7f9e3fd0fde760c332dfbef208589ed"><td class="mdescLeft"> </td><td class="mdescRight">Initialize an empty <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> with default data in the correct format for the given tag. <a href="#ad7f9e3fd0fde760c332dfbef208589ed">More...</a><br /></td></tr>
<tr class="separator:ad7f9e3fd0fde760c332dfbef208589ed"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a34e2cc8e5cbb928a55cd16de9ce71edf"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a34e2cc8e5cbb928a55cd16de9ce71edf">exif_entry_fix</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry)</td></tr>
<tr class="memdesc:a34e2cc8e5cbb928a55cd16de9ce71edf"><td class="mdescLeft"> </td><td class="mdescRight">Fix the type or format of the given EXIF entry to bring it into spec. <a href="#a34e2cc8e5cbb928a55cd16de9ce71edf">More...</a><br /></td></tr>
<tr class="separator:a34e2cc8e5cbb928a55cd16de9ce71edf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a24425f48dd75ec56f9ac758aaa6ef9c4"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a24425f48dd75ec56f9ac758aaa6ef9c4">exif_entry_get_value</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry, char *val, unsigned int maxlen)</td></tr>
<tr class="memdesc:a24425f48dd75ec56f9ac758aaa6ef9c4"><td class="mdescLeft"> </td><td class="mdescRight">Return a localized textual representation of the value of the EXIF entry. <a href="#a24425f48dd75ec56f9ac758aaa6ef9c4">More...</a><br /></td></tr>
<tr class="separator:a24425f48dd75ec56f9ac758aaa6ef9c4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6d607d079472d7f5eed040c8f081406a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="exif-entry_8h.html#a6d607d079472d7f5eed040c8f081406a">exif_entry_dump</a> (<a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> *entry, unsigned int indent)</td></tr>
<tr class="memdesc:a6d607d079472d7f5eed040c8f081406a"><td class="mdescLeft"> </td><td class="mdescRight">Dump text representation of <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> to stdout. <a href="#a6d607d079472d7f5eed040c8f081406a">More...</a><br /></td></tr>
<tr class="separator:a6d607d079472d7f5eed040c8f081406a"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Handling EXIF entries. </p>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a id="ae12a25769109d2339461b48c65637a64"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae12a25769109d2339461b48c65637a64">◆ </a></span>exif_entry_get_ifd</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define exif_entry_get_ifd</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">e</td><td>)</td>
<td>   ((e)?<a class="el" href="exif-content_8h.html#a102270386bc7fdc7296e243967f1a2f4">exif_content_get_ifd</a>((e)->parent):EXIF_IFD_COUNT)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the IFD number of the given <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">e</td><td>an <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>* </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>#ExifIfd, or #EXIF_IFD_COUNT on error </dd></dl>
<p class="reference">Referenced by <a class="el" href="exif-entry_8h.html#a6d607d079472d7f5eed040c8f081406a">exif_entry_dump()</a>.</p>
</div>
</div>
<h2 class="groupheader">Typedef Documentation</h2>
<a id="a1629f9c1b9c17765f4e5b297f91a6e45"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1629f9c1b9c17765f4e5b297f91a6e45">◆ </a></span>ExifEntry</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="struct__ExifEntry.html">_ExifEntry</a> <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Data found in one EXIF tag. </p>
<p>The <a class="el" href="exif-entry_8h.html#a24425f48dd75ec56f9ac758aaa6ef9c4" title="Return a localized textual representation of the value of the EXIF entry. ">exif_entry_get_value</a> function can provide access to the formatted contents, or the struct members can be used directly to access the raw contents. </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="a6d607d079472d7f5eed040c8f081406a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6d607d079472d7f5eed040c8f081406a">◆ </a></span>exif_entry_dump()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_dump </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>indent</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump text representation of <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> to stdout. </p>
<p>This is intended for diagnostic purposes only.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">entry</td><td>EXIF tag data </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">indent</td><td>how many levels deep to indent the data </td></tr>
</table>
</dd>
</dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#a4d1cd87a5c3f43b3d14b087a44582c06">_ExifEntry::components</a>, <a class="el" href="exif-entry_8h.html#ae12a25769109d2339461b48c65637a64">exif_entry_get_ifd</a>, <a class="el" href="exif-entry_8h.html#a24425f48dd75ec56f9ac758aaa6ef9c4">exif_entry_get_value()</a>, <a class="el" href="exif-format_8h.html#a59375a5939c716b826311c22571680f3">exif_format_get_name()</a>, <a class="el" href="exif-tag_8h.html#a82b5a88d44d27d432afb5a1db74268b0">exif_tag_get_name_in_ifd()</a>, <a class="el" href="struct__ExifEntry.html#a6129f19697eff3ab581e0a8455d9fbae">_ExifEntry::format</a>, <a class="el" href="struct__ExifEntry.html#afee38ed13748497cc838b3c746ff8559">_ExifEntry::size</a>, and <a class="el" href="struct__ExifEntry.html#aa03a4dc9fa98c8bbc447c19a4d0536e9">_ExifEntry::tag</a>.</p>
<p class="reference">Referenced by <a class="el" href="exif-content_8h.html#a941c3522a39280f44329eaf364645620">exif_content_dump()</a>.</p>
</div>
</div>
<a id="a34e2cc8e5cbb928a55cd16de9ce71edf"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a34e2cc8e5cbb928a55cd16de9ce71edf">◆ </a></span>exif_entry_fix()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_fix </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Fix the type or format of the given EXIF entry to bring it into spec. </p>
<p>If the data for this EXIF tag is in of the wrong type or is in an invalid format according to the EXIF specification, then it is converted to make it valid. This may involve, for example, converting an EXIF_FORMAT_LONG into a EXIF_FORMAT_SHORT. If the tag is unknown, its value is untouched.</p>
<dl class="section note"><dt>Note</dt><dd>Unfortunately, some conversions are to a type with a more restricted range, which could have the side effect that the converted data becomes invalid. This is unlikely as the range of each tag in the standard is designed to encompass all likely data.</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in,out]</td><td class="paramname">entry</td><td>EXIF entry </td></tr>
</table>
</dd>
</dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#ab596479b192bc474d77a98600d4201e2">_ExifEntry::priv</a>, and <a class="el" href="struct__ExifEntry.html#aa03a4dc9fa98c8bbc447c19a4d0536e9">_ExifEntry::tag</a>.</p>
</div>
</div>
<a id="a3ed3eba673475efc0625741cf5bf6d33"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3ed3eba673475efc0625741cf5bf6d33">◆ </a></span>exif_entry_free()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_free </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Actually free the <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></b></dt><dd>Should not be called directly. Use <a class="el" href="exif-entry_8h.html#a83995c571cabed5171d6193bbef111bc" title="Increase reference counter for ExifEntry. ">exif_entry_ref</a> and <a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab" title="Decrease reference counter for ExifEntry. ">exif_entry_unref</a> instead.</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">entry</td><td>EXIF entry </td></tr>
</table>
</dd>
</dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#a7fd255a932578e60a5fbaac47d4362d4">_ExifEntry::data</a>, and <a class="el" href="struct__ExifEntry.html#ab596479b192bc474d77a98600d4201e2">_ExifEntry::priv</a>.</p>
<p class="reference">Referenced by <a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab">exif_entry_unref()</a>.</p>
</div>
</div>
<a id="a24425f48dd75ec56f9ac758aaa6ef9c4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a24425f48dd75ec56f9ac758aaa6ef9c4">◆ </a></span>exif_entry_get_value()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* exif_entry_get_value </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>val</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>maxlen</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return a localized textual representation of the value of the EXIF entry. </p>
<p>This is meant for display to the user. The format of each tag is subject to change between locales and in newer versions of libexif. Users who require the tag data in an unambiguous form should access the data members of the <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> structure directly.</p>
<dl class="section warning"><dt>Warning</dt><dd>The character set of the returned string may be in the encoding of the current locale or the native encoding of the camera. </dd></dl>
<dl class="bug"><dt><b><a class="el" href="bug.html#_bug000003">Bug:</a></b></dt><dd>The EXIF_TAG_XP_* tags are currently always returned in UTF-8, regardless of locale, and code points above U+FFFF are not supported.</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">entry</td><td>EXIF entry </td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">val</td><td>buffer in which to store value </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">maxlen</td><td>length of the buffer val </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>val pointer </dd></dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#a4d1cd87a5c3f43b3d14b087a44582c06">_ExifEntry::components</a>, <a class="el" href="exif-data_8h.html#a2d8d50e6a9c19d28fe8192ef7cc52777">exif_data_get_byte_order()</a>, <a class="el" href="exif-format_8h.html#a924038efe0cd8ebade8f44619dd794f3">exif_format_get_size()</a>, <a class="el" href="struct__ExifEntry.html#a6129f19697eff3ab581e0a8455d9fbae">_ExifEntry::format</a>, <a class="el" href="struct__ExifContent.html#aae965558ea5c98783c4c2418364aabea">_ExifContent::parent</a>, <a class="el" href="struct__ExifEntry.html#a6a4cb064a2c7d60f3fd439e2b3cab2a6">_ExifEntry::parent</a>, <a class="el" href="struct__ExifEntry.html#afee38ed13748497cc838b3c746ff8559">_ExifEntry::size</a>, and <a class="el" href="struct__ExifEntry.html#aa03a4dc9fa98c8bbc447c19a4d0536e9">_ExifEntry::tag</a>.</p>
<p class="reference">Referenced by <a class="el" href="exif-entry_8h.html#a6d607d079472d7f5eed040c8f081406a">exif_entry_dump()</a>.</p>
</div>
</div>
<a id="ad7f9e3fd0fde760c332dfbef208589ed"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad7f9e3fd0fde760c332dfbef208589ed">◆ </a></span>exif_entry_initialize()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_initialize </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>e</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="exif-tag_8h.html#a1a0ded93d47585f6889eb546915d0f41">ExifTag</a> </td>
<td class="paramname"><em>tag</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize an empty <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> with default data in the correct format for the given tag. </p>
<p>If the entry is already initialized, this function does nothing. This call allocates memory for the <code>data</code> element of the given <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. That memory is freed at the same time as the <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[out]</td><td class="paramname">e</td><td>entry to initialize </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">tag</td><td>tag number to initialize as</td></tr>
</table>
</dd>
</dl>
<dl class="bug"><dt><b><a class="el" href="bug.html#_bug000002">Bug:</a></b></dt><dd>Log and report failed exif_mem_malloc() calls.</dd></dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#a7fd255a932578e60a5fbaac47d4362d4">_ExifEntry::data</a>, <a class="el" href="exif-data_8h.html#a2d8d50e6a9c19d28fe8192ef7cc52777">exif_data_get_byte_order()</a>, <a class="el" href="struct__ExifContent.html#aae965558ea5c98783c4c2418364aabea">_ExifContent::parent</a>, <a class="el" href="struct__ExifEntry.html#a6a4cb064a2c7d60f3fd439e2b3cab2a6">_ExifEntry::parent</a>, and <a class="el" href="struct__ExifEntry.html#aa03a4dc9fa98c8bbc447c19a4d0536e9">_ExifEntry::tag</a>.</p>
</div>
</div>
<a id="a81d54ed31654fc76331ca493a2a35633"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a81d54ed31654fc76331ca493a2a35633">◆ </a></span>exif_entry_new()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a>* exif_entry_new </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reserve memory for and initialize a new <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. </p>
<p>No memory is allocated for the <code>data</code> element of the returned <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>.</p>
<dl class="section return"><dt>Returns</dt><dd>new allocated <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>, or NULL on error</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="exif-entry_8h.html#a3f8eb4f2fce7c69d0897cb35261a70f6" title="Reserve memory for and initialize new ExifEntry using the specified memory allocator. ">exif_entry_new_mem</a>, <a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab" title="Decrease reference counter for ExifEntry. ">exif_entry_unref</a> </dd></dl>
<p class="reference">References <a class="el" href="exif-entry_8h.html#a3f8eb4f2fce7c69d0897cb35261a70f6">exif_entry_new_mem()</a>, <a class="el" href="exif-mem_8h.html#acd2926c29b470c9d43f84567a84d5acb">exif_mem_new_default()</a>, and <a class="el" href="exif-mem_8h.html#adabd1345e1172ce379658cecfd3f7d70">exif_mem_unref()</a>.</p>
</div>
</div>
<a id="a3f8eb4f2fce7c69d0897cb35261a70f6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3f8eb4f2fce7c69d0897cb35261a70f6">◆ </a></span>exif_entry_new_mem()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a>* exif_entry_new_mem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-mem_8h.html#aab8aacbc0ed6f11a1f022b7b1bf4750e">ExifMem</a> * </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reserve memory for and initialize new <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> using the specified memory allocator. </p>
<p>No memory is allocated for the <code>data</code> element of the returned <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>.</p>
<dl class="section return"><dt>Returns</dt><dd>new allocated <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>, or NULL on error</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="exif-entry_8h.html#a81d54ed31654fc76331ca493a2a35633" title="Reserve memory for and initialize a new ExifEntry. ">exif_entry_new</a>, <a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab" title="Decrease reference counter for ExifEntry. ">exif_entry_unref</a> </dd></dl>
<p class="reference">Referenced by <a class="el" href="exif-entry_8h.html#a81d54ed31654fc76331ca493a2a35633">exif_entry_new()</a>.</p>
</div>
</div>
<a id="a83995c571cabed5171d6193bbef111bc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a83995c571cabed5171d6193bbef111bc">◆ </a></span>exif_entry_ref()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_ref </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Increase reference counter for <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">entry</td><td><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a></td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="exif-entry_8h.html#ad983a948211cb7de95c8fc52049f1bab" title="Decrease reference counter for ExifEntry. ">exif_entry_unref</a> </dd></dl>
<p class="reference">References <a class="el" href="struct__ExifEntry.html#ab596479b192bc474d77a98600d4201e2">_ExifEntry::priv</a>.</p>
</div>
</div>
<a id="ad983a948211cb7de95c8fc52049f1bab"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad983a948211cb7de95c8fc52049f1bab">◆ </a></span>exif_entry_unref()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void exif_entry_unref </td>
<td>(</td>
<td class="paramtype"><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45">ExifEntry</a> * </td>
<td class="paramname"><em>entry</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Decrease reference counter for <a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a>. </p>
<p>When the reference count drops to zero, free the entry.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">entry</td><td><a class="el" href="exif-entry_8h.html#a1629f9c1b9c17765f4e5b297f91a6e45" title="Data found in one EXIF tag. ">ExifEntry</a> </td></tr>
</table>
</dd>
</dl>
<p class="reference">References <a class="el" href="exif-entry_8h.html#a3ed3eba673475efc0625741cf5bf6d33">exif_entry_free()</a>, and <a class="el" href="struct__ExifEntry.html#ab596479b192bc474d77a98600d4201e2">_ExifEntry::priv</a>.</p>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="dir_04d2bd150f7cc849eeec70b9b0fdccb1.html">libexif</a></li><li class="navelem"><a class="el" href="exif-entry_8h.html">exif-entry.h</a></li>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li>
</ul>
</div>
</body>
</html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
81f8f8cab415e843eef59cf17d943f66
>
files
>
53
