forked from KolibriOS/kolibrios
newlib: update
git-svn-id: svn://kolibrios.org@6099 a494cfbc-eb01-0410-851d-a64ba20cac60
This commit is contained in:
@@ -17,32 +17,55 @@
|
||||
|
||||
/*
|
||||
FUNCTION
|
||||
<<fputc>>---write a character on a stream or file
|
||||
<<fputc>>, <<fputc_unlocked>>---write a character on a stream or file
|
||||
|
||||
INDEX
|
||||
fputc
|
||||
INDEX
|
||||
fputc_unlocked
|
||||
INDEX
|
||||
_fputc_r
|
||||
INDEX
|
||||
_fputc_unlocked_r
|
||||
|
||||
ANSI_SYNOPSIS
|
||||
#include <stdio.h>
|
||||
int fputc(int <[ch]>, FILE *<[fp]>);
|
||||
|
||||
#define _BSD_SOURCE
|
||||
#include <stdio.h>
|
||||
int fputc_unlocked(int <[ch]>, FILE *<[fp]>);
|
||||
|
||||
#include <stdio.h>
|
||||
int _fputc_r(struct _rent *<[ptr]>, int <[ch]>, FILE *<[fp]>);
|
||||
|
||||
#include <stdio.h>
|
||||
int _fputc_unlocked_r(struct _rent *<[ptr]>, int <[ch]>, FILE *<[fp]>);
|
||||
|
||||
TRAD_SYNOPSIS
|
||||
#include <stdio.h>
|
||||
int fputc(<[ch]>, <[fp]>)
|
||||
int <[ch]>;
|
||||
FILE *<[fp]>;
|
||||
|
||||
#define _BSD_SOURCE
|
||||
#include <stdio.h>
|
||||
int fputc_unlocked(<[ch]>, <[fp]>)
|
||||
int <[ch]>;
|
||||
FILE *<[fp]>;
|
||||
|
||||
#include <stdio.h>
|
||||
int _fputc_r(<[ptr]>, <[ch]>, <[fp]>)
|
||||
struct _reent *<[ptr]>;
|
||||
int <[ch]>;
|
||||
FILE *<[fp]>;
|
||||
|
||||
#include <stdio.h>
|
||||
int _fputc_unlocked_r(<[ptr]>, <[ch]>, <[fp]>)
|
||||
struct _reent *<[ptr]>;
|
||||
int <[ch]>;
|
||||
FILE *<[fp]>;
|
||||
|
||||
DESCRIPTION
|
||||
<<fputc>> converts the argument <[ch]> from an <<int>> to an
|
||||
<<unsigned char>>, then writes it to the file or stream identified by
|
||||
@@ -56,8 +79,18 @@ oadvances by one.
|
||||
|
||||
For a macro version of this function, see <<putc>>.
|
||||
|
||||
The <<_fputc_r>> function is simply a reentrant version of <<fputc>>
|
||||
that takes an additional reentrant structure argument: <[ptr]>.
|
||||
<<fputc_unlocked>> is a non-thread-safe version of <<fputc>>.
|
||||
<<fputc_unlocked>> may only safely be used within a scope
|
||||
protected by flockfile() (or ftrylockfile()) and funlockfile(). This
|
||||
function may safely be used in a multi-threaded program if and only
|
||||
if they are called while the invoking thread owns the (FILE *)
|
||||
object, as is the case after a successful call to the flockfile() or
|
||||
ftrylockfile() functions. If threads are disabled, then
|
||||
<<fputc_unlocked>> is equivalent to <<fputc>>.
|
||||
|
||||
The <<_fputc_r>> and <<_fputc_unlocked_r>> functions are simply reentrant
|
||||
versions of the above that take an additional reentrant structure
|
||||
argument: <[ptr]>.
|
||||
|
||||
RETURNS
|
||||
If successful, <<fputc>> returns its argument <[ch]>. If an error
|
||||
@@ -67,6 +100,8 @@ query for errors.
|
||||
PORTABILITY
|
||||
<<fputc>> is required by ANSI C.
|
||||
|
||||
<<fputc_unlocked>> is a BSD extension also provided by GNU libc.
|
||||
|
||||
Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
|
||||
<<lseek>>, <<read>>, <<sbrk>>, <<write>>.
|
||||
*/
|
||||
|
Reference in New Issue
Block a user