This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Convert a character string to an integer

MuPAD® notebooks are not recommended. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.


text2int(text, <b>)


text2int(text, b) converts a character string corresponding to an integer in b-adic representation to an integer of type DOM_INT.

It must consist of the first b characters in 0, 1, …, 9, A, B, …, Z, a, b, …, z. The letters are used to represent the b-adic digits larger than 9.

For bases larger than 10 but smaller than 37 the letters are not case sensitive. The lower case letters a, b, …, z are accepted: a = A = 10, …, z = Z = 35.

text2int is the inverse of int2text.


Example 1

Relative to the default base 10, text2int provides a mere datatype conversion from DOM_STRING to DOM_INT:

text2int("123"), text2int("-45678")

Example 2

The characters of the input string are interpreted as digits with respect to the specified base, the return value is a standard MuPAD® integer represented with respect to the decimal system. The following example converts integers from the base 2 and 16, respectively, to the base 10:

text2int("101", 2), text2int("101", 16)

The digit “3” does not exist in a binary representation:

text2int("103", 2)
Error: Invalid argument. [text2int]

Example 3

For bases larger than 10 but smaller than 37, the letters are not case-sensitive:

text2int("3B9ACA00", 16), text2int("Z", 36) = text2int("z", 36)

For bases larger than 37 however, the case makes a difference:

text2int("Z", 62) <> text2int("z", 62)



A character string


The base: an integer between 2 and 62. The default base is 10.

Return Values


Was this topic helpful?