DragonFly On-Line Manual Pages

RKXFER(3)             DragonFly Library Functions Manual             RKXFER(3)

NAME
       RRkkXXffeerr - change the current candidate

SYNOPSIS
       ##iinncclluuddee <<ccaannnnaa//RRKK..hh>>
       iinntt RRkkXXffeerr((ccxxnnuumm,, kknnuumm))
       iinntt ccxxnnuumm;;
       iinntt kknnuumm;;

DESCRIPTION
       RkXfer sets the candidate with a specified candidate number knum as the
       current candidate.  The candidate number must be 0 or greater but less
       than the highest candidate number in the current clause.  The current
       clause does not change when a candidate number outside this range is
       specified.

RETURN VALUE
       If successful, this function moves the current candidate in the context
       and returns the candidate number after the move.  It returns 00, without
       doing anything, if it has been run in a nonconversion mode context.

                                                                     RKXFER(3)