Handle Objects

DESCRIPTION:

Deallocates a S-PLUS handle object. The given handle will be marked as no longer in use.

Note: This function is deprecated. For more information, see .

USAGE:

handle.free(x) 

REQUIRED ARGUMENTS:

x
a S-PLUS handle object.

VALUE:

Invisibly returns the passed in argument x.

SIDE EFFECTS:

The "inuse" flag for the specified handle x is cleared. After calling handle.free , the function handle.inuse will always return FALSE.

DETAILS:

An "inuse" flag is maintained for each handle. The flag is set when the handle is created with the handle function and cleared with the handle.free function.

SEE ALSO:

,

EXAMPLES:

current.handle <- handle("toyHandle") 
current.handle 
# Above command produces this output: 
Handle 816651124 type = toyHandle : Valid Inuse 
handle.free(current.handle) 
current.handle 
# Above command produces this output: 
Handle 816651124 type = toyHandle : Valid NotInuse