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<title>TryStart</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/os/Overview.html">os</a>::<a href="../../../nn/os/Thread/Overview.html">Thread</a>::TryStart</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/os.h&gt;
14
15template &lt;typename T, typename U, typename Stack&gt;
16<a href="../../../nn/Result/Overview.html">nn::Result</a> TryStart(
17     void(*)(T) f,
18     U param,
19     Stack & stack,
20     <a href="../../../nn_types/s32.html">s32</a> priority = DEFAULT_THREAD_PRIORITY,
21     <a href="../../../nn_types/s32.html">s32</a> coreNo = CORE_NO_USE_PROCESS_VALUE
22);
23</pre>
24    </div>
25<h2>Template Arguments</h2>
26    <div class="section">
27      <table class="arguments">
28        <thead>
29          <tr>
30<th>Name</th>
31<td>Description</td>
32          </tr>
33        </thead>
34        <tr>
35<th>T</th>
36<td>Data type of argument(s) of the function to run (this type must be copyable).</td>
37        </tr>
38        <tr>
39<th>U</th>
40<td>A type that can be converted to <SPAN class="argument">T</SPAN>.</td>
41        </tr>
42        <tr>
43<th>Stack</th>
44<td>Type representing stacks.</td>
45        </tr> </table>
46    </div>
47<h2>Parameters</h2>
48    <div class="section">
49      <table class="arguments">
50        <thead>
51          <tr>
52            <td width="15" />
53<th>Name</th>
54<td>Description</td>
55          </tr>
56        </thead>
57        <tr>
58<td>in</td>
59<th>f</th>
60<td>Pointer to the function to begin running.</td>
61        </tr>
62        <tr>
63<td>in</td>
64<th>param</th>
65<td>Argument to pass to the function that begins execution.</td>
66        </tr>
67        <tr>
68<td>in</td>
69<th>stack</th>
70<td>Object representing the stack region.</td>
71        </tr>
72        <tr>
73<td>in</td>
74<th>priority</th>
75<td>Priority of the thread.</td>
76        </tr>
77        <tr>
78<td>in</td>
79<th>coreNo</th>
80<td>Preferred processor for the thread.</td>
81        </tr> </table>
82    </div>
83<h2>Return Values</h2>
84<div class="section">Returns the function's execution result. </div>
85<h2>Description</h2>
86    <div class="section">
87<p>Tries to initialize and run a thread.</p><p>This function attempts to initialize and run a thread; it returns an error if it fails because of insufficient resources or for any other such reason.</p></div>
88<h2>See Also</h2>
89    <div class="section">
90<p class="reference"><a href="../../../nn/os/Thread/Start.html"><CODE>Start</CODE></a><br /> </p>
91    </div>
92<h2>Revision History</h2>
93    <div class="section">
94      <dl class="history">
95        <dt>2011/09/01</dt>
96<dd>Deleted the note about specifying a preferred processor.<br />
97        </dd>
98        <dt>2011/06/22</dt>
99<dd>Added a note about specifying a preferred processor.<br />
100        </dd>
101        <dt>2010/01/07</dt>
102<dd>Initial version.<br />
103        </dd>
104      </dl>
105    </div>
106  <hr><p>CONFIDENTIAL</p></body>
107</html>
108