System WSID: Difference between revisions

From NARS2000
Jump to navigationJump to search
No edit summary
(combine both articles)
Line 1: Line 1:
<h1>{quad}WSID - Set or Retrieve Workspace ID<br/>
<h1>{quad}WSID - Set or retrieve Workspace ID<br/><br/>
)WSID - Name the current workspace</h1>
)WSID - Display or Name the Current Workspace</h1>
{{BoxStart|<apll>Z←⎕WSID</apll>
<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
|returns the current file name of the workspace.}}
<tr>
{{BoxEnd|<apll>Z</apll> is a string.}}
  <td>
<br />
    <table border="0" cellpadding="5" cellspacing="0" summary="">
    <tr>
      <td valign="top"><apll>Z←⎕WSID</apll></td>
      <td></td>
      <td></td>
      <td>returns the current file name of the workspace.</td>
    </tr>
    <tr>
    <td><apll>Z</apll> is a string.</td>
    </tr>
    <tr>
      <td valign="top"><apll>{quad}WSID{assign}R</apll></td>
      <td></td>
      <td></td>
      <td>sets the name of the workspace to the value of <apll>R</apll>.</td>
    </tr>
    <tr>
      <td colspan=4><hr/></td>
    </tr>
    <tr>
      <td valign="top"><apll>)WSID</apll></td>
      <td></td>
      <td></td>
      <td>displays the current workspace name or CLEAR WS.</td>
    </tr>
    <tr>
      <td valign="top"><apll>)WSID name</apll></td>
      <td></td>
      <td></td>
      <td>Sets the workspace name to ''name''. The prior name is displayed</td>
    </tr>


{| border="1" cellpadding="5" cellspacing="0" rules="none" summary=""
    </table>
|-
  </td>
||<apll>⎕WSID←R</apll>
</tr>
||sets the name of the workspace to the value of <apll>R</apll>.
</table>
|}
<br />
<br />
For a clear WS, ⎕WSID will return null; for a named WS, will return the full file name of the current workspace. NARS2000 will not validate the string passed to {quad}WSID, you must be certain it is a valid file name. A workspace name may include spaces; in fact, you can only insert spaces within the workspace name through the '''⎕WSID''' system variable; the [[System Command WSID|)WSID]] command will truncate a workspace name at the first space.
When you begin using an APL interpreter, the Session Manager presents you with a blank screen, and your workspace has a blank name, it's known as a CLEAR WS. In order to be able to save your workspace, you must give it a name. You can do this without saving the workspace, by issuing a ''')WSID''' command followed by the workspace name, or assigning the name to the '''{quad}WSID''' system variable.  You can also name the workspace with the [[System Command SAVE|)SAVE]] command.
 
This example is from Windows 7:<br/>
<apll>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid<br/>
IS CLEAR WS<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid<br/>
<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid april<br/>
WAS CLEAR WS<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\april<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid<br/>
IS april<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid←'March'<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid<br/>
IS March<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\March<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid←'This is My Workspace'<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid<br/>
IS This is My Workspace<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is My Workspace<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)WSID This is mine<br/>
WAS This is My Workspace<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;⎕WSID<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This<br/>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)wsid<br/>
IS This</apll><br/>


<br/>
For a clear WS, ⎕WSID will return null; for a named WS, will return the full file name of the current workspace.


{{System Variables}}
Issuing the )WSID command without an argument lists the current name of the workspace. Otherwise it changes the name of the workspace to the argument and reports the prior name. Because a space is a value separator, you cannot give a workspace a name with spaces in it through the )WSID command, the name will be chopped at the first space; underlines may be used instead. If you want to create a name with a space you must use the {quad}WSID system function instead. Case is preserved on the )WSID argument.


NARS2000 will not validate the string passed to )WSID nor to {quad}WSID, you must be certain it is a valid file name. A workspace name specified by the {quad}WSID system vsriable may include spaces; the )WSID command will truncate a workspace name at the first space.


<h1></h1>
This example is from Windows 7:<br/>
When you begin using the APL interpreter, the Session Manager presents you with a blank screen, and your workspace has a blank name, it's known as a CLEAR WS. In order to be able to save your workspace, you must give it a name. You can do this without saving the workspace, by issuing a ''')WSID''' command followed by the workspace name.  You can also name the workspace by doing the same thing with the [[System Command SAVE|)SAVE]] command.
<tt>
 
:)wsid<br/>
Issuing the )WSID command without an argument lists the current name of the workspace. Otherwise it changes the name of the workspace to the argument and reports the prior name. Because a space is a value separator, you cannot give a workspace a name with spaces in it, the name will be chopped at the first space; underlines may be used instead. If you want to create a name with a space you must use the {quad}WSID system function instead. Case is preserved on the WSID argument.
IS CLEAR WS<br/>
 
The command works like this:<code><br/>
:)WSID<br/>
:)WSID<br/>
IS CLEAR WS<br/>
IS CLEAR WS<br/>
:⎕wsid<br/>
<br/>
:)wsid / {comment} Note this is a bad name
WAS CLEAR WS
:)wsid
IS /
:)wsid big<br/>
:)wsid big<br/>
WAS CLEAR WS<br/>
WAS /<br/>
:)wsid hello there<br/>
:)wsid hello there<br/>
WAS big<br/>
WAS big<br/>
Line 69: Line 75:
:)wsid
:)wsid
IS Mixed_Case
IS Mixed_Case
           
:)wsid april<br/>
</code>
WAS Mixed_Case<br/>
:⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\april<br/>
:)wsid<br/>
IS april<br/>
:⎕wsid←'March'<br/>
:)wsid<br/>
IS March<br/>
:⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\March<br/>
:⎕wsid←'This is My Workspace'<br/>
:)wsid<br/>
IS This is My Workspace<br/>
:⎕wsid<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is My Workspace<br/>
:)WSID This is mine<br/>
WAS This is My Workspace<br/>
:⎕WSID<br/>
C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This<br/>
:)wsid<br/>
IS This</tt><br/>


The equivalent System Variable to allow a function to set or retrieve the workspace name is [[System Variable WSID|{quad}WSID]].


{{System Variables}}
{{Commands}}
{{Commands}}
{{article footer}}
{{article footer}}

Revision as of 00:42, 27 November 2014

⎕WSID - Set or retrieve Workspace ID

)WSID - Display or Name the Current Workspace

Z←⎕WSID returns the current file name of the workspace.
Z is a string.
⎕WSID←R sets the name of the workspace to the value of R.

)WSID displays the current workspace name or CLEAR WS.
)WSID name Sets the workspace name to name. The prior name is displayed


When you begin using an APL interpreter, the Session Manager presents you with a blank screen, and your workspace has a blank name, it's known as a CLEAR WS. In order to be able to save your workspace, you must give it a name. You can do this without saving the workspace, by issuing a )WSID command followed by the workspace name, or assigning the name to the ⎕WSID system variable. You can also name the workspace with the )SAVE command.

For a clear WS, ⎕WSID will return null; for a named WS, will return the full file name of the current workspace.

Issuing the )WSID command without an argument lists the current name of the workspace. Otherwise it changes the name of the workspace to the argument and reports the prior name. Because a space is a value separator, you cannot give a workspace a name with spaces in it through the )WSID command, the name will be chopped at the first space; underlines may be used instead. If you want to create a name with a space you must use the ⎕WSID system function instead. Case is preserved on the )WSID argument.

NARS2000 will not validate the string passed to )WSID nor to ⎕WSID, you must be certain it is a valid file name. A workspace name specified by the ⎕WSID system vsriable may include spaces; the )WSID command will truncate a workspace name at the first space.

This example is from Windows 7:

)wsid

IS CLEAR WS

)WSID

IS CLEAR WS

⎕wsid


)wsid / ⍝ Note this is a bad name

WAS CLEAR WS

)wsid

IS /

)wsid big

WAS /

)wsid hello there

WAS big

)wsid

IS hello

)wsid x_5

WAS hello

)wsid

IS x_5

)Wsid Mixed_Case

WAS x_5

)wsid

IS Mixed_Case

)wsid april

WAS Mixed_Case

⎕wsid

C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\april

)wsid

IS april

⎕wsid←'March'
)wsid

IS March

⎕wsid

C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\March

⎕wsid←'This is My Workspace'
)wsid

IS This is My Workspace

⎕wsid

C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is My Workspace

)WSID This is mine

WAS This is My Workspace

⎕WSID

C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This

)wsid

IS This


System Variables (A value may be assigned to these except for ⎕DM)
ALX CT DM DT ELX FC FEATURE FPC IC IO
LR LX PP PR PW RL SA WSID
Niladic System Functions (a value cannot be assigned to these)
A AV EM ET LC NNAMES NNUMS SI SYSID SYSVER
T TC TCBEL TCBS TCESC TCFF TCHT TCLF TCNL TCNUL
TS WA
Monadic or dyadic system functions (a value cannot be assigned to these)
AT CR DC DFT DL DR EA EC ERROR ES
EX FMT FX MF NAPPEND NC NCREATE NERASE NINFO NL
NLOCK NREAD NRENAME NREPLACE NRESIZE NSIZE NTIE NUNTIE STOP TF
TRACE UCS VR
Note that quad functions and variables (except for the ⎕A family of functions) are case insensitive
System Commands (not case sensitive)
)CLEAR )CLOSE )COPY )DROP )EDIT )ERASE )EXIT )FNS )FOP )FOPS
)IN )INASCII )LIB )LOAD )NEWTAB )NMS )OFF )OPEN )OPS )OUT
)RESET )SAVE )SI )SIC )SINL )SYMB )ULIB )VARS )XLOAD )WSID


See Also
System Commands System Variables and Functions Operators


Keyboard
A+S
Alt ¨ ¯ < > × ÷
Sh ~ ! @ # $ % ^ & * ( ) _ +
Key ` 1 2 3 4 5 6 7 8 9 0 - =
A+S
Alt ? § π
Sh Q W E R T Y U I O P { } |
Key q w e r t y u i o p [ ] \
A+S
Alt
Sh A S D F G H J K L : "
Key a s d f g h j k l ; '
A+S χ
Alt
Sh Z X C V B N M < > ?
Key z x c v b n m , . /
NARS 2000 Lang
Tool
Bar
+ - × ÷ * ! ? |
< = >
~ § π .. ,
/ \ ¨ .
_ ¯
Second Row i j k i j k l g p r v x

[[Category:Mouse Group {{{1}}}|{{{2}}}]]