strncpy

[funkcja] Kopiuje określoną liczbę znaków łańcucha.

Składnia

#include <cstring>

char * strncpy( char * dest, const char * src, size_t count );

Opis szczegółowy

Kopiuje określoną liczbę znaków z łańcucha źródłowego (src) do łańcucha docelowego (dest).

Jeżeli źródłowy łańcuch znaków jest krótszy niż wartość przekazana poprzez argument count to łańcuch znaków w buforze docelowym będzie zakończony znakiem terminalnym '\0'. W przeciwnym wypadku łańcuch znaków w buforze docelowym nie będzie zakończony znakiem terminalnym.

Argumenty

Nazwa argumentu	Opis
dest	Miejsce w które ma zostać skopiowany łańcuch znaków
src	Łańcuch znaków, który ma zostać skopiowany
count	Maksymalna liczba znaków jaka może być skopiowana do dest

Zwracana wartość

Zwraca wskaźnik przekazany jako argument dest.

Dodatkowe informacje

Zachowanie funkcji jest nieokreślone jeżeli łańcuch źródłowy i łańcuch docelowy na siebie nachodzą.

Przykład

#include <cstdio>
#include <cstring>

int main()
{

char zrodlo[] = "Dokumentacja C++";
char przeznaczenie[ 4 ] = "";

strncpy( przeznaczenie, zrodlo, 3 );
printf( "Ilosc skopiowanych znakow: %u\n", strlen( przeznaczenie ) );
printf( "Tresc: %s\n", przeznaczenie );
return 0;
}

Standardowe wyjście programu:

Ilosc skopiowanych znakow: 3
Tresc: Dok

Zagadnienia powiązane

strcpy	Kopiuje łańcuch znaków do tablicy znaków. (funkcja)
memcpy	Kopiuje zawartość jednego bloku pamięci do drugiego. (funkcja)
memmove	Kopiuje zawartość jednego bloku pamięci do drugiego (bloki mogą na siebie zachodzić). (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.