Left 함수(Visual Basic)

업데이트: 2007년 11월

문자열의 왼쪽에서 지정한 수의 문자를 포함하는 문자열을 반환합니다.

Public Shared Function Left( _
ByVal str As String, _
ByVal Length As Integer _
) As String

매개 변수

  • str
    필수적 요소. 가장 왼쪽의 문자를 반환하는 String 식입니다.

  • Length
    필수적 요소. Integer 식입니다. 반환할 문자의 개수를 나타내는 숫자 식입니다. 0인 경우 길이가 0인 문자열("")이 반환됩니다. str의 문자 개수보다 많거나 같은 경우 전체 문자열이 반환됩니다.

예외

예외 형식

오류 번호

조건

ArgumentException

5

Length < 0.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

Len 함수를 사용하여 str의 문자 개수를 확인합니다. Windows Forms 응용 프로그램에서 사용하거나 Left 속성이 있는 다른 클래스에서 사용할 경우 Microsoft.VisualBasic.Left를 사용하여 해당 함수를 정규화해야 합니다.

참고:

이전 Visual Basic 버전의 LeftB 함수는 문자가 아니라 바이트로 된 문자열을 반환합니다. 이 함수는 주로 DBCS(이중 바이트 문자 집합) 응용 프로그램의 문자열을 변환하는 데 사용됩니다. 현재의 모든 Visual Basic 문자열은 유니코드이며 LeftB는 이제 지원되지 않습니다.

예제

다음 예제에서는 Left 함수를 사용하여 특정 String의 부분 문자열을 반환하는 방법을 보여 줍니다. Left 속성을 가진 클래스에서는 Left 함수를 정규화해야 할 수도 있습니다.

Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Strings

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

개념

프로그래밍 요소 지원 변경 사항 요약

참조

문자열 조작 요약

Right 함수(Visual Basic)

Len 함수(Visual Basic)

Mid 함수(Visual Basic)

ArgumentException