Proyectos de Subversion Moodle

Rev

| Ultima modificación | Ver Log |

Rev Autor Línea Nro. Línea
1441 ariadna 1 
<?php
2 
 
3 
/**
4 
 * This file is part of FPDI
5 
 *
6 
 * @package   setasign\Fpdi
7 
 * @copyright Copyright (c) 2024 Setasign GmbH & Co. KG (https://www.setasign.com)
8 
 * @license   http://opensource.org/licenses/mit-license The MIT License
9 
 */
10 
 
11 
namespace setasign\Fpdi\PdfParser\Type;
12 
 
13 
use setasign\Fpdi\PdfParser\PdfParser;
14 
use setasign\Fpdi\PdfParser\StreamReader;
15 
use setasign\Fpdi\PdfParser\Tokenizer;
16 
 
17 
/**
18 
 * Class representing a PDF dictionary object
19 
 */
20 
class PdfDictionary extends PdfType
21 
{
22 
    /**
23 
     * Parses a dictionary of the passed tokenizer, stream-reader and parser.
24 
     *
25 
     * @param Tokenizer $tokenizer
26 
     * @param StreamReader $streamReader
27 
     * @param PdfParser $parser
28 
     * @return bool|self
29 
     * @throws PdfTypeException
30 
     */
31 
    public static function parse(Tokenizer $tokenizer, StreamReader $streamReader, PdfParser $parser)
32 
    {
33 
        $entries = [];
34 
 
35 
        while (true) {
36 
            $token = $tokenizer->getNextToken();
37 
            if ($token === '>' && $streamReader->getByte() === '>') {
38 
                $streamReader->addOffset(1);
39 
                break;
40 
            }
41 
 
42 
            $key = $parser->readValue($token);
43 
            if ($key === false) {
44 
                return false;
45 
            }
46 
 
47 
            // ensure the first value to be a Name object
48 
            if (!($key instanceof PdfName)) {
49 
                $lastToken = null;
50 
                // ignore all other entries and search for the closing brackets
51 
                while (($token = $tokenizer->getNextToken()) !== '>' || $lastToken !== '>') {
52 
                    if ($token === false) {
53 
                        return false;
54 
                    }
55 
                    $lastToken = $token;
56 
                }
57 
 
58 
                break;
59 
            }
60 
 
61 
 
62 
            $value = $parser->readValue();
63 
            if ($value === false) {
64 
                return false;
65 
            }
66 
 
67 
            if ($value instanceof PdfNull) {
68 
                continue;
69 
            }
70 
 
71 
            // catch missing value
72 
            if ($value instanceof PdfToken && $value->value === '>' && $streamReader->getByte() === '>') {
73 
                $streamReader->addOffset(1);
74 
                break;
75 
            }
76 
 
77 
            $entries[$key->value] = $value;
78 
        }
79 
 
80 
        $v = new self();
81 
        $v->value = $entries;
82 
 
83 
        return $v;
84 
    }
85 
 
86 
    /**
87 
     * Helper method to create an instance.
88 
     *
89 
     * @param PdfType[] $entries The keys are the name entries of the dictionary.
90 
     * @return self
91 
     */
92 
    public static function create(array $entries = [])
93 
    {
94 
        $v = new self();
95 
        $v->value = $entries;
96 
 
97 
        return $v;
98 
    }
99 
 
100 
    /**
101 
     * Get a value by its key from a dictionary or a default value.
102 
     *
103 
     * @param mixed $dictionary
104 
     * @param string $key
105 
     * @param PdfType|null $default
106 
     * @return PdfNull|PdfType
107 
     * @throws PdfTypeException
108 
     */
109 
    public static function get($dictionary, $key, ?PdfType $default = null)
110 
    {
111 
        $dictionary = self::ensure($dictionary);
112 
 
113 
        if (isset($dictionary->value[$key])) {
114 
            return $dictionary->value[$key];
115 
        }
116 
 
117 
        return $default ?? new PdfNull();
118 
    }
119 
 
120 
    /**
121 
     * Ensures that the passed value is a PdfDictionary instance.
122 
     *
123 
     * @param mixed $dictionary
124 
     * @return self
125 
     * @throws PdfTypeException
126 
     */
127 
    public static function ensure($dictionary)
128 
    {
129 
        return PdfType::ensureType(self::class, $dictionary, 'Dictionary value expected.');
130 
    }
131 
}