com.sonar.sslr.api

Class Comments

java.lang.Object

com.sonar.sslr.api.Comments

All Implemented Interfaces:

java.lang.Iterable<Token>

public class Comments
extends java.lang.Object
implements java.lang.Iterable<Token>

Utility class to manipulate comment tokens

Constructor Summary

Constructors

Constructor and Description
Comments( comments)
Comments( comments, CommentAnalyser analyser)

Method Summary

Methods

Modifier and Type	Method and Description
Token	getCommentAtLine(int line) Deprecated. see getCommentTokensAtLine(int)
java.util.List<Token>	getCommentTokensAtLine(int line)
java.util.SortedSet<java.lang.Integer>	getLinesOfComment() Get the sorted list of lines containing at least a comment
boolean	hasCommentTokensAtLine(int line)
boolean	isBlank(java.lang.String commentValue)
boolean	isBlankComment(int line) Deprecated. see #isBlank(int)
static boolean	isBlankComment(java.lang.String comment) Deprecated. see isBlank(String)
boolean	isThereCommentAtLine(int commentLine) Deprecated. see hasCommentTokensAtLine(int)
boolean	isThereCommentBeforeLine(int line)
java.util.Iterator<Token>	iterator() Iterates over the collection of comment tokens
int	size() Return the number of comment tokens

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Comments

public Comments( comments)

Comments

public Comments( comments,
        CommentAnalyser analyser)

Method Detail

iterator

public java.util.Iterator<Token> iterator()

Iterates over the collection of comment tokens

Specified by:

iterator in interface java.lang.Iterable<Token>

getLinesOfComment

public java.util.SortedSet<java.lang.Integer> getLinesOfComment()

Get the sorted list of lines containing at least a comment

size

public int size()

Return the number of comment tokens

hasCommentTokensAtLine

public boolean hasCommentTokensAtLine(int line)

Parameters:

line - the line where we expect to find some comment tokens

Returns:

true if there is at least one comment token at provided line

getCommentTokensAtLine

public java.util.List<Token> getCommentTokensAtLine(int line)

Parameters:

line - the line where we expect to find some comment tokens

Returns:

the list of comment tokens on this line

isBlank

public boolean isBlank(java.lang.String commentValue)

Parameters:

commentValue - the value of the comment

Returns:

true if the value is considered to be a blank comment

isBlankComment

@Deprecated
public static boolean isBlankComment(java.lang.String comment)

Deprecated. see isBlank(String)

isBlankComment

@Deprecated
public boolean isBlankComment(int line)

Deprecated. see #isBlank(int)

getCommentAtLine

@Deprecated
public Token getCommentAtLine(int line)

Deprecated. see getCommentTokensAtLine(int)

isThereCommentBeforeLine

public boolean isThereCommentBeforeLine(int line)

Parameters:

line - the line above which some non-blank comment tokens are expected to be found

Returns:

true if there is a list one non-blank comment tokens before the provided line

isThereCommentAtLine

@Deprecated
public boolean isThereCommentAtLine(int commentLine)

Deprecated. see hasCommentTokensAtLine(int)