polar-threading.h

/* Internal API: thread management for polar-objc.
   Copyright (C) 2022-2025 Michael Malicoat <[email protected]>
 
   This file is part of polar-objc.
 
   polar-objc is free software; you can redistribute it and/or modify it under the terms of the GNU General Public
   License as published by the Free Software Foundation; either version 3, or (at your option) any later version.
 
   polar-objc is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
   warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
   details.
 
   You should have received a copy of the GNU General Public License along with this program; see the file LICENSE.  If
   not, see <http://www.gnu.org/licenses/>.
*/
#ifndef POLAR_THREADING_H
#define POLAR_THREADING_H
 
POLAR_FUNCTION_INTERNAL intptr_t
polar_thread_split( thrd_t *out_thread_id, polar_func_thread_enter func_thread_enter, void *thread_entry_data,
                    polar_thread_message_queue *thread_new_inbox );
 
POLAR_FUNCTION_INTERNAL polar_thread_data *
polar_thread_current_get_data( BOOL flag_allocate_on_demand );
 
// This is passed as a destructor to tss_create() and so must be a standard C function
void
polar_thread_current_exit( void );
 
// Called by polar_init()
POLAR_FUNCTION_INTERNAL intptr_t
polar_threading_init( void );
 
// Called by polar_finalize()
POLAR_FUNCTION_INTERNAL void
polar_threading_finalize( void );
 
static inline polar_thread_message_queue *
polar_thread_current_get_inbox( void )
{
  return polar_thread_data_get_inbox( polar_thread_current_get_data(YES) );
}
 
#endif //POLAR_THREADING_H