\AtEndOfPackage
\AtEndOfPackage ist eine LaTeX-Kern-Anweisung für Paketautoren, um Code am Ende der Paketdatei auszuführen.
Inhaltsverzeichnis
Verwendung
Syntax
\AtEndOfPackage{Code}
Parameter
{Code}-
- Der
Code, der nach dem vollständigen Lesen der aktuellen Paketdatei ausgeführt werden soll.
- Der
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
\AtEndOfPackagenach\begin{document}aufgerufen wird.
- Die Fehlermeldung tritt auf, wenn
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.
