DWARF_HASFORM(3)

💖 query attribute forms 💖

okay so you're reading DWARF_HASFORM(3), a Library Functions Manual page from the DWARF Access Library (libdwarf, -ldwarf). It's giving “ask questions about attribute forms” energy, and honestly? iconic. 🦋

🌸 NAME 🌸

dwarf_hasform, dwarf_whatform, dwarf_whatform_direct — the little trio for querying attribute forms. 💅

🎀 LIBRARY 🎀

DWARF Access Library (libdwarf, -ldwarf). 🫶

✨ SYNOPSIS ✨

#include <libdwarf.h>

int
dwarf_hasform(Dwarf_Attribute attr, Dwarf_Half form, Dwarf_Bool *ret,
    Dwarf_Error *err);

int
dwarf_whatform(Dwarf_Attribute attr, Dwarf_Half *retform,
    Dwarf_Error *err);

int
dwarf_whatform_direct(Dwarf_Attribute attr, Dwarf_Half *retform,
    Dwarf_Error *err);

💜 DESCRIPTION 💜

bestie, here's the tea on each function ☕✨

• dwarf_hasform() — this one tells you whether the DWARF attribute passed as attr has the attribute form specified by form. If it does, the argument ret gets set to a non-zero value; if it doesn't, ret gets set to zero. If err is non-NULL, it'll be used to return an error descriptor in case of an error. 🎀
• dwarf_whatform() — this sets the location specified by retform to the attribute form code for the DWARF attribute referenced by attr. crucial detail: if the attribute referenced by attr has an indirect form attribute, this function returns the final form for the attribute. If err is non-NULL, it'll be used to return an error descriptor in case of an error. 🌈
• dwarf_whatform_direct() — this also sets the location specified by retform to the attribute form code for the DWARF attribute referenced by attr. but if the form is an indirect form, it sets the location specified by retform to DW_FORM_indirect instead. If err is non-NULL, it'll be used to return an error descriptor in case of an error. 💫

🔥 RETURN VALUES 🔥

These functions return DW_DLV_OK on success. If something goes wrong, they return DW_DLV_ERR and set argument err. periodt. 💅

🍓 ERRORS 🍓

These functions may fail with the following errors:

• [DW_DLE_ARGUMENT] — any of the arguments attr, ret, or retform was NULL. 😭

👑 SEE ALSO 👑

go read dwarf(3), dwarf_attr(3), and dwarf_hasattr(3) too, iykyk 💜

mwah 💋 — source/version: Debian · date: May 22, 2010.