class Enumerator::Chain

Enumerator::Chain ist eine Unterklasse von Enumerator, die eine Kette von Enumerable-Objekten darstellt, die als einzelner Enumerator fungiert.

Diese Art von Objekten kann durch Enumerable#chain und Enumerator#+ erstellt werden.

Öffentliche Klassenmethoden

Enumerator::Chain.new(*enums) → enum

Source

static VALUE
enum_chain_initialize(VALUE obj, VALUE enums)
{
    struct enum_chain *ptr;

    rb_check_frozen(obj);
    TypedData_Get_Struct(obj, struct enum_chain, &enum_chain_data_type, ptr);

    if (!ptr) rb_raise(rb_eArgError, "unallocated chain");

    RB_OBJ_WRITE(obj, &ptr->enums, rb_ary_freeze(enums));
    ptr->pos = -1;

    return obj;
}

Erzeugt ein neues Enumerator-Objekt, das nacheinander über die Elemente der angegebenen Enumerable-Objekte iteriert.

e = Enumerator::Chain.new(1..3, [4, 5])
e.to_a #=> [1, 2, 3, 4, 5]
e.size #=> 5

Öffentliche Instanzmethoden

each(*args) { |...| ... } → obj

each(*args) → enumerator

Source

static VALUE
enum_chain_each(int argc, VALUE *argv, VALUE obj)
{
    VALUE enums, block;
    struct enum_chain *objptr;
    long i;

    RETURN_SIZED_ENUMERATOR(obj, argc, argv, argc > 0 ? enum_chain_enum_no_size : enum_chain_enum_size);

    objptr = enum_chain_ptr(obj);
    enums = objptr->enums;
    block = rb_block_proc();

    for (i = 0; i < RARRAY_LEN(enums); i++) {
        objptr->pos = i;
        rb_funcall_with_block(RARRAY_AREF(enums, i), id_each, argc, argv, block);
    }

    return obj;
}

Iteriert über die Elemente des ersten Enumerable-Objekts, indem die "each"-Methode mit den angegebenen Argumenten aufgerufen wird, und geht dann nacheinander zu den folgenden Enumerable-Objekten über, bis alle Enumerable-Objekte erschöpft sind.

Wenn kein Block angegeben wird, wird ein Enumerator zurückgegeben.

inspect → String

Source

static VALUE
enum_chain_inspect(VALUE obj)
{
    return rb_exec_recursive(inspect_enum_chain, obj, 0);
}

Gibt eine druckbare Version der Enumerator-Kette zurück.

rewind → obj

Source

static VALUE
enum_chain_rewind(VALUE obj)
{
    struct enum_chain *objptr = enum_chain_ptr(obj);
    VALUE enums = objptr->enums;
    long i;

    for (i = objptr->pos; 0 <= i && i < RARRAY_LEN(enums); objptr->pos = --i) {
        rb_check_funcall(RARRAY_AREF(enums, i), id_rewind, 0, 0);
    }

    return obj;
}

Setzt die Enumerator-Kette zurück, indem die "rewind"-Methode für jedes Enumerable-Objekt in umgekehrter Reihenfolge aufgerufen wird. Jeder Aufruf wird nur durchgeführt, wenn das Enumerable-Objekt die Methode unterstützt.

size → int, Float::INFINITY oder nil

Source

static VALUE
enum_chain_size(VALUE obj)
{
    return enum_chain_total_size(enum_chain_ptr(obj)->enums);
}

Gibt die Gesamtgröße der Enumerator-Kette zurück, die durch Aufsummieren der Größen jedes Enumerable-Objekts in der Kette berechnet wird. Wenn eines der Enumerable-Objekte seine Größe als nil oder Float::INFINITY meldet, wird dieser Wert als Gesamtgröße zurückgegeben.