---
name: "TIFFStrileQuery"
section: "3tiff"
platform: "linux"
package: "libtiff-dev"
version: "4.7.0-3+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/TIFFStrileQuery"
---

# TIFFStrileQuery(3tiff)

get strile byte count and offset

## NAME

TIFFStrileQuery - get strile byte count and offset

## SYNOPSIS

```
#include <tiffio.h>
```

- **uint64\_t TIFFGetStrileByteCount(TIFF \*tif, uint32\_t strile);**

  - **uint64\_t TIFFGetStrileOffset(TIFF \*tif, uint32\_t strile);**

  - **uint64\_t TIFFGetStrileByteCountWithErr(TIFF \*tif, uint32\_t strile, int \*pbErr);**

  - **uint64\_t TIFFGetStrileOffsetWithErr(TIFF \*tif, uint32\_t strile, int \*pbErr);**

  ## DESCRIPTION

Make defer strile offset/bytecount loading available at runtime and add per-strile offset/bytecount loading capabilities. Part of this commit makes the behaviour that was previously met when **libtiff** was compiled with **-DDEFER\_STRILE\_LOAD** available for default builds.

When specifying the new **D** (Deferred) *TIFFOpen()* flag, the loading of strile offset/bytecount is defered. In that mode, the **StripOffsets** / **StripByteCounts** or **TileOffsets** / **TileByteCounts** arrays are only loaded when first accessed. This can speed-up the opening of files stored on the network when just metadata retrieval is needed.

Another addition is the capability of loading only the values of the offset/bytecount of the strile of interest instead of the whole array. This is enabled with the new **O** (Ondemand) flag of *TIFFOpen()* (which implies **D**).

The public *TIFFGetStrileOffset()*, *TIFFGetStrileOffsetWithErr()*, *TIFFGetStrileByteCount()* and *TIFFGetStrileByteCountWithErr()* functions have been added to API. They are of particular interest when using sparse files (with **offset == bytecount == 0**) and you want to detect if a strile is present or not without decompressing the data, or updating an existing sparse file.

*TIFFGetStrileByteCount()* returns the value of the TileByteCounts / StripByteCounts array for the specified tile/strile.

*TIFFGetStrileByteCountWithErr()* additionally provides *pbErr* as an *int* pointer to an error return variable, which is set to "0" for successful return or to "1" for an error return.

*TIFFGetStrileOffset()* returns the value of the TileOffsets / StripOffsets array for the specified tile/strile.

*TIFFGetStrileOffsetWithErr()* additionally provides *pbErr* as an *int* pointer to an error return variable, which is set to "0" for successful return or to "1" for an error return.

## DIAGNOSTICS

All error messages are directed to the *TIFFErrorExtR()* routine. Likewise, warning messages are directed to the *TIFFWarningExtR()* routine.

## NOTE

This functionality was introduced with libtiff 4.1.

## SEE ALSO

*libtiff* (3tiff), *TIFFOpen*  (3tiff), *TIFFDeferStrileArrayWriting* (3tiff)

## AUTHOR

LibTIFF contributors

## COPYRIGHT

1988-2022, LibTIFF contributors