summaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
authorKeith Bostic <keith.bostic@wiredtiger.com>2011-10-20 09:07:45 +0000
committerKeith Bostic <keith.bostic@wiredtiger.com>2011-10-20 09:07:45 +0000
commitc9bc27b2b0447f7a93e93ee1c95f039b8b5b6b02 (patch)
tree3647344f7c564d291895c48aba79b436cf952c1a /examples
parentb424256e1c8d350a8bbe9516828b0c04979d6b24 (diff)
downloadmongo-c9bc27b2b0447f7a93e93ee1c95f039b8b5b6b02.tar.gz
Add code comments in places where there are multiple examples to explain
how the examples are different. Add examples of setting/getting WT_ITEM (raw) key/values. Fix a bug where cursor->remove said the value had to be set.
Diffstat (limited to 'examples')
-rw-r--r--examples/c/ex_all.c28
1 files changed, 24 insertions, 4 deletions
diff --git a/examples/c/ex_all.c b/examples/c/ex_all.c
index bd9a1451ab9..797800a029c 100644
--- a/examples/c/ex_all.c
+++ b/examples/c/ex_all.c
@@ -41,27 +41,35 @@ cursor_ops(WT_SESSION *session)
{
/*! [Get the cursor's string key] */
- const char *key;
+ const char *key; /* Get the cursor's string key. */
ret = cursor->get_key(cursor, &key);
/*! [Get the cursor's string key] */
}
{
/*! [Get the cursor's record number key] */
- uint64_t recno;
+ uint64_t recno; /* Get the cursor's record number key. */
ret = cursor->get_key(cursor, &recno);
/*! [Get the cursor's record number key] */
}
{
/*! [Get the cursor's string value] */
- const char *value;
+ const char *value; /* Get the cursor's string value. */
ret = cursor->get_value(cursor, &value);
/*! [Get the cursor's string value] */
}
{
+ /*! [Get the cursor's raw value] */
+ WT_ITEM value; /* Get the cursor's raw value. */
+ ret = cursor->get_value(cursor, &value);
+ /*! [Get the cursor's raw value] */
+ }
+
+ {
/*! [Set the cursor's string key] */
+ /* Set the cursor's string key. */
const char *key = "another key";
cursor->set_key(cursor, key);
/*! [Set the cursor's string key] */
@@ -69,17 +77,26 @@ cursor_ops(WT_SESSION *session)
{
/*! [Set the cursor's record number key] */
- uint64_t recno = 37;
+ uint64_t recno = 37; /* Set the cursor's record number key. */
cursor->set_key(cursor, recno);
/*! [Set the cursor's record number key] */
}
{
/*! [Set the cursor's string value] */
+ /* Set the cursor's string value. */
const char *value = "another value";
cursor->set_value(cursor, value);
/*! [Set the cursor's string value] */
}
+ {
+ /*! [Set the cursor's raw value] */
+ WT_ITEM value; /* Set the cursor's raw value. */
+ value.data = "another value";
+ value.size = strlen("another value");
+ cursor->set_value(cursor, &value);
+ /*! [Set the cursor's raw value] */
+ }
/*! [Return the first key/value pair] */
ret = cursor->first(cursor);
@@ -109,6 +126,7 @@ cursor_ops(WT_SESSION *session)
{
/*! [Insert a new record] */
+ /* Insert a new record. */
const char *key = "some key";
const char *value = "some value";
cursor->set_key(cursor, key);
@@ -119,6 +137,7 @@ cursor_ops(WT_SESSION *session)
{
/*! [Insert a new record or overwrite an existing record] */
+ /* Insert a new record or overwrite an existing record. */
const char *key = "some key";
const char *value = "some value";
ret = session->open_cursor(
@@ -131,6 +150,7 @@ cursor_ops(WT_SESSION *session)
{
/*! [Insert a new record and assign a record number] */
+ /* Insert a new record and assign a record number. */
uint64_t recno;
const char *value = "some value";
ret = session->open_cursor(