Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ rewind(3s) — Ultrix/UWS 4.2 RISC

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

lseek(2)

fopen(3s)

fseek(3s)

Name

fseek, ftell, rewind − reposition a file pointer in a stream

Syntax

#include <stdio.h>

int fseek(stream, offset, ptrname)
FILE *stream;
long offset;
int ptrname;

long ftell(stream)
FILE *stream;

void rewind(stream)
FILE *stream;

Description

The fseek function sets the position of the next input or output operation on the stream. The new position is at the signed distance offset bytes from the beginning, the current position, or the end of the file, according as ptrname has the value SEEK_SET, SEEK_CUR, or SEEK_END. 

The fseek function undoes any effects of ungetc(.).

The ftell function returns the current value of the offset relative to the beginning of the file associated with the named stream. It is measured in bytes and is the only foolproof way to obtain an offset for fseek.

The rewind (stream) function is equivalent to fseek (stream , 0L, 0, SEEK_SET), except that no value is returned.

Return Values

The fseek function returns −1 for improper seeks, otherwise 0.

See Also

lseek(2), fopen(3s)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026