

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# \$1nin
<a name="nin"></a>

`$nin`Operator digunakan untuk mencocokkan nilai yang tidak ada dalam array yang ditentukan. Ini adalah kebalikan dari `$in` operator, yang cocok dengan nilai-nilai yang ada dalam array yang ditentukan.

Perencana versi 2.0 menambahkan dukungan indeks untuk`$nin`.

**Parameter**
+ `field`: Bidang untuk memeriksa.
+ `array`: Array nilai untuk memeriksa terhadap.

 

**Dollar (`$`) dalam nama bidang**

Lihat [Dolar (\$1) dan titik (.) dalam nama bidang](functional-differences.md#functional-differences-dollardot) batasan terkait kueri bidang `$` awalan `$nin` di objek bersarang.

## Contoh (MongoDB Shell)
<a name="nin-examples"></a>

Contoh berikut menunjukkan bagaimana menggunakan `$nin` operator untuk menemukan dokumen di mana `category` bidang tidak sama dengan “Fiksi” atau “Misteri”.

**Buat dokumen sampel**

```
db.books.insertMany([
  { title: "The Great Gatsby", author: "F. Scott Fitzgerald", category: "Fiction" },
  { title: "To Kill a Mockingbird", author: "Harper Lee", category: "Fiction" },
  { title: "The Girl on the Train", author: "Paula Hawkins", category: "Mystery" },
  { title: "The Martian", author: "Andy Weir", category: "Science Fiction" },
  { title: "The Alchemist", author: "Paulo Coelho", category: "Philosophy" }
])
```

**Contoh kueri**

```
db.books.find({
  category: {
    $nin: ["Fiction", "Mystery"]
  }
})
```

**Keluaran**

```
[
  {
    _id: ObjectId('...'),
    title: 'The Martian',
    author: 'Andy Weir',
    category: 'Science Fiction'
  },
  {
    _id: ObjectId('...'),
    title: 'The Alchemist',
    author: 'Paulo Coelho',
    category: 'Philosophy'
  }
]
```

## Contoh kode
<a name="nin-code"></a>

Untuk melihat contoh kode untuk menggunakan `$nin` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function findBooksNotInCategories(categories) {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const books = await db.collection('books').find({
    category: {
      $nin: categories
    }
  }).toArray();
  console.log(books);
  client.close();
}

findBooksNotInCategories(['Fiction', 'Mystery']);
```

------
#### [ Python ]

```
from pymongo import MongoClient

def find_books_not_in_categories(categories):
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    books = list(db.books.find({
        'category': {
            '$nin': categories
        }
    }))
    print(books)
    client.close()

find_books_not_in_categories(['Fiction', 'Mystery'])
```

------