Site Tools


qword

# $EPIC: qword.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $

Synopsis:

$qword(<index> <list>)

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:

<ugh. this is a mess>

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.

qword.txt · Last modified: 2007/03/02 02:32 by 127.0.0.1