Package com.oracle.truffle.api.source
Interface SourceSection
-
- All Known Implementing Classes:
NullSourceSection
public interface SourceSectionDescription of contiguous section of text within aSourceof program code; supports multiple modes of access to the text and its location. A special null subtype should be used for code that is not available from source, e.g language builtins.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description intgetCharEndIndex()Returns the index of the text position immediately following the last character in the section.intgetCharIndex()Returns the 0-based index of the first character in this section.intgetCharLength()Returns the length of this section in characters.java.lang.StringgetCode()Returns text described by this section.java.lang.StringgetIdentifier()Returns terse text describing this source section, typically used for printing the section.LineLocationgetLineLocation()Gets a representation of the first line of the section, suitable for a hash key.java.lang.StringgetShortDescription()Returns a short description of the source section, using just the file name, rather than its full path.SourcegetSource()Representation of the source program that contains this section.intgetStartColumn()Returns the 1-based column number of the first character in this section (inclusive).intgetStartLine()Returns 1-based line number of the first character in this section (inclusive).
-
-
-
Method Detail
-
getSource
Source getSource()
Representation of the source program that contains this section.- Returns:
- the source object
-
getStartLine
int getStartLine()
Returns 1-based line number of the first character in this section (inclusive).- Returns:
- the starting line number
-
getLineLocation
LineLocation getLineLocation()
Gets a representation of the first line of the section, suitable for a hash key.
-
getStartColumn
int getStartColumn()
Returns the 1-based column number of the first character in this section (inclusive).- Returns:
- the starting column number
-
getCharIndex
int getCharIndex()
Returns the 0-based index of the first character in this section.- Returns:
- the starting character index
-
getCharLength
int getCharLength()
Returns the length of this section in characters.- Returns:
- the number of characters in the section
-
getCharEndIndex
int getCharEndIndex()
Returns the index of the text position immediately following the last character in the section.- Returns:
- the end position of the section
-
getIdentifier
java.lang.String getIdentifier()
Returns terse text describing this source section, typically used for printing the section.- Returns:
- the identifier of the section
-
getCode
java.lang.String getCode()
Returns text described by this section.- Returns:
- the code as a String object
-
getShortDescription
java.lang.String getShortDescription()
Returns a short description of the source section, using just the file name, rather than its full path.- Returns:
- a short description of the source section
-
-