# O que é a função Pandas any() em Python e como ela funciona?

A função `DataFrame.any()` da [biblioteca Pandas do Python](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/python-pandas/) é usada para verificar se pelo menos um valor em um eixo do DataFrame é verdadeiro (*True*).

## Qual é a sintaxe da função Pandas `any()`?

A sintaxe básica da função Pandas `any()` é bem direta e segue este padrão:

```python
DataFrame.any(axis=0, bool_only=None, skipna=True)
```

Nota A função Pandas `DataFrame.any()` é similar à ferramenta `numpy.any()` da popular biblioteca *NumPy* em Python.

### Parâmetros importantes da função Pandas `any()`

A função aceita a inclusão de diversos parâmetros:

<table>
  <thead>
    <tr>
      <th><strong>Parâmetro</strong></th>
      <th><strong>Descrição</strong></th>
      <th><strong>Valor padrão</strong></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`axis`</td>
      <td>Especifica se o método é aplicado às linhas (0 ou `index`) ou colunas (1 ou `columns`)</td>
      <td>0</td>
    </tr>
    <tr>
      <td>`skipna`</td>
      <td>Especifica se os valores NaN (valores ausentes) devem ser ignorados</td>
      <td>`True`</td>
    </tr>
    <tr>
      <td>`bool_only`</td>
      <td>Se verdadeiro (`True`), apenas colunas booleanas serão levadas em consideração</td>
      <td>`False`</td>
    </tr>
  </tbody>
</table>

## Como usar a função Pandas `DataFrame.any()`

### Exemplo 1: Verificar valores `True` nas linhas

A função Pandas `any()` costuma ser usada para verificar se alguma linha do DataFrame contém pelo menos um valor verdadeiro (`True`). Esse é um recurso bastante útil no processo de validação de condições.

```python
import pandas as pd
# Criar um DataFrame com três colunas e três linhas
data = {
    'A': [0, 0, 0],
    'B': [True, False, False],
    'C': [False, False, False]
}
df = pd.DataFrame(data)
# Usar a função Pandas any() para verificar se algum valor nas linhas é verdadeiro
result = df.any(axis=0)
print(result)
```

No código acima, a função Pandas `DataFrame.any()` retorna uma série que mostra que apenas a coluna B contém um valor verdadeiro (`True`). O resultado produzido é o seguinte:

```none
A    False
B    True
C    False
dtype: bool
```

### Exemplo 2: Verificar os valores `True` nas colunas

Assim como no primeiro exemplo, também é possível verificar se alguma coluna contém pelo menos um valor verdadeiro (`True`), usando `axis=1` como parâmetro:

```python
result = df.any(axis=1)
print(result)
```

O resultado mostra que apenas a primeira linha contém um valor verdadeiro (`True`):

```none
0     True
1    False
2    False
dtype: bool
```

Nota Em programação, a indexação sempre começa em 0. É por isso que esse número foi usado para representar a primeira linha no resultado exibido acima.


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/python-pandas-dataframe-any/](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/python-pandas-dataframe-any/) for AI/LLM consumption.