---
name: "WordCursorOne"
section: "3"
platform: "linux"
package: "libmifluz0-dev"
version: "0.24.0-9"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/WordCursorOne"
---

# WordCursorOne(3)

search and retrieve entries in a WordListOne object.

## NAME

WordCursorOne - search and retrieve entries in a WordListOne object.

## SYNOPSIS

```
#include <WordList.h>
int callback(WordList *, WordDBCursor& , const WordReference *, Object &)
{
   ...
}
Object* data = ...
WordList *words = ...;
WordCursor *search = words->Cursor(callback, data);
WordCursor *search = words->Cursor(WordKey("word <UNDEF> <UNDEF>"));
WordCursor *search = words->Cursor(WordKey("word <UNDEF> <UNDEF>"), callback, data);
WordCursor *search = words->Cursor(WordKey());
if(search->Walk() == NOTOK) bark;
List* results = search->GetResults();
search->WalkInit();
if(search->WalkNext() == OK)
  dosomething(search->GetFound());
search->WalkFinish();
```

## DESCRIPTION

WordCursorOne is a WordCursor derived class that implements search in a WordListOne object. It currently is the only derived class of the WordCursor object. Most of its behaviour is described in the WordCursor manual page, only the behaviour specific to WordCursorOne is documented here.

## METHODS

- **WordCursorOne(WordList \*words)**

  Private constructor. Creator of the object must then call Initialize() prior to using any other methods.

- **WordCursorOne(WordList \*words, wordlist\_walk\_callback\_t callback, Object \* callback\_data)**

  Private constructor. See WordList::Cursor method with same prototype for description.

- **WordCursorOne(WordList \*words, const WordKey &searchKey, int action = HTDIG\_WORDLIST\_WALKER)**

  Private constructor. See WordList::Cursor method with same prototype for description.

- **WordCursorOne(WordList \*words, const WordKey &searchKey, wordlist\_walk\_callback\_t callback, Object \* callback\_data)**

  Private constructor. See WordList::Cursor method with same prototype for description.

## AUTHORS

Loic Dachary loic@gnu.org

The Ht://Dig group http://dev.htdig.org/

## SEE ALSO

[htdb\_dump(1)](/htdb_dump/1.md), [htdb\_stat(1)](/htdb_stat/1.md), [htdb\_load(1)](/htdb_load/1.md), [mifluzdump(1)](/mifluzdump/1.md), [mifluzload(1)](/mifluzload/1.md), [mifluzsearch(1)](/mifluzsearch/1.md), [mifluzdict(1)](/mifluzdict/1.md), [WordContext(3)](/WordContext/3.md), [WordList(3)](/WordList/3.md), [WordDict(3)](/WordDict/3.md), [WordListOne(3)](/WordListOne/3.md), [WordKey(3)](/WordKey/3.md), [WordKeyInfo(3)](/WordKeyInfo/3.md), [WordType(3)](/WordType/3.md), [WordDBInfo(3)](/WordDBInfo/3.md), [WordRecordInfo(3)](/WordRecordInfo/3.md), [WordRecord(3)](/WordRecord/3.md), [WordReference(3)](/WordReference/3.md), [WordCursor(3)](/WordCursor/3.md), [WordMonitor(3)](/WordMonitor/3.md), [Configuration(3)](/Configuration/3.md), [mifluz(3)](/mifluz/3.md)