<?xml version="1.0" encoding="iso-8859-1"?>
<!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>
<!-- template designed by Marco Von Ballmoos -->
<title>File Source for PelEntry.php</title>
<link rel="stylesheet" href="../media/stylesheet.css" />
<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
</head>
<body>
<h1>Source for file PelEntry.php</h1>
<p>Documentation is available at <a href="../PEL/_PelEntry.php.html">PelEntry.php</a></p>
<div class="src-code">
<div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
<li><div class="src-line"><a name="a2"></a> </div></li>
<li><div class="src-line"><a name="a3"></a><span class="src-comm">/* PEL: PHP Exif Library. A library with support for reading and</span></div></li>
<li><div class="src-line"><a name="a4"></a><span class="src-comm"> * writing all Exif headers in JPEG and TIFF images using PHP.</span></div></li>
<li><div class="src-line"><a name="a5"></a><span class="src-comm"> *</span></div></li>
<li><div class="src-line"><a name="a6"></a><span class="src-comm"> * Copyright (C) 2004, 2005, 2006 Martin Geisler.</span></div></li>
<li><div class="src-line"><a name="a7"></a><span class="src-comm"> *</span></div></li>
<li><div class="src-line"><a name="a8"></a><span class="src-comm"> * This program is free software; you can redistribute it and/or modify</span></div></li>
<li><div class="src-line"><a name="a9"></a><span class="src-comm"> * it under the terms of the GNU General Public License as published by</span></div></li>
<li><div class="src-line"><a name="a10"></a><span class="src-comm"> * the Free Software Foundation; either version 2 of the License, or</span></div></li>
<li><div class="src-line"><a name="a11"></a><span class="src-comm"> * (at your option) any later version.</span></div></li>
<li><div class="src-line"><a name="a12"></a><span class="src-comm"> *</span></div></li>
<li><div class="src-line"><a name="a13"></a><span class="src-comm"> * This program is distributed in the hope that it will be useful,</span></div></li>
<li><div class="src-line"><a name="a14"></a><span class="src-comm"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div></li>
<li><div class="src-line"><a name="a15"></a><span class="src-comm"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span></div></li>
<li><div class="src-line"><a name="a16"></a><span class="src-comm"> * GNU General Public License for more details.</span></div></li>
<li><div class="src-line"><a name="a17"></a><span class="src-comm"> *</span></div></li>
<li><div class="src-line"><a name="a18"></a><span class="src-comm"> * You should have received a copy of the GNU General Public License</span></div></li>
<li><div class="src-line"><a name="a19"></a><span class="src-comm"> * along with this program in the file COPYING; if not, write to the</span></div></li>
<li><div class="src-line"><a name="a20"></a><span class="src-comm"> * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,</span></div></li>
<li><div class="src-line"><a name="a21"></a><span class="src-comm"> * Boston, MA 02110-1301 USA</span></div></li>
<li><div class="src-line"><a name="a22"></a><span class="src-comm"> */</span></div></li>
<li><div class="src-line"><a name="a23"></a> </div></li>
<li><div class="src-line"><a name="a24"></a><span class="src-doc">/* $Id: PelEntry.php 442 2006-09-17 12:45:10Z mgeisler $ */</span></div></li>
<li><div class="src-line"><a name="a25"></a> </div></li>
<li><div class="src-line"><a name="a26"></a> </div></li>
<li><div class="src-line"><a name="a27"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * Classes for dealing with Exif entries.</span></div></li>
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a30"></a><span class="src-doc"> * This file defines two exception classes and the abstract class</span></div></li>
<li><div class="src-line"><a name="a31"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link PelEntry}</span><span class="src-doc"> which provides the basic methods that all Exif</span></div></li>
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * entries will have. All Exif entries will be represented by</span></div></li>
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> * descendants of the </span><span class="src-doc-inlinetag">{@link PelEntry}</span><span class="src-doc"> class --- the class itself is</span></div></li>
<li><div class="src-line"><a name="a34"></a><span class="src-doc"> * abstract and so it cannot be instantiated.</span></div></li>
<li><div class="src-line"><a name="a35"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a36"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Martin Geisler <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Revision: 442 $</span></div></li>
<li><div class="src-line"><a name="a38"></a><span class="src-doc"> * </span><span class="src-doc-tag">@date</span><span class="src-doc"> $Date: 2006-09-17 14:45:10 +0200 (Sun, 17 Sep 2006) $</span></div></li>
<li><div class="src-line"><a name="a39"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.gnu.org/licenses/gpl.html GNU General Public</span></div></li>
<li><div class="src-line"><a name="a40"></a><span class="src-doc"> * License (GPL)</span></div></li>
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PEL</span></div></li>
<li><div class="src-line"><a name="a42"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a43"></a> </div></li>
<li><div class="src-line"><a name="a44"></a><span class="src-doc">/**#@+ Required class definitions. */</span></div></li>
<li><div class="src-line"><a name="a45"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-str">'PelException.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a46"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-str">'PelFormat.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a47"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-str">'PelTag.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a48"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-str">'Pel.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a49"></a><span class="src-doc-close-template">/**#@-*/</span></div></li>
<li><div class="src-line"><a name="a50"></a> </div></li>
<li><div class="src-line"><a name="a51"></a> </div></li>
<li><div class="src-line"><a name="a52"></a><span class="src-doc-template"> * Exception indicating a problem with an entry.</span></div></li>
<li><div class="src-line"><a name="a53"></a><span class="src-doc-template"> *</span></div></li>
<li><div class="src-line"><a name="a54"></a><span class="src-doc-template"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc-template"> Martin Geisler <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a55"></a><span class="src-doc-template"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc-template"> PEL</span></div></li>
<li><div class="src-line"><a name="a56"></a><span class="src-doc-template"> * </span><span class="src-doc-coretag">@subpackage</span><span class="src-doc-template"> Exception</span></div></li>
<li><div class="src-line"><a name="a58"></a><span class="src-doc-template"> */</span></div></li>
<li><div class="src-line"><a name="a59"></a><span class="src-key">class </span><a href="../PEL/Exception/PelEntryException.html">PelEntryException</a> <span class="src-key">extends </span><a href="../PEL/Exception/PelException.html">PelException</a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a60"></a> </div></li>
<li><div class="src-line"><a name="a61"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a62"></a><span class="src-doc"> * The IFD type (if known).</span></div></li>
<li><div class="src-line"><a name="a63"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a64"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">int </span></div></li>
<li><div class="src-line"><a name="a65"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a66"></a> <span class="src-key">protected </span><a href="../PEL/Exception/PelEntryException.html#var$type">$type</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a67"></a> </div></li>
<li><div class="src-line"><a name="a68"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a69"></a><span class="src-doc"> * The tag of the entry (if known).</span></div></li>
<li><div class="src-line"><a name="a70"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a71"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">PelTag </span></div></li>
<li><div class="src-line"><a name="a72"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a73"></a> <span class="src-key">protected </span><a href="../PEL/Exception/PelEntryException.html#var$tag">$tag</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a74"></a> </div></li>
<li><div class="src-line"><a name="a75"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a76"></a><span class="src-doc"> * Get the IFD type associated with the exception.</span></div></li>
<li><div class="src-line"><a name="a77"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a78"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">int </span><span class="src-doc">one of </span><span class="src-doc-inlinetag">{@link PelIfd::IFD0}</span><span class="src-doc">, </span><span class="src-doc-inlinetag">{@link PelIfd::IFD1}</span><span class="src-doc">,</span></div></li>
<li><div class="src-line"><a name="a79"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link PelIfd::EXIF}</span><span class="src-doc">, </span><span class="src-doc-inlinetag">{@link PelIfd::GPS}</span><span class="src-doc">, or </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a80"></a><span class="src-doc"> * PelIfd::INTEROPERABILITY}. If no type is set, null is returned.</span></div></li>
<li><div class="src-line"><a name="a81"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a82"></a> <span class="src-key">function </span><a href="../PEL/Exception/PelEntryException.html#methodgetIfdType">getIfdType</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a83"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$type">type</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a84"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a85"></a> </div></li>
<li><div class="src-line"><a name="a86"></a> </div></li>
<li><div class="src-line"><a name="a87"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a88"></a><span class="src-doc"> * Get the tag associated with the exception.</span></div></li>
<li><div class="src-line"><a name="a89"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a90"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">PelTag </span><span class="src-doc">the tag. If no tag is set, null is returned.</span></div></li>
<li><div class="src-line"><a name="a91"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a92"></a> <span class="src-key">function </span><a href="../PEL/Exception/PelEntryException.html#methodgetTag">getTag</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a93"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$tag">tag</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a94"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a95"></a> </div></li>
<li><div class="src-line"><a name="a96"></a><span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a97"></a> </div></li>
<li><div class="src-line"><a name="a98"></a> </div></li>
<li><div class="src-line"><a name="a99"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a100"></a><span class="src-doc"> * Exception indicating that an unexpected format was found.</span></div></li>
<li><div class="src-line"><a name="a101"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a102"></a><span class="src-doc"> * The documentation for each tag in </span><span class="src-doc-inlinetag">{@link PelTag}</span><span class="src-doc"> will detail any</span></div></li>
<li><div class="src-line"><a name="a103"></a><span class="src-doc"> * constrains.</span></div></li>
<li><div class="src-line"><a name="a104"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a105"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Martin Geisler <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a106"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PEL</span></div></li>
<li><div class="src-line"><a name="a107"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@subpackage</span><span class="src-doc"> Exception</span></div></li>
<li><div class="src-line"><a name="a108"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a109"></a><span class="src-key">class </span><a href="../PEL/Exception/PelUnexpectedFormatException.html">PelUnexpectedFormatException</a> <span class="src-key">extends </span><a href="../PEL/Exception/PelEntryException.html">PelEntryException</a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a110"></a> </div></li>
<li><div class="src-line"><a name="a111"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a112"></a><span class="src-doc"> * Construct a new exception indicating an invalid format.</span></div></li>
<li><div class="src-line"><a name="a113"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a114"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc">the type of IFD.</span></div></li>
<li><div class="src-line"><a name="a115"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a116"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PelTag </span><span class="src-doc">the tag for which the violation was found.</span></div></li>
<li><div class="src-line"><a name="a117"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a118"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PelFormat </span><span class="src-doc">the format found.</span></div></li>
<li><div class="src-line"><a name="a119"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a120"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PelFormat </span><span class="src-doc">the expected format.</span></div></li>
<li><div class="src-line"><a name="a121"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a122"></a> <span class="src-key">function </span><a href="../PEL/Exception/PelUnexpectedFormatException.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-var">$type</span><span class="src-sym">, </span><span class="src-var">$tag</span><span class="src-sym">, </span><span class="src-var">$found</span><span class="src-sym">, </span><span class="src-var">$expected</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a123"></a> <span class="src-id">parent</span><span class="src-sym">::</span><span class="src-id">__construct</span><span class="src-sym">(</span><span class="src-str">'Unexpected format found for %s tag: PelFormat::%s. ' </span>.</div></li>
<li><div class="src-line"><a name="a124"></a> <span class="src-str">'Expected PelFormat::%s instead.'</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a125"></a> <span class="src-id"><a href="../PEL/PelTag.html">PelTag</a></span><span class="src-sym">::</span><a href="../PEL/PelTag.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$type</span><span class="src-sym">, </span><span class="src-var">$tag</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a126"></a> <a href="http://www.php.net/strtoupper">strtoupper</a><span class="src-sym">(</span><span class="src-id"><a href="../PEL/PelFormat.html">PelFormat</a></span><span class="src-sym">::</span><a href="../PEL/PelFormat.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$found</span><span class="src-sym">))</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a127"></a> <a href="http://www.php.net/strtoupper">strtoupper</a><span class="src-sym">(</span><span class="src-id"><a href="../PEL/PelFormat.html">PelFormat</a></span><span class="src-sym">::</span><a href="../PEL/PelFormat.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$expected</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a128"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$tag">tag</a> = <span class="src-var">$tag</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a129"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$type">type</a> = <span class="src-var">$type</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a130"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a131"></a><span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a132"></a> </div></li>
<li><div class="src-line"><a name="a133"></a> </div></li>
<li><div class="src-line"><a name="a134"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a135"></a><span class="src-doc"> * Exception indicating that an unexpected number of components was</span></div></li>
<li><div class="src-line"><a name="a136"></a><span class="src-doc"> * found.</span></div></li>
<li><div class="src-line"><a name="a137"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a138"></a><span class="src-doc"> * Some tags have strict limits as to the allowed number of</span></div></li>
<li><div class="src-line"><a name="a139"></a><span class="src-doc"> * components, and this exception is thrown if the data violates such</span></div></li>
<li><div class="src-line"><a name="a140"></a><span class="src-doc"> * a constraint. The documentation for each tag in </span><span class="src-doc-inlinetag">{@link PelTag}</span></div></li>
<li><div class="src-line"><a name="a141"></a><span class="src-doc"> * explains the expected number of components.</span></div></li>
<li><div class="src-line"><a name="a142"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a143"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Martin Geisler <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a144"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PEL</span></div></li>
<li><div class="src-line"><a name="a145"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@subpackage</span><span class="src-doc"> Exception</span></div></li>
<li><div class="src-line"><a name="a146"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a147"></a><span class="src-key">class </span><a href="../PEL/Exception/PelWrongComponentCountException.html">PelWrongComponentCountException</a> <span class="src-key">extends </span><a href="../PEL/Exception/PelEntryException.html">PelEntryException</a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a148"></a> </div></li>
<li><div class="src-line"><a name="a149"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a150"></a><span class="src-doc"> * Construct a new exception indicating a wrong number of</span></div></li>
<li><div class="src-line"><a name="a151"></a><span class="src-doc"> * components.</span></div></li>
<li><div class="src-line"><a name="a152"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a153"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc">the type of IFD.</span></div></li>
<li><div class="src-line"><a name="a154"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a155"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PelTag </span><span class="src-doc">the tag for which the violation was found.</span></div></li>
<li><div class="src-line"><a name="a156"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a157"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc">the number of components found.</span></div></li>
<li><div class="src-line"><a name="a158"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a159"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc">the expected number of components.</span></div></li>
<li><div class="src-line"><a name="a160"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a161"></a> <span class="src-key">function </span><a href="../PEL/Exception/PelWrongComponentCountException.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-var">$type</span><span class="src-sym">, </span><span class="src-var">$tag</span><span class="src-sym">, </span><span class="src-var">$found</span><span class="src-sym">, </span><span class="src-var">$expected</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a162"></a> <span class="src-id">parent</span><span class="src-sym">::</span><span class="src-id">__construct</span><span class="src-sym">(</span><span class="src-str">'Wrong number of components found for %s tag: %d. ' </span>.</div></li>
<li><div class="src-line"><a name="a163"></a> <span class="src-str">'Expected %d.'</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a164"></a> <span class="src-id"><a href="../PEL/PelTag.html">PelTag</a></span><span class="src-sym">::</span><a href="../PEL/PelTag.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$type</span><span class="src-sym">, </span><span class="src-var">$tag</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$found</span><span class="src-sym">, </span><span class="src-var">$expected</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a165"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$tag">tag</a> = <span class="src-var">$tag</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a166"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/Exception/PelEntryException.html#var$type">type</a> = <span class="src-var">$type</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a167"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a168"></a><span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a169"></a> </div></li>
<li><div class="src-line"><a name="a170"></a> </div></li>
<li><div class="src-line"><a name="a171"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a172"></a><span class="src-doc"> * Common ancestor class of all </span><span class="src-doc-inlinetag">{@link PelIfd}</span><span class="src-doc"> entries.</span></div></li>
<li><div class="src-line"><a name="a173"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a174"></a><span class="src-doc"> * As this class is abstract you cannot instantiate objects from it.</span></div></li>
<li><div class="src-line"><a name="a175"></a><span class="src-doc"> * It only serves as a common ancestor to define the methods common to</span></div></li>
<li><div class="src-line"><a name="a176"></a><span class="src-doc"> * all entries. The most important methods are </span><span class="src-doc-inlinetag">{@link getValue()}</span><span class="src-doc"> and</span></div></li>
<li><div class="src-line"><a name="a177"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link setValue()}</span><span class="src-doc">, both of which is abstract in this class. The</span></div></li>
<li><div class="src-line"><a name="a178"></a><span class="src-doc"> * descendants will give concrete implementations for them.</span></div></li>
<li><div class="src-line"><a name="a179"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a180"></a><span class="src-doc"> * If you have some data coming from an image (some raw bytes), then</span></div></li>
<li><div class="src-line"><a name="a181"></a><span class="src-doc"> * the static method </span><span class="src-doc-inlinetag">{@link newFromData()}</span><span class="src-doc"> is helpful --- it will look</span></div></li>
<li><div class="src-line"><a name="a182"></a><span class="src-doc"> * at the data and give you a proper decendent of </span><span class="src-doc-inlinetag">{@link PelEntry}</span></div></li>
<li><div class="src-line"><a name="a183"></a><span class="src-doc"> * back.</span></div></li>
<li><div class="src-line"><a name="a184"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a185"></a><span class="src-doc"> * If you instead want to have an entry for some data which take the</span></div></li>
<li><div class="src-line"><a name="a186"></a><span class="src-doc"> * form of an integer, a string, a byte, or some other PHP type, then</span></div></li>
<li><div class="src-line"><a name="a187"></a><span class="src-doc"> * don't use this class. You should instead create an object of the</span></div></li>
<li><div class="src-line"><a name="a188"></a><span class="src-doc"> * right subclass (</span><span class="src-doc-inlinetag">{@link PelEntryShort}</span><span class="src-doc"> for short integers, </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a189"></a><span class="src-doc"> * PelEntryAscii} for strings, and so on) directly.</span></div></li>
<li><div class="src-line"><a name="a190"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a191"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Martin Geisler <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a192"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PEL</span></div></li>
<li><div class="src-line"><a name="a193"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a194"></a><span class="src-key">abstract </span><span class="src-key">class </span><a href="../PEL/PelEntry.html">PelEntry</a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a195"></a> </div></li>
<li><div class="src-line"><a name="a196"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a197"></a><span class="src-doc"> * Type of IFD containing this tag.</span></div></li>
<li><div class="src-line"><a name="a198"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a199"></a><span class="src-doc"> * This must be one of the constants defined in </span><span class="src-doc-inlinetag">{@link PelIfd}</span><span class="src-doc">:</span></div></li>
<li><div class="src-line"><a name="a200"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link PelIfd::IFD0}</span><span class="src-doc"> for the main image IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::IFD1}</span></div></li>
<li><div class="src-line"><a name="a201"></a><span class="src-doc"> * for the thumbnail image IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::EXIF}</span><span class="src-doc"> for the Exif</span></div></li>
<li><div class="src-line"><a name="a202"></a><span class="src-doc"> * sub-IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::GPS}</span><span class="src-doc"> for the GPS sub-IFD, or </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a203"></a><span class="src-doc"> * PelIfd::INTEROPERABILITY} for the interoperability sub-IFD.</span></div></li>
<li><div class="src-line"><a name="a204"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a205"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">int </span></div></li>
<li><div class="src-line"><a name="a206"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a207"></a> <span class="src-key">protected </span><a href="../PEL/PelEntry.html#var$ifd_type">$ifd_type</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a208"></a> </div></li>
<li><div class="src-line"><a name="a209"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a210"></a><span class="src-doc"> * The bytes representing this entry.</span></div></li>
<li><div class="src-line"><a name="a211"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a212"></a><span class="src-doc"> * Subclasses must either override </span><span class="src-doc-inlinetag">{@link getBytes()}</span><span class="src-doc"> or, if</span></div></li>
<li><div class="src-line"><a name="a213"></a><span class="src-doc"> * possible, maintain this property so that it always contains a</span></div></li>
<li><div class="src-line"><a name="a214"></a><span class="src-doc"> * true representation of the entry.</span></div></li>
<li><div class="src-line"><a name="a215"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a216"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a217"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a218"></a> <span class="src-key">protected </span><a href="../PEL/PelEntry.html#var$bytes">$bytes</a> = <span class="src-str">''</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a219"></a> </div></li>
<li><div class="src-line"><a name="a220"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a221"></a><span class="src-doc"> * The </span><span class="src-doc-inlinetag">{@link PelTag}</span><span class="src-doc"> of this entry.</span></div></li>
<li><div class="src-line"><a name="a222"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a223"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">PelTag </span></div></li>
<li><div class="src-line"><a name="a224"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a225"></a> <span class="src-key">protected </span><a href="../PEL/PelEntry.html#var$tag">$tag</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a226"></a> </div></li>
<li><div class="src-line"><a name="a227"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a228"></a><span class="src-doc"> * The </span><span class="src-doc-inlinetag">{@link PelFormat}</span><span class="src-doc"> of this entry.</span></div></li>
<li><div class="src-line"><a name="a229"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a230"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">PelFormat </span></div></li>
<li><div class="src-line"><a name="a231"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a232"></a> <span class="src-key">protected </span><a href="../PEL/PelEntry.html#var$format">$format</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a233"></a> </div></li>
<li><div class="src-line"><a name="a234"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a235"></a><span class="src-doc"> * The number of components of this entry.</span></div></li>
<li><div class="src-line"><a name="a236"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a237"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">int </span></div></li>
<li><div class="src-line"><a name="a238"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a239"></a> <span class="src-key">protected </span><a href="../PEL/PelEntry.html#var$components">$components</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a240"></a> </div></li>
<li><div class="src-line"><a name="a241"></a> </div></li>
<li><div class="src-line"><a name="a242"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a243"></a><span class="src-doc"> * Return the tag of this entry.</span></div></li>
<li><div class="src-line"><a name="a244"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a245"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">PelTag </span><span class="src-doc">the tag of this entry.</span></div></li>
<li><div class="src-line"><a name="a246"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a247"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetTag">getTag</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a248"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$tag">tag</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a249"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a250"></a> </div></li>
<li><div class="src-line"><a name="a251"></a> </div></li>
<li><div class="src-line"><a name="a252"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a253"></a><span class="src-doc"> * Return the type of IFD which holds this entry.</span></div></li>
<li><div class="src-line"><a name="a254"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a255"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">int </span><span class="src-doc">one of the constants defined in </span><span class="src-doc-inlinetag">{@link PelIfd}</span><span class="src-doc">:</span></div></li>
<li><div class="src-line"><a name="a256"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link PelIfd::IFD0}</span><span class="src-doc"> for the main image IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::IFD1}</span></div></li>
<li><div class="src-line"><a name="a257"></a><span class="src-doc"> * for the thumbnail image IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::EXIF}</span><span class="src-doc"> for the Exif</span></div></li>
<li><div class="src-line"><a name="a258"></a><span class="src-doc"> * sub-IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::GPS}</span><span class="src-doc"> for the GPS sub-IFD, or </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a259"></a><span class="src-doc"> * PelIfd::INTEROPERABILITY} for the interoperability sub-IFD.</span></div></li>
<li><div class="src-line"><a name="a260"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a261"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetIfdType">getIfdType</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a262"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$ifd_type">ifd_type</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a263"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a264"></a> </div></li>
<li><div class="src-line"><a name="a265"></a> </div></li>
<li><div class="src-line"><a name="a266"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a267"></a><span class="src-doc"> * Update the IFD type.</span></div></li>
<li><div class="src-line"><a name="a268"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a269"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc">must be one of the constants defined in </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a270"></a><span class="src-doc"> * PelIfd}: </span><span class="src-doc-inlinetag">{@link PelIfd::IFD0}</span><span class="src-doc"> for the main image IFD, </span><span class="src-doc-inlinetag">{@link }</span></div></li>
<li><div class="src-line"><a name="a271"></a><span class="src-doc"> * PelIfd::IFD1} for the thumbnail image IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::EXIF}</span></div></li>
<li><div class="src-line"><a name="a272"></a><span class="src-doc"> * for the Exif sub-IFD, </span><span class="src-doc-inlinetag">{@link PelIfd::GPS}</span><span class="src-doc"> for the GPS sub-IFD, or</span></div></li>
<li><div class="src-line"><a name="a273"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link PelIfd::INTEROPERABILITY}</span><span class="src-doc"> for the interoperability</span></div></li>
<li><div class="src-line"><a name="a274"></a><span class="src-doc"> * sub-IFD.</span></div></li>
<li><div class="src-line"><a name="a275"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a276"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodsetIfdType">setIfdType</a><span class="src-sym">(</span><span class="src-var">$type</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a277"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$ifd_type">ifd_type</a> = <span class="src-var">$type</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a278"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a279"></a> </div></li>
<li><div class="src-line"><a name="a280"></a> </div></li>
<li><div class="src-line"><a name="a281"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a282"></a><span class="src-doc"> * Return the format of this entry.</span></div></li>
<li><div class="src-line"><a name="a283"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a284"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">PelFormat </span><span class="src-doc">the format of this entry.</span></div></li>
<li><div class="src-line"><a name="a285"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a286"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetFormat">getFormat</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a287"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$format">format</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a288"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a289"></a> </div></li>
<li><div class="src-line"><a name="a290"></a> </div></li>
<li><div class="src-line"><a name="a291"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a292"></a><span class="src-doc"> * Return the number of components of this entry.</span></div></li>
<li><div class="src-line"><a name="a293"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a294"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">int </span><span class="src-doc">the number of components of this entry.</span></div></li>
<li><div class="src-line"><a name="a295"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a296"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetComponents">getComponents</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a297"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$components">components</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a298"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a299"></a> </div></li>
<li><div class="src-line"><a name="a300"></a> </div></li>
<li><div class="src-line"><a name="a301"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a302"></a><span class="src-doc"> * Turn this entry into bytes.</span></div></li>
<li><div class="src-line"><a name="a303"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a304"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PelByteOrder </span><span class="src-doc">the desired byte order, which must be either</span></div></li>
<li><div class="src-line"><a name="a305"></a><span class="src-doc"> * </span><span class="src-doc-inlinetag">{@link Convert::LITTLE_ENDIAN}</span><span class="src-doc"> or </span><span class="src-doc-inlinetag">{@link Convert::BIG_ENDIAN}</span><span class="src-doc">.</span></div></li>
<li><div class="src-line"><a name="a306"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a307"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span><span class="src-doc">bytes representing this entry.</span></div></li>
<li><div class="src-line"><a name="a308"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a309"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetBytes">getBytes</a><span class="src-sym">(</span><span class="src-var">$o</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a310"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$bytes">bytes</a><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a311"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a312"></a> </div></li>
<li><div class="src-line"><a name="a313"></a> </div></li>
<li><div class="src-line"><a name="a314"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a315"></a><span class="src-doc"> * Get the value of this entry as text.</span></div></li>
<li><div class="src-line"><a name="a316"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a317"></a><span class="src-doc"> * The value will be returned in a format suitable for presentation,</span></div></li>
<li><div class="src-line"><a name="a318"></a><span class="src-doc"> * e.g., rationals will be returned as 'x/y', ASCII strings will be</span></div></li>
<li><div class="src-line"><a name="a319"></a><span class="src-doc"> * returned as themselves etc.</span></div></li>
<li><div class="src-line"><a name="a320"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a321"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">boolean </span><span class="src-doc">some values can be returned in a long or more</span></div></li>
<li><div class="src-line"><a name="a322"></a><span class="src-doc"> * brief form, and this parameter controls that.</span></div></li>
<li><div class="src-line"><a name="a323"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a324"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span><span class="src-doc">the value as text.</span></div></li>
<li><div class="src-line"><a name="a325"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a326"></a> <span class="src-key">abstract </span><span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetText">getText</a><span class="src-sym">(</span><span class="src-var">$brief </span>= <span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a327"></a> </div></li>
<li><div class="src-line"><a name="a328"></a> </div></li>
<li><div class="src-line"><a name="a329"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a330"></a><span class="src-doc"> * Get the value of this entry.</span></div></li>
<li><div class="src-line"><a name="a331"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a332"></a><span class="src-doc"> * The value returned will generally be the same as the one supplied</span></div></li>
<li><div class="src-line"><a name="a333"></a><span class="src-doc"> * to the constructor or with </span><span class="src-doc-inlinetag">{@link setValue()}</span><span class="src-doc">. For a formatted</span></div></li>
<li><div class="src-line"><a name="a334"></a><span class="src-doc"> * version of the value, one should use </span><span class="src-doc-inlinetag">{@link getText()}</span><span class="src-doc"> instead.</span></div></li>
<li><div class="src-line"><a name="a335"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a336"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">mixed </span><span class="src-doc">the unformatted value.</span></div></li>
<li><div class="src-line"><a name="a337"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a338"></a> <span class="src-key">abstract </span><span class="src-key">function </span><a href="../PEL/PelEntry.html#methodgetValue">getValue</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a339"></a> </div></li>
<li><div class="src-line"><a name="a340"></a> </div></li>
<li><div class="src-line"><a name="a341"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a342"></a><span class="src-doc"> * Set the value of this entry.</span></div></li>
<li><div class="src-line"><a name="a343"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a344"></a><span class="src-doc"> * The value should be in the same format as for the constructor.</span></div></li>
<li><div class="src-line"><a name="a345"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a346"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">mixed </span><span class="src-doc">the new value.</span></div></li>
<li><div class="src-line"><a name="a347"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a348"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@abstract</span></div></li>
<li><div class="src-line"><a name="a349"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a350"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#methodsetValue">setValue</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a351"></a> <span class="src-comm">/* This (fake) abstract method is here to make it possible for the</span></div></li>
<li><div class="src-line"><a name="a352"></a><span class="src-comm"> * documentation to refer to PelEntry::setValue().</span></div></li>
<li><div class="src-line"><a name="a353"></a><span class="src-comm"> *</span></div></li>
<li><div class="src-line"><a name="a354"></a><span class="src-comm"> * It cannot declared abstract in the proper PHP way, for then PHP</span></div></li>
<li><div class="src-line"><a name="a355"></a><span class="src-comm"> * wont allow subclasses to define it with two arguments (which is</span></div></li>
<li><div class="src-line"><a name="a356"></a><span class="src-comm"> * what PelEntryCopyright does).</span></div></li>
<li><div class="src-line"><a name="a357"></a><span class="src-comm"> */</span></div></li>
<li><div class="src-line"><a name="a358"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../PEL/Exception/PelException.html">PelException</a></span><span class="src-sym">(</span><span class="src-str">'setValue() is abstract.'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a359"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a360"></a> </div></li>
<li><div class="src-line"><a name="a361"></a> </div></li>
<li><div class="src-line"><a name="a362"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a363"></a><span class="src-doc"> * Turn this entry into a string.</span></div></li>
<li><div class="src-line"><a name="a364"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a365"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span><span class="src-doc">a string representation of this entry. This is</span></div></li>
<li><div class="src-line"><a name="a366"></a><span class="src-doc"> * mostly for debugging.</span></div></li>
<li><div class="src-line"><a name="a367"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a368"></a> <span class="src-key">function </span><a href="../PEL/PelEntry.html#method__toString">__toString</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a369"></a> <span class="src-var">$str </span>= <span class="src-id"><a href="../PEL/Pel.html">Pel</a></span><span class="src-sym">::</span><a href="../PEL/Pel.html#methodfmt">fmt</a><span class="src-sym">(</span><span class="src-str">" Tag: 0x%04X (%s)\n"</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a370"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$tag">tag</a><span class="src-sym">, </span><span class="src-id"><a href="../PEL/PelTag.html">PelTag</a></span><span class="src-sym">::</span><a href="../PEL/PelTag.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$ifd_type">ifd_type</a><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$tag">tag</a><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a371"></a> <span class="src-var">$str </span>.= <span class="src-id"><a href="../PEL/Pel.html">Pel</a></span><span class="src-sym">::</span><a href="../PEL/Pel.html#methodfmt">fmt</a><span class="src-sym">(</span><span class="src-str">" Format : %d (%s)\n"</span><span class="src-sym">,</span></div></li>
<li><div class="src-line"><a name="a372"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$format">format</a><span class="src-sym">, </span><span class="src-id"><a href="../PEL/PelFormat.html">PelFormat</a></span><span class="src-sym">::</span><a href="../PEL/PelFormat.html#methodgetName">getName</a><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$format">format</a><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a373"></a> <span class="src-var">$str </span>.= <span class="src-id"><a href="../PEL/Pel.html">Pel</a></span><span class="src-sym">::</span><a href="../PEL/Pel.html#methodfmt">fmt</a><span class="src-sym">(</span><span class="src-str">" Components: %d\n"</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#var$components">components</a><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a374"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#methodgetTag">getTag</a><span class="src-sym">(</span><span class="src-sym">) </span>!= <span class="src-id"><a href="../PEL/PelTag.html">PelTag</a></span><span class="src-sym">::</span><span class="src-id">MAKER_NOTE </span>&&</div></li>
<li><div class="src-line"><a name="a375"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#methodgetTag">getTag</a><span class="src-sym">(</span><span class="src-sym">) </span>!= <span class="src-id"><a href="../PEL/PelTag.html">PelTag</a></span><span class="src-sym">::</span><span class="src-id">PRINT_IM</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a376"></a> <span class="src-var">$str </span>.= <span class="src-id"><a href="../PEL/Pel.html">Pel</a></span><span class="src-sym">::</span><a href="../PEL/Pel.html#methodfmt">fmt</a><span class="src-sym">(</span><span class="src-str">" Value : %s\n"</span><span class="src-sym">, </span><a href="http://www.php.net/print_r">print_r</a><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#methodgetValue">getValue</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-id">true</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a377"></a> <span class="src-var">$str </span>.= <span class="src-id"><a href="../PEL/Pel.html">Pel</a></span><span class="src-sym">::</span><a href="../PEL/Pel.html#methodfmt">fmt</a><span class="src-sym">(</span><span class="src-str">" Text : %s\n"</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PEL/PelEntry.html#methodgetText">getText</a><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a378"></a> <span class="src-key">return </span><span class="src-var">$str</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a379"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a380"></a><span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a381"></a> </div></li>
<li><div class="src-line"><a name="a382"></a><span class="src-php">?></span></div></li>
</ol></div>
</div>
<p class="notes" id="credit">
Documentation generated on Tue, 19 Dec 2006 01:08:17 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.0</a>
<a target="_top" href="http://sourceforge.net/"><img src="http://sourceforge.net/sflogo.php?group_id=108380&type=1" width="88" height="31" border="0" align="right" alt="SourceForge.net Logo" /></a>
</p>
</body>
</html>