typeof

diff --git a/lib/functions.php b/lib/functions.php
index 9e82d7200aef3ee44f6ca068bb29e6135f873874..9776da9b696f7c719b05b676c970c69e092e5fc0 100644 (file)
--- a/lib/functions.php
+++ b/lib/functions.php
@@ -1,7 +1,31 @@
 <?php
 
+namespace seekat;
+
+/**
+ * Generate a human readable represenation of a variable
+ * @param mixed $arg
+ * @param bool $export whether to var_export the $arg
+ * @return string
+ */
+function typeof($arg, $export = false) {
+       $type = (is_object($arg)
+               ? "instance of ".get_class($arg)
+               : gettype($arg)
+       );
+       if ($export) {
+               $type .= ": ".var_export($arg, true);
+       }
+       return $type;
+}
+
 namespace seekat\Exception;
 
+/**
+ * Canonicalize an error message from a string or Exception
+ * @param string|Exception $error
+ * @return string
+ */
 function message(&$error) : string {
        if ($error instanceof \Throwable) {
                $message = $error->getMessage();