---
name: "TIFFWriteDirectory"
section: "3t"
platform: "linux"
package: "libtiff3g-dev"
version: "3.5.5-6.woody5"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/TIFFWriteDirectory"
---

# TIFFWriteDirectory(3t)

write the current directory in an open TIFF file

## NAME

TIFFWriteDirectory - write the current directory in an open TIFF file

## SYNOPSIS

**#include \<tiffio.h\>**\
 **int TIFFWriteDirectory(TIFF\* tif)**

## DESCRIPTION

Write the contents of the current directory to the file and setup to create a new subfile in the same file. Applications only need to call *TIFFWriteDirectory* when writing multiple subfiles to a single TIFF file. *TIFFWriteDirectory* is automatically called by *TIFFClose* and *TIFFFlush* to write a modified directory if the file is open for writing.

## RETURN VALUES

1 is returned when the contents are successfully written to the file. Otherwise, 0 is returned if an error was encountered when writing the directory contents.

## DIAGNOSTICS

All error messages are directed to the *TIFFError*(3T) routine.

**Error post-encoding before directory write**. Before writing the contents of the current directory, any pending data are flushed. This message indicates that an error occurred while doing this.

**Error flushing data before directory write**. Before writing the contents of the current directory, any pending data are flushed. This message indicates that an error occurred while doing this.

**Cannot write directory, out of space**. There was not enough space to allocate a temporary area for the directory that was to be written.

**Error writing directory count**. A write error occurred when writing the count of fields in the directory.

**Error writing directory contents**. A write error occurred when writing the directory fields.

**Error writing directory link**. A write error occurred when writing the link to the next directory.

**Error writing data for field "%s"**. A write error occurred when writing indirect data for the specified field.

**Error writing TIFF header**. A write error occurred when re-writing header at the front of the file.

**Error fetching directory count**. A read error occurred when fetching the directory count field for a previous directory. This can occur when setting up a link to the directory that is being written.

**Error fetching directory link**. A read error occurred when fetching the directory link field for a previous directory. This can occur when setting up a link to the directory that is being written.

## SEE ALSO

*libtiff*(3T), *TIFFOpen*(3T), *TIFFError*(3T), *TIFFReadDirectory*(3T), *TIFFSetDirectory*(3T)