$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>
의 인덱스를 반환합니다.
다양한 동작을 강조하기 위한 몇 가지 짧은 예:
예제 | 결과 |
---|---|
{ $indexOfBytes: [ "cafeteria", "e" ] } | 3 |
{ $indexOfBytes: [ "cafétéria", "é" ] } | 3 |
{ $indexOfBytes: [ "cafétéria", "e" ] } | -1 |
{ $indexOfBytes: [ "cafétéria", "t" ] } | 5 |
{ $indexOfBytes: [ "foo.bar.fi", ".", 5 ] } | 7 |
{ $indexOfBytes: [ "vanilla", "ll", 0, 2 ] } | -1 |
{ $indexOfBytes: [ "vanilla", "ll", -1 ] } | -1 |
{ $indexOfBytes: [ "vanilla", "ll", 12 ] } | -1 |
{ $indexOfBytes: [ "vanilla", "ll", 5, 2 ] } | -1 |
{ $indexOfBytes: [ "vanilla", "nilla", 3 ] } | -1 |
{ $indexOfBytes: [ null, "foo" ] } | null |
예제
다음 문서가 포함된 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 }