Seeking

Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.
移動機能は、デコードを開始/再開するストリーム内の特定の位置を設定する機能を提供する。

All libvorbisfile seeking routines are declared in "vorbis/vorbisfile.h".
libvorbisのすべての移動ルーティンは"vorbis/vorbisfile.h"で定義されている。

Certain seeking functions are best suited to different situations. When speed is important and exact positioning isn't required, page-level seeking should be used. Note also that Vorbis files do not necessarily start at a sample number or time offset of zero. Do not be surprised if a file begins at a positive offset of several minutes or hours, such as would happen if a large stream (such as a concert recording) is chopped into multiple separate files. Requesting to seek to a position before the beginning of such a file will seek to the position where audio begins.
移動関数は目的別に最良のものがある。 もしスピードが重要で、正確な位置指定が要求されないなら、ページレベルの移動を使うべきだ。 Vorbisファイルはサンプル番号や時間が０で始まっていないかもしれないことにも注意。 もしファイルが何分、何時間という正の位置から始まっていても驚くな。 こんなことは（コンサートの録音データのように）大きなストリームが複数のファイルに分割されているときなどに起こり得る。 もしそのファイルの開始位置より前に移動することを要求した場合、音声が始まる位置に移動するだろう。

function	purpose
ov_raw_seek	This function seeks to a position specified in the compressed bitstream, specified in bytes. この関数は圧縮されたビットストリーム内の特定の位置にバイト単位で移動する。
ov_pcm_seek	This function seeks to a specific audio sample number, specified in pcm samples. この関数は音声のサンプル番号で特定する位置に移動する。
ov_pcm_seek_page	This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples. この関数は音声のサンプル番号で特定する位置に先行する最も近いページに移動する。
ov_time_seek	This function seeks to the specific time location in the bitstream, specified in seconds この関数は時間で特定される位置に、秒で指定して移動する。
ov_time_seek_page	This function seeks to the closest page preceding the specified time position in the bitstream この関数は時間で特定された位置に先行する最も近いページに移動する。