NAME¶afOpenFile - open an audio file and create a file handle structure used for subsequent calls to the Audio File Library
AFfilehandle afOpenFile(const char *path, const char *mode, AFfilesetup setup);
PARAMETERS¶path is the path to the file to be opened.
mode specifies a mode for opening the file: "r" for reading or "w" for writing.
setup is an AFfilesetup created by afNewFileSetup(3). This value is ignored for files opened for reading except when the file format is AF_FILE_RAWDATA.
RETURN VALUE¶Upon success, afOpenFile returns a valid AFfilehandle which can be used in subsequent calls to the Audio File Library. Upon failure, afOpenFile returns NULL and generates an error.
afCloseFile(3) is used to close the file when it is no longer needed.
ERRORS¶afOpenFile can produce the following errors:
setup specifies a file format which is unsupported for mode.
setup specifies an invalid or unsupported configuration.
SEE ALSO¶afCloseFile(3), afNewFileSetup(3), afInitFileFormat(3), afInitSampleFormat(3), afReadFrames(3), afWriteFrames(3)
AUTHOR¶Michael Pruett <firstname.lastname@example.org>
|03/06/2013||Audio File Library 0.3.6|