---
name: "AuSoundCreateFileFromBucket"
section: "3x"
platform: "linux"
package: "nas"
version: "1.2p5-3"
release: "Debian 2.0 (Hamm)"
platforms: ["linux"]
url: "https://new.carta.tech/AuSoundCreateFileFromBucket/3x"
---

# AuSoundCreateFileFromBucket(3x)

copy the data from a bucket into a file.

## Name

**AuSoundCreateFileFromBucket** - copy the data from a bucket into a file.

## Synopsis

\#include \<audio/audiolib.h\>\
 \#include \<audio/soundlib.h\>

**AuBool** **AuSoundCreateFileFromBucket**(*server*, *filename*, *file\_format*, *bucket*, *status*)\
\
     **AuServer** \**server*;\
\
     char \**filename*;\
\
     int *file\_format*;\
\
     **AuBucketID** *bucket*;\
\
     **AuStatus** \**status*;

## Arguments

- *server*

  Specifies the connection to the audio server.

- *filename*

  Specifies the name of the file to use.

- *file*

  Specifies the format of the file. Currently, the following file formats are supported: **SoundFileFormatSnd**, **SoundFileFormatVoc**, **SoundFileFormatWave**, **SoundFileFormatAiff**, **SoundFileFormatSvx**.

- *bucket*

  Specifies the bucket to get the audio data from.

- *status*

  If non-NULL, flush the output buffer and return the status from the server.

## Description

**AuSoundCreateFileFromBucket** creates a file using the audio data from *bucket* and returns **AuTrue** if successfull or **AuFalse** if there was an error.

## Errors

**AuBadBucket**.

## See Also

**AuSoundCreateDataFromBucket**.

audiolib - **Network Audio System** C Language Interface