Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
locale
has_facet
isalnum
isalpha
iscntrl
isdigit
isgraph
islower
isprint
ispunct
isspace
isupper
isxdigit
locale
tolower
toupper
use_facet
standard facets:
codecvt
codecvt_base
codecvt_byname
collate
collate_byname
ctype
ctype_base
ctype_byname
messages
messages_base
messages_byname
moneypunct
moneypunct_byname
money_base
money_get
money_put
numpunct
numpunct_byname
num_get
num_put
time_base
time_get
time_get_byname
time_put
time_put_byname


isalnum

function template
<locale>
template <class charT>
  bool isalnum ( charT c, const locale& loc );

Check if character is alphanumeric using locale

Checks whether c is an alphanumeric character using ctype facet of locale loc, returning the same as a call to:

 
use_facet < ctype<charT> > (loc).is (ctype_base::alnum, c)


This function replicates the functionality of its C-library equivalent isalnum. See isalnum for more info.

Parameters

c
Character to be checked.
loc
Locale to be used. Shall have facet ctype present.

Template parameter charT is the character type.

Return Value

true if indeed c is an alphanumeric character, false otherwise.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// isalnum example (C++)
#include <iostream>
#include <string>
#include <locale>
using namespace std;
int main ()
{
  locale loc;
  string str = "c3po...";
  size_t i=0;
  while ( (i<str.length()) && (isalnum(str[i])) ) {++i;}
  cout << "The first " << i << " characters are alphanumeric.\n";
  return 0;
}


Output:

The first 4 characters are alphanumeric.

See also