[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3  *
   4  * This file is part of the phpBB Forum Software package.
   5  *
   6  * @copyright (c) phpBB Limited <https://www.phpbb.com>
   7  * @license GNU General Public License, version 2 (GPL-2.0)
   8  *
   9  * For full copyright and license information, please see
  10  * the docs/CREDITS.txt file.
  11  *
  12  */
  13  
  14  namespace phpbb\request;
  15  
  16  /**
  17  * An interface for type cast operations.
  18  */
  19  interface type_cast_helper_interface
  20  {
  21      /**
  22      * Recursively applies addslashes to a variable.
  23      *
  24      * @param    mixed    &$var    Variable passed by reference to which slashes will be added.
  25      */
  26  	public function addslashes_recursively(&$var);
  27  
  28      /**
  29      * Recursively applies addslashes to a variable if magic quotes are turned on.
  30      *
  31      * @param    mixed    &$var    Variable passed by reference to which slashes will be added.
  32      */
  33  	public function add_magic_quotes(&$var);
  34  
  35      /**
  36      * Set variable $result to a particular type.
  37      *
  38      * @param mixed    &$result    The variable to fill
  39      * @param mixed    $var        The contents to fill with
  40      * @param mixed    $type        The variable type. Will be used with {@link settype()}
  41      * @param bool    $multibyte    Indicates whether string values may contain UTF-8 characters.
  42      *                             Default is false, causing all bytes outside the ASCII range (0-127) to be replaced with question marks.
  43      */
  44  	public function set_var(&$result, $var, $type, $multibyte = false);
  45  
  46      /**
  47      * Recursively sets a variable to a given type using {@link set_var set_var}.
  48      *
  49      * @param    string    $var        The value which shall be sanitised (passed by reference).
  50      * @param    mixed    $default    Specifies the type $var shall have.
  51      *                                 If it is an array and $var is not one, then an empty array is returned.
  52      *                                 Otherwise var is cast to the same type, and if $default is an array all
  53      *                                 keys and values are cast recursively using this function too.
  54      * @param    bool    $multibyte    Indicates whether string keys and values may contain UTF-8 characters.
  55      *                                 Default is false, causing all bytes outside the ASCII range (0-127) to
  56      *                                 be replaced with question marks.
  57      */
  58  	public function recursive_set_var(&$var, $default, $multibyte);
  59  }