REDROOM

Navigation

Breadcrumbs

/ / home / getspomw / itechservicellc.com / vendor / nikic / php-parser / lib / PhpParser

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 6.75 KB

/home/getspomw/itechservicellc.com/vendor/nikic/php-parser/lib/PhpParser/Comment.php

Text Base64

<?php declare(strict_types=1);

namespace PhpParser;

class Comment implements \JsonSerializable {
    protected string $text;
    protected int $startLine;
    protected int $startFilePos;
    protected int $startTokenPos;
    protected int $endLine;
    protected int $endFilePos;
    protected int $endTokenPos;

/**
     * Constructs a comment node.
     *
     * @param string $text Comment text (including comment delimiters like /*)
     * @param int $startLine Line number the comment started on
     * @param int $startFilePos File offset the comment started on
     * @param int $startTokenPos Token offset the comment started on
     */
    public function __construct(
        string $text,
        int $startLine = -1, int $startFilePos = -1, int $startTokenPos = -1,
        int $endLine = -1, int $endFilePos = -1, int $endTokenPos = -1
    ) {
        $this->text = $text;
        $this->startLine = $startLine;
        $this->startFilePos = $startFilePos;
        $this->startTokenPos = $startTokenPos;
        $this->endLine = $endLine;
        $this->endFilePos = $endFilePos;
        $this->endTokenPos = $endTokenPos;
    }

/**
     * Gets the comment text.
     *
     * @return string The comment text (including comment delimiters like /*)
     */
    public function getText(): string {
        return $this->text;
    }

/**
     * Gets the line number the comment started on.
     *
     * @return int Line number (or -1 if not available)
     * @phpstan-return -1|positive-int
     */
    public function getStartLine(): int {
        return $this->startLine;
    }

/**
     * Gets the file offset the comment started on.
     *
     * @return int File offset (or -1 if not available)
     */
    public function getStartFilePos(): int {
        return $this->startFilePos;
    }

/**
     * Gets the token offset the comment started on.
     *
     * @return int Token offset (or -1 if not available)
     */
    public function getStartTokenPos(): int {
        return $this->startTokenPos;
    }

/**
     * Gets the line number the comment ends on.
     *
     * @return int Line number (or -1 if not available)
     * @phpstan-return -1|positive-int
     */
    public function getEndLine(): int {
        return $this->endLine;
    }

/**
     * Gets the file offset the comment ends on.
     *
     * @return int File offset (or -1 if not available)
     */
    public function getEndFilePos(): int {
        return $this->endFilePos;
    }

/**
     * Gets the token offset the comment ends on.
     *
     * @return int Token offset (or -1 if not available)
     */
    public function getEndTokenPos(): int {
        return $this->endTokenPos;
    }

/**
     * Gets the comment text.
     *
     * @return string The comment text (including comment delimiters like /*)
     */
    public function __toString(): string {
        return $this->text;
    }

/**
     * Gets the reformatted comment text.
     *
     * "Reformatted" here means that we try to clean up the whitespace at the
     * starts of the lines. This is necessary because we receive the comments
     * without leading whitespace on the first line, but with leading whitespace
     * on all subsequent lines.
     *
     * Additionally, this normalizes CRLF newlines to LF newlines.
     */
    public function getReformattedText(): string {
        $text = str_replace("\r\n", "\n", $this->text);
        $newlinePos = strpos($text, "\n");
        if (false === $newlinePos) {
            // Single line comments don't need further processing
            return $text;
        }
        if (preg_match('(^.*(?:\n\s+\*.*)+$)', $text)) {
            // Multi line comment of the type
            //
            //     /*
            //      * Some text.
            //      * Some more text.
            //      */
            //
            // is handled by replacing the whitespace sequences before the * by a single space
            return preg_replace('(^\s+\*)m', ' *', $text);
        }
        if (preg_match('(^/\*\*?\s*\n)', $text) && preg_match('(\n(\s*)\*/$)', $text, $matches)) {
            // Multi line comment of the type
            //
            //    /*
            //        Some text.
            //        Some more text.
            //    */
            //
            // is handled by removing the whitespace sequence on the line before the closing
            // */ on all lines. So if the last line is "    */", then "    " is removed at the
            // start of all lines.
            return preg_replace('(^' . preg_quote($matches[1]) . ')m', '', $text);
        }
        if (preg_match('(^/\*\*?\s*(?!\s))', $text, $matches)) {
            // Multi line comment of the type
            //
            //     /* Some text.
            //        Some more text.
            //          Indented text.
            //        Even more text. */
            //
            // is handled by removing the difference between the shortest whitespace prefix on all
            // lines and the length of the "/* " opening sequence.
            $prefixLen = $this->getShortestWhitespacePrefixLen(substr($text, $newlinePos + 1));
            $removeLen = $prefixLen - strlen($matches[0]);
            return preg_replace('(^\s{' . $removeLen . '})m', '', $text);
        }

// No idea how to format this comment, so simply return as is
        return $text;
    }

/**
     * Get length of shortest whitespace prefix (at the start of a line).
     *
     * If there is a line with no prefix whitespace, 0 is a valid return value.
     *
     * @param string $str String to check
     * @return int Length in characters. Tabs count as single characters.
     */
    private function getShortestWhitespacePrefixLen(string $str): int {
        $lines = explode("\n", $str);
        $shortestPrefixLen = \PHP_INT_MAX;
        foreach ($lines as $line) {
            preg_match('(^\s*)', $line, $matches);
            $prefixLen = strlen($matches[0]);
            if ($prefixLen < $shortestPrefixLen) {
                $shortestPrefixLen = $prefixLen;
            }
        }
        return $shortestPrefixLen;
    }

/**
     * @return array{nodeType:string, text:mixed, line:mixed, filePos:mixed}
     */
    public function jsonSerialize(): array {
        // Technically not a node, but we make it look like one anyway
        $type = $this instanceof Comment\Doc ? 'Comment_Doc' : 'Comment';
        return [
            'nodeType' => $type,
            'text' => $this->text,
            // TODO: Rename these to include "start".
            'line' => $this->startLine,
            'filePos' => $this->startFilePos,
            'tokenPos' => $this->startTokenPos,
            'endLine' => $this->endLine,
            'endFilePos' => $this->endFilePos,
            'endTokenPos' => $this->endTokenPos,
        ];
    }
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 9 Ã— Files: 28

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
Builder DIR	-	drwxr-xr-x	2025-11-18 19:24:02	Edit Download recursive recursive
Comment DIR	-	drwxr-xr-x	2025-11-18 19:24:02	Edit Download recursive recursive
ErrorHandler DIR	-	drwxr-xr-x	2025-11-18 19:24:02	Edit Download recursive recursive
Internal DIR	-	drwxr-xr-x	2025-11-18 19:24:02	Edit Download recursive recursive
Lexer DIR	-	drwxr-xr-x	2025-11-18 19:24:02	Edit Download recursive recursive
Node DIR	-	drwxr-xr-x	2025-11-18 19:24:04	Edit Download recursive recursive
NodeVisitor DIR	-	drwxr-xr-x	2025-11-18 19:24:04	Edit Download recursive recursive
Parser DIR	-	drwxr-xr-x	2025-11-18 19:24:04	Edit Download recursive recursive
PrettyPrinter DIR	-	drwxr-xr-x	2025-11-18 19:24:04	Edit Download recursive recursive
Builder.php	202 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
BuilderFactory.php	10.30 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
BuilderHelpers.php	9.73 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Comment.php	6.75 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
compatibility_tokens.php	2.39 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
ConstExprEvaluationException.php	112 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
ConstExprEvaluator.php	9.21 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Error.php	4.84 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
ErrorHandler.php	300 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
JsonDecoder.php	3.44 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Lexer.php	4.26 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Modifiers.php	2.71 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NameContext.php	9.82 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Node.php	4.03 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeAbstract.php	5.24 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeDumper.php	10.24 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeFinder.php	2.55 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeTraverser.php	10.09 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeTraverserInterface.php	598 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeVisitor.php	4.08 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
NodeVisitorAbstract.php	447 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Parser.php	765 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
ParserAbstract.php	50.13 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
ParserFactory.php	1.41 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
PhpVersion.php	4.62 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
PrettyPrinter.php	1.66 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
PrettyPrinterAbstract.php	70.38 KB	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive
Token.php	487 B	lrw-r--r--	2025-10-28 20:23:04	Edit Download recursive recursive