Editing WoW:API GetTradePlayerItemLink

{{wowapi}}

<!-- Describe the purpose of the function, exhausting detail can be saved for a later section -->
Returns a single value: chat-ready item link.

<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->
chatItemLink = GetTradePlayerItemLink(ID);

== Parameters ==
=== Arguments ===
<!-- List each argument, together with its type -->
:(ID)

:;ID : numeric - index value of the "player's" (your character) trade slots (starts at 1 and proceeds to 6.  7 may be used for the will-not-be-traded-slot.)

=== Returns ===
;''Returns''
<!-- List each return value, together with its type -->
:chatItemLink

:;chatItemLink : String - a string that can be used to link items in the chat log

== Example ==
<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory -->
 for i = 1, 7 do
   chatItemLink = GetTradePlayerItemLink(i);
 end

<!-- If it helps, include example results here, though they are not required-->

==Details==
<!-- Details not appropriate for the main description can go here -->

: Remember, chatItemLink(s) are different than itemLink parameters needed by many APIs.  To properly extract an itemLink from a chatItemLink, here is a neat function:
 --[[ Function: extractItemLinkFromChatItemLink
      Purpose: gets an item link string from a chat item link string
      Note: don't ask questions, it works
   ]]
 function extractItemLinkFromChatItemLink(message)
   local _, _, _, _itemLink = string.find(message, "(|H(.+)|h)");
   _, _, _itemLink = string.find(_itemLink, "(.-|h)");
   return _itemLink;
 end

: Here is a chatItemLink Example:

 |cffffffff|Hitem:3771:0:0:0|h[Wild Hog Shank]|h|r

: Here is an itemLink Example:

 item:3771:0:0:0

----
__NOTOC__