std::strxfrm
Определено в заголовочном файле <cstring> | ||
std::size_t strxfrm(char* dest, constchar* src, std::size_t count ); | ||
Преобразует строку байтов с нулевым завершающим символом, на которую указывает src, в форму, определяемую реализацией, так чтобы сравнение двух преобразованных строк с помощью std::strcmp давало тот же результат, что и сравнение исходных строк с std::strcoll в текущей локали C.
Первые count символов преобразованной строки записываются в место назначения, включая завершающий нулевой символ, и возвращается длина полной преобразованной строки, исключая завершающий нулевой символ.
Поведение не определено, если массив dest недостаточно велик. Поведение не определено, если dest и src перекрываются.
Если count равно 0, то dest может быть нулевым указателем.
Содержание |
[править]Примечание
Правильная длина буфера, который может принять всю преобразованную строку, равна 1+ std::strxfrm(nullptr, src, 0).
Эта функция используется при выполнении нескольких сравнений, зависящих от локали, с использованием одной и той же строки или набора строк, поскольку более эффективно использовать std::strxfrm для однократного преобразования всех строк и последующего сравнения преобразованных строк с помощью std::strcmp.
[править]Параметры
| dest | — | указатель на первый элемент массива, куда будет записана преобразованная строка |
| src | — | указатель на первый символ строки байтов с нулевым завершающим символом для преобразования |
| count | — | максимальное количество символов для записи |
[править]Возвращаемое значение
Длина преобразованной строки, не включая завершающий нулевой символ.
[править]Пример
#include <cassert>#include <cstring>#include <iomanip>#include <iostream>#include <string> int main(){char* loc =std::setlocale(LC_COLLATE, "cs_CZ.iso88592");assert(loc); std::string in1 ="hrnec";std::string out1(1+ std::strxfrm(nullptr, in1.c_str(), 0), ' ');std::string in2 ="chrt";std::string out2(1+ std::strxfrm(nullptr, in2.c_str(), 0), ' '); std::strxfrm(&out1[0], in1.c_str(), out1.size()); std::strxfrm(&out2[0], in2.c_str(), out2.size()); std::cout<<"В чешской локали: ";if(out1 < out2)std::cout<< in1 <<" перед "<< in2 <<'\n';elsestd::cout<< in2 <<" перед "<< in1 <<'\n'; std::cout<<"В лексикографическом сравнении: ";if(in1 < in2)std::cout<< in1 <<" перед "<< in2 <<'\n';elsestd::cout<< in2 <<" перед "<< in1 <<'\n';}
Возможный вывод:
В чешской локали: hrnec перед chrt В лексикографическом сравнении: chrt перед hrnec
[править]Смотрите также
| преобразует широкую строку так, чтобы wcscmp давала тот же результат, что и wcscoll (функция) | |
[virtual] | преобразует строку так, чтобы сортировки можно заменить сравнение Оригинал: transforms a string so that collation can be replaced by comparison Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (virtual protected std::collate функция-элемент) |
| сравнивает две строки в соответствии с текущей локалью (функция) | |
Документация C по strxfrm | |
