Man:Man3/strcpy.3

Матеріал з docs.linux.org.ua — збірника документації з Unix/Linux українською мовою.

(Перенаправлено з Man/man3/strcpy.3)

Перейти до: навігація, пошук

Зміст

1 НАЗВА
2 ВИКОРИСТАННЯ
3 ОПИС
4 ПРИКЛАДИ
5 ПОВЕРНЕНІ ЗНАЧЕННЯ
6 ВАДИ
7 ВІДПОВІДНІСТЬ СТАНДАРТАМ
8 ДИВІТЬСЯ ТАКОЖ

НАЗВА

strcpy, strncpy - копіює рядок

ВИКОРИСТАННЯ

#іnclude <string.h>

char *strcpy(char *dest, const char *src);

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

ОПИС

Функція strcpy() копіює рядок, на який вказує src (включаючи кінцевий символ '\0'), у масив, на який вказує dest. Рядки не можуть перекриватися і рядок що утвориться, на який вказує dest, повинен мати досить місця для копії.

Функція strncpy() працює аналогічно, за винятком того копіюється не більше перших n байтів рядка src. Таким чином, якщо в n байтах рядка src немає нульового байта, то отриманий рядок не буде закінчуватися символом ' '.

Якщо довжина src менша за n, то зайве місце в dest заповниться нулями.

ПРИКЛАДИ

Наступне надасть charray значення "abc\0\0\0":

(void)strncpy(charray, "abc", 6);

Наступний приклад встановить charray як "abcdef" без нульового закінчення, оскільки копійований рядок >= параметра довжини масиву. strncpy() може надати нульове закінчення лише у випадку коли копійований рядок менший за параметр довжини.

(void)strncpy(charray, "abcdef", 6);

Нижче наведено приклад у якому ми копіюємо стільки знаків, скільки це можливо з input до buff і вручну добавляємо '\0' в кінці, оскільки немає надії що strncpy() завершить рядок належним чином.

char buf[BUFSIZE];

(void)strncpy(buf, input, sizeof(buf) - 1);
buf[sizeof(buf) - 1] = '\0';

Зауважте, що strlcpy(3) буде кращим вибором для таких ситуацій. Той самий вираз з використанням strlcpy() буде виглядати просто як:

(void)strlcpy(buf, input, sizeof(buf));

ПОВЕРНЕНІ ЗНАЧЕННЯ

Функції strcpy() і strncpy() повертають покажчик на рядок dest, отриманий в результаті.

ВАДИ

Якщо в новоствореному рядку недостатньо місця для операції strcpy() (це буває, якщо недосвідчений або лінивий програміст не перевірив розміру перед копіюванням), то може статися все що завгодно. Переповнення рядків сталої довжини є улюбленою технікою крекерів.