[ Pobierz całość w formacie PDF ]
normalerweise werden nur negative Werte mit Vorzeichen ausgegeben
" "
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
douxX
.n spezifiziert daß mindestens n Zeichen ausgegeben werden. Wenn das
Eingangs-Argument weniger als n Stellen hat, wird der Ausgangswert links mit
Nullen aufgefüllt. Wenn das Eingangs-Argument mehr als n Stellen hat, wir die
Ausgabe nicht abgeschnitten.
eEf
.n spezifiziert daß n Zeichen nach dem Dezimalpunkt ausgegeben werden, und die
letzte ausgegebene Stelle wird gerundet.
gG
.n spezifiziert daß höchstens n signifikante Stellen ausgegeben werden.
c
.n hat keinen Einfluß auf die Ausgabe.
s
.n spezifiziert daß nicht mehr als n Zeichen gedruckt werden.
Der binäre Wert 0
Im Gegensatz zu sprintf kann die printf-Funktion den binären Wert 0 (0x00) ausgeben.
char c = 0x00;
printf("%c", c);
Beispiel
int i = 42;
real r = 3.14;
char c = 'A';
string s = "Hello";
printf("Integer: %8d\n", i);
printf("Hex: %8X\n", i);
printf("Real: %8f\n", r);
printf("Char: %-8c\n", c);
printf("String: %-8s\n", s);
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
sprintf()
Funktion
Schreibt eine formatierte Ausgabe in einen String.
Syntax
int sprintf(string result, string format[, argument, ...]);
Rückgabewert
Die sprintf-Funktion liefert die Zahl der Zeichen, die in den result-String geschrieben
wurden.
Im Falle eines Fehlers liefert sprintf den Wert -1.
Siehe auch printf
Format-String
Siehe printf.
Der binäre Wert 0
Bitte beachten Sie, dass sprintf den binären Wert 0 (0x00) nicht verarbeiten kann. Wenn
der Ergebnis-String 0x00 enthält, werden die folgenden Zeichen ignoriert. Verwenden Sie
printf um binäre Daten auszugeben.
Beispiel
string result;
int number = 42;
sprintf(result, "The number is %d", number);
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
String-Funktionen
String-Funktionen werden dazu verwendet, Character-Strings zu manipulieren.
Die folgenden String-Funktionen sind verfügbar:
strchr()
strjoin()
strlen()
strlwr()
strrchr()
strrstr()
strsplit()
strstr()
strsub()
strtod()
strtol()
strupr()
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
strchr()
Funktion
Durchsucht einen String nach dem ersten Vorkommen eines gegebenen Zeichens.
Syntax
int strchr(string s, char c[, int index]);
Rückgabewert
Die strchr-Funktion liefert den Integer-Offset des Zeichen im String oder -1, wenn
das Zeichen nicht vorkommt.
Siehe auch strrchr, strstr
Falls index angegeben wird, beginnt die Suche an dieser Position. Negative Werte werden
vom Ende des Strings her gezählt.
Beispiel
string s = "This is a string";
char c = 'a';
int pos = strchr(s, c);
if (pos >= 0)
printf("The character %c is at position %d\n", c, pos);
else
printf("The character was not found\n");
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
strjoin()
Funktion
Erzeugt aus einem String-Array einen einzelnen String.
Syntax
string strjoin(string array[], char separator);
Rückgabewert
Die strjoin-Funktion liefert die kombinierten Einträge von array.
Beschreibung
strjoin fügt alle Einträge aus array, getrennt durch den angegebenen separator
zusammen, und liefert den Ergebnis-String.
Wenn separator ein Newline-Zeichen ("\n") ist, wird der Ergebnis-String mit einem
Newline-Zeichen abgeschlossen. So erhält man eine Textdatei mit N Zeilen (jede
davon ist mit einem Newline-Zeichen abgeschlossen). Die Datei wird mit den
Funktionen fileread() eingelesen und mit split in ein Array mit N Strings aufgeteilt
und zu dem ursprünglichen String, der aus der Datei eingelesen wurde,
hinzugefügt.
Siehe auch strsplit, lookup, fileread
Beispiel
string a[] = { "Field 1", "Field 2", "Field 3" };
string s = strjoin(a, ':');
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
strlen()
Funktion
Berechnet die Länge eines Strings.
Syntax
int strlen(string s);
Rückgabewert
Die strlen-Funktion liefert die Zahl der Zeichen im String.
Beispiel
string s = "This is a string";
int l = strlen(s);
printf("The string is %d characters long\n", l);
Index Copyright © 2003 CadSoft Computer GmbH
EAGLE Help
[ Pobierz całość w formacie PDF ]