[Back to Interface] [Prev] [Next]

Hendbitaccess

intn Hendbitaccess(int32 h_id, intn flushbit)

h_id IN:

Identifier of the bit-access element to be disposed of

flushbit IN:

Specifies how the leftover bits are to be flushed

Purpose

Disposes of the specified bit-access file element.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

If called after a bit-write operation, Hendbitaccess flushes all buffered bits to the dataset, then calls Hendaccess.

"Leftover bits" are bits that have been buffered, but are fewer than the number of bits defined by BITNUM, which is usually set to 8.

Valid codes for flushbit are: 0 for flush with zeros, 1 for flush with ones and -1 for dispose of leftover bits



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.