模块 IO::generic_readable - Ruby 3.3 文档

getch(min: nil, time: nil, intr: nil) → char 点击切换源代码

参见 IO#getch。

static VALUE
io_getch(int argc, VALUE *argv, VALUE io)
{
    return rb_funcallv(io, id_getc, argc, argv);
}

getpass(prompt=nil) → string 点击切换源代码

参见 IO#getpass。

static VALUE
io_getpass(int argc, VALUE *argv, VALUE io)
{
    VALUE str;

    rb_check_arity(argc, 0, 1);
    prompt(argc, argv, io);
    rb_check_funcall(io, id_flush, 0, 0);
    str = rb_ensure(gets_call, io, puts_call, io);
    return str_chomp(str);
}

read_nonblock(integer[, outbuf [, opts]]) → string 点击切换源代码

类似于 read，但除非传入 +exception: false+ 选项，否则在字符串末尾引发 EOFError。

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 点击切换源代码

类似于 getbyte，但如果已处于流末尾，则引发异常；参见字节 IO。

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 点击切换源代码

类似于 getc，但如果已处于流末尾，则引发异常；参见字符 IO。

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

使用 IO#gets 读取一行，但如果已处于文件末尾，则引发 EOFError；参见行 IO。

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;
}

readpartial(integer[, outbuf]) → string

类似于 read，但会在字符串末尾引发 EOFError，而不是返回 nil，就像 IO#sysread 所做的那样。

别名：sysread

sysread(integer[, outbuf]) → string 点击切换源代码

类似于 read，但会在字符串末尾引发 EOFError，而不是返回 nil，就像 IO#sysread 所做的那样。

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;
}

也别名为：readpartial