Incorporate existing strcasestr doc into new doc structure.
[gnulib.git] / doc / functions / ftell.texi
1 @node ftell
2 @section @code{ftell}
3 @findex ftell
4
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/ftell.html}
6
7 Gnulib module: ftell
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function mistakenly succeeds on pipes on some platforms: mingw.
13 @end itemize
14
15 Portability problems not fixed by Gnulib:
16 @itemize
17 @item
18 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
19 on input streams that are opened in @code{O_TEXT} mode and whose contents
20 contains Unix line terminators (LF), on some platforms: mingw.
21 @item
22 On platforms where @code{long} is a 32-bit type, @code{ftell} does not work
23 correctly with files larger than 2 GB.  The fix is to use @code{ftello}
24 instead and to invoke the @code{AC_SYS_LARGEFILE} macro.
25 @end itemize