company logo

Application :: output - Write message to application output area

The function writes the message passed in sString to the application output area. Line breaks are not created automatically but have to be passed in the message ( '\n' ). In order to write a message on the same line as the last message, the message should start with '\r' .

Messages might be displayed immediately or written to a message buffer. Before displaying the message, the output area can be cleared.

Implementation overview

Implementation details

  1. Display message and clear output
    Application  :: output ( odaba::String &sString, bool bClear )

    The function writes a message to the output area. When passing true in bClear , the output area will be cleared before writing the message. Otherwise, the message will be appended to the existing text in the output area.

    • sString - String value
    • bClear - Clear output area before displaying message

      The option must be set to true in order to clear the output area or console before displaying the message.

  2. to list
  3. Display message
    Application  :: output ( odaba::String &sString )

    The function writes a message to the output area. The message will be appended to the existing text in the output area. In order to write the message on a new line, the message should contain appropriate new line characters ( '\n' ).

    In order to clear output area before displaying the message, output( sString , true ) might be called. In order to write the message into the message buffer without displaying it, one may call output( sString , true , false ) .

    • sString - String value
  4. to list
  5. Write message to message buffer
    Application  :: output ( odaba::String &sString, bool bClear, bool bFlush )

    Usually, messages are displayed immediately in the output area. In order to write the message to the message buffer without displaying it, false has to be passed in bFlush .

    When passing true in bClear , the output area will be cleared before writing the message. Otherwise, the message will be appended to the existing text in the output area.

    • sString - String value
    • bClear - Clear output area before displaying message

      The option must be set to true in order to clear the output area or console before displaying the message.

    • bFlush - Flush data immediately after writing

      In order to write data to output area or console immediately after sending it, the option has to be set to true . When passing false , data is stored to an output area until the next flush request.

  6. to list