System Function FX - Revision history

WikiSysop: /* Dyadic Function */

2017-06-03T20:55:51Z

Dyadic Function

← Older revision		Revision as of 16:55, 3 June 2017
Line 54:		Line 54:

	==Dyadic Function==		==Dyadic Function==
	~~WITH Execution Properties~~
	<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">		<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
	<tr>		<tr>

WikiSysop: /* Monadic Function */

2017-06-03T20:55:28Z

Monadic Function

← Older revision		Revision as of 16:55, 3 June 2017
Line 2:		Line 2:

	==Monadic Function==		==Monadic Function==
	~~<h3> No Execution Properties (no ''special'' properties in the output function established/fixed)</h3>~~
	<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">		<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
	<tr>		<tr>

WikiSysop: /* Dyadic Function */

2017-06-03T20:54:37Z

Dyadic Function

← Older revision		Revision as of 16:54, 3 June 2017
Line 60:		Line 60:
	<table border="0" cellpadding="5" cellspacing="0" summary="">		<table border="0" cellpadding="5" cellspacing="0" summary="">
	<tr>		<tr>
	<td valign="top"><apll>Z←L ⎕FX R</apll></td>		<td valign="top"><apll>Z←L ⎕FX R</apll>   Fix a function and Set its function timestamp</td>
	<td>~~Right argument~~ R is the same as the monadic call</td>		</tr>
	<td>~~Left argument~~ L is a ~~boolean~~ vector ~~with 1=turn ON property, 0=turn OFF property~~</td>		<tr>
	<td>~~Not yet fully documented, awaiting full documentation.~~</td>		<td><apll>R</apll> is the same as in the monadic call</td>
			</tr>
			<tr>
			<td><apll>L</apll> is a 7-element numeric vector which contains the new timestamp — the format is the same as for <apll>⎕TS</apll>.</td>
			</tr>
			<tr>
			<td><apll>Z</apll> is the result of fixing the function as described in the monadic case.
	</tr>		</tr>
	</table>		</table>
Line 69:		Line 75:
	</tr>		</tr>
	</table>		</table>
	~~Sample Output~~ Function ~~Properties(~~to ~~potentially or hypothetically switch on/off):~~<br>		<br />
	<u>'''~~Function~~'''</u>:<br>		The dyadic version of this System Function first fixes the function as per <apll>R</apll>. If that is successful, it then changes the timestamp to that of <apll>L</apll>. If the User Preference '''Use local time (instead of UTC)''' is checked, the timestamp in <apll>L</apll> is assumed to be in Local Time; otherwise, the timestamp is assumed to be in UTC. The time stored internal to the function is always in UTC.
	* Can/Cannot be ~~displayed - viewed~~
	* Can/Cannot be suspended - halted		If <apll>L</apll> is not valid, the appropriate error is signaled.
	* Does/~~does Not ignore attention signal(e.g~~. ~~Ctrl-C or Ctrl-Break)~~
	* Converts ANY nonresource error to DOMAIN ERROR		<p>For example:</p>
	* Can/~~Cannot be modified/locked~~
	'''~~Quad FX~~''' ~~sample~~ ''~~dyadic~~'' ~~usage: not yet documented.~~		<apll><pre>
			⎕←⎕FX 'Z←L g R' 'Z←L,R'
			g
			2 ⎕AT 'g'
			2017 6 3 15 58 59 104
			⎕←(⎕TS+7↑1) ⎕FX 'Z←L g R' 'Z←L,R'
			g
			2 ⎕AT 'g'
			2018 6 3 15 59 5 593
			</pre></apll>

	{{SFDM\|FX}}		{{SFDM\|FX}}

Robert Wallick: Created Quad FX page

2015-02-15T06:03:38Z

Created Quad FX page

New page

<h1>Quad FX - FIX or Function eXecute - '''⎕FX'''     System Function</h1>

==Monadic Function==
<h3> No Execution Properties (no ''special'' properties in the output function established/fixed)</h3>
<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
<tr>
<td>
<table border="0" cellpadding="5" cellspacing="0" summary="">
<tr>
<td valign="top"><apll>Z←⎕FX R</apll></td>
<td></td>
<td></td>
<td></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><apll>R</apll> is either a '''character matrix''' OR a '''vector of strings''' for a <u>'''function'''</u>'s representation in character matrix or string form.</td>
</tr>
<tr>
<td><apll>Z</apll> returned will be the '''function name''' OR the '''line number''' of the function which failed to be established in the workspace.</td>
</tr>

</table>
<br />
'''Quad FX''' FIX sample ''monadic'' use/user session(with comments at right):
<pre>
)FNS ⍝ In a CLEAR NARS APL workspace there are NOT YET any functions
⎕NL 3 ⍝ Similarly, Quad Name List will show NO user functions
⍴⎕NL 3
0 0
X←'Z←Total vecNums' 'Z←+/vecNums' '"The Total is: ",Z' ⍝Var X is assigned 3 vectorized strings for a NEW funct.
X ⍝ X has 3 elements, 1) function header, 2) APL code statement #1, 3) APL code statement #2
Z←Total vecNums Z←+/vecNums "The Total is: ",Z
⎕FX X ⍝ Here variable X is attempted to be Function eXecuted or FIXed into a NEW function
Total ⍝ ⎕FX or FIX attempt SUCCEEDED and APL returns the Function NAME(Total)
Total ⍳5 ⍝ The first "use" of function Total attempts to Total 5 numbers(iota 5), 1+2+3+4+5
The Total is: 15
15
)FNS ⍝ Now a list of functions in the workspace shows function 'Total' exists
Total
⎕VR 'Total' ⍝ Request function Total's Virtual Representation (1 header row plus 2 APL statement rows)
∇ Z←Total vecNums
[1] Z←+/vecNums
[2] "The Total is: ",Z
∇ 2015 2 15 4 38 9 863 (UTC)
</pre>
When is ⎕FX useful?
* You are using a different function editor than the one supplied with NARS and need to re-establish or fix the function into the workspace.
* You have read in an APL function into APL from a different APL software package OR outside source, and need to make the function read-in '''active''' in the current workspace.
* Your program has automatically created a function in string form, on the fly, and you need to make it active.
* You have external libraries of APL functions and only want to use them as needed, thus you read in the file and FIX the functions, then use them.<br>

==Dyadic Function==
WITH Execution Properties
<table border="1" cellpadding="5" cellspacing="0" rules="none" summary="">
<tr>
<td>
<table border="0" cellpadding="5" cellspacing="0" summary="">
<tr>
<td valign="top"><apll>Z←L ⎕FX R</apll></td>
<td>Right argument R is the same as the monadic call</td>
<td>Left argument L is a boolean vector with 1=turn ON property, 0=turn OFF property</td>
<td>Not yet fully documented, awaiting full documentation.</td>
</tr>
</table>
</td>
</tr>
</table>
Sample Output Function Properties(to potentially or hypothetically switch on/off):<br>
<u>'''Function'''</u>:<br>
* Can/Cannot be displayed - viewed
* Can/Cannot be suspended - halted
* Does/does Not ignore attention signal(e.g. Ctrl-C or Ctrl-Break)
* Converts ANY nonresource error to DOMAIN ERROR
* Can/Cannot be modified/locked
'''Quad FX''' sample ''dyadic'' usage: not yet documented.

{{SFDM|FX}}