Cursor::match() - Code Metrics - Inspection of "Merge pull request #305 from thephpleague/cursor-o..." - thephpleague/commonmark - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 181260...afd04b )

by Colin

created 2017-12-30 17:51 UTC

Cursor::match() B

↳ Parent: Cursor

Complexity

Conditions	3
Paths	3

Size

Total Lines	25
Code Lines	11

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	11
CRAP Score	3

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
c	1
b	0
f	0
dl	0
loc	25
ccs	11
cts	11
cp	1
rs	8.8571
cc	3
eloc	11
nc	3
nop	1
crap	3

<?php

/*
 * This file is part of the league/commonmark package.
 *
 * (c) Colin O'Dell <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace League\CommonMark;

class Cursor
{
    const INDENT_LEVEL = 4;

    /**
     * @var string
     */
    private $line;

    /**
     * @var int
     */
    private $length;

    /**
     * @var int
     *
     * It's possible for this to be 1 char past the end, meaning we've parsed all chars and have
     * reached the end.  In this state, any character-returning method MUST return null.
     */
    private $currentPosition = 0;

    /**
     * @var int
     */
    private $column = 0;

    /**
     * @var int
     */
    private $indent = 0;

    /**
     * @var int
     */
    private $previousPosition = 0;

    /**
     * @var int|null
     */
    private $nextNonSpaceCache;

    /**
     * @var bool
     */
    private $partiallyConsumedTab = false;

    /**
     * @var string
     */
    private $encoding;

    /**
     * @var bool
     */
    private $lineContainsTabs;

    /**
     * @var bool
     */
    private $isMultibyte;

    /**
     * @param string $line
     */
    public function __construct($line)
    {
        $this->line = $line;
        $this->encoding = mb_detect_encoding($line, 'ASCII,UTF-8', true) ?: 'ISO-8859-1';
        $this->length = mb_strlen($line, $this->encoding);
        $this->isMultibyte = $this->length !== strlen($line);
        $this->lineContainsTabs = preg_match('/\t/', $line) > 0;
    }

    /**
     * Returns the position of the next character which is not a space (or tab)
     *
     * @deprecated Use getNextNonSpacePosition() instead
     *
     * @return int
     */
    public function getFirstNonSpacePosition()
    {
        @trigger_error('Cursor::getFirstNonSpacePosition() will be removed in a future 0.x release.  Use getNextNonSpacePosition() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
// For example instead of
@mkdir($dir);

// Better use
if (@mkdir($dir) === false) {
    throw new \RuntimeException('The directory '.$dir.' could not be created.');
}

        return $this->getNextNonSpacePosition();
    }

    /**
     * Returns the position of the next character which is not a space (or tab)
     *
     * @return int
     */
    public function getNextNonSpacePosition()
    {
        if ($this->nextNonSpaceCache !== null) {
            return $this->nextNonSpaceCache;
        }

        $i = $this->currentPosition;
        $cols = $this->column;

        while (($c = $this->getCharacter($i)) !== null) {
            if ($c === ' ') {
                $i++;
                $cols++;
            } elseif ($c === "\t") {
                $i++;
                $cols += (4 - ($cols % 4));
            } else {
                break;
            }
        }

        $nextNonSpace = ($c === null) ? $this->length : $i;
        $this->indent = $cols - $this->column;

        return $this->nextNonSpaceCache = $nextNonSpace;
    }

    /**
     * Returns the next character which isn't a space (or tab)
     *
     * @deprecated Use getNextNonSpaceCharacter() instead
     *
     * @return string
     */
    public function getFirstNonSpaceCharacter()
    {
        @trigger_error('Cursor::getFirstNonSpaceCharacter() will be removed in a future 0.x release.  Use getNextNonSpaceCharacter() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
// For example instead of
@mkdir($dir);

// Better use
if (@mkdir($dir) === false) {
    throw new \RuntimeException('The directory '.$dir.' could not be created.');
}

        return $this->getNextNonSpaceCharacter();
    }

    /**
     * Returns the next character which isn't a space (or tab)
     *
     * @return string
     */
    public function getNextNonSpaceCharacter()
    {
        return $this->getCharacter($this->getNextNonSpacePosition());
    }

    /**
     * Calculates the current indent (number of spaces after current position)
     *
     * @return int
     */
    public function getIndent()
    {
        $this->getNextNonSpacePosition();

        return $this->indent;
    }

    /**
     * Whether the cursor is indented to INDENT_LEVEL
     *
     * @return bool
     */
    public function isIndented()
    {
        $this->getNextNonSpacePosition();

        return $this->indent >= self::INDENT_LEVEL;
    }

    /**
     * @param int|null $index
     *
     * @return string|null
     */
    public function getCharacter($index = null)
    {
        if ($index === null) {
            $index = $this->currentPosition;
        }

        // Index out-of-bounds, or we're at the end
        if ($index < 0 || $index >= $this->length) {
            return;
        }

        return mb_substr($this->line, $index, 1, $this->encoding);
    }

    /**
     * Returns the next character (or null, if none) without advancing forwards
     *
     * @param int $offset
     *
     * @return string|null
     */
    public function peek($offset = 1)
    {
        return $this->getCharacter($this->currentPosition + $offset);
    }

    /**
     * Whether the remainder is blank
     *
     * @return bool
     */
    public function isBlank()
    {
        return $this->getNextNonSpacePosition() === $this->length;
    }

    /**
     * Move the cursor forwards
     */
    public function advance()
    {
        $this->advanceBy(1);
    }

    /**
     * Move the cursor forwards
     *
     * @param int  $characters       Number of characters to advance by
     * @param bool $advanceByColumns Whether to advance by columns instead of spaces
     */
    public function advanceBy($characters, $advanceByColumns = false)
    {
        if ($characters === 0) {
            $this->previousPosition = $this->currentPosition;

            return;
        }

        $this->previousPosition = $this->currentPosition;
        $this->nextNonSpaceCache = null;

        $nextFewChars = mb_substr($this->line, $this->currentPosition, $characters, $this->encoding);

        // Optimization to avoid tab handling logic if we have no tabs
        if (!$this->lineContainsTabs || preg_match('/\t/', $nextFewChars) === 0) {
            $length = min($characters, $this->length - $this->currentPosition);
            $this->partiallyConsumedTab = false;
            $this->currentPosition += $length;
            $this->column += $length;

            return;
        }

        if ($characters === 1 && !empty($nextFewChars)) {
            $asArray = [$nextFewChars];
        } else {
            $asArray = preg_split('//u', $nextFewChars, null, PREG_SPLIT_NO_EMPTY);
        }

        foreach ($asArray as $relPos => $c) {
            if ($c === "\t") {
                $charsToTab = 4 - ($this->column % 4);
                if ($advanceByColumns) {
                    $this->partiallyConsumedTab = $charsToTab > $characters;
                    $charsToAdvance = $charsToTab > $characters ? $characters : $charsToTab;
                    $this->column += $charsToAdvance;
                    $this->currentPosition += $this->partiallyConsumedTab ? 0 : 1;
                    $characters -= $charsToAdvance;
                } else {
                    $this->partiallyConsumedTab = false;
                    $this->column += $charsToTab;
                    $this->currentPosition++;
                    $characters--;
                }
            } else {
                $this->partiallyConsumedTab = false;
                $this->currentPosition++;
                $this->column++;
                $characters--;
            }

            if ($characters <= 0) {
                break;
            }
        }
    }

    /**
     * Advances the cursor by a single space or tab, if present
     *
     * @return bool
     */
    public function advanceBySpaceOrTab()
    {
        $character = $this->getCharacter();

        if ($character === ' ' || $character === "\t") {
            $this->advanceBy(1, true);

            return true;
        }

        return false;
    }

    /**
     * Advances the cursor while the given character is matched
     *
     * @param string   $character                  Character to match
     * @param int|null $maximumCharactersToAdvance Maximum number of characters to advance before giving up
     *
     * @return int Number of positions moved (0 if unsuccessful)
     *
     * @deprecated Use match() instead
     */
    public function advanceWhileMatches($character, $maximumCharactersToAdvance = null)
    {
        @trigger_error('Cursor::advanceWhileMatches() will be removed in a future 0.x release.  Use match() instead.', E_USER_DEPRECATED);

        // Calculate how far to advance
        $start = $this->currentPosition;
        $newIndex = $start;
        if ($maximumCharactersToAdvance === null) {
            $maximumCharactersToAdvance = $this->length;
        }

        $max = min($start + $maximumCharactersToAdvance, $this->length);

        while ($newIndex < $max && $this->getCharacter($newIndex) === $character) {
            ++$newIndex;
        }

        if ($newIndex <= $start) {
            return 0;
        }

        $this->advanceBy($newIndex - $start);

        return $this->currentPosition - $this->previousPosition;
    }

    /**
     * Parse zero or more space characters, including at most one newline.
     *
     * @deprecated Use advanceToNextNonSpaceOrNewline() instead
     */
    public function advanceToFirstNonSpace()
    {
        @trigger_error('Cursor::advanceToFirstNonSpace() will be removed in a future 0.x release.  Use advanceToNextNonSpaceOrTab() or advanceToNextNonSpaceOrNewline() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
// For example instead of
@mkdir($dir);

// Better use
if (@mkdir($dir) === false) {
    throw new \RuntimeException('The directory '.$dir.' could not be created.');
}

        return $this->advanceToNextNonSpaceOrNewline();
    }

    /**
     * Parse zero or more space/tab characters
     *
     * @return int Number of positions moved
     */
    public function advanceToNextNonSpaceOrTab()
    {
        $newPosition = $this->getNextNonSpacePosition();
        $this->advanceBy($newPosition - $this->currentPosition);
        $this->partiallyConsumedTab = false;

        return $this->currentPosition - $this->previousPosition;
    }

    /**
     * Parse zero or more space characters, including at most one newline.
     *
     * Tab characters are not parsed with this function.
     *
     * @return int Number of positions moved
     */
    public function advanceToNextNonSpaceOrNewline()
    {
        $matches = [];
        preg_match('/^ *(?:\n *)?/', $this->getRemainder(), $matches, PREG_OFFSET_CAPTURE);

        // [0][0] contains the matched text
        // [0][1] contains the index of that match
        $increment = $matches[0][1] + strlen($matches[0][0]);

        if ($increment === 0) {
            return 0;
        }

        $this->advanceBy($increment);

        return $this->currentPosition - $this->previousPosition;
    }

    /**
     * Move the position to the very end of the line
     *
     * @return int The number of characters moved
     */
    public function advanceToEnd()
    {
        $this->previousPosition = $this->currentPosition;
        $this->nextNonSpaceCache = null;

        $this->currentPosition = $this->length;

        return $this->currentPosition - $this->previousPosition;
    }

    /**
     * @return string
     */
    public function getRemainder()
    {
        if ($this->currentPosition >= $this->length) {
            return '';
        }

        $prefix = '';
        $position = $this->currentPosition;
        if ($this->partiallyConsumedTab) {
            $position++;
            $charsToTab = 4 - ($this->column % 4);
            $prefix = str_repeat(' ', $charsToTab);
        }

        return $prefix . mb_substr($this->line, $position, null, $this->encoding);
    }

    /**
     * @return string
     */
    public function getLine()
    {
        return $this->line;
    }

    /**
     * @return bool
     */
    public function isAtEnd()
    {
        return $this->currentPosition >= $this->length;
    }

    /**
     * Try to match a regular expression
     *
     * Returns the matching text and advances to the end of that match
     *
     * @param string $regex
     *
     * @return string|null
     */
    public function match($regex)
    {
        $subject = $this->getRemainder();

        $matches = [];
        if (!preg_match($regex, $subject, $matches, PREG_OFFSET_CAPTURE)) {
            return;
        }

        // $matches[0][0] contains the matched text
        // $matches[0][1] contains the index of that match

        if ($this->isMultibyte) {
            // PREG_OFFSET_CAPTURE always returns the byte offset, not the char offset, which is annoying
            $offset = mb_strlen(mb_strcut($subject, 0, $matches[0][1], $this->encoding), $this->encoding);
        } else {
            $offset = $matches[0][1];
        }

        // [0][0] contains the matched text
        // [0][1] contains the index of that match
        $this->advanceBy($offset + mb_strlen($matches[0][0], $this->encoding));

        return $matches[0][0];
    }

    /**
     * Encapsulates the current state of this cursor in case you need to rollback later.
     *
     * WARNING: Do not parse or use the return value for ANYTHING except for
     * passing it back into restoreState(), as the number of values and their
     * contents may change in any future release without warning.
     *
     * @return array
     */
    public function saveState()
    {
        return [
            $this->currentPosition,
            $this->previousPosition,
            $this->nextNonSpaceCache,
            $this->indent,
            $this->column,
            $this->partiallyConsumedTab,
        ];
    }

    /**
     * Restore the cursor to a previous state.
     *
     * Pass in the value previously obtained by calling saveState().
     *
     * @param array $state
     */
    public function restoreState($state)
    {
        list(
            $this->currentPosition,
            $this->previousPosition,
            $this->nextNonSpaceCache,
            $this->indent,
            $this->column,
            $this->partiallyConsumedTab
          ) = $state;
    }

    /**
     * @return int
     */
    public function getPosition()
    {
        return $this->currentPosition;
    }

    /**
     * @return string
     */
    public function getPreviousText()
    {
        return mb_substr($this->line, $this->previousPosition, $this->currentPosition - $this->previousPosition, $this->encoding);
    }

    /**
     * @return int
     */
    public function getColumn()
    {
        return $this->column;
    }
}


1		<?php
2
3		/*
4		* This file is part of the league/commonmark package.
5		*
6		* (c) Colin O'Dell <[email protected]>
7		*
8		* For the full copyright and license information, please view the LICENSE
9		* file that was distributed with this source code.
10		*/
11
12		namespace League\CommonMark;
13
14		class Cursor
15		{
16		const INDENT_LEVEL = 4;
17
18		/**
19		* @var string
20		*/
21		private $line;
22
23		/**
24		* @var int
25		*/
26		private $length;
27
28		/**
29		* @var int
30		*
31		* It's possible for this to be 1 char past the end, meaning we've parsed all chars and have
32		* reached the end. In this state, any character-returning method MUST return null.
33		*/
34		private $currentPosition = 0;
35
36		/**
37		* @var int
38		*/
39		private $column = 0;
40
41		/**
42		* @var int
43		*/
44		private $indent = 0;
45
46		/**
47		* @var int
48		*/
49		private $previousPosition = 0;
50
51		/**
52		* @var int\|null
53		*/
54		private $nextNonSpaceCache;
55
56		/**
57		* @var bool
58		*/
59		private $partiallyConsumedTab = false;
60
61		/**
62		* @var string
63		*/
64		private $encoding;
65
66		/**
67		* @var bool
68		*/
69		private $lineContainsTabs;
70
71		/**
72		* @var bool
73		*/
74		private $isMultibyte;
75
76		/**
77		* @param string $line
78		*/
79	2430	public function __construct($line)
80		{
81	2430	$this->line = $line;
82	2430	$this->encoding = mb_detect_encoding($line, 'ASCII,UTF-8', true) ?: 'ISO-8859-1';
83	2430	$this->length = mb_strlen($line, $this->encoding);
84	2430	$this->isMultibyte = $this->length !== strlen($line);
85	2430	$this->lineContainsTabs = preg_match('/\t/', $line) > 0;
86	2430	}
87
88		/**
89		* Returns the position of the next character which is not a space (or tab)
90		*
91		* @deprecated Use getNextNonSpacePosition() instead
92		*
93		* @return int
94		*/
95	8	public function getFirstNonSpacePosition()
96		{
97	8	@trigger_error('Cursor::getFirstNonSpacePosition() will be removed in a future 0.x release. Use getNextNonSpacePosition() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
		1 ignored issue – show Security Best Practice introduced 2017-08-05 19:01 UTC by Report Bug Copy Issue Report It seems like you do not handle an error condition here. This can introduce security issues, and is generally not recommended. If you suppress an error, we recommend checking for the error condition explicitly: // For example instead of @mkdir($dir); // Better use if (@mkdir($dir) === false) { throw new \RuntimeException('The directory '.$dir.' could not be created.'); } Loading history...
98
99	8	return $this->getNextNonSpacePosition();
100		}
101
102		/**
103		* Returns the position of the next character which is not a space (or tab)
104		*
105		* @return int
106		*/
107	2112	public function getNextNonSpacePosition()
108		{
109	2112	if ($this->nextNonSpaceCache !== null) {
110	1980	return $this->nextNonSpaceCache;
111		}
112
113	2112	$i = $this->currentPosition;
114	2112	$cols = $this->column;
115
116	2112	while (($c = $this->getCharacter($i)) !== null) {
117	2088	if ($c === ' ') {
118	504	$i++;
119	504	$cols++;
120	2088	} elseif ($c === "\t") {
121	36	$i++;
122	36	$cols += (4 - ($cols % 4));
123	36	} else {
124	2046	break;
125		}
126	525	}
127
128	2112	$nextNonSpace = ($c === null) ? $this->length : $i;
129	2112	$this->indent = $cols - $this->column;
130
131	2112	return $this->nextNonSpaceCache = $nextNonSpace;
132		}
133
134		/**
135		* Returns the next character which isn't a space (or tab)
136		*
137		* @deprecated Use getNextNonSpaceCharacter() instead
138		*
139		* @return string
140		*/
141	8	public function getFirstNonSpaceCharacter()
142		{
143	8	@trigger_error('Cursor::getFirstNonSpaceCharacter() will be removed in a future 0.x release. Use getNextNonSpaceCharacter() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
		1 ignored issue – show Security Best Practice introduced 2017-08-05 19:01 UTC by Report Bug Copy Issue Report It seems like you do not handle an error condition here. This can introduce security issues, and is generally not recommended. If you suppress an error, we recommend checking for the error condition explicitly: // For example instead of @mkdir($dir); // Better use if (@mkdir($dir) === false) { throw new \RuntimeException('The directory '.$dir.' could not be created.'); } Loading history...
144
145	8	return $this->getNextNonSpaceCharacter();
146		}
147
148		/**
149		* Returns the next character which isn't a space (or tab)
150		*
151		* @return string
152		*/
153	1905	public function getNextNonSpaceCharacter()
154		{
155	1905	return $this->getCharacter($this->getNextNonSpacePosition());
156		}
157
158		/**
159		* Calculates the current indent (number of spaces after current position)
160		*
161		* @return int
162		*/
163	1890	public function getIndent()
164		{
165	1890	$this->getNextNonSpacePosition();
166
167	1890	return $this->indent;
168		}
169
170		/**
171		* Whether the cursor is indented to INDENT_LEVEL
172		*
173		* @return bool
174		*/
175	1932	public function isIndented()
176		{
177	1932	$this->getNextNonSpacePosition();
178
179	1932	return $this->indent >= self::INDENT_LEVEL;
180		}
181
182		/**
183		* @param int\|null $index
184		*
185		* @return string\|null
186		*/
187	2205	public function getCharacter($index = null)
188		{
189	2205	if ($index === null) {
190	1683	$index = $this->currentPosition;
191	1683	}
192
193		// Index out-of-bounds, or we're at the end
194	2205	if ($index < 0 \|\| $index >= $this->length) {
195	1887	return;
196		}
197
198	2163	return mb_substr($this->line, $index, 1, $this->encoding);
199		}
200
201		/**
202		* Returns the next character (or null, if none) without advancing forwards
203		*
204		* @param int $offset
205		*
206		* @return string\|null
207		*/
208	1014	public function peek($offset = 1)
209		{
210	1014	return $this->getCharacter($this->currentPosition + $offset);
211		}
212
213		/**
214		* Whether the remainder is blank
215		*
216		* @return bool
217		*/
218	1950	public function isBlank()
219		{
220	1950	return $this->getNextNonSpacePosition() === $this->length;
221		}
222
223		/**
224		* Move the cursor forwards
225		*/
226	789	public function advance()
227		{
228	789	$this->advanceBy(1);
229	789	}
230
231		/**
232		* Move the cursor forwards
233		*
234		* @param int $characters Number of characters to advance by
235		* @param bool $advanceByColumns Whether to advance by columns instead of spaces
236		*/
237	2286	public function advanceBy($characters, $advanceByColumns = false)
238		{
239	2286	if ($characters === 0) {
240	1971	$this->previousPosition = $this->currentPosition;
241
242	1971	return;
243		}
244
245	2142	$this->previousPosition = $this->currentPosition;
246	2142	$this->nextNonSpaceCache = null;
247
248	2142	$nextFewChars = mb_substr($this->line, $this->currentPosition, $characters, $this->encoding);
249
250		// Optimization to avoid tab handling logic if we have no tabs
251	2142	if (!$this->lineContainsTabs \|\| preg_match('/\t/', $nextFewChars) === 0) {
252	2130	$length = min($characters, $this->length - $this->currentPosition);
253	2130	$this->partiallyConsumedTab = false;
254	2130	$this->currentPosition += $length;
255	2130	$this->column += $length;
256
257	2130	return;
258		}
259
260	45	if ($characters === 1 && !empty($nextFewChars)) {
261	18	$asArray = [$nextFewChars];
262	18	} else {
263	39	$asArray = preg_split('//u', $nextFewChars, null, PREG_SPLIT_NO_EMPTY);
264		}
265
266	45	foreach ($asArray as $relPos => $c) {
267	45	if ($c === "\t") {
268	45	$charsToTab = 4 - ($this->column % 4);
269	45	if ($advanceByColumns) {
270	33	$this->partiallyConsumedTab = $charsToTab > $characters;
271	33	$charsToAdvance = $charsToTab > $characters ? $characters : $charsToTab;
272	33	$this->column += $charsToAdvance;
273	33	$this->currentPosition += $this->partiallyConsumedTab ? 0 : 1;
274	33	$characters -= $charsToAdvance;
275	33	} else {
276	18	$this->partiallyConsumedTab = false;
277	18	$this->column += $charsToTab;
278	18	$this->currentPosition++;
279	18	$characters--;
280		}
281	45	} else {
282	12	$this->partiallyConsumedTab = false;
283	12	$this->currentPosition++;
284	12	$this->column++;
285	12	$characters--;
286		}
287
288	45	if ($characters <= 0) {
289	45	break;
290		}
291	45	}
292	45	}
293
294		/**
295		* Advances the cursor by a single space or tab, if present
296		*
297		* @return bool
298		*/
299	333	public function advanceBySpaceOrTab()
300		{
301	333	$character = $this->getCharacter();
302
303	333	if ($character === ' ' \|\| $character === "\t") {
304	321	$this->advanceBy(1, true);
305
306	321	return true;
307		}
308
309	249	return false;
310		}
311
312		/**
313		* Advances the cursor while the given character is matched
314		*
315		* @param string $character Character to match
316		* @param int\|null $maximumCharactersToAdvance Maximum number of characters to advance before giving up
317		*
318		* @return int Number of positions moved (0 if unsuccessful)
319		*
320		* @deprecated Use match() instead
321		*/
322	15	public function advanceWhileMatches($character, $maximumCharactersToAdvance = null)
323		{
324	15	@trigger_error('Cursor::advanceWhileMatches() will be removed in a future 0.x release. Use match() instead.', E_USER_DEPRECATED);
325
326		// Calculate how far to advance
327	15	$start = $this->currentPosition;
328	15	$newIndex = $start;
329	15	if ($maximumCharactersToAdvance === null) {
330	6	$maximumCharactersToAdvance = $this->length;
331	6	}
332
333	15	$max = min($start + $maximumCharactersToAdvance, $this->length);
334
335	15	while ($newIndex < $max && $this->getCharacter($newIndex) === $character) {
336	11	++$newIndex;
337	11	}
338
339	15	if ($newIndex <= $start) {
340	4	return 0;
341		}
342
343	11	$this->advanceBy($newIndex - $start);
344
345	11	return $this->currentPosition - $this->previousPosition;
346		}
347
348		/**
349		* Parse zero or more space characters, including at most one newline.
350		*
351		* @deprecated Use advanceToNextNonSpaceOrNewline() instead
352		*/
353	18	public function advanceToFirstNonSpace()
354		{
355	18	@trigger_error('Cursor::advanceToFirstNonSpace() will be removed in a future 0.x release. Use advanceToNextNonSpaceOrTab() or advanceToNextNonSpaceOrNewline() instead. See https://github.com/thephpleague/commonmark/issues/280', E_USER_DEPRECATED);
		1 ignored issue – show Security Best Practice introduced 2017-08-05 19:01 UTC by Report Bug Copy Issue Report It seems like you do not handle an error condition here. This can introduce security issues, and is generally not recommended. If you suppress an error, we recommend checking for the error condition explicitly: // For example instead of @mkdir($dir); // Better use if (@mkdir($dir) === false) { throw new \RuntimeException('The directory '.$dir.' could not be created.'); } Loading history...
356
357	18	return $this->advanceToNextNonSpaceOrNewline();
358		}
359
360		/**
361		* Parse zero or more space/tab characters
362		*
363		* @return int Number of positions moved
364		*/
365	1842	public function advanceToNextNonSpaceOrTab()
366		{
367	1842	$newPosition = $this->getNextNonSpacePosition();
368	1842	$this->advanceBy($newPosition - $this->currentPosition);
369	1842	$this->partiallyConsumedTab = false;
370
371	1842	return $this->currentPosition - $this->previousPosition;
372		}
373
374		/**
375		* Parse zero or more space characters, including at most one newline.
376		*
377		* Tab characters are not parsed with this function.
378		*
379		* @return int Number of positions moved
380		*/
381	441	public function advanceToNextNonSpaceOrNewline()
382		{
383	441	$matches = [];
384	441	preg_match('/^ (?:\n )?/', $this->getRemainder(), $matches, PREG_OFFSET_CAPTURE);
385
386		// [0][0] contains the matched text
387		// [0][1] contains the index of that match
388	441	$increment = $matches[0][1] + strlen($matches[0][0]);
389
390	441	if ($increment === 0) {
391	300	return 0;
392		}
393
394	300	$this->advanceBy($increment);
395
396	300	return $this->currentPosition - $this->previousPosition;
397		}
398
399		/**
400		* Move the position to the very end of the line
401		*
402		* @return int The number of characters moved
403		*/
404	84	public function advanceToEnd()
405		{
406	84	$this->previousPosition = $this->currentPosition;
407	84	$this->nextNonSpaceCache = null;
408
409	84	$this->currentPosition = $this->length;
410
411	84	return $this->currentPosition - $this->previousPosition;
412		}
413
414		/**
415		* @return string
416		*/
417	2037	public function getRemainder()
418		{
419	2037	if ($this->currentPosition >= $this->length) {
420	693	return '';
421		}
422
423	2022	$prefix = '';
424	2022	$position = $this->currentPosition;
425	2022	if ($this->partiallyConsumedTab) {
426	15	$position++;
427	15	$charsToTab = 4 - ($this->column % 4);
428	15	$prefix = str_repeat(' ', $charsToTab);
429	15	}
430
431	2022	return $prefix . mb_substr($this->line, $position, null, $this->encoding);
432		}
433
434		/**
435		* @return string
436		*/
437	1887	public function getLine()
438		{
439	1887	return $this->line;
440		}
441
442		/**
443		* @return bool
444		*/
445	411	public function isAtEnd()
446		{
447	411	return $this->currentPosition >= $this->length;
448		}
449
450		/**
451		* Try to match a regular expression
452		*
453		* Returns the matching text and advances to the end of that match
454		*
455		* @param string $regex
456		*
457		* @return string\|null
458		*/
459	1902	public function match($regex)
460		{
461	1902	$subject = $this->getRemainder();
462
463	1902	$matches = [];
464	1902	if (!preg_match($regex, $subject, $matches, PREG_OFFSET_CAPTURE)) {
465	1758	return;
466		}
467
468		// $matches[0][0] contains the matched text
469		// $matches[0][1] contains the index of that match
470
471	1776	if ($this->isMultibyte) {
472		// PREG_OFFSET_CAPTURE always returns the byte offset, not the char offset, which is annoying
473	51	$offset = mb_strlen(mb_strcut($subject, 0, $matches[0][1], $this->encoding), $this->encoding);
474	51	} else {
475	1725	$offset = $matches[0][1];
476		}
477
478		// [0][0] contains the matched text
479		// [0][1] contains the index of that match
480	1776	$this->advanceBy($offset + mb_strlen($matches[0][0], $this->encoding));
481
482	1776	return $matches[0][0];
483		}
484
485		/**
486		* Encapsulates the current state of this cursor in case you need to rollback later.
487		*
488		* WARNING: Do not parse or use the return value for ANYTHING except for
489		* passing it back into restoreState(), as the number of values and their
490		* contents may change in any future release without warning.
491		*
492		* @return array
493		*/
494	1011	public function saveState()
495		{
496		return [
497	1011	$this->currentPosition,
498	1011	$this->previousPosition,
499	1011	$this->nextNonSpaceCache,
500	1011	$this->indent,
501	1011	$this->column,
502	1011	$this->partiallyConsumedTab,
503	1011	];
504		}
505
506		/**
507		* Restore the cursor to a previous state.
508		*
509		* Pass in the value previously obtained by calling saveState().
510		*
511		* @param array $state
512		*/
513	795	public function restoreState($state)
514		{
515		list(
516	795	$this->currentPosition,
517	795	$this->previousPosition,
518	795	$this->nextNonSpaceCache,
519	795	$this->indent,
520	795	$this->column,
521	795	$this->partiallyConsumedTab
522	795	) = $state;
523	795	}
524
525		/**
526		* @return int
527		*/
528	648	public function getPosition()
529		{
530	648	return $this->currentPosition;
531		}
532
533		/**
534		* @return string
535		*/
536	870	public function getPreviousText()
537		{
538	870	return mb_substr($this->line, $this->previousPosition, $this->currentPosition - $this->previousPosition, $this->encoding);
539		}
540
541		/**
542		* @return int
543		*/
544	240	public function getColumn()
545		{
546	240	return $this->column;
547		}
548		}
549

thephpleague / commonmark

Push — master ( 181260...afd04b )

Cursor::match() B

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like