Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. CommentEmptyLineSniff.php

function CommentEmptyLineSniff::process

Processes this test, when one of its tokens is encountered.

Parameters

\PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.:

int $stackPtr The position of the current token: in the stack passed in $tokens.

Return value

void

Overrides Sniff::process

File

vendor/drupal/coder/coder_sniffer/DrupalPractice/Sniffs/Commenting/CommentEmptyLineSniff.php, line 48

Class

CommentEmptyLineSniff
Throws a warning if there is a blank line after an inline comment.

Namespace

DrupalPractice\Sniffs\Commenting

Code

public function process(File $phpcsFile, $stackPtr) {
    $tokens = $phpcsFile->getTokens();
    $comment = rtrim($tokens[$stackPtr]['content']);
    // Only want inline comments.
    if (substr($comment, 0, 2) !== '//') {
        return;
    }
    // The line below the last comment cannot be empty.
    for ($i = $stackPtr + 1; $i < $phpcsFile->numTokens; $i++) {
        if ($tokens[$i]['line'] === $tokens[$stackPtr]['line'] + 1) {
            if ($tokens[$i]['code'] !== T_WHITESPACE) {
                return;
            }
        }
        else {
            if ($tokens[$i]['line'] > $tokens[$stackPtr]['line'] + 1) {
                break;
            }
        }
    }
    $warning = 'There must be no blank line following an inline comment';
    $phpcsFile->addWarning($warning, $stackPtr, 'SpacingAfter');
}
RSS feed
Powered by Drupal