diff options
| author | Bill Meier <wmeier@newsguy.com> | 2010-10-22 15:00:37 +0000 |
|---|---|---|
| committer | Bill Meier <wmeier@newsguy.com> | 2010-10-22 15:00:37 +0000 |
| commit | 2041f87240d59e3085de91eb0c4cc74853dc4648 (patch) | |
| tree | 3d6880508452a1d8b58552534472140b44adb690 /doc | |
| parent | 5bf4fc31166cc9c16aa3bbf798dc3d1af83b510e (diff) | |
Add some info about extended value string to section 1.7.1
svn path=/trunk/; revision=34621
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/README.developer | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/README.developer b/doc/README.developer index fffd1d018e..21eb9f5329 100644 --- a/doc/README.developer +++ b/doc/README.developer @@ -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 |