fSeek (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

Constants for the external files

Functions for handling directories and external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fInsertTextAtBeginning

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

Managing errors
Current position

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Functions for handling directories and external files

fSeek (Function)

In french: fPositionne

Returns and modifies the current position in an external file.

When opening a file, the current position corresponds to:

the first file byte,
the last file byte if the file is opened in "addition" mode (foAdd constant).

Using the read functions (fRead, fReadLine) and the write functions (fWrite, fWriteLine) modifies the current position.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for Windows Phone applications.

New in version 16

This function is now available for Windows Phone applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

// Open an external file
FileID = fOpen("C:\MyDirectories\File.txt", foReadWrite)
IF FileID <> -1 THEN
...
// Get the current position
ResPosition = fSeek(FileID, 0, fpCurrent)
...
END

Syntax

<Result> = fSeek(<File identifier> , <Move> , <Source position>)

<Result>: Integer

Current position after modification,
-1 if an error occurred. To get the details of the error, use ErrorInfo with the errMessage constant.
This parameter must be a variant.

<File identifier>: Integer

Identifier of the file to use, defined by fOpen or fCreate.

<Move>: Integer

Number of bytes (characters) corresponding to the requested move in the file. When the move is performed from the end of the file (fpEnd constant), this number must be negative.

<Source position>: Constant

Specifies the source position:
fpCurrent The source position corresponds to the current position.
fpBeginning The source position corresponds to the first file byte (position 0).
fpEnd The source position corresponds to the last file byte.

Remarks

Managing errors

fSeek throws an error in the following cases:

the file is not opened,
the file is locked by another computer or by another application.

Current position

To retrieve the current position in the external file, use the following syntax:

CurrentPosition = fSeek(FileID, 0, fpCurrent)

No move is performed in the specified file.

Component: wd270std.dll