You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

131 lines
8.5KB

  1. <HTML>
  2. <HEAD>
  3. <TITLE>The RtAudio Home Page</TITLE>
  4. <LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css">
  5. <LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico">
  6. </HEAD>
  7. <BODY BGCOLOR="#FFFFFF">
  8. <CENTER>
  9. <a class="qindex" href="index.html">Home</a> &nbsp; <a class="qindex" href="annotated.html">Class/Enum List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; </CENTER>
  10. <HR>
  11. <!-- Generated by Doxygen 1.4.4 -->
  12. <h1>RtError Class Reference</h1><!-- doxytag: class="RtError" -->Exception handling class for <a class="el" href="classRtAudio.html">RtAudio</a> &amp; RtMidi.
  13. <a href="#_details">More...</a>
  14. <p>
  15. <code>#include &lt;<a class="el" href="RtError_8h-source.html">RtError.h</a>&gt;</code>
  16. <p>
  17. <a href="classRtError-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
  18. <tr><td></td></tr>
  19. <tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
  20. <tr><td class="memItemLeft" nowrap align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#w11">Type</a> { <br>
  21. &nbsp;&nbsp;<a class="el" href="classRtError.html#w11w0">WARNING</a>,
  22. <a class="el" href="classRtError.html#w11w1">DEBUG_WARNING</a>,
  23. <a class="el" href="classRtError.html#w11w2">UNSPECIFIED</a>,
  24. <a class="el" href="classRtError.html#w11w3">NO_DEVICES_FOUND</a>,
  25. <br>
  26. &nbsp;&nbsp;<a class="el" href="classRtError.html#w11w4">INVALID_DEVICE</a>,
  27. <a class="el" href="classRtError.html#w11w5">MEMORY_ERROR</a>,
  28. <a class="el" href="classRtError.html#w11w6">INVALID_PARAMETER</a>,
  29. <a class="el" href="classRtError.html#w11w7">INVALID_USE</a>,
  30. <br>
  31. &nbsp;&nbsp;<a class="el" href="classRtError.html#w11w8">DRIVER_ERROR</a>,
  32. <a class="el" href="classRtError.html#w11w9">SYSTEM_ERROR</a>,
  33. <a class="el" href="classRtError.html#w11w10">THREAD_ERROR</a>
  34. <br>
  35. }</td></tr>
  36. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Defined RtError types. <a href="classRtError.html#w11">More...</a><br></td></tr>
  37. <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
  38. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a0"></a><!-- doxytag: member="RtError::RtError" ref="a0" args="(const std::string &amp;message, Type type=RtError::UNSPECIFIED)" -->
  39. &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a0">RtError</a> (const std::string &amp;message, <a class="el" href="classRtError.html#w11">Type</a> type=RtError::UNSPECIFIED) throw ()</td></tr>
  40. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The constructor. <br></td></tr>
  41. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a1"></a><!-- doxytag: member="RtError::~RtError" ref="a1" args="(void)" -->
  42. virtual&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a1">~RtError</a> (void) throw ()</td></tr>
  43. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The destructor. <br></td></tr>
  44. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a2"></a><!-- doxytag: member="RtError::printMessage" ref="a2" args="(void)" -->
  45. virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a2">printMessage</a> (void) throw ()</td></tr>
  46. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Prints thrown error message to stderr. <br></td></tr>
  47. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a3"></a><!-- doxytag: member="RtError::getType" ref="a3" args="(void)" -->
  48. virtual const <a class="el" href="classRtError.html#w11">Type</a> &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a3">getType</a> (void) throw ()</td></tr>
  49. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the thrown error message type. <br></td></tr>
  50. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a4"></a><!-- doxytag: member="RtError::getMessage" ref="a4" args="(void)" -->
  51. virtual const std::string &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a4">getMessage</a> (void) throw ()</td></tr>
  52. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the thrown error message string. <br></td></tr>
  53. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a5"></a><!-- doxytag: member="RtError::what" ref="a5" args="(void) const " -->
  54. virtual const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a5">what</a> (void) const throw ()</td></tr>
  55. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the thrown error message as a c-style string. <br></td></tr>
  56. </table>
  57. <hr><a name="_details"></a><h2>Detailed Description</h2>
  58. Exception handling class for <a class="el" href="classRtAudio.html">RtAudio</a> &amp; RtMidi.
  59. <p>
  60. The RtError class is quite simple but it does allow errors to be "caught" by <a class="el" href="classRtError.html#w11">RtError::Type</a>. See the <a class="el" href="classRtAudio.html">RtAudio</a> and RtMidi documentation to know which methods can throw an RtError.
  61. <p>
  62. <hr><h2>Member Enumeration Documentation</h2>
  63. <a class="anchor" name="w11"></a><!-- doxytag: member="RtError::Type" ref="w11" args="" --><p>
  64. <table class="mdTable" cellpadding="2" cellspacing="0">
  65. <tr>
  66. <td class="mdRow">
  67. <table cellpadding="0" cellspacing="0" border="0">
  68. <tr>
  69. <td class="md" nowrap valign="top">enum <a class="el" href="classRtError.html#w11">RtError::Type</a> </td>
  70. </tr>
  71. </table>
  72. </td>
  73. </tr>
  74. </table>
  75. <table cellspacing="5" cellpadding="0" border="0">
  76. <tr>
  77. <td>
  78. &nbsp;
  79. </td>
  80. <td>
  81. <p>
  82. Defined RtError types.
  83. <p>
  84. <dl compact><dt><b>Enumerator: </b></dt><dd>
  85. <table border="0" cellspacing="2" cellpadding="0">
  86. <tr><td valign="top"><em><a class="anchor" name="w11w0"></a><!-- doxytag: member="WARNING" ref="w11w0" args="" -->WARNING</em>&nbsp;</td><td>
  87. A non-critical error. </td></tr>
  88. <tr><td valign="top"><em><a class="anchor" name="w11w1"></a><!-- doxytag: member="DEBUG_WARNING" ref="w11w1" args="" -->DEBUG_WARNING</em>&nbsp;</td><td>
  89. A non-critical error which might be useful for debugging. </td></tr>
  90. <tr><td valign="top"><em><a class="anchor" name="w11w2"></a><!-- doxytag: member="UNSPECIFIED" ref="w11w2" args="" -->UNSPECIFIED</em>&nbsp;</td><td>
  91. The default, unspecified error type. </td></tr>
  92. <tr><td valign="top"><em><a class="anchor" name="w11w3"></a><!-- doxytag: member="NO_DEVICES_FOUND" ref="w11w3" args="" -->NO_DEVICES_FOUND</em>&nbsp;</td><td>
  93. No devices found on system. </td></tr>
  94. <tr><td valign="top"><em><a class="anchor" name="w11w4"></a><!-- doxytag: member="INVALID_DEVICE" ref="w11w4" args="" -->INVALID_DEVICE</em>&nbsp;</td><td>
  95. An invalid device ID was specified. </td></tr>
  96. <tr><td valign="top"><em><a class="anchor" name="w11w5"></a><!-- doxytag: member="MEMORY_ERROR" ref="w11w5" args="" -->MEMORY_ERROR</em>&nbsp;</td><td>
  97. An error occured during memory allocation. </td></tr>
  98. <tr><td valign="top"><em><a class="anchor" name="w11w6"></a><!-- doxytag: member="INVALID_PARAMETER" ref="w11w6" args="" -->INVALID_PARAMETER</em>&nbsp;</td><td>
  99. An invalid parameter was specified to a function. </td></tr>
  100. <tr><td valign="top"><em><a class="anchor" name="w11w7"></a><!-- doxytag: member="INVALID_USE" ref="w11w7" args="" -->INVALID_USE</em>&nbsp;</td><td>
  101. The function was called incorrectly. </td></tr>
  102. <tr><td valign="top"><em><a class="anchor" name="w11w8"></a><!-- doxytag: member="DRIVER_ERROR" ref="w11w8" args="" -->DRIVER_ERROR</em>&nbsp;</td><td>
  103. A system driver error occured. </td></tr>
  104. <tr><td valign="top"><em><a class="anchor" name="w11w9"></a><!-- doxytag: member="SYSTEM_ERROR" ref="w11w9" args="" -->SYSTEM_ERROR</em>&nbsp;</td><td>
  105. A system error occured. </td></tr>
  106. <tr><td valign="top"><em><a class="anchor" name="w11w10"></a><!-- doxytag: member="THREAD_ERROR" ref="w11w10" args="" -->THREAD_ERROR</em>&nbsp;</td><td>
  107. A thread error occured. </td></tr>
  108. </table>
  109. </dl>
  110. </td>
  111. </tr>
  112. </table>
  113. <hr>The documentation for this class was generated from the following file:<ul>
  114. <li><a class="el" href="RtError_8h-source.html">RtError.h</a></ul>
  115. <HR>
  116. <table><tr><td><img src="../images/mcgill.gif" width=165></td>
  117. <td>&copy;2001-2008 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr>
  118. </table>
  119. </BODY>
  120. </HTML>