[#BloombergLP-bdlcc-SkipList-0a-skipForward]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/SkipList-0a.adoc[SkipList]::skipForward
:relfileprefix: ../../../
:mrdocs:

Advance `item` to the next item in the list.

== Synopsis

Declared in `<bdlcc_skiplist.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
skipForward(xref:BloombergLP/bdlcc/SkipList-0a/PairHandle.adoc[PairHandle]* item) const;
----

== Description

If the item identified by the specified `item` is not at the end of the list, load a reference to the next item in the list into `item`; otherwise reset the value of `item`. Return 0 on success, and `e_NOT_FOUND` (with no effect on the value of `item`) if `item` is no longer in the list.

== Return Value

0 on success, and `e_NOT_FOUND` if `item` is no longer in the list

== Parameters

[cols="1,4"]
|===
| Name| Description
| *item*
| handle identifying the current item; updated in place
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#