Str 함수

아티클
08/20/2008

업데이트: 2007년 11월

숫자를 나타내는 String을 반환합니다.

Public Shared Function Str(ByVal Number As Object) As String

매개 변수

Number
필수적 요소. 임의의 유효한 숫자 식을 포함하는 Object입니다.

예외

예외 형식	오류 번호	조건
ArgumentNullException	5	Number를 지정하지 않았습니다.
InvalidCastException	5	Number가 숫자 형식이 아닙니다.

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

설명

숫자가 문자열로 변환되면 선행 공백은 항상 Number의 부호로 예약됩니다. Number가 양수이면 반환되는 문자열에는 선행 공백 및 + 부호가 포함됩니다. 음수인 경우에는 - 부호가 포함되지만 선행 공백은 없습니다.

숫자 값을 날짜, 시간, 통화 또는 다른 사용자 정의 형식으로 변환하려면 Format 함수를 사용합니다. Str 함수와 달리 Format 함수는 Number의 부호용으로 사용되는 선행 공백을 포함하지 않습니다.

참고:
Str 함수는 마침표(.)만 유효한 소수 구분 기호로 인식합니다. 국가별 응용 프로그램 등에서는 다른 소수 구분 기호가 사용될 수 있으므로 이러한 경우에는 CStr 또는 Format 함수를 사용하여 숫자를 문자열로 변환합니다. 특정 culture의 숫자에 대한 문자열 표현을 가져오려면 숫자의 ToString(IFormatProvider) 메서드를 사용합니다. 예를 들어, Double 형식의 값을 문자열로 변환할 경우 ToString을 사용합니다.

Str 함수는 마침표(.)만 유효한 소수 구분 기호로 인식합니다. 국가별 응용 프로그램 등에서는 다른 소수 구분 기호가 사용될 수 있으므로 이러한 경우에는 CStr 또는 Format 함수를 사용하여 숫자를 문자열로 변환합니다. 특정 culture의 숫자에 대한 문자열 표현을 가져오려면 숫자의 ToString(IFormatProvider) 메서드를 사용합니다. 예를 들어, Double 형식의 값을 문자열로 변환할 경우 ToString을 사용합니다.

예제

다음 예제에서는 Str 함수를 사용하여 숫자를 나타내는 String 표현을 반환합니다. 양수가 문자열로 변환되는 경우 해당 부호용으로 항상 선행 공백이 예약됩니다.

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)