Neue Befehle

% \newcommand{cmd}[narg]{command definition}
\newcommand{\figureref}[1]{(Abbildung \ref{#1})}%

Dabei sind bis zu 9 Argumente (narg) möglich. Diese werden abgerufen über #1, …, #9.

Wie man mehr als 9 Argumente übegeben kann ist in der englischen FAQ erklärt:http://www.tex.ac.uk/cgi-bin/texfaq2html?label=moren9. Eine solche Anzahl von Argumenten ist jedoch nicht zu empfehlen. Besser ist es eine key=value Syntax zu verwenden.

Ist ein Befehl schon definiert löst ein \newcommand einen Fehler aus.

zur Definition gibt es noch weitere Befehle, jeweils mit der gleichen Syntax:

• \renewcommand: definiert ein bestehenden Befehl um. Löst einen Fehler aus falls der Befehl noch nicht exisiter.
• \providecommand: definiert einen Befehl unabhängig davon ob er schon existierte oder nicht.
• \DeclareRobustCommand: wie \newcommand, definiert allerdings einenrobusten Befehl.

Lange und kurze Befehle

Lange Befehle, dass sind alle die mit den vorgestellten Befehle \newcommand, \renewcommand, \providecommand usw. erzeugt werden erlauben Paragraphenumbrüche in den Argumenten.

\newcommand*
\renewcommand*
\providecommand*
...

die dann kurze Befehle erzeugen, die dann keine Paragraphenumbrüche in den Argumenten erlauben.

Intern sind die langen Befehl als \long\def definiert und die kurzen nur als \def

Optionale Argumente

\newcommand{cmd}[narg][default]{command definition}

In diesem Fall hat das Optionale Argument die Nummer #1 und wird durch den default Wert ersetzt wenn der optionale Parameter nicht genutzt wird.

\newcommand{\foobar}[1][2]{#1}

Mehrfache optionale Argumente

\long\def\test@[#1][#2][#3][#4]{%
	(#1) (#2) (#3) (#4)
}
\newcommand{\test}{%
	\optparams{\test@}{[one][two][three][four]}%
}

\test[this] % ergibt "(this) (two) (three) (four)"
\test[this][is] % ergibt  "(this) (is) (three) (four)"
\test[this][is][a]% ergibt "(this) (is) (a) (four)"
\test[this][is][a][test]% ergibt  "(this) (is) (a) (test)"

\long\def\test@[#1][#2][#3][#4]#5{%
	(#1) (#2) (#3) (#4) #5
}
\newcommand{\test}{%
	\optparams{\test@}{[one][two][three][four]}%
}

Allerdings muss bei dieser Methode der erste Befehl über ein \def definiert werden da ein \newcommand diese Syntax nicht versteht.

Zum Anderen gibt es das wesentlich mächtigere Paket xargs welches eine sehr flexible Lösung bietet.

In diesem Paket werden die Befehle

\newcommandx
\renewcommandx
\providecommandx
\DeclareRobustCommandx
\CheckCommandx
\newenvironmentx
\renewenvironmentx

definiert, welche sich durch die vordefiniertem jeweils durch das angehangene x unterscheiden und eine etwas andere Syntax bieten:

\newcommandx*{command}[number][list]{definition}
% zum Vergleich
\newcommand*{command}[number]{definition}

Die Definition eines Befehls unterscheidet sich somit in der Definition von list. Das folgende Beispiel definiert zwei optionale Argumente

\newcommandx*\coord[3][1=1, 3=n]{(#2_{#1},\ldots,#2_{#3})}
$\coord{x}$ % (x1, . . . , xn)
$\coord[0]{y}$ % (y0, . . . , yn)
$\coord{z}[m]$ % (z1, . . . , zm)
$\coord[0]{t}[m]$ % (t0, . . . , tm)

Der ‘value’ Wert bei der Liste gibt dabei den Standardwert an.

Um ein optionales Argument zu übergehen, also nicht anzugeben, aber das darauffolgende anzugeben muss man der Liste den Wert “usedefault” hinzufügen. Das Beispiel sieht dann wie folgt aus

\newcommandx*\coord[3][2=1,3=n,usedefault]{(#2_{#1},\ldots,#2_{#3})}
$\coord{x}$ % (1x, . . . , 1n)
$\coord{y}[0]$ % (0y, . . . , 0n)
$\coord{z}[][m]$ % (1z, . . . , 1m)
$\coord{t}[0][m]$ % (0t, . . . , 0m)

Verschachtelte Befehle

\newcommand\TextZwischenAnfangUndEnde[1]{Anfang \ldots #1 \ldots Ende}
\newcommand\NeuerAnfangUndEnde[2]{%
   \renewcommand\TextZwischenAnfangUndEnde[1]{#1 \ldots ##1 \ldots #2}%
}

Mit der Voreingestellten Definition von \TextZwischenAnfangUndEnde erhält man dann die Ausgabe

Benutzt man nun den Befehl zum Umdefinieren

\NeuerAnfangUndEnde{Es war einmal}{Sie lebten gluecklich bis an ihr Lebensende}
\TextZwischenAnfangUndEnde{Das Maerchen}

so erhält man

Befehle mit *

\newcommand{\fancy}{\@ifnextchar*{Befehl mit *}{Befehl ohne *} sonstiges}

Umgebungen

\newenvironment{cmd}[narg]{begin definition}{end definition}
\renewenvironment{cmd}[narg]{begin definition}{end definition}
% Erste Argument optional
\newenvironment{cmd}[narg][optional]{begin definition}{end definition}

% \newenvironment{myquote}[1]{\small\begin{quote}}{\end{quote}} % funktioniert nicht!
\newenvironment{myquote}[1]{\small\quote}{\endquote} % funktioniert

Protect, Fragile und Robust

\protect\somecommand

Fragile Befehle sind dann solche die in ungültigem TeX Code beim Speichern resultieren, wohingegen Robuste Befehle in gültigen Code beim Speichern expandieren.