summaryrefslogtreecommitdiff
path: root/std/uuid/v5.ts
diff options
context:
space:
mode:
authoraakhtar3 <aakhtar3@users.noreply.github.com>2020-10-01 05:40:40 -0400
committerGitHub <noreply@github.com>2020-10-01 11:40:40 +0200
commitda29ccece5e357b893ce9a5cf145fd6e939c1fb5 (patch)
tree6216d4ab8da666ae7539c1899d4c55de320a67d0 /std/uuid/v5.ts
parent326ccb1095adeb9b8c86d42cc9d9d8566bba2788 (diff)
docs(std/uuid): Added JSdocs for the std/uuid module (#7735)
Diffstat (limited to 'std/uuid/v5.ts')
-rw-r--r--std/uuid/v5.ts10
1 files changed, 10 insertions, 0 deletions
diff --git a/std/uuid/v5.ts b/std/uuid/v5.ts
index 9b4c4111a..64c131c5a 100644
--- a/std/uuid/v5.ts
+++ b/std/uuid/v5.ts
@@ -11,6 +11,10 @@ import { assert } from "../_util/assert.ts";
const UUID_RE =
/^[0-9a-f]{8}-[0-9a-f]{4}-[5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Validates the UUID v5
+ * @param id UUID value
+ */
export function validate(id: string): boolean {
return UUID_RE.test(id);
}
@@ -20,6 +24,12 @@ interface V5Options {
namespace: string | number[];
}
+/**
+ * Generates a RFC4122 v5 UUID (SHA-1 namespace-based)
+ * @param options Can use a namespace and value to creat SHA-1 hash
+ * @param buf Can allow the UUID to be written in byte-form starting at the offset
+ * @param offset Index to start writing on the UUID bytes in buffer
+ */
export function generate(
options: V5Options,
buf?: number[],