thusfar

Author: bobmagicii

src/Nether/Common/Datastore.php

@@ -802,6 +802,48 @@ public function
 		return FALSE;
 	}
 
+	#[Meta\Date('2025-03-14')]
+	#[Meta\Info('Use a callable to check if the dataset has something.')]
+	public function
+	HasThing(callable $FuncKeyValue):
+	bool {
+
+		$K = NULL;
+		$V = NULL;
+
+		////////
+
+		foreach($this->Data as $K=> $V) {
+			if($FuncKeyValue($K, $V))
+			return TRUE;
+
+			continue;
+		}
+
+		return FALSE;
+	}
+
+	#[Meta\Date('2025-03-14')]
+	#[Meta\Info('Use a callable to find an item in the dataset.')]
+	public function
+	FindThing(callable $FuncKeyValue):
+	?Units\KeyValue {
+
+		$K = NULL;
+		$V = NULL;
+
+		////////
+
+		foreach($this->Data as $K=> $V) {
+			if($FuncKeyValue($K, $V))
+			return new Units\KeyValue($K, $V);
+
+			continue;
+		}
+
+		return NULL;
+	}
+
 	public function
 	IsFirstKey(mixed $Key):
 	bool {

src/Nether/Common/Units/KeyValue.php

@@ -0,0 +1,64 @@
+<?php ##########################################################################
+################################################################################
+
+namespace Nether\Common\Units;
+
+use Nether\Common;
+
+################################################################################
+################################################################################
+
+class KeyValue {
+
+	public string|int
+	$Key;
+
+	public mixed
+	$Value;
+
+	////////////////////////////////////////////////////////////////
+	////////////////////////////////////////////////////////////////
+
+	public function
+	__Construct(string|int $Key, mixed $Value) {
+
+		$this->Key = $Key;
+		$this->Value = $Value;
+
+		return;
+	}
+
+	////////////////////////////////////////////////////////////////
+	////////////////////////////////////////////////////////////////
+
+	static public function
+	FromKeyedPair(array $KV):
+	static {
+
+		if(count($KV) !== 1)
+		throw new Common\Error\FormatInvalid('not a single item array');
+
+		////////
+
+		return new static(key($KV), current($KV));
+	}
+
+	static public function
+	FromFlatPair(array $KV):
+	static {
+
+		if(count($KV) !== 2)
+		throw new Common\Error\FormatInvalid('not a two item array');
+
+		if(!array_key_exists(0, $KV))
+		throw new Common\Error\FormatInvalid('missing key 0');
+
+		if(!array_key_exists(1, $KV))
+		throw new Common\Error\FormatInvalid('missing key 1');
+
+		////////
+
+		return new static($KV[0], $KV[1]);
+	}
+
+};