pandas.Series.str.isdecimal — pandas 2.2.3 documentation (original) (raw)

Series.str.isdecimal()[source]#

Check whether all characters in each string are decimal.

This is equivalent to running the Python string methodstr.isdecimal() for each element of the Series/Index. If a string has zero characters, False is returned for that check.

Returns:

Series or Index of bool

Series or Index of boolean values with the same length as the original Series/Index.

Examples

Checks for Alphabetic and Numeric Characters

s1 = pd.Series(['one', 'one1', '1', ''])

s1.str.isalpha() 0 True 1 False 2 False 3 False dtype: bool

s1.str.isnumeric() 0 False 1 False 2 True 3 False dtype: bool

s1.str.isalnum() 0 True 1 True 2 True 3 False dtype: bool

Note that checks against characters mixed with any additional punctuation or whitespace will evaluate to false for an alphanumeric check.

s2 = pd.Series(['A B', '1.5', '3,000']) s2.str.isalnum() 0 False 1 False 2 False dtype: bool

More Detailed Checks for Numeric Characters

There are several different but overlapping sets of numeric characters that can be checked for.

s3 = pd.Series(['23', '³', '⅕', ''])

The s3.str.isdecimal method checks for characters used to form numbers in base 10.

s3.str.isdecimal() 0 True 1 False 2 False 3 False dtype: bool

The s.str.isdigit method is the same as s3.str.isdecimal but also includes special digits, like superscripted and subscripted digits in unicode.

s3.str.isdigit() 0 True 1 True 2 False 3 False dtype: bool

The s.str.isnumeric method is the same as s3.str.isdigit but also includes other characters that can represent quantities such as unicode fractions.

s3.str.isnumeric() 0 True 1 True 2 True 3 False dtype: bool

Checks for Whitespace

s4 = pd.Series([' ', '\t\r\n ', '']) s4.str.isspace() 0 True 1 True 2 False dtype: bool

Checks for Character Case

s5 = pd.Series(['leopard', 'Golden Eagle', 'SNAKE', ''])

s5.str.islower() 0 True 1 False 2 False 3 False dtype: bool

s5.str.isupper() 0 False 1 False 2 True 3 False dtype: bool

The s5.str.istitle method checks for whether all words are in title case (whether only the first letter of each word is capitalized). Words are assumed to be as any sequence of non-numeric characters separated by whitespace characters.

s5.str.istitle() 0 False 1 True 2 False 3 False dtype: bool