/**
* @param string $tag
* @param array(string => string) $attributes [optional]
* @param mixed[] $contents [optional]
* @return X
*/
function df_xml_node($tag, array $attributes = [], array $contents = [])
{
/** @var X $result */
$result = df_xml_parse(df_sprintf('<%s/>', $tag));
$result->addAttributes($attributes);
$result->importArray($contents);
return $result;
}
/**
* @override
* @return string
*/
protected function getExpectedTypeInGenitiveCase()
{
return df_sprintf('объекта класса «%s»', $this->getClassExpected());
}
/**
* 2016-07-12
* @param string $url
* @param string|E $message [optional]
* @return void
* @throws E|LE
*/
function df_assert_https($url, $message = null)
{
if (df_enable_assertions() && !df_check_https($url)) {
df_error($message ? $message : df_sprintf('The URL «%s» is invalid, because the system expects an URL which starts with «https://».', $url));
}
}
/**
* @param string $resultValue
* @param int $stackLevel [optional]
* @return void
* @throws DFE
*/
function df_result_string($resultValue, $stackLevel = 0)
{
if (df_enable_assertions()) {
// Раньше тут стояло:
// Q::assertResultIsString($resultValue, $stackLevel + 1)
if (!is_string($resultValue)) {
Q::raiseErrorResult($validatorClass = __FUNCTION__, $messages = [df_sprintf('Требуется строка, но вместо неё получена переменная типа «%s».', gettype($resultValue))], $stackLevel + 1);
}
}
}
/**
* @param mixed[] $args
* @return string
*/
function df_format(...$args)
{
$args = df_args($args);
/** @var string $result */
$result = null;
/** @var int $count */
$count = count($args);
df_assert_gt0($count);
switch ($count) {
case 1:
$result = $args[0];
break;
case 2:
/** @var mixed $params */
$params = $args[1];
if (is_array($params)) {
$result = strtr($args[0], $params);
}
break;
}
return !is_null($result) ? $result : df_sprintf($args);
}