Conversion.Int Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Retorna a parte inteira de um número.

Sobrecargas

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

Int(Decimal)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Decimal ou qualquer expressão numérica válida.

Retornos

Decimal

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Double)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Double ou qualquer expressão numérica válida.

Retornos

Double

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

A partir do Visual Basic 15.8, o desempenho da conversão double-to-integer será otimizado se você passar o valor retornado pelo Int método para qualquer uma das funções de conversão integral ou se o valor Double retornado por Int for convertido automaticamente em um inteiro com Option Strict definido como Desativado. 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 de inteiro. O exemplo a seguir ilustra essa conversão otimizada:

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

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Int16)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Short ou qualquer expressão numérica válida.

Retornos

Int16

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Int32)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Integer ou qualquer expressão numérica válida.

Retornos

Int32

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Int64)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Long ou qualquer expressão numérica válida.

Retornos

Int64

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Object)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Object ou qualquer expressão numérica válida. Se Number contiver Nothing, Nothing será retornado.

Retornos

Object

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

A partir do Visual Basic 15.8, se o Number argumento for um objeto cujo tipo de runtime é Double ou Single, o desempenho da conversão de ponto flutuante para inteiro será otimizado se você passar o valor retornado pelo Int método para qualquer uma das funções de conversão integral ou se o valor retornado por Int for convertido automaticamente em um inteiro com Option Strict definido como Desativado. 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 de inteiro. 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

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão

Int(Single)

Origem:

Conversion.vb

Retorna 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

Obrigatórios. Um número do tipo Single ou qualquer expressão numérica válida.

Retornos

Single

A parte inteira de um número.

Exceções

ArgumentNullException

O número não está especificado.

ArgumentException

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

Exemplos

Este exemplo ilustra como as Int funções e Fix retornam partes inteiras de números. No caso de um argumento numérico negativo, a Int função retorna o primeiro inteiro negativo menor ou igual ao número; a Fix função retorna o primeiro inteiro negativo maior ou igual ao número. O exemplo a seguir exige que você especifique Option Strict Off porque conversões implícitas de tipo Double em tipo Integer não são permitidas em 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.

Você pode usar a CInt função para converter explicitamente outros tipos de dados em tipo Integer com Option Strict Off. No entanto, CInt arredonda para o 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.

Você pode usar a CInt função no resultado de uma chamada para Fix ou Int para executar a conversão explícita em inteiro sem arredondamento. Por exemplo:

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

Para obter mais informações sobre CInt, consulte Funções de conversão de tipo.

Comentários

Int As funções e Fix removem a parte fracionária de Number e retornam o valor inteiro resultante.

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

Fix(number) equivale a Sign(number) * Int(Abs(number)).

A partir do Visual Basic 15.8, o desempenho da Singleconversão -to-integer será otimizado se você passar o valor retornado pelo Int método para qualquer uma das funções de conversão integral ou se o Single valor retornado por Int for convertido automaticamente em um inteiro com Option Strict definido como Desativado. 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 de inteiro. O exemplo a seguir ilustra essa conversão otimizada:

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

Confira também

• ArgumentNullException
• Funções de conversão do tipo
• Resumo do tipo de dados (Visual Basic)
• Resumo de matemática
• Funções matemáticas (Visual Basic)
• Resumo da Conversão