Méthode fetchone (Python)

.fetchone (): Fille la ligne suivante (observation) à partir du jeu de données actif. Le résultat est un tuple unique ou le type de données Python Aucun après la lecture de la dernière ligne. La valeur Aucun est également renvoyée à la limite de division. Dans ce cas, un appel ultérieur à fetchone extraira le premier cas du groupe scindé suivant.

  • Cette méthode est disponible en mode lecture ou écriture.
  • Chaque élément du tuple renvoyé contient la valeur de données d'une variable spécifique. L'ordre des valeurs de variable dans le tuple est l'ordre spécifié par les valeurs d'index de variable dans l'argument facultatif n de la classe Cursor ou l'ordre du fichier si n est omis. Par exemple, si n= [ 5,2, 7 ] le premier élément de tuple est la valeur de la variable avec la valeur d'index 5, le second est la variable avec la valeur d'index 2 et le troisième est la variable avec la valeur d'index 7.
  • Les valeurs de chaîne sont remplies à droite de la largeur définie de la variable de chaîne.
  • Les valeurs système manquantes sont toujours converties au type de données Python None.
  • Par défaut, les valeurs manquantes de l'utilisateur sont converties au type de données Python Aucun. Vous pouvez utiliser la méthode SetUserMissingInclude pour spécifier que les valeurs manquantes doivent être considérées comme valides.
  • Les valeurs des variables avec des formats d'heure sont renvoyées sous forme d'entiers représentant le nombre de secondes à partir de minuit.
  • Par défaut, les valeurs des variables avec des formats de date ou de date-heure sont renvoyées sous forme d'entiers représentant le nombre de secondes à partir du 14 octobre 1582. Vous pouvez spécifier la conversion des valeurs de ces variables en objets Python datetime.datetime à l'aide de l'argument cvtDates de la fonction spss.Cursor . Pour plus d'informations, voir spss.Cursor Class (Python) .
  • Si une variable de pondération a été définie pour le jeu de données actif, les observations avec des valeurs nulles, négatives ou manquantes pour la variable de pondération sont ignorées lors de l'extraction des données avec fetchone, fetchallou fetchmany. Si vous devez extraire toutes les observations lorsque la pondération est activée, vous pouvez utiliser la classe de fichier.
  • Les méthodes fetchone, fetchallet fetchmany respectent les filtres de casse spécifiés avec les commandes FILTER ou USE .
DATA LIST FREE /var1 var2 var3.
BEGIN DATA
1 2 3
4 5 6
END DATA.
BEGIN PROGRAM.
import spss
dataCursor=spss.Cursor()
firstRow=dataCursor.fetchone()
secondRow=dataCursor.fetchone()
thirdRow=dataCursor.fetchone()
print("First row: ",firstRow)
print("Second row ",secondRow)
print("Third row...there is NO third row: ",thirdRow)
dataCursor.close()
END PROGRAM.

Résultat

First row:  (1.0, 2.0, 3.0)
Second row  (4.0, 5.0, 6.0)
Third row...there is NO third row:  None