Update Files

Kha/Kinc/Sources/kinc/threads/semaphore.h

@@ -0,0 +1,58 @@
+#pragma once
+
+#include <kinc/global.h>
+
+#include <kinc/backend/semaphore.h>
+
+#include <stdbool.h>
+
+/*! \file semaphore.h
+    \brief A semaphore is a fancier version of an event that includes a counter to control how many threads are allowed to work on a task.
+*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct kinc_semaphore {
+	kinc_semaphore_impl_t impl;
+} kinc_semaphore_t;
+
+/// <summary>
+/// Initializes a semaphore.
+/// </summary>
+/// <param name="semaphore">The semaphore to initialize</param>
+/// <param name="current">The current count of the semaphore</param>
+/// <param name="max">The maximum allowed count of the semaphore</param>
+KINC_FUNC void kinc_semaphore_init(kinc_semaphore_t *semaphore, int current, int max);
+
+/// <summary>
+/// Destroys a semaphore.
+/// </summary>
+/// <param name="semaphore">The semaphore to destroy</param>
+KINC_FUNC void kinc_semaphore_destroy(kinc_semaphore_t *semaphore);
+
+/// <summary>
+/// Increases the current count of the semaphore, therefore allowing more acquires to succeed.
+/// </summary>
+/// <param name="semaphore">The semaphore to increase the count on</param>
+/// <param name="count">The amount by which the count will be increased</param>
+KINC_FUNC void kinc_semaphore_release(kinc_semaphore_t *semaphore, int count);
+
+/// <summary>
+/// Decreases the count of the semaphore by one. Blocks until it is possible to decrease the count if it already reached zero.
+/// </summary>
+/// <param name="semaphore">The semaphore to acquire</param>
+KINC_FUNC void kinc_semaphore_acquire(kinc_semaphore_t *semaphore);
+
+/// <summary>
+/// Attempts to decrease the count of the semaphore by one.
+/// </summary>
+/// <param name="semaphore">The semaphore to acquire</param>
+/// <param name="timeout">The timeout in seconds after which the function returns if the semaphore-count could not be decreased</param>
+/// <returns>Whether the semaphore-count could be decreased</returns>
+KINC_FUNC bool kinc_semaphore_try_to_acquire(kinc_semaphore_t *semaphore, double timeout);
+
+#ifdef __cplusplus
+}
+#endif