mssql_fetch_field
(PHP 4, PHP 5, PECL odbtp >= 1.1.1)
mssql_fetch_field — Liefert Informationen über ein Feld
Beschreibung
object mssql_fetch_field
( resource
$result
[, int $field_offset = -1
] )mssql_fetch_field() wird verwendet, um im Ergebnis einer Anfrage Informationen über Felder zu erhalten.
Parameter-Liste
-
result -
Der Bezeichner des Ergebnisses, das ausgewertet wird. Dieses Ergebnis stammt von einem Aufruf von mssql_query().
-
field_offset -
Der numerische Feld-Offset. Wurde kein Feld-Offset angegeben, liefert diese Funktion das nächste Feld, das noch nicht abgefragt wurde. Der
field_offsetbeginnt bei Null.
Rückgabewerte
Gibt ein Objekt mit Informationen über ein Feld zurück.
Die Eigenschaften dieses Objekts sind:
- name - Feldname. Wenn das Feld das Ergebnis einer Funktion ist, wird diese Eigenschaft auf computed#N gesetzt, wobei #N eine fortlaufende Nummer ist.
- column_source - die Tabelle, zu der das Feld gehört
- max_length - maximale Feldbreite
- numeric - 1, wenn es sich um ein numerisches Feld handelt
- type - der Feldtyp.
Beispiele
Beispiel #1 mssql_fetch_field()-Beispiel
<?php
// Mit MSSQL verbinden und Datenbank auswählen
mssql_connect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php');
// Eine Select-Anfrage an MSSQL senden
$anfrage = mssql_query('SELECT * FROM [php].[dbo].[persons]');
// Eine Tabelle bauen
echo '<h3>Tabellenstruktur für \'persons\'</h3>';
echo '<table border="1">';
// Tabellenkopf
echo '<thead>';
echo '<tr>';
echo '<td>Feldname</td>';
echo '<td>Datentyp</td>';
echo '<td>Max. Länge</td>';
echo '</tr>';
echo '</thead>';
// Alle Felder anzeigen
echo '<tbody>';
for ($i = 0; $i < mssql_num_fields($anfrage); ++$i) {
// Feldinformationen abrufen
$feld = mssql_fetch_field($anfrage, $i);
// Eine Zeile ausgeben
echo '<tr>';
echo '<td>' . $feld->name . '</td>';
echo '<td>' . strtoupper($feld->type) . '</td>';
echo '<td>' . $feld->max_length . '</td>';
echo '</tr>';
}
echo '</tbody>';
echo '</table>';
// Den Ergebnisspeicher freigeben
mssql_free_result($anfrage);
?>