strccpy(3G)                                                     strccpy(3G)

NAME
     strccpy, streadd, strcadd, strecpy - Zeichenketten kopieren

SYNTAX
     cc [option ...] datei ... -lgen [bibliothek ...]

     #include <libgen.h>

     char *strccpy(char *Ausgabe, const char *Eingabe);

     char *strcadd(char *Ausgabe, const char *Eingabe);

     char *strecpy(char *Ausgabe, const char *Eingabe, const char *Ausnahmen);

     char *streadd(char *Ausgabe, const char *Eingabe, const char *Ausnahmen);

BESCHREIBUNG
     strccpy() kopiert die Zeichenkette Eingabe bis zu einem Null-Byte in
     die Zeichenkette Ausgabe und komprimiert die Escape-Sequenzen der
     Sprache C (zum Beispiel \n, \001) in das äquivalente Zeichen. An die
     Ausgabe wird ein Null-Byte angehängt. Das Argument Ausgabe muß auf
     einen Speicherplatz zeigen, der groß genug ist, um das Ergebnis aufzu-
     nehmen. Wenn er so groß ist wie der Speicherplatz, auf den Eingabe
     zeigt, ist er mit Sicherheit groß genug. strccpy() gibt das Argument
     Ausgabe zurück.

     strcadd() ist genau wie strccpy(), nur daß hier ein Zeiger auf das
     Null-Byte, das die Ausgabe abschließt, zurückgegeben wird.

     strecpy() kopiert die Zeichenkette Eingabe bis zu einem Null-Byte zur
     Zeichenkette Ausgabe und erweitert nichtgrafische Zeichen in ihre
     äquivalenten Escape-Sequenzen der Sprache C (zum Beispiel \n, \001).
     Das Argument Ausgabe muß auf einen Speicherplatz zeigen, der groß
     genug ist, um das Ergebnis aufzunehmen; ein Speicherplatz der viermal
     so groß ist wie der, auf den Eingabe zeigt, ist mit Sicherheit groß
     genug (schlimmstenfalls kann aus jedem Zeichen \ mit drei Ziffern wer-
     den). Zeichen in der Zeichenkette Ausnahmen werden nicht erweitert.
     Das Argument Ausnahmen kann NULL sein, das heißt, daß alle nicht-
     grafischen Zeichen erweitert werden. strecpy() gibt das Argument
     Ausgabe zurück.

     streadd() entspricht strecpy(), nur daß hier ein Zeiger auf das Null-
     Byte zurückgegeben wird, das die Ausgabe abschließt.

BEISPIELE
     /* alle Zeichen außer Neue-Zeile und Tabulator erweitern */
     strecpy( Ausgabe, Eingabe, "\n

     /* einige Zeichenketten zusammenfügen und komprimieren */
     cp = strcadd( Ausgabe, Eingabe1 );
     cp = strcadd( cp, Eingabe2 );
     cp = strcadd( cp, Eingabe3 );



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

strccpy(3G)                                                     strccpy(3G)

SIEHE AUCH
     string(3C), str(3G).




















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98