Home Original page

stdlib/lib/node_modules/@stdlib/assert/is-alphanumeric at develop · stdlib-js/stdlib

isAlphaNumeric

Test whether a string contains only alphanumeric characters.

Usage

var isAlphaNumeric = require( '@stdlib/assert/is-alphanumeric' );

isAlphaNumeric( value )

Tests whether a string contains only alphanumeric characters.

var bool = isAlphaNumeric( 'abc0123456789' );
// returns true

Notes

  • For non-string values, the function returns false.
  • Alphanumeric is defined as the characters a-zA-Z and the numeric characters 0-9.

Examples

var isAlphaNumeric = require( '@stdlib/assert/is-alphanumeric' );

var out = isAlphaNumeric( 'abs0123456789' );
// returns true

out = isAlphaNumeric( '0xffffff' );
// returns true

out = isAlphaNumeric( '' );
// returns false

out = isAlphaNumeric( 123 );
// returns false

CLI

Usage

Usage: is-alphanumeric [options] [<string>]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.

Notes

  • If the split separator is a regular expression, ensure that the split option is either properly escaped or enclosed in quotes.

    # Not escaped...
$ echo -n $'beep\n01abc23456789' | is-alphanumeric --split /\r?\n/
# Escaped...
$ echo -n $'beep\n01abc23456789' | is-alphanumeric --split /\\r?\\n/

  • The implementation ignores trailing delimiters.

Examples

$ is-alphanumeric 01abc23456789
true

To use as a standard stream,

$ echo -n '0123456789' | is-alphanumeric
true

By default, when used as a standard stream, the implementation assumes newline-delimited data. To specify an alternative delimiter, set the split option.

$ echo -n 'beep\t01abc23456789' | is-alphanumeric --split '\t'
false
true

See Also