$indexOfBytes (애그리게이션)

정의

$indexOfBytes

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

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

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

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

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

행동

• <string expression> 가 null이면 $indexOfBytes 은 null 을 반환합니다.

• 문서에 존재하지 않는 필드에서 $indexOfBytes 가 호출되면 $indexOfBytes 은 null 을 반환합니다.

• <string expression> 이(가) string 이 아니고 null이 아닌 경우 $indexOfBytes 은(는) 오류를 반환합니다.

• <substring expression> 이 null이면 $indexOfBytes 는 오류를 반환합니다.

• <start> 또는 <end> 이 음수인 경우 $indexOfBytes 는 오류를 반환합니다.

• <start> 이 <end> 보다 큰 숫자인 경우 $indexOfBytes 는 -1 을 반환합니다.

• <start> 이 string 의 바이트 길이보다 큰 숫자인 경우 $indexOfBytes 는 -1를 반환합니다.

• <start> 또는 <end> 에 정수가 아닌 값이 지정되면 $indexOfBytes 는 오류를 반환합니다.

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

다양한 동작을 강조하기 위한 몇 가지 짧은 예:

예제

다음 문서가 포함된 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 }

다음 작업은 $indexOfBytes 연산자를 사용하여 각 항목에서 문자열 foo 가 있는 인덱스를 검색합니다.

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

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

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