I-Beam R←{X}(A⌶)Y
I-Beam is a monadic operator that provides a range of system-related services.
Warning
Any service provided using an 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.
A is an integer that specifies the type of operation to be performed – see the table below.
X (optionally, depends on A) and Y are arrays that supply further information about what is to be done and to what.
R is the result.
When attempting to use the I-beam operator with an unsupported operation value A, one of three different error messages will be reported:
- Invalid I-Beam function selection
- I-Beam function A has been withdrawn
- I-Beam function A 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.
Key to restrictions in the following table:
- AIX: AIX only
- LiW: Linux/Windows only
- WF: Microsoft .NET Framework only
- WIN: Microsoft Windows only
- X: AIX/Linux/macOS only
- 64U: 64-bit Unicode only