dwarf_formflag(3)

dwarf_formflag3

Return the value of a boolean class attribute

Usage

#include <libdwarf.h>

int

dwarf_formflag(Dwarf_Attribute attr, Dwarf_Bool *ret, Dwarf_Error *err);

Library

library “libdwarf”

Overview

Function dwarf_formflag() sets the location pointed to by argument ret to 1 if the attribute referenced by argument attr has a non-zero value, or 0 otherwise. The form of argument attr must be one of DW_FORM_flag or DW_FORM_flag_present.

If argument err is not NULL, it will be used to return an error descriptor in case of an error.

Return values

Function dwarf_formflag() returns DW_DLV_OK on success. In case of an error, it returns DW_DLV_ERROR and sets argument err.

Errors

Function dwarf_formflag() may fail with the following errors:

[DW_DLE_ARGUMENT]

Either of arguments attr or ret was NULL.

[DW_DLE_ATTR_FORM_BAD]

The attribute referenced by argument attr was not of a permitted kind.

Releases

25 releases since FreeBSD 11.0-RELEASE; the text changed 1 time.

  1. 11.0–12.0
  2. 12.1–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.