Add the C, CPP, JavaRS, KotlinC, KotlinSync, PHP, Ruby Getting Started Code

README.md

@@ -6,10 +6,16 @@ includes its own setup instructions.
 
 ## Available Client Libraries
 
+- [C](c/hello-world/README.md)
+- [C++](cpp/hello-world/README.md)
 - [.NET/C#](dotnet/hello-world/README.md)
 - [Go](go/hello-world/README.md)
-- [Java](java/hello-world/README.md)
+- [Java Reactive Streams](java-rs/hello-world/README.md)
+- [Java Sync](java/hello-world/README.md)
+- [Kotlin Coroutines](kotlin-coroutine/hello-world/README.md)
+- [Kotlin Sync](kotlin-sync/hello-world/README.md)
 - [Node.js](node/hello-world/README.md)
+- [PHP](php/hello-world/README.md)
 - [Python](python/hello-world/README.md)
 
 ## Prerequisites

c/hello-world/.gitignore

@@ -0,0 +1 @@
+build/

c/hello-world/CMakeLists.txt

@@ -0,0 +1,10 @@
+cmake_minimum_required(VERSION 3.15)
+project(hello-world C)
+
+set(CMAKE_C_STANDARD 11)
+set(CMAKE_C_STANDARD_REQUIRED ON)
+
+find_package(mongoc 2.0 REQUIRED)
+
+add_executable(hello-world hello-world.c)
+target_link_libraries(hello-world PRIVATE mongoc::mongoc)

c/hello-world/README.md

@@ -0,0 +1,124 @@
+# Get Started with the MongoDB C Driver
+
+This sample application connects to a MongoDB deployment, seeds a small
+set of sample product documents, and retrieves one of them. Because the
+app inserts its own data, you don't need to load an external dataset.
+
+## Prerequisites
+
+Before you begin, complete the [Atlas Get Started guide](https://www.mongodb.com/docs/get-started/)
+to create a free Atlas deployment and save your database user
+credentials.
+
+You also need the following components installed in your development environment:
+
+- CMake 3.15 or later
+- A C11-compatible compiler
+- [vcpkg](https://github.com/microsoft/vcpkg) (Windows and Linux)
+
+The commands in this guide assume a Bash compatible shell.
+
+## Installation
+
+Clone this repository:
+
+```bash
+git clone https://github.com/mongodb/docs-get-started
+```
+
+### Install the MongoDB C Driver
+
+This project requires MongoDB C driver 2.0 or later. Install it with your
+platform's package manager.
+
+<details open>
+<summary><strong>macOS / Linux </strong></summary>
+
+On macOS, install the MongoDB C driver with [Homebrew](https://brew.sh/):
+
+```bash
+brew install mongo-c-driver
+```
+
+On Linux, most distribution packages are too old to satisfy this
+requirement. Use vcpkg instead:
+
+```bash
+vcpkg install mongo-c-driver
+```
+
+Navigate into the project directory, then configure and build:
+
+```bash
+cd docs-get-started/c/hello-world
+cmake -S . -B build
+cmake --build build
+```
+
+If you installed the driver with vcpkg, add the vcpkg toolchain file to
+the configure step so CMake can locate it, replacing `<vcpkg root>` with
+your vcpkg installation path:
+
+```bash
+cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=<vcpkg root>/scripts/buildsystems/vcpkg.cmake
+```
+</details>
+
+<details open>
+<summary><strong>Windows </strong></summary>
+
+On Windows, use vcpkg to install the MongoDB C driver:
+
+```bash
+vcpkg install mongo-c-driver
+```
+
+Navigate into the project directory, then configure and build:
+
+```bash
+cd docs-get-started/c/hello-world
+cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=<vcpkg root>/scripts/buildsystems/vcpkg.cmake
+cmake --build build --config Release
+```
+
+Replace `<vcpkg root>` with your vcpkg installation path.
+</details>
+
+For other installation methods, see the
+[C driver installation guide](https://www.mongodb.com/docs/languages/c/c-driver/current/get-started/).
+
+## Connect to MongoDB
+
+Set your connection string as an environment variable, replacing
+`<connection string uri>` with your connection string:
+
+```bash
+export MONGODB_URI="<connection string uri>"
+```
+
+## Run the Application
+
+On macOS and Linux, run the following command:
+
+```bash
+./build/hello-world
+```
+
+On Windows, use the following command instead:
+
+```bash
+./build/Release/hello-world.exe
+```
+
+When you run the app, it inserts a few product documents into the
+`get_started.products` collection, then queries and prints one of them:
+
+```
+{ "_id" : ObjectId("..."), "name" : "Wireless Mouse", "category" : "Electronics", "price" : NumberDecimal("24.99"), "tags" : ["wireless", "usb", "ergonomic"] }
+```
+
+You can run the app more than once. It clears the collection before
+each run, so the results stay consistent.
+
+If you encounter an error or see no output, verify that you set the
+`MONGODB_URI` environment variable correctly.

c/hello-world/hello-world.c

@@ -0,0 +1,164 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <mongoc/mongoc.h>
+
+typedef struct {
+   const char *name;
+   const char *category;
+   const char *price;
+   const char *tags[8];
+   size_t tag_count;
+} sample_product_t;
+
+/* A few sample product documents seeded by this app so you can run it
+ * without loading an external dataset. */
+static const sample_product_t sample_products[] = {
+   {"Wireless Mouse", "Electronics", "24.99", {"wireless", "usb", "ergonomic"}, 3},
+   {"Standing Desk", "Furniture", "349.99", {"adjustable", "office"}, 2},
+   {"Noise-Cancelling Headphones", "Electronics", "199.99", {"bluetooth", "wireless", "over-ear"}, 3},
+};
+
+#define SAMPLE_PRODUCT_COUNT (sizeof (sample_products) / sizeof (sample_products[0]))
+
+static bson_t *
+product_to_bson (const sample_product_t *product)
+{
+   bson_t *doc = bson_new ();
+   bson_decimal128_t price;
+   bson_array_builder_t *tags;
+
+   bson_decimal128_from_string (product->price, &price);
+   BSON_APPEND_UTF8 (doc, "name", product->name);
+   BSON_APPEND_UTF8 (doc, "category", product->category);
+   BSON_APPEND_DECIMAL128 (doc, "price", &price);
+
+   bson_append_array_builder_begin (doc, "tags", -1, &tags);
+   for (size_t i = 0; i < product->tag_count; i++) {
+      bson_array_builder_append_utf8 (tags, product->tags[i], -1);
+   }
+   bson_append_array_builder_end (doc, tags);
+
+   return doc;
+}
+
+/* Prints a product document using MongoDB Shell-style formatting,
+ * preserving types such as ObjectId and NumberDecimal. */
+static void
+print_shell_product (const bson_t *product)
+{
+   bson_iter_t iter;
+   bson_oid_t oid;
+   char oid_str[25];
+
+   printf ("{ ");
+
+   if (bson_iter_init_find (&iter, product, "_id")) {
+      bson_oid_copy (bson_iter_oid (&iter), &oid);
+      bson_oid_to_string (&oid, oid_str);
+      printf ("\"_id\" : ObjectId(\"%s\"), ", oid_str);
+   }
+
+   if (bson_iter_init_find (&iter, product, "name")) {
+      printf ("\"name\" : \"%s\", ", bson_iter_utf8 (&iter, NULL));
+   }
+
+   if (bson_iter_init_find (&iter, product, "category")) {
+      printf ("\"category\" : \"%s\", ", bson_iter_utf8 (&iter, NULL));
+   }
+
+   if (bson_iter_init_find (&iter, product, "price")) {
+      bson_decimal128_t price;
+      char price_str[BSON_DECIMAL128_STRING];
+      bson_iter_decimal128 (&iter, &price);
+      bson_decimal128_to_string (&price, price_str);
+      printf ("\"price\" : NumberDecimal(\"%s\"), ", price_str);
+   }
+
+   if (bson_iter_init_find (&iter, product, "tags")) {
+      bson_iter_t tags_iter;
+      bool first = true;
+
+      printf ("\"tags\" : [");
+      BSON_ASSERT (bson_iter_recurse (&iter, &tags_iter));
+      while (bson_iter_next (&tags_iter)) {
+         printf ("%s\"%s\"", first ? "" : ", ", bson_iter_utf8 (&tags_iter, NULL));
+         first = false;
+      }
+      printf ("]");
+   }
+
+   printf (" }\n");
+}
+
+int
+main (void)
+{
+   mongoc_client_t *client;
+   mongoc_collection_t *products;
+   const char *uri_string;
+   bson_t empty_filter = BSON_INITIALIZER;
+   bson_t name_filter = BSON_INITIALIZER;
+   bson_t *inserts[SAMPLE_PRODUCT_COUNT];
+   bson_error_t error;
+   const bson_t *product;
+   mongoc_cursor_t *cursor;
+   int exit_code = EXIT_SUCCESS;
+
+   uri_string = getenv ("MONGODB_URI");
+   if (!uri_string) {
+      fprintf (stderr, "Set the MONGODB_URI environment variable before running this app.\n");
+      return EXIT_FAILURE;
+   }
+
+   mongoc_init ();
+
+   client = mongoc_client_new (uri_string);
+   if (!client) {
+      fprintf (stderr, "Failed to parse MONGODB_URI.\n");
+      mongoc_cleanup ();
+      return EXIT_FAILURE;
+   }
+
+   products = mongoc_client_get_collection (client, "get_started", "products");
+
+   /* Seed the collection so the app has data to query. Clearing the
+    * collection first keeps results consistent across repeated runs. */
+   if (!mongoc_collection_delete_many (products, &empty_filter, NULL, NULL, &error)) {
+      fprintf (stderr, "Delete failed: %s\n", error.message);
+      exit_code = EXIT_FAILURE;
+      goto cleanup;
+   }
+
+   for (size_t i = 0; i < SAMPLE_PRODUCT_COUNT; i++) {
+      inserts[i] = product_to_bson (&sample_products[i]);
+   }
+   if (!mongoc_collection_insert_many (
+          products, (const bson_t **) inserts, SAMPLE_PRODUCT_COUNT, NULL, NULL, &error)) {
+      fprintf (stderr, "Insert failed: %s\n", error.message);
+      exit_code = EXIT_FAILURE;
+   }
+   for (size_t i = 0; i < SAMPLE_PRODUCT_COUNT; i++) {
+      bson_destroy (inserts[i]);
+   }
+   if (exit_code == EXIT_FAILURE) {
+      goto cleanup;
+   }
+
+   BSON_APPEND_UTF8 (&name_filter, "name", "Wireless Mouse");
+   cursor = mongoc_collection_find_with_opts (products, &name_filter, NULL, NULL);
+   if (mongoc_cursor_next (cursor, &product)) {
+      print_shell_product (product);
+   } else if (mongoc_cursor_error (cursor, &error)) {
+      fprintf (stderr, "Query failed: %s\n", error.message);
+      exit_code = EXIT_FAILURE;
+   }
+   mongoc_cursor_destroy (cursor);
+
+cleanup:
+   bson_destroy (&name_filter);
+   mongoc_collection_destroy (products);
+   mongoc_client_destroy (client);
+   mongoc_cleanup ();
+
+   return exit_code;
+}

cpp/hello-world/.gitignore

@@ -0,0 +1 @@
+build/

cpp/hello-world/CMakeLists.txt

@@ -0,0 +1,12 @@
+cmake_minimum_required(VERSION 3.15)
+
+project(hello-world CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+find_package(mongocxx 4.0 REQUIRED)
+
+add_executable(hello-world main.cpp)
+
+target_link_libraries(hello-world PRIVATE mongo::mongocxx_shared)