문자열 함수 string-functions

문자열 함수를 사용하면 여정 표현식 내에서 텍스트 값을 조작하고 작업할 수 있습니다. 이러한 기능은 고객 여정의 텍스트 처리, 유효성 검사, 변형 및 분석에 필수적입니다.

다음을 수행해야 하는 경우 문자열 함수 사용:

문자열 함수는 포괄적인 텍스트 조작 기능을 제공하여 여정 표현식의 텍스트 콘텐츠를 기반으로 하는 정교한 데이터 처리 및 조건부 논리를 가능하게 합니다.

concat concat

두 개의 문자열 매개 변수 또는 문자열 목록을 연결합니다.

구문
concat(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
목록 listString
문자열 문자열
서명 및 반환된 유형

concat(<string>,<string>)

concat(<listString>)

문자열을 반환합니다.

예시

concat("Hello","World")

"HelloWorld"를 반환합니다.

concat(["Hello"," ","World"])

"Hello World"를 반환합니다.

contain contain

두 번째 인수 문자열이 첫 번째 인수 문자열에 포함되어 있는지 확인합니다.

구문
contain(<parameters>)
매개변수
  • 문자열
서명 및 반환된 유형

contain(<string>,<string>)

부울 반환.

예시

contain("rowing is great", "great")

true를 반환합니다.

containIgnoreCase containIgnoreCase

두 번째 인수 문자열이 대소문자를 고려하지 않고 첫 번째 인수 문자열에 포함되어 있는지 확인합니다.

구문
containIgnoreCase(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
문자열 검색됨 문자열
서명 및 반환된 유형

containIgnoreCase(<string>,<string>)

부울 반환.

예시

containIgnoreCase("rowing is great", "GREAT")

true를 반환합니다.

endWith endWith

두 번째 매개 변수가 첫 번째 매개 변수의 접미사인 경우 true를 반환합니다.

구문
endWith(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
접미사 문자열
서명 및 반환된 유형

endWith(<string>,<string>)

부울 반환.

예시

endWith("Hello World", "World")

true를 반환합니다.

endWith("Hello World", "Hello")

false를 반환합니다.

endWithIgnoreCase endWithIgnoreCase

첫 번째 인수 문자열이 대소문자를 고려하지 않고 특정 문자열(두 번째 인수 문자열)로 끝나는지 확인합니다.

구문
endWithIgnoreCase(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
접미사 문자열
서명 및 반환된 유형

endWithIgnoreCase(<string>,<string>)

부울 반환.

예시

endWithIgnoreCase("rowing is great", "AT")

true를 반환합니다.

equalIgnoreCase equalIgnoreCase

대/소문자 고려 사항을 무시하면서 첫 번째 인수 문자열과 두 번째 인수 문자열을 비교합니다.

구문
equalIgnoreCase(<parameters>)
매개변수
  • 문자열
서명 및 반환된 유형

equalIgnoreCase(<string>,<string>)

부울 반환.

예시

equalIgnoreCase("rowing is great", "rowing is GREAT")

true를 반환합니다.

indexOf indexOf

두 번째 매개 변수의 첫 번째 발생 횟수 위치(첫 번째 인수에서)를 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

구문
indexOf(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
지정된 값 문자열
서명 및 반환된 유형

indexOf(<string>,<string>)

정수 반환.

예시

indexOf("Hello", "l")

2를 반환합니다.

설명:

"Hello"에서 "l"의 첫 번째 발생은 위치 2에 있다.

isEmpty isEmpty

매개 변수의 문자열에 문자가 없으면 true를 반환합니다.

구문
isEmpty(<parameters>)
매개변수
  • 문자열
서명 및 반환된 유형

isEmpty(<string>)

부울 반환.

예시

isEmpty("")

true를 반환합니다.

isEmpty("Hello World")

false를 반환합니다.

isEmpty(<null>)

false를 반환합니다.

isNotEmpty isNotEmpty

매개 변수의 문자열이 비어 있지 않으면 true를 반환합니다.

구문
isNotEmpty(<parameters>)
매개변수
  • 문자열
서명 및 반환된 유형

isNotEmpty(<string>)

부울 반환.

예시

isNotEmpty("")

false를 반환합니다.

isNotEmpty("hello")

true를 반환합니다.

lastIndexOf lastIndexOf

두 번째 매개 변수의 마지막 발생 횟수 위치(첫 번째 인수에서)를 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

구문
lastIndexOf(<parameters>)
매개 변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
지정된 값 문자열
서명 및 반환된 유형

lastIndexOf(<string>,<string>)

정수 반환.

예시

lastIndexOf("Hello", "l")

3을 반환합니다.

설명:

"Hello"에서 "l"의 마지막 발생은 위치 3에 있다.

length length

매개 변수에서 문자열 식의 문자 수를 반환합니다.

구문
length(<parameters>)
매개 변수
  • 문자열
서명 및 반환된 유형

length(<string>)

정수 반환.

예시

length("Hello World")

11을 반환합니다.

lower lower

매개 변수의 소문자 버전을 반환합니다.

구문
lower(<parameter>)
매개 변수
  • 문자열
서명 및 반환된 유형

lower(<string>)

문자열을 반환합니다.

예시

lower("A")

"a"를 반환합니다.

matchRegExp matchRegExp

첫 번째 매개 변수의 문자열이 두 번째 매개 변수의 정규 표현식과 일치하면 true를 반환합니다. 자세한 내용은 이 페이지를 참조하세요.

구문
matchRegExp(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
regexp 문자열
서명 및 반환된 유형

matchRegExp(<string>,<string>)

부울 반환.

예시

matchRegExp("12345", "\\d+")

true를 반환합니다.

notEqualIgnoreCase notEqualIgnoreCase

대/소문자 고려 사항을 무시한 채 첫 번째 인수 문자열과 두 번째 인수 문자열이 다른지 확인합니다.

구문
notEqualIgnoreCase(<parameters>)
매개변수
  • 문자열
서명 및 반환된 유형

notEqualIgnoreCase(<string>,<string>)

부울 반환.

예시
notEqualIgnoreCase(@event{iOSPushPermissionAllowed.device.model}, "iPad")

replace replace

대상 문자열과 일치하는 첫 번째 발생 횟수를 기본 문자열의 대체 문자열로 바꿉니다.

교체는 문자열 시작부터 끝까지 진행됩니다. 예를 들어, 문자열 "aaa"에서 "aa"를 "b"로 바꾸면 "ab"가 아닌 "ba"가 생성됩니다.

구문
replace(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2 3-row-2
매개 변수 유형
기본 문자열
target 문자열(RegExp)
교체 문자열
서명 및 반환된 유형

replace(<base>,<target>,<replacement>)

문자열을 반환합니다.

예시

replace("Hello World", "l", "x")

"Hexlo World"를 반환합니다.

RegExp가 있는 예제:

대상 매개 변수는 RegExp이므로 바꿀 문자열에 따라 일부 문자를 이스케이프해야 할 수 있습니다. 다음은 한 예입니다.

  • 평가할 문자열: |OFFER_A|OFFER_B
  • 프로필 특성 #{ExperiencePlatform.myFieldGroup.profile.myOffers}에서 제공함
  • 바꿀 문자열: |OFFER_A
  • 문자열을 ''(으)로 대체함
  • |자 앞에 \\을(를) 추가해야 합니다.

표현식:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

반환된 문자열: |OFFER_B

지정된 속성에서 대체할 문자열을 빌드할 수도 있습니다.

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll replaceAll

대상 문자열과 일치하는 모든 발생 항목을 기본 문자열의 대체 문자열로 바꿉니다.

교체는 문자열 시작부터 끝까지 진행됩니다. 예를 들어, 문자열 "aaa"에서 "aa"를 "b"로 바꾸면 "ab"가 아닌 "ba"가 생성됩니다.

구문
replaceAll(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2 3-row-2
매개 변수 유형
기본 문자열
target 문자열(RegExp)
교체 문자열
서명 및 반환된 유형

replaceAll(<baseString>,<sourceString>,<replacementString>)

문자열을 반환합니다.

예시

replaceAll("Hello World", "l", "x")

"Hexxo Worxd"를 반환합니다.

대상 매개 변수는 RegExp이므로 바꿀 문자열에 따라 일부 문자를 이스케이프해야 할 수 있습니다. replace 함수의 예제를 참조하십시오.

split split

첫 번째 인수 문자열을 구분 문자 문자열(정규 표현식일 수 있는 두 번째 인수 문자열)로 분할하여 문자열(토큰) 목록을 생성합니다.

구문
split(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
입력 문자열 문자열
구분 문자 문자열 문자열
서명 및 반환된 유형

split(<input string>, <separator string>)

listString을 반환합니다.

예시

split("A_B_C", "_")

["A","B","C"] 반환

값이 "20.45.2.3434"인 이벤트 필드 'event.appVersion’이 있는 예

split(@event{event.appVersion}, "\\.")

["20", "45", "2", "3434"] 반환

startWith startWith

두 번째 매개 변수가 첫 번째 매개 변수의 접두사인 경우 true를 반환합니다.

구문
startWith(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
접두사 문자열
서명 및 반환된 유형

startWith(<string>,<string>)

부울 반환.

예시

startWith("Hello World", "Hello")

true를 반환합니다.

startWith("Hello World", "World")

false를 반환합니다.

startWithIgnoreCase startWithIgnoreCase

두 번째 매개 변수가 첫 번째 매개 변수의 접두사이면 대소문자를 고려하지 않고 true를 반환합니다.

구문
startWithIgnoreCase(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2
매개 변수 유형
문자열 문자열
접두사 문자열
서명 및 반환된 유형

startWithIgnoreCase(<string>,<string>)

부울 반환.

예시

startWithIgnoreCase("rowing is great", "RO")

true를 반환합니다.

substr substr

시작 색인과 끝 색인 사이에 있는 문자열 식의 하위 문자열을 반환합니다. 끝 색인이 정의되지 않으면 시작 색인과 끝 사이에 있습니다.

구문
substr(<parameters>)
매개변수
table 0-row-2 1-row-2 2-row-2 3-row-2
매개 변수 유형
문자열 문자열
beginIndex 정수
endIndex 정수
서명 및 반환된 유형

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

문자열을 반환합니다.

예시

substr("Hello World",6)

"World"를 반환합니다.

substr("Hello World", 0, 5)

"Hello"를 반환합니다.

trim trim

시작 및 끝 공백을 제거합니다.

구문
trim(<parameters>)
매개 변수
table 0-row-2 1-row-2
매개 변수 유형
문자열 문자열
서명 및 반환된 유형

trim(<string>)

문자열을 반환합니다.

예시

trim(" Hello ")

"Hello"를 반환합니다.

upper upper

매개 변수의 대문자 버전을 반환합니다.

구문
upper(<parameters>)
서명 및 반환된 유형

upper(<string>)

문자열을 반환합니다.

예시

upper("b")

"B"를 반환합니다.

uuid uuid

임의의 UUID(Universal Unique IDentifier)를 생성합니다.

구문
uuid()
매개변수
이 함수에는 매개 변수가 필요하지 않습니다.
서명 및 반환된 유형

uuid()

문자열을 반환합니다.

예시

uuid()

"79e70b7f-8a85-400b-97a1-9f9826121553"를 반환합니다.

AI 기술 자료 참조

이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.

이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.

  • TL;DR: 이 페이지에서는 텍스트 검색, 비교, 변환, 추출, 유효성 검사, 대체, 분할 및 고유 식별자 생성을 다루는 AJO 여정 표현식에서 사용할 수 있는 모든 문자열 함수를 설명합니다.

의도:

  • concat을(를) 사용하여 두 개 이상의 문자열 연결
  • contain 또는 containIgnoreCase을(를) 사용하여 문자열(대/소문자 구분 또는 대/소문자 구분 안 함) 내에서 하위 문자열을 검색합니다.
  • equalIgnoreCase 또는 notEqualIgnoreCase을(를) 사용하여 대/소문자를 무시하면서 두 문자열 비교
  • startWith, endWith 및 대/소문자를 구분하지 않는 변형을 사용하여 문자열이 특정 접두사 또는 접미사로 시작되는지 또는 종료되는지 확인
  • substr을(를) 사용하여 인덱스 위치별로 하위 문자열 추출
  • replace 또는 replaceAll을(를) 사용하여 문자열에서 첫 번째 또는 모든 패턴을 바꿉니다.
  • split을(를) 사용하여 문자열을 구분 기호로 토큰 목록으로 분할합니다.
  • uuid을(를) 사용하여 고유 식별자 요구 사항에 대한 임의의 UUID 생성
  • isEmpty 또는 isNotEmpty을(를) 사용하여 문자열이 비어 있는지 또는 비어 있지 않은지 확인

용어집:

  • RegExp: replace, replaceAllmatchRegExp에서 대상 매개 변수로 사용되는 정규식 패턴입니다. 특수 문자는 \\(으)로 이스케이프해야 합니다.
  • UUID: Universal Unique IDentifier — uuid()에서 반환한 임의로 생성된 문자열 식별자입니다.
  • substr: 시작 인덱스 및 선택적 끝 인덱스(0부터 시작)를 지정하여 문자열의 일부를 추출합니다.

보호 기능:

  • replacereplaceAlltarget 매개 변수는 RegExp로 처리됩니다. 특수 문자(예: |, .)는 \\(으)로 이스케이프해야 합니다.
  • replace은(는) 일치하는 첫 번째 항목만 대체합니다. replaceAll을(를) 사용하여 모든 항목을 바꿉니다
  • isEmpty이(가) null 값(true 아님)에 대해 false를 반환합니다. null은 빈 문자열로 간주되지 않습니다.
  • 일치하는 항목이 없으면 indexOflastIndexOf에서 -1을 반환합니다.
  • 문자열 인덱스 위치는 0을 기반으로 합니다(첫 번째 문자는 위치 0에 있음).

용어:

  • 정식 이름: 문자열 함수 — 약어: 없음 — 변형: 텍스트 함수, 문자열 조작 함수
  • 동의어: “contain” = “substring check”; “split” = “tokenize string”; “trim” = “strip whitespace”
  • 혼동하지 마십시오. “replace”(첫 번째 발생만 해당) ≠ “replaceAll”(모든 발생)
  • 혼동하지 마십시오. “indexOf”(첫 번째 발생 위치) ≠ “lastIndexOf”(마지막 발생 위치)
  • 혼동하지 마십시오. “isEmpty”(길이가 0인 문자열에만 true) ≠ null 확인(isEmpty는 null에 대해 false를 반환)
  • 혼동하지 않음: “equalIgnoreCase”(대/소문자를 동일하게 무시하면 true 반환) ≠ “notEqualIgnoreCase”(대/소문자를 다르게 무시하면 true 반환)

FAQ:

  • Q: 대소문자에 관계없이 문자열에 하위 문자열이 포함되어 있는지 어떻게 확인합니까? — 어떤 경우든 검색어가 발견되면 true를 반환하는 containIgnoreCase("myString", "searchTerm")을(를) 사용합니다.
  • Q: replace과(와) replaceAll의 차이점은 무엇입니까?replace은(는) 일치하는 첫 번째 항목만 대체하고 replaceAll은(는) 문자열의 모든 항목을 대체합니다.
  • Q: replace에서 | 문자를 이스케이프해야 하는 이유는 무엇입니까? — 대상 매개 변수가 정규 표현식으로 처리됩니다. |은(는) 특수 RegExp 문자이며 리터럴 파이프로 처리되려면 \\|(으)로 이스케이프해야 합니다.
  • Q: isEmpty이(가) null에 대해 true를 반환합니까? — No, isEmpty은(는) null에 대해 false를 반환하고, 길이가 0인 문자열 ""에 대해서만 true를 반환합니다.
  • Q: "20.45.2.3434"와 같은 버전 문자열에서 주요 버전 번호를 추출하려면 어떻게 합니까?getListItem(split(@event{event.appVersion}, "\\."), 0)을(를) 사용하여 점을 기준으로 분할하고 첫 번째 요소를 검색합니다.
  • Q: 여정 식에서 고유 식별자를 어떻게 생성합니까? — 필요한 매개 변수 없이 임의로 생성된 UUID 문자열을 반환하는 uuid()을(를) 사용합니다.
recommendation-more-help
journey-optimizer-help