.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "MONGOC_MATCHER_NEW" "3" "Oct 20, 2022" "1.23.1" "libmongoc" .SH NAME mongoc_matcher_new \- mongoc_matcher_new() .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C mongoc_matcher_t * mongoc_matcher_new (const bson_t *query, bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT BSON_GNUC_DEPRECATED; .ft P .fi .UNINDENT .UNINDENT .sp Create a new \fI\%mongoc_matcher_t\fP using the query specification provided. .SH DEPRECATED .sp \fBWARNING:\fP .INDENT 0.0 .INDENT 3.5 \fBmongoc_matcher_t\fP is deprecated and will be removed in version 2.0. .UNINDENT .UNINDENT .SH PARAMETERS .INDENT 0.0 .IP \(bu 2 \fBquery\fP: A \fI\%bson_t\fP\&. .IP \(bu 2 \fBerror\fP: An optional location for a \fI\%bson_error_t\fP or \fBNULL\fP\&. .UNINDENT .SH ERRORS .sp Errors are propagated via the \fBerror\fP parameter. .SH RETURNS .sp A newly allocated \fI\%mongoc_matcher_t\fP that should be freed with \fI\%mongoc_matcher_destroy()\fP when no longer in use. Upon failure, \fBNULL\fP is returned and \fBerror\fP is set. This could happen if \fBquery\fP contains an invalid query specification. .SH AUTHOR MongoDB, Inc .SH COPYRIGHT 2017-present, MongoDB, Inc .\" Generated by docutils manpage writer. .