instance method Integer#chr

self を文字コードとして見た時に、引数で与えたエンコーディング encoding に対応する文字を返します。

p 65.chr
# => "A"
p 12354.chr
# => 'chr': 12354 out of char range (RangeError)

p 12354.chr(Encoding::UTF_8)
# => "あ"
12354.chr(Encoding::EUC_JP)
# ~> RangeError: invalid codepoint 0x3042 in EUC-JP

引数無しで呼ばれた場合は self を US-ASCII、ASCII-8BIT、デフォルト内部エンコーディングの順で優先的に解釈します。

p 0x79.chr.encoding # => #<Encoding:US_ASCII>
p 0x80.chr.encoding # => #<Encoding:ASCII_8BIT>

[PARAM] encoding:

エンコーディングを表すオブジェクト。Encoding::UTF_8、"shift_jis" など。

[RETURN]

一文字からなる文字列

[EXCEPTION] RangeError:

self を与えられたエンコーディングで正しく解釈できない場合に発生します。

[SEE_ALSO] String#ord Encoding.default_internal