User Tools

Site Tools


qword

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

qword [2007/03/02 02:32] (current)
Line 1: Line 1:
 +# $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 [[what is a word|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:​======
 +<​file>​
 +$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"
 +</​file>​
 +
 +======History:​======
 +This function first appeared in EPIC5-0.3.2.
 +
  
qword.txt ยท Last modified: 2007/03/02 02:32 (external edit)