1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

QSharedPointer: fix threadsafety docs

Browse Source 
Try and explain better the situation around QSharedPointer:
it's reentrant, not thread safe.

Change-Id: Ief9d28be8ea3fbaa6014cb6b999626db1bab52ca
Reviewed-by: Martin Smith <martin.smith@qt.io>
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
This commit is contained in:
Giuseppe D'Angelo 2019-05-10 20:47:33 +02:00
parent 341c910688
commit 41aa78856e
1 changed files with 12 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
src/corelib/tools/qsharedpointer.cpp
View File

@ -65,14 +65,19 @@
\section1 Thread-Safety \section1 Thread-Safety
QSharedPointer and QWeakPointer are thread-safe and operate QSharedPointer and QWeakPointer are reentrant classes. This means that, in
atomically on the pointer value. Different threads can also access general, a given QSharedPointer or QWeakPointer object \b{cannot} be
the QSharedPointer or QWeakPointer pointing to the same object at accessed by multiple threads at the same time without synchronization.
the same time without need for locking mechanisms.
It should be noted that, while the pointer value can be accessed Different QSharedPointer and QWeakPointer objects can safely be accessed
in this manner, QSharedPointer and QWeakPointer provide no by multiple threads at the same time. This includes the case where they
guarantee about the object being pointed to. Thread-safety and hold pointers to the same object; the reference counting mechanism
is atomic, and no manual synchronization is required.
It should be noted that, while the pointer value can be accessed in this
manner (that is, by multiple threads at the same time, without
synchronization), QSharedPointer and QWeakPointer provide no guarantee
about the object being pointed to. The specific thread-safety and
reentrancy rules for that object still apply. reentrancy rules for that object still apply.
\section1 Other Pointer Classes \section1 Other Pointer Classes