このマニュアルは既にメンテナンスが終了したバージョンの Ruby を対象としています。 最新版のマニュアルへ

Ruby 1.8.7 リファレンスマニュアル

instance method String#downcase

downcase -> String[permalink][rdoc]

'A' から 'Z' までのアルファベット大文字をすべて小文字に置き換えた新しい文字列を生成して返します。アルファベット大文字以外の文字はすべてそのまま保存されます。

このメソッドはマルチバイト文字列を認識しますが、それはあくまでも「1 文字を 1 文字として認識する」だけであって、いわゆる全角アルファベットの大文字小文字までは変換しません。

処理する文字列の文字コードが Shift JIS で、しかも $KCODE が適切に設定されていない場合、このメソッドはマルチバイト文字の一部も変換してしまう場合があります。逆に、$KCODE を適切に設定してもマルチバイト文字のアルファベットは処理できません。

例:

p "STRing?".downcase   # => "string?"

# -*- encoding: shift_jis -*-
$KCODE = 'n'
puts "帰".downcase   # => 蟻

[SEE_ALSO] String#downcase!, String#upcase, String#swapcase, String#capitalize