☰

Como usar o comando expl3 \str_case:nnF

tag-icon • tag-icon macros expl3 xparse
Como usar o comando expl3 \str_case:nnF

Alguém poderia explicar como xparse- expl3o comando \str_case:nnFfunciona com um exemplo? São str e caseimportantes aqui?

Evite respostas longas (texto). Acho que se você explicar o básico, posso usá-lo onde quiser.

Responder1

O mais curto que posso:

\str_case:nnF { <string> }
  {
    { <case 1> } { <code 1> }
    { <case 2> } { <code 2> }
    ...
    { <case n> } { <code n> }
  }
  { <false code> }

O comando irá comparar <string>com cada <case n>string, em ordem, e se encontrar uma correspondência, a correspondente <code n>será executada. Se nenhuma correspondência for encontrada, <false code>será executado.

Exemplo: suponha que você tenha uma macro para a qual o usuário passa algumas opções, digamos, above, center, ou below, e ela executa algum código dependendo da opção escolhida, e gera um erro se algo sem sentido for digitado:

\cs_new_protected:Npn \cfg_test:n #1
  {
    \str_case:nnF {#1}
      {
        { above  } { <'above' code> }
        { center } { <'center' code> }
        { below  } { <'below' code> }
      }
      { \msg_error:nn { cfg } { invalid-option } {#1} }
  }

então \cfg_test:n {center}seria executado <'center' code>e \cfg_test: {wrong}geraria um erro (embora, se fosse para uma interface de usuário, l3keyspudesse ser usado).

Umexpl3 comando(as variáveis ​​são diferentes) têm um nome no formato:

\<module>_<name>:<signature>

Diz <module>de onde vem esse comando: stris expl3do módulo string, para que você saiba que ele \str_case:nnFopera em strings.

Diz <name>o que o comando faz: caseé usado expl3para funções que se comportam como switch caseconstruções em outras linguagens de programação. funções expl3de\<whatever>_case:nn(TF)sempretêm a mesma sintaxe geral acima: apenas altera o tipo de comparação que eles realizam. \int_case:nnF, por exemplo, faz o mesmo, mas compara números inteiros.

O <signature>informa quantos e que tipo de argumentos o comando usa. né um {...}argumento delimitado normal e Fé igual a n, mas será executado se o comando for avaliado como false(agora adivinhe o que Tsignifica). Dê uma olhadaexpl3.pdf: você encontrará uma descrição de todas as assinaturas possíveis e do kernel <modules>. Então dê uma olhadainterface3.pdf, onde você encontrará uma descrição do que cada expl3comando faz.

informação relacionada