System WSID - Revision history

Paul Robinson: t/c

2019-10-13T20:55:57Z

t/c

← Older revision		Revision as of 16:55, 13 October 2019
Line 106:		Line 106:
	{{Commands\|WSID}}		{{Commands\|WSID}}
	{{Article footer\|0\|NO}}		{{Article footer\|0\|NO}}
			[[Category:System variables]]

Paul Robinson: t/c

2019-10-13T20:53:00Z

t/c

← Older revision		Revision as of 16:53, 13 October 2019
Line 104:		Line 104:

	{{System Variables}}		{{System Variables}}
	{{Commands}}		{{Commands\|WSID}}
	{{~~article~~ footer}}		{{Article footer\|0\|NO}}

WikiSysop at 16:51, 16 April 2018

2018-04-16T16:51:16Z

← Older revision		Revision as of 12:51, 16 April 2018
Line 1:		Line 1:
	<h1>~~{quad}WSID~~ - Set or retrieve Workspace ID<br/><br/>		<h1><aplxx>⎕WSID</aplxx> - Set or retrieve Workspace ID<br/><br/>
	)WSID - Display or Name the Current Workspace</h1>		<aplxx>)WSID</aplxx> - Display or Name the Current Workspace</h1>
	<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">		<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
	<tr>		<tr>
Line 12:		Line 12:
	</tr>		</tr>
	<tr>		<tr>
	<td><apll>Z</apll> is a ~~string~~.</td>		<td><apll>Z</apll> is a character vector.</td>
	</tr>		</tr>
	<tr>		<tr>
	<td valign="top"><apll>~~{quad}WSID~~{assign}R</apll></td>		<td valign="top"><apll>⎕WSID{assign}R</apll></td>
	<td></td>		<td></td>
	<td></td>		<td></td>
Line 41:		Line 41:
	</table>		</table>
	<br />		<br />
	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.		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 <apll>)WSID</apll> command followed by the workspace name, or assigning the name to the <apll>⎕WSID</apll> system variable. You can also name the workspace with the [[System Command SAVE\|)SAVE]] command.

	For a clear WS, ⎕WSID ~~will return null~~; for a named WS, ~~will return~~ the full file name of the current workspace.		For a clear WS, <apll>⎕WSID</apll> returns an empty vector; for a named WS, returns 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 {quad}WSID system function~~ instead. Case is preserved on the )WSID or ~~{quad}WSID~~ argument.		Issuing the <apll>)WSID</apll> 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, in order to give a workspace a name with spaces in it through the <apll>)WSID</apll> command, you must enclose it in double quote marks. Without the double quote marks, the name will be chopped at the first space; underlines may be used instead. Case is preserved on the <apll>)WSID</apll> or <apll>⎕WSID</apll> 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~~.		NARS2000 will not validate the string passed to <apll>)WSID</apll> nor to <apll>⎕WSID</apll> — you must be certain it is a valid file name. A workspace name specified by the <apll>⎕WSID</apll> system variable may include spaces; the <apll>)WSID</apll> command requires the workspace name to be enclosed in double quote marks.

	This example is from Windows 7:<~~br/~~>		This example is from Windows 7:
	<tt>		<apll><pre>
	:)wsid~~<br/>~~		)wsid
	IS CLEAR WS~~<br/>~~		IS CLEAR WS
	:)WSID~~<br/>~~		)WSID
	IS CLEAR WS~~<br/>~~		IS CLEAR WS
	~~:⎕wsid<br/>~~		⎕WSID
	~~<br/>~~
	:)wsid / {comment} Note this is a bad name		)wsid / {comment} Note this is a bad name
	WAS CLEAR WS		WAS CLEAR WS
	:)wsid		)wsid
	IS /		IS /
	:)wsid big~~<br/>~~		)wsid big
	WAS /~~<br/>~~		WAS /
	:)wsid hello there~~<br/>~~		)wsid hello there
	WAS big~~<br/>~~		WAS big
	:)wsid~~<br>~~		)wsid
	IS hello~~<br/>~~		IS hello
	:)wsid x_5~~<br/>~~		)wsid "hello there"
	WAS hello~~<br/>~~		WAS hello
	:)wsid~~<br/>~~		)wsid
			IS hello there
			)wsid x_5
			WAS hello
			)wsid
	IS x_5		IS x_5
	:)Wsid Mixed_Case		)Wsid Mixed_Case
	WAS x_5		WAS x_5
	:)wsid		)wsid
	IS Mixed_Case		IS Mixed_Case
	:)wsid april~~<br/>~~		)wsid april
	WAS Mixed_Case~~<br/>~~		WAS Mixed_Case
	:⎕wsid~~<br/>~~		⎕wsid
	C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\april~~<br/>~~		C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\april
	:)wsid~~<br/>~~		)wsid
	IS april~~<br/>~~		IS april
	:⎕wsid←'March'~~<br/>~~		⎕wsid←'March'
	:)wsid~~<br/>~~		)wsid
	IS March~~<br/>~~		IS March
	:⎕wsid~~<br/>~~		⎕wsid
	C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\March~~<br/>~~		C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\March
	:⎕wsid←'This is My Workspace'~~<br/>~~		⎕wsid←'This is My Workspace'
	:)wsid~~<br/>~~		)wsid
	IS This is My Workspace~~<br/>~~		IS This is My Workspace
	:⎕wsid~~<br/>~~		⎕wsid
	C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is My Workspace~~<br/>~~		C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is My Workspace
	:)WSID This is mine~~<br/>~~		)WSID "This is mine"
	WAS This is My Workspace~~<br/>~~		WAS This is My Workspace
	:⎕WSID~~<br/>~~		⎕WSID
	C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This~~<br/>~~		C:\Users\Programmer\AppData\Roaming\NARS2000\workspaces\This is mine
	:)wsid~~<br/>~~		)wsid
	IS This</tt><br/>		IS This is mine</pre></apll>

Paul Robinson at 00:43, 27 November 2014

2014-11-27T00:43:48Z

← Older revision		Revision as of 20:43, 26 November 2014
Line 45:		Line 45:
	For a clear WS, ⎕WSID will return null; for a named WS, will return the full file name of the current workspace.		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 {quad}WSID system function instead. Case is preserved on the )WSID argument.		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 or {quad}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.		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.

Paul Robinson: combine both articles

2014-11-27T00:42:04Z

combine both articles

Show changes

Paul Robinson at 22:52, 26 November 2014

2014-11-26T22:52:20Z

← Older revision		Revision as of 18:52, 26 November 2014
Line 1:		Line 1:
	<h1>{quad}WSID - Set or Retrieve Workspace ID</h1>		<h1>{quad}WSID - Set or Retrieve Workspace ID<br/>
			)WSID - Name the current workspace</h1>
	{{BoxStart\|<apll>Z←⎕WSID</apll>		{{BoxStart\|<apll>Z←⎕WSID</apll>
	\|returns the current file name of the workspace.}}		\|returns the current file name of the workspace.}}
Line 46:		Line 47:


	<h1>~~)WSID - Name the current workspace~~</h1>		<h1></h1>
	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.		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.

Paul Robinson at 22:26, 26 November 2014

2014-11-26T22:26:27Z

← Older revision		Revision as of 18:26, 26 November 2014
Line 44:		Line 44:

	{{System Variables}}		{{System Variables}}


			<h1>)WSID - Name the current workspace</h1>
			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.

			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.

			The command works like this:<code><br/>
			:)WSID<br/>
			IS CLEAR WS<br/>
			:)wsid big<br/>
			WAS CLEAR WS<br/>
			:)wsid hello there<br/>
			WAS big<br/>
			:)wsid<br>
			IS hello<br/>
			:)wsid x_5<br/>
			WAS hello<br/>
			:)wsid<br/>
			IS x_5
			:)Wsid Mixed_Case
			WAS x_5
			:)wsid
			IS Mixed_Case

			</code>

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

			{{Commands}}
			{{article footer}}

Paul Robinson: Paul Robinson moved page System Variable WSID to System WSID: Combine )WSID and Quad WSID

2014-11-26T22:25:05Z

Paul Robinson moved page System Variable WSID to System WSID: Combine )WSID and Quad WSID

← Older revision	Revision as of 18:25, 26 November 2014
(No difference)

Paul Robinson at 22:23, 26 November 2014

2014-11-26T22:23:36Z

← Older revision		Revision as of 18:23, 26 November 2014
Line 1:		Line 1:
	<h1>{quad}WSID - Workspace ID</h1>		<h1>{quad}WSID - Set or Retrieve Workspace ID</h1>
	{{BoxStart\|<apll>Z←⎕WSID</apll>		{{BoxStart\|<apll>Z←⎕WSID</apll>
	\|returns the current file name of the workspace.}}		\|returns the current file name of the workspace.}}

Paul Robinson: new

2013-02-28T10:48:35Z

new

New page

<h1>{quad}WSID - Workspace ID</h1>
{{BoxStart|<apll>Z←⎕WSID</apll>
|returns the current file name of the workspace.}}
{{BoxEnd|<apll>Z</apll> is a string.}}
 

{| border="1" cellpadding="5" cellspacing="0" rules="none" summary=""
|-
||<apll>⎕WSID←R</apll>
||sets the name of the workspace to the value of <apll>R</apll>.
|}
 
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.

This example is from Windows 7: 
<apll>      )wsid 
IS CLEAR WS 
      ⎕wsid 
 
      )wsid april 
WAS CLEAR WS 
      ⎕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</apll> 

 

{{System Variables}}