diff options
Diffstat (limited to 'man3/open_memstream.3')
-rw-r--r-- | man3/open_memstream.3 | 28 |
1 files changed, 15 insertions, 13 deletions
diff --git a/man3/open_memstream.3 b/man3/open_memstream.3 index 63a1ea9be..f5d735f78 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -24,7 +24,7 @@ Standard C library .P .RS -4 Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): +.MR feature_test_macros 7 ): .RE .P .BR open_memstream (), @@ -43,7 +43,7 @@ The function dynamically allocates the buffer, and the buffer automatically grows as needed. Initially, the buffer has a size of zero. After closing the stream, the caller should -.BR free (3) +.MR free 3 this buffer. .P The locations pointed to by @@ -54,9 +54,11 @@ are used to report, respectively, the current location and the size of the buffer. The locations referred to by these pointers are updated each time the stream is flushed -.RB ( fflush (3)) +\%(\c +.MR fflush 3 ) and when the stream is closed -.RB ( fclose (3)). +\%(\c +.MR fclose 3 ). These values remain valid only as long as the caller performs no further output on the stream. If further output is performed, then the stream @@ -72,9 +74,9 @@ The stream maintains the notion of a current position, which is initially zero (the start of the buffer). Each write operation implicitly adjusts the buffer position. The stream's buffer position can be explicitly changed with -.BR fseek (3) +.MR fseek 3 or -.BR fseeko (3). +.MR fseeko 3 . Moving the buffer position past the end of the data already written fills the intervening space with null characters. @@ -97,7 +99,7 @@ Otherwise, NULL is returned and is set to indicate the error. .SH ATTRIBUTES For an explanation of the terms used in this section, see -.BR attributes (7). +.MR attributes 7 . .TS allbox; lbx lb lb @@ -123,19 +125,19 @@ glibc 2.4. There is no file descriptor associated with the file stream returned by these functions (i.e., -.BR fileno (3) +.MR fileno 3 will return an error if called on the returned stream). .SH BUGS Before glibc 2.7, seeking past the end of a stream created by .BR open_memstream () does not enlarge the buffer; instead the -.BR fseek (3) +.MR fseek 3 call fails, returning \-1. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996 .SH EXAMPLES See -.BR fmemopen (3). +.MR fmemopen 3 . .SH SEE ALSO -.BR fmemopen (3), -.BR fopen (3), -.BR setbuf (3) +.MR fmemopen 3 , +.MR fopen 3 , +.MR setbuf 3 |