aboutsummaryrefslogtreecommitdiffstats
path: root/lib/filevercmp.h
diff options
context:
space:
mode:
authorPaul Eggert2016-02-21 13:25:24 -0800
committerPaul Eggert2016-02-21 13:27:40 -0800
commit1f7feecaee0ed3fb79758fe60020aefb30d9ff01 (patch)
treeb0476096aabea32658be041242caa74e7a5232cd /lib/filevercmp.h
parent3e67708d7239cde24b0988d4d1288bc75585cfea (diff)
downloademacs-1f7feecaee0ed3fb79758fe60020aefb30d9ff01.tar.gz
emacs-1f7feecaee0ed3fb79758fe60020aefb30d9ff01.zip
Use Gnulib filevercmp for version comparison
* admin/merge-gnulib (GNULIB_MODULES): Add filevercmp. * doc/lispref/strings.texi (Text Comparison): * etc/NEWS, src/fns.c: * test/src/fns-tests.el (fns-tests-string-version-lessp): Rename newly-introduced function to string-version-lessp, by analogy with strverscmp. * lib/filevercmp.c, lib/filevercmp.h: New files, copied from gnulib. * lib/gnulib.mk, m4/gnulib-comp.m4: Regenerate. * src/fns.c: Include <filevercmp.h>. (gather_number_from_string): Remove. (Fstring_version_lessp): Reimplement via filevercmp.
Diffstat (limited to 'lib/filevercmp.h')
-rw-r--r--lib/filevercmp.h42
1 files changed, 42 insertions, 0 deletions
diff --git a/lib/filevercmp.h b/lib/filevercmp.h
new file mode 100644
index 00000000000..220b71b5790
--- /dev/null
+++ b/lib/filevercmp.h
@@ -0,0 +1,42 @@
1/*
2 Copyright (C) 1995 Ian Jackson <iwj10@cus.cam.ac.uk>
3 Copyright (C) 2001 Anthony Towns <aj@azure.humbug.org.au>
4 Copyright (C) 2008-2016 Free Software Foundation, Inc.
5
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
18
19#ifndef FILEVERCMP_H
20#define FILEVERCMP_H
21
22/* Compare version strings:
23
24 This function compares strings S1 and S2:
25 1) By PREFIX in the same way as strcmp.
26 2) Then by VERSION (most similarly to version compare of Debian's dpkg).
27 Leading zeros in version numbers are ignored.
28 3) If both (PREFIX and VERSION) are equal, strcmp function is used for
29 comparison. So this function can return 0 if (and only if) strings S1
30 and S2 are identical.
31
32 It returns number >0 for S1 > S2, 0 for S1 == S2 and number <0 for S1 < S2.
33
34 This function compares strings, in a way that if VER1 and VER2 are version
35 numbers and PREFIX and SUFFIX (SUFFIX defined as (\.[A-Za-z~][A-Za-z0-9~]*)*)
36 are strings then VER1 < VER2 implies filevercmp (PREFIX VER1 SUFFIX,
37 PREFIX VER2 SUFFIX) < 0.
38
39 This function is intended to be a replacement for strverscmp. */
40int filevercmp (const char *s1, const char *s2) _GL_ATTRIBUTE_PURE;
41
42#endif /* FILEVERCMP_H */