Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 iden-
       tical.

       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  pro-
	       vided  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
	       command,	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 com-
       mand 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://www.freebsd.org/cgi/man.cgi?query=fstrcmp&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help