strcat, strcat_s

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

char* strcat( char* restrict dest, const char* restrict src );

errno_t strcat_s(char* restrict dest, rsize_t destsz, const char* restrict src);

Параметры

Возвращаемое значение

Примечания

Поскольку strcat требуется находить конец dest при каждом вызове, конкатенация многих строк в одну с помощью strcat неэффективна.

strcat_s разрешается затирать целевой массив от последнего записанного символа до destsz для повышения эффективности: она может копировать многобайтовыми блоками, а затем проверять наличие нулевых байтов.

Функция strcat_s похожа на функцию BSD strlcat, за исключением того, что

• strlcat усекает исходную строку, чтобы она поместилась в целевую
• strlcat не выполняет все проверки времени выполнения, которые выполняет strcat_s
• strlcat не делает ошибки очевидными, устанавливая целевую строку в пустую строку или вызывая обработчик в случае неудачи.

Хотя strcat_s запрещает усечение из-за потенциальных рисков безопасности, можно усечь строку, используя strncat с проверкой границ.

Пример

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void)
{
    char str[50] = "Hello ";
    char str2[50] = "World!";
    strcat(str, str2);
    strcat(str, " ...");
    strcat(str, " Goodbye World!");
    puts(str);

#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    int r = strcat_s(str, sizeof str, " ... ");
    printf("str = \"%s\", r = %d\n", str, r);
    r = strcat_s(str, sizeof str, " and this is too much");
    printf("str = \"%s\", r = %d\n", str, r);
#endif
}

Hello World! ... Goodbye World!
str = "Hello World! ... Goodbye World! ... ", r = 0
str = "", r = 22

Ссылки

Смотрите также