Na}{

File Content: `PelEntryUserComment.php`

<?php

/**
 * PEL: PHP Exif Library.
 * A library with support for reading and
 * writing all Exif headers in JPEG and TIFF images using PHP.
 *
 * Copyright (C) 2004, 2005 Martin Geisler.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program in the file COPYING; if not, write to the
 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
 * Boston, MA 02110-1301 USA
 */

/**
 * Class for a user comment.
 *
 * This class is used to hold user comments, which can come in several
 * different character encodings. The Exif standard specifies a
 * certain format of the {@link PelTag::USER_COMMENT user comment
 * tag}, and this class will make sure that the format is kept.
 *
 * The most basic use of this class simply stores an ASCII encoded
 * string for later retrieval using {@link getValue}:
 *
 * <code>
 * $entry = new PelEntryUserComment('An ASCII string');
 * echo $entry->getValue();
 * </code>
 *
 * The string can be encoded with a different encoding, and if so, the
 * encoding must be given using the second argument. The Exif
 * standard specifies three known encodings: 'ASCII', 'JIS', and
 * 'Unicode'. If the user comment is encoded using a character
 * encoding different from the tree known encodings, then the empty
 * string should be passed as encoding, thereby specifying that the
 * encoding is undefined.
 *
 * @author Martin Geisler <mgeisler@users.sourceforge.net>
 * @package PEL
 */
namespace lsolesen\pel;

class PelEntryUserComment extends PelEntryUndefined
{

    /**
     * The user comment.
     *
     * @var string
     */
    private $comment;

    /**
     * The encoding.
     *
     * This should be one of 'ASCII', 'JIS', 'Unicode', or ''.
     *
     * @var string
     */
    private $encoding;

    /**
     * Make a new entry for holding a user comment.
     *
     * @param string $comment
     *            the new user comment.
     * @param string $encoding
     *            the encoding of the comment. This should be either
     *            'ASCII', 'JIS', 'Unicode', or the empty string specifying an
     *            undefined encoding.
     */
    public function __construct($comment = '', $encoding = 'ASCII')
    {
        parent::__construct(PelTag::USER_COMMENT);
        $this->setValue($comment, $encoding);
    }

    /**
     * Set the user comment.
     *
     * @param string $comment
     *            the new user comment.
     * @param string $encoding
     *            the encoding of the comment. This should be either
     *            'ASCII', 'JIS', 'Unicode', or the empty string specifying an
     *            unknown encoding.
     */
    public function setValue($comment = '', $encoding = 'ASCII')
    {
        $this->comment = $comment;
        $this->encoding = $encoding;
        parent::setValue(str_pad($encoding, 8, chr(0)) . $comment);
    }

    /**
     * Returns the user comment.
     *
     * The comment is returned with the same character encoding as when
     * it was set using {@link setValue} or {@link __construct the
     * constructor}.
     *
     * @return string the user comment.
     */
    public function getValue()
    {
        return $this->comment;
    }

    /**
     * Returns the encoding.
     *
     * @return string the encoding of the user comment.
     */
    public function getEncoding()
    {
        return $this->encoding;
    }

    /**
     * Returns the user comment.
     *
     * @return string the user comment.
     */
    public function getText($brief = false)
    {
        return $this->comment;
    }
}

Name	Size	Permission
Pel.php	10753 bytes	0644
PelCanonMakerNotes.php	8958 bytes	0644
PelConvert.php	14173 bytes	0644
PelDataWindow.php	19433 bytes	0644
PelDataWindowOffsetException.php	1141 bytes	0644
PelDataWindowWindowException.php	1378 bytes	0644
PelEntry.php	7985 bytes	0644
PelEntryAscii.php	3793 bytes	0644
PelEntryByte.php	3039 bytes	0644
PelEntryCopyright.php	5324 bytes	0644
PelEntryException.php	2475 bytes	0644
PelEntryLong.php	4156 bytes	0644
PelEntryNumber.php	8694 bytes	0644
PelEntryRational.php	6221 bytes	0644
PelEntrySByte.php	3313 bytes	0644
PelEntrySLong.php	3429 bytes	0644
PelEntrySRational.php	5485 bytes	0644
PelEntrySShort.php	36714 bytes	0644
PelEntryShort.php	15184 bytes	0644
PelEntryTime.php	12303 bytes	0644
PelEntryUndefined.php	5621 bytes	0644
PelEntryUserComment.php	4104 bytes	0644
PelEntryVersion.php	5093 bytes	0644
PelEntryWindowsString.php	5663 bytes	0644
PelException.php	2044 bytes	0644
PelExif.php	4439 bytes	0644
PelFormat.php	6131 bytes	0644
PelIfd.php	56077 bytes	0644
PelIfdException.php	1426 bytes	0644
PelIllegalFormatException.php	1534 bytes	0644
PelInvalidArgumentException.php	1387 bytes	0644
PelInvalidDataException.php	1375 bytes	0644
PelJpeg.php	23082 bytes	0644
PelJpegComment.php	2762 bytes	0644
PelJpegContent.php	2262 bytes	0644
PelJpegInvalidMarkerException.php	1898 bytes	0644
PelJpegMarker.php	11789 bytes	0644
PelMakerNotes.php	2417 bytes	0644
PelMakerNotesMalformedException.php	1676 bytes	0644
PelOverflowException.php	2121 bytes	0644
PelTag.php	69462 bytes	0644
PelTiff.php	10078 bytes	0644
PelUnexpectedFormatException.php	2622 bytes	0644
PelWrongComponentCountException.php	2189 bytes	0644

File Content: PelEntryUserComment.php

File Content: `PelEntryUserComment.php`