I-Beam R←{X}(A⌶)Y
I-Beam is a monadic operator that provides a range of system related services.
Warning
Although documentation is provided for I-Beam functions, any service provided using I-Beam should be considered as "experimental" and subject to change – without notice - from one release to the next. Any use of I-Beams in applications should therefore be carefully isolated in cover-functions that can be adjusted if necessary. See also: RIDE and Experimental Features-related I-Beams.
A is an integer that specifies the type of operation to be performed as shown in the table below. Y is an array that supplies further information about what is to be done.
X may or may not be required depending on A.
R is the result of the derived function.
When attempting to use I-Beam with an unsupported operation value, A, one of three different error messages will be reported:
- Invalid I-Beam function selection
- I-Beam function xxx has been withdrawn
- I-Beam function xxx is not supported by this interpreter
This allows the user to distinguish between operation values that have never been used, those that have been used in earlier versions but are no longer included in the current version, and those that are valid in other editions or on other platforms other than the current interpreter.
The column labelled O/S indicates if a function applies only on Windows (W), only on Windows .NET Framework, (WF), only under IBM AIX (AIX), or only on non-Windows (X) platforms.