PIO  1.7.1
 All Classes Files Functions Groups Pages


integer function, public piolib_mod::pio_openfile (iosystem, file, iotype, fname, mode)
 open an existing file using pio More...

Detailed Description

Function/Subroutine Documentation

integer function, public piolib_mod::pio_openfile ( type (iosystem_desc_t), intent(inout), target  iosystem,
type (file_desc_t), intent(out)  file,
integer, intent(in)  iotype,
character(len=*), intent(in)  fname,
integer, intent(in), optional  mode 

open an existing file using pio

Input parameters are read on comp task 0 and ignored elsewhere.

iosystem: a defined pio system descriptor created by a call to PIO_init (see PIO_types)
file: the returned file descriptor

An integer parameter which controls the iotype.

fname: the name of the file to open
mode: a zero value (or PIO_nowrite) specifies the default behavior: open the dataset with read-only access, buffering and caching accesses for efficiency otherwise, the creation mode is PIO_write. setting the PIO_write flag opens the dataset with read-write access. ("writing" means any kind of change to the dataset, including appending or changing data, adding or renaming dimensions, variables, and attributes, or deleting attributes.)
Return values