aboutsummaryrefslogtreecommitdiff
path: root/doc/language/cpsc-function-eof.7.md
blob: 721e667c4c654591b7d5774553a07dc8fa798d5c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

% CPSC-FUNCTION-EOF(7)

# NAME

cpsc-function-eof - test for the end of a text file

# SYNOPSIS

```text
EOF(filename : STRING) RETURNS BOOLEAN
```

# DESCRIPTION

Return true when no further characters remain in a file opened FOR READ.
The test does not consume the next character. Testing an unopened file or
a file in the wrong mode terminates execution.

# EXAMPLE

```text
DECLARE Line : STRING
OPENFILE "notes.txt" FOR READ
WHILE NOT EOF("notes.txt") DO
    READFILE "notes.txt", Line
    OUTPUT Line
ENDWHILE
CLOSEFILE "notes.txt"
```

# SEE ALSO

[cpsc-language-overview(7)](cpsc-language-overview.7.md), [cpsc-keyword-openfile(7)](cpsc-keyword-openfile.7.md), [cpsc-keyword-readfile(7)](cpsc-keyword-readfile.7.md), [cpsc-keyword-closefile(7)](cpsc-keyword-closefile.7.md).