###### (This is the documentation for SDL3, which is the current stable version. [SDL2](https://wiki.libsdl.org/SDL2/) was the previous version!)
# SDL_LoadWAV

Loads a WAV from a file path.

## Header File

Defined in [<SDL3/SDL_audio.h>](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_audio.h)

## Syntax

```c
bool SDL_LoadWAV(const char *path, SDL_AudioSpec *spec, Uint8 **audio_buf, Uint32 *audio_len);
```

## Function Parameters

|                                  |               |                                                                                                                         |
| -------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------- |
| const char *                     | **path**      | the file path of the WAV file to open.                                                                                  |
| [SDL_AudioSpec](SDL_AudioSpec) * | **spec**      | a pointer to an [SDL_AudioSpec](SDL_AudioSpec) that will be set to the WAVE data's format details on successful return. |
| Uint8 **                         | **audio_buf** | a pointer filled with the audio data, allocated by the function.                                                        |
| [Uint32](Uint32) *               | **audio_len** | a pointer filled with the length of the audio data buffer in bytes.                                                     |

## Return Value

(bool) Returns true on success. `audio_buf` will be filled with a pointer
to an allocated buffer containing the audio data, and `audio_len` is filled
with the length of that audio buffer in bytes.

This function returns false if the .WAV file cannot be opened, uses an
unknown data format, or is corrupt; call [SDL_GetError](SDL_GetError)() for
more information.

When the application is done with the data returned in `audio_buf`, it
should call [SDL_free](SDL_free)() to dispose of it.

## Remarks

This is a convenience function that is effectively the same as:

```c
SDL_LoadWAV_IO(SDL_IOFromFile(path, "rb"), true, spec, audio_buf, audio_len);
```

## Thread Safety

It is safe to call this function from any thread.

## Version

This function is available since SDL 3.1.3.

## See Also

- [SDL_free](SDL_free)
- [SDL_LoadWAV_IO](SDL_LoadWAV_IO)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryAudio](CategoryAudio)