AuDestroyBucket(3)

📦 version 1.9.5, in fedora 43, fedora 44

✨ AuDestroyBucket(3) ✨

okay bestie, this is a page from the Library Functions Manual — the audiolib era of Unix audio, and we're about to yeet a bucket 💅

🎀 NAME 🎀

AuDestroyBucket — destroy bucket

like. that's it. that's the whole vibe. you have a bucket, you want it GONE. 🦋

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

void AuDestroyBucket(server, bucket, status)
    AuServer *server;
    AuBucketID bucket;
    AuStatus *status; /* RETURN */

she takes three things and gives you nothing back, which is honestly iconic of her. 💖

💜 ARGUMENTS 💜

  • server — the connection to the audio server. your lil phone line to the sound daemon. 📞
  • bucket — the ID of the bucket that's getting destroyed. bye boo 👋
  • status — if it's non-NULL, she flushes the output buffer and hands you back the status from the server. it's marked /* RETURN */ in the synopsis so you know she's writing to it. if you pass NULL, she just… doesn't. no cap.

🔥 DESCRIPTION 🔥

AuDestroyBucket destroys the specified bucket, releasing the resources used by the bucket. gone. freed. deceased. 💀

but here's the plot twist — if the bucket is currently in use, the resources will not be released until the bucket is no longer in use. so it's not an instant delete, it's more like a girl, when you're done with this. the cleanup is scheduled, she's just being patient about it. 🧚

💀 ERRORS 💀

she can hit you with:

  • AuBadBucket
  • AuBadAccess

that's the whole list. short, sweet, devastating. 😭

🌈 SEE ALSO 🌈

  • AuCreateBucket — for when you want to make one instead of unmake one. the two of them are lowkey soulmates 🫶
  • audiolib — Network Audio System C Language Interface

k that's the page bestie, go forth and free your buckets, you've got this 👑

this one's from audiolib — bucket existence, version 1.9.5, and ngl there's no date on the footer, so we're just gonna say it's from the audiolib times. mwah 💅✨🍓

📦 where this page comes from