XMREPTYPEGETRECORD(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

πŸ’– XmRepTypeGetRecord πŸ’–

okay bestie, so this one is XmRepTypeGetRecord and it lives in the library call manual, section 3 β€” it's a representation type manager function, and it's here to hand you the deets on a rep type. that's the whole vibe. periodt. πŸŽ€


✨ NAME ✨

XmRepTypeGetRecord β€” a representation type manager function that returns information about a representation type πŸ¦‹


🌸 SYNOPSIS 🌸

#include <Xm/RepType.h>
XmRepTypeEntry XmRepTypeGetRecord(
XmRepTypeId rep_type_id);

πŸ’… DESCRIPTION πŸ’…

so XmRepTypeGetRecord goes and retrieves information about a particular representation type that is registered with the representation type manager. like, you point at the one you want and it comes back with the whole lore. πŸ‘‘

and here's the thing bestie, it allocates memory for the returned data β€” which means you own that memory now. the application must free it using XtFree. no cap. don't be out here leaking, that's not the vibe. 😭

  • rep_type_id β€” the identification number of the representation type. it's how the manager knows which one you're talking about. iykyk.

the representation type entry structure contains the following information:

typedef struct
{
        String  rep_type_name;
        String  *value_names;
        unsigned char   *values;
        unsigned char   num_values;
        Boolean reverse_installed;
        XmRepTypeId     rep_type_id;
} XmRepTypeEntryRec, *XmRepTypeEntry;
(void)
not me leaving the (void) in there exactly as it was β€” if it's in the original it stays in mine, fr fr. πŸ’€

and here's what every single one of those fields means, one by one, no skips:

  • rep_type_name β€” the name of the representation type 🏷️
  • value_names β€” an array of representation type value names
  • values β€” an array of representation type numerical values πŸ”’
  • num_values β€” the number of values associated with the representation type
  • reverse_installed β€” a flag that indicates whether or not the reverse converter is installed πŸ”
  • rep_type_id β€” the identification number of the representation type (yes, again, it's in the struct too, she contains multitudes πŸ’–)

🌈 RETURN 🌈

returns a pointer to the representation type entry structure that describes the representation type. that's it, that's the whole gift. 🎁


go read those next, bestie, they're the rest of the friend group. ✨


and that's a wrap on XmRepTypeGetRecord(library call) β€” straight from the library call corner of the manual, footer and all, no date drama, just the title doing its little sign-off. mwah. πŸ’…πŸŒΈπŸ¦‹