Comment vérifier si un DataFrame Pandas est vide (avec exemple)

Vous pouvez utiliser la syntaxe suivante pour vérifier si un DataFrame pandas est vide :

len(df.index) == 0

Cette syntaxe particulière vérifie si la longueur de la colonne d’index dans le DataFrame est égale à zéro, ce qui équivaut à vérifier si l’intégralité du DataFrame est vide.

Si le DataFrame est vide, cette syntaxe renverra True . Sinon, il renverra False .

Si vous souhaitez imprimer un texte personnalisé qui vous indique si un DataFrame est vide, vous pouvez utiliser une simple fonction if else :

if len(df.index) == 0:
    print('df is empty')
else:
    print('df is not empty')

L’exemple suivant montre comment utiliser ces fonctions dans la pratique.

Exemple : Vérifiez si Pandas DataFrame est vide

Supposons que nous ayons le DataFrame pandas vide suivant :

import pandas as pd

#create empty DataFrame
df = pd.DataFrame(columns=['A', 'B', 'C', 'D', 'E'])

#view DataFrame
print(df)

Empty DataFrame
Columns: [A, B, C, D, E]
Index: []

Nous pouvons utiliser le code suivant pour vérifier si le DataFrame pandas est vide :

#check if DataFrame is empty
len(df.index) == 0

True

La fonction renvoie True , ce qui nous indique que le DataFrame est bien vide.

Nous pourrions également utiliser le code suivant pour imprimer un texte personnalisé qui nous indique si le DataFrame est vide ou non :

#check if DataFrame is empty and return output
if len(df.index) == 0:
    print('df is empty')
else:
    print('df is not empty')

df is empty

La sortie nous indique que le DataFrame est vide.

En revanche, supposons que nous ayons un DataFrame qui n’est pas vide :

import pandas as pd

#create DataFrame
df_full = pd.DataFrame({'team': ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H'],
                   'points': [18, 22, 19, 14, 14, 11, 20, 28],
                   'assists': [5, 7, 7, 9, 12, 9, 9, 4],
                   'rebounds': [11, 8, 10, 6, 6, 5, 9, 12]})

#view DataFrame
print(df_full)

  team  points  assists  rebounds
0    A      18        5        11
1    B      22        7         8
2    C      19        7        10
3    D      14        9         6
4    E      14       12         6
5    F      11        9         5
6    G      20        9         9
7    H      28        4        12

Nous pouvons utiliser la fonction len() pour vérifier si le DataFrame est vide :

#check if DataFrame is empty
len(df_full.index) == 0

False

La fonction renvoie False , ce qui nous indique que le DataFrame n’est pas vide.

Et si nous utilisons une fonction if else , nous pouvons renvoyer une sortie personnalisée :

#check if DataFrame is empty and return output
if len(df_full.index) == 0:
    print('df is empty')
else:
    print('df is not empty')

df is not empty

La sortie nous indique que le DataFrame n’est pas vide.

Ressources additionnelles

Les didacticiels suivants expliquent comment effectuer d’autres opérations courantes dans les pandas :

Comment vérifier si la cellule est vide dans Pandas DataFrame
Comment obtenir la valeur d’une cellule dans Pandas DataFrame
Comment créer un DataFrame Pandas vide avec des noms de colonnes