enchant_dict_is_in_session — Funktion · PHP-Referenz

Signatur

enchant_dict_is_in_session(EnchantDictionary $dictionary, string $word): bool

Beschreibung

enchant_dict_is_in_session() ist ein Alias der Funktion enchant_dict_is_added() und prüft, ob ein bestimmtes Wort während der aktuellen Sitzung zu einem Enchant-Wörterbuch hinzugefügt wurde. Wörter, die per enchant_dict_add() zur Sitzung hinzugefügt wurden, werden von dieser Funktion erkannt.

Die Funktion ist nützlich, wenn man sicherstellen möchte, dass ein Wort nicht erneut zur Sitzungswortliste hinzugefügt wird. Sie unterscheidet zwischen dauerhaft im Wörterbuch gespeicherten Wörtern und solchen, die nur für die Laufzeit der aktuellen Sitzung gelten.

Da diese Funktion ein Alias ist, verhält sie sich identisch zu enchant_dict_is_added(). In modernem Code empfiehlt sich die Verwendung der kanonischen Funktion enchant_dict_is_added(), da Aliase in zukünftigen PHP-Versionen entfernt werden könnten.

Parameter

Name	Typ	Default	Beschreibung
$dictionary Pflicht	EnchantDictionary		Ein gültiges `EnchantDictionary`-Objekt, das zuvor mit `enchant_broker_request_dict()` oder `enchant_broker_request_pwl_dict()` erzeugt wurde.
$word Pflicht	string		Das zu prüfende Wort als Zeichenkette.

Rückgabewert

Typ

bool

Beschreibung

Gibt true zurück, wenn das Wort in der aktuellen Sitzung zum Wörterbuch hinzugefügt wurde, andernfalls false.

Beispiele

Prüfen, ob ein Wort in der Sitzung vorhanden ist

<?php
$broker = enchant_broker_init();
$dict = enchant_broker_request_dict($broker, 'de_DE');

$word = 'Programmierung';

// Wort zur Sitzung hinzufügen
enchant_dict_add($dict, $word);

// Prüfen, ob das Wort in der Sitzung vorhanden ist
if (enchant_dict_is_in_session($dict, $word)) {
    echo "Das Wort '{$word}' wurde in dieser Sitzung hinzugefügt.";
} else {
    echo "Das Wort '{$word}' ist nicht in der Sitzung.";
}

enchant_broker_free($broker);

Das Wort 'Programmierung' wurde in dieser Sitzung hinzugefügt.

Doppeltes Hinzufügen eines Wortes vermeiden

<?php
$broker = enchant_broker_init();
$dict = enchant_broker_request_dict($broker, 'de_DE');

$words = ['Testbegriff', 'Beispielwort', 'Testbegriff'];

foreach ($words as $word) {
    if (!enchant_dict_is_in_session($dict, $word)) {
        enchant_dict_add($dict, $word);
        echo "Wort '{$word}' zur Sitzung hinzugefügt.\n";
    } else {
        echo "Wort '{$word}' ist bereits in der Sitzung vorhanden.\n";
    }
}

enchant_broker_free($broker);

Wort 'Testbegriff' zur Sitzung hinzugefügt. Wort 'Beispielwort' zur Sitzung hinzugefügt. Wort 'Testbegriff' ist bereits in der Sitzung vorhanden.

// Wichtig · Fallstricke

Alias-Hinweis: enchant_dict_is_in_session() ist ein Alias von enchant_dict_is_added(). Es wird empfohlen, in neuem Code stets enchant_dict_is_added() zu verwenden, da Aliase in zukünftigen PHP-Versionen ohne Vorwarnung entfernt werden können.

Ab PHP 8.0 erwartet der erste Parameter ein EnchantDictionary-Objekt anstelle einer Ressource, wie es in PHP 7.x und früher der Fall war.

Siehe auch

enchant_dict_is_added enchant_dict_add enchant_broker_request_dict enchant_dict_check