File: skipNext.3

package info (click to toggle)
clearsilver 0.10.5-3
  • links: PTS
  • area: main
  • in suites: buster
  • size: 3,304 kB
  • ctags: 3,158
  • sloc: ansic: 24,586; python: 4,233; sh: 2,502; cs: 1,429; ruby: 819; java: 735; makefile: 593; perl: 120; lisp: 34; sql: 21
file content (48 lines) | stat: -rw-r--r-- 1,022 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.TH skipNext 3 "12 July 2007" "ClearSilver" "util/skiplist.h"

.de Ss
.sp
.ft CW
.nf
..
.de Se
.fi
.ft P
.sp
..
.SH NAME
skipNext  - find next item.
.SH SYNOPSIS
.Ss
#include <util/skiplist.h>
.Se
.Ss
void *skipNext(skipList list, UINT32 *pkey, void **plock);

.Se

.SH ARGUMENTS
list - list to search in.
.br
pkey - pointer to previous key (0 to start).
.br
plock - place for value lock (or NULL).

.SH DESCRIPTION
Searches in list <list> for item with key next larger
that the one in <pkey>, and returns its value if 
found, or NULL if not.  If <plock> is non-NULL, then
the lock returned in <plock> will be associated with
the returned value.  Until this lock is passed to
skipRelease(), the value will not be freed with the
freeValue callback (see skipNewList()).

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

.SH "RETURN VALUE"
pkey - set to new key.
.br
plock - set to value lock.

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