diff -r 000000000000 -r e4d67989cc36 genericopenlibs/cstdlib/LSTDIO/PUTCHAR.C --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/genericopenlibs/cstdlib/LSTDIO/PUTCHAR.C Tue Feb 02 02:01:42 2010 +0200 @@ -0,0 +1,111 @@ +/* PUTCHAR.C + * + * Portions Copyright (c) 1990-2006 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + */ + +/* + * 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 +<>---write a character (macro) + +INDEX + putchar +INDEX + _putchar_r + +ANSI_SYNOPSIS + #include + int putchar(int <[ch]>); + + int _putchar_r(void *<[reent]>, int <[ch]>); + +TRAD_SYNOPSIS + #include + int putchar(<[ch]>) + int <[ch]>; + + int _putchar_r(<[reent]>, <[ch]>) + char *<[reent]>; + int <[ch]>; + +DESCRIPTION +<> is a macro, defined in <>. <> +writes its argument to the standard output stream, +after converting it from an <> to an <>. + +The alternate function <<_putchar_r>> is a reentrant version. The +extra argument <[reent]> is a pointer to a reentrancy structure. + +RETURNS +If successful, <> returns its argument <[ch]>. If an error +intervenes, the result is <>. You can use `<>' to +query for errors. + +PORTABILITY +ANSI C requires <>; it suggests, but does not require, that +<> be implemented as a macro. + +Supporting OS subroutines required: <>, <>, <>, +<>, <>, <>, <>. +*/ + +/* + * A subroutine version of the macro putchar + */ + +#include +#include "LOCAL.H" + +#undef putchar + +/** +A reentrant version of putchar(). +*/ +EXPORT_C int +_putchar_r (struct _reent *ptr,int c) +{ + return __sputc ((unsigned char)c, _stdout_r (ptr)); +} + +#ifndef _REENT_ONLY + +#undef putchar +/** +Write character to standard output. +Writes character to the current position in the standard output +and increases the file pointer to point to next character. +This routine cooresponds to: putc(character,stdout). + +@param c Character to be written. + +@return On Success, returns the written character. + On Failure, EOF is returned and errno may be set. +*/ +EXPORT_C int +putchar (int c) +{ + /* CHECK_INIT is (eventually) called by __swbuf. */ + struct _reent *r = _REENT2; + if (!r) + return EOF; // Memory for library globals is not allocated (errno not set). + return(_putchar_r (r, c)); +} + +#endif