class GenderNeutralCommentSniff in Coder 8.3
Same name and namespace in other branches
- 8.3.x coder_sniffer/Drupal/Sniffs/Commenting/GenderNeutralCommentSniff.php \Drupal\Sniffs\Commenting\GenderNeutralCommentSniff
Parses and verifies that comments use gender neutral language.
@category PHP @package PHP_CodeSniffer @link http://pear.php.net/package/PHP_CodeSniffer
Hierarchy
- class \Drupal\Sniffs\Commenting\GenderNeutralCommentSniff implements \PHP_CodeSniffer\Sniffs\Sniff
Expanded class hierarchy of GenderNeutralCommentSniff
File
- coder_sniffer/
Drupal/ Sniffs/ Commenting/ GenderNeutralCommentSniff.php, line 22
Namespace
Drupal\Sniffs\CommentingView source
class GenderNeutralCommentSniff implements Sniff {
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array<int|string>
*/
public function register() {
return [
T_COMMENT,
T_DOC_COMMENT_STRING,
];
}
//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param \PHP_CodeSniffer\Files\File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
*
* @return void
*/
public function process(File $phpcsFile, $stackPtr) {
$tokens = $phpcsFile
->getTokens();
if ((bool) preg_match('/(^|\\W)(he|her|hers|him|his|she)($|\\W)/i', $tokens[$stackPtr]['content']) === true) {
$phpcsFile
->addError('Unnecessarily gendered language in a comment', $stackPtr, 'GenderNeutral');
}
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
GenderNeutralCommentSniff:: |
public | function | Processes this test, when one of its tokens is encountered. | |
GenderNeutralCommentSniff:: |
public | function | Returns an array of tokens this test wants to listen for. |