method

chars

v1_8_7_330 - Show latest stable - 0 notes - Class: String

1_8_6_287
1_8_7_72 (0)
1_8_7_330 (0)
1_9_1_378 (-38)
1_9_2_180 (10)
1_9_3_125 (0)
1_9_3_392 (0)
2_1_10 (23)
2_2_9 (0)
2_4_6 (0)
2_5_5 (0)
2_6_3 (0)
What's this?

chars() public

Returns an enumerator that gives each character in the string. If a block is given, it iterates over each character in the string.

"foo".chars.to_a   #=> ["f","o","o"]

Show source

/*
 *  Document-method: each_char
 *  call-seq:
 *     str.each_char {|cstr| block }    => str
 *  
 *  Passes each character in <i>str</i> to the given block.
 *     
 *     "hello".each_char {|c| print c, ' ' }
 *     
 *  <em>produces:</em>
 *     
 *     h e l l o 
 */

static VALUE
rb_str_each_char(VALUE str)
{
    int i, len, n;
    const char *ptr;

    RETURN_ENUMERATOR(str, 0, 0);
    str = rb_str_new4(str);
    ptr = RSTRING(str)->ptr;
    len = RSTRING(str)->len;
    for (i = 0; i < len; i += n) {
        n = mbclen(ptr[i]);
        rb_yield(rb_str_substr(str, i, n));
    }
    return str;
}

chars

Related methods