Thread4D (TotalCrossSDK 6.1.0 API)

java.lang.Object
- totalcross.lang.Thread4D

All Implemented Interfaces:

java.lang.Runnable
```
public abstract class Thread4D
extends java.lang.Object
implements java.lang.Runnable
```
A simple preemptive thread model. Important: the synchronized keyword is not implemented by the TotalCross VM. Note that in PalmOS while the user is writing in the grafitti area all events (including threads) are blocked (this is a Operating System behaviour).

IMPORTANT: the totalcross.lang package is the java.lang that will be used in the device. You CANNOT use nor import totalcross.lang package in desktop. When tc.Deploy is called, all references to java.lang are replaced by totalcross.lang automatically. Given this, you must use only the classes and methods that exists BOTH in java.lang and totalcross.lang. For example, you can't use java.lang.ClassLoader because there are no totalcross.lang.ClassLoader. Another example, you can't use java.lang.String.indexOfIgnoreCase because there are no totalcross.lang.String.indexOfIgnoreCase method. Trying to use a class or method from the java.lang package that has no correspondence with totalcross.lang will make the tc.Deploy program to abort, informing where the problem occured. A good idea is to always refer to this javadoc to know what is and what isn't available.

See Also:

Runnable

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MAX_PRIORITY` The maximum priority that a thread can have.
`static int`	`MIN_PRIORITY` The minimum priority that a thread can have.
`static int`	`NORM_PRIORITY` The default priority that is assigned to a thread.

Constructor Summary

Constructors
Constructor and Description
`Thread4D()` Creates a new thread using a newly generated name in the format "Thread-n", where "n" is the thread's ID.
`Thread4D(java.lang.Runnable r)` Creates a new thread with the given runnable object and using a newly generated name in the format "Thread-n", where "n" is the thread's ID.
`Thread4D(java.lang.Runnable r, java.lang.String name)` Creates a new thread with the given runnable object and name.
`Thread4D(java.lang.String name)` Creates a new thread with the given name.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static java.lang.Thread`	`currentThread()` Returns a reference to the currently running thread.
`long`	`getId()` Returns the thread id, which is a number generated automatically.
`java.lang.String`	`getName()` Returns this thread's name.
`int`	`getPriority()` Returns this thread's priority.
`boolean`	`isAlive()` Returns true if this thread is alive.
`void`	`run()` Called by the vm to run the thread.
`void`	`setName(java.lang.String name)` Sets this thread's name.
`void`	`setPriority(int priority)` Sets the thread priority, ranging from #MIN_PRIORITY to #MAX_PRIORITY.
`static void`	`sleep(long millis)`
`void`	`start()` Starts a thread.
`java.lang.String`	`toString()` Returns a string representation of this thread, including the thread's name and priority.
`static void`	`yield()` Give up on the timeslice of the current thread and goes to the next thread in the round-robin queue.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - MIN_PRIORITY
```
public static final int MIN_PRIORITY
```
    The minimum priority that a thread can have.
    
    See Also:
    
    Constant Field Values
  - NORM_PRIORITY
```
public static final int NORM_PRIORITY
```
    The default priority that is assigned to a thread.
    
    See Also:
    
    Constant Field Values
  - MAX_PRIORITY
```
public static final int MAX_PRIORITY
```
    The maximum priority that a thread can have.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Thread4D
```
public Thread4D()
```
    Creates a new thread using a newly generated name in the format "Thread-n", where "n" is the thread's ID.
  - Thread4D
```
public Thread4D(java.lang.String name)
```
    Creates a new thread with the given name.
    
    Parameters:
    
    name - the name of the new thread or null to use a newly generated name in the format "Thread-n", where "n" is the thread's ID.
    
    Since:
    
    TotalCross 1.22
  - Thread4D
```
public Thread4D(java.lang.Runnable r)
```
    Creates a new thread with the given runnable object and using a newly generated name in the format "Thread-n", where "n" is the thread's ID.
    
    Parameters:
    
    r - the object whose run method is called.
  - Thread4D
```
public Thread4D(java.lang.Runnable r,
                java.lang.String name)
```
    Creates a new thread with the given runnable object and name.
    
    Parameters:
    
    r - the object whose run method is called.
    
    name - the name of the new thread or null to use a newly generated name in the format "Thread-n", where "n" is the thread's ID.
    
    Since:
    
    TotalCross 1.22
- Method Detail
  - getId
```
public long getId()
```
    Returns the thread id, which is a number generated automatically.
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this thread, including the thread's name and priority.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    a string representation of this thread.
  - getName
```
public final java.lang.String getName()
```
    Returns this thread's name.
    
    Returns:
    
    this thread's name.
    
    Since:
    
    TotalCross 1.22
  - setName
```
public final void setName(java.lang.String name)
```
    Sets this thread's name.
    
    Parameters:
    
    name - the new name for this thread.
    
    Since:
    
    TotalCross 1.22
  - getPriority
```
public final int getPriority()
```
    Returns this thread's priority.
    
    Returns:
    
    this thread's priority.
    
    Since:
    
    TotalCross 1.22
  - setPriority
```
public final void setPriority(int priority)
```
    Sets the thread priority, ranging from #MIN_PRIORITY to #MAX_PRIORITY. Must be set BEFORE start is called, otherwise it will have no effect (some platforms do not allow the priority change after it is started).
    
    See Also:
    
    MIN_PRIORITY, NORM_PRIORITY, MAX_PRIORITY
  - isAlive
```
public final boolean isAlive()
```
    Returns true if this thread is alive.
  - run
```
public void run()
```
    Called by the vm to run the thread.
    
    Specified by:
    
    run in interface java.lang.Runnable
  - yield
```
public static void yield()
```
    Give up on the timeslice of the current thread and goes to the next thread in the round-robin queue.
  - sleep
```
public static void sleep(long millis)
                  throws java.lang.InterruptedException
```
    Throws:
    
    java.lang.InterruptedException
  - start
```
public void start()
```
    Starts a thread. The same thread cannot be started twice.
  - currentThread
```
public static java.lang.Thread currentThread()
```
    Returns a reference to the currently running thread.
    
    Since:
    
    TotalCross 1.22

Class Thread4D

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MIN_PRIORITY

NORM_PRIORITY

MAX_PRIORITY

Constructor Detail

Thread4D

Thread4D

Thread4D

Thread4D

Method Detail

getId

toString

getName

setName

getPriority

setPriority

isAlive

run

yield

sleep

start

currentThread