strnlen: document Android bug
[gnulib.git] / lib / c32srtombs-state.c
blob30d7b17bccfde0f0397659e9f03e5e75b2f2af69
1 /* Convert 32-bit wide string to string.
2 Copyright (C) 2008-2024 Free Software Foundation, Inc.
3 Written by Bruno Haible <bruno@clisp.org>, 2020.
5 This file is free software: you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as
7 published by the Free Software Foundation, either version 3 of the
8 License, or (at your option) any later version.
10 This file is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License
16 along with this program. If not, see <https://www.gnu.org/licenses/>. */
18 #include <config.h>
20 #include <wchar.h>
22 /* Internal state used by the functions c32srtombs() and c32snrtombs(). */
23 extern mbstate_t _gl_c32srtombs_state;
24 mbstate_t _gl_c32srtombs_state
25 /* The state must initially be in an "initial state"; so, zero-initialize it.
26 On most systems, putting it into BSS is sufficient. Not so on Mac OS X 10.3,
27 see <https://lists.gnu.org/r/bug-gnulib/2009-01/msg00329.html>.
28 When it needs an initializer, use 0 or {0} as initializer? 0 only works
29 when mbstate_t is a scalar type (such as when gnulib defines it, or on
30 AIX, IRIX, mingw). {0} works as an initializer in all cases: for a struct
31 or union type, but also for a scalar type (ISO C 99, 6.7.8.(11)). */
32 #if defined __ELF__
33 /* On ELF systems, variables in BSS behave well. */
34 #else
35 /* Use braces, to be on the safe side. */
36 = { 0 }
37 #endif