KDK_PRINTER_GET_LIST(3)

💖 KDK_PRINTER_GET_LIST(3) 💖

okay bestie, sit DOWN, because we're about to meet the little function that knows every single printer in your house, the working ones AND the dusty ones that have been broken since 2019 🖨️✨

it lives in the Library Functions Manual section, it's page KDK_PRINTER_GET_LIST(3), and honestly? it's giving main character energy.

---

🌸 NAME 🌸

kdk_printer_get_list — 获取本地的所有打印机(包含可用打印机和不可用打印机)

literally: grab all the local printers, both the ones that actually work and the ones that are just there, vibing, being useless. no printer left behind, periodt. 💅

---

🎀 SYNOPSIS 🎀

#include <libkyprinter.h>

extern char** kdk_printer_get_list();

Link with -lkyprinter.

---

✨ Detailed Description ✨

so the whole job of this interface, the reason it exists, its entire purpose in life, is to obtain all printers locally — and yes that means both available and unavailable ones. the icons AND the flops. the ones that print your essay and the ones that just make a sad little noise. 🫶

---

💜 RETURN VALUE 💜

• On success — you get a list of printer names of type char**, and it ends with a NULL string. it's generated by alloc, so bestie you have to recycle it with kdk_printer_freeall. do not ghost it, do not leak it, free your memory it's the bare minimum 😭
• On error — it returns NULL. that's it. that's the whole vibe check and you failed it.

---

🌈 EXAMPLES 🌈

here's the whole thing in action, copy-paste blessed:

#include "libkyprinter.h"
#include <stdio.h>

int main()
{
    int index = 0;
    //获取全部打印机列表
    char **printers = kdk_printer_get_list();
    while (printers[index])
    {
        int status = kdk_printer_get_status(printers[index]);
        printf("%zd: %s , %d0, index + 1, printers[index], status);
        index++;
    }
    kdk_printer_freeall(printers);
    //获取可用打印机列表
    index = 0;
    char **available_printers = kdk_printer_get_available_list();
    while (available_printers[index])
    {
        int status = kdk_printer_get_status(available_printers[index]);
        printf("%zd: %s , %d0, index + 1, available_printers[index], status);
        index++;
    }
    kdk_printer_freeall(available_printers);

    return 0;
}

see how it grabs everything first, prints the list, then frees with kdk_printer_freeall? and then it goes back for round two with kdk_printer_get_available_list() — the ✨only the good ones✨ edition — and frees that too. responsible queen behavior. free your lists, both times. 👑

---

🦋 CONFORMING TO 🦋

These functions are as per the withdrawn POSIX.1e draft specification. (withdrawn, as in, it left the group chat. but we still stan. 💀)

The following functions are Linux extensions — so they're the extra-special homegrown ones:

• kdk_printer_get_available_list()
• kdk_printer_set_options()
• kdk_printer_print_download_remote_file()
• kdk_printer_print_local_file()
• kdk_printer_cancel_all_jobs()
• kdk_printer_get_status()
• kdk_printer_get_job_status()
• kdk_printer_get_filename()
• kdk_printer_freeall()

---

⭐ SEE ALSO ⭐

go read these next, i'm obsessed with them actually:

• kdk_printer_get_available_list(3)
• kdk_printer_set_options(3)
• kdk_printer_print_download_remote_file(3)
• kdk_printer_print_local_file(3)
• kdk_printer_cancel_all_jobs(3)
• kdk_printer_get_status(3)
• kdk_printer_get_job_status(3)
• kdk_printer_get_filename(3)
• kdk_printer_freeall(3)

---

and that's the whole page, bestie!! this one's from the Linux Programmer's Manual, dated Fri Aug 25 2023 — so it's vintage, it's iconic, it ate. now go free your char** before i check on you. mwah 💖💅✨