База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

snprintf — форматиране с ограничен буфер

snprintf записва форматиран текст в буфер със зададен капацитет. Стойността на връщане позволява да се установи съкращаване; капацитетът включва крайния нулев знак.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <stdio.h>
int snprintf(char * restrict s, size_t n, const char * restrict format, ...);

snprintf от <stdio.h> форматира данни в масива s. При n > 0 записва най-много n - 1 знака и крайния \0. Посочете действително наличния капацитет на буфера, а не размера на указателя.

Първо проверете result < 0: отрицателна върната стойност означава грешка при кодирането. В противен случай върнатата стойност е необходимата дължина без \0, а (unsigned int)result >= n означава, че няма достатъчно място за пълния резултат заедно с \0. Всяка неотрицателна стойност от тип int може да се представи в unsigned int, а неявните преобразувания при това сравнение запазват и двете стойности. Преобразуването на върнатата стойност в size_t обаче може да промени стойност, по-голяма от SIZE_MAX, и така да прикрие съкращаването.

snprintf(NULL, 0, ...) не записва нищо и позволява изчисляване на дължината. Типовете на аргументите трябва да съответстват на формата; копирането между припокриващи се обекти води до недефинирано поведение.

Примери

#include <stdio.h>

int main(void)
{
    char buf[5];
    int result = snprintf(buf, sizeof buf, "%s", "abcdef");

    if (result < 0) {
        puts("encoding error");
        return 1;
    }
    printf("buffer: %s\nrequired: %d\n", buf, result);
    if ((size_t)result >= sizeof buf) {
        puts("truncated");
    }
    return 0;
}

Резултат

buffer: abcd
required: 6
truncated

Кодът и посоченият изход са проверени в изолирана среда. Преобразуването в `size_t` работи в този пример, защото върнатата стойност `6` може да се представи в този тип. В общия случай използвайте описаното по-горе сравнение с `unsigned int`.

Източници