MtkFileBlockMetaFieldList.c File Reference

#include "MisrFileQuery.h"
#include "MisrUtil.h"
#include "MisrError.h"
#include <hdf.h>
#include <string.h>

Go to the source code of this file.

Functions
MTKt_status	MtkFileBlockMetaFieldList (const char *filename, const char *blockmetaname, int *nfields, char **fieldlist[])
	Read list of fields in a block metadata structure. More...
MTKt_status	MtkFileBlockMetaFieldListFid (int32 file_id, const char *blockmetaname, int *nfields, char **fieldlist[])
	Version of MtkFileBlockMetaFieldList that takes an HDF file identifier rather than a filename. More...

Function Documentation

MtkFileBlockMetaFieldList()

MTKt_status MtkFileBlockMetaFieldList	(	const char *	filename,
		const char *	blockmetaname,
		int *	nfields,
		char **	fieldlist[]
	)

Read list of fields in a block metadata structure.

Returns

MTK_SUCCESS if successful.

Example:

In this example, we read the list of fields in the PerBlockMetadataCommon structure in the file MISR_AM1_GRP_TERRAIN_GM_P161_O012115_DF_F03_0021.hdf

status = MtkFileBlockMetaFieldList("MISR_AM1_GRP_TERRAIN_GM_P161_O012115_DF_F03_0021.hdf", "PerBlockMetadataCommon", &nfields, &fieldlist);

Note

The caller is responsible for using MtkStringListFree() to free the memory used by fieldlist

Parameters

[in]	filename	Filename
[in]	blockmetaname	Block metadata structure name
[out]	nfields	Number of Fields
[out]	fieldlist	List of Fields

Definition at line 39 of file MtkFileBlockMetaFieldList.c.

MtkFileBlockMetaFieldListFid()

MTKt_status MtkFileBlockMetaFieldListFid	(	int32	file_id,
		const char *	blockmetaname,
		int *	nfields,
		char **	fieldlist[]
	)

Version of MtkFileBlockMetaFieldList that takes an HDF file identifier rather than a filename.

Returns

MTK_SUCCESS if successful.

Parameters

[in]	file_id	HDF file identifier
[in]	blockmetaname	Block metadata structure name
[out]	nfields	Number of Fields
[out]	fieldlist	List of Fields

Definition at line 84 of file MtkFileBlockMetaFieldList.c.