add wrap function 'mongoc_stream_write'.

Closes #130

Author: lloydzhou

build/autotools/versions.ldscript

@@ -180,6 +180,7 @@ LIBMONGOC_1.0 {
         mongoc_stream_tls_check_cert;
         mongoc_stream_tls_do_handshake;
         mongoc_stream_tls_new;
+        mongoc_stream_write;
         mongoc_stream_writev;
         mongoc_uri_copy;
         mongoc_uri_destroy;
@@ -237,6 +238,7 @@ LIBMONGOC_1.1 {
         mongoc_socket_check_closed
         mongoc_socket_inet_ntop
         mongoc_stream_check_closed
+        mongoc_stream_write
         mongoc_uri_get_credentials;
         mongoc_uri_get_mechanism_properties;
 } LIBMONGOC_1.0;

build/cmake/libmongoc-ssl.def

@@ -197,6 +197,8 @@ mongoc_stream_socket_new
 mongoc_stream_tls_check_cert
 mongoc_stream_tls_do_handshake
 mongoc_stream_tls_new
+mongoc_stream_write
+mongoc_stream_write
 mongoc_stream_writev
 mongoc_uri_copy
 mongoc_uri_destroy

build/cmake/libmongoc.def

@@ -188,6 +188,8 @@ mongoc_stream_readv
 mongoc_stream_setsockopt
 mongoc_stream_socket_get_socket
 mongoc_stream_socket_new
+mongoc_stream_write
+mongoc_stream_write
 mongoc_stream_writev
 mongoc_uri_copy
 mongoc_uri_destroy

doc/mongoc_stream_read.page

@@ -48,6 +48,7 @@ mongoc_stream_read (mongoc_stream_t *stream,
   <section id="seealso">
     <title>See Also</title>
     <p><link xref="mongoc_stream_readv">mongoc_stream_readv()</link></p>
+    <p><link xref="mongoc_stream_write">mongoc_stream_write()</link></p>
     <p><link xref="mongoc_stream_writev">mongoc_stream_writev()</link></p>
   </section>
 

doc/mongoc_stream_readv.page

@@ -48,6 +48,7 @@ mongoc_stream_readv (mongoc_stream_t *stream,
   <section id="seealso">
     <title>See Also</title>
     <p><link xref="mongoc_stream_read">mongoc_stream_read()</link></p>
+    <p><link xref="mongoc_stream_write">mongoc_stream_write()</link></p>
     <p><link xref="mongoc_stream_writev">mongoc_stream_writev()</link></p>
   </section>
 

doc/mongoc_stream_write.page

@@ -0,0 +1,53 @@
+<?xml version="1.0"?>
+
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic"
+      style="function"
+      xmlns:api="http://projectmallard.org/experimental/api/"
+      xmlns:ui="http://projectmallard.org/experimental/ui/"
+      id="mongoc_stream_write">
+
+
+  <info>
+    <link type="guide" xref="mongoc_stream_t" group="function"/>
+  </info>
+  <title>mongoc_stream_write()</title>
+
+  <section id="synopsis">
+    <title>Synopsis</title>
+    <synopsis><code mime="text/x-csrc"><![CDATA[ssize_t
+mongoc_stream_write (mongoc_stream_t *stream,
+                    void            *buf,
+                    size_t           count,
+                    int32_t          timeout_msec);
+]]></code></synopsis>
+  </section>
+
+
+  <section id="parameters">
+    <title>Parameters</title>
+    <table>
+      <tr><td><p>stream</p></td><td><p>A <link xref="mongoc_stream_t">mongoc_stream_t</link>.</p></td></tr>
+      <tr><td><p>buf</p></td><td><p>The buffer to write.</p></td></tr>
+      <tr><td><p>count</p></td><td><p>The number of bytes to write.</p></td></tr>
+      <tr><td><p>timeout_msec</p></td><td><p>The number of milliseconds to wait before failure, a timeout of 0 will not block. If negative, use the default timeout.</p></td></tr>
+    </table>
+  </section>
+
+  <section id="description">
+    <p>The <link xref="mongoc_stream_read">mongoc_stream_write()</link> function shall perform a write to a <link xref="mongoc_stream_t">mongoc_stream_t</link>. It's modeled on the API and semantics of <code>write()</code>, though the parameters map only loosely.</p>
+  </section>
+
+  <section id="return">
+    <title>Returns</title>
+    <p>The <link xref="mongoc_stream_write">mongoc_stream_write</link> function returns the number of bytes write on success. It returns <code>&gt;= 0</code> and <code>&lt; min_bytes</code> when end-of-file is encountered and <code>-1</code> on failure. <code>errno</code> is set upon failure.</p>
+  </section>
+
+  <section id="seealso">
+    <title>See Also</title>
+    <p><link xref="mongoc_stream_read">mongoc_stream_read()</link></p>
+    <p><link xref="mongoc_stream_readv">mongoc_stream_readv()</link></p>
+    <p><link xref="mongoc_stream_writev">mongoc_stream_writev()</link></p>
+  </section>
+
+</page>

src/libmongoc.symbols

@@ -196,6 +196,7 @@ mongoc_stream_socket_new
 mongoc_stream_tls_check_cert
 mongoc_stream_tls_do_handshake
 mongoc_stream_tls_new
+mongoc_stream_write
 mongoc_stream_writev
 mongoc_uri_copy
 mongoc_uri_destroy

src/mongoc/mongoc-stream.c

@@ -131,6 +131,40 @@ mongoc_stream_writev (mongoc_stream_t *stream,
    RETURN (ret);
 }
 
+/**
+ * mongoc_stream_write:
+ * @stream: A mongoc_stream_t.
+ * @buf: A buffer to write.
+ * @count: The number of bytes to write into @buf.
+ *
+ * Simplified access to mongoc_stream_writev(). Creates a single iovec
+ * with the buffer provided.
+ *
+ * Returns: -1 on failure, otherwise the number of bytes write.
+ */
+ssize_t
+mongoc_stream_write (mongoc_stream_t *stream,
+                     void            *buf,
+                     size_t           count,
+                     int32_t          timeout_msec)
+{
+   mongoc_iovec_t iov;
+   ssize_t ret;
+
+   ENTRY;
+
+   bson_return_val_if_fail (stream, -1);
+   bson_return_val_if_fail (buf, -1);
+
+   iov.iov_base = buf;
+   iov.iov_len = count;
+
+   BSON_ASSERT (stream->writev);
+
+   ret = mongoc_stream_writev (stream, &iov, 1, timeout_msec);
+
+   RETURN (ret);
+}
 
 /**
  * mongoc_stream_readv:

src/mongoc/mongoc-stream.h

@@ -65,6 +65,10 @@ ssize_t          mongoc_stream_writev          (mongoc_stream_t       *stream,
                                                 mongoc_iovec_t        *iov,
                                                 size_t                 iovcnt,
                                                 int32_t                timeout_msec);
+ssize_t          mongoc_stream_write           (mongoc_stream_t       *stream,
+                                                void                  *buf,
+                                                size_t                 count,
+                                                int32_t                timeout_msec);
 ssize_t          mongoc_stream_readv           (mongoc_stream_t       *stream,
                                                 mongoc_iovec_t        *iov,
                                                 size_t                 iovcnt,