// compile.asm:	WORD p_load_file,'LOAD-FILE'

anchor:p_load_file[]

=== Word: LOAD-FILE

....
data stack: ( chaz* -- * 0/1 )
....

"LOAD-FILE" is a function word that evaluates a text file. It opens a
file via xref:p_open_file[OPEN-FILE] and sets up a stream with a
buffer of <<p_load_buffer_size,LOAD-BUFFER-SIZE>> bytes for
reading it. The stream is passed to
<<p_evaluate_stream,EVALUATE-STREAM>> for processing its words. Upon
its return the file is closed and the stream memory is reclaimed, and
then the function returns whatever
<<p_evaluate_stream,EVALUATE-STREAM>> returns.