CKTIS / C++
std::left — подравняване на изходно поле вляво
std::left избира подравняване вляво за форматиран изход на поток. Когато полето е по-широко от стойността, знаците за запълване се появяват след нея. Настройката за подравняване остава активна, докато не бъде променена.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left е манипулатор, деклариран в <ios>. Записът out << std::left променя състоянието на форматиране на потока, вместо да извежда текст. Функцията извиква str.setf(std::ios_base::left, std::ios_base::adjustfield) и връща str: заменя настройката за подравняване, без да променя други групи флагове.
В изходно поле, подравнено вляво, знаците за запълване следват стойността. Задайте ширината с std::setw(width), а знака за запълване — с std::setfill(c); и двата манипулатора изискват <iomanip>. Ширината е минимална: по-дългият текст не се отрязва. std::left сам по себе си не задава нито ширината, нито знака за запълване.
Подравняването и знакът за запълване остават зададени, докато не бъдат променени. За разлика от тях, вмъкването на знак или низ от знаци нулира ширината на полето, затова използвайте отново std::setw преди всяко такова поле. std::right заменя подравняването вляво с подравняване вдясно. Когато използвате споделен поток, имайте предвид, че промененото състояние влияе и на следващите операции за извеждане.
Примерът използва точки, за да направи запълването видимо. Първите две полета показват, че std::left остава активно, а последното показва преминаването към std::right. Можете да проверите примера локално с опцията -std=c++23. Показаният изходен код е изпълнен без промени в изолирана среда, а стандартният изход (stdout) съвпада точно с очаквания. Тази проверка не удостоверява поведението на програмата по време на изпълнение в производствена среда.
Примери
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::left;
std::cout << '|' << std::setw(6) << "cat"
<< '|' << std::setw(6) << "ox" << "|\n";
std::cout << std::right
<< '|' << std::setw(6) << "cat" << "|\n";
}
Резултат
|cat...|ox....| |...cat|
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- C++ working draft — adjustfield manipulators [adjustfield.manip]
- C++ working draft — Header <ios> synopsis [ios.syn]
- C++ working draft — Common requirements [ostream.formatted.reqmts]
- C++ working draft — Character inserter function templates [ostream.inserters.character]
- C++ working draft — Standard manipulators [std.manip]