Changes

== Using Lua == There is a lovely set of functions in the <tt>utilities.parsers</tt> table that turns strings into nice Lua-accessible tables of various kinds. An example is given below; the functions are documented on the [[String_manipulation#util-prs.lua|string manipulation]] page. <texcode>\startluacodeuserdata = userdata or { } function userdata.mycommand(keywords, keyvals) keyword_options = utilities.parsers.settings_to_array(keywords) named_values = utilities.parsers.settings_to_hash(keyvals) -- do stuff based on that array and that hashtable.end\stopluacode \def\mycommand[#1][#2]{\ctxlua{ userdata.mycommand('#1', '#2')}  \mycommand[top, inmargin, now][color=green, roof=gabled]</texcode> == Using TeX == This section is based on a post on the mailing list by Taco Hoekwater from [[http://www.mail-archive.com/ntg-context@ntg.nl/msg03235.html 2004-06-28]].  === Example code === <texcode>\unprotect % enable exclamations in macro names % Helper function: if the user specifies nothing, throw an error\def\errorDir{% \def\Dir{0}% error recovery \message{Please supply "Dir" argument}%} % Helper function:process Dir=... other than Up/Down/Left/Right% Accept numbers, else throw an error\def\checkDir#1{% \doifnumberelse {#1} {\def\Dir{#1}} {\message{Invalid "Dir" argument! (#1)}}} % Defining our command that accepts key=val\def\MyZigzag#1[#2]{% % the #1 makes sure we allow a space before the bracket  % create commands \ZZDir, \ZZLinewidth (default 1pt), etc. \getparameters[ZZ][Dir=,Linewidth=1pt,Color=Red,Width=3em,#2]  % define an alias \edef\mywidth{\ZZWidth}%  % accept keywords for Dir= (and map those keywords to numbers) %\expandafter\processaction\expandafter[\ZZDir] % mkii \processaction[\ZZDir] % mkiv [ Down=>\def\Dir{270}, Left=>\def\Dir{180}, Up=>\def\Dir{90}, Right=>\def\Dir{0}, \s!default=>\errorDir, \s!unknown=>\checkDir{\ZZDir}]} % this brace belongs to \def! \protect % end of definitions</texcode> === The same example, with commentary ===

<{{cmd>|getparameters</cmd> }} and <{{cmd>|processaction</cmd>}}. Here is a 'quickstart', assuming you want to define <tt>\MyZigzag</tt>:

\def\MyZigzag#1[#2]{% % This brace is closed below, after the \expandafter block

At least there are <tt>\ZZDir</tt>,<tt>\ZZLinewidth</tt>, <tt>\ZZColor</tt> and <tt>\ZZWidth</tt> (these have default values) but possibly others as well, depending on user input. Here's a usage In the next lines you make use of these variables, for exampleas follows:

If you want some of the variables to use accept keyword values, then you also need to use <{{cmd>|processaction</cmd>. Say you want "Dir" }} on the ZZ variable in question to be mandatory and that it accepts 4 directional map the keywords, as well as a direct angle specificationonto actual values.

Say you want "Dir" to be mandatory and that it accepts 4 directional keywords, as well as a direct angle specification. I've used all mixed case keywords, because otherwise you might run into conflicts with the multilingual interface:

%\expandafter\processaction\expandafter[\ZZDir]% mkii \processaction[\ZZDir] % mkiv [ Down =>\def\Dir{270}, Left =>\def\Dir{180}, Up =>\def\Dir{90}, Right =>\def\Dir{0}, \s!default =>\errorDir, \s!unknown =>\checkDir{\ZZDir}]

The In MkII, the first argument to <{{cmd>|processaction</cmd> }} has to be expanded, so you need the <{{cmd>|expandafter</}}s. In MkIV, {{cmd>s|processaction|link=no}} does this automatically.

for For completeness, here is an example definition of <tt>\checkDir</tt> and <tt>\errorDir</tt>: