NUME¶

stpncpy, strncpy - reduce la zero un buffer cu lățime fixă și copiază un șir de caractere într-o secvență de caractere cu trunchiere și reduce la zero restul acestuia

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

REZUMAT¶

#include <string.h>

char *strncpy(char dst[restrict .sz], const char *restrict src,
               size_t sz);
char *stpncpy(char dst[restrict .sz], const char *restrict src,
               size_t sz);

stpncpy():

    Începând cu glibc 2.10


        _POSIX_C_SOURCE >= 200809L


    Înainte de glibc 2.10:


        _GNU_SOURCE

DESCRIERE¶

Aceste funcții copiază șirul de caractere indicat de src într-o secvență de caractere cu umplutură nulă în memoria tampon cu lățime fixă indicată de dst. În cazul în care memoria tampon de destinație, limitată de dimensiunea sa, nu este suficient de mare pentru a conține copia, secvența de caractere rezultată este trunchiată. Pentru a vedea diferența dintre cele două funcții, consultați secțiunea VALOAREA RETURNATĂ.

O implementare a acestor funcții ar putea fi:

char *
strncpy(char *restrict dst, const char *restrict src, size_t sz)
{


    stpncpy(dst, src, sz);


    return dst;
}
char *
stpncpy(char *restrict dst, const char *restrict src, size_t sz)
{


    bzero(dst, sz);


    return mempcpy(dst, src, strnlen(src, sz));
}

VALOAREA RETURNATö

strncpy()

returnează dst.

stpncpy()

returnează un indicator la un octet după ultimul caracter din secvența de caractere de destinație.

ATRIBUTE¶

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

STANDARDE¶

strncpy()

C11, POSIX.1-2008.

stpncpy()

POSIX.1-2008.

STANDARDE¶

strncpy()

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

stpncpy()

glibc 1.07. POSIX.1-2008.

AVERTISMENTE¶

Numele acestor funcții este confuz. Aceste funcții produc o secvență de caractere cu umplutură nulă, nu un șir de caractere (a se vedea string_copying(7)).

Este imposibil să se facă distincția între trunchiere prin rezultatul apelului și o secvență de caractere care se potrivește cu memoria tampon de destinație; trunchierea ar trebui detectată prin compararea lungimii șirului de intrare cu dimensiunea memoriei tampon de destinație.

Dacă aveți de gând să utilizați această funcție în apeluri înlănțuite, ar fi util să dezvoltați o funcție similară care să accepte un indicator la capătul (un octet după ultimul element) al memoriei tampon de destinație în loc de dimensiunea acesteia.

EXEMPLE¶

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


    char    *p;


    char    buf1[20];


    char    buf2[20];


    size_t  len;


    if (sizeof(buf2) < strlen("Salutare lume!"))


        warnx("strncpy: truncating character sequence");


    strncpy(buf2, "Salutare lume!", sizeof(buf2));


    len = strnlen(buf2, sizeof(buf2));


    printf("[len = %zu]: ", len);


    printf("%.*s\n", (int) len, buf2);  // "Salutare lume!"


    if (sizeof(buf1) < strlen("Salutare lume!"))


        warnx("stpncpy: truncating character sequence");


    p = stpncpy(buf1, "Salutare lume!", sizeof(buf1));


    len = p - buf1;


    printf("[len = %zu]: ", len);


    printf("%.*s\n", (int) len, buf1);  // "Salutare lume!"


    exit(EXIT_SUCCESS);
}

CONSULTAȚI ȘI¶

wcpncpy(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.