detect_init(3)

💖 NAME 💖

detect_init — bestie, this is the little function that wakes your Detect structure up and gets it ready for the whole chardet situation ✨

---

🌸 SNOPSIS 🌸

ngl the original spells this heading "SNOPSIS" and honestly? iconic. we keep it. no notes. 💅

#include <chardet.h>
Detect * chardet_init (void);

---

🦋 DESCRIPTION 🦋

okay so. detect_init initializes the Detect structure. that's the whole job, that's the assignment, and it does it 💖

like, you call it, it hands you back a Detect and you're off. that's it. periodt.

---

🫶 RETURN VALUE 🫶

• Returns NULL on false 😭 (so if you get NULL back, the init did not work, and you should absolutely check for that, no cap)
• Returns the Detect structure on success 🎉

and here's what that structure is giving, for reference:

typedef struct Detect_t {
     Detector *detect;
} Detect;

---

🎀 EXAMPLE 🎀

here's the full vibe, copied exactly, go off:

#include <chardet.h>

int main (void) {
     Detect    * d;
     DetectObj * obj;

     if ( (d = detect_init ()) == NULL ) {
          fprintf (stderr, "chardet handle initialize failed\n");
          return CHARDET_MEM_ALLOCATED_FAIL;
     }

     detect_reset (&d);

     if ( (obj = detect_obj_init ()) == NULL ) {
          fprintf (stderr, "Memory Allocation failed\n");
          return CHARDET_MEM_ALLOCATED_FAIL;
     }

     switch (detect_handledata (&d, "¾È³çÇϼ¼¿ä", &obj)) {
          case CHARDET_OUT_OF_MEMORY :
               fprintf (stderr, "On handle processing, occured out of memory\n");
               detect_obj_free (&obj);
               return CHARDET_OUT_OF_MEMORY;
          case CHARDET_NULL_OBJECT :
               fprintf (stderr,
                         "2st argument of chardet() is must memory allocation "
                         "with detect_obj_init API\n");
               return CHARDET_NULL_OBJECT;
     }

     # check support obj->bom with CHARDET_BOM_CHECK constant
     printf ("encoding: %s, confidence: %f, exists bom: %d\n", obj->encoding, obj->confidence, obj->bom);
     detect_obj_free (&obj);
     detect_destroy (&d);

    return 0;
}

like, look at her. she checks the NULL return, she checks the object init, she handles CHARDET_OUT_OF_MEMORY and CHARDET_NULL_OBJECT, she frees everything before she leaves. main character energy fr fr 👑

---

👑 AUTHORS 👑

JoungKyun.Kim <http://oops.org> — thank you for your service, we are obsessed 🫶

---

💀 BUG REPORTS 💀

Use QnA board on https://github.com/Joungkyun/libchardet/issues

like if something's broken, that's the spot, go tell them there, don't suffer in silence bestie 🙈

---

🌈 SEE ALSO 🌈

• detect_obj_init(3)
• detect_obj_free(3)
• detect_reset(3)
• detect_handledata(3)
• detect_destroy(3)

the whole friend group, love that for them 💜

---

okay that's the page, mwah 💋 this came from the libchardet manuals, dated 2019-08-01, for detect_init(3) — go forth and initialize responsibly, bestie 🦋✨