FileInputByteStreamRef::cur_pos

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
std::uint64_t cur_pos() const; //1
void cur_pos(std::uint64_t cbNewPos); //2
void cur_pos(/*специальная позиция*/); //3

Возвращает или устанавливает связанный с потоком файловый указатель.

  1. Возвращает текущее значение связанного с потоком файлового указателя в виде байтового сдвига относительно начала файла.
  2. Задает абсолютное значение файлового указателя заданным параметрически байтовым сдвигом относительно начала файла.
  3. Перемещает связанный с потоком файловый указатель в начало или конец файла. Тип параметра не специфицирован. Если file_is - поток FileInputByteStreamRef, то вызов file_is.cur_pos(FileInputByteStreamRef::begin_pos); устанавливает поток в начальную позицию (аналогично вызову перегрузки 2: file_is.cur_pos(0);), а вызов file_is.cur_pos(FileInputByteStreamRef::end_pos); - в конечную.
Параметры
cbNewPosСмещение относительно начала файла, над которым определен поток this, задающее абсолютным образом позицию файлового указателя.
Возвращаемое значение:
Перегрузка 1 возвращает текущее значение файлового указателя, связанного с потоком this, в виде сдвига относительно начала файла.