nn::os::Thread Class

class Thread : public nn::os::WaitObject

Class for representing threads.

Threads have priorities. The thread priority is specified as an integer from 0 to 31, with 0 indicating the highest priority. Standard threads specify the DEFAULT_THREAD_PRIORITY of 16.

A stack region is needed for thread operation. You can either directly specify a memory region for this stack region, or you can use AutoStackManager.

To directly specify a memory region, pass the stack region to the Start function when you start the thread. Pass a stack region that is an instance of a class that has a function similar to uptr GetStackBottom(). The StackMemoryBlock and StackBuffer classes meet these requirements, so they can pass the stack region directly.
Note: If you are directly specifying a memory region, be careful that the stack region does not get invalidated before the thread is destroyed. (For example, releasing it will invalidate it.)

To use AutoStackManager to manage the stack region, pass the stack size to the StartUsingAutoStack function when you start the thread.

Thread objects become valid once Start-series functions have been left. Note that it is not at the point when a thread starts running. The IsValid function can be used to check whether an object is valid.

You must always call Join explicitly before destroying Thread objects that were started using the Start function. You cannot call Detach.

You must always call either Join or Detach explicitly before destroying Thread objects that were started using the StartUsingAutoStack function.

Thread objects inherit WaitObject objects; when a thread is released from waiting, it means that the thread has exited. When it's necessary to perform non-blocking Join operations, call a function like WaitOne or WaitObject::WaitAny first to verify that the thread has been released from waiting.

You can create up to 32 Thread objects. Note also that different functions might use up resources that count against this limit.

nn::util::NonCopyable
  nn::os::HandleObject
    nn::os::WaitObject
      nn::os::Thread

2010/01/07

Initial version.