---
title: "setproperty | open.mp"
description: "Adicione uma nova propriedade ou altere uma propriedade existente."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/setproperty
language: pt-BR
---

# setproperty

## Descrição

Adicione uma nova propriedade ou altere uma propriedade existente.

| Nome | Descrição |
| --- | --- |
| id | A máquina virtual a ser usada, você deve manter este zero. _(opcional=0)_ |
| name\[\] | Usado em combinação com valor ao armazenar números inteiros; não use isso se quiser armazenar uma string. |
| valor | O valor inteiro a ser armazenado ou o ID exclusivo da propriedade, se estiver armazenando uma string. Use a função hash para calculá-lo a partir de uma string. _(opcional=célulamin)_ |
| string\[\] | O valor da propriedade, como uma string. Não use isso se quiser armazenar um número inteiro. |

## Retornos

Esta função não retorna nenhum valor específico.

## Exemplos

```c
setproperty(.name = "MyInteger", .value = 42);

new value = getproperty(.name = "MyInteger");
printf("Value that was stored is: %d", value);
```

```c
setproperty(0, "", 123984334, ":)");

new value[4];
getproperty(0, "", 123984334, value);
strunpack(value, value, sizeof(value)); // precisamos descompactar a string primeiro
print(value);

//deveria imprimir:)
```

```c
setproperty(.value = 123984334, .string = ":)");

// O resto é igual ao anterior.
```

## Notas

dica

Recomenda-se utilizar o plugin PVars/SVars ou GVar no lugar desses nativos por serem muito lentos.

## Funções Relacionadas

-   [getproperty](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/getproperty): obtém o valor de uma propriedade.
-   [deleteproperty](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/deleteproperty): Exclui uma propriedade.
-   [existproperty](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/existproperty): Verifica se existe uma propriedade.