assert options()

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

assert_options

assert_options — Ställ in/hämta olika assert-flaggor

Varning: Denna funktion är föråldrad sedan PHP 8.3.0. Användningen av denna funktion avrådes starkt.

Beskrivning

assert_options(int $option, mixed $value = ?): mixed Ställ in olika kontrollalternativ för assert() eller fråga bara om deras aktuella inställningar.

Notering: Användning av assert_options() avrådes till förmån för att ställa in och hämta php.ini-direktiv som zend.assertions och assert.exception med ini_set() respektive ini_get().

Parametrar

option
Alternativ för assert
Alternativ INI-inställning Standardvärde Beskrivning
ASSERT_ACTIVE assert.active 1 Aktivera assert()-utvärdering
ASSERT_EXCEPTION assert.exception 1 Kastar ett AssertionError för varje misslyckat påstående
ASSERT_WARNING assert.warning 1 Utfärdar en E_WARNING för varje misslyckat påstående
ASSERT_BAIL assert.bail 0 Avslutar körning vid misslyckade påståenden
ASSERT_QUIET_EVAL assert.quiet_eval 0 Inaktiverar error_reporting under utvärdering av påståendeuttryck. Borttagen från och med PHP 8.0.0.
ASSERT_CALLBACK assert.callback (null) Callback att anropa vid misslyckade påståenden
value
Ett valfritt nytt värde för alternativet.

Callback-funktionen som anges via ASSERT_CALLBACK eller assert.callback bör ha följande signatur:

assert_callback(
    string $file,
    int $line,
    ?string $assertion,
    string $description = ?
): void
  • file - Filen där assert() har anropats.
  • line - Linjen där assert() har anropats.
  • assertion - Före PHP 8.0.0, påståendet som skickades till assert(), men endast när påståendet ges som en sträng. (Om påståendet är ett booleskt villkor, kommer denna parameter att vara en tom sträng.) Från och med PHP 8.0.0 är denna parameter alltid null.
  • description - Beskrivningen som skickades till assert().

Om du skickar en tom sträng som value återställs assert-callbacken.

Returvärden

Returnerar den ursprungliga inställningen för ett alternativ.

Fel/Undantag

Om option inte är ett giltigt alternativ, kastas ett ValueError.

Ändringslogg

Version Beskrivning
8.3.0 assert_option() är nu föråldrad.
8.0.0 Om option inte är ett giltigt alternativ, kastas nu ett ValueError. Tidigare returnerades false.

Exempel

Exempel #1 assert_options() exempel

<?php
// Detta är vår funktion för att hantera
// misslyckanden i assert
function assert_failure($file, $line, $assertion, $message)
{
    echo "Påståendet $assertion i $file på rad $line har misslyckats: $message";
}

// Detta är vår testfunktion
function test_assert($parameter)
{
    assert(is_bool($parameter));
}

// Ställ in våra assert-alternativ
assert_options(ASSERT_ACTIVE,   true);
assert_options(ASSERT_BAIL,     true);
assert_options(ASSERT_WARNING,  false);
assert_options(ASSERT_CALLBACK, 'assert_failure');

// Gör ett påstående som skulle misslyckas
test_assert(1);

// Detta nås aldrig på grund av att ASSERT_BAIL 
// är true
echo 'Nås aldrig';
?>

Se även

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.assert-options.php

PHP Funktioner Funktionsreferens


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp och Datorservice som har sponsrat Linux.se med webserver.