PXFFDOPEN

POSIX Subroutine: Opens an external unit.

Module

USE IFPOSIX

Syntax

CALL PXFFDOPEN (ifildes,iunit,access,ierror)

ifildes

(Input) INTEGER(4). The file descriptor of the opened file.

iunit

(Input) INTEGER(4). The Fortran logical unit to connect to file descriptor ifildes.

access

(Input) Character. A character string that specifies the attributes for the Fortran unit. The string must consist of one or more of the following keyword/value pairs. Keyword/value pairs should be separated by a comma, and blanks are ignored.

Keyword

Possible Values

Description

Default

'NEWLINE'

'YES' or 'NO'

I/O type

'YES'

'BLANK'

'NULL' or 'ZERO'

Interpretation of blanks

'NULL'

'STATUS'

'OLD', 'SCRATCH', or 'UNKNOWN'

File status at open

'UNKNOWN'

'FORM'

'FORMATTED' or 'UNFORMATTED'

Format type

'FORMATTED'

Keywords should be separated from their values by the equals ('=') character; for example:

call PXFDOPEN (IFILDES, IUNIT, 'BLANK=NULL, STATUS=UNKNOWN', IERROR)

ierror

(Output) INTEGER(4). The error status.

The PXFFDOPEN subroutine connects an external unit identified by iunit to a file descriptor ifildes. If unit is already connected to a file, the file should be closed before using PXFFDOPEN.

Note iconNote

On Windows* systems, the default value of the POSIX/IO flag is 0, which causes PXFFDOPEN to return an error.

To prevent this, call subroutine PXFPOSIXIO and set the value of the POSIX/IO flag to 1.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

PXFPOSIXIO