The current implementation uses NSFItemConvertToText, which looks to convert only the first one. The docs indicate that NSFItemConvertValueToText is useful when there are multiple items by the same name, though the mechanics of that function imply that it'd be up to the caller to iterate over all such items.
It may be worth adding a secondary method to this to describe how to handle concatenating the values from multiple items. The use of a character for concatenating list-type items would be a reasonable default, but realistically what you'd want with e.g. a rich-text item is either no character or a different one, like a newline.
The current implementation uses NSFItemConvertToText, which looks to convert only the first one. The docs indicate that NSFItemConvertValueToText is useful when there are multiple items by the same name, though the mechanics of that function imply that it'd be up to the caller to iterate over all such items.
It may be worth adding a secondary method to this to describe how to handle concatenating the values from multiple items. The use of a character for concatenating list-type items would be a reasonable default, but realistically what you'd want with e.g. a rich-text item is either no character or a different one, like a newline.