ZIP_SET_FILE_COMMENT(3)

πŸ“¦
version 1.11.4 Β· 3 versions
, in arch rolling, debian trixie, fedora 43, fedora 44, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ ZIP_SET_FILE_COMMENT(3) ✨

ok so bestie, we're in the Library Functions Manual section of the ZIP_SET_FILE_COMMENT(3) page and it's giving "vintage but still iconic" πŸ’… because this function is literally the obsolete interface. it's the grandma of comment-setters. we respect her. we just don't call her anymore. periodt. πŸŽ€


🌸 NAME 🌸

zip_set_file_comment β€” set comment for file in zip (obsolete interface)


πŸ“š LIBRARY πŸ“š

libzip (-lzip)


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <zip.h>

int
zip_set_file_comment(zip_t *archive, zip_uint64_t index,
    const char *comment, int len);

πŸ’– DESCRIPTION πŸ’–

okok so here's the tea β˜• β€” zip_set_file_comment() is the obsolete version of zip_file_set_comment(3). like, the old model. the original recipe. πŸ“

the only differences between them are:

  • the type of the len argument, and
  • the extra flags argument that the new one has and this one doesn't.

and that's it. no cap. so zip_set_file_comment() is literally the same as calling zip_file_set_comment(3) with an empty flags argument. that's the whole vibe. 🫢

⚠️ bestie this one is obsolete β€” if you're writing new code, go say hi to zip_file_set_comment(3) instead πŸ’œ

πŸ‘€ SEE ALSO πŸ‘€


πŸ“œ HISTORY πŸ“œ

so the timeline is giving main character arc ✨:

  • zip_set_file_comment() was added in libzip 0.7. πŸŽ‰
  • in libzip 0.10, the type of index was changed from int to zip_uint64_t. glow-up fr fr.
  • it was deprecated in libzip 0.11 β€” so like, use zip_file_set_comment() instead. no more old interface, babe. πŸ’…

πŸ‘‘ AUTHORS πŸ‘‘

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> β€” absolute icons, we love them, mwah 😚


and that's the whole page bestie!! this one came from the Debian crew, dated December 18, 2017, and it lives under ZIP_SET_FILE_COMMENT(3) πŸŽ€βœ¨ go set some comments, but do it the non-obsolete way, i'm begging πŸ’–πŸ¦‹