Documentation du code /trunk/inc/classes/class.recordset.php

Classe recordset

Cette classe permet de manipuler des données entrées dans un tableaux multilignes et multicolonnes. La classe connection renvoie des recordsets comme résultat de requêtes.

Paramètres

• arry_data - Tableau contenant les données
• int_index - Emplacement du curseur
• int_row_count - Nombre d'enregistrements
• int_col_count - Nombre de colonnes
• fetch_index - Indice de déplacement utilisé localement

Méthodes

recordset

void recordset($data)

Paramètres

• data - Tableau contenant les données

Constructeur. Cette méthode initialise le recordset. $data est un tableau de plusieurs lignes et colones.

Par exemple :

<?php
$d = array(
array('f1' => 'v01', 'f2' => 'v02'),
array('f1' => 'v11', 'f2' => 'v12'),
array('f1' => 'v21', 'f2' => 'v22')
);
$rs = new recordset($d);

while ($rs->fetch()) {
echo $rs->f('f1').' - '.$rs->f('f2').'<br />';
}
?>

field

string field($c)

Paramètres

• c - Nom ou numéro du champ

Renvoie la valeur d'un champ donné, pour la ligne courante.

f

string f($c)

Paramètres

• c - Nom ou numéro du champ

Alias de la méthode field.

setField

void setField($c, $v)

Paramètres

• c - Nom du champ
• v - Valeur du champ

Change la valeur d'un champ donné à la ligne courante.

moveStart

boolean moveStart()

Remet le curseur à la première ligne des données et renvoie vrai.

moveEnd

boolean moveEnd()

Positionne le curseur à la dernière ligne des données et renvoie vrai.

moveNext

boolean moveNext()

Déplace le curseur d'un cran si possible et renvoie vrai. Si le curseur est à la fin du tableau, renvoie false.

movePrev

boolean movePrev()

Déplace le curseur d'un cran dans le sens inverse si possible et renvoie vrai. Si le curseur est au début du tableau, renvoie false.

move

boolean move($index)

Paramètres

• index - Indice

Positionne le curseur à l'indice donné par $index. Si l'indice n'existe pas, renvoie false.

fetch

boolean fetch()

Déplace le cuseur d'un cran et renvoie vrai tant que celui ci n'est pas positionné à la fin du tableau. La fonction démarre toujours du premier élément du tableau. Elle a pour vocation à être utilisée dans une boucle de type while (voir le premier exemple).

BOF

boolean BOF()

Indique si le curseur est au début du tableau.

EOF

boolean EOF()

Indique si le curseur est à la fin du tableau.

isEmpty

boolean isEmpty()

Indique si le tableau de données est vide.

getData

array getData()

Renvoie le tableau de données.

nbRow

integer nbRow()

Renvoie le nombre de lignes du tableau.