# $EPIC: qword.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $
Synopsis:
Technical:
If the <index> argument is omitted, the empty string is returned.
If the <list> argument is omitted, the empty string is returned.
The <index> argument is taken as an integer number.
If <index> is a negative number, the empty string is returned.
The return value is the <index>th word in <list>, counting from zero.
Remember that <list> is always a list of
words.
In either case, if the return value is double-quoted if it contains a space.
If <index> is greater than the number of words in <list>, the empty string is returned.
Practical:
Use this function when you need to extract a specific word from a list.
Returns:
The <index>th word in <list>, counting from zero.
Compatability:
Examples:
$qword(2 foo bar blah) returns blah
xdebug -dword
$qword(1 one "two three" four five) returns "two
xdebug dword
$qword(1 one "two three" four five) returns "two three"
History:
This function first appeared in EPIC5-0.3.2.