FreeBSD Manual Pages
fstrcmp(1) General Commands Manual fstrcmp(1) NAME fstrcmp - fuzzy comparison of strings SYNOPSIS fstrcmp [ -p ] first-string second-string fstrcmp -w first-string second-string fstrcmp -a first-file second-file fstrcmp -s needle haystack... fstrcmp --version DESCRIPTION The fstrcmp command is used to make fuzzy comparisons between strings. The "edit distance" between the strings is printed, with 0.0 meaning the strings are utterly un-alike, and 1.0 meaning the strings are identical. You may need to quote the string to insulate them from the shell. OPTIONS The fstrcmp command understands the following options: -a --files-as-bytes This option is used to compare two files as arrays of bytes. See fmemcmp(3) for more information. -p --pair This option is used to compare two strings as arrays of bytes. This is the default. See fstrcmp(3) for more information. -s --select This option is used to select the closest needle from the provided haystack alternatives. The most similar (single) choice is printed. If none are particularly similar, nothing is printed. See fstrcmp(3) for more information. See below for example. -V --version This option may be used to print the version of the fstrcmp com- mand, and then exit. -w --wide-pair This option is used to compare two multi-byte character strings. See fstrcoll(3) for more information. EXIT STATUS The fstrcmp command exits with status 1 on any error. The fstrcmp command only exits with status 0 if there are no errors. EXAMPLE The fstrcmp --select option may be used in a shell script to improve error messages. case "$action" in start) start ;; stop) stop ;; restart) stop start ;; *) echo "$0: action \"$action\" unknown" 1>&2 guess=`fstrcmp --select "$action" stop start restart` if [ "$guess" ] then echo "$0: did you mean \"$guess\" instead?" 1>&2 fi exit 1 ;; esac Thus, the error message frequently suggests the correct action in the face of simple finger problems on the command line. SEE ALSO fstrcmp(3) fuzzy comparison of strings fstrcoll(3) fuzzy comparison of two multi-byte character strings fstrcmpi(3) fuzzy comparison of strings, integer variation COPYRIGHT fstrcmp version 0.7 Copyright (C) 2009 Peter Miller Peter Miller <pmiller@opensource.org.au> The comparison code is derived from the fuzzy comparison functions in GNU Gettext 0.17. The GNU Gettext comparison functions were, in turn, derived from GNU Diff 2.7. Copyright (C) 1988-2009 Free Software Foundation fstrcmp(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | EXAMPLE | SEE ALSO | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fstrcmp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>