com.starteam
Interface File.Keyword

Enclosing class:

File

public static interface File.Keyword

A Keyword object that encapsulates information about a File keyword. When a file is added, checked-in or checked-out of the repository keyword expansion may be applied to the contents of the file. For example, an occurrence of $Author$ in a file might be be replaced with $Author: Fred$ upon checkout. NOTE: This interface is not intended to be implemented by client applications.

Method Summary

java.lang.String	expand(java.lang.String linePrefix, java.lang.String eol, boolean expand) Returns the expanded or unexpanded version of this keyword.
boolean	getIsMultiLine() Returns true if this keyword spans multiple lines.
java.lang.String	getName() Return the keyword name.
boolean	getStopExpanding() Return true if upon encountering this keyword in a file that no further keyword expansion will occur.
java.lang.String	getValue() Return the keyword value.
java.lang.String	getXMLString() Returns an XML representation of the keyword.
boolean	matches(java.lang.String line, int start, int[] endPos) Returns true of this keyword is found in the specified line.

Method Detail

getName

java.lang.String getName()

Return the keyword name.

Returns:

the keyword name.

getValue

java.lang.String getValue()

Return the keyword value.

Returns:

the keyword value

getStopExpanding

boolean getStopExpanding()

Return true if upon encountering this keyword in a file that no further keyword expansion will occur. This is true for the StarTeam keyword $NoKeywords$.

Returns:

true if keyword expansion should stop in a file after encountering this keyword.

getIsMultiLine

boolean getIsMultiLine()

Returns true if this keyword spans multiple lines. This is only true for the StarTeam $Log$ and $History$ keywords.

Returns:

true if this keyword spans multiple lines.

matches

boolean matches(java.lang.String line,
                int start,
                int[] endPos)

Returns true of this keyword is found in the specified line. If found then the endPos parameter is treated as an output parameter and the value of endPos[0] should be the position in the line where the ending $ occurs.

Parameters:

line - the line to search for this keyword

start - the position in the line (zero based) to start searching

endPos - and "output" array where the end of the keyword occurs.

Returns:

true if the keyword is found on the specified line

expand

java.lang.String expand(java.lang.String linePrefix,
                        java.lang.String eol,
                        boolean expand)

Returns the expanded or unexpanded version of this keyword. For example, if the keyword is "Author" then expanding this should return "Author: Fred$". Note that the leading $ is not returned, it is handled elsehwere. Unexpand would return "Author$"

Parameters:

linePrefix - the begining of the line in the souce leading up to the keyword

eol - the end-of-line convention used in the source file

expand - true if the keyword is to be expanded and false for unexpand

Returns:

the appropriately expanded or unexpanded keyword.

getXMLString

java.lang.String getXMLString()

Returns an XML representation of the keyword.

Returns:

an XML representation of the keyword.