TnFOX: FX::QRWMutex::lock

bool FX::QRWMutex::lock ( bool write = true )

Returns:: True if nested write lock request while read lock was held resulted in unlock for other thread (ie; reread all your pointers etc)

Parameters:

write

True if you wish to write as well as read

Claims the read/write mutex for access. Requesting read access will always return immediately if only other claimants have requested read access. You may nest lock()'s, for example

    lock(false);
    ...
    lock(true);
    ...
    unlock(true);
    unlock(false);

This facility to lock for read, then if necessary a write is quite useful.

Warning:: Do not use this directly unless absolutely necessary. Use QMtxHold instead.