DBLockStringMutex - Revision history

Admin: 1 revision imported

2025-06-09T11:11:14Z

1 revision imported

1>Admin at 16:10, 19 May 2025

2025-05-19T16:10:13Z

Admin: 1 revision imported

2021-04-16T14:16:53Z

1 revision imported

1>Admin at 07:53, 21 March 2021

2021-03-21T07:53:48Z

Admin: 1 revision imported

2021-02-07T06:43:27Z

1 revision imported

Admin at 08:35, 31 July 2020

2020-07-31T08:35:50Z

New page

{{infobox function
|name=DBLockStringMutex
|object=[[Функции общего назначения]]
|caption=Серверные функции
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция осуществляет блокировку именованного серверного семафора, либо возвращает данные пользователя, который его заблокировал. Серверные семафоры задаются по именам и ведут себя как системные именованные [[Функции общего назначения#Объект семафор|семафоры]] для всех пользователей сервера (т.е., два пользователя не могут одновременно заблокировать один семафор с определенным именем). Имена семафоров зависят от регистра и могут содержать любые знаки (включая символы с кодом 0). Серверные семафоры могут использоваться для операций, требующих исключительно эксклюзивного доступа, однако, не представляющих собой объекты базы данных. К примеру, доступ к каталогу на сервере может быть разграничен с помощью серверного семафора. Важно понимать, что функция не возвращает объект, поэтому, семафор не будет разблокирован автоматически при удалении переменной с объектом, необходимо предусмотреть механизм, который гарантировано разблокирует семафор после выполнения требуемого действия. Блокировка семафора осуществляется на уровне потока, два разных потока одного клиента не могут заблокировать один и тот же семафор. При закрытии потока или завершении работы клиента, сервер автоматически осуществит разблокировку семафора. Ниже дана таблица, сравнивающая различные блокировки в системе:
{{Типы блокировок системы}}

== Синтаксис ==
<code>
'''DBLockStringMutex'''(''<Имя семафора (STRING)>''{{OptionalByRef|,<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>}}):''<Результат (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя семафора (STRING)>''</code> - Имя серверного семафора, который необходимо заблокировать
* <code>''<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>''</code> - {{ByRef}} {{Optional}} Переменные, получающие информацию о том, кто, где и в какое время произвел блокировку семафора, если он уже был заблокирован.

==== Возвращаемое значение ====
Возвращает 1, если семафор удалось заблокировать, иначе возвращает 0.

== Примеры ==
<pre>
//Блок позволяет провести обмен с другой базой из текущей в монопольном режиме (другие пользователи из текущей базы не смогут производить обмен, пока он ведется данным клиентом).
ИмяБлок:="Обмен с центральной базой";
аПольз:="";аМаш:="";аДата:="";
If not DBLockStringMutex(ИмяБлок,аПольз,аМаш,аДата) Then
Box("Обмен с центральной базой уже выполняет пользователь "+аПольз+" ("+аМаш+"), начало "+аДата+"! Дождитесь окончания предыдущего обмена!",Q_STOP);
Exit;
EndIf;
Try
...
Finally
DBUnlockStringMutex(ИмяБлок);
EndTry;
</pre>

← Older revision	Revision as of 11:11, 9 June 2025
(No difference)

@@ Line 18: / Line 18: @@
 == Синтаксис ==
 <code>
-'''DBLockStringMutex'''(''<Имя семафора (STRING)>''{{OptionalByRef|,<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>}}):''<Результат (INT)>''
+'''DBLockStringMutex'''(''<Имя семафора (STRING)>''{{OptionalByRef|,<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>}}{{Optional|,<Время ожидания блокировки (INT)>{{Default|{{Eq}}0}}}}):''<Результат (INT)>''
 </code>
 ==== Аргументы ====
 * <code>''<Имя семафора (STRING)>''</code> - Имя серверного семафора, который необходимо заблокировать
 * <code>''<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>''</code> - {{ByRef}} {{Optional}} Переменные, получающие информацию о том, кто, где и в какое время произвел блокировку семафора, если он уже был заблокирован.
 ==== Возвращаемое значение ====

← Older revision	Revision as of 14:16, 16 April 2021
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция осуществляет блокировку именованного серверного семафора, либо возвращает данные пользователя, который его заблокировал. Серверные семафоры задаются по именам и ведут себя как системные именованные [[Функции общего назначения#Объект семафор|семафоры]] для всех пользователей сервера (т.е., два пользователя не могут одновременно заблокировать один семафор с определенным именем). Имена семафоров зависят от регистра и могут содержать любые знаки (включая символы с кодом 0). Серверные семафоры могут использоваться для операций, требующих исключительно эксклюзивного доступа, однако, не представляющих собой объекты базы данных. К примеру, доступ к каталогу на сервере может быть разграничен с помощью серверного семафора. Важно понимать, что функция не возвращает объект, поэтому, семафор не будет разблокирован автоматически при удалении переменной с объектом, необходимо предусмотреть механизм, который гарантировано разблокирует семафор после выполнения требуемого действия. Блокировка семафора осуществляется на уровне потока, два разных потока одного клиента не могут заблокировать один и тот же семафор. При закрытии потока или завершении работы клиента, сервер автоматически осуществит разблокировку семафора. Ниже дана таблица, сравнивающая различные блокировки в системе:
+Функция осуществляет блокировку именованного серверного семафора, либо возвращает данные пользователя, который его заблокировал. Серверные семафоры задаются по именам и ведут себя как системные именованные [[Функции общего назначения#Объект семафор|семафоры]] для всех пользователей сервера (т.е., два пользователя не могут одновременно заблокировать один семафор с определенным именем). Имена семафоров зависят от регистра и могут содержать любые знаки (включая символы с кодом 0). Серверные семафоры могут использоваться для операций, требующих исключительно эксклюзивного доступа, однако, не оперирующих определенным объектом базы данных. К примеру, доступ к каталогу на сервере может быть разграничен с помощью серверного семафора. Важно понимать, что функция не возвращает объект, поэтому, семафор не будет разблокирован автоматически при удалении переменной с объектом, необходимо предусмотреть механизм, который гарантировано разблокирует семафор после выполнения требуемого действия. Блокировка семафора осуществляется на уровне потока, два разных потока одного клиента не могут заблокировать один и тот же семафор. При закрытии потока или завершении работы клиента, сервер автоматически осуществит разблокировку семафора. Ниже дана таблица, сравнивающая различные блокировки в системе:
 {{Типы блокировок системы}}

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)