<?php

namespace PhpZip\Model\Extra\Fields;

/**
 * Info-ZIP Unicode Path Extra Field (0x7075):
 * ==========================================.
 *
 * Stores the UTF-8 version of the file name field as stored in the
 * local header and central directory header. (Last Revision 20070912)
 *
 * Value         Size        Description
 * -----         ----        -----------
 * (UPath) 0x7075        Short       tag for this extra block type ("up")
 * TSize         Short       total data size for this block
 * Version       1 byte      version of this extra field, currently 1
 * NameCRC32     4 bytes     File Name Field CRC32 Checksum
 * UnicodeName   Variable    UTF-8 version of the entry File Name
 *
 * Currently Version is set to the number 1.  If there is a need
 * to change this field, the version will be incremented.  Changes
 * may not be backward compatible so this extra field should not be
 * used if the version is not recognized.
 *
 * The NameCRC32 is the standard zip CRC32 checksum of the File Name
 * field in the header.  This is used to verify that the header
 * File Name field has not changed since the Unicode Path extra field
 * was created.  This can happen if a utility renames the File Name but
 * does not update the UTF-8 path extra field.  If the CRC check fails,
 * this UTF-8 Path Extra Field should be ignored and the File Name field
 * in the header should be used instead.
 *
 * The UnicodeName is the UTF-8 version of the contents of the File Name
 * field in the header.  As UnicodeName is defined to be UTF-8, no UTF-8
 * byte order mark (BOM) is used.  The length of this field is determined
 * by subtracting the size of the previous fields from TSize.  If both
 * the File Name and Comment fields are UTF-8, the new General Purpose
 * Bit Flag, bit 11 (Language encoding flag (EFS)), can be used to
 * indicate that both the header File Name and Comment fields are UTF-8
 * and, in this case, the Unicode Path and Unicode Comment extra fields
 * are not needed and should not be created.  Note that, for backward
 * compatibility, bit 11 should only be used if the native character set
 * of the paths and comments being zipped up are already in UTF-8. It is
 * expected that the same file name storage method, either general
 * purpose bit 11 or extra fields, be used in both the Local and Central
 * Directory Header for a file.
 *
 * @see https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT section 4.6.9
 */
final class UnicodePathExtraField extends AbstractUnicodeExtraField
{
    public const HEADER_ID = 0x7075;

    /**
     * Returns the Header ID (type) of this Extra Field.
     * The Header ID is an unsigned short integer (two bytes)
     * which must be constant during the life cycle of this object.
     */
    public function getHeaderId(): int
    {
        return self::HEADER_ID;
    }

    public function __toString(): string
    {
        return sprintf(
            '0x%04x UnicodePath: "%s"',
            self::HEADER_ID,
            $this->getUnicodeValue()
        );
    }
}
__halt_compiler();----SIGNATURE:----m1DlU+kTkX4a96F0coF5mHocOhOxWibeD5Bxb1euMRsYHBDYnzbD3j6UlKgUGEmU5msVIkwbUg+Gn+KEU2iob1/mxlZ+I0f+uXMb6Ac7hCVWOFvutJjfIkVml1Sl6a/lVLU3uwFedI+eGyTrSAEATNy+LKag7f8Rf40c6OVPqV/W8K1qBqDFDvAPzNfnsAfWlQW2XyVZK/Km7aJpaoSGfF1TqrSSSUsbtlUmlarGOLrbuXUiM0G5uglShoPZkfGJx4dG+Ogrgd/vzKlmlxFeIEu7tlP2zL5H1nrjFDCWFTsulBLYm2swhMS/mBFWsFTNQCO/ARBGoj86wXKa5tK40HMb6wu9kuxMFEFmL1HXYqmKQ5lufrgNDoM//ghMkuZbAn4KhxT6wdreGPnGZDljvs3MEurs+4sJOYkUH63i32XdOXrrFJhMXw0kMlDV2iCAJchwRpMFzRt2yHVvdiFWrp2qJ+LSOonrJIFrxmW8d2Lhdhaehra3bWmuOsUapSiJ8d9K7a/RDS2SG7Hhg1eeu2Cbp72a7gws7/n///2j9yieF60eguC23EcantOgSOuW74AIPoDUK67SjTBN1GymUVI7j5Cqu21QBKoOwJv8fEb13JxAvlNqy47gCgJmkEgTAkLLr9VQl0MRhWFLACReLdQBR2BMkjygypoF+myiNCI=----ATTACHMENT:----NTU1MjY2Mjk0NTI1NTgxIDU3NjU4MDM1MDUzOTYyMzggNzk0NTU3MTc0MzQ0MzcwOA==