BAP Online Manuals : Library Reference : Library by Name : rem_handle
Previous: reload
Next: remove

6.2.108. rem_handle

gets the value associated to a virtual handle and removes it

SYNOPSIS

INCLUDE 'msglib.h'
rem_handle(file,FileHandle,"DEMONSTRATION")

SYNTAX

rem_handle(VirtualHandle,RealHandle,ErrorString)(i,o,i)

ARGUMENTS

handle(VirtualHandle) (i) virtual handle to be evaluated
void(RealHandle) (i) value associated with the virtual handle
string(ErrString) (i) string printed in case of misuse

DESCRIPTION

Acts similar to handle_value (), but additionally removes the association between the virtual and the real handle. Please consult the handle_value() () description for details.

EXAMPLE

new_file(my_data,"Hello World",user_string,"OPEN 
DATA").
....
handle_value(my_data,X,"GET DATA"),
write(X),nl.
....
rem_handle(my_data,_,"LOSE DATA").

ERRORS

A runtime error occurs if an invalid handle is given.

LAYERS

prolog-process, client-server, object

RELATED PREDICATES

new_handle , handle_value


BAP Online Manuals : Library Reference : Library by Name : rem_handle
Previous: reload
Next: remove