1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"[]> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../css/manpage.css" type="text/css" /> 7 <style type="text/css"><!-- 8 span.static_style 9 { 10 font-size : 8pt; 11 color : white; 12 font-weight : bold; 13 background : #44f; 14 border-left : solid 1px #aaf; 15 border-top : solid 1px #aaf; 16 border-right : solid 1px #00c; 17 border-bottom : solid 1px #00c; 18 padding-left : 2px; 19 padding-right : 2px; 20 } 21 22 span.virtual_style 23 { 24 font-size : 8pt; 25 color : white; 26 font-weight : bold; 27 background : #0a0; 28 border-left : solid 1px #0f0; 29 border-top : solid 1px #0f0; 30 border-right : solid 1px #060; 31 border-bottom : solid 1px #060; 32 padding-left : 2px; 33 padding-right : 2px; 34 } 35 36 span.protected_style 37 { 38 font-size : 8pt; 39 color : white; 40 font-weight : bold; 41 background : #444; 42 border-left : solid 1px #ccc; 43 border-top : solid 1px #ccc; 44 border-right : solid 1px #222; 45 border-bottom : solid 1px #222; 46 padding-left : 2px; 47 padding-right : 2px; 48 } 49 --></style> 50<title>C-Language Wrappers</title> 51 </head> 52 <body> 53<h1>C-Language Wrappers</h1> 54<h2>Description</h2> 55 <div class="section"> 56<p>The CTR-SDK APIs are mostly written in C++. C++ APIs cannot be called directly from C-language files.</p><p>The CTR-SDK therefore provides wrappers that allow you to call the C++ APIs from C source files.</p> 57 </div> 58<h3>Mutex Example</h3> 59<div class="section"><p>In C++, you would use the <a href="../nn/os/Mutex/Overview.html"><CODE>nn::os::Mutex</CODE></a> class to use mutexes. The mutex class maintains mutex objects internally.</p><p>The names of the wrappers that allow this class to be used in C begin with <CODE>nnosMutex</CODE>, as shown in the examples below. These functions have a 1:1 correspondence with the C++ methods.</p><p><itemizedlist><listitem><para><a href="../nn_os_Mutex_c/nnosMutexInitialize.html">nnosMutexInitialize</a> → <a href="../nn/os/Mutex/Initialize.html">nn::os::Mutex::Initialize</a><br /></para></listitem><listitem><para><a href="../nn_os_Mutex_c/nnosMutexLock.html">nnosMutexLock</a> → <a href="../nn/os/Mutex/Lock.html">nn::os::Mutex::Lock</a><br /></para></listitem><listitem><para><a href="../nn_os_Mutex_c/nnosMutexTryLock.html">nnosMutexTryLock</a> → <a href="../nn/os/Mutex/TryLock.html">nn::os::Mutex::TryLock</a><br /></para></listitem><listitem><para><a href="../nn_os_Mutex_c/nnosMutexUnlock.html">nnosMutexUnlock</a> → <a href="../nn/os/Mutex/Unlock.html">nn::os::Mutex::Unlock</a><br /></para></listitem><listitem><para><a href="../nn_os_Mutex_c/nnosMutexInitialize.html">nnosMutexInitialize</a> → <a href="../nn/os/Mutex/Initialize.html">nn::os::Mutex::Initialize</a><br /></para></listitem></itemizedlist> To learn details about the C wrapper functions, see the explanations for the corresponding class methods.</p><p>The <a href="../nnosMutex/Overview.html"><CODE>nnosMutex</CODE></a> structure, the data type that stores mutex objects in C, is an exception. This structure is actually a class instance under the hood, so it cannot be referenced directly from the C language.</p></div> 60<h3>List</h3> 61<div class="section"><p>See the "Modules" page for a list of modules that can be used in C and C++ code respectively.</p><!-- write here --></div> 62<h2>Revision History</h2> 63 <div class="section"> 64 <dl class="history"> 65 <dt>2010/01/07</dt> 66<dd>Initial version.<br /> 67 </dd> 68 </dl> 69 </div> 70 <hr><p>CONFIDENTIAL</p></body> 71</html>