Open Cons

FreeBASIC

Open Cons
 
Opens the console's standard input (stdin) or output (stdout) streams for use in file operations.

Syntax

Open Cons As [#]filenumber
Open Cons For Input As [#]filenumber
Open Cons For Output As [#]filenumber

Usage

result = Open Cons( [For {Input|Output}[,]] As filenumber )
(or using the QB-like syntax,)
Open Cons [For {Input|Output}] As filenumber

Parameters

filenumber
An available file number to bind to the stdin or stdout stream, which can be found with FreeFile.

Return Value

In the first usage, Open Cons returns zero (0) on success and a non-zero error code otherwise.

Description

Open Cons opens the console's stdin or stdout streams for reading or writing. A file number is bound to the stream, which is used in subsequent file operations, such as Input #. An available file number can be retrieved with FreeFile.

The Input file mode opens the stdin stream for reading file operations, such as Line Input #, while the Output file mode opens the stdout stream for writing file operations, such as Print #. The Output file mode is the default if not specified.

The stdin and stdout streams are the ones used when the calling process' input or output is redirected (piped) by OS commands, or when it is opened with Open Pipe.

To open both the stdin and stdout streams for file operations, a process must use multiple file numbers.


Runtime errors:
Open Cons throws one of the following runtime errors:

(1) Illegal function call
    • filenumber was not free at the time. use FreeFile to ensure that filenumber is free.
Example

Dim a As String

Open Cons For Input As #1
Open Cons For Output As #2

Print #2,"Please write something and press ENTER"
Line Input #1,a
Print #2, "You wrote : ";a

Close
Sleep


Differences from QB

  • In QB the syntax was OPEN "CON:" FOR INPUT|OUTPUT AS [#] filenum

See also