ドキュメントをカウント

サンプル データ

このガイドの例では、Atlas サンプルデータセットの sample_mflix データベースの movies コレクションを使用します。MongoDB Atlasクラスターを無料で作成して、サンプルデータセットをロードする方法については、MongoDBを使い始めるガイドを参照してください。

すべてのドキュメントをカウントする

コレクション内のすべてのドキュメントの数を返すには、次の例に示すように、空のクエリフィルターを指定して mongoc_collection_count_documents() 関数を呼び出します。

bson_error_t error;
bson_t *empty_query = bson_new();
int64_t count = 
    mongoc_collection_count_documents(collection, empty_query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(empty_query);

21349

特定のドキュメントのカウント

特定の検索条件に一致するドキュメントの数を返すには、mongoc_collection_count_documents() 関数でクエリを指定します。 次の例では、 moviesコレクション内の yearフィールド値が 1930 に等しいすべてのドキュメントの数を出力します。

bson_error_t error;
bson_t *query = BCON_NEW("year", BCON_INT32(1930));
int64_t count =
    mongoc_collection_count_documents(collection, query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(query);

10

カウント動作をカスタマイズする

mongoc_collection_count_documents() 関数は、カウント操作を構成するために使用できるオプションのセットを表す bson_t 構造の形式で任意のパラメータを受け入れます。 オプションを指定しない場合、ドライバーは カウント操作をカスタマイズしません。

次の表では、 countDocuments()をカスタマイズするために設定できるオプションについて説明しています。

オプションの完全なリストについては、APIドキュメント mongoc_collection_count_documents() のを参照してください。

次の例では、 bson_t 構造を使用して mongoc_collection_count_documents()操作にコメントを追加します。

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_count_documents(collection, bson_new(), opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

21349

推定カウント動作をカスタマイズ

mongoc_collection_estimated_document_count() 関数は、カウント操作 を構成するために使用できるオプションを表す bson_t 構造の形式で任意のパラメータを受け入れます。 オプションを指定しない場合、ドライバーは カウント操作をカスタマイズしません。

次の表では、 mongoc_collection_estimated_document_count()をカスタマイズするために設定できるオプションについて説明しています。

オプションの完全なリストについては、APIドキュメント mongoc_collection_estimated_document_count() のを参照してください。

次の例では、 bson_t 構造を使用して mongoc_collection_estimated_document_count()操作にコメントを追加します。

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_estimated_document_count(collection, opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

21349