$indexOfCP (애그리게이션)

정의

$indexOfCP

버전 3.4에 새로 추가되었습니다.

문자열에서 하위 문자열의 발생을 검색하고 UTF-8 코드 포인트 를 반환합니다. 첫 번째 항목의 인덱스(0부터 시작)입니다. 부분 문자열을 찾을 수 없으면 -1 을 반환합니다.

$indexOfCP 에는 다음과 같은 연산자 표현식 구문이 있습니다.

{ $indexOfCP: [ <string expression>, <substring expression>, <start>, <end> ] }

필드	유형	설명
<string>	문자열	문자열로 해석되는 한 모든 유효한 표현식 일 수 있습니다. 표현식에 대한 자세한 내용은 표현식을 참조하세요 . 문자열 표현식이 null 값으로 해석되거나 누락된 필드를 참조하는 경우 $indexOfCP 는 null 를 반환합니다. 문자열 표현식이 문자열 또는 null 로 해석되지 않거나 누락된 필드를 참조하는 경우 $indexOfCP 는 오류를 반환합니다.
<substring>	문자열	문자열로 해석되는 한 모든 유효한 표현식 일 수 있습니다. 표현식에 대한 자세한 내용은 표현식을 참조하세요 .
<start>	integer	선택 사항. 정수 또는 검색의 시작 인덱스 위치를 지정하는 정수(예: 2.0)로 표시할 수 있는 숫자입니다. 음수가 아닌 정수로 해석되는 유효한 표현식이 될 수 있습니다. 지정하지 않으면 검색의 시작 인덱스 위치는 문자열의 시작입니다.
<end>	integer	선택 사항. 검색의 끝 인덱스 위치를 지정하는 정수 또는 정수(예: 2.0)로 표시될 수 있는 숫자입니다. 음수가 아닌 정수로 해석되는 모든 유효한 표현식 일 수 있습니다. <end> 인덱스 값을 지정하는 경우 <start> 인덱스 값도 지정해야 합니다. 그렇지 않으면 $indexOfCP 는 <end> 값 대신 <start> 인덱스 값으로 <end> 값을 사용합니다. 지정하지 않으면 검색의 끝 인덱스 위치는 문자열의 끝입니다.

행동

<substring expression> 이 <string expression> 내에서 여러 번 발견되면 $indexOfCP 는 시작 인덱스 위치에서 처음 발견된 <substring expression> 의 인덱스를 반환합니다.

$indexOfCP null은 를 반환합니다.

• <string expression>이(가) null인 경우, 또는

• <string expression>이 입력 문서에 존재하지 않는 필드를 참조하는 경우

$indexOfCP 은(는) 오류를 반환합니다.

• <string expression> 가 문자열이 아니고 null이 아닌 경우 또는

• <substring expression> 가 null이거나 문자열이 아니거나 입력 문서에 존재하지 않는 필드를 참조하는 경우 또는

• <start> 또는 <end>가 음의 정수(또는 -5.0과 같이 음의 정수로 표시될 수 있는 값)인 경우

$indexOfCP -1은 를 반환합니다.

• <string expression> 에서 부분 문자열을 찾을 수 없는 경우 또는

• <start>가 <end>보다 큰 숫자인 경우 또는

• <start> 가 문자열의 바이트 길이보다 큰 숫자인 경우

예제

다음 문서가 포함된 inventory 컬렉션을 생각해 보세요.

{ "_id" : 1, "item" : "foo" }
{ "_id" : 2, "item" : "fóofoo" }
{ "_id" : 3, "item" : "the foo bar" }
{ "_id" : 4, "item" : "hello world fóo" }
{ "_id" : 5, "item" : null }
{ "_id" : 6, "amount" : 3 }

다음 연산은 $indexOfCP 연산자를 사용하여 각 item 문자열에서 foo 문자열이 위치한 코드 포인트 인덱스를 반환합니다.

db.inventory.aggregate(
   [
     {
       $project:
          {
            cpLocation: { $indexOfCP: [ "$item", "foo" ] },
          }
      }
   ]
)

이 연산은 다음과 같은 결과를 반환합니다.

{ "_id" : 1, "cpLocation" : "0" }
{ "_id" : 2, "cpLocation" : "3" }
{ "_id" : 3, "cpLocation" : "4" }
{ "_id" : 4, "cpLocation" : "-1" }
{ "_id" : 5, "cpLocation" : null }
{ "_id" : 6, "cpLocation" : null }