DOCSP-19389 available method (#175)

* added available method

Author: kyuan-mongodb

source/fundamentals/crud/read-operations/cursor.txt

@@ -58,6 +58,21 @@ results:
 This method is often used when your query filter will match one
 document, such as when filtering by a unique index.
 
+Number of Results
+~~~~~~~~~~~~~~~~~
+
+Use the ``available()`` method to retrieve the number of results
+locally present without blocking:
+
+.. literalinclude:: /includes/fundamentals/code-snippets/Cursor.java
+   :language: java
+   :dedent:
+   :start-after: begin availableExample
+   :end-before: end availableExample
+
+The method returns ``0`` if the application has already iterated though
+all the documents in the cursor or if the cursor is closed.
+
 Into
 ~~~~
 
@@ -124,6 +139,7 @@ For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
 
 - `first() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#first()>`__
+- `available() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCursor.html#available()>`__
 - `into() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#into(A)>`__
 - `cursor() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#cursor()>`__
 - `explain() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html#explain()>`__

source/includes/fundamentals/code-snippets/Cursor.java

@@ -39,6 +39,9 @@ public static void main(String [] args){
         System.out.println("First Example");
         c.firstExample();
 
+        System.out.println("Available Example");
+        c.availableExample();
+
         System.out.println("Explain Example");
         c.explainExample();
 
@@ -69,6 +72,13 @@ private void firstExample(){
         // end firstExample
     }
 
+    private void availableExample(){
+        // begin availableExample
+        MongoCursor<Document> cursor = collection.find().cursor();
+        System.out.println(cursor.available());
+        // end availableExample
+    }
+
     private void explainExample(){
         // begin explainExample
         Document explanation = collection.find().explain(ExplainVerbosity.EXECUTION_STATS);