<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Warnings and Gotchas of using ClanLib - ClanLib Game SDK</title> <link rel="stylesheet" type="text/css" href="../../default.css"> </head> <body style="background-color: #a4daea; color: black; margin: 1em 3em 1em 3em;"> <div style="border-style: solid; border-width:thin; border-color: black;"> <div style="background-color: white; color: black; padding: .3em 1em .3em 1em; border-bottom-style: dotted; border-bottom-width: 2px;"> <table cellspacing="0" cellpadding="0" border="0" width="100%"> <tr> <td align="center"> <h1> <a href="http://www.clanlib.org"><img style="border-style: none; padding-right: 130px;" src="../../gfx/clanlib.png" alt="ClanLib"></a> </h1> </td> </tr> </table> <!--<div class="menu"> <a href="index.html">News</a> <a href="intro.html">About</a> <a href="download.html">Download</a> <a href="cvs.html">CVS</a> <a class="active" href="docs.html">Docs</a> <a href="games.html">Games</a> <a href="contact.html">Contact</a> <a href="links.html">Links</a> </div>--> </div> <div style="background-color: white; padding: 1em 3em 1em 3em;"> <!-- clanlib header end --> <div style="border-bottom-style: dotted; border-bottom-width: 1px; margin-bottom: 1em;"><h2>Warnings and Gotchas of using ClanLib</h2></div> <h1>OUTDATED</h1> <div style="border-bottom-style: dotted; border-bottom-width: 1px;"><h2>Abstract:</h2></div> <p>This document covers all issues about ClanLib safely and correctly</p> <div style="border-bottom-style: dotted; border-bottom-width: 1px;"><h3>Creating destroying objects</h3></div> <p>All objects must both created AND destroyed inside their respective ::init() and ::deinit() groups. This means that letting an object fall out of scope might not work, especially in CL_Application::main().<p> <ul><pre><font face="Arial,Courier New,Courier">... Do_Bar() { CL_SetupSound::init(); CL_SoundBuffer *soundbuffer = CL_Sample::create("beep.wav",NULL); CL_SoundBuffer_Session ses = soundbuffer->play(); ... delete soundbuffer; // Good CL_SetupSound::deinit(); //All user objects must be destroyed before now } //ses destroyed here, very bad </font></pre></ul> <p> In this code ses is destroyed when it goes out of scope, which is after it should be destroyed. A better solution to this problem would be either wrap Do_Bar in some other function. eg<p> <ul><pre><font face="Arial,Courier New,Courier"> init_sound() { CL_SetupSound::init(); Do_Bar(); CL_SetupSound::deinit(); } Do_Bar() { CL_SoundBuffer *soundbuffer = CL_Sample::create("beep.wav",NULL); CL_SoundBuffer_Session ses = soundbuffer->play(); //Ok here ... delete soundbuffer; // Good } </font></pre></ul> <p> The code above is perfectly safe as ses is destroy when Do_Bar goes out of scope which is before deinit(). Another way is to use pointers.</p> <!-- clanlib footer begin --> <div style="margin-top: 0em; text-align: center; color: #a0a0a0; border-top-style: dotted; border-top-width: 1px;"> Questions or comments, write to the <a href="http://clanlib.org/contact.html">ClanLib mailing list</a>. </div> </div> </div> </body> </html>