std/private/threadtypes

Types

GcThread {.pure, inheritable.} = object
  when emulatedThreadVars:
      tls*: ThreadLocalStorage

  else:
      nil

  when hasSharedHeap:
      next*, prev*: PGcThread
      stackBottom*, stackTop*: pointer
      stackSize*: int

  else:
      nil

Source Edit

Handle = int

Source Edit

PGcThread = ptr GcThread

Source Edit

SysThread = Handle

Source Edit

Thread[TArg] = object
  core*: PGcThread
  sys*: SysThread
  when TArg is void:
      dataFn*: proc () {.nimcall, ...gcsafe.}

  else:
      dataFn*: proc (m: TArg) {.nimcall, ...gcsafe.}
      data*: TArg

  when hasAllocStack:
      rawStack*: pointer

Source Edit

ThreadLocalStorage = array[0 .. (nimTlsSize div 8), float]

Source Edit

WinThreadProc = proc (x: pointer): int32 {.stdcall.}

Source Edit

Consts

emulatedThreadVars = false

Source Edit

hasAllocStack = false

Source Edit

hasSharedHeap = false

Source Edit

Procs

proc `=copy`[TArg](x: var Thread[TArg]; y: Thread[TArg]) {.error.}

Source Edit

proc createThread(lpThreadAttributes: pointer; dwStackSize: int32;
                  lpStartAddress: WinThreadProc; lpParameter: pointer;
                  dwCreationFlags: int32; lpThreadId: var int32): SysThread {.
    stdcall, dynlib: "kernel32", importc: "CreateThread", ...raises: [], tags: [],
    forbids: [].}

Source Edit

proc setThreadAffinityMask(hThread: SysThread; dwThreadAffinityMask: uint) {.
    importc: "SetThreadAffinityMask", stdcall, header: "<windows.h>",
    ...raises: [], tags: [], forbids: [].}

Source Edit

proc terminateThread(hThread: SysThread; dwExitCode: int32): int32 {.stdcall,
    dynlib: "kernel32", importc: "TerminateThread", ...raises: [], tags: [],
    forbids: [].}

Source Edit

proc waitForMultipleObjects(nCount: int32; lpHandles: ptr SysThread;
                            bWaitAll: int32; dwMilliseconds: int32): int32 {.
    stdcall, dynlib: "kernel32", importc: "WaitForMultipleObjects", ...raises: [],
    tags: [], forbids: [].}

Source Edit

proc waitForSingleObject(hHandle: SysThread; dwMilliseconds: int32): int32 {.
    stdcall, dynlib: "kernel32", importc: "WaitForSingleObject", ...raises: [],
    tags: [], forbids: [].}

Source Edit

proc winResumeThread(hThread: SysThread): int32 {.stdcall, dynlib: "kernel32",
    importc: "ResumeThread", ...raises: [], tags: [], forbids: [].}

Source Edit

proc winSuspendThread(hThread: SysThread): int32 {.stdcall, dynlib: "kernel32",
    importc: "SuspendThread", ...raises: [], tags: [], forbids: [].}

Source Edit