ECROS API Function OsFPutRomS()

char OsFPutRomS( rom char * string, UInt8T stream )

Function OsFPutRomS() should be called by the client application to send a string stored in ROM to a stream.  The function arguments are the address of the string and the stream identifier.  The string should be stored in ROM.  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 in ROM being sent to UART1.

{
   static rom char string[] = "ECROS Technology\n";
   
   OsFPutRomS( string, OS_UART1 );
}

Note that the design of ZiLOG's ZDS II for Z8 Encore! is such that the ROM string cannot be defined by placement in the function's actual argument list.  Whatever project options are selected, this results in the string being placed in RAM.  The compiler disregards the type of the formal argument of the function.

Advanced

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