【Ruby3.x】CSV::pos=()メソッドの使い方
pos=メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
メソッドは、CSVファイルの読み書きを行うCSVオブジェクトにおいて、現在のファイルポインタの位置（次に読み書きを開始するバイト位置）を設定するメソッドです。
このメソッドを使用することで、CSVデータ内の任意の場所へ移動し、そこから読み込みや書き込みを再開することができます。例えば、非常に大きなCSVファイルを処理する際に、途中で処理を中断した後に特定のバイトオフセットからデータの読み込みを再開したい場合や、ファイル内の特定のセクションに直接アクセスしたい場合に役立ちます。
pos=メソッドは、新しいファイルポインタの位置を示す整数値を引数として受け取ります。この整数値は、ファイルの先頭からのバイトオフセットを表します。指定された位置に移動すると、次にCSVオブジェクトのread、shift、eachなどの読み込みメソッドが呼び出された際には、その新しい位置からデータが読み込まれます。同様に、addや<<などの書き込みメソッドも、指定された位置から書き込みを開始します。
注意点として、この位置はCSVの行番号ではなく、ファイルの内容のバイト単位で指定される点があります。そのため、日本語などのマルチバイト文字を含むCSVファイルを扱う際は、文字数とバイト数が異なることに留意してください。このメソッドは、通常、現在の位置を取得するposメソッドや、ファイルポインタをファイルの先頭に戻すrewindメソッドと組み合わせて使用されることが多いです。
構文(syntax)
1require 'csv' 2 3csv_object = CSV.new("sample,data\n1,2") 4csv_object.pos = 0
引数(parameters)
n
- n: 現在のCSV読み込み位置を示す整数
戻り値(return)
Integer
CSV#pos= メソッドは、CSV リーダーの現在の位置を整数で返します。