Funktion "update data()"

Aus Limbas Wiki

Wechseln zu: Navigation, Suche

<-- zurück zu Admin-Dokumentation / <-- zurück zur Hauptseite


bool update_data(array $update, numeric $typ=null, array $relation=null, bool $nometa=null);

Funktion zum Ändern von Datensätzen (./limbas_src/gtab/gtab.lib)

Parameter:

$update

→ Durch gültige Einstellungen im $update-Array lassen sich die Inhalte beliebig vieler Tabellenfelder aus beliebig vielen Tabellen mit einem Funktionsaufruf in der Datenbank verändern. Für jedes zu verändernde Tabellenfeld ist ein Array-Element notwendig. Das Tabellenfeld wird dabei eindeutig im Index des Array-Elements spezifiziert, der neue Tabellenfeld-Inhalt ist der Wert des Array-Elements.

$update = array();
$update["$tableID_1,$fieldID_1,$datasetID_1"] = $value_1;
$update["$tableID_2,$fieldID_2,$datasetID_2"] = $value_2;
.
.
.
$update["$tableID_n,$fieldID_n,$datasetID_n"] = $value_n;

Dabei sind die folgenden Variablen durch entsprechende Werte zu ersetzen:

  • $tableID_1, $tableID_2, ..., $tableID_n: Tabellen-ID des Feldes, dessen Inhalt verändert werden soll.
  • $fieldID_1, $fieldID_2, ..., $fieldID_n: Feld-ID des Feldes, dessen Inhalt verändert werden soll.
  • $datasetID_1, $datasetID_2, ..., $datasetID_n: Datensatz-ID des Feldes, dessen Inhalt verändert werden soll.
  • $value_1, $value_2, ..., $value_n: Neuer Inhalt für das spezifizierte Tabellenfeld

$typ

$relation

$nometa

Rückgabewert:

→ true: Die Änderungen wurden erfolgreich in der Datenbank übernommen. Dabei ist jedoch zu berücksichtigen, dass mögliche ungültige Einstellungen im $update-Array vor dem eigentlichen Datenbank-Update ausgefiltert werden.

→ false: Beim Ändern der Daten in der Datenbank ist ein Fehler aufgetreten.