====== Pick(index, text_list, delimiter) ====== Category: Special function \\ =====Description===== This function returns the value in //index// position within //text_list//, a list of text values separated by //delimiter//. \\ =====Use cases===== This function makes it possible to define EasyMorph expressions externally using parameters. \\ =====Arguments===== ^Argument^Type^Description^ |index|Number|The position of the value to return from //text_list//.| |text_list|Text|A text-based delimited list of values to search for //value//.| |delimiter|Text|The character(s) used to separate the individual values in //text_list//. This can be more than one character.| **Return value type:** Text \\ =====Remarks===== Regardless of what the return value appears to be (number, Boolean, text), this function //always// returns a text value. The values in the delimited string (//text_list//) are always considered text, even if they look like a number. This function returns an empty value if //index// exceeds the number of delimited values in //text_list//. //Delimiter// may contain more than one character. \\ =====Examples===== pick(3, 'Please don’t stop the music', ' ') //Returns 'stop' pick(2, '2,4,6,8,10,12', ',') //Returns '4' (This is a text value, not a number.) pick(5, 'Sally;Bob;Mary;Sue', ';') //Returns an empty value (Only 4 values within the text list.) \\ =====See also===== * [[syntax:functions:in|In(text, look_in, delimiter)]] * [[syntax:functions:match|Match(value, text_list, delimiter)]] * [[transformations:group|Action: Group]]