enchant_dict_remove — Funktion · PHP-Referenz

Signatur

enchant_dict_remove(EnchantDictionary $dictionary, string $word): void

Beschreibung

enchant_dict_remove fügt ein bestimmtes Wort der sogenannten Ausschlussliste (exclude list) des persönlichen Wörterbuchs hinzu. Dadurch wird das Wort bei zukünftigen Rechtschreibprüfungen als falsch markiert, selbst wenn es zuvor über enchant_dict_add zum persönlichen Wörterbuch hinzugefügt wurde.

Diese Funktion ist nützlich, wenn ein Benutzer ein Wort versehentlich als korrekt markiert hat und diese Entscheidung rückgängig machen möchte. Das Wort wird nicht nur aus dem persönlichen Wörterbuch entfernt, sondern in die Ausschlussliste aufgenommen, sodass es auch dann als falsch erkannt wird, wenn es im Systemwörterbuch vorhanden ist.

Die Änderungen werden in der persönlichen Wörterbuchdatei des Benutzers persistent gespeichert und bleiben über Programmläufe hinaus erhalten. Das entsprechende EnchantDictionary-Objekt muss zuvor über enchant_broker_request_dict oder enchant_broker_request_pwl_dict angefordert worden sein.

Parameter

Name	Typ	Default	Beschreibung
$dictionary Pflicht	EnchantDictionary		Ein gültiges `EnchantDictionary`-Objekt, das über `enchant_broker_request_dict` oder `enchant_broker_request_pwl_dict` erzeugt wurde.
$word Pflicht	string		Das Wort, das der Ausschlussliste hinzugefügt und aus dem persönlichen Wörterbuch entfernt werden soll.

Rückgabewert

Typ

void

Beschreibung

Diese Funktion gibt keinen Wert zurück.

Beispiele

Wort aus persönlichem Wörterbuch entfernen

<?php
// Broker erstellen und Wörterbuch anfordern
$broker = enchant_broker_init();
$dict = enchant_broker_request_dict($broker, 'de_DE');

// Wort zum persönlichen Wörterbuch hinzufügen
enchant_dict_add($dict, 'Testbegriff');

// Prüfen ob das Wort jetzt korrekt ist
if (enchant_dict_check($dict, 'Testbegriff')) {
    echo "'Testbegriff' ist im Wörterbuch vorhanden.\n";
}

// Wort wieder aus dem persönlichen Wörterbuch entfernen und der Ausschlussliste hinzufügen
enchant_dict_remove($dict, 'Testbegriff');

// Prüfen ob das Wort jetzt als falsch erkannt wird
if (!enchant_dict_check($dict, 'Testbegriff')) {
    echo "'Testbegriff' wurde erfolgreich entfernt und ist nun als falsch markiert.\n";
}
?>

'Testbegriff' ist im Wörterbuch vorhanden. 'Testbegriff' wurde erfolgreich entfernt und ist nun als falsch markiert.

Versehentlich hinzugefügtes Wort korrigieren

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

$falschesWort = 'Haust';

// Versehentlich als korrekt markiert
enchant_dict_add($dict, $falschesWort);
echo "Wort hinzugefügt: {$falschesWort}\n";

// Fehler erkannt: Wort wieder entfernen
enchant_dict_remove($dict, $falschesWort);
echo "Wort wurde der Ausschlussliste hinzugefügt: {$falschesWort}\n";

// Rechtschreibprüfung bestätigt Entfernung
$istKorrekt = enchant_dict_check($dict, $falschesWort);
echo $istKorrekt ? "Wort gilt als korrekt.\n" : "Wort gilt nun als falsch.\n";
?>

Wort hinzugefügt: Haust Wort wurde der Ausschlussliste hinzugefügt: Haust Wort gilt nun als falsch.

// Wichtig · Fallstricke

Vor PHP 8.0.0 arbeitete die Enchant-Erweiterung mit Ressourcen statt mit Objekten vom Typ EnchantDictionary. Die Funktion war unter demselben Namen verfügbar, akzeptierte jedoch eine Ressource als erstes Argument.

Die Änderungen durch enchant_dict_remove sind persistent und werden in der persönlichen Wörterbuchdatei des Benutzers gespeichert. Achten Sie darauf, dass der PHP-Prozess Schreibrechte auf die entsprechende Wörterbuchdatei besitzt, damit die Änderungen dauerhaft gespeichert werden können.

Falls das Wort nicht im persönlichen Wörterbuch vorhanden war, aber im Systemwörterbuch existiert, sorgt der Eintrag in der Ausschlussliste dafür, dass es trotzdem als falsch erkannt wird.

Siehe auch

enchant_dict_add enchant_dict_check enchant_dict_is_added enchant_broker_request_dict enchant_broker_request_pwl_dict