LIBJODYCODE(7)

💖 LIBJODYCODE 💖

okay bestie, sit down, hydrate, because i'm about to introduce you to the library that keeps a whole family of tools from falling apart. it's called libjodycode — shared code used by several tools written by Jody Bruchon. yes that's the whole vibe. it's a section 7 page (miscellaneous, not a command you run, it's a thing you link against) 🎀

---

✨ SYNOPSIS ✨

#include <libjodycode.h>

🚨 Alarm API

int jc_alarm_ring
int jc_start_alarm(const unsigned int seconds, const int repeat)
int jc_stop_alarm(void)

🗄️ Cacheinfo API

void jc_get_proc_cacheinfo(struct jc_proc_cacheinfo *pci)

😭 Error API

const char *jc_get_errname(int errnum)
const char *jc_get_errdesc(int errnum)
int jc_print_error(int errnum)

🧮 jodyhash API

int jc_block_hash(jodyhash_t *data, jodyhash_t *hash, const size_t count)

💀 OOM (out-of-memory) API

void jc_oom(const char * const restrict msg)
void jc_nullptr(const char * restrict func)a

🛤️ Paths API

int jc_collapse_dotdot(char * const path)
int jc_make_relative_link_name(const char * const src, const char * const dest, char *rel_path)

📏 Size Suffix API

const struct jc_size_suffix jc_size_suffix[]

🔢 Sort API

int jc_numeric_sort(char * restrict c1, char * restrict c2, int sort_direction)

⏰ String-to-epoch API

time_t jc_strtoepoch(const char * const datetime)

🧵 String API

int jc_strncaseeq(const char *s1, const char *s2, size_t len)
int jc_strcaseeq(const char *s1, const char *s2)
int jc_strneq(const char *s1, const char *s2, size_t len)
int jc_streq(const char *s1, const char *s2)

👑 Version API

const char *jc_version
const char *jc_verdate
const int jc_api_version
const int jc_api_featurelevel
const int jc_jodyhash_version
const unsigned char jc_api_versiontable[]

🪟 Windows stat() API

time_t jc_nttime_to_unixtime(const uint64_t * const restrict timestamp)
time_t jc_unixtime_to_nttime(const uint64_t * const restrict timestamp)
int jc_win_stat(const char * const filename, struct jc_winstat * const restrict buf)

🌈 Windows Unicode API

int jc_fwprint(FILE * const restrict stream, const char * const restrict str, const int cr)
void jc_slash_convert(char *path)
void jc_set_output_modes(unsigned int modes)
int jc_widearg_to_argv(int argc, wchar_t **wargv, char **argv)

🦋 Windows Unicode conversion shortcut definitions

M2W(char *a, JC_WCHAR_T *b) : convert string a to wide string b using MultiByteToWideChar()

W2M(JC_WCHAR_T *a, char *b) : convert wide string a to normal string b using WideCharToMultiByte()

---

💅 DESCRIPTION 💅

so basically, libjodycode is a software code library containing code shared among several of the programs written by Jody Bruchon, like imagepile, jdupes, winregfs, and zeromerge. 🫶

the origin story? those shared pieces of code used to get copied between each program as they were updated. but as the number of programs increased and keeping those copies synced became more and more annoying 😭, the decision was made to combine all of them into a single reusable shared library. and that, bestie, is the glow-up. periodt. ✨

---

📝 NOTES 📝

libjodycode is created and maintained by Jody Bruchon <jody@jodybruchon.com> 💜

General information, help, and tech info: https://www.jdupes.com/ 🌐

Development, source code, releases: https://codeberg.org/jbruchon/libjodycode 🛠️

if you find this software useful, please consider financially supporting its development through the author's home page, no pressure but like… if you're feeling generous 🥺:

https://www.jodybruchon.com/ 💸

---

⚖️ LICENSE ⚖️

MIT License 🎀

Copyright (c) 2014-2025 Jody Lee Bruchon <jody@jodybruchon.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

and that's the whole page bestie!! version 3.1, dated 2025-03-08, filed under LIBJODYCODE(7) in your manual. go forth and share some code, you're gonna slay 💖✨🦋