<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:59:43 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[CXX-604] Documentation for mongocxx::collection::find_one doesn&apos;t specify what happens if the document isn&apos;t found</title>
                <link>https://jira.mongodb.org/browse/CXX-604</link>
                <project id="11980" key="CXX">C++ Driver</project>
                    <description>&lt;p&gt;The documentation for mongocxx::collection::find_one says that it throws a mongocxx::exception::query exception if the query fails. It&apos;s not clear whether failure is meant to include the case where no documents are returned. It appears that the actual behavior is to return an instance of the return type with the value set to nullopt. This needs to be described. An example of use would also be useful and welcome.&lt;/p&gt;</description>
                <environment>Any</environment>
        <key id="206337">CXX-604</key>
            <summary>Documentation for mongocxx::collection::find_one doesn&apos;t specify what happens if the document isn&apos;t found</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="matt.cotter">Matt Cotter</assignee>
                                    <reporter username="sdeerwester">Scott Deerwester</reporter>
                        <labels>
                    </labels>
                <created>Mon, 25 May 2015 22:52:32 +0000</created>
                <updated>Mon, 16 Nov 2015 18:02:14 +0000</updated>
                            <resolved>Fri, 13 Nov 2015 20:42:14 +0000</resolved>
                                                                    <component>API</component>
                    <component>Documentation</component>
                                        <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="1088290" author="matt.cotter" created="Fri, 13 Nov 2015 20:41:56 +0000"  >&lt;p&gt;Hi Scott,&lt;/p&gt;

&lt;p&gt;We think the docs are pretty much fine as is. When we say that the return is &quot;&lt;span class=&quot;error&quot;&gt;&amp;#91;a&amp;#93;&lt;/span&gt;n optional document&quot;, we mean that (as you&apos;ve pointed out) the find_one command may not be able to return a document because no documents match. In that case, the return will be &lt;tt&gt;stdx::nullopt&lt;/tt&gt; (just as you&apos;ve deduced). This will only throw if the command itself errors (ex: an unauthenticated user tries a find).&lt;/p&gt;

&lt;p&gt;We&apos;re going to close this, but please feel free to re-open if you need!&lt;/p&gt;

&lt;p&gt;-Matt&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>CXX-668</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrenbj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                    <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="723">Platform C (11/20/15)</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>