# bin2dec

Convert text representation of binary integer to double value

## Syntax

``D = bin2dec(binStr)``

## Description

example

````D = bin2dec(binStr)` converts the binary integer represented by `binStr` to the equivalent decimal number and returns it as a double-precision floating-point value.If `binStr` represents an integer greater than or equal to `flintmax`, then `bin2dec` might not represent it exactly as a floating-point value.```

## Examples

collapse all

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

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

Starting in R2019b, you can write values in binary format directly without using `bin2dec`. Use the `0b` prefix and do not use quotation marks. MATLAB® stores the value as an integer, not as text.

`D = 0b10111`
```D = uint8 23 ```

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×3 1023 122 14 ```

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

`D = [0b1111111111 0b1111010 0b1110]`
```D = 1x3 uint16 row vector 1023 122 14 ```

## Input Arguments

collapse all

Text representing binary numbers, specified as a character array, cell array of character vectors, or string array. `binStr` represents binary digits using the characters `0` and `1`.

• If `binStr` is a character array with multiple rows or a cell array of character vectors, then the output is a numeric column vector.

• If `binStr` is a string array, then the output is a numeric array that has the same dimensions.

A binary number represented by `binStr` can have no more than 53 digits.

Starting in R2020a, `binStr` can be text that includes the same prefixes (`0b` or `0B`) and suffixes used by binary literals. For example, these calls to `bin2dec` each return the number `7`.

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

Also, in R2020a `binStr` can 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 the `s8` suffix specifies the 8-bit signed integer type. In previous releases, `binStr` cannot represent a negative number.

## Version History

Introduced before R2006a

expand all