Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/io/clog"

From cppreference.com
< cpp‎ | io
m
m (Shorten template names. Use {{lc}} where appropriate.)
Line 1: Line 1:
 
{{cpp/title|clog|wclog}}
 
{{cpp/title|clog|wclog}}
 
{{cpp/io/basic_ostream/navbar}}
 
{{cpp/io/basic_ostream/navbar}}
{{ddcl list begin}}
+
{{dcl begin}}
{{ddcl list header | iostream }}
+
{{dcl header | iostream }}
{{ddcl list item | num=1 | 1=
+
{{dcl | num=1 | 1=
 
extern std::ostream clog;
 
extern std::ostream clog;
 
}}
 
}}
{{ddcl list item | num=2| 1=
+
{{dcl | num=2| 1=
 
extern std::wostream wclog;
 
extern std::wostream wclog;
 
}}
 
}}
{{ddcl list end}}
+
{{dcl end}}
  
The global objects {{c|std::clog}} and {{c|std::wclog}} control output to a stream buffer of implementation-defined type (derived from {{c|std::streambuf}}), associated with the standard C output stream {{c|stderr}}, but, unlike {{c|std::cerr}}/{{c|std::wcerr}}, these streams are not automatically flushed and not automatically tie()'d with cout.
+
The global objects {{lc|std::clog}} and {{lc|std::wclog}} control output to a stream buffer of implementation-defined type (derived from {{lc|std::streambuf}}), associated with the standard C output stream {{lc|stderr}}, but, unlike {{lc|std::cerr}}/{{lc|std::wcerr}}, these streams are not automatically flushed and not automatically tie()'d with cout.
  
These objects are guaranteed to be constructed before the first constructor of a static object is called and they are guaranteed to outlive the last destructor of a static object, so that it is always possible to write to {{c|std::clog}} in user code.
+
These objects are guaranteed to be constructed before the first constructor of a static object is called and they are guaranteed to outlive the last destructor of a static object, so that it is always possible to write to {{lc|std::clog}} in user code.
  
 
Unless {{c|sync_with_stdio(false)}} has been issued, it is safe to concurrently access these objects from multiple threads for both formatted and unformatted output.
 
Unless {{c|sync_with_stdio(false)}} has been issued, it is safe to concurrently access these objects from multiple threads for both formatted and unformatted output.
Line 45: Line 45:
  
 
===See also===
 
===See also===
{{dcl list begin}}
+
{{dsc begin}}
{{dcl list template | cpp/io/ios_base/dcl list Init}}
+
{{dsc inc | cpp/io/ios_base/dcl list Init}}
{{dcl list template | cpp/io/dcl list cerr}}
+
{{dsc inc | cpp/io/dcl list cerr}}
{{dcl list template | cpp/io/dcl list cout}}
+
{{dsc inc | cpp/io/dcl list cout}}
{{dcl list end}}
+
{{dsc end}}
  
 
[[de:cpp/io/clog]]
 
[[de:cpp/io/clog]]

Revision as of 18:55, 31 May 2013

 
 
 
 
Defined in header <iostream>
extern std::ostream clog;
(1)
extern std::wostream wclog;
(2)

The global objects std::clog and std::wclog control output to a stream buffer of implementation-defined type (derived from std::streambuf), associated with the standard C output stream stderr, but, unlike std::cerr/std::wcerr, these streams are not automatically flushed and not automatically tie()'d with cout.

These objects are guaranteed to be constructed before the first constructor of a static object is called and they are guaranteed to outlive the last destructor of a static object, so that it is always possible to write to std::clog in user code.

Unless sync_with_stdio(false) has been issued, it is safe to concurrently access these objects from multiple threads for both formatted and unformatted output.

Example

#include <iostream>
 
struct Foo {
    int n;
    Foo() {
       std::clog << "static constructor\n";
    }
    ~Foo() {
       std::clog << "static destructor\n";
    }
};
 
Foo f; // static object
 
int main()
{
    std::clog << "main function\n";
}

Output:

static constructor
main function
static destructor

See also

Template:cpp/io/ios base/dcl list InitTemplate:cpp/io/dcl list cerrTemplate:cpp/io/dcl list cout