QString::number()

QString::number() - это статический метод класса QString в Qt, который преобразует число (целое или с плавающей точкой) в строковое представление. Этот метод перегружен для различных числовых типов и предоставляет различные параметры форматирования.

 

Основные варианты использования и их параметры:

 

1. Преобразование целых чисел:

 

QString QString::number(int n, int base = 10)

 

QString QString::number(long n, int base = 10)

 

QString QString::number(long long n, int base = 10)

 

QString QString::number(uint n, int base = 10)

 

QString QString::number(ulong n, int base = 10)

 

QString QString::number(ulong long n, int base = 10)

 

n: Число, которое нужно преобразовать.

base: (необязательный параметр, по умолчанию 10) Основание системы счисления. Может быть 2 (двоичная), 8 (восьмеричная), 10 (десятичная) или 16 (шестнадцатеричная). Если base равно 16, используются символы 0-9 и a-f для представления цифр.

Примеры:

 

int num = 123;

QString str = QString::number(num); // str == "123" (в десятичной системе)

 

long long bigNum = 9876543210LL;

QString strBig = QString::number(bigNum); // strBig == "9876543210"

 

int hexNum = 255;

QString hexStr = QString::number(hexNum, 16); // hexStr == "ff" (в шестнадцатеричной системе)

 

int binNum = 5;

QString binStr = QString::number(binNum, 2); // binStr == "101" (в двоичной системе)

2. Преобразование чисел с плавающей точкой:

 

QString QString::number(double n, char format = 'g', int precision = 6)

 

QString QString::number(float n, char format = 'g', int precision = 6)

 

n: Число, которое нужно преобразовать.

 

format: (необязательный параметр, по умолчанию 'g') Символ, указывающий формат представления числа. Основные значения:

 

'e': Научная нотация (например, 1.23456e+02).

'E': Научная нотация с большой буквой E (например, 1.23456E+02).

'f': Фиксированная нотация (например, 123.456).

'g': Общий формат. Использует фиксированную нотацию, если это уместно, иначе научную. Алгоритм выбирает наиболее компактное представление.

'G': Общий формат с большой буквой E в научной нотации.

precision: (необязательный параметр, по умолчанию 6) Количество значащих цифр (для 'g' и 'G') или количество цифр после десятичной точки (для 'e', 'E' и 'f').

 

Примеры:

 

double pi = 3.14159265359;

QString strPi = QString::number(pi); // strPi == "3.14159" (по умолчанию 'g' и 6 знаков)

 

QString strPiFixed = QString::number(pi, 'f', 3); // strPiFixed == "3.142" (фиксированная нотация, 3 знака после точки)

 

double largeNum = 1234567.89;

QString strLarge = QString::number(largeNum); // strLarge == "1.23457e+06" ('g' автоматически выбирает научную нотацию)

 

QString strLargeFixed = QString::number(largeNum, 'f', 2); // strLargeFixed == "1234567.89"

 

double smallNum = 0.000012345;

QString strSmall = QString::number(smallNum); // strSmall == "1.2345e-05"

 

QString strSmallFixed = QString::number(smallNum, 'f', 8); // strSmallFixed == "0.00001235"

Ключевые моменты:

 

QString::number() всегда возвращает новый объект QString.

Этот метод не изменяет исходное число.

По умолчанию (без указания format и precision), используется формат 'g' с точностью 6, что часто является наиболее подходящим вариантом.

Правильный выбор format и precision важен для получения желаемого строкового представления числа.

Учитывайте локализацию при форматировании чисел для отображения пользователю (например, использование запятой вместо точки в качестве десятичного разделителя). Qt предоставляет классы QLocale и QFormatString для локализованного форматирования.

Пример с локализацией:

 

#include <QLocale>

 

double value = 1234.567;

 

// Получаем локаль пользователя

QLocale locale;

 

// Форматируем число с использованием локали

QString formattedNumber = locale.toString(value, 'f', 2);

 

qDebug() << formattedNumber; // Вывод зависит от локали (например, "1 234,57" для русской локали)

В заключение, QString::number() - это мощный и удобный инструмент для преобразования чисел в строки в Qt. Правильное использование параметров format и precision позволяет получить строковое представление числа в нужном формате. Не забывайте о локализации, если необходимо отображать числа пользователю в соответствии с его региональными настройками.