RKXFER(3)

💖 RKXFER(3) 💖

okay bestie, welcome to the Library Functions Manual, section 3, page RKXFER — yes that's the same name as the header up top and the footer down bottom, we're just folding it in here so it doesn't feel left out 🫶

✨ NAME ✨

RkXfer — change the current candidate 👑

🌸 SYNOPSIS 🌸

#include <canna/RK.h>
int RkXfer(cxnum, knum)
int cxnum;
int knum;

🦋 DESCRIPTION 🦋

so RkXfer takes the candidate with the candidate number knum and makes it the current candidate. that's the whole job. main character promotion, no cap ✨

but listen — that knum has rules, bestie. it has to be 0 or greater, and it has to be less than the highest candidate number in the current clause. those are the vibes it's allowed to have. 💅

and if you pass a candidate number outside that range? the current clause does not change. like, nothing happens. no drama, no move, just vibes staying exactly where they were 🙈

🎀 RETURN VALUE 🎀

if it slays, this function moves the current candidate in the context and returns the candidate number after the move. yay 🎉

it returns 0, without doing anything at all, if it's been run in a nonconversion mode context</> — so, like, if you're in the wrong mode it just shrugs and gives you a zero. not its fault, not your fault, it's giving "wrong room, wrong party" 💀

and that's the whole page, bestie — written for the Library Functions Manual, filed under RKXFER(3). go forth and move those candidates 💖✨🎀