Scroll to navigation

strcpy(3) Library Functions Manual strcpy(3)

NUME

stpcpy, strcpy, strcat - copiază sau concatenează un șir de caractere

BIBLIOTECA

Biblioteca C standard (libc, -lc)

SINOPSIS

#include <string.h>
char *stpcpy(char *restrict dst, const char *restrict src);
char *strcpy(char *restrict dst, const char *restrict src);
char *strcat(char *restrict dst, const char *restrict src);

Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

stpcpy():


Începând cu glibc 2.10
_POSIX_C_SOURCE >= 200809L
Înainte de glibc 2.10:
_GNU_SOURCE

DESCRIERE

Aceste funcții copiază șirul indicat de src într-un șir din memoria tampon indicată de dst. Programatorul este responsabil pentru alocarea unei memorii tampon de destinație suficient de mare, adică strlen(src) + 1. Pentru diferența dintre cele două funcții, consultați secțiunea VALOAREA RETURNATĂ.
Această funcție concatenează șirul indicat de src după șirul indicat de dst (suprascriind octetul nul de sfârșit). Programatorul este responsabil pentru alocarea unei memorii tampon de destinație suficient de mari, adică strlen(dst) + strlen(src) + 1.

O implementare a acestor funcții ar putea fi:


char *
stpcpy(char *restrict dst, const char *restrict src)
{

char *p;
p = mempcpy(dst, src, strlen(src));
*p = '\0';
return p; } char * strcpy(char *restrict dst, const char *restrict src) {
stpcpy(dst, src);
return dst; } char * strcat(char *restrict dst, const char *restrict src) {
stpcpy(dst + strlen(dst), src);
return dst; }

VALOAREA RETURNATĂ

Această funcție returnează un indicator la octetul nul de sfârșit al șirului copiat.
Aceste funcții returnează dst.

ATRIBUTE

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

Interfață Atribut Valoare
stpcpy(), strcpy(), strcat() Siguranța firelor MT-Safe

STANDARDE

POSIX.1-2008.
C11, POSIX.1-2008.

STANDARDE

POSIX.1-2008.
POSIX.1-2001, C89, SVr4, 4.3BSD.

AVERTISMENTE

Șirurile src și dst nu se pot suprapune.

În cazul în care memoria tampon de destinație nu este suficient de mare, comportamentul este nedefinit. A se vedea _FORTIFY_SOURCE în feature_test_macros(7).

strcat() poate fi foarte ineficientă. Citiți despre aceasta în Shlemiel the painter

EXEMPLE

#include <err.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int
main(void)
{

char *p;
char *buf1;
char *buf2;
size_t len, maxsize;
maxsize = strlen("Salutare ") + strlen("lume") + strlen("!") + 1;
buf1 = malloc(sizeof(*buf1) * maxsize);
if (buf1 == NULL)
err(EXIT_FAILURE, "malloc()");
buf2 = malloc(sizeof(*buf2) * maxsize);
if (buf2 == NULL)
err(EXIT_FAILURE, "malloc()");
p = buf1;
p = stpcpy(p, "Salutare ");
p = stpcpy(p, "lume");
p = stpcpy(p, "!");
len = p - buf1;
printf("[len = %zu]: ", len);
puts(buf1); // "Salutare lume!"
free(buf1);
strcpy(buf2, "Salutare ");
strcat(buf2, "lume");
strcat(buf2, "!");
len = strlen(buf2);
printf("[len = %zu]: ", len);
puts(buf2); // "Salutare lume!"
free(buf2);
exit(EXIT_SUCCESS); }

CONSULTAȚI ȘI

strdup(3), string(3), wcscpy(3), string_copying(7)

TRADUCERE

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

2 mai 2024 Pagini de manual de Linux 6.8