作者LSC112233 (LSC)
看板LaTeX
标题[心得] newcommand renewcommand providecommand
时间Tue Nov 6 15:11:18 2012
这三个指令都和建立巨集相关,差别只在使用时机:
a)
假设已定义巨集\ABC,内容为{abc}
1) \newcommand\ABC{def}
\ABC
产生编译错误!
2) \renewcommand\ABC{def}
\ABC
def
3) \providecommand\ABC{def}
\ABC
abc
b)
假设巨集\ABC未定义
1) \newcommand\ABC{def}
\ABC
def
2) \renewcommand\ABC{def}
\ABC
产生编译错误!
3) \providecommand\ABC{def}
\ABC
def
============================================================
除了上述差异外,三个指令的语法结构等等都完全相同,以下只用
\newcommand 来当范例。
A) 基本用法
\newcommand\
巨集名称[
n]{
巨集内容}
巨集名称可以是任何可用的 TeX字串,但最好避免和系统指令或
其他套件定义的巨集相同,以免混淆。
n为引数数量,是1--9间的正整数;换言之,引数最多为9个。
*
* n 为 0就没有写出的必要;此外,还是有方法让引数大於 9,但在
这里不讨论。
巨集中可用
#m来调用引数,例如:
\newcommand\foo[3]{#3,#1;#2。#1#2#3!}
\foo{A}{B}{C}
C,A;B。ABC!
B) 星号型态
\newcommand\ABC[1]{#1 ABC} %"
长"指令
\newcommand*\ABC[1]{#1 ABC} %"
短"指令
指令长短与巨集内容
毫无关联,而是和引数型态相关。长指令的
引数可以大於一个段落 (就算是整本书也吃得下去) ,短指令则
反之。
此外,指令长短和是否脆弱 (fragile ) 或稳固 (robust) 相关
但非全等;两者的关系如下:
^
稳固 -> 短指令 长指令 -> 脆弱
^ 稳固与脆弱指令非本文讨论范围,当另外讨论。
在非必要的情况下,请用短指令形态来定义自己的巨集!优点是
由於短指令的有效范围只在同一个段落内,系统侦错与执行的效
率比长指令好得多。
C) 巨集本身的星号型态
\makeatletter
\newcommand{\ABC}{\@ifstar
\ABCStar
\ABCNoStar
}
\newcommand{\ABCStar}[
m]{星号型态巨集}
\newcommand{\ABCNoStar}[
n]{无星号巨集}
\makeatother
上例只是一种做法,还有很多方式可以达到相同的目的。在 TeX
里这是常态,请选择自己最熟悉、最有把握的方法。特别要注意
的是,两种型态可以有不同数量的引数!
\makeatletter
\newcommand{\ABC}{\@ifstar
\ABCStar
\ABCNoStar
}
\newcommand{\ABCStar}[3]{#3,#2;#1。}
\newcommand{\ABCNoStar}[2]{#1!#2。}
\makeatother
\ABC{A}{B}\\
\ABC*{A}{B}{C}
A!B。
C,B;A。
D) 选择性参数
\newcommand\ABC[3][defaultA][defaultB]{#3,#1;#2。}
\ABC[D]{E}
E,D;defaultB。
\ABC[][D]{E}
E,defaultA;D。
上例定义了一个使用三个引数的巨集,其中两个是有预设值的选
择性引数:
#1 选择性 预设值 defaultA
#2 选择性 预设值 defaultB
#3 必要
当选择性引数无预设值时,直接用[]即可。
!
! 在设定选择性引数时,请注意括号的使用。
\newcommand\ABC[2](D){#2,#1.}
\ABC[a]{A}
编译错误
\ABC(a){A}
A,a.
使用不同的括号会影响使用方式!一般来说,
[]是最好的选择。
E) 选择性引数放在後面
\makeatletter
\newcommand\ABC[1]{\def\ABC@temp{#1}\ABC@real}% -----
(I)
\newcommand{\ABC@real}[1][default]{#1,\ABC@temp.}% --
(II)
\makeatother
\ABC{A}[B]
B,A.
(I) 将必要引数储存在\ABC@temp 然後呼叫执行指令;在後面要
呼叫必要引数时,就必须用\ABC@temp 来表示。
如果有多个必要引数,暂存变数就必须随之增加;例如:
\newcommand\ABC[2]{%
\def\ABC@tempA{#1}%
\def\ABC@tempB{#2}%
\ABC@real}
(II)接受选择性引数,且包含巨集的真正内容。
F) 如果我希望能简单一点
请参考使用
xparse这个套件。
=============================================================
希望以上内容有所帮助;发现错误的请不吝指教!
--
※ 发信站: 批踢踢实业坊(ptt.cc)
◆ From: 111.255.183.58
※ 编辑: LSC112233 来自: 111.255.183.58 (11/06 15:56)
1F:推 andrew43:好文 11/06 20:24
2F:推 CCY0927:赞! 11/07 19:34