Como verificar se um dataframe do pandas está vazio (com exemplo)

Você pode usar a seguinte sintaxe para verificar se um DataFrame do pandas está vazio:

 len ( df.index ) == 0

Esta sintaxe específica verifica se o comprimento da coluna do índice no DataFrame é zero, o que equivale a verificar se todo o DataFrame está vazio.

Se o DataFrame estiver vazio, esta sintaxe retornará True . Caso contrário, retornará False .

Se você deseja imprimir um texto personalizado que informa se um DataFrame está vazio, você pode usar uma função if else simples:

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

O exemplo a seguir mostra como usar essas funções na prática.

Exemplo: verifique se o Pandas DataFrame está vazio

Vamos supor que temos o seguinte DataFrame vazio do pandas:

 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: []

Podemos usar o seguinte código para verificar se o DataFrame do pandas está vazio:

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

True

A função retorna True , o que nos informa que o DataFrame está realmente vazio.

Também poderíamos usar o seguinte código para imprimir um texto personalizado que nos diga se o DataFrame está vazio ou não:

 #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

A saída nos informa que o DataFrame está vazio.

Por outro lado, suponha que temos um DataFrame que não está vazio:

 import pandas as pd

#createDataFrame
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:28 4 12

Podemos usar a função len() para verificar se o DataFrame está vazio:

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

False

A função retorna False , o que nos informa que o DataFrame não está vazio.

E se usarmos uma função if else , podemos retornar uma saída personalizada:

 #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

A saída nos diz que o DataFrame não está vazio.

Recursos adicionais

Os tutoriais a seguir explicam como realizar outras operações comuns em pandas:

Como verificar se a célula está vazia no Pandas DataFrame
Como obter o valor de uma célula no Pandas DataFrame
Como criar um Pandas DataFrame vazio com nomes de colunas