---
name: "auparse_goto_record_num"
section: "3"
platform: "linux"
package: "audit"
version: "4.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/auparse_goto_record_num"
---

# auparse\_goto\_record\_num(3)

move record cursor to specific record

## NAME

auparse\_goto\_record\_num - move record cursor to specific record

## SYNOPSIS

**#include \<auparse.h\>**

**int auparse\_goto\_record\_num(const auparse\_state\_t \****au,***unsigned***int"***num);"**

## DESCRIPTION

auparse\_goto\_record\_num will move the internal library cursors to point to a specific physical record number. Records within the same event are numbered starting from 0. This is generally not needed but there are some cases where one may want precise control over the exact record being looked at.

## RETURN VALUE

Returns 0 on error or 1 for success.

## SEE ALSO

[**auparse\_get\_num\_records**(3)](/auparse_get_num_records/3.md),[**auparse\_next\_record**(3)](/auparse_next_record/3.md).

## AUTHOR

Steve Grubb