AUTFREEHEAP(3)

🎀 autfreeheap(3) — AUT FUNCTIONS 🎀

okay bestie, welcome to the autfreeheap page 💖 this one lives in the AUT FUNCTIONS section of the manual, and it's literally the "give the memory back" bestie of autallocheap. short page, big job. let's get into it 🫶

🌸 ORIGIN 🌸

this software belongs to the ALLIANCE CAD SYSTEM, developed by the ASIM team at the LIP6 laboratory of Université Pierre et Marie CURIE, in Paris, France 🥖✨ (yes, that Paris).

• Web : http://asim.lip6.fr/recherche/alliance/
• E-mail : alliance-users@asim.lip6.fr

✨ SYNOPSIS ✨

#include "aut101.h"
void autfreeheap( Pointer, Size )
   char         ∗Pointer;
   unsigned int Size;

🦋 PARAMETERS 🦋

• Pointer — the pointer you're handing back to the heap 🫴 she's going home.
• Size — the size of the block that was previously allocated by autallocheap. you gotta tell her how big she was, no cap.

💅 DESCRIPTION 💅

autfreeheap frees a pointer and puts the block back on the heap. that's the whole vibe ✨

and listen — using it is necessary to free memory blocks that were previously allocated by autallocheap 👑 like, that's the matching pair, the duo, the main characters. autallocheap gives, autfreeheap takes back. periodt 💀

🍓 RETURN VALUE 🍓

autfreeheap returns nothing. literally nothing. void. empty. she gives you zero back and that's iconic 😌

🌈 EXAMPLE 🌈

okay here's the whole thing in action, bestie — a little bipointer struct and her alloc/free besties:

#include "aut101.h"
typedef struct bipointer
{
  struct bipointer ∗NEXT;
  void             ∗DATA;
} bipointer;
bipointer ∗addbipointer( Data );
  void ∗Data;
{
  bipointer ∗Bp = (bipointer ∗)autallocheap( sizeof( bipointer ) );
  Bp->DATA = Data;
  return Bp;
}
void delbipointer( Bp );
  bipointer ∗Bp;
{
  autfreeheap( Pointer, sizeof( bipointer ) );
}

👀 just copying it faithfully, bestie — that last line says exactly what it says, so don't come for me, I'm just the messenger 💀

🧚 SEE ALSO 🧚

aut(1), autresizeblock(3), autallocheap(3), autallocblock(3), autfreeblock(3).

💜 BUG REPORT 💜

this tool is under development at the ASIM department of the LIP6 laboratory. we need your feedback to improve documentation and tools 🙏 fr fr, tell them what's broken, they want to know.

and that's the page, bestie! 🌸 this one's from ASIM/LIP6, dated October 1, 1997 (yes she's an elder icon 👑), filed under AUTFREEHEAP(3). go forth and free your heap responsibly 🎀💖