feat(guardStringLengthBetween()): guard string length between.

src/guard/lib/guard-string-length-between.func.ts

@@ -0,0 +1,31 @@
+// Function.
+import { isStringLengthBetween } from '../../is';
+// Type.
+import { AnyString } from '../../type/any-string.type';
+import { ResultCallback } from '../../type/result-callback.type';
+import { StringOfLength } from '../../type/string-of-length.type';
+/**
+ * Guards the value to be `string` or `String` instance of a length between the specified range.
+ * @param value The value of a generic type variable `Type` constrained by `AnyString`, by default of the type captured from itself to
+ * guard.
+ * @param min The **minimum** length of generic type variable `Min` of a given `value`.
+ * @param max The **maximum** length of generic type variable `Max` of a given `value`.
+ * @param callback An optional `ResultCallback` function to handle the result before returns.
+ * @param payload Optional `object` of generic type variable `Payload` is assigned to the `payload` of the provided `callback` function.
+ * @returns The return value is a `boolean` indicating whether the `value` is a `string` type or an instance of `String` of a length between
+ * the specified range.
+ * @angularpackage
+ */
+export const guardStringLengthBetween = <
+  Type extends AnyString,
+  Min extends number,
+  Max extends number,
+  Payload extends object = object
+>(
+  value: Type,
+  min: Min,
+  max: Max,
+  callback?: ResultCallback<Type, { min: Min, max: Max } & Payload>,
+  payload?: Payload
+): value is StringOfLength<Min, Max, Type> =>
+  isStringLengthBetween(value, min, max, callback, payload);