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)