ECROS API Function OsFPutS()

char OsFPutS( const char far * string, UInt8T stream )

Function OsFPutS() should be called by the client application to send a string to a stream.  The function arguments are the address of the string and the stream identifier.  The string should be stored in RAM and, if the small memory model is used, its address cast to a far pointer.  If the address of the string is 0x0F00 or greater, it is assumed to be in ROM and the function behaves as OsFPutRomS().  If an invalid stream identifier is supplied, the function does nothing.  The return value is the number of characters written to the stream.

The general form of this function is the same as the ANSI standard C library function fputs().

Example

The example below shows a string being sent to UART1.

Advanced

Non-printing characters have the effects on streams described for API function OsFPutC().


Last edited March 10, 2004.  All material Copyright © 2004 Graham Davies, ECROS Technology.