Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strcat — aggiungere una stringa

strcat, in <string.h>, aggiunge una stringa sorgente a una stringa di destinazione. Richiede un buffer abbastanza grande e non ne controlla la capacità.

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

Sintassi

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

strcat(s1, s2) sostituisce il \0 finale in s1 con una copia di s2, compreso il suo \0. Restituisce s1, non un puntatore alla fine del risultato.

Entrambi gli argomenti devono puntare a stringhe valide terminate da un carattere nullo. Il buffer di destinazione deve essere scrivibile e poter contenere almeno strlen(s1) + strlen(s2) + 1 byte. La sovrapposizione degli oggetti coinvolti nella copia causa un comportamento indefinito.

La funzione non riceve la capacità del buffer e non offre protezione dagli overflow. Un buffer troppo piccolo causa un comportamento indefinito, non un troncamento sicuro. Aggiungere ripetutamente stringhe può essere inefficiente: a ogni chiamata viene cercata di nuovo la fine della stringa di destinazione.

Esempi

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

int main(void)
{
    char text[12] = "Hello";
    const char suffix[] = ", C!";

    strcat(text, suffix);
    puts(text);
    return 0;
}

Risultato

Hello, C!

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti