Programmer Guide/Command Reference/EMSG - Revision history

Jw at 07:40, 13 May 2015

2015-05-13T07:40:24Z

← Older revision		Revision as of 09:40, 13 May 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
			{{Command Reference}}
	#emsg := EMSG <var>errorCode</var>		#emsg := EMSG <var>errorCode</var>
	or		or

Christian: Text replace - "S_TOOLS-STx" to "{{STX}}"

2011-04-05T15:56:07Z

Text replace - "S_TOOLS-STx" to "{{STX}}"

← Older revision		Revision as of 17:56, 5 April 2011
Line 4:		Line 4:
	EMSG <var>tableItem</var>		EMSG <var>tableItem</var>

	The <code>EMSG</code> command will return a string describing the meaning of the numerical error code <var>errorCode</var> returned by an ~~S_TOOLS-STx~~ command. If a table item (<var>tableItem</var>) is passed instead of an error code, all error descriptions are stored in the table (deleting the previous contents).		The <code>EMSG</code> command will return a string describing the meaning of the numerical error code <var>errorCode</var> returned by an {{STX}} command. If a table item (<var>tableItem</var>) is passed instead of an error code, all error descriptions are stored in the table (deleting the previous contents).

	// store all error messages in a simple table		// store all error messages in a simple table

Christian at 18:11, 23 March 2011

2011-03-23T18:11:33Z

← Older revision		Revision as of 20:11, 23 March 2011
Line 19:		Line 19:
	#spu := new spu * testspu pa pb pc		#spu := new spu * testspu pa pb pc
	if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)		if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)
			<!-- C.G. 23.3.2011 -->

Christian at 18:11, 23 March 2011

2011-03-23T18:11:18Z

← Older revision		Revision as of 20:11, 23 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	#emsg := EMSG <var>errorCode</var>		#emsg := EMSG <var>errorCode</var>
			or
	EMSG <var>tableItem</var>		EMSG <var>tableItem</var>

Christian at 18:11, 23 March 2011

2011-03-23T18:11:06Z

← Older revision		Revision as of 20:11, 23 March 2011
Line 12:		Line 12:
	// show this table to the user		// show this table to the user
	showitem $#tab		showitem $#tab

	// tidily dispose of the table after use		// tidily dispose of the table after use
	delete /Var #tab		delete /Var #tab

Christian at 18:10, 23 March 2011

2011-03-23T18:10:59Z

← Older revision		Revision as of 20:10, 23 March 2011
Line 9:		Line 9:
	#tab := new table *		#tab := new table *
	EMSG $#tab		EMSG $#tab

			// show this table to the user
			showitem $#tab

			// tidily dispose of the table after use
			delete /Var #tab
	or		or
	// check if command fails and display error message on error		// check if command fails and display error message on error
	#spu := new spu * testspu pa pb pc		#spu := new spu * testspu pa pb pc
	if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)		if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)

Christian at 18:09, 23 March 2011

2011-03-23T18:09:57Z

← Older revision		Revision as of 20:09, 23 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	#emsg := EMSG <var>errorCode</var>		#emsg := EMSG <var>errorCode</var>
	or
	EMSG <var>tableItem</var>		EMSG <var>tableItem</var>

Christian at 18:09, 23 March 2011

2011-03-23T18:09:47Z

← Older revision		Revision as of 20:09, 23 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	==EMSG==		#emsg := EMSG <var>errorCode</var>
			or
			EMSG <var>tableItem</var>

	<code>~~#emsg :=~~ EMSG <var>errorCode</var>\|<var>~~table~~</var></code>		The <code>EMSG</code> command will return a string describing the meaning of the numerical error code <var>errorCode</var> returned by an S_TOOLS-STx command. If a table item (<var>tableItem</var>) is passed instead of an error code, all error descriptions are stored in the table (deleting the previous contents).

	The <code>EMSG</code> command will return a string describing the meaning of a numerical error (<var>errorCode</var>) returned by an S_TOOLS-STx command. If a table item (<var>table</var>) is passed instead of an error code, all error descriptions are stored in the table (deleting the previous contents).		// store all error messages in a simple table
			#tab := new table *
	~~<pre>~~		EMSG $#tab
	// store all error messages in a simple table
	#tab := new table *
	EMSG $#tab
	~~</pre>~~
	or		or
			// check if command fails and display error message on error
	~~<pre>~~		#spu := new spu * testspu pa pb pc
	// check if command fails and display error message on error		if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)
	#spu := new spu * testspu pa pb pc
	if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)
	~~</pre>~~

Admin: 1 revision: Initial import

2010-11-18T16:31:35Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==EMSG==

<code>#emsg := EMSG <var>errorCode</var>|<var>table</var></code>

The <code>EMSG</code> command will return a string describing the meaning of a numerical error (<var>errorCode</var>) returned by an S_TOOLS-STx command. If a table item (<var>table</var>) is passed instead of an error code, all error descriptions are stored in the table (deleting the previous contents).

<pre>
// store all error messages in a simple table
#tab := new table *
EMSG $#tab
</pre>
or

<pre>
// check if command fails and display error message on error
#spu := new spu * testspu pa pb pc
if '$rc' > 0 em $rc ; SPU creation failed: $(emsg $rc)
</pre>