Difference between revisions of "Command/datasetvariable"
< Command
Jump to navigation
Jump to search
(Initial commit) |
m (Elaborate example, terser definition, add category) |
||
Line 15: | Line 15: | ||
<tr valign="top" class="second"> | <tr valign="top" class="second"> | ||
<td class="cmd">{...}</td> | <td class="cmd">{...}</td> | ||
− | <td> | + | <td>name or number of table in data set</td> |
</tr> | </tr> | ||
<tr valign="top" class="third"> | <tr valign="top" class="third"> | ||
<td class="cmd">{...}</td> | <td class="cmd">{...}</td> | ||
− | <td> | + | <td>variable name</td> |
</tr> | </tr> | ||
</table> | </table> | ||
Line 26: | Line 26: | ||
== Description == | == Description == | ||
− | + | <texcode> | |
+ | \datasetvariable{mydataset}{mytable}{myvariable} | ||
+ | </texcode> | ||
+ | This command retrieves the value of <code>myvariable</code> in the table <code>mytable</code> stored in the dataset <code>mydataset</code>. Two complete examples are shown below. | ||
== Usage == | == Usage == | ||
<texcode> | <texcode> | ||
− | \datasetvariable{ | + | % Define a dataset called 'mysteries' |
+ | \definedataset[mysteries] | ||
+ | |||
+ | % The first anonymous table is stored at position 1, the second at position 2, etc. | ||
+ | \setdataset[mysteries][assistant=Watson] | ||
+ | |||
+ | % Retrieving an anonymous table | ||
+ | \datasetvariable{mysteries}{1}{assistant} % Watson | ||
</texcode> | </texcode> | ||
Line 37: | Line 47: | ||
<texcode> | <texcode> | ||
− | \datasetvariable{ | + | % Define a dataset called 'mysteries' |
+ | \definedataset[mysteries] | ||
+ | |||
+ | % Store a key-value dataset called 'Doyle' | ||
+ | \setdataset[mysteries][Doyle][detective=Holmes, assistant=Watson, officer=Lestrade] | ||
+ | |||
+ | % Retrive the variable 'assistant' from the 'Doyle' table in the 'mysteries' dataset | ||
+ | \datasetvariable{mysteries}{Doyle}{assistant} % Watson | ||
</texcode> | </texcode> | ||
− | |||
== See also == | == See also == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | {{cmd|definedataset}} | + | * {{cmd|definedataset}} to define a dataset for storing key-value tables |
− | {{cmd|setdataset}} | + | * {{cmd|setdataset}} to store key-value tables in a dataset |
+ | * More detailed explanations and examples can be found in the Key-Value Assignments article, under the section [[System_Macros/Key_Value_Assignments#Multi-pass data|Multi-pass data]]. | ||
Line 56: | Line 68: | ||
{{Forum|{{SUBPAGENAME}}}} | {{Forum|{{SUBPAGENAME}}}} | ||
− | [[Category: | + | [[Category:Command/Datasets|datasetvariable]] |
Revision as of 21:51, 8 May 2012
\datasetvariable
Syntax
\datasetvariable{...}{...}{...} | |
{...} | name of data set |
{...} | name or number of table in data set |
{...} | variable name |
Description
\datasetvariable{mydataset}{mytable}{myvariable}
This command retrieves the value of myvariable
in the table mytable
stored in the dataset mydataset
. Two complete examples are shown below.
Usage
% Define a dataset called 'mysteries' \definedataset[mysteries] % The first anonymous table is stored at position 1, the second at position 2, etc. \setdataset[mysteries][assistant=Watson] % Retrieving an anonymous table \datasetvariable{mysteries}{1}{assistant} % Watson
or
% Define a dataset called 'mysteries' \definedataset[mysteries] % Store a key-value dataset called 'Doyle' \setdataset[mysteries][Doyle][detective=Holmes, assistant=Watson, officer=Lestrade] % Retrive the variable 'assistant' from the 'Doyle' table in the 'mysteries' dataset \datasetvariable{mysteries}{Doyle}{assistant} % Watson
See also
- \definedataset to define a dataset for storing key-value tables
- \setdataset to store key-value tables in a dataset
- More detailed explanations and examples can be found in the Key-Value Assignments article, under the section Multi-pass data.
Help from ConTeXt-Mailinglist/Forum
All issues with: