TS-2360 Improve the example slightly, but it is still an example

Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/b187978b
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/b187978b
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/b187978b

Branch: refs/heads/master
Commit: b187978b8992f7625073081ad053e41e3704ab4d
Parents: 7195488
Author: Leif Hedstrom <[email protected]>
Authored: Mon Nov 18 22:14:02 2013 -0700
Committer: Leif Hedstrom <[email protected]>
Committed: Mon Nov 18 22:14:02 2013 -0700

----------------------------------------------------------------------
 doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/b187978b/doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst 
b/doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst
index aacc6af..feec628 100644
--- a/doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst
+++ b/doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst
@@ -73,13 +73,15 @@ does not have date-time semantics always returns :data:`0`.
 Examples
 ========
 
+This examples show how to retrieve and copy a specific header.
+
 ::
 
     #include <string.h>
     #include <ts/ts.h>
 
     int
-    get_content_type(TSHttpTxn txnp, char* buf)
+    get_content_type(TSHttpTxn txnp, char* buf, size_t buf_size)
     {
       TSMBuffer bufp;
       TSMLoc hdrs;
@@ -92,6 +94,8 @@ Examples
         if (TS_NULL_MLOC != ctype_field) {
           const char* str = TSMimeHdrFieldValueStringGet(bufp, hdrs, 
ctype_field, -1, &len);
 
+          if (len > buf_size)
+            len = buf_size;
           memcpy(buf, str, len);
           TSHandleMLocRelease(bufp, hdrs, ctype_field);
         }

Reply via email to