wxWidgets: wxRecursionGuard Class Reference

| Version: 3.1.5

Loading...
Searching...
No Matches
Public Member Functions | List of all members
wxRecursionGuard Class Reference
Class List by Category » Miscellaneous

`#include </cygdrive/c/Users/Hamis/Cygwin-packaging/wxWidgets3.1/wxWidgets3.1-3.1.5-4.x86_64/src/wxWidgets-3.1.5/interface/wx/recguard.h>`

## Detailed Description

wxRecursionGuard is a very simple class which can be used to prevent reentrancy problems in a function.

It is not thread-safe and so should be used only in single-threaded programs or in combination with some thread synchronization mechanisms.

wxRecursionGuard is always used together with the wxRecursionGuardFlag like in this example:

void Foo()
{
static wxRecursionGuardFlag s_flag;
wxRecursionGuard guard(s_flag);
if ( guard.IsInside() )
{
// don't allow reentrancy
return;
}
...
}
wxRecursionGuardFlag
This is a completely opaque class which exists only to be used with wxRecursionGuard,...
Definition recguard.h:23
wxRecursionGuard::wxRecursionGuard
wxRecursionGuard(wxRecursionGuardFlag &flag)
A wxRecursionGuard object must always be initialized with a static wxRecursionGuardFlag.

As you can see, wxRecursionGuard simply tests the flag value and sets it to true if it hadn't been already set. IsInside() allows testing the old flag value. The advantage of using this class compared to directly manipulating the flag is that the flag is always reset in the wxRecursionGuard destructor and so you don't risk to forget to do it even if the function returns in an unexpected way (for example because an exception has been thrown).

##

Library: wxBase

<>< =''>:</>&;&;< =''>\ </></>

## Public Member Functions
| wxRecursionGuard (wxRecursionGuardFlag &flag)
| A wxRecursionGuard object must always be initialized with a `static` wxRecursionGuardFlag.
| ~wxRecursionGuard ()
| The destructor resets the flag value so that the function can be entered again the next time.
bool | IsInside () const
| Returns true if we're already inside the code block "protected" by this wxRecursionGuard (i.e.

## Constructor & Destructor Documentation

## ◆ wxRecursionGuard()

wxRecursionGuard::wxRecursionGuard | ( | wxRecursionGuardFlag & | flag | ) |

A wxRecursionGuard object must always be initialized with a `static` wxRecursionGuardFlag.

The constructor saves the value of the flag to be able to return the correct value from IsInside().

## ◆ ~wxRecursionGuard()

wxRecursionGuard::~wxRecursionGuard | ( |  | ) |

The destructor resets the flag value so that the function can be entered again the next time.

Note
  This is not virtual, so this class is not meant to be derived from (besides, there is absolutely no reason to do it anyhow).

## Member Function Documentation

## ◆ IsInside()

bool wxRecursionGuard::IsInside | ( |  | ) | const

Returns true if we're already inside the code block "protected" by this wxRecursionGuard (i.e.

between this line and the end of current scope). Usually the function using wxRecursionGuard takes some specific actions in such case (may be simply returning) to prevent reentrant calls to itself.

If this method returns false, it is safe to continue.