Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

fstrcmp(1) [debian man page]

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 mean-
       ing 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 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 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.4
       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)

Check Out this Related Man Page

Similarity(3)						User Contributed Perl Documentation					     Similarity(3)

NAME

       String::Similarity - calculate the similarity of two strings

SYNOPSIS

	use String::Similarity;

	$similarity = similarity $string1, $string2;
	$similarity = similarity $string1, $string2, $limit;

DESCRIPTION

       $factor = similarity $string1, $string2, [$limit]
	   The "similarity"-function calculates the similarity index of its two arguments.  A value of 0 means that the strings are entirely
	   different. A value of 1 means that the strings are identical. Everything else lies between 0 and 1 and describes the amount of
	   similarity between the strings.

	   It roughly works by looking at the smallest number of edits to change one string into the other.

	   You can add an optional argument $limit (default 0) that gives the minimum similarity the two strings must satisfy. "similarity" stops
	   analyzing the string as soon as the result drops below the given limit, in which case the result will be invalid but lower than the
	   given $limit. You can use this to speed up the common case of searching for the most similar string from a set by specifing the maximum
	   similarity found so far.

SEE ALSO

	The basic algorithm is described in:
	"An O(ND) Difference Algorithm and its Variations", Eugene Myers,
	Algorithmica Vol. 1 No. 2, 1986, pp. 251-266;
	see especially section 4.2, which describes the variation used below.

	The basic algorithm was independently discovered as described in:
	"Algorithms for Approximate String Matching", E. Ukkonen,
	Information and Control Vol. 64, 1985, pp. 100-118.

AUTHOR

	Marc Lehmann <schmorp@schmorp.de>
	http://home.schmorp.de/

	(the underlying fstrcmp function was taken from gnu diffutils and
	modified by Peter Miller <pmiller@agso.gov.au> and Marc Lehmann
	<schmorp@schmorp.de>).

perl v5.16.3							    2008-11-04							     Similarity(3)
Man Page