具有多个参数的 xparse 处理器

Question 1

该\ProcessList功能是实验性的，并建议宏采用单个参数。解决此问题的一种方法是定义\funcwithin \boxed，以便它获取参数：

\documentclass{article}

\usepackage{xparse,xcolor}

\NewDocumentCommand{\boxed}{ O{white} O{gray} O{white} >{\SplitList{,}}m }{{%
  \NewDocumentCommand{\func}{ m }{%
    \fcolorbox{#3}{#2}{\color{#1}\strut##1}\space}
  \ProcessList{#4}{\func}}}

\begin{document}

\boxed{a,b,c}

\boxed[yellow]{d,e,f}

\boxed[yellow][black]{g,h,i}

\boxed[yellow][black][red]{j,k,l}

\end{document}

Answer

该\ProcessList功能是实验性的，并建议宏采用单个参数。解决此问题的一种方法是定义\funcwithin \boxed，以便它获取参数：

\documentclass{article}

\usepackage{xparse,xcolor}

\NewDocumentCommand{\boxed}{ O{white} O{gray} O{white} >{\SplitList{,}}m }{{%
  \NewDocumentCommand{\func}{ m }{%
    \fcolorbox{#3}{#2}{\color{#1}\strut##1}\space}
  \ProcessList{#4}{\func}}}

\begin{document}

\boxed{a,b,c}

\boxed[yellow]{d,e,f}

\boxed[yellow][black]{g,h,i}

\boxed[yellow][black][red]{j,k,l}

\end{document}

Question 2

在这种情况下，最好使用较低级别的功能：

\documentclass{article}
\usepackage{xparse,xcolor}

\ExplSyntaxOn

\NewDocumentCommand{\myboxed}{O{white}O{gray}O{white}m}
 {
  \clist_map_inline:nn { #4 }
   {
    \andrea_myboxed:nnnn { #1 } { #2 } { #3 } { ##1 }
   }
 }
\cs_new_protected:Nn \andrea_myboxed:nnnn
 {
  \fcolorbox{#3}{#2}{\color{#1}#4}
 }
\ExplSyntaxOff

\begin{document}

\myboxed{a,b,c}

\end{document}

请注意，\clist_map_inline:nn将第一个参数在逗号处拆分，删除前导和尾随空格并循环遍历各个项目，将每个项目传递给第二个参数中的代码#1；这里之所以变成这样，是##1因为我们处于定义的主体中。

\seq_set_split:Nnn可以使用函数并使用来拆分逗号以外的其他字符\seq_map_inline:Nn。您可以在网站上找到几个示例。

但是，三个可选参数很麻烦，因为如果您只想指定第三个参数，则还必须明确提供前两个参数。键值接口更好。优点是能够以任何顺序指定键，因此您只需记住它们的名称（这比记住可选参数的顺序更容易）。

\documentclass{article}
\usepackage{xparse,xcolor}

\ExplSyntaxOn

\keys_define:nn { andrea/myboxed }
 {
  border     .tl_set:N = \l__andrea_myboxed_border_tl,
  background .tl_set:N = \l__andrea_myboxed_background_tl,
  text       .tl_set:N = \l__andrea_myboxed_text_tl,
  border     .initial:n = white,
  background .initial:n = gray,
  text       .initial:n = white,
 }
\NewDocumentCommand{\kmyboxed}{O{}m}
 {
  \group_begin:
  \keys_set:nn { andrea/myboxed } { #1 }
  \clist_map_inline:nn { #2 }
   {
    \andrea_myboxed:VVVn
     \l__andrea_myboxed_border_tl
     \l__andrea_myboxed_background_tl
     \l__andrea_myboxed_text_tl
     {##1}
   }
  \group_end:
 }
\cs_new_protected:Nn \andrea_myboxed:nnnn
 {
  \fcolorbox{#3}{#2}{\color{#1}#4}
 }
\cs_generate_variant:Nn \andrea_myboxed:nnnn { VVV }
\ExplSyntaxOff

\begin{document}

\kmyboxed{a,b,c}

\kmyboxed[text=red,background=green,border=blue]{a,b,c}

\end{document}

我们定义一些键，设置它们的初始值，并基本上执行与之前相同的代码，但在一个组中，以便在特定循环完成时保持值不变。如果组妨碍了，可以在处重置初始值\keys_set:nn。

变体\andrea_myboxed:VVVn用于将标记列表变量转换为括号参数（其值位于括号之间）；在这个特定的应用程序中不是必需的，但在其他应用程序中可以是必需的。

Answer