soundex.h

eC++编译器源码

#pragma Soundex
/* Compresses strings to a code that measures similarity by sound.
   Developed by Margaret Odell and Robert Russel USPats. 1435663 1261167.
   The first character of "in" must be a letter.
   When coding names with prefixes such as von Ryan or D'Abreau, moving the
   prefixes to the end may give a better result.
   The output is not truncated and can range from 1 character to HIGH(in).
*/

  typedef void *Code;

  void Open(Code &c, unsigned int whichOne);
/* GCW 01/22/90 Open must be called before any other procedure in this module.
   If it is not called first, expect to get a memory fault - coredump.
   The parameter whichOne is not used; calling program may pass anything
   with the correct type. */

  void Close(Code &c);
/* GCW 01/22/90 Calling Close before Open results in a memory fault -
   coredump */

  void Convert(Code &c, char &in[], char &out[]);
/* GCW 01/22/90 Purpose: Given an input string (in), return corresponding
   soundex code (out). Soundex code is of the form: first alphabetic
   character of input string plus a mapping of the remaining characters
   to digits. For example, the soundex code for the string "Smith" is "S53".
   Notes regarding on input string:
           2)  No restriction is put on the length of the input string
               (or the output string).
           3)  Since the soundex code retains the first alphabetic
               character of the input string, it is not a very accurate
               measure of similarity of sound. For example, even though
               strings like "Smith" and "Smythe" have the same soundex
               code, strings like "Kahn" and "Caan" do not.
           4)  Convert is not case-sensitive. That is, input strings
               "SMITH", "smith" and "Smith" all return the same code.
   Convert should not be called before Open. Memory fault - coredump will
   result if it is. */
 
  void ConvertS(Code &c, char &in[], unsigned int start, unsigned int N, char &out[]);
/* GCW 01/22/90 Not implemented to date */