pht\Vector::lock

(PECL pht >= 0.0.1)

pht\Vector::lockAcquires the vector's mutex lock

Description

public void pht\Vector::lock ( void )

This method will acquire the mutex lock associated with the vector. The mutex lock should always be acquired when manipulating the vector if it is being used by multiple threads.

The mutex locks of the Inter-Thread Communication (ITC) data structures are not reentrant. Attempting to reacquire an already-acquired mutex lock by the same thread will therefore cause a deadlock.

Parameters

This function has no parameters.

Return Values

No return value.

Examples

Example #1 Locking a vector's mutex lock

<?php

use pht\{ThreadVector};

$thread = new Thread();
$vector = new Vector();

$thread->addFunctionTask(function ($vector) {
    
$vector->lock();
    
$vector[] = 1;
    
$vector->unlock();
}, 
$vector);

$thread->start();

// $vector is currently being used by multiple threads
$vector->lock();
$vector[] = 2;
$vector->unlock();

$thread->join();

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top