Function Heap_offer

src/util/heap.c:196–207

add item, ensures that the data structure can hold the item NOTE: realloc() possibly called return 0 on success; -1 on failure

// NOTE: realloc() possibly called
// return 0 on success; -1 on failure
int Heap_offer
(
	heap_t **hp,  // pointer to the heap, changed when heap is enlarged
	void *item    // item The item to be added
) {
	if(NULL == (*hp = __ensurecapacity(*hp))) {
		return -1;
	}

	__Heap_offerx(*hp, item);
	return 0;
}

// add item
// an error will occur if there isn't enough space for this item