.TH STRIS 1

.SH NAME

str \(en test the character types of string arguments

.SH SYNOPSIS

str
.RB [ type ]
.RB [ string... ]

.SH DESCRIPTION

Str tests each character in an arbitrary quantity of string arguments against the function of the same name within ctype(3).

.SH DIAGNOSTICS

Str exits successfully if all tests pass and unsuccessfully if a test failed.
.PP
Str will exit unsuccessfully if a string is empty, as none of its contents passed the test.
.PP
Str will print a message to standard error and exit unsuccessfully if used improperly.

.SH EXTENSIONS FROM CTYPE

Using the ctype "isvalue", which does not exist within ctype(3), will make str exit successfully as long as the given string(s) have non-zero length.

.SH BUGS

There's no way of knowing which argument failed the test without re-testing arguments individually.
.PP
If a character in a string isn't valid ASCII str will exit unsuccessfully.

.SH SEE ALSO

ctype(3), ascii(7)

.SH COPYRIGHT

Public domain.