---
name: "afNewFileSetup"
section: "3"
platform: "linux"
package: "audiofile"
version: "0.3.6-12"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/afNewFileSetup"
---

# afNewFileSetup(3)

create and initialize a new AFfilesetup structure

## NAME

afNewFileSetup - create and initialize a new AFfilesetup structure

## SYNOPSIS

```
#include <audiofile.h>
```

```
AFfilesetup afNewFileSetup(void);
```

## RETURN VALUE

afNewFileSetup returns, upon success, a valid AFfilesetup structure.

Upon failure, afNewFileSetup returns a null AFfilesetup. This case should only occur when no memory is available.

## DESCRIPTION

The opaque AFfilesetup structure returned by afNewFileSetup can be used to specify parameters for a file to be opened for writing by [**afOpenFile**(3)](/afOpenFile/3.md).

## SEE ALSO

[**afOpenFile**(3)](/afOpenFile/3.md)

## AUTHOR

Michael Pruett \<michael@68k.org\>