rem_handle
BAP Online Manuals : Library
Reference : Library by Name
: rem_handle
Previous: reload
Next: remove
BAP Online Manuals : Library Reference : Library by Name : rem_handle
Previous: reload
Next: remove
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
BAP Online Manuals : Library Reference : Library by Name : rem_handle
Previous: reload
Next: remove