Class: Async::IO::Protocol::Line

Inherits:
Generic
  • Object
show all
Defined in:
lib/async/io/protocol/line.rb

Constant Summary

Constants inherited from Generic

Generic::WRAPPERS

Instance Attribute Summary collapse

Attributes inherited from Generic

#timeout

Instance Method Summary collapse

Methods inherited from Generic

#<<, #connected?, #dup, #nonblock, #nonblock=, #nonblock?, #read, #sysread, #syswrite, #wait, wrap, wrap_blocking_method, wraps, #write

Constructor Details

#initialize(stream, eol = $/) ⇒ Line

Returns a new instance of Line.



29
30
31
32
33
 
# File 'lib/async/io/protocol/line.rb', line 29

def initialize(stream, eol = $/)
  super(stream)
  
  @eol = eol
end

Instance Attribute Details

#eol ⇒ Object (readonly)

Returns the value of attribute eol.



35
36
37
 
# File 'lib/async/io/protocol/line.rb', line 35

def eol
  @eol
end

Instance Method Details

#each_line ⇒ Object 



64
65
66
67
68
69
70
 
# File 'lib/async/io/protocol/line.rb', line 64

def each_line
  return to_enum(:each_line) unless block_given?
  
  while line = @stream.read_until(@eol)
    yield line
  end
end

#peek_line ⇒ Object

Raises:

  • (EOFError) 


54
55
56
57
58
59
60
61
62
 
# File 'lib/async/io/protocol/line.rb', line 54

def peek_line
  @stream.peek do |read_buffer|
    if index = read_buffer.index(@eol)
      return read_buffer.slice(0, index)
    end
  end
  
  raise EOFError
end

#read_line ⇒ Object 



50
51
52
 
# File 'lib/async/io/protocol/line.rb', line 50

def read_line
  @stream.read_until(@eol) or @stream.eof!
end

#read_lines ⇒ Object 



72
73
74
 
# File 'lib/async/io/protocol/line.rb', line 72

def read_lines
  @stream.read.split(@eol)
end

#write_lines(*args) ⇒ Object 



37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/async/io/protocol/line.rb', line 37

def write_lines(*args)
  if args.empty?
    @stream.write(@eol)
  else
    args.each do |arg|
      @stream.write(arg)
      @stream.write(@eol)
    end
  end
  
  @stream.flush
end