bin2dec

Convert text representation of binary integer to double value

Syntax

D = bin2dec(binStr)

Description

D= bin2dec(binStr)converts the binary integer represented bybinStrto the equivalent decimal number and returns it as a double-precision floating-point value.

IfbinStrrepresents an integer greater than or equal toflintmax, thenbin2decmight not represent it exactly as a floating-point value.

Examples

collapse all

Convert Text Representing Binary Value

Open Live Script

Convert a character vector that represents a binary value to a decimal number.

binStr ='10111'; D = bin2dec(binStr)

D = 23

从R2019b开始,你可以写在二进制值format directly without usingbin2dec. Use the0bprefix and do not use quotation marks. MATLAB® stores the value as an integer, not as text.

D = 0b10111

D =uint823

Return Numeric Array

Open Live Script

Create a string array that represents multiple binary values.

binStr = ["1111111111""1111010""1110"]

binStr =1x3 string"1111111111" "1111010" "1110"

Convert the binary values and return a numeric array.

D = bin2dec(binStr)

D =1×31023 122 14

Starting in R2019b, it is recommended that you create a numeric array using binary literals instead of converting text withbin2dec.

D = [0b1111111111 0b1111010 0b1110]

D =1x3 uint16 row vector1023 122 14

Input Arguments

collapse all

`binStr`—Text representing binary numbers
character array|cell array of character vectors|string array

Text representing binary numbers, specified as a character array, cell array of character vectors, or string array.binStrrepresents binary digits using the characters0and1.

IfbinStris a character array with multiple rows or a cell array of character vectors, then the output is a numeric column vector.
IfbinStris a string array, then the output is a numeric array that has the same dimensions.

A binary number represented bybinStrcan have no more than 53 digits.

Starting in R2020a,binStrcan be text that includes the same prefixes (0bor0B) and suffixes used by binary literals. For example, these calls tobin2deceach return the number7.

bin2dec('111') bin2dec('0b111') bin2dec('0b111s32')

Also, in R2020abinStrcan represent the two's complement of a negative number, using a suffix that specifies a signed integer type. For example,bin2dec('0b11111111s8')returns-1, because thes8suffix specifies the 8-bit signed integer type. In previous releases,binStrcannot represent a negative number.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

Input text must be specified as a character array or a string scalar. Cell arrays are not supported.
When the input is empty, the answer does not match the answer in MATLAB^®.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Usage notes and limitations:

Input text must be specified as a character array. Cell arrays are not supported.
When the input is empty, the answer does not match the answer in MATLAB.

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

This function fully supports thread-based environments. For more information, seeRun MATLAB Functions in Thread-Based Environment.

Version History

Introduced before R2006a

expand all

R2020b: Issue warning when input values are greater than or equal to`flintmax`

Behavior changed in R2020b

Thebin2decfunction issues a warning when input values are greater than or equal toflintmax. In previous releases,bin2decdid not issue this warning.

bin2decnow issues a warning because inputs representing integers greater than or equal toflintmaxmight not be represented exactly as double-precision floating-point values.

To convert values greater thanflintmaxexactly, consider one of these alternatives:

In place of scalar text inputs, use hexadecimal or binary literals representing the same values. When you write a value as a literal, MATLAB stores it as an integer that represents the value exactly. For more information, see十六进制和二进制值.
To convert hexadecimal inputs greater thanflintmax, you can use thesscanffunction with the%lxoperator. When you use%lx, the converted values are integers that have theuint64data type. These integers have enough storage to represent values greater thanflintmaxexactly.
.

bin2dec

Syntax

Description

Examples

Convert Text Representing Binary Value

Return Numeric Array

Input Arguments

`binStr`—Text representing binary numbers
character array|cell array of character vectors|string array

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

Version History

R2020b: Issue warning when input values are greater than or equal to`flintmax`

See Also

Topics

External Websites

bin2dec

Syntax

Description

Examples

Convert Text Representing Binary Value

Return Numeric Array

Input Arguments

binStr—Text representing binary numberscharacter array|cell array of character vectors|string array

Extended Capabilities

C/C++ Code GenerationGenerate C and C++ code using MATLAB® Coder™.

GPU Code GenerationGenerate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based EnvironmentRun code in the background using MATLAB®backgroundPoolor accelerate code with Parallel Computing Toolbox™ThreadPool.

Version History

R2020b: Issue warning when input values are greater than or equal toflintmax

See Also

Topics

External Websites

`binStr`—Text representing binary numbers
character array|cell array of character vectors|string array

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

R2020b: Issue warning when input values are greater than or equal to`flintmax`