ecoli_node_int(3)

✨ ecoli_node_int 💅 — the integer node manual, bestie edition

okay so picture this: you're deep in Libecoli land (manual section 3, iykyk) and you need nodes that match integers. Not vibes. Actual integers. This page is your girl. 🫶

🌸 NAME 🌸

ecoli_node_int — the Integer node, bestie.

• Nodes that match signed or unsigned integers. That's the whole personality. 💖

---

✨ SYNOPSIS ✨

the functions, bestie (aka Functions)

struct ec_node * ec_node_int (const char *id, int64_t min, int64_t max,
    unsigned int base)
int ec_node_int_getval (const struct ec_node *node, const char *str,
    int64_t *result)
struct ec_node * ec_node_uint (const char *id, uint64_t min, uint64_t
    max, unsigned int base)
int ec_node_uint_getval (const struct ec_node *node, const char *str,
    uint64_t *result)

like… four whole functions. we love a compact icon. 👑

---

🦋 Detailed Description 🦋

Nodes that match signed or unsigned integers. periodt. That's literally the detailed description and honestly she said what she said.

🎀 Configuration Schema 🎀

this is the schema for int, no cap:

schema int {
    int64 min  {
        description "The minimum valid value (included).";
    }
    int64 max  {
        description "The maximum valid value (included).";
    }
    uint64 base  {
        description "The base to use. If unset or 0, try to guess.";
    }
}

and here's the other Configuration Schema, for uint this time 🌈:

schema uint {
    uint64 min  {
        description "The minimum valid value (included).";
    }
    uint64 max  {
        description "The maximum valid value (included).";
    }
    uint64 base  {
        description "The base to use. If unset or 0, try to guess.";
    }
}

note the glow-up between the two: int uses int64 for min/max, uint uses uint64. same energy, different signedness. 💅

---

🔥 Function Documentation 🔥

🌟 struct ec_node* ec_node_int (const char * id, int64_t min, int64_t max, unsigned int base)

Create a signed integer node. yes bestie, signed. 🌸

Parameters

• id — The node identifier.
• min — The minimum valid value (included).
• max — The maximum valid value (included).
• base — The base to use for parsing. If 0, try to guess from prefix.

Returns

The node, or NULL on error (errno is set). so like… check your return value, bestie, i'm begging 😭

---

💜 int ec_node_int_getval (const struct ec_node * node, const char * str, int64_t * result)

Get the value of a parsed signed integer. this is the one that actually reads your string and hands you the number. iconic. ✨

Parameters

• node — The integer node.
• str — The string to parse.
• result — Pointer where the result will be stored on success.

Returns

0 on success, -1 on error (errno is set). classic zero-for-slaying, minus-one-for-oop. 💀

---

🧚 struct ec_node* ec_node_uint (const char * id, uint64_t min, uint64_t max, unsigned int base)

Create an unsigned integer node. negative numbers? not invited to this party. 🙈

Parameters

• id — The node identifier.
• min — The minimum valid value (included).
• max — The maximum valid value (included).
• base — The base to use for parsing. If 0, try to guess from prefix.

Returns

The node, or NULL on error (errno is set). fr fr, errno is set, so go look at it. 👑

---

💖 int ec_node_uint_getval (const struct ec_node * node, const char * str, uint64_t * result)

Get the value of a parsed unsigned integer. the unsigned sibling, equally slay. 🌈

Parameters

• node — The unsigned integer node.
• str — The string to parse.
• result — Pointer where the result will be stored on success.

Returns

0 on success, -1 on error (errno is set). 💅

---

👑 Author 👑

Generated automatically by Doxygen for Libecoli from the source code. so nobody hand-wrote this and yet she's still serving. we love an auto-generated main character. 🎀

---

lowkey reminder bestie: min and max are included in the valid range, and base of 0 means "try to guess from prefix." that's it, that's the lore. 🍓

Version 0.11.3 💜 dated Thu Apr 9 2026 🌸 — and that's the whole page, bestie. go forth and match some integers. mwah. 💋✨