sesam_diagnostic

Description

Returns an associative array of status and return codes for the last SQL query/statement/command. Elements of the array are:

In the following example, a syntax error (E SEW42AE ILLEGAL CHARACTER) is displayed by including the offending SQL statement and pointing to the error location:

例子 1. Displaying SESAM error messages with error position <?php // Function which prints a formatted error message, // displaying a pointer to the syntax error in the // SQL statement function PrintReturncode($exec_str) {    $err = Sesam_Diagnostic();    $colspan=4; // 4 cols for: sqlstate, errlin, errcol, rowcount    if ($err["errlin"] == -1)        --$colspan;    if ($err["errcol"] == -1)        --$colspan;    if ($err["rowcount"] == 0)        --$colspan;    echo "<table border=\"1\">\n";    echo "<tr><th colspan=\"" . $colspan . "\"><span class=\"spanred\">ERROR:</span> ".          htmlspecialchars($err["errmsg"]) . "</th></tr>\n";    if ($err["errcol"] >= 0) {        echo "<tr><td colspan=\"" . $colspan . "\"><pre>\n";        $errstmt = $exec_str . "\n";        for ($lin=0; $errstmt != ""; ++$lin) {            if ($lin != $err["errlin"]) { // $lin is less or greater than errlin                if (!($i = strchr($errstmt, "\n")))                    $i = "";                $line = substr ($errstmt, 0, strlen($errstmt)-strlen($i)+1);                $errstmt = substr($i, 1);                if ($line != "\n")                    echo htmlspecialchars($line);            } else {                if (! ($i = strchr ($errstmt, "\n")))                    $i = "";                $line = substr ($errstmt, 0, strlen ($errstmt)-strlen($i)+1);                $errstmt = substr($i, 1);                for ($col=0; $col < $err["errcol"]; ++$col) {                    echo (substr($line, $col, 1) == "\t") ? "\t" : ".";                }                echo "<span class=\"spanred\">\\</span>\n";                echo "<span class=\"normal\">" . htmlspecialchars($line) . "</span>";                for ($col=0; $col < $err["errcol"]; ++$col) {                    echo (substr ($line, $col, 1) == "\t") ? "\t" : ".";                }                echo "<span class=\"spanred\">/</span>\n";            }        }        echo "</pre></td></tr>\n";    }    echo "<tr>\n";    echo " <td>sqlstate=" . $err["sqlstate"] . "</td>\n";    if ($err["errlin"] != -1)        echo " <td>errlin=" . $err["errlin"] . "</td>\n";    if ($err["errcol"] != -1)        echo " <td>errcol=" . $err["errcol"] . "</td>\n";    if ($err["rowcount"] != 0)          echo " <td>rowcount=" . $err["rowcount"] . "</td>\n";    echo "</tr>\n";    echo "</table>\n"; } if (!sesam_connect ("mycatalog", "phoneno", "otto"))   die ("cannot connect"); $stmt = "SELECT * FROM phone\n" .        " WHERE@ LASTNAME='KRAEMER'\n" .        " ORDER BY FIRSTNAME"; if (!($result = sesam_query ($stmt)))    PrintReturncode ($stmt); ?>

See also: sesam_errormsg() for simple access to the error string only