O que você precisa saber sobre estado antes de ler os exemplos
A maioria dos tutoriais começa definindo verbo de estado como aquele que indica condição permanente. Isso é impreciso e gera confusão na hora da implementação. Na prática, você lida com operações que não mudam o estado do sistema ou dos dados após sua execução. A diferença entre um verbo de ação e um verbo de estado é técnica, não semântica. O compilador ou o framework é que interpretam a intenção.
verbo de estado exemplos no dia a dia
Vou listar alguns casos comuns, mas a ordem não segue a lógica tradicional. Primeiro o método, depois a classificação. Para verificar a existência de um registro, use exists(). Para buscar um dado sem alterá-lo, use get() ou find(). Para calcular uma média a partir de um conjunto, use average(). Todos esses são verbos de estado porque o objeto de origem permanece inalterado após a chamada. Um exemplo concreto em Python com pandas:
df.filter(items=['coluna_a']) Isso retorna um novo DataFrame. O original df não é modificado. O mesmo vale para df.describe(), que gera estatísticas sem escrever nada no dataframe. Se você passar inplace=True em métodos que realmente alteram, como drop() ou fillna(), deixa de ser verbo de estado. A distinção importa quando você está depurando efeitos colaterais inesperados.
Eu estava migrando uma lógica de cálculo de score para outra base e recebi um erro de inconsistência de dados. O método calculate_score() parecia ser apenas leitura, mas internamente atualizava um cache global. Descobri que o framework de machine learning que usei tinha um model.fit() com side-effect de gravação de métricas. A solução foi isolar a etapa de cálculo em uma função pura, sem acesso ao contexto da sessão, e usar copy.deepcopy() nos dados de entrada. Isso cortou o tempo de debugging de cerca de 4 horas para 20 minutos, porque eliminei a dependência de estado mutável.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Por que a separação não é sempre óbvia
Algumas linguagens tratam certos métodos como estado mesmo quando há operação por trás. O len() em Python parece inofensivo, mas em estruturas customizadas pode disparar um cache ou incrementar um contador de acesso. Em Java, o método String.hashCode() pode ser memorizado após a primeira chamada. Você precisa ler a documentação específica da classe, não a assinatura geral. Outro ponto negligenciado: testes de integração. Quando você escreve um teste que chama um verbo de estado, precisa garantir que o ambiente isolado seja restaurado entre os casos. Senão, o resultado do caso B depende do caso A. Eu vi isso acontecer com frequência em projetos que usam bancos em memória para testes. Cada teste que assume estado limpo introduz uma falha intermitente difícil de rastrear. A correção é usar factories que criam novos objetos de estado a cada teste, nunca reutilizar instâncias globais.
Limitações e quando não usar
Verbo de estado não é uma solução para todos os cenários. Se o seu sistema precisa de alta responsividade e os cálculos são complexos, manter tudo como puro pode gerar overhead desnecessário. Nesse caso, considere usar uma camada de cache com invalidação explícita. O custo é maior complexidade inicial, mas a performance melhora significativamente em cargas repetitivas. Se você está trabalhando com APIs REST, a convenção diz que GET deve ser idempotente e seguro. Isso se alinha ao conceito de verbo de estado. No entanto, alguns desenvolvedores usam GET para operações que realmente modificam dados. Isso quebra a expectativa e causa problemas de cache e de reconexão automática. Sempre valide se os seus endpoints seguem a semântica correta antes de expô-los.
Abaixo, mais exemplos rápidos para consultar:
list.contains(item)– verifica presença sem alterar a lista.map.get(key)– recupera valor sem modificar o mapa.array.slice(start, end)– retorna fatia sem mudar o array original.math.sqrt(number)– cálculo matemático puro.
Em SQL, funções como COUNT(), AVG() e MAX() são verbos de estado naturais. Elas não executam DML. Já UPDATE, INSERT e DELETE são verbos de ação, claramente. A linha tênue aparece em triggers e views materializadas, que podem parecer leitura mas têm efeito lateral. Se precisar de uma referência prática, procure por guias que mostrem a diferença entre métodos mutáveis e imutáveis na linguagem que você usa. Isso costuma ser mais direto do que tentar deduzir pela nomeação dos métodos. A nomeação é enganosa com frequência.
