mssql_fetch_field

(PHP 4, PHP 5, PECL odbtp >= 1.1.1)

mssql_fetch_field — Lit les informations sur le champ

Avertissement

Cette fonction a été SUPPRIMÉE à partir de PHP 7.0.0.

Les alternatives à cette fonction incluent :

Description

mssql_fetch_field ( resource $result [, int $field_offset = -1 ] ) : object

mssql_fetch_field() sert à lire des informations spécifiques à un champ, dans un résultat de requête.

Liste de paramètres

result

La ressource de résultats à évaluer. Ce résultat provient d'un appel à la fonction mssql_query().

field_offset

La position numérique du champ. Si l'offset du champ field_offset n'est pas précisé, le prochain champ sera analysé. field_offset commence à 0.

Valeurs de retour

Retourne un objet contenant les informations du champ.

Les propriétés de l'objet sont :

  • "name" : nom de la colonne. Si la colonne est le résultat d'une fonction, le nom de la colonne sera computed#N, où #N est un numéro de série.
  • "column_source" : le nom de la table d'où la colonne est originaire.
  • "max_length" : taille maximale de la colonne.
  • "numeric" : 1 si la colonne est numérique.
  • "type" : le type de la colonne.

Exemples

Exemple #1 Exemple avec mssql_fetch_field()

<?php
// Connexion à MSSQL et sélection de la base de données
mssql_connect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php');

// Envoie une requête Select à MSSQL
$query = mssql_query('SELECT * FROM [php].[dbo].[persons]');

// Construit la table
echo '<h3>Table structure for \'persons\'</h3>';
echo '<table border="1">';

// Entête de table
echo '<thead>';
echo '<tr>';
echo '<td>Field name</td>';
echo '<td>Data type</td>';
echo '<td>Max length</td>';
echo '</tr>';
echo '</thead>';

// Champs
echo '<tbody>';

for ($i = 0; $i < mssql_num_fields($query); ++$i) {
    // Lecture des informations des champs
    $field = mssql_fetch_field($query, $i);

    // Affichage de la ligne
    echo '<tr>';
    echo '<td>' . $field->name . '</td>';
    echo '<td>' . strtoupper($field->type) . '</td>';
    echo '<td>' . $field->max_length . '</td>';
    echo '</tr>';
}

echo '</tbody>';
echo '</table>';

// Libération des ressources
mssql_free_result($query);
?>

Voir aussi