"use strict"; var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) { function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); } return new (P || (P = Promise))(function (resolve, reject) { function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); } step((generator = generator.apply(thisArg, _arguments || [])).next()); }); }; var __generator = (this && this.__generator) || function (thisArg, body) { var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g; return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g; function verb(n) { return function (v) { return step([n, v]); }; } function step(op) { if (f) throw new TypeError("Generator is already executing."); while (_) try { if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t; if (y = 0, t) op = [op[0] & 2, t.value]; switch (op[0]) { case 0: case 1: t = op; break; case 4: _.label++; return { value: op[1], done: false }; case 5: _.label++; y = op[1]; op = [0]; continue; case 7: op = _.ops.pop(); _.trys.pop(); continue; default: if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; } if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; } if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; } if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; } if (t[2]) _.ops.pop(); _.trys.pop(); continue; } op = body.call(thisArg, _); } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; } if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true }; } }; Object.defineProperty(exports, "__esModule", { value: true }); exports.Latch = void 0; //================================================================ /** * @packageDocumentation * @module std */ //================================================================ var ConditionVariable_1 = require("./ConditionVariable"); /** * Latch for critical sections. * * The `Latch` class blocks critical sections until the downward counter to be zero. Howver, * unlike {@link Barrier} who can reusable that downward counter be reset whenever reach to the * zero, downward of the `Latch` is not reusable but diposable. * * @author Jeongho Nam - https://github.com/samchon */ var Latch = /** @class */ (function () { /* --------------------------------------------------------- CONSTRUCTORS --------------------------------------------------------- */ /** * Initializer Constructor. * * @param size Size of the downward counter. */ function Latch(size) { this.cv_ = new ConditionVariable_1.ConditionVariable(); this.count_ = size; } /* --------------------------------------------------------- WAIT FUNCTIONS --------------------------------------------------------- */ /** * Waits until the counter to be zero. * * Blocks the function calling until internal counter to be reached to the zero. * * If the {@link Latch} already has been reached to the zero, it would be returned * immediately. */ Latch.prototype.wait = function () { return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: if (!(this._Try_wait() === false)) return [3 /*break*/, 2]; return [4 /*yield*/, this.cv_.wait()]; case 1: _a.sent(); _a.label = 2; case 2: return [2 /*return*/]; } }); }); }; /** * Test whether the counter has been reached to the zero. * * The {@link try_wait} function tests whether the internal counter has been reached to the * zero. * * @return Whether reached to zero or not. */ Latch.prototype.try_wait = function () { return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { return [2 /*return*/, this._Try_wait()]; }); }); }; /** * Tries to wait until the counter to be zero in timeout. * * Attempts to block the function calling until internal counter to be reached to the zero * in timeout. If succeeded to waiting the counter to be reached to the zero, it returns * `true`. Otherwise, the {@link Latch} fails to reach to the zero in the given time, the * function gives up the waiting and returns `false`. * * If the {@link Latch} already has been reached to the zero, it would return `true` directly. * * @param ms The maximum miliseconds for waiting. * @return Whether succeeded to waiting in the given time. */ Latch.prototype.wait_for = function (ms) { return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: if (!(this._Try_wait() === true)) return [3 /*break*/, 1]; return [2 /*return*/, true]; case 1: return [4 /*yield*/, this.cv_.wait_for(ms)]; case 2: return [2 /*return*/, _a.sent()]; } }); }); }; /** * Tries to wait until the counter to be zero in time expiration. * * Attempts to block the function calling until internal counter to be reached to the zero * in time expiration. If succeeded to waiting the counter to be reached to the zero, it * returns `true`. Otherwise, the {@link Latch} fails to reach to the zero in the given time, * the function gives up the waiting and returns `false`. * * If the {@link Latch} already has been reached to the zero, it would return `true` directly. * * @param at The maximum time point to wait. * @return Whether succeeded to waiting in the given time. */ Latch.prototype.wait_until = function (at) { return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: if (!(this._Try_wait() === true)) return [3 /*break*/, 1]; return [2 /*return*/, true]; case 1: return [4 /*yield*/, this.cv_.wait_until(at)]; case 2: return [2 /*return*/, _a.sent()]; } }); }); }; Latch.prototype._Try_wait = function () { return this.count_ <= 0; }; /* ----------------------------------------------------------- ARRIVAL FUNCTIONS ----------------------------------------------------------- */ /** * Derecements the counter. * * Decrements the counter by *n* without blocking. * * If the parametric value *n* is equal to or greater than internal counter, so that the * internal counter be equal to or less than zero, everyone who are {@link wait waiting} for * the {@link Latch} would continue their execution. * * @param n Value of the decrement. Default is 1. */ Latch.prototype.count_down = function (n) { if (n === void 0) { n = 1; } return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: this.count_ -= n; if (!(this._Try_wait() === true)) return [3 /*break*/, 2]; return [4 /*yield*/, this.cv_.notify_all()]; case 1: _a.sent(); _a.label = 2; case 2: return [2 /*return*/]; } }); }); }; /** * Decrements the counter and waits until the counter to be zero. * * Decrements the counter by *n* and blocks the section until internal counter to be zero. * * If the parametric value *n* is equal to or greater than internal counter, so that the * internal counter be equal to or less than zero, everyone who are {@link wait waiting} for * the {@link Latch} would continue their execution including this one. * * @param n Value of the decrement. Default is 1. */ Latch.prototype.arrive_and_wait = function (n) { if (n === void 0) { n = 1; } return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: return [4 /*yield*/, this.count_down(n)]; case 1: _a.sent(); return [4 /*yield*/, this.wait()]; case 2: _a.sent(); return [2 /*return*/]; } }); }); }; return Latch; }()); exports.Latch = Latch; //# sourceMappingURL=Latch.js.map