diff options
Diffstat (limited to 'content/xdocs/ScopedLocking.html')
-rwxr-xr-x | content/xdocs/ScopedLocking.html | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/content/xdocs/ScopedLocking.html b/content/xdocs/ScopedLocking.html new file mode 100755 index 0000000000..95796e6f94 --- /dev/null +++ b/content/xdocs/ScopedLocking.html @@ -0,0 +1,52 @@ +<html> + <head> + <title>Apache Qpid : ScopedLocking</title> + <link rel="stylesheet" href="styles/site.css" type="text/css" /> + <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> + </head> + + <body> + <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> + <tr> + <td valign="top" class="pagebody"> + <div class="pageheader"> + <span class="pagetitle"> + Apache Qpid : ScopedLocking + </span> + </div> + <div class="pagesubheading"> + This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. + </div> + + <p>Always use scoped lockers to lock mutexes and the like. Don't do this:</p> +<div class="preformatted"><div class="preformattedContent"> +<pre> lock.acquire();
+ do_stuff(); // DANGER: lock never released if exception thrown here.
+ lock.release();
+</pre> +</div></div> + +<p>Instead use a "scoped locker". This is simply a class that does the "acquire" in its constructor and the "release" in its destructor:</p> +<div class="preformatted"><div class="preformattedContent"> +<pre> Locker locker(lock);
+ do_stuff();
+</pre> +</div></div> + +<p>Not only does this save a bit of typing, it guarantees that the lock will be released even if an exception is thrown, because C++ guarantees to call destructors of all local variables on exit from a scope. This also protects you forgetting to release the lock at every exit point from a function with multiple exit points - the compiler takes care of it for you. This technique applies more generally to any situation where you have to acquire and release resources. <tt>std::auto_ptr</tt> is a similar tool for memory management.</p> + + + + </td> + </tr> + </table> + <table border="0" cellpadding="0" cellspacing="0" width="100%"> + <tr> + <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> + </tr> + <tr> + <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> + </tr> + </table> + </body> +</html>
\ No newline at end of file |