Click above to get retro games delivered to your door ever month!

FILESCREEN()

Syntax:     FILESCREEN(<expC>[,<expN>])

Arguments:  <expC> denotes the name and path of the screenfile.
            <expN> corresponds to the offset within the file from which
            to read (default: start of the file).

Returns:    A numeric value.
            The number of bytes is returned.

Usage:      FILESCREEN() is the opposite of SCREENFILE().  A screen
            stored with SCREENFILE() may be read back and displayed
            with FILESCREEN().  The argument <expN> can be used to
            indicate an offset from which to read the file.  The start
            of a new screen, in a file containing more than one screen
            can be easily calculated using the number of bytes used
            to write the SCREENFILE().  This will save storage space.

Notes:      The file read by FILESCREEN() may contain the end of file
            control characters.  The read process will not be prematurely
            terminated, as 4000 bytes are always being read.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * Read a screen from the start of a file.
            FILESCREEN("file.tst")

            * Read the second screen.  The first screen
            * will be "skipped" as the offset was
            * indicated by 4000.
            FILESCREEN("file.tst",4000)

            * Details of the drive and path are allowed.
            FILESCREEN("\file.tst")
            FILESCREEN("a:\file.tst")

            * Wild cards are not allowed.
            FILESCREEN("file.*")                && Result: 0