- return $field . ($negate ? ' NOT IN ' : ' IN ' ) . '(' . implode(', ', array_map(array($this, '_sql_validate_value'), $array)) . ')';

- * @param $sql_ary array multi-dimensional array holding the statement data.

- * @param $table string table name to run the statements on

-* Modified by Acyd Burn to meet our coding standards

-*/

-

-/**

-* The PHP diff code used in this package was originally written by Geoffrey

-* T. Dairiki and is used with his permission.

-*

- * @param string $line The line to trim.

-* Modified by Acyd Burn to meet our coding standards

-*/

-

-/**

-* Modified by Acyd Burn to meet our coding standards

-*/

-

-/**

- * @param diff $diff A diff object.

-* @param $extra additional entropy

- * @param string needle is the string to search for

- * @return Returns the numeric position of the first occurrence of needle in the haystack string. Unlike strpos(), stripos() is case-insensitive.

- * @param string $keywords Contains the keyword as entered by the user

- * @return false if no valid keywords were found and otherwise true

- * @param array $id_ary passed by reference, to be filled with ids for the page specified by $start and $per_page, should be ordered

- * @param array $id_ary passed by reference, to be filled with ids for the page specified by $start and $per_page, should be ordered

- * @param boolean|string $error is passed by reference and should either be set to false on success or an error message on failure.

- * @param string $fields contains either titleonly (topic titles should be searched), msgonly (only message bodies should be searched), firstpost (only subject and body of the first post should be searched) or all (all post bodies and subjects should be searched)

- * @param string $terms is either 'all' (use query as entered, words without prefix should default to "have to be in field") or 'any' (ignore search query parts and just return all posts that contain any of the specified words)

- * @param array $sort_by_sql contains SQL code for the ORDER BY part of a query

- * @param string $sort_key is the key of $sort_by_sql for the selected sorting

- * @param string $sort_dir is either a or d representing ASC and DESC

- * @param string $sort_days specifies the maximum amount of days a post may be old

- * @param array $ex_fid_ary specifies an array of forum ids which should not be searched

- * @param array $m_approve_fid_ary specifies an array of forum ids in which the searcher is allowed to view unapproved posts

- * @param int $topic_id is set to 0 or a topic id, if it is not 0 then only posts in this topic should be searched

- * @param array $author_ary an array of author ids if the author should be ignored during the search the array is empty

- * @param array $id_ary passed by reference, to be filled with ids for the page specified by $start and $per_page, should be ordered

- * @param array $sort_by_sql contains SQL code for the ORDER BY part of a query

- * @param string $sort_key is the key of $sort_by_sql for the selected sorting

- * @param string $sort_dir is either a or d representing ASC and DESC

- * @param string $sort_days specifies the maximum amount of days a post may be old

- * @param array $ex_fid_ary specifies an array of forum ids which should not be searched

- * @param array $m_approve_fid_ary specifies an array of forum ids in which the searcher is allowed to view unapproved posts

- * @param int $topic_id is set to 0 or a topic id, if it is not 0 then only posts in this topic should be searched

- * @param array $author_ary an array of author ids

- * @param array $id_ary passed by reference, to be filled with ids for the page specified by $start and $per_page, should be ordered

- * @param string $message New or updated post content

- * @param string $subject New or updated post subject

- * @param int result_count will contain the number of all results for the search (not only for the current page)

- * @param array id_ary is filled with the ids belonging to the requested page that are stored in the cache

- * @param array id_ary contains a list of post or topic ids that shall be cached, the first element

- * Some Examples:

- * <code>

- * alter_block_array('loop', $vararray); // Insert vararray at the beginning

- * alter_block_array('loop', $vararray, 2); // Insert vararray at position 2

- * alter_block_array('loop', $vararray, array('KEY' => 'value')); // Insert vararray at the position where the key 'KEY' has the value of 'value'

- * alter_block_array('loop', $vararray, false); // Insert vararray at first position

- * alter_block_array('loop', $vararray, true); // Insert vararray at last position (assign_block_vars equivalence)

- * alter_block_array('loop', $vararray, 2, 'change'); // Change/Merge vararray with existing array at position 2

- * alter_block_array('loop', $vararray, array('KEY' => 'value'), 'change'); // Change/Merge vararray with existing array at the position where the key 'KEY' has the value of 'value'

- * alter_block_array('loop', $vararray, false, 'change'); // Change/Merge vararray with existing array at first position

- * alter_block_array('loop', $vararray, true, 'change'); // Change/Merge vararray with existing array at last position

- * </code>

- *

- * @param string $blockname the blockname, for example 'loop'

- * @param array $vararray the var array to insert/add or merge

- * @param mixed $key Key to search for

- * @param insert|change $mode Mode to execute

- * @return false on error, true on success

-* @param int $folder display folder with the id used

-* @param inbox|outbox|sentbox display folder with the associated name

-*

- * @param string $str Unchecked UTF string

- * @param integer $pos Position of the first UTF char (in bytes)

- * @param integer $len Length of the string (in bytes)

- * @param array $qc Quick-check array, passed by reference but never modified

- * @param array $decomp_map Decomposition mapping, passed by reference but never modified

- * @return string The string, validated and recomposed

- * @param string $str UTF string

- * @param integer $pos Position of the first UTF char (in bytes)

- * @param integer $len Length of the string (in bytes)

- * @param array $decomp_map Decomposition mapping, passed by reference but never modified

- * @return string The string, decomposed and sorted canonically

-* already done: strtolower, strtoupper, ucfirst, str_split, strrpos, strlen (hopefully!), strpos, substr

-* remaining: clean_username, htmlentities (no longer needed for internal data?), htmlspecialchars (using charset)

-* strspn, chr, ord

- * @param string $string UTF-8 encoded data

- * @param string haystack

- * @param string needle

- * @param integer (optional) offset (from left)

- * @param string haystack

- * @param string needle

- * @param integer offset in characters (from left)

- * @param string

- * @param integer number of UTF-8 characters offset (from left)

- * @param integer (optional) length in UTF-8 characters from offset

-* @param string UTF-8 encoded

-* @param int number to characters to split string by

-* @param string

-* @return int

-* @param integer $cp UNICODE code point

-* @return string UTF-8 char

-* - we do not convert NCRs recursively, if you pass &#38;#38; it will return &#38;

-* - we DO NOT check for the existence of the Unicode characters, therefore an entity

-* may be converted to an inexistent codepoint

-* @param string $text text to be case folded

-* @param string $option determines how we will fold the cases

-* @return string case folded text

-* @param mixed $strings a string or an array of strings to normalize

-* @return mixed the normalized content, preserving array keys if array given.

-* @param $text An unclean string, mabye user input (has to be valid UTF-8!)

-* @return Cleaned up version of the input string

- $ignored = (sizeof($search->common_words)) ? sprintf($user->lang['IGNORED_TERMS_EXPLAIN'], htmlspecialchars(implode(' ', $search->common_words))) . '<br />' : '';