다음을 통해 공유


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을 반환합니다.

예외

예외 형식

오류 번호

조건

ArgumentNullException

9

Array 이 선언은 아래 선언과 같습니다. Nothing

RankException

9

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)

참고 항목

참조

LBound 함수(Visual Basic)

Dim 문(Visual Basic)

ReDim 문(Visual Basic)

ArgumentException

RankException