PIO_inq_attid

Inquire attribute id. More...

Functions/Subroutines
integer function	spio_inq_att::pio_inq_attid_file_vid (file, varid, attname, attid)
	Inquire/get the unique id associated with an attribute in a file. More...
integer function	spio_inq_att::pio_inq_attid_fh_vid (fh, varid, attname, attid)
	Inquire/get the unique id associated with an attribute in a file. More...
integer function	spio_inq_att::pio_inq_attid_file_vdesc (file, vdesc, attname, attid)
	Inquire/get the unique id associated with a attribute in a file. More...

Detailed Description

Inquire attribute id.

This API can be used to inquire the unique id associated with a attribute in a file.

The attributes can be associated with a variable or not (a global attribute). Attributes associated with a variable needs to be queried using the variable id and global attributes can be queried using PIO_GLOBAL as the variable id (indicating that the attribute is a global attribute that is not associated with a single variable)

This API is a collective call (Although the library might internally choose to make progress on a single or small subset of MPI processes) on the I/O system associated with the file

Function/Subroutine Documentation

pio_inq_attid_fh_vid()

integer function spio_inq_att::pio_inq_attid_fh_vid	(	integer, intent(in)	fh,
		integer, intent(in)	varid,
		character(len=*), intent(in)	attname,
		integer, intent(out)	attid
	)

Inquire/get the unique id associated with an attribute in a file.

Parameters

[in]	fh	The file id/handle
[in]	varid	The id of the variable associated with the attribute. Use PIO_GLOBAL for global attributes
[in]	attname	The name of the attribute
[out]	attid	The id of the attribute

Return values

ierr	: The error return code. Set to PIO_NOERR on success, or an error code otherwise (See PIO_seterrorhandling for more information on how to customize/set error handling)

pio_inq_attid_file_vdesc()

integer function spio_inq_att::pio_inq_attid_file_vdesc	(	type(file_desc_t), intent(in)	file,
		type(var_desc_t), intent(out)	vdesc,
		character(len=*), intent(in)	attname,
		integer, intent(out)	attid
	)

Inquire/get the unique id associated with a attribute in a file.

Parameters

[in]	file	The file handle. File descriptor structure. This structure holds information associated with each open file
[in]	vdesc	The descriptor of the variable with the attribute. Variable description structure.
[in]	attname	The name of the attribute
[out]	attid	The id of the attribute

Return values

ierr	: The error return code. Set to PIO_NOERR on success, or an error code otherwise (See PIO_seterrorhandling for more information on how to customize/set error handling)

pio_inq_attid_file_vid()

integer function spio_inq_att::pio_inq_attid_file_vid	(	type(file_desc_t), intent(in)	file,
		integer, intent(in)	varid,
		character(len=*), intent(in)	attname,
		integer, intent(out)	attid
	)

Inquire/get the unique id associated with an attribute in a file.

Parameters

[in]	file	The file handle. File descriptor structure. This structure holds information associated with each open file
[in]	varid	The id of the variable associated with the attribute. Use PIO_GLOBAL for global attributes
[in]	attname	The name of the attribute
[out]	attid	The id of the attribute

Return values

ierr	: The error return code. Set to PIO_NOERR on success, or an error code otherwise (See PIO_seterrorhandling for more information on how to customize/set error handling)