Zum Hauptinhalt springen

c16_selopen

c16_selopen(aConnection : resource) : int​

Selektionspuffer anlegen

Details

Diese Funktion legt einen neuen Selektionspuffer an, über den auf Selektionen und deren Mengen zugegriffen werden kann.

Im Parameter (aConnection) wird das von c16_connect() bereitgestellte Verbindungsobjekt übergeben.

Der erzeugte Deskriptor wird als Resultat zurückgegeben. Ist der Rückgabewert kleiner oder gleich 0 ist ein Fehler aufgetreten. Die Fehlerwerte sind im Abschnitt Fehlerwerte beschrieben.

Beispiel:

$sel = c16_selopen($connection);
if ($sel > 0)
{
  // Selektion lesen
  $res = c16_selread($sel, 1, _SelFirst);
  ...
  c16_selclose($sel);
}

Tritt bei der Verarbeitung ein Fehler auf, wird der Fehlerwert von der Anweisung zurückgegeben. Der Fehler kann ebenfalls mit den Anweisungen c16_error() oder c16_errortext() ermittelt werden. Folgende Fehler können auftreten:

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