Click above to get retro games delivered to your door ever month!

 pickstring()        Return list string with hot-key markers eliminated
------------------------------------------------------------------------------
 Declaration
   pick.hdr

 Syntax
   func char pickstring extern
   param value _SLIST gHandle, ;
         value uint   uItem

 Arguments
   pList is a list pointer.
   uItem is a list item index.

 Return
   List item as character string, with any hot-key marker character
   contained in the list item eliminated.

 Description
   The pickstring() function returns the string associated with the list
   index value uItem.

   This function can only be used with string lists, but not with generic
   lists that contain non-character data.

 Example
   #define EXAMPLE_LIST
   #include example.hdr

   proc Test_pickstring
   vardef
      _SLIST pList
   enddef
   pList := pickinit()
   pickadd( pList, "&First item" )
   pickadd( pList, "Seco$nd item" )
   ? "Hot character is", chr( pickhotch( pList ) )
   ? pickstring( pList, 1 )
   ? pickstring( pList, 2 )
   ?
   picksethotch( pList, '$' )
   ? "Hot character is", chr( pickhotch( pList ) )
   ? pickstring( pList, 1 )
   ? pickstring( pList, 2 )
   ?
   ? "pickstr() shows all hot key marker characters as well"
   ? pickstr( pList, 1 )
   ? pickstr( pList, 2 )
   ?
   pickclear( pList )
   endproc

   proc main
   Test_pickstring()
   endproc