☰

Como anexar opções a um .meta:n l3key existente?

tag-icon • tag-icon l3keys
Como anexar opções a um .meta:n l3key existente?

Se eu já configurei uma .meta:nchave com

\keys_define:nn { module } { key .meta:n = { … } }

então é fácil substituir a chave por novos valores chamando \kerys_define:nncom novas metaopções.

Mas e se eu quiser acrescentar às meta opções atuais da chave?

MWE

Neste MWE, quero \setstylesubstituir as meta opções para stylee \setstyle*anexar às meta opções para style. Como posso fazer isso?

\documentclass{article}
\ExplSyntaxOn
\keys_define:nn { dcp }
  { 
    keya .tl_set:N = \l__dcp_keya_tl ,
    keyb .tl_set:N = \l__dcp_keyb_tl ,
    keyc .tl_set:N = \l__dcp_keyc_tl ,
    style .choice:
  }
\NewDocumentCommand \setstyle { s m }
  {
    \bool_if:NTF #1
      {
        % how can I append to style?
      }
      {
        % set style
        \keys_define:nn { dcp } { style .meta:n = {#2} }
      }
  }
\NewDocumentCommand \showstyle { }
  {
    \keys_show:nn { dcp } { style }
  }
\ExplSyntaxOff
\setstyle{keya=x,keyb=y}
\begin{document}
\showstyle
\setstyle{keya=x,keyb=yy}
\showstyle
\setstyle*{keyc=z}
\showstyle
\end{document}

Responder1

Não tenho certeza se existe uma interface oficial, mas armazenar as chaves como uma lista parece funcionar. Tive que mudar o \showstylecomando porque do jeito que defini \setstyle, \keys_show:nnsó mostra

>  code  =>  \keys_set:nV {dcp}\l_dcp_style_clist

o que não é muito útil. Além disso, eu entenderia perfeitamente se não fosse isso que você tinha em mente...

\documentclass{article}
\ExplSyntaxOn
\keys_define:nn { dcp }
  { 
    keya .tl_set:N = \l__dcp_keya_tl ,
    keyb .tl_set:N = \l__dcp_keyb_tl ,
    keyc .tl_set:N = \l__dcp_keyc_tl ,
    %style .choice:
  }
\clist_new:N \l_dcp_style_clist
\NewDocumentCommand \setstyle { s m }
  {
    \bool_if:NTF #1
      {
        % append to style
        \clist_put_right:Nn \l_dcp_style_clist { #2 }
      }
      {
        % set style
        \clist_set:Nn \l_dcp_style_clist { #2 }
      }
    \keys_define:nn { dcp }
      {
        style .code:n = \keys_set:nV { dcp } \l_dcp_style_clist
      }
  }
\NewDocumentCommand \showstyle { }
  {
    \keys_set:nn { dcp } { style }
    \l__dcp_keya_tl
    \l__dcp_keyb_tl
    \l__dcp_keyc_tl
  }
\ExplSyntaxOff

\begin{document}

\setstyle{keya=x,keyb=y}

\showstyle

\setstyle{keya=x,keyb=yy}

\showstyle

\setstyle*{keyc=z}

\showstyle

\end{document}

Não fiz benchmark, mas é possível que a pré-compilação ofereça algum benefício de velocidade; você poderia mudar a definição de \setstylepara

\cs_generate_variant:Nn \keys_precompile:nnN { nV }
\NewDocumentCommand \setstyle { s m }
  {
    \bool_if:NTF #1
      {
        % append to style
        \clist_put_right:Nn \l_dcp_style_clist { #2 }
      }
      {
        % set style
        \clist_set:Nn \l_dcp_style_clist { #2 }
      }
    \keys_precompile:nVN { dcp } \l_dcp_style_clist \l_dcp_stylekeys_tl
    \keys_define:nn { dcp }
      {
        style .code:n = \l_dcp_stylekeys_tl
      }
  }

informação relacionada