SourceSection (GraalVM SDK Java API Reference)

java.lang.Object
- org.graalvm.polyglot.SourceSection

```
public final class SourceSection
extends Object
```
Description of contiguous section of text within a Source of program code.; supports multiple modes of access to the text and its location. Two available source sections are considered equal if their sources, start and length are equal. Unavailable source sections are compared by identity. Source sections are designed to be used as keys in hash maps.

Since:

19.0

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)`
`CharSequence`	`getCharacters()` Returns the source code fragment described by this section.
`int`	`getCharEndIndex()` Returns the index of the text position immediately following the last character in the section.
`int`	`getCharIndex()` Returns the 0-based index of the first character in this section.
`int`	`getCharLength()` Returns the length of this section in characters.
`int`	`getEndColumn()` Returns the 1-based column number of the last character in this section (inclusive).
`int`	`getEndLine()` Returns 1-based line number of the last character in this section (inclusive).
`Source`	`getSource()` Representation of the source program that contains this section.
`int`	`getStartColumn()` Returns the 1-based column number of the first character in this section (inclusive).
`int`	`getStartLine()` Returns 1-based line number of the first character in this section (inclusive).
`boolean`	`hasCharIndex()` Returns `true` if this section has a character index information, `false` otherwise.
`boolean`	`hasColumns()` Returns `true` if this section has a column number information, `false` otherwise.
`int`	`hashCode()`
`boolean`	`hasLines()` Returns `true` if this section has a line number information, `false` otherwise.
`boolean`	`isAvailable()` Returns whether this is a special instance that signifies that source information is available.
`String`	`toString()` Returns an implementation-defined string representation of this source section to be used for debugging purposes only.

Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - isAvailable
```
public boolean isAvailable()
```
    Returns whether this is a special instance that signifies that source information is available. Available source sections are never equal to unavailable source sections. Unavailable source sections return the same indices and lengths as empty source sections starting at character index 0.
    
    Since:
    
    19.0
  - hasLines
```
public boolean hasLines()
```
    Returns true if this section has a line number information, false otherwise. When true, SourceSection.getStartLine() and SourceSection.getEndLine() return valid line numbers, when false, SourceSection.getStartLine() and SourceSection.getEndLine() return 1.
    
    Since:
    
    19.0
  - hasColumns
```
public boolean hasColumns()
```
    Returns true if this section has a column number information, false otherwise. When true, SourceSection.hasLines() is true as well, SourceSection.getStartColumn() and SourceSection.getEndColumn() return valid column numbers. When false, SourceSection.getStartColumn() and SourceSection.getEndColumn() return 1.
    
    Since:
    
    19.0
  - hasCharIndex
```
public boolean hasCharIndex()
```
    Returns true if this section has a character index information, false otherwise. When true, SourceSection.getCharIndex(), SourceSection.getCharEndIndex() and SourceSection.getCharLength() return valid character indices, when false, SourceSection.getCharIndex(), SourceSection.getCharEndIndex() and SourceSection.getCharLength() return 0.
    
    Since:
    
    19.0
  - getSource
```
public Source getSource()
```
    Representation of the source program that contains this section.
    
    Returns:
    
    the source object.
    
    Since:
    
    19.0
  - getStartLine
```
public int getStartLine()
```
    Returns 1-based line number of the first character in this section (inclusive). Returns 1 for out of bounds or unavailable source sections, or source sections not having lines.
    
    Returns:
    
    the starting line number.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasLines()
  - getStartColumn
```
public int getStartColumn()
```
    Returns the 1-based column number of the first character in this section (inclusive). Returns 1 for out of bounds or unavailable source sections, or source sections not having columns.
    
    Returns:
    
    the starting column number.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasColumns()
  - getEndLine
```
public int getEndLine()
```
    Returns 1-based line number of the last character in this section (inclusive). Returns 1 for out of bounds or unavailable source sections, or source sections not having lines.
    
    Returns:
    
    the starting line number.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasLines()
  - getEndColumn
```
public int getEndColumn()
```
    Returns the 1-based column number of the last character in this section (inclusive). Returns 1 for out of bounds or unavailable source sections, or source sections not having columns.
    
    Returns:
    
    the starting column number.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasColumns()
  - getCharIndex
```
public int getCharIndex()
```
    Returns the 0-based index of the first character in this section. Returns 0 for unavailable source sections, or sections not having character index. The returned index might be out of bounds of the source code if assertions (-ea) are not enabled.
    
    Returns:
    
    the starting character index.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasCharIndex()
  - getCharLength
```
public int getCharLength()
```
    Returns the length of this section in characters. Returns 0 for unavailable source sections, or sections not having character index. The returned length might be out of bounds of the source code if assertions (-ea) are not enabled.
    
    Returns:
    
    the number of characters in the section.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasCharIndex()
  - getCharEndIndex
```
public int getCharEndIndex()
```
    Returns the index of the text position immediately following the last character in the section. Returns 0 for unavailable source sections, or sections not having character index. The returned index might be out of bounds of the source code if assertions (-ea) are not enabled.
    
    Returns:
    
    the end position of the section.
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.hasCharIndex()
  - getCharacters
```
public CharSequence getCharacters()
```
    Returns the source code fragment described by this section. Returns an empty string for out of bounds or unavailable source sections.
    
    Returns:
    
    the code as a string.
    
    Since:
    
    19.0
  - toString
```
public String toString()
```
    Returns an implementation-defined string representation of this source section to be used for debugging purposes only.
    
    Overrides:
    
    toString in class Object
    
    Since:
    
    19.0
    
    See Also:
    
    SourceSection.getCharacters()
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
    
    Since:
    
    19.0 or earlier
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
    
    Since:
    
    19.0 or earlier

Class SourceSection

Method Summary

Methods inherited from class java.lang.Object

Method Detail

isAvailable

hasLines

hasColumns

hasCharIndex

getSource

getStartLine

getStartColumn

getEndLine

getEndColumn

getCharIndex

getCharLength

getCharEndIndex

getCharacters

toString

hashCode

equals