This represents a source of Ruby code that has been parsed. It is used in conjunction with locations to allow them to resolve line numbers and source ranges.
The source code that this source object represents.
The line number where this source starts.
The list of newline byte offsets in the source code.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 12
def self.for(source, start_line = 1, offsets = [])
source.ascii_only? ? ASCIISource.new(source, start_line, offsets): new(source, start_line, offsets)
end
Create a new source object with the given source code. This method should be used instead of ‘new` and it will return either a `Source` or a specialized and more performant `ASCIISource` if no multibyte characters are present in the source code.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 26
def initialize(source, start_line = 1, offsets = [])
@source = source
@start_line = start_line # set after parsing is done
@offsets = offsets # set after parsing is done
end
Create a new source object with the given source code.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 78
def character_column(byte_offset)
character_offset(byte_offset) - character_offset(line_start(byte_offset))
end
Return the column number in characters for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 73
def character_offset(byte_offset)
(source.byteslice(0, byte_offset) or raise).length
end
Return the character offset for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 95
def code_units_column(byte_offset, encoding)
code_units_offset(byte_offset, encoding) - code_units_offset(line_start(byte_offset), encoding)
end
Returns the column number in code units for the given encoding for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 88
def code_units_offset(byte_offset, encoding)
byteslice = (source.byteslice(0, byte_offset) or raise).encode(encoding)
(encoding == Encoding::UTF_16LE || encoding == Encoding::UTF_16BE) ? (byteslice.bytesize / 2) : byteslice.length
end
Returns the offset from the start of the file for the given byte offset counting in code units for the given encoding.
This method is tested with UTF-8, UTF-16, and UTF-32. If there is the concept of code units that differs from the number of characters in other encodings, it is not captured here.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 68
def column(byte_offset)
byte_offset - line_start(byte_offset)
end
Return the column number for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 34
def encoding
source.encoding
end
Returns the encoding of the source code, which is set by parameters to the parser or by the encoding magic comment.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 103
def find_line(byte_offset)
left = 0
right = offsets.length - 1
while left <= right
mid = left + (right - left) / 2
return mid if (offset = offsets[mid]) == byte_offset
if offset < byte_offset
left = mid + 1
else
right = mid - 1
end
end
left - 1
end
Binary search through the offsets to find the line number for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 51
def line(byte_offset)
start_line + find_line(byte_offset)
end
Binary search through the offsets to find the line number for the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 63
def line_end(byte_offset)
offsets[find_line(byte_offset) + 1] || source.bytesize
end
Returns the byte offset of the end of the line corresponding to the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 57
def line_start(byte_offset)
offsets[find_line(byte_offset)]
end
Return the byte offset of the start of the line corresponding to the given byte offset.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 39
def lines
source.lines
end
Returns the lines of the source code as an array of strings.
# File tmp/rubies/ruby-3.4.0-preview1/lib/prism/parse_result.rb, line 45
def slice(byte_offset, length)
source.byteslice(byte_offset, length) or raise
end
Perform a byteslice on the source code using the given byte offset and byte length.