unsafe (Referência de C#)

  • Artigo

A palavra-chave unsafe denota um contexto inseguro, que é necessário para qualquer operação que envolva ponteiros. Para obter mais informações, consulte Código não seguro e ponteiros.

Você pode usar o modificador unsafe na declaração de um tipo ou membro. Toda a extensão textual do tipo ou membro é, portanto, considerada um contexto inseguro. Por exemplo, a seguir está um método declarado com o modificador unsafe:

unsafe static void FastCopy(byte[] src, byte[] dst, int count)
{
    // Unsafe context: can use pointers here.
}

O escopo do contexto inseguro se estende da lista de parâmetros até o final do método, portanto, os ponteiros também podem ser usados na lista de parâmetros:

unsafe static void FastCopy ( byte* ps, byte* pd, int count ) {...}

Você também pode usar um bloco não seguro para habilitar o uso de um código não seguro dentro desse bloco. Por exemplo:

unsafe
{
    // Unsafe context: can use pointers here.
}

Para compilar o código não seguro, você deve especificar a opção do compilador AllowUnsafeBlocks. O código não seguro não é verificável pelo Common Language Runtime.

Exemplo

// compile with: -unsafe
class UnsafeTest
{
    // Unsafe method: takes pointer to int.
    unsafe static void SquarePtrParam(int* p)
    {
        *p *= *p;
    }

    unsafe static void Main()
    {
        int i = 5;
        // Unsafe method: uses address-of operator (&).
        SquarePtrParam(&i);
        Console.WriteLine(i);
    }
}
// Output: 25

Especificação da linguagem C#

Para saber mais, confira código unsafe na Especificação da Linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Confira também