ING_DB
This commit is contained in:
Oliver Lehmann
parent
b995e725a4
commit
97f943910a
|
|
@ -0,0 +1,951 @@
|
|||
.ds RF \f3LIBRARY \f1
|
||||
.ds RH \f3GUTIL \f1
|
||||
.ds CH - % -
|
||||
.ds LH Anwendung
|
||||
.ds LF ING_DB 6.3/0
|
||||
.bp
|
||||
.NH 2
|
||||
.ft B
|
||||
Bibliotheksfunktionen **
|
||||
.ft R
|
||||
.LP
|
||||
.sp 10
|
||||
.NH 3
|
||||
.ft B
|
||||
Vorbemerkung **
|
||||
.ft R
|
||||
.LP
|
||||
Zwangsl\o'a"'ufig werden bei einem so umfangreichen
|
||||
Programmkomplex wie ING_DB eine Reihe von Bibliotheken
|
||||
verwendet. Dieser Abschnitt soll keine Erl\o'a"'uterungen
|
||||
zum Inhalt und zur Leistung der einzelnen Prozeduren
|
||||
und Funktionen
|
||||
bringen, es soll nur auf einige Besonderheiten
|
||||
hingewiesen werden. Mit dem \o'U"'bergang von UNIX Version 6
|
||||
zu Version 7 wurden die Konvertierungsfunktionen
|
||||
.ft B
|
||||
atoX
|
||||
.ft R
|
||||
in ihrer Parameter\o'u"'bergabe bzw. -\o'u"'bernahme nicht
|
||||
den Bedingungen der V7-Bibliothek
|
||||
.ft B
|
||||
libc.a
|
||||
.ft R
|
||||
angepasst. Es ist deshalb sinnvoll in AMX-Programmen
|
||||
grunds\o'a"'tzlich die V6-Variante zu verwenden, um die
|
||||
Namensgleichheit zu \o'u"'berbr\o'u"'cken.
|
||||
.LP
|
||||
Dar\o'u"'berhinaus kennt die Bibliothek
|
||||
.ft B
|
||||
gutil
|
||||
.ft R
|
||||
eine Reihe von Funktionen, deren Anwendung durchaus
|
||||
Erleichterungen bei der Programmierung in C bringen kann,
|
||||
ohne das Gesamtkonzept zu st\o'o"'ren. Allerdings wird
|
||||
nachfolgend nur ein sehr bescheidener Teil der Prozeduren
|
||||
beschrieben.
|
||||
.NH 3
|
||||
.ft B
|
||||
Funktionen **
|
||||
.ft R
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3APPEND \f1
|
||||
.DE
|
||||
.ft B NAME
|
||||
.IP
|
||||
append - Block-Verkettung
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
append (b1, l1, b2, l2, b3)
|
||||
int l1, l2;
|
||||
char *b1, *b2, *b3;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Bl\o'o"'cke b1 und b2, jeweils mit der L\o'a"'nge l1 und l2, werden
|
||||
zum Block b3 verkettet. "return" erfolgt mit der Adresse des
|
||||
ersten Bytes nach b3.
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
FEHLER
|
||||
.ft R
|
||||
.IP
|
||||
Es wird nicht gepr\o'u"'ft, ob die Bl\o'o"'cke in unzul\o'a"'ssiger Weise
|
||||
\o'u"'berlappen.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3ATOF \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
atof - konvertiert eine Zeichenkette in eine Float-Zahl
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
atof (str, val)
|
||||
char *str;
|
||||
double *val;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
atof konvertiert eine durch str adressierte Zeichenkette in eine
|
||||
float-Zahl. Das Ergebnis steht auf der durch val adressierten
|
||||
Variablen.
|
||||
.br
|
||||
.RS
|
||||
.IP return: 8
|
||||
-1 Syntaxfehler
|
||||
.br
|
||||
0 keine Fehler
|
||||
.br
|
||||
1 \o'U"'berlauf
|
||||
.RE
|
||||
.sp 1
|
||||
Syntax:
|
||||
.IP
|
||||
{<sp>}[+|-]{<sp>}{<Ziffer>}[. <Ziffer>]{<sp>}[<exp>]
|
||||
.sp
|
||||
wobei "sp" ein Leerzeichen, exp=[e|E]<int> der Exponent und int
|
||||
eine Integer Zahl im Sinne der Konvertierungsfunktion atoi ist.
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SIEHE-AUCH
|
||||
.ft R
|
||||
.IP
|
||||
atoi()
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3ATOI \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
atoi - konvertiert eine Zeichenkette in eine Integerzahl
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
atoi (str, val)
|
||||
char *str;
|
||||
int *val;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
atoi konvertiert eine durch str adressierte Zeichenkette
|
||||
in eine 16-Bit Integer-Zahl.
|
||||
Das Ergebnis steht auf der durch val adressierten Variablen.
|
||||
.br
|
||||
.RS
|
||||
.IP return: 8
|
||||
-1 Syntaxfehler
|
||||
.br
|
||||
0 keine Fehler
|
||||
.br
|
||||
1 \o'U"'berlauf
|
||||
.RE
|
||||
.sp 1
|
||||
Syntax:
|
||||
.IP
|
||||
{<sp>}[+|-]{<sp>}{Ziffer}{<sp>}
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3ATOL \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
atol - konvertiert eine Zeichenkette in eine Long-Zahl
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
atol (str, val)
|
||||
char *str;
|
||||
int *val;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
atol konvertiert eine durch str adressierte Zeichenkette
|
||||
in eine 32-Bit Integer-Zahl.
|
||||
Das Ergebnis steht auf der durch val adressierten Variablen.
|
||||
.RS
|
||||
.IP return: 8
|
||||
-1 Syntaxfehler
|
||||
.br
|
||||
0 keine Fehler
|
||||
.br
|
||||
1 \o'U"'berlauf
|
||||
.RE
|
||||
.sp 1
|
||||
Syntax:
|
||||
.IP
|
||||
{<sp>}[+|-]{<sp>}{Ziffer}{<sp>}
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3BEQUAL \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
bequal - Test auf Blockgleichheit
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
bequal (a, b, l)
|
||||
char *a, *b;
|
||||
int l;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
.ft B
|
||||
bequal
|
||||
.ft R
|
||||
testet zwei Bl\o'o"'cke a und b, beide in der L\o'a"'nge l,
|
||||
auf Gleichheit.
|
||||
.RS
|
||||
.IP return: 8
|
||||
1 bei Gleichheit
|
||||
.br
|
||||
0 bei Ungleichheit
|
||||
.RE
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3BITPOS \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
bitpos - h\o'o"'chstwertige Bitposition ermitteln
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
bitpos (w)
|
||||
.br
|
||||
int w;
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
bitpos ermittelt die Stellung des h\o'o"'chstwertigen Bits
|
||||
der 16-Bit Integer-Zahl w.
|
||||
Die Bits werden von rechts nach links, beginnend mit Null,
|
||||
aufsteigend numeriert.
|
||||
.RS
|
||||
.IP return: 8
|
||||
0, . . . , 15 entsprechend der Bitposition,
|
||||
.br
|
||||
-1 wenn kein Bit gesetzt ist.
|
||||
.RE
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3BMOVE \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
bmove - Block Transport
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
char *bmove (a, b, l)
|
||||
char *a, *b;
|
||||
int l;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
bmove transportiert l Bytes von a nach b.
|
||||
Die Sinnf\o'a"'lligkeit von l und ein "\o'U"'berlauf" von b
|
||||
werden nicht gepr\o'u"'ft.
|
||||
.IP
|
||||
"return" erfolgt mit der Adresse des l+1. Elementes von b.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3CONCAT \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
concat - Zeichenketten Verkettung
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
char *concat (s1, s2, s3)
|
||||
char *s1, *s2, *s3;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Zeichenketten s1 und s2 werden zur Zeichenkette s3 verkettet.
|
||||
Dabei d\o'u"'rfen s1 und s3 \o'u"'berlappen.
|
||||
"return" erfolgt mit der Adresse des letzten Bytes (Null-Byte)
|
||||
von s3.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3FTOA \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
ftoa - konvertiert eine Gleitkommazahl in eine Zeichenkette
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
ftoa (val, str, l, prec, form)
|
||||
.br
|
||||
double val;
|
||||
.br
|
||||
char *str, form;
|
||||
.br
|
||||
int l, prec;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
ftoa konvertiert eine doppeltgenaue Gleitkommazahl val in eine
|
||||
entsprechende Zeichenkette str. Die Zeichenkette str muss
|
||||
mindestens in der L\o'a"'nge l+1 vereinbart sein.
|
||||
Die Genauigkeit prec gibt die Anzahl der Stellen nach dem
|
||||
Dezimalpunkt an. Mit "form" wird das
|
||||
Ausgabeformat festgelegt.
|
||||
Es kann die Werte e, E, f, F, g, G, n<, N annehmen. E steht f\o'u"'r die
|
||||
exponentielle- und F f\o'u"'r die Gleitkommadarstellung. G und N sind
|
||||
analog zu F; passt die konvertierte Zahl aber nicht in die
|
||||
Ausgabebreite, wird auf die exponentielle Form umgeschaltet.
|
||||
G garantiert die Ausrichtung des Dezimalpunktes, N nicht.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3GETSTR \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
getstr - liesst eine Zeichenkette von der Standard-Eingabe
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
getstr (str, d, n)
|
||||
char *str, d;
|
||||
int n;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Es werden Zeichen von der Standard-Eingabe nach str \o'u"'bertragen
|
||||
und zwar solange, bis der Begrenzer
|
||||
.ft B
|
||||
d
|
||||
.ft R
|
||||
erkannt wird.
|
||||
Dabei werden h\o'o"'chstens n Zeichen \o'u"'bertragen. Wenn der
|
||||
Begrenzer nach n Zeichen noch nicht erkannt wurde,
|
||||
werden alle weiteren Zeichen bis zur Erkennung des Begrenzers
|
||||
\o'u"'bergangen. An Stelle des Begrenzers wird in jedem Falle
|
||||
das Null-Byte \o'u"'betragen, sodass das Feld str mindestens von
|
||||
der L\o'a"'nge n+1 sein muss.
|
||||
"return" erfolgt mit dem Wert 1. Sollte vor der Erkennung des
|
||||
Begrenzers das file-Ende erkannt werden, wird die Zeichenkette
|
||||
ebenfalls mit dem Null-Byte abgeschlossen. "return" erfolgt dann
|
||||
mit dem Wert 0.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3IOCV \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
iocv - konvertiert eine Integer-Zahl in eine Zeichenkette
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
iocv (i)
|
||||
int i;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Integer-Zahl i wird mittels der Funktion itoa in eine
|
||||
Zeichenkette konvertiert. Das Ergebniss wird in einem internen
|
||||
statischen Bereich gespeichert, dessen Adresse durch
|
||||
"return" zur\o'u"'ckgegeben wird.
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SIEHE AUCH
|
||||
.ft R
|
||||
.IP
|
||||
itoa ()
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3ITOA \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
itoa - konvertiert 16-Bit Integerzahl in Zeichenkette
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
itoa (i, str)
|
||||
int i;
|
||||
char *str;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Integer-Zahl i wird in eine 7 Byte lange Zeichenkette konvertiert
|
||||
und in dem durch str adressierten Feld gespeichert.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3LENGTH \f1
|
||||
.DE
|
||||
.LP
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
length - ermittelt die L\o'a"'nge einer Zeichenkette
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
length (str)
|
||||
char *str;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Es wird die Anzahl der Bytes einer Zeichenkette, mit Ausnahme
|
||||
des die Kette abschliessenden Null-Bytes, ermittelt und
|
||||
durch "return" zur\o'u"'ckgegeben.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3OATOI \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
oatoi - konvertiert eine Zeichenkette, die eine Oktalzahl
|
||||
darstellt, in eine Integer-Zahl
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
oatoi (str)
|
||||
char *str;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
oatoi konvertiert die Zeichenkette str, die nur oktale Ziffern
|
||||
und kein Vorzeichen enthalten darf, in eine 16-Bit Integer-Zahl.
|
||||
Die Konvertierung wird beendet, sobald ein Zeichen ungleich einer
|
||||
Oktalziffer erkannt wird. Der konvertierte Wert wird durch
|
||||
"return" zur\o'u"'ckgegeben.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3PAD \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
pad - f\o'u"'llt eine Zeichenkette mit Leerzeichen auf
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
pad (str, l)
|
||||
char *str;
|
||||
int l;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
pad f\o'u"'llt die Zeichenkette str vom Null-Byte an bis zum
|
||||
Erreichen der l-ten Position mit Leerzeichen, vorausgesetzt,
|
||||
l ist gr\o'o"'sser als die L\o'a"'nge der Zeichenkette.
|
||||
Erf\o'u"'llt l diese Bedingung nicht, wird die Kette nicht ver\o'a"'ndert.
|
||||
pad wird durch den Aufruf von pmove (str, str, l, ' ') realisiert.
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SIEHE AUCH
|
||||
.ft R
|
||||
.IP
|
||||
pmove ()
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3PMOVE \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
pmove - transportiert eine Zeichenkette und f\o'u"'llt auf
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
char *pmove (str, b, l, c)
|
||||
char *str, *b, c;
|
||||
int l;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
pmove transportiert die Zeichenkette str in den Speicherbereich b.
|
||||
Dabei werden genau l Bytes \o'u"'bertragen. Ist die Zeichenkette l\o'a"'nger,
|
||||
wird abgeschnitten, ist sie k\o'u"'rzer, wird ab Nullbyte mit dem Zeichen
|
||||
c aufgef\o'u"'llt.
|
||||
.RE
|
||||
.lP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3PRARGS \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
prargs - protokolliert die Argumente einer Kommandozeile
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
prargs (pc, pv)
|
||||
int pc;
|
||||
char **pv;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
prargs protokolliert \o'u"'ber Standardausgabe die Argumente einer
|
||||
Kommandozeile (main(argc, argv)). Dabei werden Sonderzeichen
|
||||
(Zeichen, deren oktaler Code zwischen 040 und 0177 liegt)
|
||||
als Oktalzahl protokolliert.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3SCOMPARE \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
scompare - vergleicht zwei Zeichenketten
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
scompare (stra, la, strb, lb)
|
||||
char *stra, *strb;
|
||||
int la, lb;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.tf R
|
||||
.IP
|
||||
Zwei Zeichenketten stra und strb werden auf der Basis ihres
|
||||
ascii-Codes verglichen. Die Anzahl der zu vergleichenden Zeichen
|
||||
wird durch la bzw. lb definiert.
|
||||
Die Zeichenkettenl\o'a"'ngen sollten mindestens so gross, wie die
|
||||
angegebenen Vergleichsl\o'a"'ngen la und lb sein, andernfalls wird
|
||||
als Vergleichswert das Nullbyte benutzt.
|
||||
Werden die L\o'a"'ngen la und lb mit dem Wert Null angegeben, so
|
||||
wird daf\o'u"'r automatisch ein Maximalwert (32767) benutzt.
|
||||
Ebenso wird, falls la und lb ungleich sind f\o'u"'r die Kette
|
||||
mit der kleineren Vergleichsl\o'a"'nge das Nullbyte zum Vergleich benutzt.
|
||||
Leerzeichen werden \o'u"'bergangen.
|
||||
IP return: 8
|
||||
-1 stra < strb
|
||||
.br
|
||||
0 stra = strb
|
||||
.br
|
||||
1 stra > strb
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3SEQUAL \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
sequal - testet zwei Zeichenketten auf Gleichheit
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
sequal (stra, strb)
|
||||
.br
|
||||
char *stra, *strb;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Zwei Zeichenketten stra und strb werden auf absolute Gleichheit getestet.
|
||||
"return" erfolgt mit 1 bei Gleichheit, sonst mit 0.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3SMOVE \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
smove - Zeichenkette transportieren
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
smove (str, b)
|
||||
.br
|
||||
char *str, *b;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Zeichenkette str wird zum Block b transportiert.
|
||||
"return" erfolgt mit der L\o'a"'nge der transportierten Zeichenkette.
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3SYSERR \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
syserr - Systemfehlermitteilung und Abbruch
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
syserr (ptr)
|
||||
char *ptr;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
syserr liefert eine Fehlermitteilung \o'u"'ber Standardausgabe
|
||||
und bricht im Normalfall durch Aufruf der Funktion exit ab.
|
||||
Argumente f\o'u"'r syserr sind in der gleichen Form
|
||||
wie bei printf anzugeben. Sie sind allerdings in ihrer
|
||||
Anzahl auf 5 beschr\o'a"'nkt.
|
||||
syserr unterscheidet zwei Aufrufarten:
|
||||
.RS
|
||||
.IP 1.
|
||||
der erste Parameter ist Null (die folgenden Parameter
|
||||
wie bei printf), dann wird genau die
|
||||
printf Funktion realisiert.
|
||||
.IP 2.
|
||||
Der erste Parameter ist nicht Null (also alle Parameter
|
||||
wie bei printf), dann wird mit Hilfe der externen Variablen
|
||||
char *Proc_name und int erron, Acceerror eine erweiterte
|
||||
Fehlerprotokollierung realisiert (UNIX error,
|
||||
ACCESS METHOD error, mit Angabe einer Fehlernummer
|
||||
und eventuell vorangestelltem Programmnamen).
|
||||
.RE
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3XPUTCHAR \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
xputchar - Zeichenausgabe \o'u"'ber Standard-output
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
xputchar (c)
|
||||
.br
|
||||
char c;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
xputchar \o'u"'bertr\o'a"'gt alle Zeichen mit Ausnahme derer,
|
||||
deren oktaler Code gr\o'o"'sser als 040
|
||||
und kleiner als 0200 ist (Sonderzeichen)
|
||||
mittels der Funktion putchar zur Standardausgabe.
|
||||
Sonderzeichen werden mittels printf als Oktalzahl
|
||||
zur Standardausgabe geleitet.
|
||||
Diesen wird das Zeichen "\\" vorangestellt.
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SIEHE AUCH
|
||||
.ft R
|
||||
.IP
|
||||
printf (), putchar()
|
||||
.RE
|
||||
.LP
|
||||
------------------------------------------------------------
|
||||
.sp 2
|
||||
.DS C
|
||||
\f3ZTACK \f1
|
||||
.DE
|
||||
.ft B
|
||||
NAME
|
||||
.ft R
|
||||
.IP
|
||||
ztack - Zeichenkettenverkn\o'u"'pfung in einem Puffer
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SYNOPSIS
|
||||
.ft R
|
||||
.IP
|
||||
.DS L
|
||||
char *ztack (stra, strb()
|
||||
.br
|
||||
char *stra;
|
||||
char *strb;
|
||||
.DE
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
BESCHREIBUNG
|
||||
.ft R
|
||||
.IP
|
||||
Die Zeichenketten stra und strb werden in einem
|
||||
statischen Pufferbereich zu einer Zeichenkette verbunden.
|
||||
"return" erfolgt mit der Anfangsadresse
|
||||
des Puffers. Bei Puffer\o'u"'berlauf wird mittels Funktion syserr
|
||||
der Fehlersachverhalt "ztack overflow" nebst Pufferinhalt mitgeteilt.
|
||||
Der Puffer fasst maximal 100 Zeichen, wobei das Programm so angelegt ist,
|
||||
das erst nach dem Umspeichern der Zeichenkette in den Puffer auf \o'U"'berlauf
|
||||
getestet wird. Ein rekursiver Aufruf von ztack ist m\o'o"'glich
|
||||
(ztack(ztack(x, y), z)).
|
||||
.RE
|
||||
.sp 1
|
||||
.ft B
|
||||
SIEHE AUCH
|
||||
.ft R
|
||||
.IP
|
||||
syserr ()
|
||||
.RE
|
||||
Loading…
Reference in New Issue