Add some info about extended value string to section 1.7.1
authorwmeier <wmeier@f5534014-38df-0310-8fa8-9805f1628bb7>
Fri, 22 Oct 2010 15:00:37 +0000 (15:00 +0000)
committerwmeier <wmeier@f5534014-38df-0310-8fa8-9805f1628bb7>
Fri, 22 Oct 2010 15:00:37 +0000 (15:00 +0000)
git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@34621 f5534014-38df-0310-8fa8-9805f1628bb7

doc/README.developer

index fffd1d0..21eb9f5 100644 (file)
@@ -2729,7 +2729,7 @@ clicks as well, launching the configured browser with this URL as parameter.
 
 1.7 Utility routines.
 
-1.7.1 match_strval and val_to_str.
+1.7.1 match_strval, match_strval_ext, val_to_str and val_to_str_ext.
 
 A dissector may need to convert a value to a string, using a
 'value_string' structure, by hand, rather than by declaring a field with
@@ -2764,6 +2764,17 @@ You can use it in a call to generate a COL_INFO line for a frame such as
 
        col_add_fstr(COL_INFO, ", %s", val_to_str(val, table, "Unknown %d"));
 
+The match_strval_ext and val_to_str_ext functions are "extended" versions
+of match_strval and val_to_str. They should be used for large value-string
+arrays which contain many entries. They implement value to string conversions
+which will do either a direct access or a binary search of the
+value string array if possible. See "Extended Value Strings" under
+section  1.6 "Constructing the protocol tree" for more information.
+
+See epan/value_string.h for detailed information on the various value_string
+functions.
+
+
 1.7.2 match_strrval and rval_to_str.
 
 A dissector may need to convert a range of values to a string, using a