DWARF_GET_FORM_CLASS(3)

🌸 NAME 🌸

okay bestie, this is the DWARF_GET_FORM_CLASS(3) page for dwarf_get_form_class — yes, the (3) one — from the Library Functions Manual. Its whole job? retrieve the form class of an attribute. That's it. That's the assignment. 💅

📚 LIBRARY 📚

DWARF Access Library — that's libdwarf, link it with -ldwarf. 🫶

✨ SYNOPSIS ✨

#include <libdwarf.h>

enum Dwarf_Form_Class
dwarf_get_form_class(Dwarf_Half dwversion, Dwarf_Half attr,
    Dwarf_Half offset_size, Dwarf_Half form);

💖 DESCRIPTION 💖

Function dwarf_get_form_class() returns the class of the form of a DWARF attribute. Lowkey its whole personality is form-class retrieval. ✨

Here's the cast of arguments, bestie:

• dwversion — should specify the version number of the DWARF specification to use: 2 for DWARF2, 3 for DWARF3, and 4 for DWARF4. Pick your era. 🕰️
• attr — should hold the attribute code of the attribute, i.e. one of the DW_AT_* values defined in <libdwarf.h>. You know the ones. 💫
• offset_size — should hold the size of a DWARF offset for the relevant compilation unit. Yes, the relevant one. 📏
• form — should hold the form code of the attribute. That's the vibe check right there. 🧚

🎀 RETURN VALUES 🎀

On success, dwarf_get_form_class() returns the form class code, which is one of the DW_FORM_CLASS_* constants defined in the header file <libdwarf.h>. Slay. 👑

If the function was not able to determine the form class of the attribute, it returns the special form class code DW_FORM_CLASS_UNKNOWN. Not me getting an unknown form class 😭 — at least it's a named constant.

😭 ERRORS 😭

Function dwarf_get_form_class() does not return an error. That's right: no error return, no drama. 💀✨

🦋 SEE ALSO 🦋

• dwarf(3)
• dwarf_attr(3)
• dwarf_whatattr(3)
• dwarf_whatform(3)

💌 cute little sign-off: this page is from Debian, dated June 26, 2011. go forth and retrieve those form classes, bestie 🫶💅