class REXML::Source
A Source
can be searched for patterns, and wraps buffers and other objects and provides consumption of text
Attributes
encoding[R]
line[R]
The line number of the last consumed text
Public Class Methods
new(arg, encoding=nil)
click to toggle source
Constructor @param arg must be a String, and should be a valid XML document @param encoding if non-null, sets the encoding of the source to this value, overriding all encoding detection
# File rexml-3.2.8/lib/rexml/source.rb, line 41 def initialize(arg, encoding=nil) @orig = arg @scanner = StringScanner.new(@orig) if encoding self.encoding = encoding else detect_encoding end @line = 0 end
Public Instance Methods
buffer()
click to toggle source
The current buffer (what we’re going to read next)
# File rexml-3.2.8/lib/rexml/source.rb, line 53 def buffer @scanner.rest end
buffer_encoding=(encoding)
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 57 def buffer_encoding=(encoding) @scanner.string.force_encoding(encoding) end
current_line()
click to toggle source
@return the current line in the source
# File rexml-3.2.8/lib/rexml/source.rb, line 100 def current_line lines = @orig.split res = lines.grep @scanner.rest[0..30] res = res[-1] if res.kind_of? Array lines.index( res ) if res end
empty?()
click to toggle source
@return true if the Source
is exhausted
# File rexml-3.2.8/lib/rexml/source.rb, line 95 def empty? @scanner.eos? end
encoding=(enc)
click to toggle source
Inherited from Encoding
Overridden to support optimized en/decoding
Calls superclass method
REXML::Encoding#encoding=
# File rexml-3.2.8/lib/rexml/source.rb, line 63 def encoding=(enc) return unless super encoding_updated end
ensure_buffer()
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 75 def ensure_buffer end
match(pattern, cons=false)
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 78 def match(pattern, cons=false) if cons @scanner.scan(pattern).nil? ? nil : @scanner else @scanner.check(pattern).nil? ? nil : @scanner end end
position()
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 86 def position @scanner.pos end
position=(pos)
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 90 def position=(pos) @scanner.pos = pos end
read(term = nil)
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 68 def read(term = nil) end
read_until(term)
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 71 def read_until(term) @scanner.scan_until(Regexp.union(term)) or @scanner.rest end
Private Instance Methods
detect_encoding()
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 109 def detect_encoding scanner_encoding = @scanner.rest.encoding detected_encoding = "UTF-8" begin @scanner.string.force_encoding("ASCII-8BIT") if @scanner.scan(/\xfe\xff/n) detected_encoding = "UTF-16BE" elsif @scanner.scan(/\xff\xfe/n) detected_encoding = "UTF-16LE" elsif @scanner.scan(/\xef\xbb\xbf/n) detected_encoding = "UTF-8" end ensure @scanner.string.force_encoding(scanner_encoding) end self.encoding = detected_encoding end
encoding_updated()
click to toggle source
# File rexml-3.2.8/lib/rexml/source.rb, line 127 def encoding_updated if @encoding != 'UTF-8' @scanner.string = decode(@scanner.rest) @to_utf = true else @to_utf = false @scanner.string.force_encoding(::Encoding::UTF_8) end end