EndsWith 및 StartsWith 함수

  • 아티클

적용 대상: 캔버스 앱 데스크톱 흐름 Dataverse 수식 열 모델 기반 앱 Power Platform CLI

텍스트 문자열이 다른 텍스트 문자열로 시작되거나 끝나는지 테스트합니다.

설명

EndsWith 함수는 텍스트 문자열이 다른 텍스트 문자열로 끝나는지 테스트합니다.

StartsWith 함수는 텍스트 문자열이 다른 텍스트 문자열로 시작하는지 테스트합니다.

두 함수 모두 테스트에서 대/소문자를 구분하지 않습니다. 두 함수의 반환 값은 부울 true 또는 false입니다.

EndsWith와 StartsWith를 Filter 함수와 함께 사용하여 앱 내의 데이터를 검색합니다. in 연산자나 Search 함수를 사용하여 시작이나 끝뿐만 아니라 텍스트 문자열 내 어디든지 볼 수 있습니다. 함수의 선택은 앱의 필요에 따라 달라지며 특정 데이터 원본에 대해 위임할 수 있는 함수에 따라 달라집니다. 이러한 함수 중 위임할 수 없는 함수가 있으면 이러한 제한 사항을 경고하기 위해 수식 작성 시 위임 경고가 표시됩니다.

구문

EndsWith( Text, EndText )

  • Text - 필수 항목입니다. 테스트할 텍스트입니다.
  • EndText – 필수 항목입니다. Text의 끝에서 검색할 텍스트입니다. EndText가 빈 문자열이면 EndsWith는 true를 반환합니다.

StartsWith( Text, StartText )

  • Text - 필수 항목입니다. 테스트할 텍스트입니다.
  • StartText – 필수 항목입니다. Text의 시작 부분에서 검색할 텍스트입니다. StartText가 빈 문자열이면 StartsWith는 true를 반환합니다.

예제

수식 설명 결과
EndsWith( "Hello World", "world" ) "Hello World"가 "world"로 끝나는지 테스트합니다. 이 테스트는 대/소문자를 구분하지 않습니다. true
EndsWith( "Good bye", "good" ) "Good bye"가 "good"으로 끝나는지 테스트합니다. EndText 인수("good")가 텍스트에 나타나지만 끝에 나타나지는 않습니다. false
EndsWith( "Always say hello", "hello" ) "Always say hello"가 "hello"로 끝나는지 테스트합니다. true
EndsWith( "Bye bye", "" ) "Bye bye"가 빈 텍스트 문자열(Len이 0을 반환함)로 끝나는지 테스트합니다. Filter 식에서 사용을 줄이면, 이런 경우 EndsWith가 true를 반환하도록 정의됩니다. true
수식 설명 결과
StartsWith( "Hello World", "hello" ) "Hello World"가 "hello"로 시작하는지 테스트합니다. 이 테스트는 대/소문자를 구분하지 않습니다. true
StartsWith( "Good bye", "hello" ) "Good bye"가 "hello"로 시작하는지 테스트합니다. false
StartsWith( "Always say hello", "hello" ) "Always say hello"가 "hello"로 시작하는지 테스트합니다. "hello"가 텍스트에 나타나지만 처음에 나타나지는 않습니다. false
StartsWith( "Bye bye", "" ) "Bye bye"가 빈 텍스트 문자열(Len이 0을 반환함)로 시작하는지 테스트합니다. Filter 식에서 사용을 줄이면, 이런 경우 StartsWith가 true를 반환하도록 정의됩니다. true

검색 사용자 환경

많은 앱에서 하나 이상의 문자를 검색 상자에 입력하여 대규모 데이터 집합의 레코드 목록을 필터링할 수 있습니다. 입력하는 동안 검색 조건과 일치하는 레코드만 목록에 표시됩니다.

이 항목의 나머지 부분에 있는 예제는 다음 데이터가 포함된 Customers 목록을 검색한 결과를 보여줍니다.

고객 목록 예시.

이 데이터 원본을 컬렉션으로 만들려면 [Button] 컨트롤을 만들고 OnSelect 속성을 다음 수식으로 설정하십시오.

ClearCollect( Customers, Table( { Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" } ) )

이 예제에서처럼 화면 하단의 Gallery 컨트롤에 레코드 목록을 표시할 수 있습니다. 화면 상단 가까이에 SearchInput이라는 Text input 컨트롤을 추가할 수 있고, 사용자는 관심 있는 레코드를 지정할 수 있습니다.

고객 갤러리.

사용자가 SearchInput에 문자를 입력하면 갤러리의 결과가 자동으로 필터링됩니다. 이 경우 갤러리는 SearchInput의 문자 순서로 시작하는 고객 이름(회사 이름 아님)에 대한 레코드를 표시하도록 구성됩니다. 사용자가 검색 상자에 co를 입력하면 갤러리에 다음 결과가 표시됩니다.

검색 기능이 있는 고객 갤러리.

Name 열을 기준으로 필터링하려면 갤러리 컨트롤의 Items 속성을 다음 수식 중 하나로 설정하십시오.

수식 설명 결과
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Name 열의 시작 부분에 검색 문자열이 나타나는 레코드에 대해 Customers 데이터 원본을 필터링합니다. 이 테스트는 대/소문자를 구분하지 않습니다. 사용자가 검색 상자에 co를 입력하면 갤러리에 Colleen Jones와 Cole Miller가 표시됩니다. Mike Collins는 해당 레코드의 Name 열이 검색 문자열로 시작하지 않기 때문에 갤러리에 표시되지 않습니다. StartsWith의 예시.
Filter( Customers, SearchInput.Text in Name ) Name 열의 아무 곳에나 나타나는 검색 문자열의 레코드에 대해 Customers 데이터 원본을 필터링합니다. 이 테스트는 대/소문자를 구분하지 않습니다. 사용자가 검색 상자에 co를 입력하면 이러한 레코드의 Name 열 어딘가에 검색 문자열이 나타나기 때문에 갤러리에 Colleen Jones, Cole Miller 및 Mike Collins가 표시됩니다. Name 내 SearchInput.Text의 예시.
Search( Customers, SearchInput.Text, "Name" ) in 연산자를 사용하는 경우와 유사하게, Search 함수는 각 레코드의 Name 열 내에서 일치하는 항목을 검색합니다. 열 이름은 큰따옴표로 묶어야 합니다. Name을 포함하는 SearchInput.Text의 예시.

Company 열과 Name 열을 포함하도록 검색 범위를 확장할 수 있습니다.

수식 설명 결과
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) 검색 문자열(예: co)로 시작하는 Name 열 또는 Company 열의 레코드에 대해 Customers 데이터 원본을 필터링합니다. StartsWith 함수 중 하나가 true이면 || 연산자는 true입니다. StartsWith으로 필터링.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) 검색 문자열(예: co)이 포함된 Name 열 또는 Company 열의 레코드에 대해 Customers 데이터 원본을 필터링합니다. 이름에서 검색 텍스트로 필터링.
Search( Customers, SearchInput.Text, "Name", "Company" ) in 연산자를 사용하는 경우와 유사하게, Search 함수는 검색 문자열(예: co)이 포함된 Name 열 또는 Company 열의 레코드에 대해 Customers 데이터 원본을 검색합니다. 여러 열 및 다수의 in 연산자를 지정하는 경우 Search 함수가 Filter보다 읽고 쓰기가 쉽습니다. 열 이름은 큰따옴표로 묶어야 합니다. 이름, 회사에서 검색 텍스트로 필터링.