CriticalSectionStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Process functions / Threads, semaphores, signals and mutex

Miscellaneous
Equivalence

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CriticalSectionStart (Function)

In french: SectionCritiqueDébut

Marks the beginning of a critical section: no other thread will be able to run the code as long as the current thread does not exit from the critical section.

To exit from the critical section, use CriticalSectionEnd.

When the calls to CriticalSectionStart and CriticalSectionEnd are in the same section of the code, it is recommended to use the type CriticalSection and the syntax USE ... IN.
Example:

// Utilisation d'une variable de type Section Critique
S is CriticalSection

// Utilisation pour un bloc de code
//---------------------------
USING S IN
	// code protégé par la section critique
	// un seul thread pourra exécuter ce code à un moment donné
END

Example

// Section critique sur une variable
t is array <critical section> of int
CriticalSectionStart(t)
// Manipulations sur le tableau par un seul thread en même temps
CriticalSectionEnd(t)

// Utilisation d'une section critique nommée
CriticalSectionStart("MaSection")
// Deux threads ne pourront pas exécuter ce code en même temps
...
CriticalSectionEnd("MaSection")

Syntax

Starting a CriticalSection on a code section: using the CriticalSection type Hide the details

CriticalSectionStart(<Critical section>)

<Critical section>: CriticalSection variable

Name of the CriticalSection variable used to identify the critical section.

Starting a critical section on a variable Hide the details

CriticalSectionStart([<Variable name>])

<Variable name>: Any type

Name of WLanguage variable that must be protected in a critical section. This variable must be defined with the <critical section> attribute.

Starting a named critical section on a code section Hide the details

CriticalSectionStart([<Section name>])

<Section name>: Optional character string

Identifies the critical section. This parameter is used to identify the protected code sections.
If this parameter is not specified, an automatic critical section is implemented.
Note: the automatic critical section and the critical section corresponding to an empty chain ("") are different..

Remarks

Miscellaneous

For more details on critical sections, see Managing the critical sections.
If a thread is destroyed while it is found in a critical section, the critical section is automatically freed.
A single thread is allowed in all the sections with the same name.
If sections use a different name, a thread can run the code of one section while another thread runs the code of another section.
For more details, see Associating a critical section with a variable.

Equivalence

SemaphoreStart("NomSémaphore")

is equivalent to:

CriticalSectionStart("MaSectionCritique")

Indeed, by default, SemaphoreStart creates a semaphore limited to a single thread.

Component: wd300vm.dll