Conversion.Int 方法

定義

命名空間:: Microsoft.VisualBasic

組件:: Microsoft.VisualBasic.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

會傳回數字的整數部分。

多載

名稱	Description
Int(Decimal)	會傳回數字的整數部分。
Int(Double)	會傳回數字的整數部分。
Int(Int16)	會傳回數字的整數部分。
Int(Int32)	會傳回數字的整數部分。
Int(Int64)	會傳回數字的整數部分。
Int(Object)	會傳回數字的整數部分。
Int(Single)	會傳回數字的整數部分。

Int(Decimal)

會傳回數字的整數部分。

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

參數

Number: Decimal

必須的。一個型別 Decimal 或任何有效的數值表達式。

傳回

Decimal

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

此範例說明和 Fix 函數如何Int回傳整數部分。在負數參數的情況下， Int 函數回傳第一個大小於或等於該數字的負整數; Fix 函數回傳第一個大於或等於該數字的負整數。以下範例要求你說明Option Strict Off，因為在以下Option Strict On條件下不允許從型別Double轉換到型別Integer：

' 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.

你可以用這個CInt函式明確將其他資料型態轉換成帶有的型別Integer。Option Strict Off 然而，將 CInt 捨入至最近的整數，而不是截斷數字的分數部分。例如：

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

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

與Fix函數的Int差異在於，若Number為負，Int則回傳第一個小Number於等於的負整數，而回Fix傳第一個大於或等於的Number負整數。例如，將 Int -8.4 轉換成 -9，將 Fix -8.4 轉換成 -8。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

另請參閱

適用於

Int(Double)

會傳回數字的整數部分。

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

參數

Number: Double

必須的。一個型別 Double 或任何有效的數值表達式。

傳回

Double

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

從 Visual Basic 15.8 開始，若將 Int 方法回傳的值傳遞給任一積分轉換函式，或將 Int 回傳的 Double 值自動轉換為整數且 Option Strict 關閉，則會優化雙整數轉換的效能。此最佳化可讓程式碼執行得更快，對於執行大量整數類型的程式碼，速度最高可達兩倍。以下範例說明了此類最佳化轉換：

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

另請參閱

適用於

Int(Int16)

會傳回數字的整數部分。

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

參數

Number: Int16

必須的。一個型別 Short 或任何有效的數值表達式。

傳回

Int16

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

另請參閱

適用於

Int(Int32)

會傳回數字的整數部分。

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

參數

Number: Int32

必須的。一個型別 Integer 或任何有效的數值表達式。

傳回

Int32

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

另請參閱

適用於

Int(Int64)

會傳回數字的整數部分。

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

參數

Number: Int64

必須的。一個型別 Long 或任何有效的數值表達式。

傳回

Int64

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

另請參閱

適用於

Int(Object)

會傳回數字的整數部分。

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

參數

Number: Object

必須的。一個型別 Object 或任何有效的數值表達式。若 Number 包含 Nothing， Nothing 則回傳。

傳回

Object

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

從 Visual Basic 15.8 開始，若 Number 參數的物件執行型別為 Double 或 Single，則浮點數轉整數的效能最佳化，若你將 Int 方法回傳的值傳遞到任一積分轉換函數，或者 Int 回傳的值會自動轉換成整數，並將 Option Strict 設為關閉。此最佳化可讓程式碼執行得更快，對於執行大量整數類型的程式碼，速度最高可達兩倍。例如：

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

另請參閱

適用於

Int(Single)

會傳回數字的整數部分。

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

參數

Number: Single

必須的。一個型別 Single 或任何有效的數值表達式。

傳回

Single

數字的整數部分。

例外狀況

ArgumentNullException

編號未明確說明。

ArgumentException

數字不是數字類型。

範例

' 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.

你可以在呼叫結果上使用這個CInt函FixInt式，或在不捨入的情況下執行明確的整數轉換。例如：

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

欲了解更多相關 CInt資訊，請參見型態轉換函數。

備註

和 Fix 函數都Int去除了的Number分數部分，並返回所得整數值。

Fix(number) 相當於 Sign(number) * Int(Abs(number)).

從 Visual Basic 15.8 開始，Single 轉整數的效能最佳化方式是：將 Int 方法回傳的值傳遞給任一積分轉換函數，或將 Int 回傳的 Single 值自動轉換為整數，並將 Option Strict 設為關閉。此最佳化可讓程式碼執行得更快，對於執行大量整數類型的程式碼，速度最高可達兩倍。以下範例說明了此類最佳化轉換：

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

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？