annotate lib/fstrcmp.h @ 40186:8964917f9574

autoupdate
author Karl Berry <karl@freefriends.org>
date Mon, 18 Feb 2019 08:02:49 -0800
parents b06060465f09
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Fuzzy string comparison.
40057
b06060465f09 maint: Run 'make update-copyright'
Paul Eggert <eggert@cs.ucla.edu>
parents: 19484
diff changeset
2 Copyright (C) 1995, 2000, 2002-2003, 2006, 2008-2019 Free Software
10437
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
3 Foundation, Inc.
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 This file was written by Peter Miller <pmiller@agso.gov.au>
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9151
diff changeset
7 This program is free software: you can redistribute it and/or modify
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9151
diff changeset
9 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9151
diff changeset
10 (at your option) any later version.
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 This program is distributed in the hope that it will be useful,
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15 GNU General Public License for more details.
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
19190
9759915b2aca all: prefer https: URLs
Paul Eggert <eggert@cs.ucla.edu>
parents: 18626
diff changeset
18 along with this program. If not, see <https://www.gnu.org/licenses/>. */
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 #ifndef _FSTRCMP_H
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 #define _FSTRCMP_H
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 #ifdef __cplusplus
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 extern "C" {
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 #endif
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 /* Fuzzy compare of S1 and S2. Return a measure for the similarity of S1
10437
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
28 and S1. The higher the result, the more similar the strings are.
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
29 The result is bounded between 0 (meaning very dissimilar strings) and
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
30 1 (meaning identical strings). */
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 extern double fstrcmp (const char *s1, const char *s2);
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32
10437
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
33 /* Like fstrcmp (S1, S2), except that if the result is < LOWER_BOUND, an
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
34 arbitrary other value < LOWER_BOUND can be returned. */
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
35 extern double fstrcmp_bounded (const char *s1, const char *s2,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 10437
diff changeset
36 double lower_bound);
10437
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
37
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
38 /* A shortcut for fstrcmp. Avoids a function call. */
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
39 #define fstrcmp(s1,s2) fstrcmp_bounded (s1, s2, 0.0)
aaa73f947c24 New function fstrcmp_bounded.
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
parents: 9309
diff changeset
40
9151
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 #ifdef __cplusplus
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42 }
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43 #endif
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44
8c5ddfde42d6 Fuzzy string comparison.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 #endif