Routines (alphabetical) > Routines: H > HDF Routines > HDF_DFR8_NIMAGES

# HDF_DFR8_NIMAGES

The HDF_DFR8_NIMAGES function returns the number of 8-bit images in the specified HDF file.

## Examples

; Open the file myhdf.hdf:

h = HDF_OPEN('myhdf.hdf')

; Retrieve the number of 8-bit images in the file into a variable:

number = HDF_DFR8_NIMAGES('myhdf.hdf')

HDF_CLOSE, h ; Close the file.

## Syntax

Result = HDF_DFR8_NIMAGES(Filename)

## Return Value

Returns the number of 8-bit images in the given HDF file. The function returns -1 if the specified file is invalid or damaged.

## Arguments

### Filename

A string containing the name of the file to be read.

## Keywords

None

## Version History

4.0 | Introduced

## See Also

HDF_DFR8_GETIMAGE, HDF_DFR8_GETINFO, HDF_DFR8_READREF HDF_DFR8_RESTART