class Prism::Location

This represents a location in the source.

Attributes

length [R] Integer

The length of this location in bytes.

source [R] Source

A Source object that is used to determine more information from the given offset and length.

start_offset [R] Integer

The byte offset from the beginning of the source where this location starts.

Public Class Methods

new (source, start_offset, length)

(Source source, Integer start_offset, Integer length) → void

Source

# File lib/prism/parse_result.rb, line 453
def initialize(source, start_offset, length)
  @source = source
  @start_offset = start_offset
  @length = length
end

Create a new location object with the given source, start byte offset, and byte length.

Public Instance Methods

== (other)

(untyped other) → bool

Source

# File lib/prism/parse_result.rb, line 661
def ==(other)
  Location === other &&
    other.start_offset == start_offset &&
    other.end_offset == end_offset
end

Returns true if the given other location is equal to this location.

adjoin (string)

(String string) → Location

Source

# File lib/prism/parse_result.rb, line 684
def adjoin(string)
  line_suffix = source.slice(end_offset, source.line_end(end_offset) - end_offset)

  line_suffix_index = line_suffix.byteindex(string)
  raise "Could not find #{string}" if line_suffix_index.nil?

  Location.new(source, start_offset, length + line_suffix_index + string.bytesize)
end

Join this location with the first occurrence of the string in the source that occurs after this location on the same line, and return the new location. This will raise an error if the string does not exist.

cached_end_code_units_column (cache)

(_CodeUnitsCache cache) → Integer

Source

# File lib/prism/parse_result.rb, line 640
def cached_end_code_units_column(cache)
  cache[end_offset] - cache[source.line_start(end_offset)]
end

The end column in code units using the given cache to fetch or calculate the value.

cached_end_code_units_offset (cache)

(_CodeUnitsCache cache) → Integer

Source

# File lib/prism/parse_result.rb, line 554
def cached_end_code_units_offset(cache)
  cache[end_offset]
end

The end offset from the start of the file in code units using the given cache to fetch or calculate the value.

cached_start_code_units_column (cache)

(_CodeUnitsCache cache) → Integer

Source

# File lib/prism/parse_result.rb, line 608
def cached_start_code_units_column(cache)
  cache[start_offset] - cache[source.line_start(start_offset)]
end

The start column in code units using the given cache to fetch or calculate the value.

cached_start_code_units_offset (cache)

(_CodeUnitsCache cache) → Integer

Source

# File lib/prism/parse_result.rb, line 524
def cached_start_code_units_offset(cache)
  cache[start_offset]
end

The start offset from the start of the file in code units using the given cache to fetch or calculate the value.

chop ()

() → Location

Source

# File lib/prism/parse_result.rb, line 469
def chop
  copy(length: length == 0 ? length : length - 1)
end

Returns a new location that is the result of chopping off the last byte.

copy (source: self.source, start_offset: self.start_offset, length: self.length)

(?source: Source, ?start_offset: Integer, ?length: Integer) → Location

Source

# File lib/prism/parse_result.rb, line 462
def copy(source: self.source, start_offset: self.start_offset, length: self.length)
  Location.new(source, start_offset, length)
end

Create a new location object with the given options.

end_character_column ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 624
def end_character_column
  source.character_column(end_offset)
end

The column in characters where this location ends from the start of the line.

end_character_offset ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 539
def end_character_offset
  source.character_offset(end_offset)
end

The character offset from the beginning of the source where this location ends.

end_code_units_column (encoding = Encoding::UTF_16LE)

(?Encoding encoding) → Integer

Source

# File lib/prism/parse_result.rb, line 632
def end_code_units_column(encoding = Encoding::UTF_16LE)
  source.code_units_column(end_offset, encoding)
end

The column in code units of the given encoding where this location ends from the start of the line.

end_code_units_offset (encoding = Encoding::UTF_16LE)

(Encoding encoding) → Integer

Source

# File lib/prism/parse_result.rb, line 546
def end_code_units_offset(encoding = Encoding::UTF_16LE)
  source.code_units_offset(end_offset, encoding)
end

The offset from the start of the file in code units of the given encoding.

end_column ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 616
def end_column
  source.column(end_offset)
end

The column in bytes where this location ends from the start of the line.

end_line ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 576
def end_line
  source.line(end_offset)
end

The line number where this location ends.

end_offset ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 531
def end_offset
  start_offset + length
end

The byte offset from the beginning of the source where this location ends.

join (other)

(Location other) → Location

Source

# File lib/prism/parse_result.rb, line 672
def join(other)
  raise "Incompatible sources" if source != other.source
  raise "Incompatible locations" if start_offset > other.start_offset

  Location.new(source, start_offset, other.end_offset - start_offset)
end

Returns a new location that stretches from this location to the given other location. Raises an error if this location is not before the other location or if they don’t share the same source.

slice ()

() → String

Source

# File lib/prism/parse_result.rb, line 490
def slice
  source.slice(start_offset, length)
end

The source code that this location represents.

slice_lines ()

() → String

Source

# File lib/prism/parse_result.rb, line 499
def slice_lines
  line_start = source.line_start(start_offset)
  line_end = source.line_end(end_offset)
  source.slice(line_start, line_end - line_start)
end

The source code that this location represents starting from the beginning of the line that this location starts on to the end of the line that this location ends on.

source_lines ()

() → Array[String]

Source

# File lib/prism/parse_result.rb, line 483
def source_lines
  source.lines
end

Returns all of the lines of the source code associated with this location.

start_character_column ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 592
def start_character_column
  source.character_column(start_offset)
end

The column in characters where this location ends from the start of the line.

start_character_offset ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 509
def start_character_offset
  source.character_offset(start_offset)
end

The character offset from the beginning of the source where this location starts.

start_code_units_column (encoding = Encoding::UTF_16LE)

(?Encoding encoding) → Integer

Source

# File lib/prism/parse_result.rb, line 600
def start_code_units_column(encoding = Encoding::UTF_16LE)
  source.code_units_column(start_offset, encoding)
end

The column in code units of the given encoding where this location starts from the start of the line.

start_code_units_offset (encoding = Encoding::UTF_16LE)

(Encoding encoding) → Integer

Source

# File lib/prism/parse_result.rb, line 516
def start_code_units_offset(encoding = Encoding::UTF_16LE)
  source.code_units_offset(start_offset, encoding)
end

The offset from the start of the file in code units of the given encoding.

start_column ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 584
def start_column
  source.column(start_offset)
end

The column in bytes where this location starts from the start of the line.

start_line ()

() → Integer

Source

# File lib/prism/parse_result.rb, line 561
def start_line
  source.line(start_offset)
end

The line number where this location starts.

start_line_slice ()

() → String

Source

# File lib/prism/parse_result.rb, line 568
def start_line_slice
  offset = source.line_start(start_offset)
  source.slice(offset, start_offset - offset)
end

The content of the line where this location starts before this location.