lock()

Read(2247) Label: synchronization lock,

Description:

Use a synchronization lock.

Syntax:

lock(n,s)

Note:

The function enforces limits on access to a file in a multithreading execution environment using lock-based synchronization. With the lock, only one thread can access and process the file at a time. Return true if the locking succeeds and return false if it fails.

Parameter:

n

Lock name

s

Timeout (in millisecond); waiting to be locked if the parameter is absent

Option:

@u

Unlock the restriction

Return value:

Boolean

Example:

Locking; below is the script file D:\test \lock1.splx:

 

A

 

1

=lock(1)

Use a lock named 1.

2

>output("Task "/arg1/" start...")

Output the parameter and start to calculate.

3

=file("D:/file/test/1.btx")

Create a btx file.

4

=create(ID,Value)

Create a table sequence.

5

>A4.record([arg1,arg1*arg1])

Add records to A4’s table sequence.

6

>sleep(1000)

Make the system sleep for 1,000 milliseconds.

7

>A3.export@ab(A4)

Write A4’s table sequence into the btx file.

8

>output("Task "/arg1/" finished.")

Output the parameter and finish the calculation.

9

>lock@u(1)

Unlock the access restriction.

 

File access:

 

A

 

1

=file("D:/file/test/1.btx")

 

2

D:\test \lock1.splx

 

3

=callx(A2,to(100))

When using callx() function to acess a file, the max number of parallel task set in Tool -> Options should be greater than 1 in case that the lock-based synchronization reports an error.

4

=A1.import@b()