1. Manuals
  2. Tumbleweed
  3. libtiff-devel-docs
  4. TIFFFieldReadCount(3tiff)

Scroll to navigation

TIFFFIELDREADCOUNT(3tiff) LibTIFF TIFFFIELDREADCOUNT(3tiff)

NAME

TIFFFieldReadCount - get number of values to be read from field

SYNOPSIS

#include <tiffio.h>



DESCRIPTION

TIFFFieldReadCount() returns the number of values available to be read from the specified TIFF field; that is, the number of arguments that should be supplied to TIFFGetField() <#c.TIFFGetField>. For most field types this is a small positive integer, typically 1 or 2, but there are some special values:

  • TIFF_VARIABLE = -1 indicates that a variable number of values is possible; then, a uint16_t count argument and a pointer data argument must be supplied to TIFFGetField() <#c.TIFFGetField>.
  • TIFF_VARIABLE2 = -3 is the same as TIFF_VARIABLE except that the count argument must have type uint32_t.
  • TIFF_SPP = -2 indicates that the number of arguments is equal to the image's number of samples per pixel.

fip is a field information pointer previously returned by TIFFFindField() <#c.TIFFFindField>, TIFFFieldWithTag() <#c.TIFFFieldWithTag>, or TIFFFieldWithName() <#c.TIFFFieldWithName>.

RETURN VALUES

TIFFFieldReadCount() returns an integer.

SEE ALSO

TIFFFieldDataType <> (3tiff), TIFFFieldName <> (3tiff), TIFFFieldPassCount <> (3tiff), TIFFFieldQuery <> (3tiff), TIFFFieldTag <> (3tiff), TIFFFieldWriteCount <> (3tiff), libtiff <> (3tiff)

Author

LibTIFF contributors

Copyright

1988-2025, LibTIFF contributors

September 18, 2025 4.7