Difference between revisions of "Command/setdataset"

From ConTeXt wiki
 
Line 4: Line 4:
 
}}
 
}}
  
== [[Help:Reference|Syntax]] (autogenerated)] ==
+
== [[Help:Reference|Syntax]] (autogenerated) ==
 
<syntax>setdataset</syntax>
 
<syntax>setdataset</syntax>
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==

Latest revision as of 14:49, 13 October 2019

\setdataset

Syntax (autogenerated)

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

Help from ConTeXt-Mailinglist/Forum

All issues with: