123456789_123456789_123456789_123456789_123456789_

Module: IO::generic_readable

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
::StringIO
Defined in: ext/stringio/stringio.c

Instance Method Summary

Instance Method Details

#read_nonblock(integer[, outbuf [, opts]]) ⇒ String

Similar to #read, but raises EOFError at end of string unless the exception: false option is passed in.

[ GitHub ] 

  


# File 'ext/stringio/stringio.c', line 1708



static VALUE
strio_read_nonblock(int argc, VALUE *argv, VALUE self)
{
    VALUE opts = Qnil, val;

    rb_scan_args(argc, argv, "11:", NULL, NULL, &opts);

    if (!NIL_P(opts)) {
	argc--;
    }

    val = strio_read(argc, argv, self);
    if (NIL_P(val)) {
	if (!NIL_P(opts) &&
	      rb_hash_lookup2(opts, sym_exception, Qundef) == Qfalse)
	    return Qnil;
	else
	    rb_eof_error();
    }

    return val;
}


  








  

    #readbyte  ⇒ byte   



  

    

Like getbyte, but raises an exception if already at end-of-stream; see Byte IO.


  



  [ GitHub ]


  

  


# File 'ext/stringio/stringio.c', line 1068



static VALUE
strio_readbyte(VALUE self)
{
    VALUE c = rb_funcallv(self, rb_intern("getbyte"), 0, 0);
    if (NIL_P(c)) rb_eof_error();
    return c;
}


  








  

    #readchar  ⇒ String   



  

    

Like getc, but raises an exception if already at end-of-stream; see Character IO.


  



  [ GitHub ]


  

  


# File 'ext/stringio/stringio.c', line 1053



static VALUE
strio_readchar(VALUE self)
{
    VALUE c = rb_funcallv(self, rb_intern("getc"), 0, 0);
    if (NIL_P(c)) rb_eof_error();
    return c;
}


  








  

    

      #readline(sep = $/, chomp: false)  ⇒ String 
      #readline(limit, chomp: false)  ⇒ String 
      #readline(sep, limit, chomp: false)  ⇒ String 
    

  



  

    

Reads a line as with IO#gets, but raises EOFError if already at end-of-file; see Line IO.


  





  


  [ GitHub ]


  

  


# File 'ext/stringio/stringio.c', line 1369



static VALUE
strio_readline(int argc, VALUE *argv, VALUE self)
{
    VALUE line = rb_funcallv_kw(self, rb_intern("gets"), argc, argv, RB_PASS_CALLED_KEYWORDS);
    if (NIL_P(line)) rb_eof_error();
    return line;
}


  








  

    

      #sysread(integer[, outbuf])  ⇒ String 
      #readpartial(integer[, outbuf])  ⇒ String 
    

  



  

    

Alias for #sysread.


  





  








  

    

      #sysread(integer[, outbuf])  ⇒ String 
      #readpartial(integer[, outbuf])  ⇒ String 
    

    Also known as: #readpartial
  



  

    

Similar to #read, but raises EOFError at end of string instead of returning nil, as well as IO#sysread does.


  





  


  [ GitHub ]


  

  


# File 'ext/stringio/stringio.c', line 1691



static VALUE
strio_sysread(int argc, VALUE *argv, VALUE self)
{
    VALUE val = rb_funcallv_kw(self, rb_intern("read"), argc, argv, RB_PASS_CALLED_KEYWORDS);
    if (NIL_P(val)) {
	rb_eof_error();
    }
    return val;
}