---
title: "GetActorHealth | open.mp"
description: "Obtenha a saúde de um ator."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorHealth
language: pt-BR
---

# GetActorHealth

aviso

Esta função foi adicionada no SA-MP 0.3.7 e não funcionará em versões anteriores!

## Descrição

Obtenha a saúde de um ator.

| Nome | Descrição |
| --- | --- |
| actorid | O ID do ator para obter a saúde. |
| &Float:health | Uma variável flutuante, passada por referência, na qual armazenar a saúde do ator. |

## Retornos

**true** – sucesso

**false** - falha (ou seja, o ator não foi criado).

NOTE: A saúde do ator é armazenada na variável especificada, não no valor de retorno.

## Exemplos

```c
new gMyActor;

public OnGameModeInit()
{
    gMyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // Ator como vendedor em Munição

    SetActorHealth(gMyActor, 100.0);

    new Float:actorHealth;
    GetActorHealth(gMyActor, actorHealth);
    printf("Actor ID %d has %.2f health.", gMyActor, actorHealth);
    return 1;
}
```

## Funções Relacionadas

-   [CreateActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/CreateActor): Crie um ator (estático NPC).
-   [SetActorHealth](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorHealth): Define a saúde de um ator.
-   [SetActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorInvulnerable): Definir ator invulnerável.
-   [IsActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsActorInvulnerable): Verifique se o ator é invulnerável.