WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strncpy — Kopieren mit Nullauffüllung

strncpy schreibt n Bytes und füllt kürzere Eingaben mit Nullbytes auf. Ein mit '\0' abgeschlossener Zielstring ist nicht garantiert.

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

Syntax

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

strncpy aus <string.h> kopiert von s2 nach s1 und gibt s1 zurück. Wenn die Funktion vor dem Limit n auf '\0' trifft, füllt sie das Ergebnis mit Nullbytes auf genau n Bytes auf.

Enthalten die ersten n Quellbytes kein '\0', hat das Ergebnis keinen Terminator. n prüft nicht automatisch die Kapazität: Das Ziel muss n Bytes aufnehmen können, und die Quelle muss bis zu ihrem ersten '\0' oder über n Bytes hinweg lesbar sein. Überlappende Speicherbereiche führen zu undefiniertem Verhalten.

Übergib ein nicht terminiertes Ergebnis nicht an ein unbegrenztes %s. Das Beispiel zeigt Auffüllen und Abschneiden; %.*s begrenzt das Lesen aus truncated.

Beispiele

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

int main(void)
{
    char padded[5];
    char truncated[3];

    strncpy(padded, "Hi", sizeof padded);
    strncpy(truncated, "Hello", sizeof truncated);

    printf("padded: %s; zero padding: %d %d %d\n",
           padded, padded[2] == '\0', padded[3] == '\0',
           padded[4] == '\0');
    printf("truncated: %.*s\n", (int)sizeof truncated, truncated);
    return 0;
}

Ergebnis

padded: Hi; zero padding: 1 1 1
truncated: Hel

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