The doc of `str.isalnum()` should say `alphanumeric(alphabetic and/or numeric)` which is more clear

[hyperkai]

The doc of str.isalnum() only says alphanumeric which is less clear because we don't clearly know both of alphabetic and numeric characters or either of alphabetic or numeric characters as shown below:

Return True if all characters in the string are alphanumeric and there is at least one character, False otherwise. ...

So, the doc of str.isalnum() should say alphanumeric(alphabetic and/or numeric) which is more clear as shown below:

Return True if all characters in the string are alphanumeric(alphabetic and/or numeric) and there is at least one character, False otherwise. ...

print('abc123'.isalnum())
print('abc'.isalnum())
print('123'.isalnum())
# True

print('a b c 1 2 3'.isalnum())
print('a b c'.isalnum())
print('1 2 3'.isalnum())
# False

[AA-Turner]

I think the second sentence is very clear: "A character c is alphanumeric if one of the following returns True: c.isalpha(), c.isdecimal(), c.isdigit(), or c.isnumeric().". In general, 'alphanumeric' is a well-known term. I agree adding an example would be nice, but I'll close this issue in favour of the string-examples issue.

A

[hugovk]

close this issue in favour of the string-examples issue.

#106318