.\" Man page generated from reStructuredText. . .TH "MONGOC_MATCHER_NEW" "3" "Feb 23, 2019" "1.14.0" "MongoDB C Driver" .SH NAME mongoc_matcher_new \- mongoc_matcher_new() . .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 .. .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); .ft P .fi .UNINDENT .UNINDENT .sp Create a new \fBmongoc_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 \fBbson_error_t\fP or \fBNULL\fP\&. .UNINDENT .SH ERRORS .sp Errors are propagated via the \fBerror\fP parameter. .SH RETURNS .sp A newly allocated \fBmongoc_matcher_t\fP that should be freed with \fBmongoc_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. .