2014-02-10 02:10:30 +01:00
/*************************************************************************/
/* thread.cpp */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
2017-08-27 14:16:55 +02:00
/* https://godotengine.org */
2014-02-10 02:10:30 +01:00
/*************************************************************************/
2021-01-01 20:13:46 +01:00
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
2014-02-10 02:10:30 +01:00
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
2018-01-05 00:50:27 +01:00
2021-09-25 02:23:36 +02:00
# ifndef PLATFORM_THREAD_OVERRIDE // See details in thread.h
2021-09-16 02:48:04 +02:00
2014-02-10 02:10:30 +01:00
# include "thread.h"
2021-01-27 20:10:10 +01:00
# include "core/script_language.h"
2014-02-10 02:10:30 +01:00
2021-01-27 20:10:10 +01:00
# if !defined(NO_THREADS)
2014-02-10 02:10:30 +01:00
2021-01-31 13:34:42 +01:00
# include "core/safe_refcount.h"
2021-01-27 20:10:10 +01:00
Error ( * Thread : : set_name_func ) ( const String & ) = nullptr ;
void ( * Thread : : set_priority_func ) ( Thread : : Priority ) = nullptr ;
void ( * Thread : : init_func ) ( ) = nullptr ;
void ( * Thread : : term_func ) ( ) = nullptr ;
2016-03-09 00:00:52 +01:00
2021-03-07 09:09:02 +01:00
uint64_t Thread : : _thread_id_hash ( const std : : thread : : id & p_t ) {
static std : : hash < std : : thread : : id > hasher ;
return hasher ( p_t ) ;
}
Thread : : ID Thread : : main_thread_id = _thread_id_hash ( std : : this_thread : : get_id ( ) ) ;
2021-03-25 20:45:51 +01:00
static thread_local Thread : : ID caller_id = 0 ;
static thread_local bool caller_id_cached = false ;
2014-02-10 02:10:30 +01:00
2021-01-27 20:10:10 +01:00
void Thread : : _set_platform_funcs (
Error ( * p_set_name_func ) ( const String & ) ,
void ( * p_set_priority_func ) ( Thread : : Priority ) ,
void ( * p_init_func ) ( ) ,
void ( * p_term_func ) ( ) ) {
Thread : : set_name_func = p_set_name_func ;
Thread : : set_priority_func = p_set_priority_func ;
Thread : : init_func = p_init_func ;
Thread : : term_func = p_term_func ;
}
2016-03-09 00:00:52 +01:00
2021-01-27 20:10:10 +01:00
void Thread : : callback ( Thread * p_self , const Settings & p_settings , Callback p_callback , void * p_userdata ) {
2021-03-25 20:45:51 +01:00
caller_id = _thread_id_hash ( p_self - > thread . get_id ( ) ) ;
caller_id_cached = true ;
2021-01-27 20:10:10 +01:00
if ( set_priority_func ) {
set_priority_func ( p_settings . priority ) ;
}
if ( init_func ) {
init_func ( ) ;
}
ScriptServer : : thread_enter ( ) ; //scripts may need to attach a stack
p_callback ( p_userdata ) ;
ScriptServer : : thread_exit ( ) ;
if ( term_func ) {
term_func ( ) ;
}
}
2016-03-09 00:00:52 +01:00
2021-01-27 20:10:10 +01:00
void Thread : : start ( Thread : : Callback p_callback , void * p_user , const Settings & p_settings ) {
2021-03-07 09:09:02 +01:00
if ( id ! = _thread_id_hash ( std : : thread : : id ( ) ) ) {
2021-01-27 20:10:10 +01:00
# ifdef DEBUG_ENABLED
WARN_PRINT ( " A Thread object has been re-started without wait_to_finish() having been called on it. Please do so to ensure correct cleanup of the thread. " ) ;
# endif
thread . detach ( ) ;
std : : thread empty_thread ;
thread . swap ( empty_thread ) ;
2014-02-10 02:10:30 +01:00
}
2021-01-27 20:10:10 +01:00
std : : thread new_thread ( & Thread : : callback , this , p_settings , p_callback , p_user ) ;
thread . swap ( new_thread ) ;
2021-03-07 09:09:02 +01:00
id = _thread_id_hash ( thread . get_id ( ) ) ;
2014-02-10 02:10:30 +01:00
}
2021-01-27 20:10:10 +01:00
bool Thread : : is_started ( ) const {
2021-03-07 09:09:02 +01:00
return id ! = _thread_id_hash ( std : : thread : : id ( ) ) ;
2021-01-27 20:10:10 +01:00
}
2016-03-09 00:00:52 +01:00
2021-01-27 20:10:10 +01:00
void Thread : : wait_to_finish ( ) {
2021-03-07 09:09:02 +01:00
if ( id ! = _thread_id_hash ( std : : thread : : id ( ) ) ) {
2021-02-25 13:16:27 +01:00
ERR_FAIL_COND_MSG ( id = = get_caller_id ( ) , " A Thread can't wait for itself to finish. " ) ;
2021-01-27 20:10:10 +01:00
thread . join ( ) ;
std : : thread empty_thread ;
thread . swap ( empty_thread ) ;
2021-03-07 09:09:02 +01:00
id = _thread_id_hash ( std : : thread : : id ( ) ) ;
2021-01-27 20:10:10 +01:00
}
2014-02-10 02:10:30 +01:00
}
2015-12-17 10:24:27 +01:00
Error Thread : : set_name ( const String & p_name ) {
2021-01-27 20:10:10 +01:00
if ( set_name_func ) {
2016-02-01 00:22:38 +01:00
return set_name_func ( p_name ) ;
2021-01-27 20:10:10 +01:00
}
2016-02-01 00:22:38 +01:00
2015-12-17 10:24:27 +01:00
return ERR_UNAVAILABLE ;
2014-02-10 02:10:30 +01:00
}
2017-03-05 16:44:50 +01:00
Thread : : ~ Thread ( ) {
2021-03-07 09:09:02 +01:00
if ( id ! = _thread_id_hash ( std : : thread : : id ( ) ) ) {
2021-01-27 20:10:10 +01:00
# ifdef DEBUG_ENABLED
WARN_PRINT ( " A Thread object has been destroyed without wait_to_finish() having been called on it. Please do so to ensure correct cleanup of the thread. " ) ;
# endif
thread . detach ( ) ;
}
2014-02-10 02:10:30 +01:00
}
2021-01-27 20:10:10 +01:00
2021-03-25 20:45:51 +01:00
Thread : : ID Thread : : get_caller_id ( ) {
if ( likely ( caller_id_cached ) ) {
return caller_id ;
} else {
caller_id = _thread_id_hash ( std : : this_thread : : get_id ( ) ) ;
caller_id_cached = true ;
return caller_id ;
}
}
2021-01-27 20:10:10 +01:00
# endif
2021-09-25 02:23:36 +02:00
# endif // PLATFORM_THREAD_OVERRIDE