Conversion.Int Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve a parte inteira de um número.

Sobrecargas

Name	Description
Int(Decimal)	Devolve a parte inteira de um número.
Int(Double)	Devolve a parte inteira de um número.
Int(Int16)	Devolve a parte inteira de um número.
Int(Int32)	Devolve a parte inteira de um número.
Int(Int64)	Devolve a parte inteira de um número.
Int(Object)	Devolve a parte inteira de um número.
Int(Single)	Devolve a parte inteira de um número.

Int(Decimal)

Devolve a parte inteira de um número.

public:
 static System::Decimal Int(System::Decimal Number);

public static decimal Int(decimal Number);

static member Int : decimal -> decimal

Public Function Int (Number As Decimal) As Decimal

Parâmetros

Number: Decimal

Required. Um número de tipos Decimal ou qualquer expressão numérica válida.

Devoluções

Decimal

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras dos números. No caso de um argumento de número negativo, a Int função devolve o primeiro inteiro negativo menor ou igual ao número; a Fix função devolve o primeiro inteiro negativo maior ou igual ao número. O exemplo seguinte exige que especifique Option Strict Off porque conversões implícitas de tipo Double para tipo Integer não são permitidas sob Option Strict On:

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

Pode usar a CInt função para converter explicitamente outros tipos de dados para escrever Integer com Option Strict Off. No entanto, CInt arredonda para o número inteiro mais próximo em vez de truncar a parte fracionária dos números. Por exemplo:

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

A diferença entre Int e Fix funções é que, se Number for negativo, Int devolve o primeiro inteiro negativo menor ou igual a Number, enquanto Fix devolve o primeiro inteiro negativo maior ou igual a Number. Por exemplo, Int converte -8,4 em -9, e Fix converte -8,4 em -8.

a.. é equivalente a a..^0

Ver também

Aplica-se a

Int(Double)

Devolve a parte inteira de um número.

public:
 static double Int(double Number);

public static double Int(double Number);

static member Int : double -> double

Public Function Int (Number As Double) As Double

Parâmetros

Number: Double

Required. Um número de tipos Double ou qualquer expressão numérica válida.

Devoluções

Double

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

A partir de Visual Basic 15.8, o desempenho da conversão de Duplo para inteiro é otimizado se passar o valor devolvido pelo método Int para qualquer uma das funções de conversão integral, ou se o valor Duplo devolvido por Int for automaticamente convertido num inteiro com Opção Estrito definido para Desligado. Essa otimização permite que o código seja executado mais rapidamente -- até duas vezes mais rápido para o código que faz um grande número de conversões para tipos inteiros. O exemplo seguinte ilustra tal conversão otimizada:

Dim dbl As Double = 175.7619
Dim i3 As Integer = CInt(Int(dbl))         ' Result: 175

Ver também

Aplica-se a

Int(Int16)

Devolve a parte inteira de um número.

public:
 static short Int(short Number);

public static short Int(short Number);

static member Int : int16 -> int16

Public Function Int (Number As Short) As Short

Parâmetros

Number: Int16

Required. Um número de tipos Short ou qualquer expressão numérica válida.

Devoluções

Int16

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

Ver também

Aplica-se a

Int(Int32)

Devolve a parte inteira de um número.

public:
 static int Int(int Number);

public static int Int(int Number);

static member Int : int -> int

Public Function Int (Number As Integer) As Integer

Parâmetros

Number: Int32

Required. Um número de tipos Integer ou qualquer expressão numérica válida.

Devoluções

Int32

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

Ver também

Aplica-se a

Int(Int64)

Devolve a parte inteira de um número.

public:
 static long Int(long Number);

public static long Int(long Number);

static member Int : int64 -> int64

Public Function Int (Number As Long) As Long

Parâmetros

Number: Int64

Required. Um número de tipos Long ou qualquer expressão numérica válida.

Devoluções

Int64

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

Ver também

Aplica-se a

Int(Object)

Devolve a parte inteira de um número.

public:
 static System::Object ^ Int(System::Object ^ Number);

public static object Int(object Number);

static member Int : obj -> obj

Public Function Int (Number As Object) As Object

Parâmetros

Number: Object

Required. Um número de tipos Object ou qualquer expressão numérica válida. Se Number contém Nothing, Nothing é devolvido.

Devoluções

Object

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

Começando com Visual Basic 15.8, se o argumento Number for um objeto cujo tipo de execução é Double ou Single, o desempenho da conversão de ponto flutuante para inteiro é otimizado se passares o valor devolvido pelo método Int para qualquer uma das funções de conversão integral, ou se o valor devolvido por Int for automaticamente convertido num inteiro com Option Strict definido para Off. Essa otimização permite que o código seja executado mais rapidamente -- até duas vezes mais rápido para o código que faz um grande número de conversões para tipos inteiros. Por exemplo:

Dim d As Object = 173.7619
Dim i1 As Integer = CInt(Int(d))           ' Result: 173
Dim s As Object = 173.7619F
Dim i2 As Integer = CInt(Int(s))           ' Result: 173

Ver também

Aplica-se a

Int(Single)

Devolve a parte inteira de um número.

public:
 static float Int(float Number);

public static float Int(float Number);

static member Int : single -> single

Public Function Int (Number As Single) As Single

Parâmetros

Number: Single

Required. Um número de tipos Single ou qualquer expressão numérica válida.

Devoluções

Single

A parte inteira de um número.

Exceções

ArgumentNullException

O número não é especificado.

ArgumentException

Número não é um tipo numérico.

Exemplos

' This code requires Option Strict Off
Dim MyNumber As Integer
MyNumber = Int(99.8)   ' Returns 99.
MyNumber = Fix(99.8)   ' Returns 99.

MyNumber = Int(-99.8)  ' Returns -100.
MyNumber = Fix(-99.8)  ' Returns -99.

MyNumber = Int(-99.2)  ' Returns -100.
MyNumber = Fix(-99.2)  ' Returns -99.

MyNumber = CInt(99.8)    ' Returns 100.
MyNumber = CInt(-99.8)   ' Returns -100.
MyNumber = CInt(-99.2)   ' Returns -99.

Pode usar a CInt função no resultado de uma chamada para Fix ou Int para realizar uma conversão explícita para inteiro sem arredondamento. Por exemplo:

MyNumber = CInt(Fix(99.8))   ' Returns 99.
MyNumber = CInt(Int(99.8))   ' Returns 99.

Para mais informações sobre CInt, veja Funções de Conversão de Tipos.

Observações

Tanto as Int funções e Fix removem a parte fracionária de Number como devolvem o valor inteiro resultante.

a.. é equivalente a a..^0

A partir de Visual Basic 15.8, o desempenho da conversão de Single para inteiro é otimizado se passar o valor devolvido pelo método Int para qualquer uma das funções de conversão integral, ou se o valor Single devolvido por Int for automaticamente convertido num inteiro com Opção Estrito definido para Desligado. Essa otimização permite que o código seja executado mais rapidamente -- até duas vezes mais rápido para o código que faz um grande número de conversões para tipos inteiros. O exemplo seguinte ilustra tal conversão otimizada:

Dim sng As Single = 175.7619
Dim i3 As Integer = CInt(Fix(sng))         ' Result: 175

Ver também

Aplica-se a

Comentários

Esta página foi útil?