Zum Hauptinhalt springen

c16_fldget

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

Feldpuffer in Array übertragen

Details

Mit dieser Anweisung wird der Inhalt des Datensatzpuffers in das Array übertragen. Anschließend kann der Inhalt des Arrays ausgewertet 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.

Beispiel:

Das folgende Beispiel gibt alle Datensätze einer Datei aus. Ausgegeben werden nur die Felder "CST.iNumber" und "CST.aDescription", 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('ART.iNummer' => 0, 'ART.aBezeichnung' => '');

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>';

Ü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.