Availability:C-language interface function
int PL_unify_stream(term_t
t, IOSTREAM *s)Unify t with a blob that points at s.
Note that a blob provides a unique and reliable reference to a stream.
Blobs are subject to atom garbage collection. If an open stream
is garbage collected the behaviour depends on the Prolog flag
agc_close_streams.
See also Sgcclose().
The blob is a thread-local blob (see PL_BLOB_LOCAL in section
12.4.10.1): the thread that creates it reclaims it as soon as it is
no longer referenced. If closing is needed, this is left to the atom
garbage collector.