【Ruby3.x】StringIO::putc()メソッドの使い方
putcメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
putcメソッドは、StringIOオブジェクトが保持する内部の文字列バッファに、指定された1文字を書き込む処理を実行するメソッドです。
StringIOクラスは、メモリ上でファイルのように読み書きできる仮想的な文字列バッファを提供します。このputcメソッドは、そのバッファの現在の書き込み位置に、引数で渡された1文字を追加します。
引数には、書き込みたい文字を直接文字列として渡すことができます。例えば、"A"という文字列を渡すと、'A'がバッファに書き込まれます。この際、引数が複数の文字を含む文字列であったとしても、メソッドは常にその文字列の最初の1文字のみを書き込みます。例えば、"Hello"を渡した場合でも、書き込まれるのは'H'だけです。
また、文字のUnicodeコードポイントやバイト値に対応する整数を引数として渡すことも可能です。この場合、指定された整数値が文字コードとして解釈され、対応する文字がバッファに書き込まれます。
putcメソッドは、書き込みが成功した場合に、書き込まれた文字（引数が文字列の場合はその最初の文字、引数が整数の場合はその整数値）を返します。
このメソッドは、一時的に文字列データを構築したり、特定の文字を一つずつ追記しながら文字列を作成したりする際に有用です。StringIOオブジェクトにputcメソッドで文字を順次書き込み、最終的にstringメソッドを用いてバッファに蓄積された全ての文字列を一括で取得する、といった使い方ができます。これにより、ファイルI/Oのテストや、メモリ上で完結するデータ処理を効率的に行えます。
構文(syntax)
1require 'stringio' 2 3sio = StringIO.new 4sio.putc 'A'
引数(parameters)
req
- char: 文字列の最初の1文字。または、単一の文字を表す文字列。
戻り値(return)
String | Integer
StringIO#putc は、渡された文字または整数をStringIOオブジェクトに書き込み、その文字または整数の値を返します。