tests/auto/qthreadonce/qthreadonce.cpp
changeset 0 1918ee327afb
child 4 3b1da2848fc7
equal deleted inserted replaced
-1:000000000000 0:1918ee327afb
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     4 ** All rights reserved.
       
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
       
     6 **
       
     7 ** This file is part of the test suite of the Qt Toolkit.
       
     8 **
       
     9 ** $QT_BEGIN_LICENSE:LGPL$
       
    10 ** No Commercial Usage
       
    11 ** This file contains pre-release code and may not be distributed.
       
    12 ** You may use this file in accordance with the terms and conditions
       
    13 ** contained in the Technology Preview License Agreement accompanying
       
    14 ** this package.
       
    15 **
       
    16 ** GNU Lesser General Public License Usage
       
    17 ** Alternatively, this file may be used under the terms of the GNU Lesser
       
    18 ** General Public License version 2.1 as published by the Free Software
       
    19 ** Foundation and appearing in the file LICENSE.LGPL included in the
       
    20 ** packaging of this file.  Please review the following information to
       
    21 ** ensure the GNU Lesser General Public License version 2.1 requirements
       
    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
       
    23 **
       
    24 ** In addition, as a special exception, Nokia gives you certain additional
       
    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
       
    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
       
    27 **
       
    28 ** If you have questions regarding the use of this file, please contact
       
    29 ** Nokia at qt-info@nokia.com.
       
    30 **
       
    31 **
       
    32 **
       
    33 **
       
    34 **
       
    35 **
       
    36 **
       
    37 **
       
    38 ** $QT_END_LICENSE$
       
    39 **
       
    40 ****************************************************************************/
       
    41 
       
    42 
       
    43 #include "qplatformdefs.h"
       
    44 #include "qthreadonce.h"
       
    45 
       
    46 #ifndef QT_NO_THREAD
       
    47 #include "qmutex.h"
       
    48 
       
    49 Q_GLOBAL_STATIC_WITH_ARGS(QMutex, onceInitializationMutex, (QMutex::Recursive))
       
    50 
       
    51 enum QOnceExtra {
       
    52     MustRunCode = 0x01,
       
    53     MustUnlockMutex = 0x02
       
    54 };
       
    55 
       
    56 /*!
       
    57     \internal
       
    58     Initialize the Q_ONCE structure.
       
    59 
       
    60     Q_ONCE consists of two variables:
       
    61      - a static POD QOnceControl::ControlVariable (it's a QBasicAtomicInt)
       
    62      - an automatic QOnceControl that controls the former
       
    63 
       
    64     The POD is initialized to 0.
       
    65 
       
    66     When QOnceControl's constructor starts, it'll lock the global
       
    67     initialization mutex. It'll then check if it's the first to up
       
    68     the control variable and will take note.
       
    69 
       
    70     The QOnceControl's destructor will unlock the global
       
    71     initialization mutex.
       
    72 */
       
    73 QOnceControl::QOnceControl(QBasicAtomicInt *control)
       
    74 {
       
    75     d = 0;
       
    76     gv = control;
       
    77     // check if code has already run once
       
    78     if (*gv == 2) {
       
    79         // uncontended case: it has already initialized
       
    80         // no waiting
       
    81         return;
       
    82     }
       
    83 
       
    84     // acquire the path
       
    85     onceInitializationMutex()->lock();
       
    86     extra = MustUnlockMutex;
       
    87 
       
    88     if (gv->testAndSetAcquire(0, 1)) {
       
    89         // path acquired, we're the first
       
    90         extra |= MustRunCode;
       
    91     }
       
    92 }
       
    93 
       
    94 QOnceControl::~QOnceControl()
       
    95 {
       
    96     if (mustRunCode())
       
    97         // code wasn't run!
       
    98         gv->testAndSetRelease(1, 0);
       
    99     else
       
   100         gv->testAndSetRelease(1, 2);
       
   101     if (extra & MustUnlockMutex)
       
   102         onceInitializationMutex()->unlock();
       
   103 }
       
   104 
       
   105 /*!
       
   106     \internal
       
   107     Returns true if the initialization code must be run.
       
   108 
       
   109     Obviously, the initialization code must be run only once...
       
   110 */
       
   111 bool QOnceControl::mustRunCode()
       
   112 {
       
   113     return extra & MustRunCode;
       
   114 }
       
   115 
       
   116 void QOnceControl::done()
       
   117 {
       
   118     extra &= ~MustRunCode;
       
   119 }
       
   120 
       
   121 #endif // QT_NO_THREAD