CagdListInsert

Section: C Library Functions (3)
Updated: IRIT Version 6.0
Index Return to Main Contents

NAME

CagdListInsert()

SYNOPSIS

cagd_lib/cagd2gen.c:884

VoidPtr CagdListInsert(VoidPtr List,
                       VoidPtr NewElement,
                       CagdCompFuncType CompFunc,
                       CagdBType InsertEqual)

DESCRIPTION

Inserts a new element NewElement into an ordered list List. Ordering is prescribed by CompFunc.

PARAMETERS:

List: The list to update, in place. Can be empty list.

NewElement: New element to insert, in place into List.

CompFunc: A comparison function. Gets two elements of the list and compare and return a positive, zero, or negative values if first elements is smaller, equal, larger than second element, strcmp style.

InsertEqual: If TRUE, a new item that is found to be equal to an item in the list will be insert anyway. If FALSE, NULL is returned and no modification is made to the list, if equal.

FUNCTION RETURN VALUE

VoidPtr: The updated list. NULL if !InsertEqual and found equality. If NULL is returned, no modification was made to List.

ORIGIN

This document was created by man2html, using the manual pages.
Time: 07:27:17 GMT, October 17, 2022