42 lines
986 B
Groff
42 lines
986 B
Groff
.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.
|