Difference between revisions of "Command/setdataset"
< Command
Jump to navigation
Jump to search
(better stuff) |
|||
(3 intermediate revisions by 2 users not shown) | |||
Line 4: | Line 4: | ||
}} | }} | ||
+ | == [[Help:Reference|Syntax]] (autogenerated) == | ||
+ | <syntax>setdataset</syntax> | ||
== [[Help:Reference|Syntax]] == | == [[Help:Reference|Syntax]] == | ||
<table cellspacing="4" cellpadding="2" class="cmd"> | <table cellspacing="4" cellpadding="2" class="cmd"> | ||
Line 26: | Line 28: | ||
== Description == | == Description == | ||
− | 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. | + | 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. |
− | A middle argument is optional. If provided, it | + | |
+ | A middle argument is optional. If provided, it specifies the name (or numerical index) at which the key-value table is stored in the dataset; if it is omitted, the first anonymous table is stored at index 1, the next at index 2, and so on. | ||
== Usage == | == Usage == | ||
Line 34: | Line 37: | ||
\definedataset[somedataset] | \definedataset[somedataset] | ||
− | % Store | + | % Store an anonymous table. It will be stored at point 1. |
− | \setdataset[somedataset][ | + | \setdataset[somedataset][wantscake=yes, wantsdeath=no] |
% Store a table by name | % Store a table by name | ||
\setdataset[somedataset][catnames][cat1=Georgina, cat2=George] | \setdataset[somedataset][catnames][cat1=Georgina, cat2=George] | ||
− | % | + | % The next anonymous table is stored at point 2. |
\setdataset[somedataset][name=Hans Hagen] | \setdataset[somedataset][name=Hans Hagen] | ||
+ | |||
+ | % We can overwrite existing tables, even anonymous ones | ||
+ | \setdataset[somedataset][1][wantscake=Yes please., wantsdeath=No thanks.] | ||
% Retrieve a stored datum. | % Retrieve a stored datum. | ||
− | + | Do you want cake? \datasetvariable{somedataset}{1}{wantscake}. | |
− | % --> | + | % --> Do you want cake? Yes please. |
− | |||
</texcode> | </texcode> | ||
== See also == | == 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]]. | * 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]]. | ||
− | |||
== Help from ConTeXt-Mailinglist/Forum == | == Help from ConTeXt-Mailinglist/Forum == |
Latest revision as of 14:49, 13 October 2019
\setdataset
Syntax (autogenerated)
\setdataset[...][...][...=...,...] | |
[...] | name |
[...] | name |
key | value |
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.
A middle argument is optional. If provided, it specifies the name (or numerical index) at which the key-value table is stored in the dataset; if it is omitted, the first anonymous table is stored at index 1, the next at index 2, and so on.
Usage
\definedataset[somedataset] % Store an anonymous table. It will be stored at point 1. \setdataset[somedataset][wantscake=yes, wantsdeath=no] % Store a table by name \setdataset[somedataset][catnames][cat1=Georgina, cat2=George] % The next anonymous table is stored at point 2. \setdataset[somedataset][name=Hans Hagen] % We can overwrite existing tables, even anonymous ones \setdataset[somedataset][1][wantscake=Yes please., wantsdeath=No thanks.] % Retrieve a stored datum. Do you want cake? \datasetvariable{somedataset}{1}{wantscake}. % --> Do you want cake? Yes please.
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: