Programmer Guide/Shell Items/Table/SET TABLE - Revision history

Toni: /* {{anchor|FIND|Finding table entries}} */

2019-01-30T09:30:52Z

← Older revision		Revision as of 11:30, 30 January 2019
Line 253:		Line 253:
	:The logical operator combining two search criteria; logical operators are applied from left to right, bracketing is not possible. The following operators are supported:		:The logical operator combining two search criteria; logical operators are applied from left to right, bracketing is not possible. The following operators are supported:

	:<code>AND</code> ~~- conjunction~~		::conjunction: <code>AND</code> or <code>&&</code>
	<code>&&</code> ~~- conjunction~~		::disjunction: <code>OR</code> or <code>\|\|</code>
	<code>OR</code> ~~- disjunction~~		::exclusive disjunction: <code>XOR</code> or <code>^^</code>
	<code>\|\|</code> - disjunction
	<code>XOR</code> ~~- exclusive disjunction~~

	:<code>^^</code> ~~- exclusive disjunction~~

	;<var>/Start</var>		;<var>/Start</var>

Jw: /* Retrieving a table entry */

2018-12-13T08:12:02Z

Retrieving a table entry

← Older revision		Revision as of 10:12, 13 December 2018
Line 58:		Line 58:
	== Retrieving a table entry ==		== Retrieving a table entry ==

	You can retrieve a table entry using the following syntax: <code>$#table[$#index]</code>		You can retrieve a table entry using the following syntax: <code>$#table[$#index]</code>. If the table has columns defined, you can use the syntax <samp>$#table[$#index,$#columnid]</samp>.

	== Configuring a table field==		== Configuring a table field==

Jw: /* Formatting table fields */

2018-12-12T10:38:12Z

Formatting table fields

← Older revision		Revision as of 12:38, 12 December 2018
Line 326:		Line 326:
	SET <var>table</var> FORMAT <var>format</var> [<var>listdel</var> <var>vardel</var> <var>numfmt </var> <var>intfmt</var>]		SET <var>table</var> FORMAT <var>format</var> [<var>listdel</var> <var>vardel</var> <var>numfmt </var> <var>intfmt</var>]

	Configuration of the write format used to save and load tables from files (see [[XXX\|<code>SET file LOAD</code>]] and [[XXX\|<code>SET file SAVE</code>]]). You can configure the [[~~Programmer Guide~~/~~Shell Items~~/Table/~~Show_Format~~\|show format]] (used to display tables in the GUI) using the [[Programmer_Guide/Shell_Items/Table/SET_TABLE#Configuring_a_table_field\|<code>CONFIG</code>]] command.		Configuration of the write format used to save and load tables from files (see [[XXX\|<code>SET file LOAD</code>]] and [[XXX\|<code>SET file SAVE</code>]]). You can configure the [[Programmer_Guide/Shell_Items/Table/Introducing_Table_Items#The_Show_Format\|show format]] (used to display tables in the GUI) using the [[Programmer_Guide/Shell_Items/Table/SET_TABLE#Configuring_a_table_field\|<code>CONFIG</code>]] command.

	;<var>format</var>		;<var>format</var>

Toni: /* Copying to and from the clipboard */

2018-11-13T07:28:21Z

Copying to and from the clipboard

← Older revision		Revision as of 09:28, 13 November 2018
Line 179:		Line 179:
	SET <var>table</var> CLIPBOARD /Args arg1 arg2 ... [ /Show\|Write ]		SET <var>table</var> CLIPBOARD /Args arg1 arg2 ... [ /Show\|Write ]

	Copy the content of the arguments to the clipboard. Each argument <code>argI</code> can be a string (string is copied) or a table item (content of table is copied). The option <code>/Show\|Write</code> specifies the output format used for the table items (as described above).		Copy the content of the arguments to the clipboard. Each argument <code>argI</code> can be a string (string is copied) or a table item (content of table is copied). The option <code>/Show\|Write</code> specifies the output format used for the table items (as described above). The content of the table item <var>table</var> is only copied, if it is specified as argument.

	SET <var>table</var> CLIPBOARD /Read [ /Delete ] [ /Empty ]		SET <var>table</var> CLIPBOARD /Read [ /Delete ] [ /Empty ]

Toni: /* Copying to and from the clipboard */

2018-11-13T07:26:41Z

Copying to and from the clipboard

← Older revision		Revision as of 09:26, 13 November 2018
Line 174:		Line 174:
	# [[Programmer_Guide/Shell_Items/Table/Introducing_Table_Items#Write_Format\|write-format]], i.e. the format normally used when writing to a file. This is done with the <code>/Write</code> option.		# [[Programmer_Guide/Shell_Items/Table/Introducing_Table_Items#Write_Format\|write-format]], i.e. the format normally used when writing to a file. This is done with the <code>/Write</code> option.

	;<code>/Show</code>: Use the ~~[[Programmer Guide/Shell Items/Table/Show_Format\|~~show format]] to format each entry string. This is the default.		;<code>/Show</code>: Use the show format to format each entry string. This is the default.
	;<code>/Write</code>: Use the ~~[[Programmer Guide/Shell Items/Table/Write_Format\|~~write format]] to format each entry string.		;<code>/Write</code>: Use the write format to format each entry string.

	SET <var>table</var> CLIPBOARD /Args arg1 arg2 ... [ /Show\|Write ]		SET <var>table</var> CLIPBOARD /Args arg1 arg2 ... [ /Show\|Write ]

Toni: /* Copying to and from the clipboard */

2018-11-13T07:25:33Z

Copying to and from the clipboard

← Older revision		Revision as of 09:25, 13 November 2018
Line 176:		Line 176:
	;<code>/Show</code>: Use the [[Programmer Guide/Shell Items/Table/Show_Format\|show format]] to format each entry string. This is the default.		;<code>/Show</code>: Use the [[Programmer Guide/Shell Items/Table/Show_Format\|show format]] to format each entry string. This is the default.
	;<code>/Write</code>: Use the [[Programmer Guide/Shell Items/Table/Write_Format\|write format]] to format each entry string.		;<code>/Write</code>: Use the [[Programmer Guide/Shell Items/Table/Write_Format\|write format]] to format each entry string.

			SET <var>table</var> CLIPBOARD /Args arg1 arg2 ... [ /Show\|Write ]

			Copy the content of the arguments to the clipboard. Each argument <code>argI</code> can be a string (string is copied) or a table item (content of table is copied). The option <code>/Show\|Write</code> specifies the output format used for the table items (as described above).

	SET <var>table</var> CLIPBOARD /Read [ /Delete ] [ /Empty ]		SET <var>table</var> CLIPBOARD /Read [ /Delete ] [ /Empty ]

Jw: /* Formatting table fields */

2018-08-14T08:57:44Z

Formatting table fields

← Older revision		Revision as of 10:57, 14 August 2018
Line 344:		Line 344:
	:Integer (!) format string used for all fields of type <code>INTEGER</code>. This can be any valid C string format specifier.		:Integer (!) format string used for all fields of type <code>INTEGER</code>. This can be any valid C string format specifier.

	You can set the decimal symbol using the [[~~XXX~~\|<code>MODE</code>]] command.		You can set the decimal symbol using the [[#Setting_the_table_mode\|<code>MODE</code>]] command.
	<pre>		<pre>
	///////////////////////////////////////////////////////////////////////////////		///////////////////////////////////////////////////////////////////////////////

Jw: /* Configuring a table field */

2017-07-10T11:40:40Z

Configuring a table field

← Older revision		Revision as of 13:40, 10 July 2017
Line 67:		Line 67:
	[ <var>listtable</var> <var>listfield</var> <var>listonly</var> <var>setdefault</var> <var>setuserdefault</var> <var>multirow</var> ] ]		[ <var>listtable</var> <var>listfield</var> <var>listonly</var> <var>setdefault</var> <var>setuserdefault</var> <var>multirow</var> ] ]

	Configure a table field. Define the display format (list box and list view) and field properties. The field must have been specified in the <code>[[~~User Guide~~/~~Workspace~~/~~Spectrum Viewer pre-configured profiles~~\|NEW TABLE]]</code> command. The table must be in configuration mode (see <code>[[#Setting_the_table_mode\|MODE]]</code>).		Configure a table field. Define the display format (list box and list view) and field properties. The field must have been specified in the <code>[[Programmer_Guide/Shell_Items/Table/NEW_TABLE\|NEW TABLE]]</code> command. The table must be in configuration mode (see <code>[[#Setting_the_table_mode\|MODE]]</code>).

	{\|class="keinrahmen"		{\|class="keinrahmen"

Jw: /* Formatting table fields */

2017-06-26T13:34:09Z

Formatting table fields

← Older revision		Revision as of 15:34, 26 June 2017
Line 322:		Line 322:
	SET <var>table</var> FORMAT <var>format</var> [<var>listdel</var> <var>vardel</var> <var>numfmt </var> <var>intfmt</var>]		SET <var>table</var> FORMAT <var>format</var> [<var>listdel</var> <var>vardel</var> <var>numfmt </var> <var>intfmt</var>]

	Configuration of the write format used to save and load tables from files (see [[XXX\|<code>SET file LOAD</code>]] and [[XXX\|<code>SET file SAVE</code>]]). You can configure the [[Programmer Guide/Shell Items/Table/Show_Format\|show format]] (used to display tables in the GUI) using the [[~~XXX~~\|<code>CONFIG</code>]] command.		Configuration of the write format used to save and load tables from files (see [[XXX\|<code>SET file LOAD</code>]] and [[XXX\|<code>SET file SAVE</code>]]). You can configure the [[Programmer Guide/Shell Items/Table/Show_Format\|show format]] (used to display tables in the GUI) using the [[Programmer_Guide/Shell_Items/Table/SET_TABLE#Configuring_a_table_field\|<code>CONFIG</code>]] command.

	;<var>format</var>		;<var>format</var>

Jw: /* Locking / Unlocking the table */

2017-06-19T07:32:38Z

Locking / Unlocking the table

← Older revision		Revision as of 09:32, 19 June 2017
Line 400:		Line 400:
	== Locking / Unlocking the table ==		== Locking / Unlocking the table ==

	The use of '''lock/unlock''' is only important, if a table item is (or may be) used by more than one thread. In {{STX}} shells, spu items and display item are running in own thread.		The use of '''lock/unlock''' is only important, if a table item is (or may be) used by more than one thread. In {{STX}} shells, spu items and display item are running in their own thread.


	SET <var>table</var> LOCK [/Save]		SET <var>table</var> LOCK [/Save]
	Lock the table item. The execution of the calling shell is stopped, until the item can be locked. If locked, only the shell which locked it has access to the item until it is explicitly unlocked with the command <code>UNLOCK</code>. Always beware deadlocks.		Lock the table item. The execution of the calling shell is stopped, until the item can be locked. If locked, only the shell which locked it has access to the item until it is explicitly unlocked with the command <code>UNLOCK</code>. Always beware of deadlocks.

	SET <var>table</var> LOCK <var>timeout</var> [Save]		SET <var>table</var> LOCK <var>timeout</var> [Save]
Line 410:		Line 409:

	:* If the table is locked with the option '''/Save''', the tag state of each entry, the current order and the mode is saved on <code>lock</code> and restored with the <code>unlock</code> command. In this case in the critical section entries can only be modified, but not created or deleted.		:* If the table is locked with the option '''/Save''', the tag state of each entry, the current order and the mode is saved on <code>lock</code> and restored with the <code>unlock</code> command. In this case in the critical section entries can only be modified, but not created or deleted.


	SET <var>table</var> UNLOCK		SET <var>table</var> UNLOCK
	Unlock the table item. '''Note''': ~~Its~~ very important that for each successful <code>LOCK</code> an <code>UNLOCK</code> is called!		Unlock the table item. '''Note''': It's very important that for each successful <code>LOCK</code>, an <code>UNLOCK</code> is called!


	See <code>lock_example.sts</code> in the script examples directory for an example.		See <code>lock_example.sts</code> in the script examples directory for an example.