<?php
/**
 * ZN PHP Web Framework
 * 
 * "Simplicity is the ultimate sophistication." ~ Da Vinci
 * 
 * @package ZN
 * @license MIT [http://opensource.org/licenses/MIT]
 * @author  Ozan UYKUN [ozan@znframework.com]
 */

/**
 * Once
 * 
 * @param string   $key
 * @param callable $data
 * 
 * @return mixed
 */
function once(string $key, callable $data)
{
    if( ! isset($GLOBALS[$key]) )
    {
        $GLOBALS[$key] = $data($key);
    }

    return $GLOBALS[$key] ?? NULL;
}

/**
 * Data length
 * 
 * @param mixed
 * 
 * @return int
 */
function length($data) : int
{
    if( is_scalar($data) )
    {
        return strlen($data);
    }
    
    return count((array) $data);
}

/**
 * Against
 * 
 * Returns the value based on the key matching the parameter.
 * 
 * @param mixed $data
 * @param array $match
 * 
 * @return mixed
 */
function against($data, array $match)
{
    $match = ZN\Datatype::multikey($match);

    $return = $match[$data] ?? $match['default'] ?? false;

    if( is_callable($return) )
    {
        return $return();
    }

    return $return;
}

/**
 * CSRFInput
 * 
 * Generates a 32-character random key. And it transfers it to the form hidden object.
 * 
 * @param void
 * 
 * @return string
 * 
 */
function CSRFInput()
{
    ZN\Security::createCSRFTokenKey();

    return ZN\Singleton::class('ZN\Hypertext\Form')->hidden('token', ZN\Security::getCSRFTokenKey());
}

/**
 * output
 * 
 * Produces formatted output.
 * 
 * @param mixed $data
 * @param array $settings = NULL
 * @param bool  $content  = false
 * 
 * @return mixed
 */
function output($data, ?array $settings = NULL, bool $content = false)
{
    return ZN\Output::display($data, $settings, $content);
}

/**
 * redirect
 * 
 * Routes to the specified URI or URL.
 * 
 * @param string $url  = NULL
 * @param int    $time = 0
 * @param array  $data = NULL
 * @param bool   $exit = true
 * 
 * @return void
 */
function redirect(?string $url = NULL, int $time = 0, ?array $data = NULL, bool $exit = true)
{
    ZN\Response::redirect($url, $time, $data, $exit);
}

/**
 * Get data.
 * 
 * @param string $string
 * @param array  $data   = []
 * @param array  $config = []
 * 
 * @return string
 */
function wizard(string $string, array $data = [], array $config = []) : string
{
    return ZN\Wizard::data($string, $data, $config);
}