[][src]Function sdl2_sys::SDL_CreateThreadWithStackSize

pub unsafe extern "C" fn SDL_CreateThreadWithStackSize(
    fn_: SDL_ThreadFunction,
    name: *const c_char,
    stacksize: size_t,
    data: *mut c_void
) -> *mut SDL_Thread

Create a thread.

Thread naming is a little complicated: Most systems have very small limits for the string length (Haiku has 32 bytes, Linux currently has 16, Visual C++ 6.0 has nine!), and possibly other arbitrary rules. You'll have to see what happens with your system's debugger. The name should be UTF-8 (but using the naming limits of C identifiers is a better bet). There are no requirements for thread naming conventions, so long as the string is null-terminated UTF-8, but these guidelines are helpful in choosing a name:

http://stackoverflow.com/questions/149932/naming-conventions-for-threads

If a system imposes requirements, SDL will try to munge the string for it (truncate, etc), but the original string contents will be available from SDL_GetThreadName().

The size (in bytes) of the new stack can be specified. Zero means "use the system default" which might be wildly different between platforms (x86 Linux generally defaults to eight megabytes, an embedded device might be a few kilobytes instead).

In SDL 2.1, stacksize will be folded into the original SDL_CreateThread function.