C ++ vswprintf () - C ++ стандартна библиотека

Функцията vswprintf () в C ++ се използва за записване на форматиран широк низ в широк буфер на низове.

Функцията vswprintf () е дефинирана в заглавния файл.

прототип vswprintf ()

 int vswprintf (wchar_t * буфер, size_t buf_size, const wchar_t * формат, va_list vlist);

Функцията vswprintf () записва широкия низ, посочен по формат, в буфера на широкия низ. Максимално (buf_size-1)широки символи се записват в буфер, който е последван от нулев широк знак.

Широкият низ формат може да съдържа спецификатори на формат, започващи с%, които се заменят със стойностите на променливи, които се предават като списък vlist.

Параметри vswprintf ()

  • буфер: указател към широк буфер за низ, за ​​да напише резултата.
  • buf_size: Максимален брой широки символи за запис, включително завършващия нулев широк символ.
  • формат: указател към нулев прекратен широк низ, който се записва в буфер. Състои се от символи заедно с опционални спецификатори на формат, започващи с% Спецификаторите на формата се заменят със стойностите на съответните променливи, които следват формата.
    Спецификаторът на формата има следните части:
    • Водещ знак%
    • Флагове: По избор един или повече флагове, които променят поведението на преобразуването.
      • -: Ляво обосноваване на резултата в полето. По подразбиране е правилно обосновано.
      • +: Знакът на резултата е прикрепен към началото на стойността, дори и за положителни резултати.
      • Интервал: Ако няма знак, интервал е прикрепен към началото на резултата.
      • #: Извършва се алтернативна форма на преобразуване.
      • 0: Използва се за цяло число и число с плаваща запетая. Водещите нули се използват за подреждане на числата вместо интервал.
    • Ширина: Незадължителна * или цяла стойност, използвана за задаване на поле за минимална ширина.
    • Прецизност: Незадължително поле, състоящо се от a. последвано от * или цяло число или нищо, за да се определи точността.
    • Дължина: Незадължителен модификатор на дължина, който указва размера на аргумента.
    • Спецификатор: Спецификатор на формат за преобразуване. Наличните спецификатори на формата са както следва:
    Спецификатори на формата
    Форматизатор Описание
    % % Разпечатки
    ° С Пише един знак
    с Пише низ от символи
    d или i Преобразува подписано цяло число в десетично представяне
    o Преобразува неподписано цяло число в осмично представяне
    X или x Преобразува неподписано цяло число в шестнадесетично представяне
    u Преобразува неподписано цяло число в десетично представяне
    F или f Преобразува число с плаваща запетая в десетично представяне
    E или e Преобразува число с плаваща запетая в десетична степенна нотация
    A или a Преобразува число с плаваща запетая в шестнадесетичен експонент
    G или g Преобразува число с плаваща запетая в десетична или десетична степенна нотация
    н Връща броя на символите, написани до момента от това извикване на функцията. Резултатът се записва на стойността, посочена от аргумента
    стр Написва дефинирана последователност от символи, дефинираща указател.

    Така че общият формат на спецификатора на формата е: 
     % (знамена) (ширина) (. прецизност) (дължина) спецификатор
  • vlist: Списък с аргументи, съдържащи данните за запис.

vswprintf () Върната стойност

  • Ако успее, функцията vswprintf () връща броя на написаните широки символи, с изключение на завършващия нулев широк символ.
  • Връща се отрицателна стойност, ако възникне грешка в кодирането или ако броят на генерираните символи е равен или по-голям от buf_size.

Пример: Как работи функцията vswprintf ()?

 #include #include #include void write(wchar_t* buffer, size_t buf_size, const wchar_t *fmt,… ) ( va_list args; va_start(args, fmt); vswprintf(buffer, buf_size, fmt, args); va_end(args); ) int main () ( wchar_t str() = L"u0684 u06b1 u06aa u06a3 u0684"; wchar_t buffer(50); setlocale(LC_ALL, "en_US.UTF-8"); write(buffer, 50, L"Arabic Letters: %ls", str); wprintf(L"%ls", buffer); return 0; )

Когато стартирате програмата, следното ще бъде записано в example.txt:

 Арабски букви: ڄ ڱ ڪ ڣ ڄ

Интересни статии...