mirrors/Odin
1
0
Fork 0
mirror of https://github.com/odin-lang/Odin.git synced 2026-08-04 05:08:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

added name argument description

Browse Source
This commit is contained in:
PePerRoNii
2025-08-20 21:00:25 +07:00
parent 155c03a2ee
commit 8884ad01f5
1 changed files with 41 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
core/thread/thread.odin
View File

@@ -104,7 +104,11 @@ thread will be in a suspended state, until `start()` procedure is called.
To start the thread, call `start()`. Also the `create_and_start()`
procedure can be called to create and start the thread immediately.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
*/
create :: proc(procedure: Thread_Proc, priority := Thread_Priority.Normal, name: Maybe(string) = nil) -> ^Thread {
return _create(procedure, priority, name)
}
@@ -178,6 +182,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -193,6 +200,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -208,6 +218,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -224,6 +237,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -240,6 +256,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -256,6 +275,9 @@ This procedure runs the given procedure on another thread. The context
specified by `init_context` will be used as the context in which `fn` is going
to execute. The thread will have priority specified by the `priority` parameter.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**IMPORTANT**: If `init_context` is specified and the default temporary allocator
is used, the thread procedure needs to call `runtime.default_temp_allocator_destroy()`
in order to free the resources associated with the temporary allocations.
@@ -276,6 +298,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -311,6 +336,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -350,6 +378,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -395,6 +426,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -446,6 +480,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -499,6 +536,9 @@ If `self_cleanup` is specified, after the thread finishes the execution of the
`fn` procedure, the resources associated with the thread are going to be
automatically freed.
Optionally specify the thread's name/description.
the name/description will be truncated to 15 bytes on Unix and 63 bytes on Windows.
**Do not** dereference the `^Thread` pointer, if this flag is specified.
That includes calling `join`, which needs to dereference ^Thread`.
@@ -572,4 +612,4 @@ _maybe_destroy_default_temp_allocator :: proc(init_context: Maybe(runtime.Contex
if context.temp_allocator.procedure == runtime.default_temp_allocator_proc {
runtime.default_temp_allocator_destroy(auto_cast context.temp_allocator.data)
}
}
}