.. include:: headings.inc



.. _LogNull:

==========================================================================================================================================
|phoenix_title|  **LogNull**
==========================================================================================================================================

This class allows you to temporarily suspend logging.          

All calls to the log functions during the life time of an object of this class are just ignored. 

In particular, it can be used to suppress the log messages given by wxWidgets itself but it should be noted that it is rarely the best way to cope with this problem as **all**  log messages are suppressed, even if they indicate a completely different error than the one the programmer wanted to suppress. 

For instance, the example of the overview: 

::

          # There will normally be a log message if a non-existant file is
          # loaded into a wx.Bitmap.  It can be suppressed with wx.LogNull
          noLog = wx.LogNull()
          bmp = wx.Bitmap('bogus.png')
          # when noLog is destroyed the old log sink is restored
          del noLog



would be better written as: 

::

          # Don't try to load the image if it doesn't exist. This avoids the
          # log messages without blocking all the others.
          if os.path.exists('bogus.png'):
              bmp = wx.Bitmap('bogus.png')
          else:
              ...











|

|class_hierarchy| Inheritance Diagram
=====================================

Inheritance diagram for class **LogNull**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/LogNull_inheritance.png" alt="Inheritance diagram of LogNull" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="LogNull.html" title="This class allows you to temporarily suspend logging." alt="" coords="5,5,80,35"/> </map> 
   </p>

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~LogNull.__init__`                                                        Suspends logging.
================================================================================ ================================================================================


|


|api| Class API
===============
   

.. class:: LogNull(object)

   This class allows you to temporarily suspend logging.
   
   **Possible constructors**::

       LogNull()
       



   .. method:: __init__(self)

      Suspends logging.