• Xbasic COMMENT
• .T.
• .F.
• LET
• DEFINE CLASS ... END CLASS
• DIM ... AS
• DIM...AS...DEFAULT
• Dim ... AS ... New
• Xbasic Arrays
• TYPE ... END TYPE
• CONSTANT, SHARED, GLOBAL
• REDIM
• Namespaces
• Null Table Field Values
• <<%DELIMITER% ... %DELIMITER%
• DELETE
• Operators in Xbasic
• IF ... THEN ... ELSE, ELSEIF
• SELECT ... CASE ... END SELECT
• FOR ... CONTINUE ... NEXT
• FOR ... NEXT, CONTINUE, EXIT FOR
• FOR EACH ... NEXT
• WHILE ... END WHILE, EXIT WHILE
• WITH ... END WITH
• EXIT, EXIT FOR, EXIT FUNCTION, EXIT WHILE
• FUNCTION, EXIT FUNCTION, END FUNCTION
• User-Defined Functions
• END, WEND
• RETURN
• UNDECLARE
• GOTO
• Handling Errors
• ON ERROR GOTO, RESUME NEXT
• RESUME, RESUME NEXT
• STOP
• MODE
• OPTION
• PARENT
• PARENTFORM
• TOPPARENT
• THIS
• YIELD CONTROL
• <%A5 ? ... %>
• A5WINCLUDE
• IMPORT PACKAGE
• Argument_List Data Structure
• Automating Your Alpha Anywhere Applications
• Class Attribute Keywords
• Class Scope Keywords
• Classes
• Code Indirection
• Collections
• Command Statements
• Compiling the Script
• Defining a Function with Optional Pointer Variables
• Expression Components
• Getting the Name of the Currently Running Script or Function
• Modifying Object Event Code on the Fly
• Quoted Xbasic Statement
• Reserved Words
• Variable Data Types
• Xbasic Reference
• MACRO
• DECLARE
• DECLARESTRUCT

YIELD CONTROL

Syntax

Description

Allow a foreground thread to run via a background thread.

Discussion

A background thread uses the YIELD CONTROL command to allow a foreground thread to run. YIELD CONTROL causes the current thread to yield. If there are any other threads waiting to use the CPU, they will be able to do so.

Example code - a background thread counts up.

dim global running as L
dim global counter as N

running = .t.
thread_create("counter",<<%code%
#while running
# yield control
# counter = counter + 1
#end while
#%code%)

? counter
= 178

? counter
= 301

? thread_enum()
= Main
counter

Without the yield control, the background thread would not relinquish control to the thread_enum() command (and Alpha Anywhere would hang). If your background thread uses THREAD_WAIT() it does not need a yield control since THREAD_WAIT() yeilds an waits for another thread to call THREAD_EVENT(). If your background thread uses socket API calls for streamed file API calls, it doesn't need a YIELD CONTROL because the socket and streamed file calls are preemptive (and return control to the main thread).

Limitations

Desktop Applications Only

See Also

• Xbasic Language Reference