class method

Encoding.find

(::encoding enc) -> ::Encoding?

Encoding.find(string) → enc

static VALUE
enc_find(VALUE klass, VALUE enc)
{
    int idx;
    if (is_obj_encoding(enc))
        return enc;
    idx = str_to_encindex(enc);
    if (idx == UNSPECIFIED_ENCODING) return Qnil;
    return rb_enc_from_encoding_index(idx);
}

Search the encoding with specified name. name should be a string.

Example

Encoding.find("US-ASCII")  #=> #<Encoding:US-ASCII>

Names which this method accept are encoding names and aliases including following special aliases

“external”: default external encoding
“internal”: default internal encoding
“locale”: locale encoding
“filesystem”: filesystem encoding

An ArgumentError is raised when no encoding with name. Only Encoding.find("internal") however returns nil when no encoding named “internal”, in other words, when Ruby has no default internal encoding.

See also .default_internal= .list .default_internal .locale_charmap also in 4.1 · 3.4 · 3.3 · 3.2 · 3.1 · 3.0

‹ prev.default_internal= next ›.list