Difference between revisions of "Command/setdataset"

From Wiki
Jump to navigation Jump to search
m (→‎See also: remove stray comma)
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">

Revision as of 13:02, 10 October 2019

\setdataset

Syntax (autogenerated)]

\setdataset[...][...][...=...,...]
[...]name
[...]name
keyvalue


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: