Function free

Engine/source/platform/platformMemory.cpp:1381–1460

#if !defined(TORQUE_DISABLE_MEMORY_MANAGER)
static void free(void* mem, bool array)
{
   // validate();

   if (!mem)
      return;

#ifdef TORQUE_MULTITHREAD
   if(!gMemMutex)
      gMemMutex = Mutex::createMutex();

   if( mem != gMemMutex )
      Mutex::lockMutex(gMemMutex);
   else
      gMemMutex = NULL;
#endif

   PROFILE_START(MemoryFree);
   AllocatedHeader *hdr = ((AllocatedHeader *)mem) - 1;

   AssertFatal(hdr->flags & Allocated, avar("Not an allocated block!"));
   AssertFatal(((bool)((hdr->flags & Array)==Array))==array, avar("Array alloc mismatch. "));

   gBlocksAllocated --;
#ifdef TORQUE_DEBUG_GUARD
   gBytesAllocated -= hdr->realSize;
   if (gEnableLogging)
      logFree(hdr);
#endif

   hdr->flags = 0;

   // fill the block with the fill value

#ifdef TORQUE_DEBUG
   #ifndef TORQUE_ENABLE_PROFILE_PATH
      PROFILE_START(stompMem2);
   #endif
   dMemset(mem, 0xCE, hdr->size);
   #ifndef TORQUE_ENABLE_PROFILE_PATH
      PROFILE_END();
   #endif
#endif

   // see if we can merge hdr with the block after it.

   Header* next = hdr->next;
   if (next && next->flags == 0)
   {
      treeRemove((FreeHeader *) next);
      hdr->size += next->size + sizeof(Header);
      hdr->next = next->next;
      if(next->next)
         next->next->prev = (Header *) hdr;
   }

   // see if we can merge hdr with the block before it.
   Header* prev = hdr->prev;