$indexOfCP (집계)
정의
$indexOfCP
string 문자열에서 하위 의 발생을 검색하고 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
string에서 foo
string이 있는 코드 포인트 인덱스를 반환합니다.
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 }