method

to_enum

v1_9_2_180 - Show latest stable - Class: Object

to_enum(*args)

public

Returns Enumerator.new(self, method, *args).

e.g.:

str = "xyz"

enum = str.enum_for(:each_byte)
a = enum.map {|b| '%02x' % b } #=> ["78", "79", "7a"]

# protects an array from being modified
a = [1, 2, 3]
some_method(a.to_enum)

static VALUE
obj_to_enum(int argc, VALUE *argv, VALUE obj)
{
    VALUE meth = sym_each;

    if (argc > 0) {
        --argc;
        meth = *argv++;
    }
    return rb_enumeratorize(obj, meth, argc, argv);
}

2Notes

Needs requiring 'enumerator' to work

yonosoytu · Aug 23, 20082 thanks

This method needs that you

require 'enumerator'

for this method to be available.

now they are built-in

flamingo · Jul 30, 2011

in ruby 1.9 and afterwards, the to_enum and enum_for(synonym for to_enum) methods are buil-in to the language. so there's no need to require that any more.

to_enum

2Notes

Needs requiring 'enumerator' to work

now they are built-in

Related methods