)IN (lib) filename (name(s))

Imports a Transfer File into the active workspace. Transfer Files are text versions of APL objects that are created by the )OUT command, or equivalent APL functions. They may be created by APLX or by another APL interpreter such as IBM's APL2. The Transfer File format is fully explained under the )OUT and ⎕TF commands. The default file extension for Transfer Files is .atf.

You can import either the whole Transfer File, or just selected items as specified by the 'names' parameter of the command. For example:

             )FNS
             )IN DISPLAY             (Read the whole Transfer File)
             )FNS
       ABSTRACT        DISPLAY DESCRIBE
             )CLEAR
       CLEAR WS
             )IN 3 DISPLAY DESCRIBE  (Read specified objects from Transfer
                                      File in Library 3)
             )FNS                     
       DESCRIBE
             )IN 2 DODO              (Transfer File not found)
       WS NOT FOUND

Library specification and path names

There are two different ways in which you can specify where APLX should look for the Transfer File:

• You can specify the just the base name of the file, for example MYWS or Budget03, optionally preceded by a library number. In this case, APLX appends the default file-extension .atf to the name, and searches for the file in the directory corresponding to the specified library number. Library numbers 0 to 9 are set up either using the Preferences dialog, or by using the ⎕MOUNT system function. Library 10 contains the utility and demonstration workspaces supplied with APLX. If you omit the library number, library 0 is assumed.
• You can specify a full operating-system path name, including directory separation characters, such as /usr/transfer/Budget03.atf (Linux), C:\transfer\Budget03.atf (Windows), or MacHD::transfer:Budget03.atf (MacOS). APLX uses the path name exactly as supplied, so you usually need to provide the .atf file extension explicitly. (Note: In Client-Server implementations of APLX, you can specify that the path refers to the Client or Server machine by preceding the file name with an Up Arrow ↑ or Down Arrow ↓).

See the description of the )LOAD system command for more detail on libraries and path names.