Str2num matlab что это
num2str
Convert numbers to character array
Syntax
Description
s = num2str( A ) converts a numeric array into a character array that represents the numbers. The output format depends on the magnitudes of the original values. num2str is useful for labeling and titling plots with numeric values.
Examples
Default Conversions of Floating-Point Values
Convert the floating-point values returned by pi and eps to character vectors.
Specify Precision
Specify the maximum number of significant digits for floating-point values.
Specify Formatting
Display pi as a floating-point number to a specified precision.
Input Arguments
A — Input array
numeric array
Input array, specified as a numeric array.
Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
Complex Number Support: Yes
precision — Maximum number of significant digits
positive integer
Maximum number of significant digits in the output string, specified as a positive integer.
Note
If you specify precision to exceed the precision of the input floating-point data type, the results might not match the input values to the precision you specified. The result depends on your computer hardware and operating system.
Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
formatSpec — Format of output fields
formatting operators
Format of the output fields, specified using formatting operators. formatSpec also can include ordinary text and special characters.
formatSpec can be a character vector in single quotes, or, starting in R2016b, a string scalar.
This table shows conversion characters to format numeric and character data as text.
Base 16 (hexadecimal), lowercase letters a – f
Fixed-point notation (Use a precision operator to specify the number of digits after the decimal point.)
Exponential notation, such as 3.141593e+00 (Use a precision operator to specify the number of digits after the decimal point.)
Characters or strings
The optional identifier, flags, field width, precision, and subtype operators further define the format of the output text.
Note: Unlike the sprintf function, num2str does not support identifiers.
Always print a sign character (+ or –) for any numeric value.
Example: %+5.2f
Right-justify text.
Example: %+10s
Insert a space before the value.
Example: % 5.2f
Pad to field width with zeros before the value.
Example: %05.2f
Modify selected numeric conversions:
Minimum number of characters to print.
Example: ‘%5d’ prints intmax as 2147483647 because the value returned by intmax exceeds the minimum number of characters to print.
If the number of characters to print is less than the field width, then the compose function pads to the field width with spaces before the value unless otherwise specified by flags.
However, the num2str function does not pad to the field width with spaces.
Number of digits to print.
Number of digits to the right of the decimal point
Example: ‘%.4f’ prints pi as ‘3.1416’
Number of significant digits
Example: ‘%.4g’ prints pi as ‘3.142’
Note
If you specify a precision operator for floating-point values that exceeds the precision of the input numeric data type, the results might not match the input values to the precision you specified. The result depends on your computer hardware and operating system.
You can use a subtype operator to print a floating-point value as its octal, decimal, or hexadecimal value. The subtype operator immediately precedes the conversion character. This table shows the conversions that can use subtypes.
Subtype and Conversion Character
Double-precision hexadecimal, octal, or decimal value
Example: %bx prints pi as 400921fb54442d18
Single-precision hexadecimal, octal, or decimal value
Example: %tx prints pi as 40490fdb
Text Before or After Formatting Operators
Ordinary text to print.
Single quotation mark
Character whose Unicode ® numeric value can be represented by the hexadecimal number, N
Example: sprintf(‘\x5A’) returns ‘Z’
Character whose Unicode numeric value can be represented by the octal number, N
Example: sprintf(‘\132’) returns ‘Z’
Notable Behavior of Conversions with Formatting Operators
Numeric conversions print only the real component of complex numbers.
If you apply a text conversion (either %c or %s ) to integer values, MATLAB converts values that correspond to valid character codes to characters.
Output Arguments
s — Text representation of input array
character array
Text representation of the input array, returned as a character array.
num2str does not accept positional identifiers in the formatSpec input argument. For example, num2str([14 15],’%2$X %1$o) returns an error.
If you specify an invalid formatting operator or special character, then num2str prints all text up to the invalid operator or character and discards the rest.
Algorithms
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
The input arguments must be constants.
This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.
GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.
num2str
Convert numbers to character array
Syntax
Description
s = num2str( A ) converts a numeric array into a character array that represents the numbers. The output format depends on the magnitudes of the original values. num2str is useful for labeling and titling plots with numeric values.
Examples
Default Conversions of Floating-Point Values
Convert the floating-point values returned by pi and eps to character vectors.
Specify Precision
Specify the maximum number of significant digits for floating-point values.
Specify Formatting
Display pi as a floating-point number to a specified precision.
Input Arguments
A — Input array
numeric array
Input array, specified as a numeric array.
Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
Complex Number Support: Yes
precision — Maximum number of significant digits
positive integer
Maximum number of significant digits in the output string, specified as a positive integer.
Note
If you specify precision to exceed the precision of the input floating-point data type, the results might not match the input values to the precision you specified. The result depends on your computer hardware and operating system.
Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
formatSpec — Format of output fields
formatting operators
Format of the output fields, specified using formatting operators. formatSpec also can include ordinary text and special characters.
formatSpec can be a character vector in single quotes, or, starting in R2016b, a string scalar.
This table shows conversion characters to format numeric and character data as text.
Base 16 (hexadecimal), lowercase letters a – f
Fixed-point notation (Use a precision operator to specify the number of digits after the decimal point.)
Exponential notation, such as 3.141593e+00 (Use a precision operator to specify the number of digits after the decimal point.)
Characters or strings
The optional identifier, flags, field width, precision, and subtype operators further define the format of the output text.
Note: Unlike the sprintf function, num2str does not support identifiers.
Always print a sign character (+ or –) for any numeric value.
Example: %+5.2f
Right-justify text.
Example: %+10s
Insert a space before the value.
Example: % 5.2f
Pad to field width with zeros before the value.
Example: %05.2f
Modify selected numeric conversions:
Minimum number of characters to print.
Example: ‘%5d’ prints intmax as 2147483647 because the value returned by intmax exceeds the minimum number of characters to print.
If the number of characters to print is less than the field width, then the compose function pads to the field width with spaces before the value unless otherwise specified by flags.
However, the num2str function does not pad to the field width with spaces.
Number of digits to print.
Number of digits to the right of the decimal point
Example: ‘%.4f’ prints pi as ‘3.1416’
Number of significant digits
Example: ‘%.4g’ prints pi as ‘3.142’
Note
If you specify a precision operator for floating-point values that exceeds the precision of the input numeric data type, the results might not match the input values to the precision you specified. The result depends on your computer hardware and operating system.
You can use a subtype operator to print a floating-point value as its octal, decimal, or hexadecimal value. The subtype operator immediately precedes the conversion character. This table shows the conversions that can use subtypes.
Subtype and Conversion Character
Double-precision hexadecimal, octal, or decimal value
Example: %bx prints pi as 400921fb54442d18
Single-precision hexadecimal, octal, or decimal value
Example: %tx prints pi as 40490fdb
Text Before or After Formatting Operators
Ordinary text to print.
Single quotation mark
Character whose Unicode ® numeric value can be represented by the hexadecimal number, N
Example: sprintf(‘\x5A’) returns ‘Z’
Character whose Unicode numeric value can be represented by the octal number, N
Example: sprintf(‘\132’) returns ‘Z’
Notable Behavior of Conversions with Formatting Operators
Numeric conversions print only the real component of complex numbers.
If you apply a text conversion (either %c or %s ) to integer values, MATLAB converts values that correspond to valid character codes to characters.
Output Arguments
s — Text representation of input array
character array
Text representation of the input array, returned as a character array.
num2str does not accept positional identifiers in the formatSpec input argument. For example, num2str([14 15],’%2$X %1$o) returns an error.
If you specify an invalid formatting operator or special character, then num2str prints all text up to the invalid operator or character and discards the rest.
Algorithms
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
The input arguments must be constants.
This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.
GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.
Документация
Преобразуйте числа в символьный массив
Синтаксис
Описание
s = num2str( A ) преобразовывает числовой массив в символьный массив, который представляет числа. Выходной формат зависит от значений исходных значений. num2str полезен для графиков маркировки и создания заголовков с числовыми значениями.
Примеры
Преобразования по умолчанию значений с плавающей точкой
Определение точности
Задайте максимальное количество значительных цифр для значений с плавающей точкой.
Определение форматирования
Задайте ширину, точность и другое форматирование для массива значений с плавающей точкой.
Входные параметры
A Входной массив
числовой массив
Входной массив, заданный как числовой массив.
Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
Поддержка комплексного числа: Да
точность Максимальное количество значительных цифр
положительное целое число
Максимальное количество значительных цифр в выводимой строке, заданной как положительное целое число.
Примечание
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
formatSpec Формат выходных полей
форматирование операторов
Формат выходных полей, заданных операторов форматирования использования. formatSpec также может включать обычный текст и специальные символы.
formatSpec может быть вектором символов в одинарных кавычках, или, запускающийся в R2016b, скаляре строки.
Эта таблица показывает символы преобразования, чтобы отформатировать числовые и символьные данные как текст.
Целое число, подписанное
Целое число, без знака
Базируйтесь 8 (восьмеричный)
Основывайте 16 (шестнадцатеричных), строчных букв a – f
Число с плавающей запятой
Представление с фиксированной точкой (Используют оператор точности, чтобы задать количество цифр после десятичной точки.)
Экспоненциальное представление, такое как 3.141593e+00 (Используют оператор точности, чтобы задать количество цифр после десятичной точки.)
Символы или строки
Дополнительный идентификатор, флаги, ширина поля, точность и операторы подтипа далее задают формат синтезируемого текста.
Примечание: Если входной параметр является массивом, вы не можете использовать идентификаторы, чтобы задать конкретные элементы массива от того входного параметра.
Лево-выровнять по ширине.
Пример: %-5.2f
Пример: %-10s
Вставьте пробел перед значением.
Пример: % 5.2f
Заполните к ширине поля нулями перед значением.
Пример: %05.2f
Измените выбранные числовые преобразования:
Минимальное количество символов, чтобы распечатать. Оператор ширины поля может быть номером или звездочкой ( * ), чтобы относиться к входному параметру.
Когда вы задаете * как оператор ширины поля, другие входные параметры должны обеспечить и ширину и значение, которое будет распечатано. Ширины и значения могут быть парами аргументов или парами в числовом массиве. С * как оператор ширины поля можно распечатать различные значения с различными ширинами.
Функция заполняет к ширине поля пробелами перед значением, если в противном случае не задано флагами.
Количество цифр справа от десятичной точки
Пример: ‘%.4f’ распечатывает pi как ‘3.1416’
Количество значительных цифр
Пример: ‘%.4g’ распечатывает pi как ‘3.142’
Оператор точности может быть номером или звездочкой ( * ), чтобы относиться к аргументу.
Когда вы задаете * как полевой оператор точности, другие входные параметры должны обеспечить и точность и значение, которое будет распечатано. Точность и значения могут быть парами аргументов или парами в числовом массиве. С * как оператор точности можно распечатать различные значения к различной точности.
Когда вы задаете *.* как ширину поля и операторы точности, необходимо задать ширину поля, точность и значения как триплеты.
Примечание
Если вы задаете оператор точности для значений с плавающей точкой, который превышает точность входного типа числовых данных, результаты не могут совпадать с входными значениями к точности, которую вы задали. Результат зависит от вашего компьютерного оборудования и операционной системы.
Можно использовать оператор подтипа, чтобы распечатать значение с плавающей точкой как его восьмеричное, десятичное, или шестнадцатеричное значение. Оператор подтипа сразу предшествует символу преобразования. Эта таблица показывает преобразования, которые могут использовать подтипы.
Тип входного значения
Подтип и символ преобразования
Тип выходного значения
Число с плавающей запятой
С двойной точностью шестнадцатеричное, восьмеричное, или десятичное значение
Пример: %bx распечатывает pi как 400921fb54442d18
Шестнадцатеричное, восьмеричное, или десятичное значение с одинарной точностью
Пример: %tx распечатывает pi как 40490fdb
Текст прежде или после операторов форматирования
Обычный текст, чтобы распечатать.
Документация
Преобразуйте числа в символьный массив
Синтаксис
Описание
s = num2str( A ) преобразует числовой массив в символьный массив, который представляет числа. Выходной формат зависит от величин исходных значений. num2str полезно для графиков маркировки и создания заголовков с числовыми значениями.
Примеры
Преобразования по умолчанию значений с плавающей точкой
Определение точности
Задайте максимальное количество значащих цифр для значений с плавающей точкой.
Определение форматирования
Отобразите pi как число с плавающей запятой к заданной точности.
Входные параметры
A — Входной массив
числовой массив
Входной массив в виде числового массива.
Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
Поддержка комплексного числа: Да
precision — Максимальное количество значительных цифр
положительное целое число
Максимальное количество значительных цифр в выводимой строке в виде положительного целого числа.
Примечание
Если вы задаете precision чтобы превысить точность входа тип данных с плавающей точкой, результаты не могут совпадать с входными значениями к точности, которую вы задали. Результат зависит от вашего компьютерного оборудования и операционной системы.
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
formatSpec — Формат выходных полей
форматирование операторов
Формат выходных полей, заданных операторов форматирования использования. formatSpec также может включать обычный текст и специальные символы.
formatSpec может быть вектор символов в одинарных кавычках, или, запускающийся в R2016b, строковом скаляре.
Эта таблица показывает символы преобразования, чтобы отформатировать числовые и символьные данные как текст.
Целое число, со знаком
Целое число, без знака
Базируйтесь 8 (восьмеричный)
Основывайте 16 (шестнадцатеричных), строчных букв a F
Число с плавающей запятой
Представление с фиксированной точкой (Используют оператор точности, чтобы задать количество цифр после десятичной точки.)
Экспоненциальное представление, такое как 3.141593e+00 (Используйте оператор точности, чтобы задать количество цифр после десятичной точки.)
Символы или строки
Дополнительный идентификатор, флаги, ширина поля, точность и операторы подтипа далее задают формат синтезируемого текста.
Примечание: в отличие от этого, sprintf функция, num2str не поддерживает идентификаторы.
Лево-выровнять по ширине.
Пример: %-5.2f
Пример: %-10s
Вставьте пробел перед значением.
Пример: % 5.2f
Заполните к ширине поля нулями перед значением.
Пример: %05.2f
Измените выбранные числовые преобразования:
Минимальное количество символов, чтобы распечатать.
Если количество символов, чтобы распечатать меньше ширины поля, то compose функционируйте клавиатуры к ширине поля с пробелами перед значением, если в противном случае не задано флагами.
Однако num2str функция не заполняет к ширине поля пробелами.
Количество цифр, чтобы распечатать.
Количество цифр справа от десятичной точки
Пример: ‘%.4f’ печать pi как ‘3.1416’
Количество значительных цифр
Пример: ‘%.4g’ печать pi как ‘3.142’
Примечание
Если вы задаете оператор точности для значений с плавающей точкой, который превышает точность входного типа числовых данных, результаты не могут совпадать с входными значениями к точности, которую вы задали. Результат зависит от вашего компьютерного оборудования и операционной системы.
Можно использовать оператор подтипа, чтобы распечатать значение с плавающей точкой как его восьмеричное, десятичное, или шестнадцатеричное значение. Оператор подтипа сразу предшествует символу преобразования. Эта таблица показывает преобразования, которые могут использовать подтипы.
Тип входного значения
Подтип и символ преобразования
Тип выходного значения
Число с плавающей запятой
С двойной точностью шестнадцатеричное, восьмеричное, или десятичное значение
Пример: %bx печать pi как 400921fb54442d18
Шестнадцатеричное, восьмеричное, или десятичное значение с одинарной точностью
Пример: %tx печать pi как 40490fdb
Текст прежде или после операторов форматирования
Обычный текст, чтобы распечатать.
Обратная косая черта
Символ, чей Unicode ® числовое значение может быть представлено шестнадцатеричным номером, N
Пример: sprintf(‘\x5A’) возвращает ‘Z’
Символ, числовое значение Unicode которого может быть представлено восьмеричным числом, N
Пример: sprintf(‘\132’) возвращает ‘Z’
Известное поведение преобразований с операторами форматирования
Числовые преобразования распечатывают только действительный компонент комплексных чисел.
Если вы применяете текстовое преобразование (любой %c или %s ) к целочисленным значениям MATLAB преобразует значения, которые соответствуют кодам допустимого символа к символам.
Выходные аргументы
s — Текстовое представление входного массива
массив символов
Текстовое представление входного массива, возвращенного как символьный массив.
Советы
num2str не принимает позиционные идентификаторы в formatSpec входной параметр. Например, num2str([14 15],’%2$X %1$o) возвращает ошибку.
Если вы задаете недопустимый оператор форматирования или специальный символ, то num2str печать весь текст до недействительного оператора или символа и отбрасываний остальные.
Пример: если formatSpec ‘value = %z’ то num2str печать ‘value =’ потому что %z не оператор форматирования.
Пример: если formatSpec ‘character \x99999 = %s’ то num2str печать ‘character’ потому что \x99999 не допустимый специальный символ.
Алгоритмы
Расширенные возможности
Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.
Указания и ограничения по применению:
Входные параметры должны быть константами.
Эта функция полностью поддерживает основанные на потоке среды. Для получения дополнительной информации смотрите функции MATLAB Запуска в Основанной на потоке Среде.
Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.
Смотрите также
Открытый пример
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
Документация MATLAB
Поддержка
© 1994-2021 The MathWorks, Inc.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.