.TH skipInsert 3 "12 July 2007" "ClearSilver" "util/skiplist.h"

.de Ss
.sp
.ft CW
.nf
..
.de Se
.fi
.ft P
.sp
..
.SH NAME
skipInsert  - insert an item.
.SH SYNOPSIS
.Ss
#include <util/skiplist.h>
.Se
.Ss
NEOERR *skipInsert(skipList list, UINT32 key, void *value, int allowUpdate);

.Se

.SH ARGUMENTS
list - list to add pair to.
.br
key - key identifying <value>.
.br
value - value to store (may NOT be NULL)

.SH DESCRIPTION
Inserts the <key>/<value> pair into the <list>.
Key values 0 and -1 are reserved (and illegal).
If key is already in list, and <allowUpdate> is true, 
value is updated, otherwise SKIPERR_EXISTS is returned.

MT-Level: Safe if <list> thread-safe.

.SH "RETURN VALUE"
None.

.SH "SEE ALSO"
.BR skipDelete "(3), "skipFreeList "(3), "skipRelease "(3), "skipInsert "(3), "skipSearch "(3), "skipNext "(3), "skipNewList