UBound 함수(Visual Basic)
업데이트: 2007년 11월
배열의 표시된 차원에 사용할 수 있는 최고 첨자를 반환합니다.
Public Function UBound( _
ByVal Array As System.Array, _
Optional ByVal Rank As Integer = 1 _
) As Integer
매개 변수
Array
필수적 요소. 데이터 형식의 배열입니다. 차원의 가능한 최고 첨자를 찾을 배열입니다.Rank
선택적 요소. Integer. 가능한 최고 첨자가 반환될 차원입니다. 첫째 차원에는 1, 둘째 차원에는 2를 사용하는 방식으로 사용됩니다. Rank가 생략되면 1이 사용됩니다.
반환 값
Integer. 지정된 차원에 대한 첨자가 포함할 수 있는 최대값입니다. Array에 요소가 하나만 있으면 UBound에서 0을 반환합니다. 길이가 0인 문자열과 같이 Array에 요소가 없으면 UBound에서 -1을 반환합니다.
예외
예외 형식 |
오류 번호 |
조건 |
|---|---|---|
Array 이 선언은 아래 선언과 같습니다. Nothing |
||
Rank가 1보다 작거나 Array의 차수보다 큽니다. |
비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.
설명
배열 첨자가 0에서 시작하므로 차원의 길이는 해당 차원에 사용할 수 있는 최고 첨자보다 1이 더 큰 값입니다.
아래와 같은 차원을 가진 배열의 경우 UBound 함수는 다음 표에 나와 있는 값을 반환합니다.
Dim a(100, 5, 4) As Byte
UBound 호출 형식 |
반환 값 |
|---|---|
UBound(a, 1) |
100 |
UBound(a, 2) |
5 |
UBound(a, 3) |
4 |
UBound 함수를 사용하여 배열의 전체 요소 수를 확인할 수 있지만, 첨자가 0에서 시작하므로 이 함수가 반환하는 값을 조정해야 합니다. 다음 예제에서는 앞의 예제에 나와 있는 배열 a의 전체 크기를 계산합니다.
Dim total As Integer
total = (UBound(A, 1) + 1) * (UBound(A, 2) + 1) * (UBound(A, 3) + 1)
total로 계산되는 값은 101 * 6 * 5에 해당하는 3030입니다.
예제
다음 예제에서는 UBound 함수를 사용하여 배열의 표시된 차원에 사용할 수 있는 최고 첨자를 결정합니다.
Dim highest, bigArray(10, 15, 20), littleArray(6) As Integer
highest = UBound(bigArray, 1)
highest = UBound(bigArray, 3)
highest = UBound(littleArray)
' The three calls to UBound return 10, 20, and 6 respectively.
요구 사항
네임스페이스:Microsoft.VisualBasic
모듈: Information
**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)