scoped_ostream_redirect Class Reference

#include <iostream.h>

Inheritance diagram for scoped_ostream_redirect:

Public Member Functions
	scoped_ostream_redirect (std::ostream &costream=std::cout, object pyostream=module::import("sys").attr("stdout"))
	~scoped_ostream_redirect ()
	scoped_ostream_redirect (const scoped_ostream_redirect &)=delete
	scoped_ostream_redirect (scoped_ostream_redirect &&other)=default
scoped_ostream_redirect &	operator= (const scoped_ostream_redirect &)=delete
scoped_ostream_redirect &	operator= (scoped_ostream_redirect &&)=delete

Protected Attributes
std::streambuf *	old
std::ostream &	costream
detail::pythonbuf	buffer

Detailed Description

This a move-only guard that redirects output.

.. code-block:: cpp

#include <pybind11/iostream.h>

...

{
    py::scoped_ostream_redirect output;
    std::cout << "Hello, World!"; // Python stdout
} // <-- return std::cout to normal

You can explicitly pass the c++ stream and the python object, for example to guard stderr instead.

.. code-block:: cpp

{
    py::scoped_ostream_redirect output{std::cerr, py::module::import("sys").attr("stderr")};
    std::cerr << "Hello, World!";
}

Definition at line 102 of file iostream.h.

Constructor & Destructor Documentation

scoped_ostream_redirect() [1/3]

scoped_ostream_redirect ( std::ostream &  costream = std::cout, object  pyostream = module::import("sys").attr("stdout")  )

inline

Definition at line 109 of file iostream.h.

~scoped_ostream_redirect()

~scoped_ostream_redirect ( )

inline

Definition at line 116 of file iostream.h.

scoped_ostream_redirect() [2/3]

scoped_ostream_redirect ( const scoped_ostream_redirect &  )

delete

scoped_ostream_redirect() [3/3]

scoped_ostream_redirect ( scoped_ostream_redirect &&  other )

default

Member Function Documentation

operator=() [1/2]

scoped_ostream_redirect& operator= ( const scoped_ostream_redirect &  )

delete

operator=() [2/2]

scoped_ostream_redirect& operator= ( scoped_ostream_redirect &&  )

delete

Member Data Documentation

buffer

detail::pythonbuf buffer

protected

Definition at line 106 of file iostream.h.

costream

std::ostream& costream

protected

Definition at line 105 of file iostream.h.

old

std::streambuf* old

protected

Definition at line 104 of file iostream.h.

---

The documentation for this class was generated from the following file:

• iostream.h