[ Pobierz całość w formacie PDF ]
resultierenden Indexwerten überschrieben.
eagle.RTF EAGLE Help Seite 288 von 372
Einheiten-Konvertierung
Funktion
Konvertiert interne Einheiten.
Syntax
real u2inch(int n);
real u2mic(int n);
real u2mil(int n);
real u2mm(int n);
Rückgabewert
u2inch liefert den Wert von n in Inch.
u2mic liefert den Wert von n in Micron (1/1000mm).
u2mil liefert den Wert von n in Mil (1/1000inch).
u2mm liefert den Wert von n in Millimeter.
Siehe auch UL_GRID »Seite 208
EAGLE speichert alle Koordinaten und Größen als int »Seite 188-Werte mit einer Auflösung von
1/10000mm (0.1µ). Die oben angegebenen Einheiten-Konvertier-Funktionen können dazu verwendet werden, die
internen Einheiten in die gewünschten Maßeinheiten umzuwandeln.
Beispiel
board(B) {
B.elements(E) {
printf("%s at (%f, %f)\n", E.name,
u2mm(E.x), u2mm(E.y));
}
}
eagle.RTF EAGLE Help Seite 289 von 372
Print-Funktionen
Print-Funktionen dienen zur Ausgabe formatierter Strings.
Die folgenden Print-Funktionen sind verfügbar:
" printf() »Seite 290
" sprintf() »Seite 293
eagle.RTF EAGLE Help Seite 290 von 372
printf()
Funktion
Schreibt formatiere Ausgaben in ein File.
Syntax
int printf(string format[, argument, ...]);
Rückgabewert
Die printf-Funktion liefert die Zahl der Zeichen, die in das vom letzten output »Seite 314-Statement
geöffnete File geschrieben wurden.
Wenn ein Fehler auftritt, liefert printf -1.
Siehe auch sprintf »Seite 293, output »Seite 314, fileerror »Seite 272
Format-String
Der Format-String steuert, wie die Argumente konvertiert, formatiert und ausgegeben werden. Es müssen genau
so viele Argumente vorhanden sein, wie für das Format erforderlich sind. Die Zahl und der Typ der Argumente
werden für jedes Format geprüft, und wenn sie nicht den Anforderungen entsprechen, wird eine Fehlermeldung
ausgegeben.
Der Format-String enthält zwei Objekt-Typen - einfache Zeichen und Format-Specifier:
" Einfache Zeichen werden direkt ausgegeben
" Format-Specifier holen Argumente von der Argument-Liste und formatieren sie
Format-Specifier
Ein Format-Specifier hat folgende Form:
% [flags] [width] [.prec] type
Jede Format-Spezifizierung beginnt mit dem Prozentzeichen (%). Nach dem % kommt folgendes, in dieser
Reihenfolge:
" optional eine Folge von Flag-Zeichen, [flags]
" optional ein Breiten-Specifier, [width]
" optional ein Präzisions-Specifier, [.prec]
" das Konvertiertyp-Zeichen, type
Konvertiertyp-Zeichen
d signed decimal int
o unsigned octal int
u unsigned decimal int
x unsigned hexadecimal int (with a, b,...)
X unsigned hexadecimal int (with A, B,...)
f signed real value von der Form [-]dddd.dddd
e signed real value von der Form [-]d.dddde[±]ddd
E wie e, aber mit E für Exponent
g signed real value entweder wie e oder f, abhängig vom gegebenen Wert und Präzision
G wie g, aber mit E für Exponent, wenn e-Format verwendet wird
c einzelnes Zeichen
s Character-String
% das %-Zeichen wird ausgegeben
Flag-Zeichen
Die folgenden Flag-Zeichen können in jeder Kombination und Reihenfolge auftreten.
"-" das formatierte Argument wird innerhalb des Feldes linksbündig ausgegeben; normalerweise ist die
Ausgabe rechtsbündig
"+" ein positiver Wert mit Vorzeichen wird mit Pluszeichen (+) ausgegeben; normalerweise werden nur
negative Werte mit Vorzeichen ausgegeben
eagle.RTF EAGLE Help Seite 291 von 372
" " ein positiver Wert mit Vorzeichen wird mit Leerzeichen am Anfang ausgegeben; wenn "+" und " "
angegeben sind, überschreibt "+" die Angabe " "
Width-Specifier
Der Width-Specifier setzt die minimale Feldbreite für einen Ausgabewert.
Die Breite wird entweder direkt mit einem Dezimalstellen-String oder indirekt mit einem Stern (*) gesetzt. Wenn
Sie * verwenden, legt das nächste Argument im Aufruf (das vom Typ int sein muß) die minimale Feldbreite
fest.
Auf keinen Fall führt ein nicht existierendes oder zu ein kleines Feld dazu, daß ein Wert abgeschnitten wird.
Wenn das Ergebnis der Konvertierung breiter ist als das Feld, wird das Feld einfach so vergrößert, daß das
Ergebnis platz hat.
n Mindestens n Zeichen werden ausgegeben. Wenn der Ausgabewert weniger als n Zeichen hat, wird er
mit Leerzeichen aufgefüllt (rechts wenn das "-"-Flag gesetzt ist, sonst links).
0n Mindestens n Zeichen werden ausgegeben. Wenn der Ausgabewert weniger als n Zeichen hat, wird links
mit Nullen aufgefüllt.
* Die Argument-Liste liefert den Width-Specifier, der dem eigentlichen (zu formatierenden) Argument
vorausgehen muß.
Präzisions-Specifier
Ein Präzisions-Specifier beginnt immer mit einem Punkt (.), um ihn von einem vorangehenden Width-Specifier zu
trennen. Dann wird, wie bei "Width", die Präzision entweder direkt mit einem Dezimalstellen-String oder indirekt
mit einem Stern (*) angegeben. Wenn Sie * verwenden, legt das nächste Argument im Aufruf (das vom Typ int
sein muß) die Präzision fest.
keiner Präzision auf Defaultwert gesetzt.
.0 Für int-Typen, Präzision wird auf Default gesetzt; für real-Typen, kein Dezimalpunkt wird
ausgegeben.
.n n Zeichen oder n Dezimalstellen werden ausgegeben. Wenn der Ausgabewert mehr als n Zeichen hat,
kann er abgeschnitten oder gerundet werden (abhängig vom Typ-Zeichen).
* Die Argument-Liste liefert den Präzisions-Specifier, der dem eigentlichen (zu formatierenden) Argument
vorausgehen muß.
Default-Präzisionswerte
douxX 1
eEf 6
gG alle signifikanten Stellen
c keine Auswirkung
s gesamten String ausgeben
Wie die Präzisionsangabe (.n) die Konvertierung beeinflußt
[ Pobierz całość w formacie PDF ]