cs_register_fileload(3)

💖 cs_register_fileload(3) 💖

okay bestie, so this is a page from the <cs/cs.h> manual — yes, the cs/cs.h one — and it's about teaching the parser how to go find your files. sit down, hydrate, let's go 🫶

✨ NAME ✨

cs_register_fileload — register a fileload function

🌸 SYNOPSIS 🌸

#include <cs/cs.h>

void cs_register_fileload(CSPARSE *parse, void *ctx, CSFILELOAD fileload);

🎀 ARGUMENTS 🎀

• parse — a pointer to an initialized CSPARSE structure. like, it has to be initialized already, don't come at me with a half-baked struct 💅
• ctx — pointer that is passed to the CSFILELOAD function when called
• fileload — a CSFILELOAD function

🦋 DESCRIPTION 🦋

cs_register_fileload registers a fileload function that overrides the built-in function. not "adds alongside", not "suggests to" — overrides. main character energy, it replaces the default. 👑

So what's the default doing, you ask? The built-in function uses hdf_search_path and ne_file_load (based on stat/open/read) to find and load the file on every template render. every. single. render. it's giving "walking to the fridge every time you want a snack" ngl.

You can override this function if you wish to provide other template search functions, or load the template from an in-memory cache, etc. so like — want a different search path strategy? slay. want to pull templates out of RAM so you're not hitting the disk every render? highkey iconic. do it.

This fileload function will be used by cs_parse, including

include: commands in the template.

so yes, include: directives in your templates go through your custom loader too. no escape routes, babe 🌈

⭐ RETURN VALUE ⭐

None. it returns nothing. void. empty. it just does the thing and leaves. mystery, elegance, periodt. 💀

🔥 SEE ALSO 🔥

• cs_dump(3)
• cs_destroy(3)
• cs_render(3)
• cs_register_esc_strfunc(3)
• cs_arg_parsev(3)
• cs_register_fileload(3)
• cs_init(3)
• cs_register_strfunc(3)
• cs_arg_parse(3)
• cs_parse_string(3)
• cs_parse_file(3)
• =(3)
• cs_register_function

(yes =(3) is really in there, i don't make the rules, i just make them cute 🧚)

lowkey reminder: your custom fileload fully replaces the built-in search, so if it can't find a file, nobody's swooping in to save you. no cap.

and that's the whole page, bestie!! this one's from ClearSilver, dated 12 July 2007 — vintage but still serving. go register something cute. bye 💜✨🎀