---
name: "cdb_successor"
section: "3"
platform: "linux"
package: "libowfat-dev"
version: "0.32-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdb_successor"
---

# cdb\_successor(3)

find next record

## NAME

cdb\_successor - find next record

## SYNTAX

**#include \<libowfat/cdb.h\>**

int cdb\_successor(struct cdb \**c*,char \**key*,unsigned long int *klen*);

## DESCRIPTION

**cdb\_successor** finds the record that follows *key*.  If *key* is NULL, cdb\_successor finds the first record.

**NOTE!**  The database must not contain keys with more than one associated record or this API will lead to infinite loops!  Use cdb\_firstkey and cdb\_nextkey instead.

You can use cdb\_datapos or cdb\_keypos to get *position* and cdb\_datalen and cdb\_keylen to get *len*.

## SEE ALSO

[cdb\_firstkey(3)](/cdb_firstkey/3.md), [cdb\_nextkey(3)](/cdb_nextkey/3.md)