Zum Hauptinhalt springen

c16_fldset

c16_fldset(aConnection : resource, aFieldArray : array) : int​

Array-Inhalt in Feldpuffer übertragen

Details

Mit dieser Anweisung wird der Inhalt des Arrays in die Feldpuffer der Datenbank übertragen. Anschließend kann eine der Datensatz-Funktionen ausgeführt werden.

Im Parameter (aConnection) wird das von c16_connect() bereitgestellte Verbindungsobjekt übergeben. Das in (aFieldArray) übergebene Array kann ein assoziatives oder indiziertes Array sein. Die Schlüsselwerte des Arrays definieren dabei entweder den Namen des Feldes oder die Nummer des Feldes.

Sollen Werte für Felder definiert werden, deren Datentypen nicht in PHP existieren, müssen diese Werte in einer Zeichenkette im CONZEPT 16 eigenen Format angegeben werden. Ein Datums-Wert wird in der Form 'dd.mm.yyyy', ein Zeitwert in der Form 'hh.mm.ss' angegeben. Bei der Übergabe von Werten in ein Feld vom Typ bigint werden alle nicht-numerischen Zeichen innerhalb der Zeichenkette ignoriert. Bei decimal muss der Punkt als Dezimal-Trennzeichen verwendet werden.

Beispiel:

Das folgende Beispiel gibt alle Datensätze einer Datei aus. Ausgegeben werden nur die Felder fiArtNumber und faArtName, die in dem Array angegeben werden.

info

Damit die Konstanten verwendet werden können, muss die Datei php_c16_def.php mit der Anweisung include('php_c16_def.php'); eingebunden werden.

echo '<table>';

// define array with fields
$fields = array('fiArtNumber' => 0, 'faArtName' => '');

c16_fldset($connection, $fields);

// read first record
$erg = c16_recread($connection,1,1,_RecFirst);

while ($erg >= _rOk && $erg < _rNoRec)
{
  // get field values in new result-array
  c16_fldget($connection, $fields);

  echo '<tr>';
  foreach ($fields as $key => $value)
    echo '<td>' . $value . '</td>';
  echo '</tr>';

  // read next record
  $erg = c16_recread($connection,1,1,_RecNext);
}
echo '</table>';

// Zuweisung von Datum und Zeit
$fields = array('fdCstLastContact' => '27.04.2006', 'ftCstLastContact' => '12.15.00');
c16_fldset($connection, $fields);

Über den Rückgabewert der Funktion kann ermittelt werden, ob die Funktion korrekt ausgeführt wurde. Der Rückgabewert kann mit folgenden Konstanten verglichen werden:

  • C16_OK (0): Kein Fehler aufgetreten.
  • C16ERR_ARGS_FORMAT (-251): Anzahl der Argumente oder Typ eines Arguments ungültig.
  • C16ERR_ARGS_CONNECTION (-254): Kein Verbindungsobjekt in aConnection übergeben.
  • C16ERR_NO_FLD (-603): Feld nicht vorhanden.