INCLUDEUnder review

FileIO.ch

#Include "FileIO.ch"

Defines opening, sharing and seeking modes used by low-level file functions.

IncludesFilesHistorical referenceCompilation

01 · OVERVIEW

Overview

Defines opening, sharing and seeking modes used by low-level file functions. Symbols highlighted by the historical file include: F_ERROR; FS_SET; FS_RELATIVE; FS_END; FO_READ; FO_WRITE; FO_READWRITE. Confirm names, availability and behavior against the official include package for the target environment.

02 · SYNTAX

Syntax

#Include "FileIO.ch"

Parameters

FileIO.ch

.ch fileOptional

Compile-time include; whether it is required depends on the symbols used by the source.

Return value

An include has no runtime return value. Its directives are processed during compilation.

03 · PRACTICAL EXAMPLE

Minimal include for study

#Include "FileIO.ch"

User Function ExFileio()
    // Use only symbols documented for the target release.
Return

Expected result

The preprocessor makes definitions from the configured include path available.

BEST PRACTICES

Include it only when the source depends on one of its symbols.
Use includes matching the environment and LIB version.
Search the current package before treating a historical symbol as valid.
Prefer current official documentation for supported APIs.

COMMON PITFALLS

The analyzed file is historical.
Copying an old include can create LIB or RPO incompatibilities.
A declared directive does not prove that its related API is still supported.