| GEOS SDK TechDocs | | FoamDBResumeUpdates() ... | GCNListAdd() ...

---

FormatIDFromManufacturerAndType

dword	FormatIDFromManufacturerAndType(mfr, type);
        ManufacturerIDs 			mfr;
        ClipboardItemFormat 			type;

This macro takes a manufacturer ID and a format type (e.g. CIF_TEXT) and combines them into a dword argument of the type ClipboardItemFormatID .

free()

void 	free(
        void * blockPtr);				/* address of memory to free */

The malloc() family of routines is provided for Standard C compatibility. The kernel will allocate a fixed block to satisfy the geode's malloc() requests; it will allocate memory from this block. When the block is filled, it will allocate another fixed malloc-block. When all the memory in the block is freed, the memory manager will automatically free the block.

When a geode is finished with some memory it requested from malloc() , it should free the memory. That makes it easier for malloc() to satisfy memory request. It can free the memory by passing the address which was returned by malloc() (or calloc() or realloc() ) when the memory was allocated. All of the memory will be freed.

The memory must be in a malloc-block assigned to the geode calling free() . If you want to free memory in another geode's malloc-block, call GeoFree() .

Include: stdlib.h

Warnings: Pass exactly the same address as the one returned to you when you allocated the memory. If you pass a different address, free() will take unpredictable actions, including possibly erasing other memory or crashing the system.

See Also: calloc(), malloc(), GeoFree(), realloc().

FractionOf()

word	FractionOf(
        WWFixedAsDWord		wwf);

This macro returns the fractional portion of a WWFixedAsDWord value.

Include: geos.h