Difference between revisions of "Command/setdataset"
< Command
Jump to navigation
Jump to search
m (Fix typo) |
(better stuff) |
||
Line 26: | Line 26: | ||
== Description == | == Description == | ||
− | This command is used to store key-value | + | This command is used to store key-value tables in a table previously defined with {{cmd|definedataset}}. The first argument is the data set name, the last argument is a list of key-value pairs of data that should be saved. By default the first table is saved at |
+ | A middle argument is optional. If provided, it provides the name (or numerical index) at which the key-value table is stored in the dataset; if omitted, the first anonymous table is stored at index 1, the next at index 2, and so on. | ||
== Usage == | == Usage == | ||
<texcode> | <texcode> | ||
− | \ | + | \definedataset[somedataset] |
− | |||
− | + | % Store a table at point 1 | |
+ | \setdataset[somedataset][foo=first, bar=second] | ||
− | + | % Store a table by name | |
− | \setdataset [somedataset] [ | + | \setdataset[somedataset][catnames][cat1=Georgina, cat2=George] |
− | |||
− | |||
+ | % Store an anonymous table at point 2 | ||
+ | \setdataset[somedataset][name=Hans Hagen] | ||
− | + | % Retrieve a stored datum. | |
− | + | This is the \datasetvariable{somedataset}{1}{foo} datum. | |
+ | % --> This is the first datum. | ||
− | + | </texcode> | |
− | |||
+ | == See also == | ||
− | {{cmd|definedataset}}, | + | * {{cmd|definedataset}}, |
− | {{cmd|datasetvariable}} | + | * {{cmd|datasetvariable}} |
+ | * 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 57: | Line 60: | ||
{{Forum|{{SUBPAGENAME}}}} | {{Forum|{{SUBPAGENAME}}}} | ||
− | [[Category: | + | [[Category:Command/Datasets|setdataset]] |
Revision as of 22:56, 26 April 2012
\setdataset
Syntax
\setdataset[...][...][...,...=...,...] | |
[...] | name |
[...] | name |
[...,...=...,...] |
Description
This command is used to store key-value tables in a table previously defined with \definedataset. The first argument is the data set name, the last argument is a list of key-value pairs of data that should be saved. By default the first table is saved at A middle argument is optional. If provided, it provides the name (or numerical index) at which the key-value table is stored in the dataset; if omitted, the first anonymous table is stored at index 1, the next at index 2, and so on.
Usage
\definedataset[somedataset] % Store a table at point 1 \setdataset[somedataset][foo=first, bar=second] % Store a table by name \setdataset[somedataset][catnames][cat1=Georgina, cat2=George] % Store an anonymous table at point 2 \setdataset[somedataset][name=Hans Hagen] % Retrieve a stored datum. This is the \datasetvariable{somedataset}{1}{foo} datum. % --> This is the first datum.
See also
- \definedataset,
- \datasetvariable
- 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: