## )CLEAR (wssize)

Clears the current workspace. All objects in the workspace are erased, most system variables revert to their default settings, and the name of the workspace reverts to CLEAR WS.

                 )CLEAR
           CLEAR WS

)CLEAR also optionally changes the workspace size. You can specify a parameter which is the workspace size you want. It must be an integer, and can be specified in bytes, or followed by K or KB for kilobytes, M or MB for megabytes, or G or GB for gigabytes. The valid range is 50 KB to 2 GB (for 32-bit versions of APLX), or up to a theoretical maximum of 8580934592 GB for APLX64.

Depending on the operating system and its configuration, and the amount of memory already in use by APLX tasks, you are likely to be limited in the maximum size of workspace which you can allocate. Thus you may not get the full size requested. In practice also, if the workspace you allocate is larger than the physical RAM in your system, then performance may become be very poor.

For example:

                )CLEAR 1000000
          WS Size = 976KB
          CLEAR WS

                )CLEAR 1024KB
          WS Size = 1.0MB
          CLEAR WS

                )CLEAR 100M
          WS Size = 100MB
          CLEAR WS

                )CLEAR 2G
          WS Size = 484MB
          CLEAR WS

Note that in the last example, the user requested 2GB but the operating system allocated only 484MB.

Example valid only in APLX64:

                )CLEAR 16G
          WS Size = 16GB
          CLEAR WS

Topic: APLX Help : Help on APL language : System Commands : )CLEAR Clear workspace

[ Previous | Next | Contents | Index ]