TS-2360 Fix usage of TSMimeHdrFieldValueStringGet() in some plugins.

This also adds Sphinx docs for the TSMimeHdrFieldValueStringGet() and
family of APIs. Finally, it also adds a regression test for the -1
IDX argument.
Added TS-2360.
TS-2360 Improve the example slightly, but it is still an example