WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strcpy — eine Zeichenkette kopieren

strcpy kopiert eine Zeichenkette einschließlich des abschließenden '\0'. Der Aufrufer muss genügend Platz im Ziel bereitstellen und sicherstellen, dass sich die Objekte nicht überlappen.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <string.h>
char *strcpy(char * restrict s1, const char * restrict s2);

strcpy, deklariert in <string.h>, kopiert die Zeichenkette aus s2 nach s1, einschließlich des abschließenden '\0'. Die Funktion gibt s1 zurück, nicht die Anzahl der kopierten Zeichen.

Die Quelle muss eine gültige, nullterminierte Zeichenkette enthalten. Das Ziel muss beschreibbar sein und mindestens strlen(s2) + 1 Bytes aufnehmen können. Die Funktion erhält keine Puffergröße und reserviert keinen Speicher. Ein zu kleiner Puffer oder überlappende kopierte Objekte führen zu undefiniertem Verhalten; es ist kein Fehlercode zu erwarten.

Im Beispiel enthält sizeof source das Nullzeichen, daher ist destination groß genug. Die getrennten Arrays überlappen sich nicht. puts gibt die Kopie aus und fügt einen Zeilenumbruch hinzu.

Beispiele

#include <stdio.h>
#include <string.h>

int main(void)
{
    const char source[] = "Hello";
    char destination[sizeof source];

    strcpy(destination, source);
    puts(destination);
    return 0;
}

Ergebnis

Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen