transfer( char, location )

Transfer target CH to location.

Returns false if location is not valid. Also returns false if CH could not be transferred due to prog trigger (see [[:triggers:enterandexit|enter and exit triggers]]).\\
Returns true if transfer completed.

'location' argument can be a room vnum, "random", "wrandom", or mob/object keyword.

"random" and "wrandom" will have the same effect, which is to use a random in-game room.

<code lua>
local pc=getpc("Astark")

if pc then
    sendtochar( pc, "Transfer to 31404...\n\r")
    transfer( pc, 31404 )
    sendtochar( pc, "Transfer to random...\n\r")
    transfer( pc, "random" )
    sendtochar( pc, "Transfer to wrandom...\n\r")
    transfer( pc, "wrandom" )
    sendtochar( pc, "Transfer to cid...\n\r")
    transfer( pc, "cid" )
    sendtochar( pc, "Transfer to south fountain...\n\r")
    transfer( pc, "south fountain" )
end
</code>