diff options
author | Thomas Fitzsimmons <fitzsim@redhat.com> | 2002-05-08 19:11:22 +0000 |
---|---|---|
committer | Thomas Fitzsimmons <fitzsim@redhat.com> | 2002-05-08 19:11:22 +0000 |
commit | 76490806069d5f64a9060aff78484ec5f6b82061 (patch) | |
tree | 4d6b79b2c6d7a53afdd52a6f9986146c4bb6161a /newlib/libc/stdio/getc_u.c | |
parent | 96bff22c5dd2df267b04aad3719950420eac0b43 (diff) | |
download | cygnal-76490806069d5f64a9060aff78484ec5f6b82061.tar.gz cygnal-76490806069d5f64a9060aff78484ec5f6b82061.tar.bz2 cygnal-76490806069d5f64a9060aff78484ec5f6b82061.zip |
* libc/stdio/getc_u.c: New file.
* libc/stdio/getchar_u.c: New file.
* libc/stdio/putc_u.c: New file.
* libc/stdio/putchar_u.c: New file.
* libc/include/stdio.h: Add declarations for getc_unlocked,
getchar_unlocked, putc_unlocked and putchar_unlocked.
* libc/stdio/Makefile.am (LIB_SOURCES): Add new files.
(CHEWOUT_FILES): Add new files' .def's.
* libc/stdio/putchar.c (_putchar_r): Replace __sputc with putc.
Diffstat (limited to 'newlib/libc/stdio/getc_u.c')
-rw-r--r-- | newlib/libc/stdio/getc_u.c | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/newlib/libc/stdio/getc_u.c b/newlib/libc/stdio/getc_u.c new file mode 100644 index 000000000..877c7f8a0 --- /dev/null +++ b/newlib/libc/stdio/getc_u.c @@ -0,0 +1,68 @@ +/* + * Copyright (c) 1990 The Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by the University of California, Berkeley. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. + */ + +/* +FUNCTION +<<getc_unlocked>>---non-thread-safe version of getc (macro) + +INDEX + getc_unlocked + +POSIX_SYNOPSIS + #include <stdio.h> + int getc_unlocked(FILE *<[fp]>); + +DESCRIPTION +<<getc_unlocked>> is a non-thread-safe version of <<getc>> declared in +<<stdio.h>>. <<getc_unlocked>> may only safely be used within a scope +protected by flockfile() (or ftrylockfile()) and funlockfile(). These +functions 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 +<<getc_unlocked>> is equivalent to <<getc>>. + +RETURNS +See <<getc>>. + +PORTABILITY +POSIX 1003.1 requires <<getc_unlocked>>. <<getc_unlocked>> may be +implemented as a macro, so arguments should not have side-effects. + +Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>, +<<lseek>>, <<read>>, <<sbrk>>, <<write>>. */ + +#if defined(LIBC_SCCS) && !defined(lint) +static char sccsid[] = "%W% (Berkeley) %G%"; +#endif /* LIBC_SCCS and not lint */ + +#include <stdio.h> + +/* + * A subroutine version of the macro getc_unlocked. + */ + +#undef getc_unlocked + +int +getc_unlocked (fp) + register FILE *fp; +{ + /* CHECK_INIT is called (eventually) by __srefill. */ + + return __sgetc (fp); +} |