XMCONTAINERCUT(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

πŸ’– XmContainerCut β€” bestie's guide to yeeting items onto the clipboard πŸ’–

okay so this one is XmContainerCut, and it lives in the library call section of the manual. she's a Container widget function, and her whole job? moving items to the clipboard. that's it. that's the girl. ✨


🌸 SYNOPSIS 🌸

#include <Xm/Container.h>
Boolean XmContainerCut(
Widget container,
Time timestamp);

πŸ¦‹ DESCRIPTION πŸ¦‹

so XmContainerCut cuts the primary selected items to the clipboard. the primary selected items. not all of them, not some random ones β€” the primary selection. she knows what she's doing. πŸ’…

here's the tea on how she does it: this routine calls the XmNconvertCallback procedures, possibly multiple times, with the selection member of the XmConvertCallbackStruct set to CLIPBOARD and with the parm member set to XmMOVE. so yeah, she's out here doing the callback thing repeatedly, no big deal, main character behavior fr fr.

and then β€” and this is the part where she really eats β€” if the transfer is successful, this routine then calls the XmNconvertCallback procedures for the CLIPBOARD selection and the DELETE target. πŸ”₯

  • container β€” specifies the Container widget ID. that's your container bestie, the one you're cutting from 🫢
  • timestamp β€” specifies the server time at which to modify the selection value. yes, time. server time. she's punctual like that ⭐
for a complete definition of Container and its associated resources, see XmContainer(3). iykyk, go read it, it's right there πŸ’œ

🌈 RETURN 🌈

the function returns False in the following cases, and listen, this is important, no cap:

  • if the primary selection is NULL 😭
  • if the widget does not own the primary selection 😭
  • if the function is unable to gain ownership of the clipboard selection 😭

otherwise? it returns True. and that's the vibe check passing. slay. πŸ‘‘



and that's the whole page bestie β€” straight from the XmContainerCut(library call) manual, library call energy and all, with no date stamp on her so she's timeless, lowkey iconic, she stays serving. periodt. πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ«Ά