DC_PARSER_NEW(3)

💖 NAME 💖

dc_parser_new, dc_parser_new2 — create a parser for a single dive.

Okay bestie, welcome to dc_parser_new(3) from the libdivecomputer library, living its best life in the Library Functions Manual ✨. This page is literally about making a parser for one single dive — focused, iconic, no extra chaos. 💅

🦋 LIBRARY 🦋

The library is “libdivecomputer” — that’s the library, bestie. 🫶

✨ SYNOPSIS ✨

Here’s the exact shape, no cap:

#include <libdivecomputer/parser.h>

dc_status_t
dc_parser_new(dc_parser_t **parser, dc_device_t *device);

dc_status_t
dc_parser_new2(dc_parser_t **parser, dc_context_t *context,
    dc_descriptor_t *descriptor);

🌸 DESCRIPTION 🌸

This creates a parser for a single dive extracted from the dive computer with dc_device_foreach(3). The parser operates on the data extracted: it does not touch the device directly to acquire data. Periodt. 💀

Because of that, there are two forms of invocation: dc_parser_new extracts the relevant values from the device parameter; and dc_parser_new2 is given device values (model, etc.) directly.

The pointer must later be freed with dc_parser_destroy(3) — don’t ghost it, bestie. 🎀

⭐ RETURN VALUES ⭐

These return DC_STATUS_OK, and fill in the parser pointer on success. Otherwise, an error is returned. That’s the whole return-value vibe check. ✅

👀 SEE ALSO 👀

• dc_device_foreach(3)
• dc_parser_destroy(3)

💖 AUTHORS 💖

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. The manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. Legends, honestly. 👑

xoxo 💅 this page is from Debian, dated January 5, 2017, and its footer tag is DC_PARSER_NEW(3) — bye bestie! 🫶