\AtEndOfPackage

Aus goLaTeX

\AtEndOfPackage ist eine LaTeX-Kern-Anweisung für Paketautoren, um Code am Ende der Paketdatei auszuführen.

Verwendung

Syntax

\AtEndOfPackage{Code}

Parameter

{Code}
Der Code, der nach dem vollständigen Lesen der aktuellen Paketdatei ausgeführt werden soll.

Beschreibung

Die Anweisung ist ausschließlich für Paketautoren gedacht. Wird die Anweisung innerhalb eines Pakets (also innerhalb der Datei eines Pakets) verwendet, so wird der angegebene Code erst nach dem vollständigen Lesen der Paketdatei expandiert und ausgeführt. Gibt es mehrere solcher Anweisungen, so wird ihr Code in der Reihenfolge der Aufrufe sowohl expandiert als auch ausgeführt. Nichts desto trotz erfolgt die Ausführung noch quasi im Kontext des Pakets. Insbesondere sind \@currname und \@currext zu diesem Zeitpunkt noch gültig.

Im Gegensatz zu vergleichbaren Anweisungen wie \AtBeginDocument oder \AtEndDocument ist eine Schachtelung bei dieser Anweisung nicht vorgesehen. Ein Aufruf außerhalb eines Pakets ergibt keinen Fehler, ist aber auch nicht sinnvoll. Da \AtEndOfClass jedoch intern mit \AtEndOfPackage identisch ist, ist \AtEndOfPackage innerhalb einer Klasse gleichbedeutend mit dem Aufruf von \AtEndOfClass. Diesen Umstand auszunutzen und innerhalb eines Pakets \AtEndOfClass statt \AtEndOfPackage zu verwenden oder umgekehrt, sollte dennoch vermieden werden, da dieser Umstand nicht offiziell dokumentiert ist.

Fehlermeldungen

LaTeX Error: Can be used only in preamble.
Die Fehlermeldung tritt auf, wenn \AtEndOfPackage nach \begin{document} aufgerufen wird.

Beispiele

Die Anweisung kann beispielsweise verwendet werden, um aus den Optionen heraus eine Anweisung, die erst später in dem Paket definiert wird, am Ende des Pakets umzudefinieren. Ein Code-Beispiel für die Verwendung existiert derzeit bewusst nicht.

Verwandte Befehle

\AtBeginDocument, \AtEndDocument, \AtEndOfClass, \AtBeginDvi, \AfterClass (Paket scrlfile), \AfterPackage (Paket scrlfile).

Verweise

Die Anweisung ist in den LaTeX-Quellen in Datei ltclass.dtx definiert und zusätzlich zu source2e.pdf in „LaTeX2ε for class and package writers” dokumentiert.

Links