AstraRegul
Релиз 2024.08.31.00
×

ToString

 
Возвращает строковое представление указанного значения.
 
string String.ToString(int8 x)
string String.ToString(uint8 x)
string String.ToString(double x)
string String.ToString(string format, int8 x)
string String.ToString(string format, uint8 x)
string String.ToString(string format, double x)
string String.ToString(bool x)
 

Параметры

 
Параметр
Тип
Описание
format
string
Опциональный параметр
Правило преобразования чисел в строку в формате printf: https://en.wikipedia.org/wiki/Printf_format_string
Если не указан, используется значение %f
x
int8, uint8, double, bool
Значение, которое нужно преобразовать к строке
 

Обратите внимание

 
Формат вывода %f, который используется по умолчанию, имеет точность 6 знаков после запятой. Если нужно преобразовывать числа в строку с большей точностью, укажите формат вывода с большей точностью. Например, %.10f – выводить дробные числа с точностью 10 знаков после запятой.
 

Возвращаемое значение

 
Тип – string.
 
Строковое представление значения x:
если x имеет тип bool – возвращается строка true или false.
если x – число, возвращается строковое представление этого числа в формате format.
 

Примеры

 
//Преобразование целых чисел:
a: string = String.ToString(777); // Результат: "777"
b: string = String.ToString("%05f", 12); // Результат: "00012"
c: string = String.ToString("%05f", -12); // Результат: "-0012"
 
//Преобразование вещественных чисел:
a: string = String.ToString(1.1); // Результат: "1.100000"
b: string = String.ToString(-123.0e-2); // Результат: "-1.230000"
c: string = String.ToString("%e", 0.001); // Результат: "1.000000e-03" (экспоненциальная форма записи)
d: string = String.ToString(0.123456789); // Результат: "0.123457" (значение округляется до 6 знаков после запятой)
e: string = String.ToString("%.10f", 0.123456789); // Результат: "0.1234567890" (значение выводится с точностью 10 знаков после запятой)
 
//Преобразование логических значений:
a: string = String.ToString(true); // Результат: "true"