UL_LIBRARY

Datenelemente

editable Ganzzahl (siehe Anmerkung)
Beschreibung Zeichenfolge (siehe Anmerkung)
Raster UL_GRID
headline Zeichenfolge
id Zeichenfolge (siehe Anmerkung)
Benennen Zeichenfolge (LIBRARY_NAME_LENGTH, siehe Anmerkung)

Loop-Members

devices() UL_DEVICE
devicesets() UL_DEVICESET
layers() UL_LAYER
footprints() UL_FOOTPRINT (neu ab EAGLE 9.1, siehe Anmerkung)
packages3d() UL_PACKAGE3D
symbols() UL_SYMBOL

Konstanten

LIBRARY_NAME_LENGTH Max. empfohlene Länge eines Bibliotheksnamens (nur in formatierter Ausgabe verwendet)

Das devices()-Element durchläuft alle Package-Varianten und Technologien aller UL_DEVICESET-Objekte in der Bibliothek. Dies resultiert in allen tatsächlich verfügbaren Device-Varianten. Das devicesets()-Element durchläuft nur die UL_DEVICESET-Objekte, die wiederum in Bezug auf die UL_DEVICE-Elemente abgefragt werden können.

Anmerkung

Das footprints()-Element ist neu in EAGLE 9.1. Für die Abwärtskompatibilität mit früheren EAGLE-Versionen steht packages() als Alias zur Verfügung.

Das description-Element gibt den gesamten beschreibenden Text zurück, der mit dem Befehl BESCHREIBUNG definiert wurde, während das headline-Element nur die erste Zeile der Beschreibung ohne HTML-Tags zurückgibt. Beachten Sie bei Verwendung des description-Texts, dass dieser möglicherweise Zeilenumbruchzeichen ('\n') enthält. Die Beschreibungs- und die Überschriftsinformationen stehen nur in einer Bibliothekszeichnung zur Verfügung und nicht, wenn die Bibliothek aus einem UL_BOARD- oder UL_SCHEMATIC-Kontext abgeleitet wurde.

Wenn die Bibliothek aus einem UL_BOARD- oder UL_SCHEMATIC-Kontext abgeleitet wird, gibt name den reinen Bibliotheksnamen (ohne Pfad oder Erweiterung) zurück. Andernfalls wird der vollständige Bibliotheksdateiname zurückgegeben.

Das id-Element ist nur dann anwendbar, wenn sich dieses UL_LIBRARY-Objekt auf eine verwaltete Bibliothek bezieht. Wenn nicht, ist id die leere Zeichenfolge.

Das editable-Element gibt den Wert 1 zurück, wenn die Bibliothek vom Benutzer bearbeitet werden kann (der Benutzer ist Eigentümer der Bibliothek). Andernfalls wird 0 zurückgegeben.

Beispiel

library(L) {
  L.devices(D)     printf("Dev: %s\n", D.name);
  L.devicesets(D)  printf("Dev: %s\n", D.name);
  L.footprints(F)  printf("Fpt: %s\n", F.name);
  L.packages3d(P)  printf("3dp: %s\n", P.name);
  L.symbols(S)     printf("Sym: %s\n", S.name);
  }
schematic(S) {
  S.libraries(L) printf("Library: %s\n", L.name);
  }