[ Pobierz całość w formacie PDF ]

Syntax
int filesize(string filename);
int filetime(string filename);
Rückgabewert
filesize liefert die Größe (in Byte) des Files.
filetime liefert den Timestamp des Files in einem Format, das mit den Zeit-Funktionen »Seite 307
benutzt wird.
Siehe auch time »Seite 308, Filename-Funktionen »Seite 274
Beispiel
board(B)
printf("Board: %s\nSize: %d\nTime: %s\n",
B.name, filesize(B.name),
t2string(filetime(B.name)));
eagle.RTF EAGLE Help Seite 276 von 372
File-Input-Funktionen
File-Input-Funktionen werden verwendet um Daten von Dateien auszulesen.
Folgender File-Input ist möglich:
" fileread() »Seite 277
Siehe output() »Seite 314 für Informationen zum Thema 'In eine Datei schreiben'.
eagle.RTF EAGLE Help Seite 277 von 372
fileread()
Funktion
Liest Daten aus einer Datei aus.
Syntax
int fileread(dest, string file);
Rückgabewert
fileread liefert die Anzahl der Objekte, die aus einer Datei ausgelesen wurden.
Die tatsächliche Bedeutung des Rückgabewerts hängt vom dest-Typ ab.
Siehe auch lookup »Seite 285, strsplit »Seite 301, fileerror »Seite 272
Wenn dest ein Character-Array ist, werden Binär-Daten aus der Datei ausgelesen. Der Rückgabewert entspricht
dann der Anzahl der Bytes, die in das Character-Array eingelesen wurden (das entspricht der Dateigröße).
Wenn dest ein String-Array ist, wird die Datei als Textdatei gelesen (eine Zeile pro Array-Member). Der
Rückgabewert zeigt die Anzahl der Zeilen, die in das Array eingelesen wurden. Newline-Zeichen werden nicht
berücksichtigt.
Wenn dest ein String ist, wird die ganze Datei in diesen String eingelesen. Der Rückgabewert ist die Länge des
Strings (die nicht unbedingt der Filegröße entsprechen muss, wenn das Betriebssystem Textdateien mit "cr/lf"
anstatt "newline" am Zeilenende speichert).
Beispiel
char b[];
int nBytes = fileread(b, "data.bin");
string lines[];
int nLines = fileread(lines, "data.txt");
string text;
int nChars = fileread(text, "data.txt");
eagle.RTF EAGLE Help Seite 278 von 372
Mathematische Funktionen
Mathematische Funktionen werden dazu verwendet, matematische Operationen auszuführen.
Die folgenden mathematischen Funktionen sind verfügbar:
" abs() »Seite 279
" acos() »Seite 281
" asin() »Seite 281
" atan() »Seite 281
" ceil() »Seite 280
" cos() »Seite 281
" exp() »Seite 282
" floor() »Seite 280
" frac() »Seite 280
" log() »Seite 282
" log10() »Seite 282
" max() »Seite 279
" min() »Seite 279
" pow() »Seite 282
" round() »Seite 280
" sin() »Seite 281
" sqrt() »Seite 282
" trunc() »Seite 280
" tan() »Seite 281
Fehlermeldungen
Wenn die Argumente eines mathematischen Funktionsaufrufs zu einem Fehler führen, zeigen die
Fehlermeldungen die aktuellen Werte der Argumente. Deshalb führen die Statements
real x = -1.0;
real r = sqrt(2 * x);
zur Fehlermeldung
Invalid argument in call to 'sqrt(-2)'
eagle.RTF EAGLE Help Seite 279 von 372
Absolutwert-, Maximum- und Minimum-Funktion
Funktion
Absolutwert-, Maximum- und Minimum-Funktion.
Syntax
type abs(type x);
type max(type x, type y);
type min(type x, type y);
Rückgabewert
abs liefert den absoluten Wert von x.
max liefert das Maximum von x und y.
min liefert das Minimum von x und y.
Der Return-Typ dieser Funktionen ist identisch mit dem größeren Typ der Argumente. type muß char
»Seite 187, int »Seite 188 oder real »Seite 189 sein.
Beispiel
real x = 2.567, y = 3.14;
printf("The maximum is %f\n", max(x, y));
eagle.RTF EAGLE Help Seite 280 von 372
Rundungs-Funktionen
Funktion
Rundungs-Funktionen.
Syntax
real ceil(real x);
real floor(real x);
real frac(real x);
real round(real x);
real trunc(real x);
Rückgabewert
ceil liefert den kleinsten Integer-Wert nicht kleiner als x.
floor liefert den größten Integer-Wert nicht größer als x.
frac liefert den Dezimalbruch von x.
round liefert x gerundet auf den nächsten Integer-Wert.
trunc liefert den ganzzahligen Teil von x.
Beispiel
real x = 2.567;
printf("The rounded value of %f is %f\n", x, round(x));
eagle.RTF EAGLE Help Seite 281 von 372
Trigonometrische Funktionen
Funktion
Trigonometrische Funktionen.
Syntax
real acos(real x);
real asin(real x);
real atan(real x);
real cos(real x);
real sin(real x);
real tan(real x);
Rückgabewert
acos liefert den arc-cosinus von x.
asin liefert den arc-sinus von x.
atan liefert den arc-tangens von x.
cos liefert den cosinus von x.
sin liefert den sinus von x.
tan liefert den tangens von x.
Konstanten
PI der Wert von "pi" (3.14...)
Beispiel
real x = 2.0;
printf("The sine of %f is %f\n", x, sin(x));
eagle.RTF EAGLE Help Seite 282 von 372
Exponential-Funktionen
Funktion
Exponential-Funktionen.
Syntax
real exp(real x);
real log(real x);
real log10(real x);
real pow(real x, real y);
real sqrt(real x);
Rückgabewert
exp liefert e hoch x.
log liefert den natürlichen Logarithmus von x.
log10 liefert den Zehnerlogarithmus von x.
pow liefert den Wert von x hoch y.
sqrt liefert die Quadratwurzel von x.
Anmerkung
Die "n-te" Wurzel kann mit Hilfe der pow-Funktion und einem negativen Exponenten berechnet werden.
Beispiel
real x = 2.1;
printf("The square root of %f is %f\n", x, sqrt(x));
eagle.RTF EAGLE Help Seite 283 von 372
Sonstige Funktionen
Sonstige Funktionen werden für weitere Aufgaben benötigt.
Die folgenden verschiedenen Funktionen sind verfügbar:
" exit() »Seite 284
" lookup() »Seite 285
" sort() »Seite 287
" Einheiten-Konvertierung »Seite 288
eagle.RTF EAGLE Help Seite 284 von 372
exit()
Funktion
Beendet ein User-Language-Programm.
Syntax
void exit(int result);
void exit(string command); [ Pobierz całość w formacie PDF ]