1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
<html>
<head>
<title>EAGLE Help: UL_LIBRARY</title>
</head>
<body bgcolor=white>
<font face=Helvetica,Arial>
<hr>
<i>EAGLE Help</i>
<h1><center>UL_LIBRARY</center></h1>
<hr>
<b>Data members</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>description</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=158.htm>string</a> (see note)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>grid</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=174.htm>UL_GRID</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>headline</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=158.htm>string</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>name</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=158.htm>string</a> (<tt>LIBRARY_NAME_LENGTH</tt>, see note)</font></td></tr>
</table>
<p>
<b>Loop members</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>devices()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=170.htm>UL_DEVICE</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>devicesets()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=171.htm>UL_DEVICESET</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>layers()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=178.htm>UL_LAYER</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>packages()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=181.htm>UL_PACKAGE</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>symbols()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=193.htm>UL_SYMBOL</a></font></td></tr>
</table>
<p>
<b>Constants</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>LIBRARY_NAME_LENGTH</tt> </font></td><td valign=top><font face=Helvetica,Arial>max. recommended length of a library name (used in formatted output only)</font></td></tr>
</table>
<p>
<b>See also</b> <a href=164.htm>UL_BOARD</a>,
<a href=188.htm>UL_SCHEMATIC</a>
<p>
The <tt>devices()</tt> member loops through all the package variants and technologies
of all UL_DEVICESETs in the library, thus resulting in all the actual device variations
available. The <tt>devicesets()</tt> member only loops through the UL_DEVICESETs,
which in turn can be queried for their UL_DEVICE members.
<p>
<b>Note</b>
<p>
The <tt>description</tt> member returns the complete descriptive text as defined with
the <a href=40.htm>DESCRIPTION</a> command, while the <tt>headline</tt>
member returns only the first line of the description, without any <a href=319.htm>Rich Text</a> tags.
When using the <tt>description</tt> text keep in mind that it may contain newline characters (<tt>'\n'</tt>).
The <tt>description</tt> and <tt>headline</tt> information is only available within a
library drawing, not if the library is derived form a UL_BOARD or UL_SCHEMATIC context.
<p>
If the library is derived form a UL_BOARD or UL_SCHEMATIC context, <tt>name</tt> returns
the pure library name (without path or extension). Otherwise it returns the full library file name.
<p>
<b>Example</b>
<pre>
library(L) {
L.devices(D) printf("Dev: %s\n", D.name);
L.devicesets(D) printf("Dev: %s\n", D.name);
L.packages(P) printf("Pac: %s\n", P.name);
L.symbols(S) printf("Sym: %s\n", S.name);
}
schematic(S) {
S.libraries(L) printf("Library: %s\n", L.name);
}
</pre>
<hr>
<table width=100% cellspacing=0 border=0><tr><td align=left><font face=Helvetica,Arial>
<a href=index.htm>Index</a>
</font></td><td align=right><font face=Helvetica,Arial size=-1>
<i>Copyright © 2005 CadSoft Computer GmbH</i>
</font></td></tr></table>
<hr>
</font>
</body>
</html>
|
