INFO: Endl Flushes the cout Buffer Immediately Upon Execution

Last reviewed: September 4, 1997
Article ID: Q83081

The information in this article applies to:
  • Microsoft C/C++ for MS-DOS, version 7.0
  • Microsoft Visual C++ for Windows, versions 1.0, 1.5, 1.51, 1.52
  • Microsoft Visual C++ 32-bit Edition, versions 1.0, 2.0, 2.1, 4.0, 5.0

SUMMARY

In these products, the cout class uses a buffering system for data that may not be flushed immediately. Because cout usually handles small messages, several messages are usually needed to fill the buffer, which will cause the data to be written to the standard output handle. In some cases, this can cause considerable delay when writing output to the screen during a debugging session. This problem can be avoided, however, by using the endl manipulator. When appended to the end of a cout call, the endl manipulator inserts a newline character and then flushes the buffer.

MORE INFORMATION

Sample Code

   /* Compile options needed: none
   */

   #include <iostream.h>

   void main(void)
   {
     cout << "This string will be buffered";
     cout << "This string will be flushed immediately" <<endl;
   }

For more information on the other methods to flush the cout buffer, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q94227
   TITLE     : INFO: Output Stream cout Is Buffered


Additional query words: 8.00 8.00c 9.00 9.10 CodeView CVW
Keywords : CPPLngIss
Version : MS-DOS:7.0; WINDOWS:1.0,1.5,1.51,1.52; WINDOWS NT:1.0,2.0,2.1,4.0,5.0
Platform : MS-DOS NT WINDOWS
Issue type : kbinfo


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: September 4, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.