Loads a file, URL, or string. Binds words to global context. Load is a native value.

source

(Type: file url string any-block binary)

/header

Includes Rebol header object if present.

/next

Load the next value only. Return block with value and new position.

/library

Force file to be a dynamic library. (Command version)

/markup

Convert HTML and XML to a block of tags and strings.

/all

Load all values. Does not evaluate Rebol header.

Reads and converts external data, including programs, data structures, images, and sounds into memory storage objects that can be directly accessed and manipulated by programs. The argument to LOAD can be a file, URL, string, or binary value. When a file name or URL is provided, the data is read from disk or network first, then it is loaded. In the case of a string or binary value, it is loaded directly from memory. Here are a few examples of using LOAD:

script: load %dict-notes.r
image: load %image.png
sound: load %whoosh.wav

;data: load http://www.rebol.com/example.r
;data: load ftp://ftp.rebol.com/example.r

data: load "1 2 luke [email protected]"
code: load {loop 10 [print "hello"]}

LOAD is often called for a text file that contains Rebol code or data that needs to be brought into memory. The text is first searched for a Rebol header, and if a header is found, it os evaluated first (however, unlike the DO function, LOAD does not require that there be a header). If the load results in a single value, it will be returned. If it results in a block, the block will be returned. No evaluation of the block will be done; however, words in the block will be bound to the global context. If the header object is desired, use the /HEADER option to return it as the first element in the block. The /ALL refinement is used to load an entire script as a block. The header is not evaluated. The /NEXT refinement returns a block consisting of two elements. The first element is the first value loaded in the series. The second element is the original series with the current index just past the loaded value.

data: load "11 22 33 44"
print third data

set [value data] load/next data
print value

print data