annotate lib/astrxfrm.h @ 17363:5a51fb7777a9

sys_select, sys_time: port 2013-01-30 Solaris 2.6 fix to Cygwin Problem reported by Marco Atzeri in <http://lists.gnu.org/archive/html/bug-gnulib/2013-03/msg00000.html>. * lib/sys_select.in.h [HAVE_SYS_SELECT_H && _CYGWIN_SYS_TIME_H]: Simply delegate to the system <sys/select.h> in this case too. Also, pay attention to _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TIME_H only if OSF/1, since otherwise Cygwin breaks, and it doesn't seem to be needed on Solaris either. * lib/sys_time.in.h [_CYGWIN_SYS_TIME_H]: Simply delgate to the system <sys/time.h> in this case.
author Paul Eggert <eggert@cs.ucla.edu>
date Tue, 19 Mar 2013 09:08:47 -0700
parents e542fd46ad6f
children 344018b6e5d7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
13555
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Locale dependent string transformation for comparison.
17249
e542fd46ad6f maint: update all copyright year number ranges
Eric Blake <eblake@redhat.com>
parents: 16201
diff changeset
2 Copyright (C) 2010-2013 Free Software Foundation, Inc.
13555
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4 This program is free software: you can redistribute it and/or modify it
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 under the terms of the GNU Lesser General Public License as published
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6 by the Free Software Foundation; either version 3 of the License, or
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
7 (at your option) any later version.
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 Lesser General Public License for more details.
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 You should have received a copy of the GNU Lesser General Public License
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 #ifndef ASTRXFRM_H
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 #define ASTRXFRM_H
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 #include <stddef.h>
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 #ifdef __cplusplus
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 extern "C" {
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 #endif
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 /* Variant of strxfrm() with a calling convention that reduces the number
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 of strxfrm calls. */
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 /* Transform the string starting at S to a string, in such a way that
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 comparing S1 and S2 with strcoll() is equivalent to comparing astrxfrm(S1)
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 and astrxfrm(S2) with strcmp().
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 The result of this function depends on the LC_COLLATE category of the
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 current locale.
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 If successful: If resultbuf is not NULL and the result fits into *lengthp
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 bytes, it is put in resultbuf, and resultbuf is returned. Otherwise, a
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 freshly allocated string is returned. In both cases, *lengthp is set to the
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 length of the returned string.
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 Upon failure, return NULL, with errno set. */
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 extern char * astrxfrm (const char *s, char *resultbuf, size_t *lengthp);
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43 #ifdef __cplusplus
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44 }
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 #endif
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
46
8ad4ee9c2fd3 New module 'astrxfrm'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
47 #endif /* ASTRXFRM_H */