Class: Squiz_Sniffs_Commenting_FunctionCommentSniff

Source Location: /PHP_CodeSniffer-2.8.0/CodeSniffer/Standards/Squiz/Sniffs/Commenting/FunctionCommentSniff.php

Class Overview

PEAR_Sniffs_Commenting_FunctionCommentSniff
 |
 --Squiz_Sniffs_Commenting_FunctionCommentSniff

Parses and verifies the doc comments for functions.

Author(s):

Marc McIntyre <mmcintyre at squiz.net>
Greg Sherwood <gsherwood at squiz.net>

Version:

Release: 2.8.0

Copyright:

2006-2014 Squiz Pty Ltd (ABN 77 084 670 600)

Methods

Child classes:

MySource_Sniffs_Commenting_FunctionCommentSniff: Parses and verifies the doc comments for functions.

Inherited Variables

Inherited Methods

Class: PEAR_Sniffs_Commenting_FunctionCommentSniff

PEAR_Sniffs_Commenting_FunctionCommentSniff::process(): Processes this test, when one of its tokens is encountered.
PEAR_Sniffs_Commenting_FunctionCommentSniff::processParams(): Process the function parameter comments.
PEAR_Sniffs_Commenting_FunctionCommentSniff::processReturn(): Process the return comment of this function comment.
PEAR_Sniffs_Commenting_FunctionCommentSniff::processThrows(): Process any throw tags that this function comment has.
PEAR_Sniffs_Commenting_FunctionCommentSniff::register(): Returns an array of tokens this test wants to listen for.

Class Details

[line 32]
Parses and verifies the doc comments for functions.

Author: Marc McIntyre <mmcintyre@squiz.net>
Author: Greg Sherwood <gsherwood@squiz.net>
Version: Release: 2.8.0
Copyright: 2006-2014 Squiz Pty Ltd (ABN 77 084 670 600)
Link: http://pear.php.net/package/PHP_CodeSniffer
License: BSD Licence

[ Top ]

Method Detail

checkSpacingAfterParamName [line 590]

void checkSpacingAfterParamName(
PHP_CodeSniffer_File
$phpcsFile, array
$param, int
$maxVar, [int
$spacing = 1])

Check the spacing after the name of a parameter.

Access: protected

Parameters:

PHP_CodeSniffer_File $phpcsFile — The file being scanned.

array $param — The parameter to be checked.

int $maxVar — The maxlength of the longest parameter name.

int $spacing — The number of spaces to add after the type.

[ Top ]

checkSpacingAfterParamType [line 536]

void checkSpacingAfterParamType(
PHP_CodeSniffer_File
$phpcsFile, array
$param, int
$maxType, [int
$spacing = 1])

Check the spacing after the type of a parameter.

Access: protected

Parameters:

PHP_CodeSniffer_File $phpcsFile — The file being scanned.

array $param — The parameter to be checked.

int $maxType — The maxlength of the longest parameter type.

int $spacing — The number of spaces to add after the type.

[ Top ]

processParams [line 248]

void processParams(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr, int
$commentStart)

Process the function parameter comments.

Access: protected

Overrides PEAR_Sniffs_Commenting_FunctionCommentSniff::processParams() (Process the function parameter comments.)

Parameters:

PHP_CodeSniffer_File $phpcsFile — The file being scanned.

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

int $commentStart — The position in the stack where the comment started.

[ Top ]

processReturn [line 53]

void processReturn(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr, int
$commentStart)

Process the return comment of this function comment.

Access: protected

Overrides PEAR_Sniffs_Commenting_FunctionCommentSniff::processReturn() (Process the return comment of this function comment.)

Parameters:

PHP_CodeSniffer_File $phpcsFile — The file being scanned.

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

int $commentStart — The position in the stack where the comment started.

[ Top ]

processThrows [line 179]

void processThrows(
PHP_CodeSniffer_File
$phpcsFile, int
$stackPtr, int
$commentStart)

Process any throw tags that this function comment has.

Access: protected

Overrides PEAR_Sniffs_Commenting_FunctionCommentSniff::processThrows() (Process any throw tags that this function comment has.)

Parameters:

PHP_CodeSniffer_File $phpcsFile — The file being scanned.

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

int $commentStart — The position in the stack where the comment started.

[ Top ]