Functions and CALL Routines

REWIND Function

Positions the data set pointer at the beginning of a SAS data set.

Category:

SAS File I/O

Syntax
Arguments
Details
Examples
See Also

Syntax

REWIND(data-set-id)

Arguments

data-set-id

is a numeric variable that specifies the data set identifier that the OPEN function returns.

Restriction:

The data set cannot be opened in IS mode.

Details

REWIND returns 0 if the operation was successful, [ne] 0 if it was not successful. After a call to REWIND, a call to FETCH reads the first observation in the data set.

If there is an active WHERE clause, REWIND moves the data set pointer to the first observation that satisfies the WHERE condition.

Examples

This example calls FETCHOBS to fetch the tenth observation in the data set MYDATA. Next, the example calls REWIND to return to the first observation and fetch the first observation.

%let dsid=%sysfunc(open(mydata,i));
%let rc=%sysfunc(fetchobs(&dsid,10));
%let rc=%sysfunc(rewind(&dsid));
%let rc=%sysfunc(fetch(&dsid));