Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- update moved/renamed examples - update removed examples
- Loading branch information
Showing
8 changed files
with
177 additions
and
46 deletions.
There are no files selected for viewing
2 changes: 1 addition & 1 deletion
2
...multithreading/criticalsectionfaq10-1.bas → ...e/multithreading/criticalsectionfaq11.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
40 changes: 0 additions & 40 deletions
40
examples/manual/proguide/multithreading/criticalsectionfaq14.bas
This file was deleted.
Oops, something went wrong.
171 changes: 171 additions & 0 deletions
171
examples/manual/proguide/multithreading/emulatetls1.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,171 @@ | ||
| '' examples/manual/proguide/multithreading/emulatetls1.bas | ||
| '' | ||
| '' Example extracted from the FreeBASIC Manual | ||
| '' from topic 'Emulate a TLS (Thread Local Storage) and a TP (Thread Pooling) feature' | ||
| '' | ||
| '' See Also: https://www.freebasic.net/wiki/wikka.php?wakka=ProPgEmulateTlsTp | ||
| '' -------- | ||
|
|
||
| #include Once "crt/string.bi" | ||
|
|
||
| #if __FB_VERSION__ < "1.08" | ||
| ' Emulation of the function Threadself() of FreeBASIC | ||
| ' Before each use, the thread must refresh this function value with its own thread handle, | ||
| ' and all of this (refreshing + use) protected by a mutex. | ||
| Function ThreadSelf () ByRef As Any Ptr | ||
| Static As Any Ptr handle | ||
| Return handle | ||
| End Function | ||
| #else | ||
| #include Once "fbthread.bi" | ||
| #endif | ||
|
|
||
| #macro CreateTLSdatatypeVariableFunction (variable_function_name, variable_datatype) | ||
| ' Creation of a "variable_function_name" function to emulate a static datatype variable (not an array), | ||
| ' with a value depending on the thread using it. | ||
| Namespace TLS | ||
| Function variable_function_name (ByVal cd As Boolean = True) ByRef As variable_datatype | ||
| ' Function emulating (creation/access/destruction) a static datatype variable with value depending on thread using it: | ||
| ' If calling without parameter (or with 'True') parameter, this allows to [create and] access the static datatype variable. | ||
| ' If calling with the 'False' parameter, this allows to destroy the static datatype variable. | ||
| Dim As Integer bound = 0 | ||
| Static As Any Ptr TLSindex(bound) | ||
| Static As variable_datatype TLSdata(bound) | ||
| Dim As Any Ptr Threadhandle = ThreadSelf() | ||
| Dim As Integer index = 0 | ||
| For I As Integer = 1 To UBound(TLSindex) ' search existing TLS variable (existing array element) for the running thread | ||
| If TLSindex(I) = Threadhandle Then | ||
| index = I | ||
| Exit For | ||
| End If | ||
| Next I | ||
| If index = 0 And cd = True Then ' create a new TLS variable (new array element) for a new thread | ||
| index = UBound(TLSindex) + 1 | ||
| ReDim Preserve TLSindex(index) | ||
| TLSindex(index) = Threadhandle | ||
| ReDim Preserve TLSdata(index) | ||
| ElseIf index > 0 And cd = False Then ' destroy a TLS variable (array element) and compact the array | ||
| If index < UBound(TLSindex) Then ' reorder the array elements | ||
| memmove(@TLSindex(index), @TLSindex(index + 1), (UBound(TLSindex) - index) * SizeOf(Any Ptr)) | ||
| Dim As variable_datatype Ptr p = Allocate(SizeOf(variable_datatype)) ' for compatibility to object with destructor | ||
| memmove(p, @TLSdata(index), SizeOf(variable_datatype)) ' for compatibility to object with destructor | ||
| memmove(@TLSdata(index), @TLSdata(index + 1), (UBound(TLSdata) - index) * SizeOf(variable_datatype)) | ||
| memmove(@TLSdata(UBound(TLSdata)), p, SizeOf(variable_datatype)) ' for compatibility to object with destructor | ||
| Deallocate(p) ' for compatibility to object with destructor | ||
| End If | ||
| ReDim Preserve TLSindex(UBound(TLSindex) - 1) | ||
| ReDim Preserve TLSdata(UBound(TLSdata) - 1) | ||
| index = 0 | ||
| End If | ||
| Return TLSdata(index) | ||
| End Function | ||
| End Namespace | ||
| #endmacro | ||
|
|
||
| '------------------------------------------------------------------------------ | ||
|
|
||
| Type threadData | ||
| Dim As Any Ptr handle | ||
| Dim As String prefix | ||
| Dim As String suffix | ||
| Dim As Double tempo | ||
| #if __FB_VERSION__ < "1.08" | ||
| Static As Any Ptr mutex | ||
| #endif | ||
| End Type | ||
| #if __FB_VERSION__ < "1.08" | ||
| Dim As Any Ptr threadData.mutex | ||
| #endif | ||
|
|
||
| CreateTLSdatatypeVariableFunction (count, Integer) ' create a TLS static integer function | ||
|
|
||
| Function counter() As Integer ' definition of a generic counter with counting depending on thread calling it | ||
| TLS.count() += 1 ' increment the TLS static integer | ||
| Return TLS.count() ' return the TLS static integer | ||
| End Function | ||
|
|
||
| Sub Thread(ByVal p As Any Ptr) | ||
| Dim As threadData Ptr ptd = p | ||
| Dim As UInteger c | ||
| Do | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexLock(threadData.mutex) | ||
| ThreadSelf() = ptd->handle | ||
| #endif | ||
| c = counter() | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexUnlock(threadData.mutex) | ||
| #endif | ||
| Print ptd->prefix & c & ptd->suffix & " "; ' single print with concatenated string avoids using a mutex | ||
| Sleep ptd->tempo, 1 | ||
| Loop Until c = 12 | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexLock(threadData.mutex) | ||
| ThreadSelf() = ptd->handle | ||
| #endif | ||
| TLS.count(False) ' destroy the TLS static integer | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexUnlock(threadData.mutex) | ||
| #endif | ||
| End Sub | ||
|
|
||
| '------------------------------------------------------------------------------ | ||
|
|
||
| Print "|x| : counting from thread a" | ||
| Print "(x) : counting from thread b" | ||
| Print "[x] : counting from thread c" | ||
|
|
||
| #if __FB_VERSION__ < "1.08" | ||
| threadData.mutex = MutexCreate() | ||
| #endif | ||
|
|
||
| Dim As threadData mtlsa | ||
| mtlsa.prefix = "|" | ||
| mtlsa.suffix = "|" | ||
| mtlsa.tempo = 100 | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexLock(threadData.mutex) | ||
| #endif | ||
| mtlsa.handle = ThreadCreate(@Thread, @mtlsa) | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexUnlock(threadData.mutex) | ||
| #endif | ||
|
|
||
| Dim As threadData mtlsb | ||
| mtlsb.prefix = "(" | ||
| mtlsb.suffix = ")" | ||
| mtlsb.tempo = 150 | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexLock(threadData.mutex) | ||
| #endif | ||
| mtlsb.handle = ThreadCreate(@Thread, @mtlsb) | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexUnlock(threadData.mutex) | ||
| #endif | ||
|
|
||
| Dim As threadData mtlsc | ||
| mtlsc.prefix = "[" | ||
| mtlsc.suffix = "]" | ||
| mtlsc.tempo = 250 | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexLock(threadData.mutex) | ||
| #endif | ||
| mtlsc.handle = ThreadCreate(@Thread, @mtlsc) | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexUnlock(threadData.mutex) | ||
| #endif | ||
|
|
||
| ThreadWait(mtlsa.handle) | ||
| ThreadWait(mtlsb.handle) | ||
| ThreadWait(mtlsc.handle) | ||
| #if __FB_VERSION__ < "1.08" | ||
| MutexDestroy(threadData.mutex) | ||
| #endif | ||
|
|
||
| Print "end of threads" | ||
|
|
||
| Sleep | ||
|
|
2 changes: 1 addition & 1 deletion
2
...e/multithreading/criticalsectionfaq13.bas → ...al/proguide/multithreading/emulatetp1.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...multithreading/criticalsectionfaq13-2.bas → ...al/proguide/multithreading/emulatetp2.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...multithreading/criticalsectionfaq13-3.bas → ...al/proguide/multithreading/emulatetp3.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...multithreading/criticalsectionfaq13-4.bas → ...al/proguide/multithreading/emulatetp4.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...multithreading/criticalsectionfaq13-5.bas → ...al/proguide/multithreading/emulatetp5.bas
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters