이전 다음

BirtStr 클래스

BirtStr 클래스는 문자열 연결, 추가 간격 조정, 문자열의 파트 가져오기 및 대문자 또는 소문자로 문자열 표시 등과 같이 문자열을 조작하기 위한 함수를 제공합니다. 이 클래스는 정적입니다. 애플리케이션은 클래스의 인스턴스를 작성할 수 없습니다.

BirtStr.charLength

이 함수는 제공된 문자열의 길이를 리턴합니다.

구문

integer BirtStr.charLength( string source )

매개변수

source

문자열. 평가할 문자열입니다.

리턴

정수형. 지정된 문자열의 문자 수입니다.

예제

다음 예제는 특정 문자열의 길이를 리턴합니다.

BirtStr.charLength( "Julie Murphy" ) // returns 12

다음 예제는 CustomerName 필드에 있는 각 값의 길이를 리턴합니다.

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

이 함수는 제공된 문자열을 연결하여 산출된 문자열을 리턴합니다.

구문

string BirtStr.concat( string source1, ..., sourceN )

매개변수

source1, ..., sourceN

문자열. 연결할 문자열입니다.

리턴

문자열. 일련의 문자열을 연결하여 산출된 문자열입니다.

예제

다음 예제는 다중 필드의 값을 연결하여 전체 주소를 리턴합니다.

BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )

BirtStr.indexOf

이 함수는 제공된 문자열에서 지정된 하위 문자열 위치를 리턴합니다.

구문

integer BirtStr.indexOf( sring target, string source, integer start )

매개변수

target

문자열. 검색할 하위 문자열입니다. 검색은 대소문자를 구분합니다.

source

문자열. 지정된 하위 문자열을 검색할 문자열입니다.

start

정수형. 선택적. 검색을 시작할 소스 문자열의 위치입니다. 이 인수를 생략하는 경우, 함수는 문자열의 첫 번째 문자에서 검색을 시작합니다.

리턴

정수형. 문자열에서 하위 문자열의 숫자 위치입니다. 문자열의 첫 번째 문자는 0에서 시작합니다. 하위 문자열을 찾을 수 없는 경우, 함수는 -1을 리턴합니다.

예제

다음 예제는 특정 문자열에서 지정된 문자의 숫자 위치를 리턴합니다.

BirtStr.indexOf( " ", "Julie Murphy" ) // returns 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // returns 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // returns 11

다음 예제는 BirtStr.left( )와 함께 BirtStr.indexOf( )를 사용하여 고객 이름의 공백 문자 앞에 문자를 표시합니다. BirtStr.left( ) 함수는 첫 번째 문자에서 시작하는 지정된 길이의 하위 문자열을 추출합니다. 이 예제에서, 표시할 하위 문자열의 길이는 공백 문자의 숫자 위치와 같습니다.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

고객 이름이 Julie Murphy인 경우 표현식은 Julie를 리턴합니다.

BirtStr.left

이 함수는 가장 왼쪽 또는 첫 번째 문자에서 시작하는 문자열의 지정된 길이에 대한 하위 문자열을 추출합니다.

구문

string BirtStr.left( string source, integer n )

매개변수

source

문자열. 하위 문자열을 추출할 문자열입니다.

n

정수형. 첫 번째 문자에서 시작하는, 추출할 문자열 수입니다.

리턴

문자열. 특정 길이의 하위 문자열입니다.

*
*
*

예제

다음 예제는 특정 문자열에서 여러 길이의 하위 문자열을 리턴합니다.

BirtStr.left( "Julie Murphy", 5 ) // returns Julie
BirtStr.left( "Julie Murphy", 12 ) // returns Julie Murphy

다음 예제는 BirtStr.left( )와 함께 BirtStr.indexOf( )를 사용하여 고객 이름의 공백 문자 앞에 문자를 표시합니다. BirtStr.left( ) 함수는 첫 번째 문자에서 시작하는 지정된 길이의 하위 문자열을 추출합니다. 이 예제에서, 표시할 하위 문자열의 길이는 공백 문자의 숫자 위치와 같습니다.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

고객 이름이 Julie Murphy인 경우 표현식은 Julie를 리턴합니다.

BirtStr.right

이 함수는 가장 오른쪽 또는 마지막 문자에서 시작하는 문자열의 지정된 길이에 대한 하위 문자열을 추출합니다.

구문

String BirtStr.right( String source, integer n )

매개변수

source

문자열. 하위 문자열을 추출할 문자열입니다.

n

정수형. 마지막 문자에서 시작하는, 추출할 문자열 수입니다.

리턴

문자열. 특정 길이의 하위 문자열입니다.

*
*
*

예제

다음 예제는 특정 문자열에서 여러 길이의 하위 문자열을 리턴합니다.

BirtStr.right( "Julie Murphy", 6 ) // returns Murphy
BirtStr.right( "Julie Murphy", 12 ) // returns Julie Murphy

다음 예제는 BirtStr.indexOf( ) 및 BirtStr.charLength( ) 함수와 함께 BirtStr.right( )를 사용하여 고객 이름의 공백 문자 뒤에 나타나는 문자를 표시합니다. 이 예제는 하이픈 다음의 문자 수가 다양하다고 가정합니다. 그러므로 전체 문자열(BirtStr.charLength( )로 리턴)의 길이에서 하이픈(BirtStr.indexOf( )로 리턴)까지의 길이를 뺀 수가 표시할 문자열 수입니다.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayLastName = BirtStr.right( row["customerName"], (BirtStr.charLength( row["customerName"] - (spaceCharPosition + 1)) )

고객 이름이 Julie Murphy인 경우 표현식은 Murphy를 리턴합니다. 고객 이름이 Kwai Li인 경우, 표현식은 Li를 리턴합니다.

BirtStr.search

이 함수는 제공된 문자열의 지정된 하위 문자열 위치를 리턴합니다. 하위 문자열에 와일드카드 문자를 포함할 수 없습니다.

구문

integer BirtStr.search( string pattern, string source, integer index )

매개변수

pattern

문자열. 검색할 문자열 패턴입니다. 검색은 대소문자를 구분하지 않습니다. 패턴에 다음 와일드카드 문자를 사용할 수 있습니다.

*
별표( * )는 공백을 포함하여 0개 이상의 문자와 일치합니다. 예를 들어, t*n은 tn, tin 및 teen과 일치합니다.
*

문자열에서 리터럴 별표 또는 물음표를 일치시키려면 두 개의 백슬래시(\\) 문자를 해당 문자 앞에 사용하십시오. 예를 들어, 하위 문자열 R*10을 찾으려면 다음 문자 패턴을 사용하십시오.

"R\\*10"

source

문자열. 지정된 하위 문자열을 검색할 문자열입니다.

index

정수형. 선택적. 검색을 시작할 소스 문자열의 위치입니다. 이 인수를 생략하는 경우, 함수는 문자열의 첫 번째 문자에서 검색을 시작합니다.

리턴

정수형. 문자열에서 하위 문자열의 숫자 위치입니다. 문자열의 첫 번째 문자는 0에서 시작합니다. 하위 문자열을 찾을 수 없는 경우, 함수는 -1을 리턴합니다.

예제

다음 예제는 특정 문자열에서 지정된 문자열 패턴의 숫자 위치를 리턴합니다.

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // returns 0
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // returns 4
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // returns 10

다음 예제는 ProductCode 필드에 있는 각 값의 S*A 문자열 패턴을 검색합니다. 제품 코드가 KBS5412A인 경우, 표현식은 2를 리턴합니다.

BirtStr.search( "S*A", row["ProductCode"] )

다음 예제는 BirtStr.left( )와 함께 BirtStr.search( )를 사용하여 제품 이름의 -Model* 문자열 패턴 앞에 문자를 표시합니다. BirtStr.left( ) 함수는 첫 번째 문자에서 시작하는 지정된 길이의 하위 문자열을 추출합니다. 이 예제에서, 표시할 하위 문자열의 길이는 문자열 패턴의 숫자 위치와 같습니다.

stringPatternPosition = BirtStr.search( "-Model*", row["productName"] );
displayString = BirtStr.left( row["productName"], stringPatternPosition );

제품 이름이 XMS-ModelA-1234인 경우 표현식은 XMS를 리턴합니다.

BirtStr.toLower

이 함수는 문자열의 모든 문자를 소문자로 변환합니다.

구문

string BirtStr.toLower( string source )

매개변수

source

문자열. 소문자로 변환할 문자열입니다.

리턴

문자열. 모두 소문자로 지정된 문자열입니다.

예제

다음 예제는 productLine 필드의 모든 값을 소문자로 표시합니다.

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

이 함수는 문자열의 모든 문자를 대문자로 변환합니다.

구문

string BirtStr.toUpper( string source )

매개변수

source

문자열. 대문자로 변환할 문자열입니다.

리턴

문자열. 모두 대문자로 지정된 문자열입니다.

예제

다음 예제는 customerName 필드의 모든 값을 대문자로 표시합니다.

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

이 함수는 모든 앞 공백 및 뒤 공백 문자가 제거된 문자열을 리턴합니다. 단어 간의 공백 문자는 제거하지 않습니다.

구문

string BirtStr.trim( string source )

매개변수

source

문자열. 앞 공백 및 뒤 공백 문자를 제거할 문자열입니다.

리턴

문자열. 모든 앞 공백 및 뒤 공백 문자가 제거된 문자열입니다.

예제

다음 예에서는 BirtStr.trim( )을 사용하여 FirstName 및 LastName 데이터 필드의 값에서 모든 앞 공백 및 뒤 공백 문자를 제거합니다.

BirtStr.trim( row["FirstName"]) + " " + BirtStr.trim(row["LastName"] )

BirtStr.trimLeft

이 함수는 모든 앞 공백 및 뒤 공백 문자가 제거된 문자열을 리턴합니다. 단어 간의 공백 문자는 제거하지 않습니다.

구문

string BirtStr.trimLeft( string source )

매개변수

source

문자열. 앞 공백 문자를 제거할 문자열입니다.

리턴

문자열. 모든 앞 공백 문자가 제거된 문자열입니다.

예제

다음 예제는 리터럴 문자열을 customerName 필드의 각 값과 연결합니다. BirtStr.trimLeft( )는 리터럴 문자열 및 customerName 값 간에 공백 문자가 없도록 customerName 값 앞에 있는 모든 공백 문자를 제거합니다.

"Customer name: " + BirtStr.trimLeft( row["customerName"] )

BirtStr.trimRight

이 함수는 뒤 공백 문자가 있는 문자열을 제거합니다. 단어 간의 공백 문자는 제거하지 않습니다.

구문

string BirtStr.trimRight( string source )

매개변수

source

문자열. 뒤 공백 문자를 제거할 문자열입니다.

리턴

문자열. 모든 뒤 공백 문자가 제거된 문자열입니다.

예제

다음 예제는 Comment 필드의 각 값을 세미콜론으로 연결한 후 조치 필드의 값과 연결합니다. BirtStr.trimRight( )는 주석 문자열 및 세미콜론 간에 공백 문자가 없도록 주석 값 뒤에 있는 모든 공백 문자를 제거합니다.

BirtStr.trimRight( row["Comment"]) + "; " + row["Action"] )

(c) Copyright Actuate Corporation 2013