# php_manual

id: getenv
type: function
doc:
<comment>Description:</comment>
  Restituisce il valore di una variabile d'ambiente
  
  Restituisce il valore della variabile d'ambiente
  
  Si può vedere una lista di tutte le variabili d'ambiente utilizzando <strong>phpinfo()</strong>. Molte di queste
  variabili sono elencate all'interno dell' RFC 3875, nello specifico sezione 4.1, "Request
  Meta-Variables".

<comment>Param:</comment>
  <info>string</info>  <strong>$varname</strong>  Il nome della variabile.

<comment>Return:</comment>
  <info>string</info>  Restituisce il valore della variabile d'ambiente <strong>$varname</strong>, oppure <info>false</info> se la variabile
          d'ambiente <strong>$varname</strong> non esiste.

<comment>See Also:</comment>
   * <strong>putenv()</strong>
   * <strong>apache_getenv()</strong>
   * Variabili Superglobal


id: gethostbyname
type: function
doc:
<comment>Description:</comment>
  Ottiene l'indirizzo IP corrispondente a un dato hostname Internet


id: gethostbynamel
type: function
doc:
<comment>Description:</comment>
  Ottiene la lista degli indirizzi IP corrispondenti a un dato hostname 
       Internet


id: gethostname
type: function
doc:
<comment>Description:</comment>
  Gets the host name
  
  <strong>gethostname()</strong> gets the standard host name for  the local machine.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string with the hostname on success, otherwise <info>false</info> is  returned.

<comment>See Also:</comment>
   * <strong>gethostbyname()</strong>
   * <strong>gethostbyaddr()</strong>
   * <strong>php_uname()</strong>


id: getimagesize
type: function
doc:
<comment>Description:</comment>
  Get the size of an image
  
  The <strong>getimagesize()</strong> function will determine the size of any supported given image file and return
  the dimensions along with the file type and a <return>height/width</return> text string to be used inside a normal
  HTML IMG tag and the correspondent HTTP content type.
  
  <strong>getimagesize()</strong> can also return some more information in <strong>$image_info</strong> parameter.
  
  This function expects <strong>$filename</strong> to be a valid image file. If a non-image file is supplied, it may
  be incorrectly detected as an image and the function will return successfully, but the array may
  contain nonsensical values.
  
  Do not use <strong>getimagesize()</strong> to check that a given file is a valid image. Use a purpose-built
  solution such as the Fileinfo extension instead.
  
  Note that JPC and JP2 are capable of having components with different  bit depths. In this case,
  the value for "bits" is the highest bit depth encountered. Also, JP2 files may contain <return>multiple
  JPEG 2000 codestreams</return>. In this case, <strong>getimagesize()</strong> returns the values for the first codestream it
  encounters in the root of the file.
  
  The information about icons are retrieved from the icon with the highest bitrate.
  
  GIF images consist of one or more frames, where each frame may only occupy part of the image. The
  size of the image which is reported by <strong>getimagesize()</strong> is the overall size (read from the logical
  screen descriptor).

<comment>Param:</comment>
  <info>string</info>  <strong>$filename  </strong>  This parameter specifies the file you wish to retrieve information about. It
                       can reference a local file or (configuration permitting) a remote file using
                       one of the supported streams.
  <info>array </info>  <strong>$image_info</strong>  This optional parameter allows you to extract some extended information from
                       the image file. Currently, this will return the different JPG APP markers as
                       an associative array. Some programs use these APP markers to embed text
                       information in  images. A very common one is to embed  IPTC information in
                       the APP13 marker. You can use the <strong>iptcparse()</strong> function to parse the binary
                       APP13 marker into something readable.
                       
                       The <strong>$image_info</strong> only supports JFIF files.

<comment>Return:</comment>
  <info>arrayfalse</info>  Returns an array with up to 7 elements. Not all image types will include the <return>channels</return>
              and <return>bits</return> elements.
              
              Index 0 and 1 contains respectively the width and the height of the image.
              
              Some formats may contain no image or may contain multiple images. In these cases,
              <strong>getimagesize()</strong> might not be able to properly determine the image size. <strong>getimagesize()</strong>
              will return zero for width and height in these cases.
              
              Index 2 is one of the IMAGETYPE_XXX constants indicating  the type of the image.
              
              Index 3 is a text string with the correct  <return>height="yyy" width="xxx"</return> string that can be
              used directly in an IMG tag.
              
              <return>mime</return> is the correspondant MIME type of the image. This information can be used to
              deliver images with the correct HTTP  <return>Content-type</return> header: <strong>getimagesize()</strong> and MIME
              types
              ]]>
              
              <return>channels</return> will be 3 for RGB pictures and 4 for CMYK pictures.
              
              <return>bits</return> is the number of bits for each color.
              
              For some image types, the presence of <return>channels</return> and <return>bits</return> values can be a bit confusing.
              As an example, GIF always uses 3 channels per pixel, but the number of bits per pixel
              cannot be calculated for an animated GIF with a global color table.
              
              On failure, <info>false</info> is returned.

<comment>See Also:</comment>
   * <strong>image_type_to_mime_type()</strong>
   * <strong>exif_imagetype()</strong>
   * <strong>exif_read_data()</strong>
   * <strong>exif_thumbnail()</strong>
   * <strong>imagesx()</strong>
   * <strong>imagesy()</strong>


id: getimagesizefromstring
type: function
doc:
<comment>Description:</comment>
  Get the size of an image from a string
  
  Identical to <strong>getimagesize()</strong> except that <strong>getimagesizefromstring()</strong> accepts a string instead of a
  file name as the first parameter.
  
  See the <strong>getimagesize()</strong> documentation for details on how this function works.

<comment>Param:</comment>
  <info>string</info>  <strong>$string    </strong>  The image data, as a string.
  <info>array </info>  <strong>$image_info</strong>  See <strong>getimagesize()</strong>.

<comment>Return:</comment>
  <info>arrayfalse</info>  See <strong>getimagesize()</strong>.

<comment>See Also:</comment>
   * <strong>getimagesize()</strong>


id: getmxrr
type: function
doc:
<comment>Description:</comment>
  Ottiene i record MX corrispondenti a un dato nome di host Internet


id: getprotobyname
type: function
doc:
<comment>Description:</comment>
  Ottiene il numero del protocollo associato al nome del protocollo


id: getprotobynumber
type: function
doc:
<comment>Description:</comment>
  Ottiene il nome del protocollo associato al numero del protocollo


id: getservbyname
type: function
doc:
<comment>Description:</comment>
  Ottiene il numero di porta associato ad un servizio Internet e ad un protocollo


id: getservbyport
type: function
doc:
<comment>Description:</comment>
  Ottiene il servizio Internet corrispondente ad una porta e ad un protocollo


id: gettext
type: function
doc:
<comment>Description:</comment>
  Lookup a message in the current domain
  
  Looks up a message in the current domain.

<comment>Param:</comment>
  <info>string</info>  <strong>$message</strong>  The message being translated.

<comment>Return:</comment>
  <info>string</info>  Returns a translated <info>string</info> if one is found in the  translation table, or the submitted
          message if not found.

<comment>See Also:</comment>
   * <strong>setlocale()</strong>


id: gettimeofday
type: function
doc:
<comment>Description:</comment>
  Restituisce l'orario attuale
  
  Questa è un'interfaccia a gettimeofday(2). Restituisce un array associativo che contiene i dati
  restituiti dalla chiamata di sistema.

<comment>Param:</comment>
  <info>bool</info>  <strong>$return_float</strong>  Quando impostato a <info>true</info>, viene restituito un float invece di un array.

<comment>Return:</comment>
  <info>mixed</info>  Per impostazione predefinita viene restituito un <info>array</info>. Se <strong>$return_float</strong> è impostato,
         allora viene restituito un <info>float</info>.
         
         Chiavi dell'array:  "sec" - secondi dalla Unix Epoch  "usec" - microsecondi  "minuteswest"
         - minuti a ovest di Greenwich  "dsttime" - tipo di correzione dst
         
         "sec" - secondi dalla Unix Epoch
         
         "usec" - microsecondi
         
         "minuteswest" - minuti a ovest di Greenwich
         
         "dsttime" - tipo di correzione dst


id: gettype
type: function
doc:
<comment>Description:</comment>
  Resituisce il tipo di una variabile
  
  Resituisce il tipo della variabile PHP <strong>$var</strong>. Per controllare il tipo, utilizzare le funzioni <return>is_*</return>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$var</strong>  La variabile di cui controllare il tipo.

<comment>Return:</comment>
  <info>string</info>  I valori possibili per la stringa restituita sono:  "<info>boolean</info>"  "<info>integer</info>"  "<info>double</info>" (per
          ragioni storiche viene restituito "double" nel caso di un <info>float</info>, e non semplicemente
          "float")  "<info>string</info>"  "<info>array</info>"  "<info>object</info>"  "<info>resource</info>"  "<info>NULL</info>"  "unknown type"
          
          "<info>boolean</info>"
          
          "<info>integer</info>"
          
          "<info>double</info>" (per ragioni storiche viene restituito "double" nel caso di un <info>float</info>, e non
          semplicemente "float")
          
          "<info>string</info>"
          
          "<info>array</info>"
          
          "<info>object</info>"
          
          "<info>resource</info>"
          
          "<info>NULL</info>"
          
          "unknown type"

<comment>See Also:</comment>
   * <strong>settype()</strong>
   * <strong>get_class()</strong>
   * <strong>is_array()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_callable()</strong>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_null()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_object()</strong>
   * <strong>is_resource()</strong>
   * <strong>is_scalar()</strong>
   * <strong>is_string()</strong>
   * <strong>function_exists()</strong>
   * <strong>method_exists()</strong>


id: glob
type: function
doc:
<comment>Description:</comment>
  Find pathnames matching a pattern
  
  The <strong>glob()</strong> function searches for all the pathnames matching <strong>$pattern</strong> according to the rules used
  by the libc glob() function, which is similar to the rules used by common shells.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  The pattern. No tilde expansion or parameter substitution is done.
                    
                    Special characters: <return>*</return> - Matches zero or more characters. <return>?</return> - Matches exactly one
                    character (any character). <return>[...]</return> - Matches one character from a group of
                    characters. If the first character is <return>!</return>, matches any character not in the group.
                    <return>\</return> - Escapes the following character, except when the <info>GLOB_NOESCAPE</info> flag is used.
                    
                    <return>*</return> - Matches zero or more characters.
                    
                    <return>?</return> - Matches exactly one character (any character).
                    
                    <return>[...]</return> - Matches one character from a group of characters. If the first character
                    is <return>!</return>, matches any character not in the group.
                    
                    <return>\</return> - Escapes the following character, except when the <info>GLOB_NOESCAPE</info> flag is used.
  <info>int   </info>  <strong>$flags  </strong>  Valid flags: <info>GLOB_MARK</info> - Adds a slash (a backslash on Windows) to each directory
                    returned <info>GLOB_NOSORT</info> - Return files as they appear in the directory (no
                    sorting). When this flag is not used, the pathnames are sorted alphabetically
                    <info>GLOB_NOCHECK</info> - Return the search pattern if no files matching it were found
                    <info>GLOB_NOESCAPE</info> - Backslashes do not quote metacharacters <info>GLOB_BRACE</info> - Expands
                    {a,b,c} to match 'a', 'b', or 'c' <info>GLOB_ONLYDIR</info> - Return only directory entries
                    which match the pattern <info>GLOB_ERR</info> - Stop on read errors (like unreadable
                    directories), by default errors are ignored.   The <info>GLOB_BRACE</info> flag is not
                    available on some non GNU systems, like Solaris.
                    
                    <info>GLOB_MARK</info> - Adds a slash (a backslash on Windows) to each directory returned
                    
                    <info>GLOB_NOSORT</info> - Return files as they appear in the directory (no sorting). When
                    this flag is not used, the pathnames are sorted alphabetically
                    
                    <info>GLOB_NOCHECK</info> - Return the search pattern if no files matching it were found
                    
                    <info>GLOB_NOESCAPE</info> - Backslashes do not quote metacharacters
                    
                    <info>GLOB_BRACE</info> - Expands {a,b,c} to match 'a', 'b', or 'c'
                    
                    <info>GLOB_ONLYDIR</info> - Return only directory entries which match the pattern
                    
                    <info>GLOB_ERR</info> - Stop on read errors (like unreadable directories), by default errors
                    are ignored.
                    
                    The <info>GLOB_BRACE</info> flag is not available on some non GNU systems, like Solaris.

<comment>Return:</comment>
  <info>arrayfalse</info>  Returns an array containing the matched files/directories, an empty array if no file
              matched or <info>false</info> on error.
              
              On some systems it is impossible to distinguish between empty match and an error.

<comment>See Also:</comment>
   * <strong>opendir()</strong>
   * <strong>readdir()</strong>
   * <strong>closedir()</strong>
   * <strong>fnmatch()</strong>


id: gmdate
type: function
doc:
<comment>Description:</comment>
  Formatta una data/ora GMT/UTC
  
  Identica alla funzione <strong>date()</strong> eccetto che l'orario restituito è Greenwich Mean Time (GMT).

<comment>Param:</comment>
  <info>string</info>  <strong>$format   </strong>  Il formato della data restituita è <info>string</info>. Vedere le opzioni di formattazione
                      per la funzione <strong>date()</strong>.
  <info>int   </info>  <strong>$timestamp</strong>  Il parametro opzionale <strong>$timestamp</strong> è un 
                      <info>integer</info> timestamp Unix che ha come default
                      l'ora locale attuale se un <strong>$timestamp</strong> non è fornito. In altre 
                      parole, ha come default il valore di <strong>time()</strong>.

<comment>Return:</comment>
  <info>string</info>  Restituisce una stringa di data formattata. Se viene usato un valore non numerico per
          <strong>$timestamp</strong>, viene restituito <info>false</info> e viene  emesso un errore di livello <info>E_WARNING</info>.

<comment>See Also:</comment>
   * <strong>date()</strong>
   * <strong>mktime()</strong>
   * <strong>gmmktime()</strong>
   * <strong>strftime()</strong>


id: gmp_binomial
type: function
doc:
<comment>Description:</comment>
  Calculates binomial coefficient
  
  Calculates the binomial coefficient C(n, k).

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$n</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                    stringa numerica dal momento che è possibile convertire quest'ultimo in un
                    numero.
  <info>int         </info>  <strong>$k</strong>  

<comment>Return:</comment>
  <info>GMP</info>  Returns the binomial coefficient C(n, k).


id: gmp_export
type: function
doc:
<comment>Description:</comment>
  Export to a binary string
  
  Export a GMP number to a binary string

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num      </strong>  The GMP number being exported
  <info>int         </info>  <strong>$word_size</strong>  Default value is 1. The number of bytes in each chunk of binary data.
                            This is mainly used in conjunction with the options parameter.
  <info>int         </info>  <strong>$flags    </strong>  Default value is GMP_MSW_FIRST | GMP_NATIVE_ENDIAN.

<comment>Return:</comment>
  <info>string</info>  Returns a string.

<comment>See Also:</comment>
   * <strong>gmp_import()</strong>


id: gmp_import
type: function
doc:
<comment>Description:</comment>
  Import from a binary string
  
  Import a GMP number from a binary string

<comment>Param:</comment>
  <info>string</info>  <strong>$data     </strong>  The binary string being imported
  <info>int   </info>  <strong>$word_size</strong>  Default value is 1. The number of bytes in each chunk of binary data. This is
                      mainly used in conjunction with the options parameter.
  <info>int   </info>  <strong>$flags    </strong>  Default value is GMP_MSW_FIRST | GMP_NATIVE_ENDIAN.

<comment>Return:</comment>
  <info>GMP</info>  Returns a GMP number.

<comment>See Also:</comment>
   * <strong>gmp_export()</strong>


id: gmp_kronecker
type: function
doc:
<comment>Description:</comment>
  Kronecker symbol
  
  This function computes the Kronecker symbol of <strong>$num1</strong> and <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num1</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                       stringa numerica dal momento che è possibile convertire quest'ultimo in un
                       numero.
  <info>GMPintstring</info>  <strong>$num2</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                       stringa numerica dal momento che è possibile convertire quest'ultimo in un
                       numero.

<comment>Return:</comment>
  <info>int</info>  Returns the Kronecker symbol of <strong>$num1</strong> and <strong>$num2</strong>

<comment>See Also:</comment>
   * <strong>gmp_jacobi()</strong>
   * <strong>gmp_legendre()</strong>


id: gmp_lcm
type: function
doc:
<comment>Description:</comment>
  Calculate LCM
  
  This function computes the least common multiple (lcm) of <strong>$num1</strong> and <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num1</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                       stringa numerica dal momento che è possibile convertire quest'ultimo in un
                       numero.
  <info>GMPintstring</info>  <strong>$num2</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                       stringa numerica dal momento che è possibile convertire quest'ultimo in un
                       numero.

<comment>Return:</comment>
  <info>GMP</info>  Una <info>resource</info> numero GMP.

<comment>See Also:</comment>
   * <strong>gmp_gcd()</strong>


id: gmp_nextprime
type: function
doc:
<comment>Description:</comment>
  Find next prime number
  
  Find next prime number

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                      stringa numerica dal momento che è possibile convertire quest'ultimo in un
                      numero.

<comment>Return:</comment>
  <info>GMP</info>  Return the next prime number greater than <strong>$num</strong>, as a GMP number.


id: gmp_perfect_power
type: function
doc:
<comment>Description:</comment>
  Perfect power check
  
  Checks whether <strong>$num</strong> is a perfect power.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                      stringa numerica dal momento che è possibile convertire quest'ultimo in un
                      numero.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if <strong>$num</strong> is a perfect power, <info>false</info> otherwise.

<comment>See Also:</comment>
   * <strong>gmp_perfect_square()</strong>


id: gmp_random_bits
type: function
doc:
<comment>Description:</comment>
  Random number
  
  Generate a random number. The number will be between 0 and (2 ** <strong>$bits</strong>) - 1.
  
  <strong>$bits</strong> must greater than 0, and the maximum value is restricted by available memory.

<comment>Param:</comment>
  <info>int</info>  <strong>$bits</strong>  The number of bits.

<comment>Return:</comment>
  <info>GMP</info>  A random GMP number.


id: gmp_random_range
type: function
doc:
<comment>Description:</comment>
  Random number
  
  Generate a random number. The number will be between <strong>$min</strong> and <strong>$max</strong>.
  
  <strong>$min</strong> and <strong>$max</strong> can both be negative but <strong>$min</strong> must always be less than <strong>$max</strong>.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$min</strong>  A GMP number representing the lower bound for the random number
  <info>GMPintstring</info>  <strong>$max</strong>  A GMP number representing the upper bound for the random number

<comment>Return:</comment>
  <info>GMP</info>  A random GMP number.


id: gmp_random_seed
type: function
doc:
<comment>Description:</comment>
  Sets the RNG seed

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$seed</strong>  The seed to be set for the <strong>gmp_random()</strong>, <strong>gmp_random_bits()</strong>, and
                       <strong>gmp_random_range()</strong> functions.
                       
                       Può essere o una <info>resource</info> numero GMP, oppure una
                       stringa numerica dal momento che è possibile convertire quest'ultimo in un
                       numero.

<comment>Return:</comment>
  <info>void</info>  Returns <info>null</info> on success o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>gmp_init()</strong>
   * <strong>gmp_random()</strong>
   * <strong>gmp_random_bits()</strong>
   * <strong>gmp_random_range()</strong>


id: gmp_root
type: function
doc:
<comment>Description:</comment>
  Take the integer part of nth root
  
  Takes the <strong>$nth</strong> root of <strong>$num</strong> and returns the integer component of the result.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                      stringa numerica dal momento che è possibile convertire quest'ultimo in un
                      numero.
  <info>int         </info>  <strong>$nth</strong>  The positive root to take of <strong>$num</strong>.

<comment>Return:</comment>
  <info>GMP</info>  The integer component of the resultant root, as a GMP number.


id: gmp_rootrem
type: function
doc:
<comment>Description:</comment>
  Take the integer part and remainder of nth root
  
  Takes the <strong>$nth</strong> root of <strong>$num</strong> and returns the integer component and remainder of the result.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num</strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                      stringa numerica dal momento che è possibile convertire quest'ultimo in un
                      numero.
  <info>int         </info>  <strong>$nth</strong>  The positive root to take of <strong>$num</strong>.

<comment>Return:</comment>
  <info>array</info>  A two element array, where the first element is the integer component of the root, and the
         second element is the remainder, both represented as GMP numbers.


id: gmp_testbit
type: function
doc:
<comment>Description:</comment>
  Tests if a bit is set
  
  Tests if the specified bit is set.

<comment>Param:</comment>
  <info>GMPintstring</info>  <strong>$num  </strong>  Può essere o una <info>resource</info> numero GMP, oppure una
                        stringa numerica dal momento che è possibile convertire quest'ultimo in un
                        numero.
  <info>int         </info>  <strong>$index</strong>  The bit to test

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the bit is set in resource <strong>$a</strong>,  otherwise <info>false</info>.

<comment>See Also:</comment>
   * <strong>gmp_setbit()</strong>
   * <strong>gmp_clrbit()</strong>


id: gnupg_adddecryptkey
type: function
doc:
<comment>Description:</comment>
  Add a key for decryption

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier </strong>  L'identificatore gnupg, ottenuto da una chiamata a
                          <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$fingerprint</strong>  La chiave fingerprint.
  <info>string  </info>  <strong>$passphrase </strong>  The pass phrase.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_addencryptkey
type: function
doc:
<comment>Description:</comment>
  Add a key for encryption

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier </strong>  L'identificatore gnupg, ottenuto da una chiamata a
                          <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$fingerprint</strong>  La chiave fingerprint.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_addsignkey
type: function
doc:
<comment>Description:</comment>
  Add a key for signing

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier </strong>  L'identificatore gnupg, ottenuto da una chiamata a
                          <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$fingerprint</strong>  La chiave fingerprint.
  <info>string  </info>  <strong>$passphrase </strong>  The pass phrase.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_cleardecryptkeys
type: function
doc:
<comment>Description:</comment>
  Removes all keys which were set for decryption before

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_clearencryptkeys
type: function
doc:
<comment>Description:</comment>
  Removes all keys which were set for encryption before

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_clearsignkeys
type: function
doc:
<comment>Description:</comment>
  Removes all keys which were set for signing before

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_decrypt
type: function
doc:
<comment>Description:</comment>
  Decrypts a given text
  
  Decrypts the given text with the keys, which were set with gnupg_adddecryptkey before.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$text      </strong>  The text being decrypted.

<comment>Return:</comment>
  <info>string</info>  On success, this function returns the decrypted text. On failure, this function returns
          <info>false</info>.


id: gnupg_decryptverify
type: function
doc:
<comment>Description:</comment>
  Decrypts and verifies a given text
  
  Decrypts and verifies a given text and returns information about the signature.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$text      </strong>  The text being decrypted.
  <info>string  </info>  <strong>$plaintext </strong>  The parameter <strong>$plaintext</strong> gets filled with the decrypted text.

<comment>Return:</comment>
  <info>array</info>  On success, this function returns information about the signature and fills the <strong>$plaintext</strong>
         parameter with the decrypted text. On failure, this function returns <info>false</info>.


id: gnupg_encrypt
type: function
doc:
<comment>Description:</comment>
  Encrypts a given text
  
  Encrypts the given <strong>$plaintext</strong> with the keys, which were set with gnupg_addencryptkey before and
  returns the encrypted text.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$plaintext </strong>  The text being encrypted.

<comment>Return:</comment>
  <info>string</info>  On success, this function returns the encrypted text. On failure, this function returns
          <info>false</info>.


id: gnupg_encryptsign
type: function
doc:
<comment>Description:</comment>
  Encrypts and signs a given text
  
  Encrypts and signs the given <strong>$plaintext</strong> with the keys, which were set with gnupg_addsignkey and
  gnupg_addencryptkey before and returns the encrypted and signed text.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$plaintext </strong>  The text being encrypted.

<comment>Return:</comment>
  <info>string</info>  On success, this function returns the encrypted and signed text. On failure, this function
          returns <info>false</info>.


id: gnupg_export
type: function
doc:
<comment>Description:</comment>
  Exports a key
  
  Exports the key <strong>$fingerprint</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier </strong>  L'identificatore gnupg, ottenuto da una chiamata a
                          <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$fingerprint</strong>  La chiave fingerprint.

<comment>Return:</comment>
  <info>string</info>  On success, this function returns the keydata. On failure, this function returns <info>false</info>.


id: gnupg_geterror
type: function
doc:
<comment>Description:</comment>
  Returns the errortext, if a function fails

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.

<comment>Return:</comment>
  <info>string</info>  Returns an errortext, if an error has occurred, otherwise <info>false</info>.


id: gnupg_getprotocol
type: function
doc:
<comment>Description:</comment>
  Returns the currently active protocol for all operations

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.

<comment>Return:</comment>
  <info>int</info>  Returns the currently active protocol, which can be one of <info>GNUPG_PROTOCOL_OpenPGP</info> or
       <info>GNUPG_PROTOCOL_CMS</info>.


id: gnupg_import
type: function
doc:
<comment>Description:</comment>
  Imports a key
  
  Imports the key <strong>$keydata</strong> and returns an array with information about the importprocess.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$keydata   </strong>  The data key that is being imported.

<comment>Return:</comment>
  <info>array</info>  On success, this function returns and info-array about the importprocess. On failure, this
         function returns <info>false</info>.


id: gnupg_init
type: function
doc:
<comment>Description:</comment>
  Initialize a connection

<comment>Return:</comment>
  <info>resource</info>  A GnuPG <info>resource</info> connection used by other GnuPG functions.


id: gnupg_keyinfo
type: function
doc:
<comment>Description:</comment>
  Returns an array with information about all keys that matches the given pattern

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$pattern   </strong>  The pattern being checked against the keys.

<comment>Return:</comment>
  <info>array</info>  Returns an array with information about all keys that matches the given pattern or <info>false</info>,
         if an error has occurred.


id: gnupg_setarmor
type: function
doc:
<comment>Description:</comment>
  Toggle armored output
  
  Toggle the armored output.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>int     </info>  <strong>$armor     </strong>  Pass a non-zero integer-value to this function to enable armored-output
                         (default). Pass 0 to disable armored output.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_seterrormode
type: function
doc:
<comment>Description:</comment>
  Sets the mode for error_reporting
  
  Sets the mode for error_reporting.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>int     </info>  <strong>$errormode </strong>  The error mode.
                         
                         <strong>$errormode</strong> takes a constant indicating what type of error_reporting should
                         be used. The possible values are <info>GNUPG_ERROR_WARNING</info>, <info>GNUPG_ERROR_EXCEPTION</info>
                         and <info>GNUPG_ERROR_SILENT</info>. By default <info>GNUPG_ERROR_SILENT</info> is used.

<comment>Return:</comment>
  <info>void</info>  Nessun valore viene restituito.


id: gnupg_setsignmode
type: function
doc:
<comment>Description:</comment>
  Sets the mode for signing
  
  Sets the mode for signing.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>        </info>  <strong>$sigmode   </strong>  The mode for signing.
                         
                         <strong>$signmode</strong> takes a constant indicating what type of signature should be
                         produced. The possible values are <info>GNUPG_SIG_MODE_NORMAL</info>,
                         <info>GNUPG_SIG_MODE_DETACH</info> and <info>GNUPG_SIG_MODE_CLEAR</info>. By default
                         <info>GNUPG_SIG_MODE_CLEAR</info> is used.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: gnupg_sign
type: function
doc:
<comment>Description:</comment>
  Signs a given text
  
  Signs the given <strong>$plaintext</strong> with the keys, which were set with gnupg_addsignkey before and returns
  the signed text or the signature, depending on what was set with gnupg_setsignmode.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  L'identificatore gnupg, ottenuto da una chiamata a
                         <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$plaintext </strong>  The plain text being signed.

<comment>Return:</comment>
  <info>string</info>  On success, this function returns the signed text or the signature. On failure, this
          function returns <info>false</info>.


id: gnupg_verify
type: function
doc:
<comment>Description:</comment>
  Verifies a signed text
  
  Verifies the given <strong>$signed_text</strong> and returns information about the signature.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier </strong>  L'identificatore gnupg, ottenuto da una chiamata a
                          <strong>gnupg_init()</strong> o <class>gnupg</class>.
  <info>string  </info>  <strong>$signed_text</strong>  The signed text.
  <info>string  </info>  <strong>$signature  </strong>  The signature. To verify a clearsigned text, set signature to <info>false</info>.
  <info>string  </info>  <strong>$plaintext  </strong>  The plain text. If this optional parameter is passed, it is filled with
                          the plain text.

<comment>Return:</comment>
  <info>array</info>  On success, this function returns information about the signature. On failure, this
         function returns <info>false</info>.


id: grapheme_extract
type: function
doc:
<comment>Description:</comment>
  Function to extract a sequence of default grapheme clusters from a text buffer, which must be
  encoded in UTF-8
  
  Stile procedurale
  
  Function to extract a sequence of default grapheme clusters from a text buffer, which must be
  encoded in UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack    </strong>  String to search.
  <info>int   </info>  <strong>$size        </strong>  Maximum number items - based on the $extract_type - to return.
  <info>int   </info>  <strong>$extract_type</strong>  Defines the type of units referred to by the $size parameter:
                         
                         GRAPHEME_EXTR_COUNT (default) - $size is the number of default grapheme
                         clusters to extract.GRAPHEME_EXTR_MAXBYTES - $size is the maximum number of
                         bytes returned.GRAPHEME_EXTR_MAXCHARS - $size is the maximum number of
                         UTF-8 characters returned.
  <info>int   </info>  <strong>$start       </strong>  Starting position in $haystack in bytes - if given, it must be zero or a
                         positive value that is less than or equal to the length of $haystack in
                         bytes, or a negative value that counts from the end of $haystack. If $start
                         does not point to the first byte of a UTF-8 character, the start position
                         is moved to the next character boundary.
  <info>int   </info>  <strong>$next        </strong>  Reference to a value that will be set to the next starting position. When
                         the call returns, this may point to the first byte position past the end of
                         the string.

<comment>Return:</comment>
  <info>string</info>  A string starting at offset $start and ending on a default grapheme cluster boundary that
          conforms to the $size and $extract_type specified.

<comment>See Also:</comment>
   * <strong>grapheme_substr()</strong>
   * 
       Unicode Text Segmentation: Grapheme Cluster Boundaries
      


id: grapheme_stripos
type: function
doc:
<comment>Description:</comment>
  Find position (in grapheme units) of first occurrence of a case-insensitive string
  
  Stile procedurale
  
  Find position (in grapheme units) of first occurrence of a case-insensitive string

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  The string to look in. Must be valid UTF-8.
  <info>string</info>  <strong>$needle  </strong>  The string to look for. Must be valid UTF-8.
  <info>int   </info>  <strong>$offset  </strong>  The optional $offset parameter allows you to specify where in haystack to start
                     searching as an offset in grapheme units (not bytes or characters). If the
                     offset is negative, it is treated relative to the end of the string. The
                     position returned is still relative to the beginning of haystack regardless of
                     the value of $offset.

<comment>Return:</comment>
  <info>int</info>  Returns the position as an integer. If needle is not found, grapheme_stripos() will return
       boolean FALSE.

<comment>See Also:</comment>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_stristr
type: function
doc:
<comment>Description:</comment>
  Returns part of haystack string from the first occurrence of case-insensitive needle to the end of
  haystack
  
  Stile procedurale
  
  Returns part of haystack string starting from and including the first occurrence of
  case-insensitive needle to the end of haystack.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack     </strong>  The input string. Must be valid UTF-8.
  <info>string</info>  <strong>$needle       </strong>  The string to look for. Must be valid UTF-8.
  <info>bool  </info>  <strong>$before_needle</strong>  If <info>true</info>, grapheme_strstr() returns the part of the haystack before the
                          first occurrence of the needle (excluding needle).

<comment>Return:</comment>
  <info>string</info>  Returns the portion of $haystack, or FALSE if $needle is not found.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_strlen
type: function
doc:
<comment>Description:</comment>
  Get string length in grapheme units
  
  Stile procedurale
  
  Get string length in grapheme units (not bytes or characters)

<comment>Param:</comment>
  <info>string</info>  <strong>$input</strong>  The string being measured for length. It must be a valid UTF-8 string.

<comment>Return:</comment>
  <info>int</info>  The length of the string on success, and 0 if the string is empty.

<comment>See Also:</comment>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     
   * <strong>iconv_strlen()</strong>
   * <strong>mb_strlen()</strong>
   * <strong>strlen()</strong>


id: grapheme_strpos
type: function
doc:
<comment>Description:</comment>
  Find position (in grapheme units) of first occurrence of a string
  
  Stile procedurale
  
  Find position (in grapheme units) of first occurrence of a string

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  The string to look in. Must be valid UTF-8.
  <info>string</info>  <strong>$needle  </strong>  The string to look for. Must be valid UTF-8.
  <info>int   </info>  <strong>$offset  </strong>  The optional $offset parameter allows you to specify where in $haystack to
                     start searching as an offset in grapheme units (not bytes or characters). If
                     the offset is negative, it is treated relative to the end of the string. The
                     position returned is still relative to the beginning of haystack regardless of
                     the value of $offset.

<comment>Return:</comment>
  <info>int</info>  Returns the position as an integer. If needle is not found, grapheme_strpos() will return
       boolean FALSE.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_strripos
type: function
doc:
<comment>Description:</comment>
  Find position (in grapheme units) of last occurrence of a case-insensitive string
  
  Stile procedurale
  
  Find position (in grapheme units) of last occurrence of a case-insensitive string

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  The string to look in. Must be valid UTF-8.
  <info>string</info>  <strong>$needle  </strong>  The string to look for. Must be valid UTF-8.
  <info>int   </info>  <strong>$offset  </strong>  The optional $offset parameter allows you to specify where in $haystack to
                     start searching as an offset in grapheme units (not bytes or characters). The
                     position returned is still relative to the beginning of haystack regardless of
                     the value of $offset.

<comment>Return:</comment>
  <info>int</info>  Returns the position as an integer. If needle is not found, grapheme_strripos() will return
       boolean FALSE.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_strrpos
type: function
doc:
<comment>Description:</comment>
  Find position (in grapheme units) of last occurrence of a string
  
  Stile procedurale
  
  Find position (in grapheme units) of last occurrence of a string

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  The string to look in. Must be valid UTF-8.
  <info>string</info>  <strong>$needle  </strong>  The string to look for. Must be valid UTF-8.
  <info>int   </info>  <strong>$offset  </strong>  The optional $offset parameter allows you to specify where in $haystack to
                     start searching as an offset in grapheme units (not bytes or characters). The
                     position returned is still relative to the beginning of haystack regardless of
                     the value of $offset.

<comment>Return:</comment>
  <info>int</info>  Returns the position as an integer. If needle is not found, grapheme_strrpos() will return
       boolean FALSE.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_strstr
type: function
doc:
<comment>Description:</comment>
  Returns part of haystack string from the first occurrence of needle to the end of haystack
  
  Stile procedurale
  
  Returns part of haystack string from the first occurrence of needle to the end of haystack
  (including the needle).

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack     </strong>  The input string. Must be valid UTF-8.
  <info>string</info>  <strong>$needle       </strong>  The string to look for. Must be valid UTF-8.
  <info>bool  </info>  <strong>$before_needle</strong>  If <info>true</info>, grapheme_strstr() returns the part of the haystack before the
                          first occurrence of the needle (excluding the needle).

<comment>Return:</comment>
  <info>string</info>  Returns the portion of string, or FALSE if needle is not found.

<comment>See Also:</comment>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: grapheme_substr
type: function
doc:
<comment>Description:</comment>
  Return part of a string
  
  Stile procedurale
  
  Return part of a string

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The input string. Must be valid UTF-8.
  <info>int   </info>  <strong>$start </strong>  Start position in default grapheme units. If $start is non-negative, the returned
                   string will start at the $start'th position in $string, counting from zero. If
                   $start is negative, the returned string will start at the $start'th grapheme unit
                   from the  end of string.
  <info>int   </info>  <strong>$length</strong>  Length in grapheme units. If $length  is given and is positive, the string
                   returned will contain at most $length grapheme units beginning from $start
                   (depending on the  length of string). If $length is given and is negative, then
                   that many grapheme units will be omitted from the end of string (after the start
                   position has been calculated when a start is negative). If $start denotes a
                   position beyond this truncation, <info>false</info> will be returned.

<comment>Return:</comment>
  <info>string</info>  Returns the extracted part of $string.

<comment>See Also:</comment>
   * <strong>grapheme_extract()</strong>
   * 
      Unicode Text Segmentation: Grapheme Cluster Boundaries
     


id: gzclose
type: function
doc:
<comment>Description:</comment>
  Chiude un puntatore a file gz
  
  Il file gz puntato da <strong>$zp</strong> viene chiuso.

<comment>Param:</comment>
  <info>resource</info>  <strong>$zp</strong>  Il puntatore al file gz deve essere valido, e deve puntare ad un file già aperto da
                 <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>


id: gzcompress
type: function
doc:
<comment>Description:</comment>
  Comprime una stringa
  
  Questa funzione comprime la stringa data usando il formato dati <return>ZLIB</return>.
  
  Per i dettagli sull'algoritmo di compressione ZLIB vedere il documento "ZLIB Compressed Data
  Format Specification version 3.3" (RFC 1950).
  
  Questa non è come la compressione gzip, che include alcuni dati di header. Vedere <strong>gzencode()</strong> per
  la compressione gzip.

<comment>Param:</comment>
  <info>string</info>  <strong>$data    </strong>  Dati da comprimere.
  <info>int   </info>  <strong>$level   </strong>  Livello di compressione. Può essere passato 0, per nessuna compressione fino ad
                     un massimo di 9 per una compressione massima.
                     
                     Se viene passato -1, viene utilizzato il livello di default di zlib, che è 6.
  <info>int   </info>  <strong>$encoding</strong>  Una delle costanti di<info>ZLIB_ENCODING_*</info>.

<comment>Return:</comment>
  <info>string</info>  La stringa compressa oppure <info>false</info> se si sono verificati errori.

<comment>See Also:</comment>
   * <strong>gzdeflate()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzdecode
type: function
doc:
<comment>Description:</comment>
  Decodes a gzip compressed string
  
  This function returns a decoded version of the input <strong>$data</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$data      </strong>  The data to decode, encoded by <strong>gzencode()</strong>.
  <info>int   </info>  <strong>$max_length</strong>  The maximum length of data to decode.

<comment>Return:</comment>
  <info>stringfalse</info>  The decoded string, or <info>false</info> if an error occurred.

<comment>See Also:</comment>
   * <strong>gzencode()</strong>


id: gzdeflate
type: function
doc:
<comment>Description:</comment>
  Comprime una stringa con il metodo DEFLATE
  
  Questa funzione restituisce una versione compressa di <strong>$data</strong> utilizzando il formato dati DEFLATE.
  
  Per i dettagli sull'algoritmo di compressione DEFLATE vedere il documento "DEFLATE Compressed Data
  Format Specification version 1.3" (RFC 1951).

<comment>Param:</comment>
  <info>string</info>  <strong>$data </strong>  I dati da comprimere.
  <info>int   </info>  <strong>$level</strong>  Il livello di compressione. Varia tra 0 (nessuna compressione) fino a 9
                  (compressione massima). Se non viene specificato, il livello di compressione di
                  default sarà quello di default della libreria zlib.

<comment>Return:</comment>
  <info>string</info>  La stringa compressa o <info>false</info> in caso di errore.

<comment>See Also:</comment>
   * <strong>gzinflate()</strong>
   * <strong>gzcompress()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzencode
type: function
doc:
<comment>Description:</comment>
  Crea una stringa compressa con gzip
  
  Questa funzione restituisce una versione compressa di <strong>$data</strong> compatibile con l'output del programma
  gzip.
  
  Per ulteriori informazioni sul formato dei file GZIP, consultare il documento: Specifica del
  formato di file GZIP versione 4.3 (RFC 1952).

<comment>Param:</comment>
  <info>string</info>  <strong>$data         </strong>  I dati da codificare.
  <info>int   </info>  <strong>$level        </strong>  Il livello di compressione. Può essere dato come 0 per nessuna
                          compressione fino a 9 per la massima compressione. Se non viene fornito,
                          il livello di compressione predefinito adottato sarà quello di default
                          della libreria zlib.
  <info>int   </info>  <strong>$encoding_mode</strong>  La modalità di codifica. Può essere <info>FORCE_GZIP</info> (il default) o
                          <info>FORCE_DEFLATE</info>.
                          
                          Prima di PHP 5.4.0, se si utilizza <info>FORCE_DEFLATE</info>, si ottiene una stringa
                          compressa col DEFLATE standard di zlib (comprendente gli header zlib) dopo
                          un header del file gzip ma senza il checksum crc32 finale.
                          
                          In PHP 5.4.0 e versioni successive, <info>FORCE_DEFLATE</info> genera un output
                          conforme a RFC 1950, costituito da un header zlib, i dati compressi col
                          DEFLATE e un checksum Adler.

<comment>Return:</comment>
  <info>string</info>  La stringa codificata o <info>false</info> se si è verificato un errore.

<comment>See Also:</comment>
   * <strong>gzdecode()</strong>
   * <strong>gzdeflate()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzcompress()</strong>
   * 
      Specifica del Formato dei Dati Compressi ZLIB (RFC 1950)
     


id: gzeof
type: function
doc:
<comment>Description:</comment>
  Test for EOF on a gz-file pointer
  
  Tests the given GZ file pointer for EOF.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the gz-file pointer is at EOF or an error occurs; otherwise returns <info>false</info>.


id: gzfile
type: function
doc:
<comment>Description:</comment>
  Read entire gz-file into an array
  
  This function is identical to <strong>readgzfile()</strong>, except that it returns the file in an array.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename        </strong>  The file name.
  <info>int   </info>  <strong>$use_include_path</strong>  You can set this optional parameter to <return>1</return>, if you want to search for the
                             file in the include_path too.

<comment>Return:</comment>
  <info>arrayfalse</info>  An array containing the file, one line per cell, empty lines included, and with
              newlines still attached, o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>readgzfile()</strong>
   * <strong>gzopen()</strong>


id: gzgetc
type: function
doc:
<comment>Description:</comment>
  Get character from gz-file pointer
  
  Returns a string containing a single (uncompressed) character read from the given gz-file pointer.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>stringfalse</info>  The uncompressed character or <info>false</info> on EOF (unlike <strong>gzeof()</strong>).

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>


id: gzgets
type: function
doc:
<comment>Description:</comment>
  Get line from file pointer
  
  Gets a (uncompressed) string of up to length - 1 bytes read from the given file pointer. Reading
  ends when length - 1 bytes have been read, on a  newline, or on EOF (whichever comes first).

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.
  <info>int     </info>  <strong>$length</strong>  The length of data to get.

<comment>Return:</comment>
  <info>stringfalse</info>  The uncompressed string, or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgetc()</strong>
   * <strong>gzwrite()</strong>


id: gzgetss
type: function
doc:
<comment>Description:</comment>
  Get line from gz-file pointer and strip HTML tags
    
  
  Identical to <strong>gzgets()</strong>, except that <strong>gzgetss()</strong> attempts to strip any HTML and PHP tags from the text
  it reads.

<comment>Param:</comment>
  <info>resource</info>  <strong>$zp            </strong>  The gz-file pointer. It must be valid, and must point to a file
                             successfully opened by <strong>gzopen()</strong>.
  <info>int     </info>  <strong>$length        </strong>  The length of data to get.
  <info>string  </info>  <strong>$allowable_tags</strong>  You can use this optional parameter to specify tags which should not
                             be stripped.

<comment>Return:</comment>
  <info>string</info>  The uncompressed and stripped string, or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>
   * <strong>strip_tags()</strong>


id: gzinflate
type: function
doc:
<comment>Description:</comment>
  Inflate a deflated string
  
  This function inflates a deflated string.

<comment>Param:</comment>
  <info>string</info>  <strong>$data      </strong>  The data compressed by <strong>gzdeflate()</strong>.
  <info>int   </info>  <strong>$max_length</strong>  The maximum length of data to decode.

<comment>Return:</comment>
  <info>stringfalse</info>  The original uncompressed data or <info>false</info> on error.
               
               The function will return an error if the uncompressed data is more than 32768 times
               the length of the compressed input <strong>$data</strong>  or more than the optional parameter
               <strong>$max_length</strong>.

<comment>See Also:</comment>
   * <strong>gzdeflate()</strong>
   * <strong>gzcompress()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzopen
type: function
doc:
<comment>Description:</comment>
  Open gz-file
  
  Opens a gzip (.gz) file for reading or writing.
  
  <strong>gzopen()</strong> can be used to read a file which is not in gzip format; in this case <strong>gzread()</strong> will
  directly read from the file without decompression.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename        </strong>  The file name.
  <info>string</info>  <strong>$mode            </strong>  As in <strong>fopen()</strong> (<return>rb</return> or  <return>wb</return>) but can also include a compression level
                             (<return>wb9</return>) or a strategy: <return>f</return> for filtered data as in <return>wb6f</return>, <return>h</return> for <return>Huffman only
                             compression</return> as in <return>wb1h</return>. (See the description of <return>deflateInit2</return> in zlib.h
                             for  more information about the strategy parameter.)
  <info>int   </info>  <strong>$use_include_path</strong>  You can set this optional parameter to <return>1</return>, if you want to search for the
                             file in the include_path too.

<comment>Return:</comment>
  <info>resourcefalse</info>  Returns a file pointer to the file opened, after that, everything you read from
                 this file descriptor will be transparently decompressed and what you  write gets
                 compressed.
                 
                 If the open fails, the function returns <info>false</info>.

<comment>See Also:</comment>
   * <strong>gzclose()</strong>


id: gzpassthru
type: function
doc:
<comment>Description:</comment>
  Output all remaining data on a gz-file pointer
    
  
  Reads to EOF on the given gz-file pointer from the current position and writes the (uncompressed)
  results to standard output.
  
  You may need to call <strong>gzrewind()</strong> to reset the file pointer to the beginning of the file if you have
  already written data  to it.
  
  If you just want to dump the contents of a file to the output buffer,  without first modifying it
  or seeking to a particular offset, you may  want to use the <strong>readgzfile()</strong> function, which saves
  you the <strong>gzopen()</strong> call.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>int</info>  The number of uncompressed characters read from <strong>$gz</strong> and passed through to the input, or <info>false</info>
       on error.


id: gzputs
type: function
doc:
<comment>Description:</comment>
  Alias di gzwrite
  
  Questa funzione è sinonimo di:  <strong>gzwrite()</strong>.


id: gzread
type: function
doc:
<comment>Description:</comment>
  Binary-safe gz-file read
  
  <strong>gzread()</strong> reads up to <strong>$length</strong> bytes from the given gz-file pointer. Reading stops when <strong>$length</strong>
  (uncompressed) bytes have been read or EOF is reached, whichever comes first.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.
  <info>int     </info>  <strong>$length</strong>  The number of bytes to read.

<comment>Return:</comment>
  <info>stringfalse</info>  The data that have been read,  o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>gzwrite()</strong>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>
   * <strong>gzgetss()</strong>
   * <strong>gzfile()</strong>
   * <strong>gzpassthru()</strong>


id: gzrewind
type: function
doc:
<comment>Description:</comment>
  Rewind the position of a gz-file pointer
  
  Sets the file position indicator of the given gz-file pointer to the  beginning of the file
  stream.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>gzseek()</strong>
   * <strong>gztell()</strong>


id: gzseek
type: function
doc:
<comment>Description:</comment>
  Seek on a gz-file pointer
  
  Sets the file position indicator for the given file pointer to the given offset byte into the file
  stream. Equivalent to calling (in C) <return>gzseek(zp, offset, SEEK_SET)</return>.
  
  If the file is opened for reading, this function is emulated but can be extremely slow. If the
  file is opened for writing, only forward seeks are supported; <strong>gzseek()</strong> then compresses a sequence
  of zeroes up to the new starting position.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.
  <info>int     </info>  <strong>$offset</strong>  The seeked offset.
  <info>int     </info>  <strong>$whence</strong>  <strong>$whence</strong> values are: <info>SEEK_SET</info> - Set position equal to <strong>$offset</strong> bytes.<info>SEEK_CUR</info> -
                     Set position to current location plus <strong>$offset</strong>.
                     
                     If <strong>$whence</strong> is not specified, it is assumed to be <info>SEEK_SET</info>.

<comment>Return:</comment>
  <info>int</info>  Upon success, returns 0; otherwise, returns -1. Note that seeking past EOF is not considered
       an error.

<comment>See Also:</comment>
   * <strong>gztell()</strong>
   * <strong>gzrewind()</strong>


id: gztell
type: function
doc:
<comment>Description:</comment>
  Tell gz-file pointer read/write position
  
  Gets the position of the given file pointer; i.e., its offset into the uncompressed file stream.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>intfalse</info>  The position of the file pointer or <info>false</info> if an error occurs.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzseek()</strong>
   * <strong>gzrewind()</strong>


id: gzuncompress
type: function
doc:
<comment>Description:</comment>
  Decomprime una stringa compressa
  
  Questa funzione decomprime una stringa compressa.

<comment>Param:</comment>
  <info>string</info>  <strong>$data  </strong>  Il dato compresso dalla funzione <strong>gzcompress()</strong>.
  <info>int   </info>  <strong>$length</strong>  La lunghezza massima del dato da decomprimere.

<comment>Return:</comment>
  <info>string</info>  Il dato originale decompresso oppure <info>false</info> in caso di errore.
          
          La funzione ritornerà un errore se il dato decompresso è più di 32768 volte la lunghezza
          dell'input compresso <strong>$data</strong>  oppure se è maggiore del parametro opzionale <strong>$length</strong>.

<comment>See Also:</comment>
   * <strong>gzcompress()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzdeflate()</strong>
   * <strong>gzencode()</strong>


id: gzwrite
type: function
doc:
<comment>Description:</comment>
  Binary-safe gz-file write
  
  <strong>gzwrite()</strong> writes the contents of <strong>$data</strong> to the given gz-file.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The gz-file pointer. It must be valid, and must point to a file successfully
                     opened by <strong>gzopen()</strong>.
  <info>string  </info>  <strong>$data  </strong>  The string to write.
  <info>intnull </info>  <strong>$length</strong>  The number of uncompressed bytes to write. If supplied, writing will  stop
                     after <strong>$length</strong> (uncompressed) bytes have been written or the end of <strong>$data</strong> is
                     reached, whichever comes first.
                     
                     Note that if the <strong>$length</strong> argument is given, then the magic_quotes_runtime
                     configuration option will be ignored and no slashes will be stripped from
                     <strong>$data</strong>.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the number of (uncompressed) bytes written to the given gz-file  stream,  o
            <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>gzread()</strong>
   * <strong>gzopen()</strong>


id: hash
type: function
doc:
<comment>Description:</comment>
  Generate a hash value (message digest)

<comment>Param:</comment>
  <info>string</info>  <strong>$algo  </strong>  Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..).
                   For a list of supported algorithms see <strong>hash_algos()</strong>.
  <info>string</info>  <strong>$data  </strong>  Message to be hashed.
  <info>bool  </info>  <strong>$binary</strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string containing the calculated message digest as lowercase hexits unless
               <strong>$binary</strong> is set to true in which case the raw binary representation of the message
               digest is returned.

<comment>See Also:</comment>
   * <strong>hash_file()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_init()</strong>
   * <strong>md5()</strong>
   * <strong>sha1()</strong>


id: hash_algos
type: function
doc:
<comment>Description:</comment>
  Return a list of registered hashing algorithms

<comment>Return:</comment>
  <info>array</info>  Returns a numerically indexed array containing the list of supported hashing algorithms.

<comment>See Also:</comment>
   * <strong>hash_hmac_algos()</strong>


id: hash_copy
type: function
doc:
<comment>Description:</comment>
  Copy hashing context

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Hashing context returned by <strong>hash_init()</strong>.

<comment>Return:</comment>
  <info>HashContext</info>  Returns a copy of Hashing Context.


id: hash_equals
type: function
doc:
<comment>Description:</comment>
  Timing attack safe string comparison
  
  Compares two strings using the same time whether they're equal or not.
  
  This function should be used to mitigate timing attacks; for instance, when testing <strong>crypt()</strong>
  password hashes.

<comment>Param:</comment>
  <info>string</info>  <strong>$known_string</strong>  The <info>string</info> of known length to compare against
  <info>string</info>  <strong>$user_string </strong>  The user-supplied string

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> when the two strings are equal, <info>false</info> otherwise.


id: hash_file
type: function
doc:
<comment>Description:</comment>
  Generate a hash value using the contents of a given file

<comment>Param:</comment>
  <info>string</info>  <strong>$algo    </strong>  Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..).
                     For a list of supported algorithms see <strong>hash_algos()</strong>.
  <info>string</info>  <strong>$filename</strong>  URL describing location of file to be hashed; Supports fopen wrappers.
  <info>bool  </info>  <strong>$binary  </strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string containing the calculated message digest as lowercase hexits unless
               <strong>$binary</strong> is set to true in which case the raw binary representation of the message
               digest is returned.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_hmac_file()</strong>
   * <strong>hash_update_file()</strong>
   * <strong>md5_file()</strong>
   * <strong>sha1_file()</strong>


id: hash_final
type: function
doc:
<comment>Description:</comment>
  Finalize an incremental hash and return resulting digest

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Hashing context returned by <strong>hash_init()</strong>.
  <info>bool       </info>  <strong>$binary </strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing the calculated message digest as lowercase hexits unless
          <strong>$binary</strong> is set to true in which case the raw binary representation of the message digest
          is returned.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_update_file()</strong>


id: hash_hkdf
type: function
doc:
<comment>Description:</comment>
  Generate a HKDF key derivation of a supplied key input

<comment>Param:</comment>
  <info>string</info>  <strong>$algo  </strong>  Name of selected hashing algorithm (i.e. "sha256", "sha512", "haval160,4", etc..)
                   See <strong>hash_algos()</strong> for a list of supported algorithms.  Non-cryptographic hash
                   functions are not allowed.
                   
                   Non-cryptographic hash functions are not allowed.
  <info>string</info>  <strong>$key   </strong>  Input keying material (raw binary). Cannot be empty.
  <info>int   </info>  <strong>$length</strong>  Desired output length in bytes. Cannot be greater than 255 times the chosen hash
                   function size.
                   
                   If <strong>$length</strong> is <return>0</return>, the output length will default to the chosen hash function size.
  <info>string</info>  <strong>$info  </strong>  Application/context-specific info string.
  <info>string</info>  <strong>$salt  </strong>  Salt to use during derivation.
                   
                   While optional, adding random salt significantly improves the strength of HKDF.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing a raw binary representation of the derived key (also known as
          output keying material - OKM); or <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>hash_pbkdf2()</strong>
   * RFC 5869
   * userland implementation


id: hash_hmac
type: function
doc:
<comment>Description:</comment>
  Generate a keyed hash value using the HMAC method

<comment>Param:</comment>
  <info>string</info>  <strong>$algo  </strong>  Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..)
                   See <strong>hash_hmac_algos()</strong> for a list of supported algorithms.
  <info>string</info>  <strong>$data  </strong>  Message to be hashed.
  <info>string</info>  <strong>$key   </strong>  Shared secret key used for generating the HMAC variant of the message digest.
  <info>bool  </info>  <strong>$binary</strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string containing the calculated message digest as lowercase hexits unless
               <strong>$binary</strong> is set to true in which case the raw binary representation of the message
               digest is returned. Returns <info>false</info> when <strong>$algo</strong> is unknown or is a non-cryptographic
               hash function.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_hmac_algos()</strong>
   * <strong>hash_init()</strong>
   * <strong>hash_hmac_file()</strong>


id: hash_hmac_algos
type: function
doc:
<comment>Description:</comment>
  Return a list of registered hashing algorithms suitable for hash_hmac

<comment>Return:</comment>
  <info>array</info>  Returns a numerically indexed array containing the list of supported hashing algorithms
         suitable for <strong>hash_hmac()</strong>.

<comment>See Also:</comment>
   * <strong>hash_hmac()</strong>
   * <strong>hash_algos()</strong>


id: hash_hmac_file
type: function
doc:
<comment>Description:</comment>
  Generate a keyed hash value using the HMAC method and the contents of a given file

<comment>Param:</comment>
  <info>string</info>  <strong>$algo  </strong>  Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..)
                   See <strong>hash_hmac_algos()</strong> for a list of supported algorithms.
  <info>string</info>  <strong>$data  </strong>  URL describing location of file to be hashed; Supports fopen wrappers.
  <info>string</info>  <strong>$key   </strong>  Shared secret key used for generating the HMAC variant of the message digest.
  <info>bool  </info>  <strong>$binary</strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string containing the calculated message digest as lowercase hexits unless
               <strong>$binary</strong> is set to true in which case the raw binary representation of the message
               digest is returned. Returns <info>false</info> when <strong>$algo</strong> is unknown or is a non-cryptographic
               hash function, or if the file <strong>$data</strong> cannot be read.

<comment>See Also:</comment>
   * <strong>hash_hmac_algos()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_file()</strong>


id: hash_init
type: function
doc:
<comment>Description:</comment>
  Initialize an incremental hashing context

<comment>Param:</comment>
  <info>string</info>  <strong>$algo </strong>  Name of selected hashing algorithm (i.e. "md5", "sha256", "haval160,4", etc..).
                  For a list of supported algorithms see <strong>hash_algos()</strong>.
  <info>int   </info>  <strong>$flags</strong>  Optional settings for hash generation, currently supports only one option:
                  <info>HASH_HMAC</info>.  When specified, the <strong>$key</strong> must be specified.
  <info>string</info>  <strong>$key  </strong>  When <info>HASH_HMAC</info> is specified for <strong>$flags</strong>, a shared secret key to be used with the
                  HMAC hashing method must be supplied in this parameter.

<comment>Return:</comment>
  <info>HashContext</info>  Returns a Hashing Context for use with <strong>hash_update()</strong>, <strong>hash_update_stream()</strong>,
               <strong>hash_update_file()</strong>, and <strong>hash_final()</strong>.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_algos()</strong>
   * <strong>hash_file()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_hmac_file()</strong>


id: hash_pbkdf2
type: function
doc:
<comment>Description:</comment>
  Generate a PBKDF2 key derivation of a supplied password

<comment>Param:</comment>
  <info>string</info>  <strong>$algo      </strong>  Name of selected hashing algorithm (i.e. <return>md5</return>, <return>sha256</return>, <return>haval160,4</return>, etc..) See
                       <strong>hash_algos()</strong> for a list of supported algorithms.
  <info>string</info>  <strong>$password  </strong>  The password to use for the derivation.
  <info>string</info>  <strong>$salt      </strong>  The salt to use for the derivation. This value should be generated randomly.
  <info>int   </info>  <strong>$iterations</strong>  The number of internal iterations to perform for the derivation.
  <info>int   </info>  <strong>$length    </strong>  The length of the output string. If <strong>$binary</strong> is <info>true</info> this corresponds to the
                       byte-length of the derived key, if <strong>$binary</strong> is <info>false</info> this corresponds to twice
                       the byte-length of the derived key (as every byte of the key is returned as
                       two hexits).
                       
                       If <return>0</return> is passed, the entire output of the supplied algorithm is used.
  <info>bool  </info>  <strong>$binary    </strong>  When set to <info>true</info>, outputs raw binary data. <info>false</info> outputs lowercase hexits.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing the derived key as lowercase hexits unless <strong>$binary</strong> is set to
          <info>true</info> in which case the raw binary representation of the derived key is returned.

<comment>See Also:</comment>
   * <strong>crypt()</strong>
   * <strong>password_hash()</strong>
   * <strong>hash()</strong>
   * <strong>hash_algos()</strong>
   * <strong>hash_init()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_hmac_file()</strong>
   * <strong>openssl_pbkdf2()</strong>


id: hash_update
type: function
doc:
<comment>Description:</comment>
  Pump data into an active hashing context

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Hashing context returned by <strong>hash_init()</strong>.
  <info>string     </info>  <strong>$data   </strong>  Message to be included in the hash digest.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update_file()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_final()</strong>


id: hash_update_file
type: function
doc:
<comment>Description:</comment>
  Pump data into an active hashing context from a file

<comment>Param:</comment>
  <info>HashContext </info>  <strong>$context       </strong>  Hashing context returned by <strong>hash_init()</strong>.
  <info>string      </info>  <strong>$filename      </strong>  URL describing location of file to be hashed; Supports fopen
                                 wrappers.
  <info>resourcenull</info>  <strong>$stream_context</strong>  Stream context as returned by <strong>stream_context_create()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_final()</strong>
   * <strong>hash()</strong>
   * <strong>hash_file()</strong>


id: hash_update_stream
type: function
doc:
<comment>Description:</comment>
  Pump data into an active hashing context from an open stream

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Hashing context returned by <strong>hash_init()</strong>.
  <info>resource   </info>  <strong>$stream </strong>  Open file handle as returned by any stream creation function.
  <info>int        </info>  <strong>$length </strong>  Maximum number of characters to copy from <strong>$stream</strong> into the hashing context.

<comment>Return:</comment>
  <info>int</info>  Actual number of bytes added to the hashing context from <strong>$stream</strong>.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_final()</strong>
   * <strong>hash()</strong>
   * <strong>hash_file()</strong>


id: header
type: function
doc:
<comment>Description:</comment>
  Send a raw HTTP header
  
  <strong>header()</strong> is used to send a raw HTTP header. See the HTTP/1.1 specification for more information on
  HTTP headers.
  
  Remember that <strong>header()</strong> must be called before any actual output is sent, either by normal HTML
  tags, blank lines in a file, or from PHP. It is a very common error to read code with <strong>include()</strong>,
  or <strong>require()</strong>,  functions, or another file access function, and have spaces or empty lines that are
  output before <strong>header()</strong> is called. The same problem exists when using a single PHP/HTML file.
  
  ]]>

<comment>Param:</comment>
  <info>string</info>  <strong>$header       </strong>  The header string.
                          
                          There are two special-case header calls.  The first is a header that
                          starts with the string "<return>HTTP/</return>" (case is not significant), which will be
                          used to figure out the HTTP status code to send. For example, if you have
                          configured Apache to use a PHP script to handle requests for missing files
                          (using the <return>ErrorDocument</return> directive), you may want to make sure that your
                          script generates the proper status code.
                          
                          
                          ]]>
                          
                          The second special case is the "Location:" header.  Not only does it send
                          this header back to the browser, but it also returns a <return>REDIRECT</return> (302)
                          status code to the browser unless the <return>201</return> or a <return>3xx</return> status code has already
                          been set.
                          
                          
                          ]]>
  <info>bool  </info>  <strong>$replace      </strong>  The optional <strong>$replace</strong> parameter indicates whether the header should
                          replace a previous similar header, or add a second header of the same
                          type.  By default it will replace, but if you pass in <info>false</info> as the second
                          argument you can force multiple headers of the same type.  For example:
                          
                          
                          ]]>
  <info>int   </info>  <strong>$response_code</strong>  Forces the HTTP response code to the specified value. Note that this
                          parameter only has an effect if the <strong>$header</strong> is  not empty.

<comment>Return:</comment>
  <info>void</info>  Nessun valore viene restituito.

<comment>See Also:</comment>
   * <strong>headers_sent()</strong>
   * <strong>setcookie()</strong>
   * <strong>http_response_code()</strong>
   * <strong>header_remove()</strong>
   * 
     The section on HTTP
     authentication
    


id: header_register_callback
type: function
doc:
<comment>Description:</comment>
  Call a header function
  
  Registers a function that will be called when PHP starts sending output.
  
  The <strong>$callback</strong> is executed just after PHP prepares all headers to be sent, and before any other
  output is sent, creating a window to manipulate the outgoing headers before being sent.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  Function called just before the headers are sent. It gets no parameters and
                       the return value is ignored.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>headers_list()</strong>
   * <strong>header_remove()</strong>
   * <strong>header()</strong>


id: header_remove
type: function
doc:
<comment>Description:</comment>
  Remove previously set headers
  
  Removes an HTTP header previously set using <strong>header()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>  The header name to be removed.
                 
                 This parameter is case-insensitive.

<comment>Return:</comment>
  <info>void</info>  Nessun valore viene restituito.

<comment>See Also:</comment>
   * <strong>header()</strong>
   * <strong>headers_sent()</strong>


id: headers_list
type: function
doc:
<comment>Description:</comment>
  Returns a list of response headers sent (or ready to send)
  
  <strong>headers_list()</strong> will return a list of headers to be sent to the browser / client.  To determine
  whether or not these headers have been sent yet, use <strong>headers_sent()</strong>.

<comment>Return:</comment>
  <info>array</info>  Returns a numerically indexed array of headers.

<comment>See Also:</comment>
   * <strong>headers_sent()</strong>
   * <strong>header()</strong>
   * <strong>setcookie()</strong>
   * <strong>apache_response_headers()</strong>
   * <strong>http_response_code()</strong>


id: headers_sent
type: function
doc:
<comment>Description:</comment>
  Checks if or where headers have been sent
  
  Checks if or where headers have been sent.
  
  You can't add any more header lines using the <strong>header()</strong> function once the header block has already
  been sent. Using this function you can at least prevent getting HTTP header related error
  messages. Another option is to use Output Buffering.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  If the optional <strong>$filename</strong> and <strong>$line</strong> parameters are set,  <strong>headers_sent()</strong> will
                     put the PHP source file name and line number where output started in the
                     <strong>$filename</strong> and <strong>$line</strong> variables.
  <info>int   </info>  <strong>$line    </strong>  The line number where the output started.

<comment>Return:</comment>
  <info>bool</info>  <strong>headers_sent()</strong> will return <info>false</info> if no HTTP headers have already been sent or <info>true</info>
        otherwise.

<comment>See Also:</comment>
   * <strong>ob_start()</strong>
   * <strong>trigger_error()</strong>
   * <strong>headers_list()</strong>
   * <strong>header()</strong> for a more detailed discussion of the
     matters involved.
    


id: hebrevc
type: function
doc:
<comment>Description:</comment>
  Converte il testo logico Ebraico in testo visuale con conversione del carattere di 'a capo'


id: hex2bin
type: function
doc:
<comment>Description:</comment>
  Decodes a hexadecimally encoded binary string
  
  Decodes a hexadecimally encoded binary string.
  
  This function does NOT convert a hexadecimal number to a binary number. This can be done using the
  <strong>base_convert()</strong> function.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Hexadecimal representation of data.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the binary representation of the given data  o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>bin2hex()</strong>
   * <strong>unpack()</strong>


id: highlight_file
type: function
doc:
<comment>Description:</comment>
  Evidenziatore di sintassi per un file
  
  Stampa o ritorna una versione del codice contenuto nel file di nome <strong>$filename</strong> con la sintassi
  evidenziata usando i colori predefiniti nel syntax highlighter per PHP.
  
  Molti server sono configurati per evidenziare i file automaticamente con l'estensione phps. Per
  esempio, example.phps mostrerà la sintassi evidenziata del codice sorgente del file. Per
  abilitarlo, aggiungere questa riga nell'httpd.conf (su webserver Apache):

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Percorso del file PHP che deve essere evidenziato.
  <info>bool  </info>  <strong>$return  </strong>  Se settato a <info>true</info> la funzione ritornerà il codice evidenziato anziché
                     stamparlo.

<comment>Return:</comment>
  <info>mixed</info>  Se <strong>$return</strong> è <info>true</info>, ritorna il codice evidenziato come una stringa invece di stamparlo.
         Altrimenti, ritornerà <info>true</info> in caso di successo o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>highlight_string()</strong>
   * Evidenziare direttive INI


id: highlight_string
type: function
doc:
<comment>Description:</comment>
  Evidenziatore di sintassi per stringhe
  
  Stampa o ritorna il markup html per una versione con sintassi evidenziata del codice PHP passato
  usando i colori predefiniti nel syntax highlighter built-in per PHP.

<comment>Param:</comment>
  <info>string</info>  <strong>$str   </strong>  Il codice PHP che deve essere evidenziato. Questo deve includere il tag di
                   apertura.
  <info>bool  </info>  <strong>$return</strong>  Settando questo parametro a <info>true</info> la funzione ritornerà il codice evidenziato.

<comment>Return:</comment>
  <info>mixed</info>  Se <strong>$return</strong> è <info>true</info>, ritorna il codice evidenziato come una stringa al posto di stamparlo.
         Altrimenti, ritornerà <info>true</info> in caso di successo o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>highlight_file()</strong>
   * Evidenziare direttive INI


id: hrtime
type: function
doc:
<comment>Description:</comment>
  Get the system's high resolution time
  
  Returns the system's high resolution time, counted from an arbitrary point in time. The delivered
  timestamp is monotonic and can not be adjusted.

<comment>Param:</comment>
  <info>bool</info>  <strong>$as_number</strong>  Whether the high resolution time should be returned as <info>array</info> or number.

<comment>Return:</comment>
  <info>arrayintfloatfalse</info>  Returns an array of integers in the form [seconds, nanoseconds], if the
                      parameter <strong>$as_number</strong> is false. Otherwise the nanoseconds are returned as <info>int</info>
                      (64bit platforms) or <info>float</info> (32bit platforms). Returns <info>false</info> on failure.

<comment>See Also:</comment>
   * The High resolution timing extension
   * <strong>microtime()</strong>


id: htmlspecialchars_decode
type: function
doc:
<comment>Description:</comment>
  Convert special HTML entities back to characters
    
  
  This function is the opposite of <strong>htmlspecialchars()</strong>. It converts special HTML entities back to
  characters.
  
  The converted entities are: , (when <info>ENT_NOQUOTES</info> is not set), <return>&#039;</return> (when <info>ENT_QUOTES</info> is set), and
  .

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The string to decode.
  <info>int   </info>  <strong>$flags </strong>  A bitmask of one or more of the following flags, which specify how to handle
                   quotes and which document type to use. The default is <return>ENT_COMPAT | ENT_HTML401</return>.
                   Available <strong>$flags</strong> constantsConstant NameDescription<info>ENT_COMPAT</info>Will convert
                   double-quotes and leave single-quotes alone.<info>ENT_QUOTES</info>Will convert both double
                   and single quotes.<info>ENT_NOQUOTES</info>Will leave both double and single quotes
                   unconverted.<info>ENT_HTML401</info> Handle code as HTML 4.01. <info>ENT_XML1</info> Handle code as XML 1.
                   <info>ENT_XHTML</info> Handle code as XHTML. <info>ENT_HTML5</info> Handle code as HTML 5.

<comment>Return:</comment>
  <info>string</info>  Returns the decoded string.

<comment>See Also:</comment>
   * <strong>htmlspecialchars()</strong>
   * <strong>html_entity_decode()</strong>
   * <strong>get_html_translation_table()</strong>


id: http_build_query
type: function
doc:
<comment>Description:</comment>
  Generate URL-encoded query string
  
  Generates a URL-encoded query string from the associative (or indexed) array provided.

<comment>Param:</comment>
  <info>mixed </info>  <strong>$query_data    </strong>  May be an array or object containing properties.
                           
                           If <strong>$query_data</strong> is an array, it may be a simple one-dimensional structure,
                           or an array of arrays (which in turn may contain other arrays).
                           
                           If <strong>$query_data</strong> is an object, then only public properties will be
                           incorporated into the result.
  <info>string</info>  <strong>$numeric_prefix</strong>  If numeric indices are used in the base array and this parameter is
                           provided, it will be prepended to the numeric index for elements in the
                           base array only.
                           
                           This is meant to allow for legal variable names when the data is decoded
                           by PHP or another CGI application later on.
  <info>string</info>  <strong>$arg_separator </strong>  arg_separator.output is used to separate arguments but may be overridden
                           by specifying this parameter.
  <info>int   </info>  <strong>$enc_type      </strong>  By default, <info>PHP_QUERY_RFC1738</info>.
                           
                           If <strong>$enc_type</strong> is <info>PHP_QUERY_RFC1738</info>, then encoding is performed per RFC
                           1738 and the <return>application/x-www-form-urlencoded</return> media type, which implies
                           that spaces are encoded as plus (<return>+</return>) signs.
                           
                           If <strong>$enc_type</strong> is <info>PHP_QUERY_RFC3986</info>, then encoding is performed according
                           to RFC 3986, and spaces will be percent encoded (<return>%20</return>).

<comment>Return:</comment>
  <info>string</info>  Returns a URL-encoded string.

<comment>See Also:</comment>
   * <strong>parse_str()</strong>
   * <strong>parse_url()</strong>
   * <strong>urlencode()</strong>
   * <strong>array_walk()</strong>


id: http_response_code
type: function
doc:
<comment>Description:</comment>
  Get or Set the HTTP response code
  
  Gets or sets the HTTP response status code.

<comment>Param:</comment>
  <info>int</info>  <strong>$response_code</strong>  The optional <strong>$response_code</strong> will set the response code.

<comment>Return:</comment>
  <info>intbool</info>  If <strong>$response_code</strong> is provided, then the previous status code will be returned. If
           <strong>$response_code</strong> is not provided, then the current status code will be returned. Both of
           these values will default to a <return>200</return> status code if used in a web server environment.
           
           <info>false</info> will be returned if <strong>$response_code</strong> is not provided and it is not invoked in a web
           server environment (such as from a CLI application). <info>true</info> will be returned if
           <strong>$response_code</strong> is provided and it is not invoked in a web server environment (but only
           when no previous response status has been set).

<comment>See Also:</comment>
   * <strong>header()</strong>
   * <strong>headers_list()</strong>


id: ibase_add_user
type: function
doc:
<comment>Description:</comment>
  Add a user to a security database

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  The handle on the database server service.
  <info>string  </info>  <strong>$user_name     </strong>  The login name of the new database user.
  <info>string  </info>  <strong>$password      </strong>  The password of the new user.
  <info>string  </info>  <strong>$first_name    </strong>  The first name of the new database user.
  <info>string  </info>  <strong>$middle_name   </strong>  The middle name of the new database user.
  <info>string  </info>  <strong>$last_name     </strong>  The last name of the new database user.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_modify_user()</strong>
   * <strong>ibase_delete_user()</strong>


id: ibase_affected_rows
type: function
doc:
<comment>Description:</comment>
  Return the number of rows that were affected by the previous query
  
  This function returns the number of rows that were affected by the previous query (INSERT, UPDATE
  or DELETE) that was executed from within the specified transaction context.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  A transaction context. If <strong>$link_identifier</strong> is a connection resource,
                              its default transaction is used.

<comment>Return:</comment>
  <info>int</info>  Returns the number of rows as an integer.

<comment>See Also:</comment>
   * <strong>ibase_query()</strong>
   * <strong>ibase_execute()</strong>


id: ibase_backup
type: function
doc:
<comment>Description:</comment>
  Initiates a backup task in the service manager and returns immediately
  
  This function passes the arguments to the (remote) database server. There it starts a new backup
  process. Therefore you won't get any responses.

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  A previously opened connection to the database server.
  <info>string  </info>  <strong>$source_db     </strong>  The absolute file path to the database on the database server. You can
                             also use a database alias.
  <info>string  </info>  <strong>$dest_file     </strong>  The path to the backup file on the database server.
  <info>int     </info>  <strong>$options       </strong>  Additional options to pass to the database server for backup. The
                             <strong>$options</strong> parameter can be a combination  of the following constants:
                             <info>IBASE_BKP_IGNORE_CHECKSUMS</info>, <info>IBASE_BKP_IGNORE_LIMBO</info>,
                             <info>IBASE_BKP_METADATA_ONLY</info>, <info>IBASE_BKP_NO_GARBAGE_COLLECT</info>,
                             <info>IBASE_BKP_OLD_DESCRIPTIONS</info>, <info>IBASE_BKP_NON_TRANSPORTABLE</info> or
                             <info>IBASE_BKP_CONVERT</info>. Read the section about  for further information.
  <info>bool    </info>  <strong>$verbose       </strong>  Since the backup process is done on the database server, you don't have
                             any chance to get its output. This argument is useless.

<comment>Return:</comment>
  <info>mixed</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
         
         Since the backup process is done on the (remote) server, this function just passes the
         arguments to it. While the arguments are legal, you won't get <info>false</info>.

<comment>See Also:</comment>
   * <strong>ibase_restore()</strong>


id: ibase_commit_ret
type: function
doc:
<comment>Description:</comment>
  Commit a transaction without closing it
  
  Commits a transaction without closing it.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  If called without an argument, this function commits the
                                       default transaction of the default link. If the argument is a
                                       connection identifier, the default transaction of the
                                       corresponding connection will be committed. If the argument
                                       is a transaction identifier, the corresponding transaction
                                       will be committed. The transaction context will be retained,
                                       so statements executed from within this transaction will not
                                       be invalidated.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: ibase_db_info
type: function
doc:
<comment>Description:</comment>
  Request statistics about a database
  
  Questa funzione, al momento
  non è documentata; è disponibile soltanto la lista degli argomenti.

<comment>Return:</comment>
  <info>string</info>  


id: ibase_delete_user
type: function
doc:
<comment>Description:</comment>
  Delete a user from a security database

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  The handle on the database server service.
  <info>string  </info>  <strong>$user_name     </strong>  The login name of the user you want to delete from the database.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_add_user()</strong>
   * <strong>ibase_modify_user()</strong>


id: ibase_drop_db
type: function
doc:
<comment>Description:</comment>
  Drops a database
  
  This functions drops a database that was opened by either <strong>ibase_connect()</strong> or <strong>ibase_pconnect()</strong>. The
  database is closed and deleted from the server.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  An InterBase link identifier. If omitted, the last opened link is assumed.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_connect()</strong>
   * <strong>ibase_pconnect()</strong>


id: ibase_errcode
type: function
doc:
<comment>Description:</comment>
  Return an error code
  
  Returns the error code that resulted from the most recent InterBase function call.

<comment>Return:</comment>
  <info>int</info>  Returns the error code as an integer, or <info>false</info> if no error occurred.

<comment>See Also:</comment>
   * <strong>ibase_errmsg()</strong>


id: ibase_fetch_assoc
type: function
doc:
<comment>Description:</comment>
  Fetch a result row from a query as an associative array
  
  Fetch a result row from a query as an associative array.
  
  <strong>ibase_fetch_assoc()</strong> fetches one row of data from the <strong>$result</strong>.  If two or more columns of the
  result have the same field names, the last column will take precedence. To access the other
  column(s) of the same name, you either need to access the result with numeric indices by using
  <strong>ibase_fetch_row()</strong> or use alias names in your query.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result    </strong>  The result handle.
  <info>int     </info>  <strong>$fetch_flag</strong>  <strong>$fetch_flag</strong> is a combination of the constants <info>IBASE_TEXT</info> and <info>IBASE_UNIXTIME</info>
                         ORed together. Passing <info>IBASE_TEXT</info> will cause this function to return BLOB
                         contents instead of BLOB ids. Passing <info>IBASE_UNIXTIME</info> will cause this
                         function to return date/time values as Unix timestamps instead of as
                         formatted strings.

<comment>Return:</comment>
  <info>array</info>  Returns an associative array that corresponds to the fetched row. Subsequent calls will
         return the next row in the result set, or <info>false</info> if there are no more rows.

<comment>See Also:</comment>
   * <strong>ibase_fetch_row()</strong>
   * <strong>ibase_fetch_object()</strong>


id: ibase_free_event_handler
type: function
doc:
<comment>Description:</comment>
  Cancels a registered event handler
  
  This function causes the registered event handler specified by <strong>$event</strong> to be cancelled. The
  callback function will no longer be called for the events it was registered to handle.

<comment>Param:</comment>
  <info>resource</info>  <strong>$event</strong>  An event resource, created by <strong>ibase_set_event_handler()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_set_event_handler()</strong>


id: ibase_gen_id
type: function
doc:
<comment>Description:</comment>
  Increments the named generator and returns its new value
  
  Questa funzione, al momento
  non è documentata; è disponibile soltanto la lista degli argomenti.

<comment>Return:</comment>
  <info>mixed</info>  Returns new generator value as integer, or as string if the value is too big.


id: ibase_maintain_db
type: function
doc:
<comment>Description:</comment>
  Execute a maintenance command on the database server
  
  Questa funzione, al momento
  non è documentata; è disponibile soltanto la lista degli argomenti.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: ibase_modify_user
type: function
doc:
<comment>Description:</comment>
  Modify a user to a security database

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  The handle on the database server service.
  <info>string  </info>  <strong>$user_name     </strong>  The login name of the database user to modify.
  <info>string  </info>  <strong>$password      </strong>  The user's new password.
  <info>string  </info>  <strong>$first_name    </strong>  The user's new first name.
  <info>string  </info>  <strong>$middle_name   </strong>  The user's new middle name.
  <info>string  </info>  <strong>$last_name     </strong>  The user's new last name.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_add_user()</strong>
   * <strong>ibase_delete_user()</strong>


id: ibase_name_result
type: function
doc:
<comment>Description:</comment>
  Assigns a name to a result set
  
  This function assigns a name to a result set. This name can be used later in UPDATE|DELETE ...
  WHERE CURRENT OF <strong>$name</strong> statements.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result</strong>  An InterBase result set.
  <info>string  </info>  <strong>$name  </strong>  The name to be assigned.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>ibase_prepare()</strong>
   * <strong>ibase_execute()</strong>


id: ibase_num_params
type: function
doc:
<comment>Description:</comment>
  Return the number of parameters in a prepared query
  
  This function returns the number of parameters in the prepared query specified by <strong>$query</strong>. This is
  the number of binding arguments that must be present when calling <strong>ibase_execute()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query</strong>  The prepared query handle.

<comment>Return:</comment>
  <info>int</info>  Returns the number of parameters as an integer.

<comment>See Also:</comment>
   * <strong>ibase_prepare()</strong>
   * <strong>ibase_param_info()</strong>


id: ibase_param_info
type: function
doc:
<comment>Description:</comment>
  Return information about a parameter in a prepared query
  
  Returns an array with information about a parameter after a query has been prepared.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query       </strong>  An InterBase prepared query handle.
  <info>int     </info>  <strong>$param_number</strong>  Parameter offset.

<comment>Return:</comment>
  <info>array</info>  Returns an array with the following keys: <return>name</return>, <return>alias</return>, <return>relation</return>, <return>length</return> and <return>type</return>.

<comment>See Also:</comment>
   * <strong>ibase_field_info()</strong>
   * <strong>ibase_num_params()</strong>


id: ibase_prepare
type: function
doc:
<comment>Description:</comment>
  Prepara una query per un successivo binding dei segnaposto dei parametri ed
       esecuzione


id: ibase_restore
type: function
doc:
<comment>Description:</comment>
  Initiates a restore task in the service manager and returns immediately
  
  This function passes the arguments to the (remote) database server. There it starts a new restore
  process. Therefore you won't get any responses.

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  A previously opened connection to the database server.
  <info>string  </info>  <strong>$source_file   </strong>  The absolute path on the server where the backup file is located.
  <info>string  </info>  <strong>$dest_db       </strong>  The path to create the new database on the server. You can also use
                             database alias.
  <info>int     </info>  <strong>$options       </strong>  Additional options to pass to the database server for restore. The
                             <strong>$options</strong> parameter can be a combination  of the following constants:
                             <info>IBASE_RES_DEACTIVATE_IDX</info>, <info>IBASE_RES_NO_SHADOW</info>,  <info>IBASE_RES_NO_VALIDITY</info>,
                             <info>IBASE_RES_ONE_AT_A_TIME</info>, <info>IBASE_RES_REPLACE</info>, <info>IBASE_RES_CREATE</info>,
                             <info>IBASE_RES_USE_ALL_SPACE</info>, <info>IBASE_PRP_PAGE_BUFFERS</info>,
                             <info>IBASE_PRP_SWEEP_INTERVAL</info>, <info>IBASE_RES_CREATE</info>. Read the section about  for
                             further information.
  <info>bool    </info>  <strong>$verbose       </strong>  Since the restore process is done on the database server, you don't
                             have any chance to get its output. This argument is useless.

<comment>Return:</comment>
  <info>mixed</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
         
         Since the restore process is done on the (remote) server, this function just passes the
         arguments to it. While the arguments are legal, you won't get <info>false</info>.

<comment>See Also:</comment>
   * <strong>ibase_backup()</strong>


id: ibase_rollback_ret
type: function
doc:
<comment>Description:</comment>
  Roll back a transaction without closing it
  
  Rolls back a transaction without closing it.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  If called without an argument, this function rolls back the
                                       default transaction of the default link. If the argument is a
                                       connection identifier, the default transaction of the
                                       corresponding connection will be rolled back. If the argument
                                       is a transaction identifier, the corresponding transaction
                                       will be rolled back. The transaction context will be
                                       retained, so statements executed from within this transaction
                                       will not be invalidated.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: ibase_server_info
type: function
doc:
<comment>Description:</comment>
  Request information about a database server

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  A previously created connection to the database server.
  <info>int     </info>  <strong>$action        </strong>  A valid constant.

<comment>Return:</comment>
  <info>string</info>  Returns mixed types depending on context.


id: ibase_service_attach
type: function
doc:
<comment>Description:</comment>
  Connect to the service manager

<comment>Param:</comment>
  <info>string</info>  <strong>$host        </strong>  The name or ip address of the database host. You can define the port by
                         adding  '/' and port number. If no port is specified, port 3050 will be
                         used.
  <info>string</info>  <strong>$dba_username</strong>  The name of any valid user.
  <info>string</info>  <strong>$dba_password</strong>  The user's password.

<comment>Return:</comment>
  <info>resourcefalse</info>  Returns a Interbase / Firebird link identifier on success o <info>false</info> in caso di
                 fallimento.

<comment>See Also:</comment>
   * <strong>ibase_service_detach()</strong>


id: ibase_service_detach
type: function
doc:
<comment>Description:</comment>
  Disconnect from the service manager

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  A previously created connection to the database server.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: ibase_set_event_handler
type: function
doc:
<comment>Description:</comment>
  Register a callback function to be called when events are posted
  
  This function registers a PHP user function as event handler for the specified events.

<comment>Param:</comment>
  <info>callable</info>  <strong>$event_handler</strong>  The callback is called with the event name and the link resource as
                            arguments whenever one of the specified events is posted by the
                            database.
                            
                            The callback must return <info>false</info> if the event handler should be canceled.
                            Any other return value is ignored. This function accepts up to 15 event
                            arguments.
  <info>string  </info>  <strong>$event_name   </strong>  An event name.
  <info>string  </info>  <strong>$event_names  </strong>  At most 15 events allowed.

<comment>Return:</comment>
  <info>resource</info>  The return value is an event resource. This resource can be used to free the event
            handler using <strong>ibase_free_event_handler()</strong>.

<comment>See Also:</comment>
   * <strong>ibase_free_event_handler()</strong>
   * <strong>ibase_wait_event()</strong>


id: ibase_wait_event
type: function
doc:
<comment>Description:</comment>
  Wait for an event to be posted by the database
  
  This function suspends execution of the script until one of the specified events is posted by the
  database. The name of the event that was posted is returned. This function accepts up to 15 event
  arguments.

<comment>Param:</comment>
  <info>string</info>  <strong>$event_name </strong>  The event name.
  <info>string</info>  <strong>$event_names</strong>  

<comment>Return:</comment>
  <info>string</info>  Returns the name of the event that was posted.

<comment>See Also:</comment>
   * <strong>ibase_set_event_handler()</strong>
   * <strong>ibase_free_event_handler()</strong>


id: iconv
type: function
doc:
<comment>Description:</comment>
  Converte una stringa nella codifica di caratteri richiesta
  
  Esegue una conversione del set di caratteri sulla stringa <strong>$str</strong> da <strong>$in_charset</strong> a <strong>$out_charset</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$in_charset </strong>  La codifica di caratteri di input.
  <info>string</info>  <strong>$out_charset</strong>  La codifica di caratteri di output.
                        
                        Se si aggiunge la stringa <return>//TRANSLIT</return> a <strong>$out_charset</strong>, la traslitterazione
                        verrà attivata. Questo significa che quando un carattere non può essere
                        rappresentato nella codifica di caratteri voluta, esso può essere
                        approssimato mediante uno o molti caratteri simili. Se si aggiunge la
                        stringa <return>//IGNORE</return>, i caratteri che non possono essere rappresentati nella
                        codifica di caratteri voluta sono scartati silenziosamente. In caso
                        contrario, viene generato un <info>E_NOTICE</info> e la funzione restituirà <info>false</info>.
  <info>string</info>  <strong>$str        </strong>  La stringa da convertire.

<comment>Return:</comment>
  <info>string</info>  Restituisce la stringa convertita o <info>false</info> in caso di fallimento.


id: iconv_get_encoding
type: function
doc:
<comment>Description:</comment>
  Recupera variabili di configurazione interna dell'estensione iconv
  
  Recupera variabili di configurazione interna dell'estensione iconv.

<comment>Param:</comment>
  <info>string</info>  <strong>$type</strong>  Il valore del parametro opzionale <strong>$type</strong> può essere:
                 allinput_encodingoutput_encodinginternal_encoding

<comment>Return:</comment>
  <info>mixed</info>  Restituisce il valore attuale della variabile di configurazione interna in caso di successo
         o <info>false</info> in caso di fallimento.
         
         Se il parametro <strong>$type</strong> è omesso o impostato a "all", <strong>iconv_get_encoding()</strong> restituisce un
         array che contiene tutte queste variabili.

<comment>See Also:</comment>
   * <strong>iconv_set_encoding()</strong>
   * <strong>ob_iconv_handler()</strong>


id: iconv_mime_decode
type: function
doc:
<comment>Description:</comment>
  Decodes a MIME header field
  
  Decodes a <return>MIME</return> header field.

<comment>Param:</comment>
  <info>string    </info>  <strong>$string  </strong>  The encoded header, as a string.
  <info>int       </info>  <strong>$mode    </strong>  <strong>$mode</strong> determines the behaviour in the event <strong>iconv_mime_decode()</strong> encounters
                         a malformed <return>MIME</return> header field. You can specify any combination of the
                         following bitmasks. Bitmasks acceptable to
                         <strong>iconv_mime_decode()</strong>ValueConstantDescription1ICONV_MIME_DECODE_STRICT If
                         set, the given header is decoded in full conformance with the standards
                         defined in RFC2047. This option is disabled by default because there are a
                         lot of broken mail user agents that don't follow the specification and
                         don't produce correct <return>MIME</return> headers. 2ICONV_MIME_DECODE_CONTINUE_ON_ERROR If
                         set, <strong>iconv_mime_decode_headers()</strong> attempts to ignore any grammatical errors
                         and continue to process a given header.
  <info>stringnull</info>  <strong>$encoding</strong>  The optional <strong>$encoding</strong> parameter specifies the character set to represent
                         the result by. If omitted or <info>null</info>, iconv.internal_encoding will be used.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a decoded <return>MIME</return> field on success, or <info>false</info> if an error occurs during the
               decoding.

<comment>See Also:</comment>
   * <strong>iconv_mime_decode_headers()</strong>
   * <strong>mb_decode_mimeheader()</strong>
   * <strong>imap_mime_header_decode()</strong>
   * <strong>imap_base64()</strong>
   * <strong>imap_qprint()</strong>


id: iconv_mime_decode_headers
type: function
doc:
<comment>Description:</comment>
  Decodes multiple MIME header fields at once
  
  Decodes multiple <return>MIME</return> header fields at once.

<comment>Param:</comment>
  <info>string    </info>  <strong>$headers </strong>  The encoded headers, as a string.
  <info>int       </info>  <strong>$mode    </strong>  <strong>$mode</strong> determines the behaviour in the event <strong>iconv_mime_decode_headers()</strong>
                         encounters a malformed <return>MIME</return> header field. You can specify any combination
                         of the following bitmasks. Bitmasks acceptable to
                         <strong>iconv_mime_decode_headers()</strong>ValueConstantDescription1ICONV_MIME_DECODE_STRICT
                         If set, the given header is decoded in full conformance with the standards
                         defined in RFC2047. This option is disabled by default because there are a
                         lot of broken mail user agents that don't follow the specification and
                         don't produce correct <return>MIME</return> headers. 2ICONV_MIME_DECODE_CONTINUE_ON_ERROR If
                         set, <strong>iconv_mime_decode_headers()</strong> attempts to ignore any grammatical errors
                         and continue to process a given header.
  <info>stringnull</info>  <strong>$encoding</strong>  The optional <strong>$encoding</strong> parameter specifies the character set to represent
                         the result by. If omitted or <info>null</info>, iconv.internal_encoding will be used.

<comment>Return:</comment>
  <info>arrayfalse</info>  Returns an associative array that holds a whole set of <return>MIME</return> header fields specified by
              <strong>$headers</strong> on success, or <info>false</info> if an error occurs during the decoding.
              
              Each key of the return value represents an individual field name and the corresponding
              element represents a field value. If more than one field of the same name are present,
              <strong>iconv_mime_decode_headers()</strong> automatically incorporates them into a numerically indexed
              array in the order of occurrence.

<comment>See Also:</comment>
   * <strong>iconv_mime_decode()</strong>
   * <strong>mb_decode_mimeheader()</strong>
   * <strong>imap_mime_header_decode()</strong>
   * <strong>imap_base64()</strong>
   * <strong>imap_qprint()</strong>


id: iconv_mime_encode
type: function
doc:
<comment>Description:</comment>
  Composes a MIME header field
  
  Composes and returns a string that represents a valid <return>MIME</return> header field, which looks like the
  following:  In the above example, "Subject" is the field name and the portion that begins with
  "=?ISO-8859-1?..." is the field value.

<comment>Param:</comment>
  <info>string</info>  <strong>$field_name </strong>  The field name.
  <info>string</info>  <strong>$field_value</strong>  The field value.
  <info>array </info>  <strong>$options    </strong>  You can control the behaviour of <strong>iconv_mime_encode()</strong> by specifying an
                        associative array that contains configuration items to the optional third
                        parameter <strong>$options</strong>. The items supported by <strong>iconv_mime_encode()</strong> are listed
                        below. Note that item names are treated case-sensitive. Configuration items
                        supported by <strong>iconv_mime_encode()</strong>ItemTypeDescriptionDefault
                        valueExamplescheme<info>string</info> Specifies the method to encode a field value by.
                        The value of this item may be either "B" or "Q", where "B" stands for <return>base64</return>
                        encoding scheme and "Q" stands for <return>quoted-printable</return> encoding scheme.
                        BBinput-charset<info>string</info> Specifies the character set in which the first
                        parameter <strong>$field_name</strong> and the second parameter <strong>$field_value</strong> are presented.
                        If not given, <strong>iconv_mime_encode()</strong> assumes those parameters are presented to
                        it in the iconv.internal_encoding ini setting.
                        iconv.internal_encodingISO-8859-1output-charset<info>string</info> Specifies the
                        character set to use to compose the <return>MIME</return> header.
                        iconv.internal_encodingUTF-8line-length<info>int</info> Specifies the maximum length of
                        the header lines. The resulting header is "folded" to a set of multiple
                        lines in case the resulting header field would be longer than the value of
                        this parameter, according to RFC2822 - Internet Message Format. If not
                        given, the length will be limited to 76 characters.
                        76996line-break-chars<info>string</info> Specifies the sequence of characters to append
                        to each line as an end-of-line sign when "folding" is performed on a long
                        header field. If not given, this defaults to "\r\n" (<return>CR</return> <return>LF</return>). Note that this
                        parameter is always treated as an ASCII string regardless of the value of
                        <return>input-charset</return>. \r\n\n

<comment>Return:</comment>
  <info>stringfalse</info>  Returns an encoded <return>MIME</return> field on success, or <info>false</info> if an error occurs during the
               encoding.

<comment>See Also:</comment>
   * <strong>imap_binary()</strong>
   * <strong>mb_encode_mimeheader()</strong>
   * <strong>imap_8bit()</strong>
   * <strong>quoted_printable_encode()</strong>


id: iconv_set_encoding
type: function
doc:
<comment>Description:</comment>
  Setta l'attuale impostazione per la conversione della codifica dei caratteri
  
  Modifica il valore della variabile di configurazione interna specificata da <strong>$type</strong> in <strong>$charset</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$type   </strong>  Il valore di <strong>$type</strong> può essere uno di questi:
                    input_encodingoutput_encodinginternal_encoding
  <info>string</info>  <strong>$charset</strong>  Il set di caratteri.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>iconv_get_encoding()</strong>
   * <strong>ob_iconv_handler()</strong>


id: iconv_strlen
type: function
doc:
<comment>Description:</comment>
  Returns the character count of string
  
  In contrast to <strong>strlen()</strong>, <strong>iconv_strlen()</strong> counts the occurrences of characters in the given byte
  sequence <strong>$string</strong> on the basis of the specified character set, the result of which is not
  necessarily identical to the length of the string in byte.

<comment>Param:</comment>
  <info>string    </info>  <strong>$string  </strong>  The string.
  <info>stringnull</info>  <strong>$encoding</strong>  If <strong>$encoding</strong> parameter is omitted or <info>null</info>, <strong>$string</strong> is assumed to be encoded
                         in iconv.internal_encoding.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the character count of <strong>$string</strong>, as an integer, or <info>false</info> if an error occurs
            during the encoding.

<comment>See Also:</comment>
   * <strong>grapheme_strlen()</strong>
   * <strong>mb_strlen()</strong>
   * <strong>strlen()</strong>


id: iconv_strpos
type: function
doc:
<comment>Description:</comment>
  Finds position of first occurrence of a needle within a haystack
  
  Finds position of first occurrence of a <strong>$needle</strong> within a <strong>$haystack</strong>.
  
  In contrast to <strong>strpos()</strong>, the return value of <strong>iconv_strpos()</strong> is the number of characters that
  appear before the needle, rather than the offset in bytes to the position where the needle has
  been found. The characters are counted on the basis of the specified character set <strong>$encoding</strong>.

<comment>Param:</comment>
  <info>string    </info>  <strong>$haystack</strong>  The entire string.
  <info>string    </info>  <strong>$needle  </strong>  The searched substring.
  <info>int       </info>  <strong>$offset  </strong>  The optional <strong>$offset</strong> parameter specifies the position from which the search
                         should be performed. If the offset is negative, it is counted from the end
                         of the string.
  <info>stringnull</info>  <strong>$encoding</strong>  If <strong>$encoding</strong> parameter is omitted or <info>null</info>, <strong>$string</strong> are assumed to be
                         encoded in iconv.internal_encoding.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the numeric position of the first occurrence of <strong>$needle</strong> in <strong>$haystack</strong>.
            
            If <strong>$needle</strong> is not found, <strong>iconv_strpos()</strong> will return <info>false</info>.
            
            Questa funzione può
            restituire il Booleano <info>false</info>, ma può anche restituire un valore non-Booleano valutato
            come <info>false</info>. Fare riferimento alla sezione Booleans per maggiori 
            informazioni. Usare l'operatore ===
             per controllare il valore restituito da questa 
            funzione.

<comment>See Also:</comment>
   * <strong>strpos()</strong>
   * <strong>iconv_strrpos()</strong>
   * <strong>mb_strpos()</strong>


id: iconv_strrpos
type: function
doc:
<comment>Description:</comment>
  Finds the last occurrence of a needle within a haystack
  
  Finds the last occurrence of a <strong>$needle</strong> within a <strong>$haystack</strong>.
  
  In contrast to <strong>strrpos()</strong>, the return value of <strong>iconv_strrpos()</strong> is the number of characters that
  appear before the needle, rather than the offset in bytes to the position where the needle has
  been found. The characters are counted on the basis of the specified character set <strong>$encoding</strong>.

<comment>Param:</comment>
  <info>string    </info>  <strong>$haystack</strong>  The entire string.
  <info>string    </info>  <strong>$needle  </strong>  The searched substring.
  <info>stringnull</info>  <strong>$encoding</strong>  If <strong>$encoding</strong> parameter is omitted or <info>null</info>, <strong>$string</strong> are assumed to be
                         encoded in iconv.internal_encoding.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the numeric position of the last occurrence of <strong>$needle</strong> in <strong>$haystack</strong>.
            
            If <strong>$needle</strong> is not found, <strong>iconv_strrpos()</strong> will return <info>false</info>.
            
            Questa funzione può
            restituire il Booleano <info>false</info>, ma può anche restituire un valore non-Booleano valutato
            come <info>false</info>. Fare riferimento alla sezione Booleans per maggiori 
            informazioni. Usare l'operatore ===
             per controllare il valore restituito da questa 
            funzione.

<comment>See Also:</comment>
   * <strong>strrpos()</strong>
   * <strong>iconv_strpos()</strong>
   * <strong>mb_strrpos()</strong>


id: iconv_substr
type: function
doc:
<comment>Description:</comment>
  Cut out part of a string
  
  Cuts a portion of <strong>$string</strong> specified by the  <strong>$offset</strong> and <strong>$length</strong> parameters.

<comment>Param:</comment>
  <info>string    </info>  <strong>$string  </strong>  The original string.
  <info>int       </info>  <strong>$offset  </strong>  If <strong>$offset</strong> is non-negative, <strong>iconv_substr()</strong> cuts the portion out of <strong>$string</strong>
                         beginning at <strong>$offset</strong>'th character, counting from zero.
                         
                         If <strong>$offset</strong> is negative, <strong>iconv_substr()</strong> cuts out the portion beginning at
                         the position, <strong>$offset</strong> characters away from the end of <strong>$string</strong>.
  <info>intnull   </info>  <strong>$length  </strong>  If <strong>$length</strong> is given and is positive, the return value will contain at most
                         <strong>$length</strong> characters of the portion that begins at <strong>$offset</strong> (depending on the
                         length of <strong>$string</strong>).
                         
                         If negative <strong>$length</strong> is passed, <strong>iconv_substr()</strong> cuts the portion out of
                         <strong>$string</strong> from the <strong>$offset</strong>'th character up to the character that is <strong>$length</strong>
                         characters away from the end of the string. In case <strong>$offset</strong> is also
                         negative, the start position is calculated beforehand according to the rule
                         explained above.
  <info>stringnull</info>  <strong>$encoding</strong>  If <strong>$encoding</strong> parameter is omitted or <info>null</info>, <strong>$string</strong> are assumed to be
                         encoded in iconv.internal_encoding.
                         
                         Note that <strong>$offset</strong> and <strong>$length</strong> parameters are always deemed to represent
                         offsets that are calculated on the basis of the character set determined by
                         <strong>$encoding</strong>, whilst the counterpart <strong>substr()</strong> always takes these for byte
                         offsets.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the portion of <strong>$string</strong> specified by the <strong>$offset</strong> and <strong>$length</strong> parameters.
               
               If <strong>$string</strong> is shorter than <strong>$offset</strong> characters long, <info>false</info> will be returned. If
               <strong>$string</strong> is exactly <strong>$offset</strong> characters long, an empty string will be returned.

<comment>See Also:</comment>
   * <strong>substr()</strong>
   * <strong>mb_substr()</strong>
   * <strong>mb_strcut()</strong>


id: idate
type: function
doc:
<comment>Description:</comment>
  Format a local time/date as integer
  
  Returns a number formatted according to the given format string using the given integer <strong>$timestamp</strong>
  or the current local time if no timestamp is given. In other words, <strong>$timestamp</strong> is optional and
  defaults to the value of <strong>time()</strong>.
  
  Unlike the function <strong>date()</strong>, <strong>idate()</strong> accepts just one char in the <strong>$format</strong> parameter.

<comment>Param:</comment>
  <info>string </info>  <strong>$format   </strong>  The following characters are recognized in the <strong>$format</strong> parameter
                       string<strong>$format</strong> characterDescription<return>B</return>Swatch Beat/Internet Time<return>d</return>Day of the
                       month<return>h</return>Hour (12 hour format)<return>H</return>Hour (24 hour format)<return>i</return>Minutes<return>I</return> (uppercase
                       i)returns <return>1</return> if DST is activated, <return>0</return> otherwise<return>L</return> (uppercase l)returns <return>1</return> for leap
                       year, <return>0</return> otherwise<return>m</return>Month number<return>s</return>Seconds<return>t</return>Days in current month<return>U</return>Seconds since
                       the Unix Epoch - January 1 1970 00:00:00 UTC - this is the same as <strong>time()</strong><return>w</return>Day
                       of the week (<return>0</return> on Sunday)<return>W</return>ISO-8601 week number of year, weeks starting on
                       Monday<return>y</return>Year (1 or 2 digits - check note below)<return>Y</return>Year (4 digits)<return>z</return>Day of the
                       year<return>Z</return>Timezone offset in seconds
  <info>intnull</info>  <strong>$timestamp</strong>  Il parametro opzionale <strong>$timestamp</strong> è un 
                       <info>integer</info> timestamp Unix che ha come default
                       l'ora locale attuale se un <strong>$timestamp</strong> non è fornito. In altre 
                       parole, ha come default il valore di <strong>time()</strong>.

<comment>Return:</comment>
  <info>intfalse</info>  Returns an <info>int</info> on success,  o <info>false</info> in caso di fallimento.
            
            As <strong>idate()</strong> always returns an <info>int</info> and as they can't start with a "0", <strong>idate()</strong> may return
            fewer digits than you would expect. See the example below.

<comment>See Also:</comment>
   * <strong>date()</strong>
   * <strong>getdate()</strong>
   * <strong>time()</strong>


id: idn_to_ascii
type: function
doc:
<comment>Description:</comment>
  Convert domain name to IDNA ASCII form
  
  Stile procedurale
  
  This function converts a Unicode domain name to an IDNA ASCII-compatible format.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain   </strong>  The domain to convert, which must be UTF-8 encoded.
  <info>int   </info>  <strong>$options  </strong>  Conversion options - combination of IDNA_* constants (except IDNA_ERROR_*
                      constants).
  <info>int   </info>  <strong>$variant  </strong>  Either <info>INTL_IDNA_VARIANT_2003</info> (deprecated as of PHP 7.2.0) for IDNA 2003 or
                      <info>INTL_IDNA_VARIANT_UTS46</info> (only available as of ICU 4.6) for UTS #46.
  <info>array </info>  <strong>$idna_info</strong>  This parameter can be used only if <info>INTL_IDNA_VARIANT_UTS46</info> was used for
                      <strong>$variant</strong>. In that case, it will be filled with an array with the keys
                      <return>'result'</return>, the possibly illegal result of the transformation,
                      <return>'isTransitionalDifferent'</return>, a boolean indicating whether the usage of the
                      transitional mechanisms of UTS #46 either has or would have changed the result
                      and <return>'errors'</return>, which is an <info>int</info> representing a bitset of the error constants
                      IDNA_ERROR_*.

<comment>Return:</comment>
  <info>stringfalse</info>  The domain name encoded in ASCII-compatible form,  o <info>false</info> in caso di fallimento

<comment>See Also:</comment>
   * <strong>idn_to_utf8()</strong>


id: idn_to_utf8
type: function
doc:
<comment>Description:</comment>
  Convert domain name from IDNA ASCII to Unicode
  
  Stile procedurale
  
  This function converts a Unicode domain name from an IDNA ASCII-compatible format to plain
  Unicode, encoded in UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain   </strong>  Domain to convert in an IDNA ASCII-compatible format.
  <info>int   </info>  <strong>$options  </strong>  Conversion options - combination of IDNA_* constants (except IDNA_ERROR_*
                      constants).
  <info>int   </info>  <strong>$variant  </strong>  Either <info>INTL_IDNA_VARIANT_2003</info> (deprecated as of PHP 7.2.0) for IDNA 2003 or
                      <info>INTL_IDNA_VARIANT_UTS46</info> (only available as of ICU 4.6) for UTS #46.
  <info>array </info>  <strong>$idna_info</strong>  This parameter can be used only if <info>INTL_IDNA_VARIANT_UTS46</info> was used for
                      <strong>$variant</strong>. In that case, it will be filled with an array with the keys
                      <return>'result'</return>, the possibly illegal result of the transformation,
                      <return>'isTransitionalDifferent'</return>, a boolean indicating whether the usage of the
                      transitional mechanisms of UTS #46 either has or would have changed the result
                      and <return>'errors'</return>, which is an <info>int</info> representing a bitset of the error constants
                      IDNA_ERROR_*.

<comment>Return:</comment>
  <info>stringfalse</info>  The domain name in Unicode, encoded in UTF-8,  o <info>false</info> in caso di fallimento

<comment>See Also:</comment>
   * <strong>idn_to_ascii()</strong>


id: ignore_user_abort
type: function
doc:
<comment>Description:</comment>
  Set whether a client disconnect should abort script execution
  
  Sets whether a client disconnect should cause a script to be aborted.
  
  When running PHP as a command line script, and the script's tty goes away without the script being
  terminated then the script will die the next time it tries to write anything, unless <strong>$enable</strong> is
  set to <info>true</info>

<comment>Param:</comment>
  <info>boolnull</info>  <strong>$enable</strong>  If set and not <info>null</info>, this function will set the ignore_user_abort ini setting
                     to the given <strong>$enable</strong>. Otherwise, this function will only return the previous
                     setting without changing it.

<comment>Return:</comment>
  <info>int</info>  Returns the previous setting, as an integer.

<comment>See Also:</comment>
   * <strong>connection_aborted()</strong>
   * <strong>connection_status()</strong>
   * Connection Handling
     for a complete description of connection handling in PHP.
    


id: iis_get_script_map
type: function
doc:
<comment>Description:</comment>
  Riceve informazioni sul mapping dello script sulla cartella virtuale per una specifica estensioneo


id: image2wbmp
type: function
doc:
<comment>Description:</comment>
  Rende disponibile l'immagine per il browser o la salva in un file


id: image_type_to_extension
type: function
doc:
<comment>Description:</comment>
  Get file extension for image type
  
  Returns the extension for the given <return>IMAGETYPE_XXX</return> constant.

<comment>Param:</comment>
  <info>int </info>  <strong>$image_type </strong>  One of the <return>IMAGETYPE_XXX</return> constant.
  <info>bool</info>  <strong>$include_dot</strong>  Whether to prepend a dot to the extension or not. Default to <info>true</info>.

<comment>Return:</comment>
  <info>stringfalse</info>  A string with the extension corresponding to the given image type,  o <info>false</info> in caso
               di fallimento.


id: image_type_to_mime_type
type: function
doc:
<comment>Description:</comment>
  Get Mime-Type for image-type returned by getimagesize,
     exif_read_data, exif_thumbnail, exif_imagetype
  
  The <strong>image_type_to_mime_type()</strong> function will determine the Mime-Type for an IMAGETYPE constant.

<comment>Param:</comment>
  <info>int</info>  <strong>$image_type</strong>  One of the <return>IMAGETYPE_XXX</return> constants.

<comment>Return:</comment>
  <info>string</info>  The returned values are as follows Returned values Constants<strong>$image_type</strong>Returned
          value<info>IMAGETYPE_GIF</info><return>image/gif</return><info>IMAGETYPE_JPEG</info><return>image/jpeg</return><info>IMAGETYPE_PNG</info><return>image/png</return><info>IMAGETYPE_SWF</info><return>application/x-shockwave-flash</return><info>IMAGETYPE_PSD</info><return>image/psd</return><info>IMAGETYPE_BMP</info><return>image/bmp</return><info>IMAGETYPE_TIFF_II</info>
          (intel byte order)<return>image/tiff</return><info>IMAGETYPE_TIFF_MM</info> (motorola byte order)
          <return>image/tiff</return><info>IMAGETYPE_JPC</info><return>application/octet-stream</return><info>IMAGETYPE_JP2</info><return>image/jp2</return><info>IMAGETYPE_JPX</info><return>application/octet-stream</return><info>IMAGETYPE_JB2</info><return>application/octet-stream</return><info>IMAGETYPE_SWC</info><return>application/x-shockwave-flash</return><info>IMAGETYPE_IFF</info><return>image/iff</return><info>IMAGETYPE_WBMP</info><return>image/vnd.wap.wbmp</return><info>IMAGETYPE_XBM</info><return>image/xbm</return><info>IMAGETYPE_ICO</info><return>image/vnd.microsoft.icon</return><info>IMAGETYPE_WEBP</info><return>image/webp</return>

<comment>See Also:</comment>
   * <strong>getimagesize()</strong>
   * <strong>exif_imagetype()</strong>
   * <strong>exif_read_data()</strong>
   * <strong>exif_thumbnail()</strong>


id: imageaffine
type: function
doc:
<comment>Description:</comment>
  Return an image containing the affine transformed src image, using an optional clipping area
  
  Questa funzione, al momento
  non è documentata; è disponibile soltanto la lista degli argomenti.

<comment>Param:</comment>
  <info>     </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$affine</strong>  Array with keys 0 to 5.
  <info>array</info>  <strong>$clip  </strong>  Array with keys "x", "y", "width" and "height".

<comment>Return:</comment>
  <info>resourcefalse</info>  Return affined image resource on success o <info>false</info> in caso di fallimento.


id: imageaffinematrixconcat
type: function
doc:
<comment>Description:</comment>
  Concatenate two affine transformation matrices
  
  Returns the concatenation of two affine transformation matrices, what is useful if multiple
  transformations should be applied to the same image in one go.

<comment>Param:</comment>
  <info>array</info>  <strong>$m1</strong>  An affine transformation matrix (an array with keys <return>0</return> to <return>5</return> and float values).
  <info>array</info>  <strong>$m2</strong>  An affine transformation matrix (an array with keys <return>0</return> to <return>5</return> and float values).

<comment>Return:</comment>
  <info>arrayfalse</info>  An affine transformation matrix (an array with keys <return>0</return> to <return>5</return> and float values) o <info>false</info>
              in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imageaffine()</strong>
   * <strong>imageaffinematrixget()</strong>


id: imageaffinematrixget
type: function
doc:
<comment>Description:</comment>
  Get an affine transformation matrix
  
  Returns an affine transformation matrix.

<comment>Param:</comment>
  <info>int  </info>  <strong>$type   </strong>  One of the <info>IMG_AFFINE_*</info> constants.
  <info>mixed</info>  <strong>$options</strong>  If <strong>$type</strong> is <info>IMG_AFFINE_TRANSLATE</info> or <info>IMG_AFFINE_SCALE</info>, <strong>$options</strong> has to be an <info>array</info>
                   with keys <return>x</return> and <return>y</return>, both having <info>float</info> values.
                   
                   If <strong>$type</strong> is <info>IMG_AFFINE_ROTATE</info>, <info>IMG_AFFINE_SHEAR_HORIZONTAL</info> or
                   <info>IMG_AFFINE_SHEAR_VERTICAL</info>, <strong>$options</strong> has to be a <info>float</info> specifying the angle.

<comment>Return:</comment>
  <info>arrayfalse</info>  An affine transformation matrix (an array with keys <return>0</return> to <return>5</return> and float values) o <info>false</info>
              in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imageaffine()</strong>
   * <strong>imageaffinematrixconcat()</strong>


id: imagealphablending
type: function
doc:
<comment>Description:</comment>
  Set the blending mode for an image
  
  <strong>imagealphablending()</strong> allows for two different modes of drawing on truecolor images. In blending
  mode, the alpha channel component of the color supplied to all drawing function, such as
  <strong>imagesetpixel()</strong> determines how much of the underlying color should be allowed to shine through.
  As a result, gd automatically blends the existing color at that point with the drawing color, and
  stores the result in the image.  The resulting pixel is opaque.  In non-blending mode, the drawing
  color is copied literally with its alpha channel information, replacing the destination pixel.
  Blending mode is not available when drawing on palette images.

<comment>Param:</comment>
  <info>    </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                    come <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>  <strong>$blendmode</strong>  Whether to enable the blending mode or not. On true color images  the default
                    value is <info>true</info> otherwise the default value is <info>false</info>

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imageantialias
type: function
doc:
<comment>Description:</comment>
  Should antialias functions be used or not
  
  Activate the fast drawing antialiased methods for lines and wired polygons. It does not support
  alpha components. It works using a direct blend operation. It works only with truecolor images.
  
  Thickness and styled are not supported.
  
  Using antialiased primitives with transparent background color can end with some unexpected
  results. The blend method uses the background color as any other colors. The lack of alpha
  component support does not allow an alpha based antialiasing method.

<comment>Param:</comment>
  <info>    </info>  <strong>$image  </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>  <strong>$enabled</strong>  Whether to enable antialiasing or not.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>


id: imagearc
type: function
doc:
<comment>Description:</comment>
  Draws an arc
  
  <strong>imagearc()</strong> draws an arc of circle centered at the given coordinates.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$cx    </strong>  x-coordinate of the center.
  <info>int</info>  <strong>$cy    </strong>  y-coordinate of the center.
  <info>int</info>  <strong>$width </strong>  The arc width.
  <info>int</info>  <strong>$height</strong>  The arc height.
  <info>int</info>  <strong>$start </strong>  The arc start angle, in degrees.
  <info>int</info>  <strong>$end   </strong>  The arc end angle, in degrees. 0° is located at the three-o'clock position, and the
                arc is drawn clockwise.
  <info>int</info>  <strong>$color </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagefilledarc()</strong>
   * <strong>imageellipse()</strong>
   * <strong>imagefilledellipse()</strong>


id: imagebmp
type: function
doc:
<comment>Description:</comment>
  Output a BMP image to browser or file
  
  Outputs or saves a BMP version of the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to        </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene
                      restituito il flusso raw dell'immagine.
                      
                      <info>null</info> is invalid if the <strong>$compressed</strong> arguments is not used.
  <info>bool </info>  <strong>$compressed</strong>  Whether the BMP should be compressed with run-length encoding (RLE), or not.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.


id: imagechar
type: function
doc:
<comment>Description:</comment>
  Draw a character horizontally
  
  <strong>imagechar()</strong> draws the first character of <strong>$c</strong> in the image identified by <strong>$image</strong> with its upper-left
  at <strong>$x</strong>,<strong>$y</strong> (top left is 0, 0) with the color <strong>$color</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>      </info>  <strong>$font </strong>  Può essere 1, 2, 3, 4, 5 per i font
                  interni con codifica latin2 (dove numeri più alti corrispondono a font più grandi)
                  o qualsiasi
                  identificatore di font registrato con <strong>imageloadfont()</strong>.
  <info>int   </info>  <strong>$x    </strong>  x-coordinate of the start.
  <info>int   </info>  <strong>$y    </strong>  y-coordinate of the start.
  <info>string</info>  <strong>$c    </strong>  The character to draw.
  <info>int   </info>  <strong>$color</strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecharup()</strong>
   * <strong>imageloadfont()</strong>


id: imagecharup
type: function
doc:
<comment>Description:</comment>
  Draw a character vertically
  
  Draws the character <strong>$c</strong> vertically at the specified coordinate on the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>      </info>  <strong>$font </strong>  Può essere 1, 2, 3, 4, 5 per i font
                  interni con codifica latin2 (dove numeri più alti corrispondono a font più grandi)
                  o qualsiasi
                  identificatore di font registrato con <strong>imageloadfont()</strong>.
  <info>int   </info>  <strong>$x    </strong>  x-coordinate of the start.
  <info>int   </info>  <strong>$y    </strong>  y-coordinate of the start.
  <info>string</info>  <strong>$c    </strong>  The character to draw.
  <info>int   </info>  <strong>$color</strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagechar()</strong>
   * <strong>imageloadfont()</strong>


id: imagecolorallocate
type: function
doc:
<comment>Description:</comment>
  Allocate a color for an image
  
  Returns a color identifier representing the color composed of the given RGB components.
  
  <strong>imagecolorallocate()</strong> must be called to create each color that is to be used in the image
  represented by <strong>$image</strong>.
  
  The first call to <strong>imagecolorallocate()</strong> fills the background color in palette-based images - images
  created using <strong>imagecreate()</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.

<comment>Return:</comment>
  <info>int</info>  A color identifier or <info>false</info> if the allocation failed.
       
       Questa funzione può
       restituire il Booleano <info>false</info>, ma può anche restituire un valore non-Booleano valutato
       come <info>false</info>. Fare riferimento alla sezione Booleans per maggiori 
       informazioni. Usare l'operatore ===
        per controllare il valore restituito da questa 
       funzione.

<comment>See Also:</comment>
   * <strong>imagecolorallocatealpha()</strong>
   * <strong>imagecolordeallocate()</strong>


id: imagecolorallocatealpha
type: function
doc:
<comment>Description:</comment>
  Allocate a color for an image
  
  <strong>imagecolorallocatealpha()</strong> behaves identically to <strong>imagecolorallocate()</strong> with the addition of the
  transparency parameter <strong>$alpha</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.
  <info>int</info>  <strong>$alpha</strong>  A value between <return>0</return> and <return>127</return>. <return>0</return> indicates completely opaque while  <return>127</return> indicates
               completely transparent.

<comment>Return:</comment>
  <info>int</info>  A color identifier or <info>false</info> if the allocation failed.
       
       Questa funzione può
       restituire il Booleano <info>false</info>, ma può anche restituire un valore non-Booleano valutato
       come <info>false</info>. Fare riferimento alla sezione Booleans per maggiori 
       informazioni. Usare l'operatore ===
        per controllare il valore restituito da questa 
       funzione.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolordeallocate()</strong>


id: imagecolorat
type: function
doc:
<comment>Description:</comment>
  Get the index of the color of a pixel
  
  Returns the index of the color of the pixel at the specified location in the image specified by
  <strong>$image</strong>.
  
  If the image is a truecolor image, this function returns the RGB value of that pixel as integer.
  Use bitshifting and masking to access the distinct red, green and blue component values:

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x    </strong>  x-coordinate of the point.
  <info>int</info>  <strong>$y    </strong>  y-coordinate of the point.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the index of the color  o <info>false</info> in caso di fallimento.
            
            Questa funzione può
            restituire il Booleano <info>false</info>, ma può anche restituire un valore non-Booleano valutato
            come <info>false</info>. Fare riferimento alla sezione Booleans per maggiori 
            informazioni. Usare l'operatore ===
             per controllare il valore restituito da questa 
            funzione.

<comment>See Also:</comment>
   * <strong>imagecolorset()</strong>
   * <strong>imagecolorsforindex()</strong>
   * <strong>imagesetpixel()</strong>


id: imagecolorclosest
type: function
doc:
<comment>Description:</comment>
  Get the index of the closest color to the specified color
  
  Returns the index of the color in the palette of the image which is "closest" to the specified RGB
  value.
  
  The "distance" between the desired color and each color in the palette is calculated as if the RGB
  values represented points in three-dimensional space.
  
  Se l'immagine è stata creata da un file, solo i colori usati nell'immagine sono risolti. I colori
  presenti solo nella palette non sono risolti.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.

<comment>Return:</comment>
  <info>int</info>  Returns the index of the closest color, in the palette of the image, to the specified one

<comment>See Also:</comment>
   * <strong>imagecolorexact()</strong>
   * <strong>imagecolorclosestalpha()</strong>
   * <strong>imagecolorclosesthwb()</strong>


id: imagecolorclosestalpha
type: function
doc:
<comment>Description:</comment>
  Get the index of the closest color to the specified color + alpha
  
  Returns the index of the color in the palette of the image which is "closest" to the specified RGB
  value and  <strong>$alpha</strong> level.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.
  <info>int</info>  <strong>$alpha</strong>  A value between <return>0</return> and <return>127</return>. <return>0</return> indicates completely opaque while  <return>127</return> indicates
               completely transparent.

<comment>Return:</comment>
  <info>int</info>  Returns the index of the closest color in the palette.

<comment>See Also:</comment>
   * <strong>imagecolorexactalpha()</strong>
   * <strong>imagecolorclosest()</strong>
   * <strong>imagecolorclosesthwb()</strong>


id: imagecolorclosesthwb
type: function
doc:
<comment>Description:</comment>
  Get the index of the color which has the hue, white and blackness
  
  Get the index of the color which has the hue,  white and blackness nearest the given color.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.

<comment>Return:</comment>
  <info>int</info>  Returns an integer with the index of the color which has  the hue, white and blackness
       nearest the given color.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolordeallocate
type: function
doc:
<comment>Description:</comment>
  De-allocate a color for an image
  
  De-allocates a color previously allocated with  <strong>imagecolorallocate()</strong> or <strong>imagecolorallocatealpha()</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$color</strong>  The color identifier.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolorallocatealpha()</strong>


id: imagecolorexact
type: function
doc:
<comment>Description:</comment>
  Get the index of the specified color
  
  Returns the index of the specified color in the palette of the image.
  
  Se l'immagine è stata creata da un file, solo i colori usati nell'immagine sono risolti. I colori
  presenti solo nella palette non sono risolti.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.

<comment>Return:</comment>
  <info>int</info>  Returns the index of the specified color in the palette, or -1 if the color does not exist.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorexactalpha
type: function
doc:
<comment>Description:</comment>
  Get the index of the specified color + alpha
  
  Returns the index of the specified color+alpha in the palette of the image.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.
  <info>int</info>  <strong>$alpha</strong>  A value between <return>0</return> and <return>127</return>. <return>0</return> indicates completely opaque while  <return>127</return> indicates
               completely transparent.

<comment>Return:</comment>
  <info>int</info>  Returns the index of the specified color+alpha in the palette of the image, or -1 if the
       color does not exist in the image's palette.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolormatch
type: function
doc:
<comment>Description:</comment>
  Makes the colors of the palette version of an image more closely match the true color version
  
  Makes the colors of the palette version of an image more closely match the true color version.

<comment>Param:</comment>
  <info>resource</info>  <strong>$image1</strong>  A truecolor image resource.
  <info>resource</info>  <strong>$image2</strong>  A palette image resource pointing to an image that has the same size as
                     <strong>$image1</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>


id: imagecolorresolve
type: function
doc:
<comment>Description:</comment>
  Get the index of the specified color or its closest possible alternative
  
  This function is guaranteed to return a color index for a requested color, either the exact color
  or the closest possible alternative.
  
  Se l'immagine è stata creata da un file, solo i colori usati nell'immagine sono risolti. I colori
  presenti solo nella palette non sono risolti.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.

<comment>Return:</comment>
  <info>int</info>  Returns a color index.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorresolvealpha
type: function
doc:
<comment>Description:</comment>
  Get the index of the specified color + alpha or its closest possible alternative
  
  This function is guaranteed to return a color index for a requested color, either the exact color
  or the closest possible alternative.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.
  <info>int</info>  <strong>$alpha</strong>  A value between <return>0</return> and <return>127</return>. <return>0</return> indicates completely opaque while  <return>127</return> indicates
               completely transparent.

<comment>Return:</comment>
  <info>int</info>  Returns a color index.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolorset
type: function
doc:
<comment>Description:</comment>
  Set the color for the specified palette index
  
  This sets the specified index in the palette to the specified color. This is useful for creating
  flood-fill-like effects in palleted images without the overhead of performing the actual
  flood-fill.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$index</strong>  An index in the palette.
  <info>int</info>  <strong>$red  </strong>  Valore della componente rossa.
  <info>int</info>  <strong>$green</strong>  Valore della componente verde.
  <info>int</info>  <strong>$blue </strong>  Valore della componente blu.
  <info>int</info>  <strong>$alpha</strong>  Value of alpha component.

<comment>Return:</comment>
  <info>void</info>  Nessun valore viene restituito.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>


id: imagecolorsforindex
type: function
doc:
<comment>Description:</comment>
  Get the colors for an index
  
  Gets the color for a specified index.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$index</strong>  The color index.

<comment>Return:</comment>
  <info>array</info>  Returns an associative array with red, green, blue and alpha keys that contain the
         appropriate values for the specified color index.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorexact()</strong>


id: imagecolorstotal
type: function
doc:
<comment>Description:</comment>
  Find out the number of colors in an image's palette
  
  Returns the number of colors in an image palette.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of colors in the specified image's palette or 0 for truecolor images.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorsforindex()</strong>
   * <strong>imageistruecolor()</strong>


id: imagecolortransparent
type: function
doc:
<comment>Description:</comment>
  Define a color as transparent
  
  Gets or sets the transparent color in the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$color</strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>int</info>  The identifier of the new (or current, if none is specified) transparent color is returned.
       If <strong>$color</strong> is not specified, and the image has no transparent color, the returned identifier
       will be -1.


id: imageconvolution
type: function
doc:
<comment>Description:</comment>
  Apply a 3x3 convolution matrix, using coefficient and offset
  
  Applies a convolution matrix on the image, using the given coefficient and offset.

<comment>Param:</comment>
  <info>     </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$matrix</strong>  A 3x3 matrix: an array of three arrays of three floats.
  <info>float</info>  <strong>$div   </strong>  The divisor of the result of the convolution, used for normalization.
  <info>float</info>  <strong>$offset</strong>  Color offset.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagefilter()</strong>


id: imagecopy
type: function
doc:
<comment>Description:</comment>
  Copy part of an image
  
  Copy a part of <strong>$src_im</strong> onto <strong>$dst_im</strong> starting at the x,y coordinates <strong>$src_x</strong>, <strong>$src_y </strong> with a width
  of <strong>$src_w</strong> and a height of <strong>$src_h</strong>.  The portion defined will be copied onto the x,y coordinates,
  <strong>$dst_x</strong> and <strong>$dst_y</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dst_im</strong>  Risorsa link dell'immagine di destinazione
  <info>resource</info>  <strong>$src_im</strong>  Risorsa link dell'immagine originale
  <info>int     </info>  <strong>$dst_x </strong>  x-coordinate of destination point.
  <info>int     </info>  <strong>$dst_y </strong>  y-coordinate of destination point.
  <info>int     </info>  <strong>$src_x </strong>  x-coordinate of source point.
  <info>int     </info>  <strong>$src_y </strong>  y-coordinate of source point.
  <info>int     </info>  <strong>$src_w </strong>  Larghezza dell'originale.
  <info>int     </info>  <strong>$src_h </strong>  Altezza dell'originale.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagecopymerge
type: function
doc:
<comment>Description:</comment>
  Copy and merge part of an image
  
  Copy a part of <strong>$src_im</strong> onto <strong>$dst_im</strong> starting at the x,y coordinates <strong>$src_x</strong>, <strong>$src_y </strong> with a width
  of <strong>$src_w</strong> and a height of <strong>$src_h</strong>.  The portion defined will be copied onto the x,y coordinates,
  <strong>$dst_x</strong> and <strong>$dst_y</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dst_im</strong>  Risorsa link dell'immagine di destinazione
  <info>resource</info>  <strong>$src_im</strong>  Risorsa link dell'immagine originale
  <info>int     </info>  <strong>$dst_x </strong>  x-coordinate of destination point.
  <info>int     </info>  <strong>$dst_y </strong>  y-coordinate of destination point.
  <info>int     </info>  <strong>$src_x </strong>  x-coordinate of source point.
  <info>int     </info>  <strong>$src_y </strong>  y-coordinate of source point.
  <info>int     </info>  <strong>$src_w </strong>  Larghezza dell'originale.
  <info>int     </info>  <strong>$src_h </strong>  Altezza dell'originale.
  <info>int     </info>  <strong>$pct   </strong>  The two images will be merged according to <strong>$pct</strong> which can range from 0 to 100.
                     When <strong>$pct</strong> = 0, no action is taken, when 100 this function behaves identically
                     to <strong>imagecopy()</strong> for pallete images, except for ignoring alpha components, while
                     it implements alpha transparency for true colour images.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagecopymergegray
type: function
doc:
<comment>Description:</comment>
  Copy and merge part of an image with gray scale
  
  <strong>imagecopymergegray()</strong> copy a part of <strong>$src_im</strong> onto <strong>$dst_im</strong> starting at the x,y coordinates <strong>$src_x</strong>,
  <strong>$src_y </strong> with a width of <strong>$src_w</strong> and a height of <strong>$src_h</strong>.  The portion defined will be copied onto
  the x,y coordinates, <strong>$dst_x</strong> and <strong>$dst_y</strong>.
  
  This function is identical to <strong>imagecopymerge()</strong> except that when merging it preserves the hue of
  the source by converting the destination pixels to gray scale before the copy operation.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dst_im</strong>  Risorsa link dell'immagine di destinazione
  <info>resource</info>  <strong>$src_im</strong>  Risorsa link dell'immagine originale
  <info>int     </info>  <strong>$dst_x </strong>  x-coordinate of destination point.
  <info>int     </info>  <strong>$dst_y </strong>  y-coordinate of destination point.
  <info>int     </info>  <strong>$src_x </strong>  x-coordinate of source point.
  <info>int     </info>  <strong>$src_y </strong>  y-coordinate of source point.
  <info>int     </info>  <strong>$src_w </strong>  Larghezza dell'originale.
  <info>int     </info>  <strong>$src_h </strong>  Altezza dell'originale.
  <info>int     </info>  <strong>$pct   </strong>  The <strong>$src_im</strong> will be changed to grayscale according  to <strong>$pct</strong> where 0 is fully
                     grayscale and 100 is  unchanged. When <strong>$pct</strong> = 100 this function behaves
                     identically to <strong>imagecopy()</strong> for pallete images, except for ignoring alpha
                     components, while it implements alpha transparency for true colour images.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagecopyresampled
type: function
doc:
<comment>Description:</comment>
  Copy and resize part of an image with resampling
  
  <strong>imagecopyresampled()</strong> copies a rectangular portion of one image to another image, smoothly
  interpolating pixel values so that, in particular, reducing the size of an image still retains a
  great deal of clarity.
  
  In other words, <strong>imagecopyresampled()</strong> will take a  rectangular area from <strong>$src_image</strong> of width
  <strong>$src_w</strong> and height <strong>$src_h</strong> at  position (<strong>$src_x</strong>,<strong>$src_y</strong>)  and place it in a rectangular area of
  <strong>$dst_image</strong>  of width <strong>$dst_w</strong> and height <strong>$dst_h</strong> at position (<strong>$dst_x</strong>,<strong>$dst_y</strong>).
  
  If the source and destination coordinates and width and heights differ, appropriate stretching or
  shrinking of the image fragment will be performed. The coordinates refer to the upper left corner.
  This function can be used to copy regions within the same image (if <strong>$dst_image</strong> is the same as
  <strong>$src_image</strong>) but if the regions overlap the results will be unpredictable.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dst_image</strong>  Risorsa link dell'immagine di destinazione
  <info>resource</info>  <strong>$src_image</strong>  Risorsa link dell'immagine originale
  <info>int     </info>  <strong>$dst_x    </strong>  x-coordinate of destination point.
  <info>int     </info>  <strong>$dst_y    </strong>  y-coordinate of destination point.
  <info>int     </info>  <strong>$src_x    </strong>  x-coordinate of source point.
  <info>int     </info>  <strong>$src_y    </strong>  y-coordinate of source point.
  <info>int     </info>  <strong>$dst_w    </strong>  Destination width.
  <info>int     </info>  <strong>$dst_h    </strong>  Destination height.
  <info>int     </info>  <strong>$src_w    </strong>  Larghezza dell'originale.
  <info>int     </info>  <strong>$src_h    </strong>  Altezza dell'originale.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecopyresized
type: function
doc:
<comment>Description:</comment>
  Copy and resize part of an image
  
  <strong>imagecopyresized()</strong> copies a rectangular portion of one image to another image. <strong>$dst_image</strong> is the
  destination image, <strong>$src_image</strong> is the source image identifier.
  
  In other words, <strong>imagecopyresized()</strong> will take a  rectangular area from <strong>$src_image</strong> of width  <strong>$src_w</strong>
  and height <strong>$src_h</strong> at  position (<strong>$src_x</strong>,<strong>$src_y</strong>)  and place it in a rectangular area of <strong>$dst_image</strong>
  of width <strong>$dst_w</strong> and height <strong>$dst_h</strong> at position (<strong>$dst_x</strong>,<strong>$dst_y</strong>).
  
  If the source and destination coordinates and width and heights differ, appropriate stretching or
  shrinking of the image fragment will be performed. The coordinates refer to the upper left corner.
  This function can be used to copy regions within the same image (if <strong>$dst_image</strong> is the same as
  <strong>$src_image</strong>) but if the regions overlap the results will be unpredictable.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dst_image</strong>  Risorsa link dell'immagine di destinazione
  <info>resource</info>  <strong>$src_image</strong>  Risorsa link dell'immagine originale
  <info>int     </info>  <strong>$dst_x    </strong>  x-coordinate of destination point.
  <info>int     </info>  <strong>$dst_y    </strong>  y-coordinate of destination point.
  <info>int     </info>  <strong>$src_x    </strong>  x-coordinate of source point.
  <info>int     </info>  <strong>$src_y    </strong>  y-coordinate of source point.
  <info>int     </info>  <strong>$dst_w    </strong>  Destination width.
  <info>int     </info>  <strong>$dst_h    </strong>  Destination height.
  <info>int     </info>  <strong>$src_w    </strong>  Larghezza dell'originale.
  <info>int     </info>  <strong>$src_h    </strong>  Altezza dell'originale.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecopyresampled()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecreate
type: function
doc:
<comment>Description:</comment>
  Create a new palette based image
  
  <strong>imagecreate()</strong> returns an image identifier representing a blank image of specified size.
  
  In general, we recommend the use of <strong>imagecreatetruecolor()</strong> instead of <strong>imagecreate()</strong> so that image
  processing occurs on the highest quality image possible. If you want to output a palette image,
  then <strong>imagetruecolortopalette()</strong> should be called immediately before saving the image with
  <strong>imagepng()</strong> or <strong>imagegif()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$width </strong>  The image width.
  <info>int</info>  <strong>$height</strong>  The image height.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefrombmp
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefrombmp()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the BMP image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromgd
type: function
doc:
<comment>Description:</comment>
  Create a new image from GD file or URL
  
  Create a new image from GD file or URL.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the GD file.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromgd2
type: function
doc:
<comment>Description:</comment>
  Create a new image from GD2 file or URL
  
  Create a new image from GD2 file or URL.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the GD2 image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromgd2part
type: function
doc:
<comment>Description:</comment>
  Create a new image from a given part of GD2 file or URL
  
  Create a new image from a given part of GD2 file or URL.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the GD2 image.
  <info>int   </info>  <strong>$srcX    </strong>  x-coordinate of source point.
  <info>int   </info>  <strong>$srcY    </strong>  y-coordinate of source point.
  <info>int   </info>  <strong>$width   </strong>  Larghezza dell'originale.
  <info>int   </info>  <strong>$height  </strong>  Altezza dell'originale.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromgif
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromgif()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  When reading GIF files into memory, only the first frame  is returned in the image resource
  pointer. The size of the image is not necessarily what is reported by <strong>getimagesize()</strong>.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the GIF image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromjpeg
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromjpeg()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the JPEG image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefrompng
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefrompng()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the PNG image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromstring
type: function
doc:
<comment>Description:</comment>
  Create a new image from the image stream in the string
  
  <strong>imagecreatefromstring()</strong> returns an image identifier representing the image obtained from the given
  <strong>$image</strong>. These types will be automatically detected if your build of PHP supports  them: JPEG, PNG,
  GIF, BMP, WBMP, GD2, and WEBP.

<comment>Param:</comment>
  <info>string</info>  <strong>$image</strong>  A string containing the image data.

<comment>Return:</comment>
  <info>resource</info>  An image resource will be returned on success. <info>false</info> is returned if the image type is
            unsupported, the data is not in a recognised format, or the image is corrupt and cannot
            be loaded.

<comment>See Also:</comment>
   * <strong>imagecreatefromjpeg()</strong>
   * <strong>imagecreatefrompng()</strong>
   * <strong>imagecreatefromgif()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefromwbmp
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromwbmp()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  WBMP images are Wireless Bitmaps, not Windows Bitmaps. The latter can be loaded with
  <strong>imagecreatefrombmp()</strong>.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the WBMP image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromwebp
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromwebp()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the WebP image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromxbm
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromxbm()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the XBM image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatefromxpm
type: function
doc:
<comment>Description:</comment>
  Crea una nuova immagine da un file o una URL
  
  <strong>imagecreatefromxpm()</strong> returns an image identifier representing the image obtained from the given
  filename.
  
  È possibile utilizzare una URL come un
  nome di file con questa funzione se fopen wrappers è stata abilitata.
  Vedere <strong>fopen()</strong> per maggiori informazioni su come specificare 
  i nomi di file. Vedere  per i link verso le informazioni
  sulle capacità dei vari wrapper, note sul loro uso,
  informazioni sulle variabili predefinite che
  forniscono.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Path to the XPM image.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.


id: imagecreatetruecolor
type: function
doc:
<comment>Description:</comment>
  Create a new true color image
  
  <strong>imagecreatetruecolor()</strong> returns an image identifier representing a black image of the specified
  size.

<comment>Param:</comment>
  <info>int</info>  <strong>$width </strong>  Image width.
  <info>int</info>  <strong>$height</strong>  Image height.

<comment>Return:</comment>
  <info>resource</info>  Restituisce un identificatore di risorsa immagine, <info>false</info> in caso di errore.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreate()</strong>


id: imagecrop
type: function
doc:
<comment>Description:</comment>
  Crop an image to the given rectangle
  
  Crops an image to the given rectangular area and returns the resulting image. The given <strong>$image</strong> is
  not modified.

<comment>Param:</comment>
  <info>     </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                 come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$rect </strong>  The cropping rectangle as <info>array</info> with keys <return>x</return>, <return>y</return>, <return>width</return> and <return>height</return>.

<comment>Return:</comment>
  <info>resourcefalse</info>  Return cropped image resource on success o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecropauto()</strong>


id: imagecropauto
type: function
doc:
<comment>Description:</comment>
  Crop an image automatically using one of the available modes
  
  Automatically crops an image according to the given <strong>$mode</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                     come <strong>imagecreatetruecolor()</strong>.
  <info>int  </info>  <strong>$mode     </strong>  One of the following constants:
                     
                     Same as <info>IMG_CROP_TRANSPARENT</info>. Before PHP 7.4.0, the bundled libgd fell back to
                     <info>IMG_CROP_SIDES</info>, if the image had no transparent color.
                     
                     Crops out a transparent background.
                     
                     Crops out a black background.
                     
                     Crops out a white background.
                     
                     Uses the 4 corners of the image to attempt to detect the background to crop.
                     
                     Crops an image using the given <strong>$threshold</strong> and <strong>$color</strong>.
  <info>float</info>  <strong>$threshold</strong>  Crops an image using the given <strong>$threshold</strong> and <strong>$color</strong>.
  <info>float</info>  <strong>$threshold</strong>  Specifies the tolerance in percent to be used while comparing the image color
                     and the color to crop. The method used to calculate the color difference is
                     based on the color distance in the RGB(a) cube.
                     
                     Used only in <info>IMG_CROP_THRESHOLD</info> mode.
                     
                     Before PHP 7.4.0, the bundled libgd used a somewhat different algorithm, so the
                     same <strong>$threshold</strong> yielded different results for system and bundled libgd.
  <info>int  </info>  <strong>$color    </strong>  Either an RGB color value or a palette index.
                     
                     Used only in <info>IMG_CROP_THRESHOLD</info> mode.

<comment>Return:</comment>
  <info>resourcefalse</info>  Returns a cropped image resource on success o <info>false</info> in caso di fallimento. If the
                 complete image was cropped, <strong>imagecrop()</strong> returns <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagedashedline
type: function
doc:
<comment>Description:</comment>
  Draw a dashed line
  
  This function is deprecated. Use combination of <strong>imagesetstyle()</strong> and <strong>imageline()</strong> instead.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x1   </strong>  Upper left x coordinate.
  <info>int</info>  <strong>$y1   </strong>  Upper left y coordinate 0, 0 is the top left corner of the image.
  <info>int</info>  <strong>$x2   </strong>  Bottom right x coordinate.
  <info>int</info>  <strong>$y2   </strong>  Bottom right y coordinate.
  <info>int</info>  <strong>$color</strong>  The fill color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagesetstyle()</strong>
   * <strong>imageline()</strong>


id: imagedestroy
type: function
doc:
<comment>Description:</comment>
  Destroy an image
  
  <strong>imagedestroy()</strong> frees any memory associated with image <strong>$image</strong>.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imageellipse
type: function
doc:
<comment>Description:</comment>
  Draw an ellipse
  
  Draws an ellipse centered at the specified coordinates.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$cx    </strong>  x-coordinate of the center.
  <info>int</info>  <strong>$cy    </strong>  y-coordinate of the center.
  <info>int</info>  <strong>$width </strong>  The ellipse width.
  <info>int</info>  <strong>$height</strong>  The ellipse height.
  <info>int</info>  <strong>$color </strong>  The color of the ellipse. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagefilledellipse()</strong>
   * <strong>imagearc()</strong>


id: imagefill
type: function
doc:
<comment>Description:</comment>
  Flood fill
  
  Performs a flood fill starting at the given coordinate (top left is 0, 0) with the given <strong>$color</strong> in
  the <strong>$image</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x    </strong>  x-coordinate of start point.
  <info>int</info>  <strong>$y    </strong>  y-coordinate of start point.
  <info>int</info>  <strong>$color</strong>  The fill color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>


id: imagefilledarc
type: function
doc:
<comment>Description:</comment>
  Draw a partial arc and fill it
  
  Draws a partial arc centered at the specified coordinate in the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$cx    </strong>  x-coordinate of the center.
  <info>int</info>  <strong>$cy    </strong>  y-coordinate of the center.
  <info>int</info>  <strong>$width </strong>  The arc width.
  <info>int</info>  <strong>$height</strong>  The arc height.
  <info>int</info>  <strong>$start </strong>  The arc start angle, in degrees.
  <info>int</info>  <strong>$end   </strong>  The arc end angle, in degrees. 0° is located at the three-o'clock position, and the
                arc is drawn clockwise.
  <info>int</info>  <strong>$color </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.
  <info>int</info>  <strong>$style </strong>  A bitwise OR of the following possibilities:
                <info>IMG_ARC_PIE</info><info>IMG_ARC_CHORD</info><info>IMG_ARC_NOFILL</info><info>IMG_ARC_EDGED</info> <info>IMG_ARC_PIE</info> and <info>IMG_ARC_CHORD</info>
                are mutually exclusive; <info>IMG_ARC_CHORD</info> just connects the starting and ending angles
                with a straight line, while <info>IMG_ARC_PIE</info> produces a rounded edge. <info>IMG_ARC_NOFILL</info>
                indicates that the arc or chord should be outlined, not filled.  <info>IMG_ARC_EDGED</info>, used
                together with <info>IMG_ARC_NOFILL</info>, indicates that the beginning and ending angles should
                be connected to the center - this is a good way to outline (rather than fill) a 'pie
                slice'.
                
                <info>IMG_ARC_PIE</info>
                
                <info>IMG_ARC_CHORD</info>
                
                <info>IMG_ARC_NOFILL</info>
                
                <info>IMG_ARC_EDGED</info>

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagefilledellipse
type: function
doc:
<comment>Description:</comment>
  Draw a filled ellipse
  
  Draws an ellipse centered at the specified coordinate on the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$cx    </strong>  x-coordinate of the center.
  <info>int</info>  <strong>$cy    </strong>  y-coordinate of the center.
  <info>int</info>  <strong>$width </strong>  The ellipse width.
  <info>int</info>  <strong>$height</strong>  The ellipse height.
  <info>int</info>  <strong>$color </strong>  The fill color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imageellipse()</strong>
   * <strong>imagefilledarc()</strong>


id: imagefilledpolygon
type: function
doc:
<comment>Description:</comment>
  Draw a filled polygon
  
  Alternative signature (as of PHP 8.0.0)
  
  <strong>imagefilledpolygon()</strong> creates a filled polygon in the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$points    </strong>  An array containing the <return>x</return> and <return>y</return> coordinates of the polygons vertices
                      consecutively.
  <info>int  </info>  <strong>$num_points</strong>  Total number of points (vertices), which must be at least 3.
                      
                      If this parameter is omitted as per the second signature, <strong>$points</strong> must have an
                      even number of elements, and <strong>$num_points</strong> is assumed to be count($points)/2.
  <info>int  </info>  <strong>$color     </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagefilledrectangle
type: function
doc:
<comment>Description:</comment>
  Draw a filled rectangle
  
  Creates a rectangle filled with <strong>$color</strong> in the given <strong>$image</strong> starting at point 1 and ending at point
  2. 0, 0 is the top left corner of the image.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x1   </strong>  x-coordinate for point 1.
  <info>int</info>  <strong>$y1   </strong>  y-coordinate for point 1.
  <info>int</info>  <strong>$x2   </strong>  x-coordinate for point 2.
  <info>int</info>  <strong>$y2   </strong>  y-coordinate for point 2.
  <info>int</info>  <strong>$color</strong>  The fill color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagefilltoborder
type: function
doc:
<comment>Description:</comment>
  Flood fill to specific color
  
  <strong>imagefilltoborder()</strong> performs a flood fill whose border color is defined by <strong>$border</strong>. The starting
  point for the fill is <strong>$x</strong>, <strong>$y</strong> (top left is 0, 0) and the region is filled with color <strong>$color</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x     </strong>  x-coordinate of start.
  <info>int</info>  <strong>$y     </strong>  y-coordinate of start.
  <info>int</info>  <strong>$border</strong>  The border color. A color identifier created with <strong>imagecolorallocate()</strong>.
  <info>int</info>  <strong>$color </strong>  The fill color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagefilter
type: function
doc:
<comment>Description:</comment>
  Applies a filter to an image
  
  <strong>imagefilter()</strong> applies the given filter <strong>$filtertype</strong> on the <strong>$image</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                    come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$filtertype</strong>  <strong>$filtertype</strong> can be one of the following: <info>IMG_FILTER_NEGATE</info>: Reverses all colors
                    of the image. <info>IMG_FILTER_GRAYSCALE</info>: Converts the image into grayscale by
                    changing the red, green and blue components to their weighted sum using the same
                    coefficients as the REC.601 luma (Y') calculation. The alpha components are
                    retained. For palette images the result may differ due to palette limitations.
                    <info>IMG_FILTER_BRIGHTNESS</info>: Changes the brightness of the image. Use <strong>$arg1</strong> to set the
                    level of brightness. The range for the brightness is -255 to 255.
                    <info>IMG_FILTER_CONTRAST</info>: Changes the contrast of the image. Use <strong>$arg1</strong> to set the
                    level of contrast. <info>IMG_FILTER_COLORIZE</info>: Like <info>IMG_FILTER_GRAYSCALE</info>, except you
                    can specify the color. Use <strong>$arg1</strong>, <strong>$arg2</strong> and <strong>$arg3</strong> in the form of <strong>$red</strong>, <strong>$green</strong>,
                    <strong>$blue</strong> and <strong>$arg4</strong> for the <strong>$alpha</strong> channel. The range for each color is 0 to 255.
                    <info>IMG_FILTER_EDGEDETECT</info>: Uses edge detection to highlight the edges in the image.
                    <info>IMG_FILTER_EMBOSS</info>: Embosses the image. <info>IMG_FILTER_GAUSSIAN_BLUR</info>: Blurs the image
                    using the Gaussian method. <info>IMG_FILTER_SELECTIVE_BLUR</info>: Blurs the image.
                    <info>IMG_FILTER_MEAN_REMOVAL</info>: Uses mean removal to achieve a "sketchy" effect.
                    <info>IMG_FILTER_SMOOTH</info>: Makes the image smoother. Use <strong>$arg1</strong> to set the level of
                    smoothness. <info>IMG_FILTER_PIXELATE</info>: Applies pixelation effect  to the image, use
                    <strong>$arg1</strong> to set the block size  and <strong>$arg2</strong> to set the pixelation effect mode.
                    <info>IMG_FILTER_SCATTER</info>: Applies scatter effect  to the image, use <strong>$arg1</strong> and  <strong>$arg2</strong>
                    to define the effect strength and  additionally <strong>$arg3</strong> to only apply the  on
                    select pixel colors.
                    
                    <info>IMG_FILTER_NEGATE</info>: Reverses all colors of the image.
                    
                    <info>IMG_FILTER_GRAYSCALE</info>: Converts the image into grayscale by changing the red,
                    green and blue components to their weighted sum using the same coefficients as
                    the REC.601 luma (Y') calculation. The alpha components are retained. For
                    palette images the result may differ due to palette limitations.
                    
                    <info>IMG_FILTER_BRIGHTNESS</info>: Changes the brightness of the image. Use <strong>$arg1</strong> to set the
                    level of brightness. The range for the brightness is -255 to 255.
                    
                    <info>IMG_FILTER_CONTRAST</info>: Changes the contrast of the image. Use <strong>$arg1</strong> to set the
                    level of contrast.
                    
                    <info>IMG_FILTER_COLORIZE</info>: Like <info>IMG_FILTER_GRAYSCALE</info>, except you can specify the
                    color. Use <strong>$arg1</strong>, <strong>$arg2</strong> and <strong>$arg3</strong> in the form of <strong>$red</strong>, <strong>$green</strong>, <strong>$blue</strong> and <strong>$arg4</strong>
                    for the <strong>$alpha</strong> channel. The range for each color is 0 to 255.
                    
                    <info>IMG_FILTER_EDGEDETECT</info>: Uses edge detection to highlight the edges in the image.
                    
                    <info>IMG_FILTER_EMBOSS</info>: Embosses the image.
                    
                    <info>IMG_FILTER_GAUSSIAN_BLUR</info>: Blurs the image using the Gaussian method.
                    
                    <info>IMG_FILTER_SELECTIVE_BLUR</info>: Blurs the image.
                    
                    <info>IMG_FILTER_MEAN_REMOVAL</info>: Uses mean removal to achieve a "sketchy" effect.
                    
                    <info>IMG_FILTER_SMOOTH</info>: Makes the image smoother. Use <strong>$arg1</strong> to set the level of
                    smoothness.
                    
                    <info>IMG_FILTER_PIXELATE</info>: Applies pixelation effect  to the image, use <strong>$arg1</strong> to set
                    the block size  and <strong>$arg2</strong> to set the pixelation effect mode.
                    
                    <info>IMG_FILTER_SCATTER</info>: Applies scatter effect  to the image, use <strong>$arg1</strong> and  <strong>$arg2</strong>
                    to define the effect strength and  additionally <strong>$arg3</strong> to only apply the  on
                    select pixel colors.
  <info>int</info>  <strong>$arg1      </strong>  <info>IMG_FILTER_BRIGHTNESS</info>: Brightness level. <info>IMG_FILTER_CONTRAST</info>: Contrast level.
                    <info>IMG_FILTER_COLORIZE</info>: Valore della componente rossa. <info>IMG_FILTER_SMOOTH</info>:
                    Smoothness level. <info>IMG_FILTER_PIXELATE</info>: Block size in pixels. <info>IMG_FILTER_SCATTER</info>:
                    Effect substraction level.  This must not be higher or equal to the addition
                    level set with  <strong>$arg2</strong>.
                    
                    <info>IMG_FILTER_BRIGHTNESS</info>: Brightness level.
                    
                    <info>IMG_FILTER_CONTRAST</info>: Contrast level.
                    
                    <info>IMG_FILTER_COLORIZE</info>: Valore della componente rossa.
                    
                    <info>IMG_FILTER_SMOOTH</info>: Smoothness level.
                    
                    <info>IMG_FILTER_PIXELATE</info>: Block size in pixels.
                    
                    <info>IMG_FILTER_SCATTER</info>: Effect substraction level.  This must not be higher or equal
                    to the addition level set with  <strong>$arg2</strong>.
  <info>int</info>  <strong>$arg2      </strong>  <info>IMG_FILTER_COLORIZE</info>: Valore della componente verde. <info>IMG_FILTER_PIXELATE</info>: Whether
                    to use advanced pixelation  effect or not (defaults to <info>false</info>).
                    <info>IMG_FILTER_SCATTER</info>: Effect addition level.
                    
                    <info>IMG_FILTER_COLORIZE</info>: Valore della componente verde.
                    
                    <info>IMG_FILTER_PIXELATE</info>: Whether to use advanced pixelation  effect or not (defaults
                    to <info>false</info>).
                    
                    <info>IMG_FILTER_SCATTER</info>: Effect addition level.
  <info>int</info>  <strong>$arg3      </strong>  <info>IMG_FILTER_COLORIZE</info>: Valore della componente blu. <info>IMG_FILTER_SCATTER</info>: Optional
                    array indexed color values  to apply effect at.
                    
                    <info>IMG_FILTER_COLORIZE</info>: Valore della componente blu.
                    
                    <info>IMG_FILTER_SCATTER</info>: Optional array indexed color values  to apply effect at.
  <info>int</info>  <strong>$arg4      </strong>  <info>IMG_FILTER_COLORIZE</info>: Alpha channel, A value  between 0 and 127. 0 indicates
                    completely opaque while 127 indicates  completely transparent.
                    
                    <info>IMG_FILTER_COLORIZE</info>: Alpha channel, A value  between 0 and 127. 0 indicates
                    completely opaque while 127 indicates  completely transparent.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imageconvolution()</strong>


id: imageflip
type: function
doc:
<comment>Description:</comment>
  Flips an image using a given mode
  
  Flips the <strong>$image</strong> image using the given <strong>$mode</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$mode </strong>  Flip mode, this can be one of the <info>IMG_FLIP_*</info> constants:
               
               ConstantMeaning<info>IMG_FLIP_HORIZONTAL</info> Flips the image horizontally. <info>IMG_FLIP_VERTICAL</info>
               Flips the image vertically. <info>IMG_FLIP_BOTH</info> Flips the image both horizontally and
               vertically.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagefontheight
type: function
doc:
<comment>Description:</comment>
  Get font height
  
  Returns the pixel height of a character in the specified font.

<comment>Param:</comment>
  <info></info>  <strong>$font</strong>  Può essere 1, 2, 3, 4, 5 per i font
           interni con codifica latin2 (dove numeri più alti corrispondono a font più grandi) o
           qualsiasi
           identificatore di font registrato con <strong>imageloadfont()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the pixel height of the font.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imageloadfont()</strong>


id: imagefontwidth
type: function
doc:
<comment>Description:</comment>
  Get font width
  
  Returns the pixel width of a character in font.

<comment>Param:</comment>
  <info></info>  <strong>$font</strong>  Può essere 1, 2, 3, 4, 5 per i font
           interni con codifica latin2 (dove numeri più alti corrispondono a font più grandi) o
           qualsiasi
           identificatore di font registrato con <strong>imageloadfont()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the pixel width of the font.

<comment>See Also:</comment>
   * <strong>imagefontheight()</strong>
   * <strong>imageloadfont()</strong>


id: imageftbbox
type: function
doc:
<comment>Description:</comment>
  Give the bounding box of a text using fonts via freetype2
  
  This function calculates and returns the bounding box in pixels for a FreeType text.
  
  <strong>imageftbbox()</strong> is an extended variant of <strong>imagettfbbox()</strong> which additionally supports the <strong>$extrainfo</strong>.

<comment>Param:</comment>
  <info>float </info>  <strong>$size     </strong>  La dimensione del carattere. A seconda della versione di GD, deve essere
                      specificata in pixel (GD1) o in punti (GD2).
  <info>float </info>  <strong>$angle    </strong>  Angle in degrees in which <strong>$text</strong> will be  measured.
  <info>string</info>  <strong>$fontfile </strong>  The name of the TrueType font file (can be a URL). Depending on which version
                      of the GD library that PHP is using, it may attempt to search for files that
                      do not begin with a leading '/' by appending '.ttf' to the filename and
                      searching along a library-defined font path.
  <info>string</info>  <strong>$text     </strong>  The string to be measured.
  <info>array </info>  <strong>$extrainfo</strong>  Possible array indexes for <strong>$extrainfo</strong>KeyTypeMeaning<return>linespacing</return><info>float</info>Defines
                      drawing linespacing

<comment>Return:</comment>
  <info>array</info>  <strong>imageftbbox()</strong> returns an array with 8 elements representing four points making the bounding
         box of the text: 0lower left corner, X position1lower left corner, Y position2lower right
         corner, X position3lower right corner, Y position4upper right corner, X position5upper
         right corner, Y position6upper left corner, X position7upper left corner, Y position
         
         The points are relative to the text regardless of the <strong>$angle</strong>, so "upper left" means in the
         top left-hand  corner seeing the text horizontally.

<comment>See Also:</comment>
   * <strong>imagefttext()</strong>
   * <strong>imagettfbbox()</strong>


id: imagefttext
type: function
doc:
<comment>Description:</comment>
  Write text to the image using fonts using FreeType 2
  
  <strong>imagefttext()</strong> is an extended variant of <strong>imagettftext()</strong> which additionally supports the <strong>$extrainfo</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>float </info>  <strong>$size     </strong>  The font size to use in points.
  <info>float </info>  <strong>$angle    </strong>  The angle in degrees, with 0 degrees being left-to-right reading text. Higher
                      values represent a counter-clockwise rotation. For example, a  value of 90
                      would result in bottom-to-top reading text.
  <info>int   </info>  <strong>$x        </strong>  The coordinates given by <strong>$x</strong> and <strong>$y</strong> will define the basepoint of the first
                      character (roughly the lower-left corner of the character). This is different
                      from the <strong>imagestring()</strong>, where <strong>$x</strong> and <strong>$y</strong> define the upper-left corner of the
                      first character. For example, "top left" is 0, 0.
  <info>int   </info>  <strong>$y        </strong>  The y-ordinate. This sets the position of the fonts baseline, not the very
                      bottom of the character.
  <info>int   </info>  <strong>$color    </strong>  The index of the desired color for the text, see  <strong>imagecolorexact()</strong>.
  <info>string</info>  <strong>$fontfile </strong>  The path to the TrueType font you wish to use.
                      
                      Depending on which version of the GD library PHP is using, when <strong>$fontfile</strong> does
                      not begin with a leading <return>/</return> then <return>.ttf</return> will be appended to the filename and the
                      library will attempt to search for that filename along a library-defined font
                      path.
                      
                      When using versions of the GD library lower than 2.0.18, a <return>space</return> character,
                      rather than a semicolon, was used as the 'path separator' for different font
                      files. Unintentional use of this feature will result in the warning message:
                      <return>Warning: Could not find/open font</return>. For these affected versions, the only
                      solution is moving the font to a path which does not contain spaces.
                      
                      In many cases where a font resides in the same directory as the script using
                      it the following trick will alleviate any include problems.
                      ]]>
  <info>string</info>  <strong>$text     </strong>  Text to be inserted into image.
  <info>array </info>  <strong>$extrainfo</strong>  Possible array indexes for <strong>$extrainfo</strong>KeyTypeMeaning<return>linespacing</return><info>float</info>Defines
                      drawing linespacing

<comment>Return:</comment>
  <info>array</info>  This function returns an array defining the four points of the box, starting in the lower
         left and moving counter-clockwise: 0lower left x-coordinate1lower left y-coordinate2lower
         right x-coordinate3lower right y-coordinate4upper right x-coordinate5upper right
         y-coordinate6upper left x-coordinate7upper left y-coordinate

<comment>See Also:</comment>
   * <strong>imageftbbox()</strong>
   * <strong>imagettftext()</strong>


id: imagegammacorrect
type: function
doc:
<comment>Description:</comment>
  Apply a gamma correction to a GD image
  
  Applies gamma correction to the given gd <strong>$image</strong>  given an input and an output gamma.

<comment>Param:</comment>
  <info>     </info>  <strong>$image      </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                       come <strong>imagecreatetruecolor()</strong>.
  <info>float</info>  <strong>$inputgamma </strong>  The input gamma.
  <info>float</info>  <strong>$outputgamma</strong>  The output gamma.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagegd
type: function
doc:
<comment>Description:</comment>
  Output GD image to browser or file
  
  Outputs a GD image to the given <strong>$to</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                 come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to   </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene restituito
                 il flusso raw dell'immagine.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd2()</strong>


id: imagegd2
type: function
doc:
<comment>Description:</comment>
  Output GD2 image to browser or file
  
  Outputs a GD2 image to the given <strong>$to</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to        </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene
                      restituito il flusso raw dell'immagine.
  <info>int  </info>  <strong>$chunk_size</strong>  Chunk size.
  <info>int  </info>  <strong>$type      </strong>  Either <info>IMG_GD2_RAW</info> or  <info>IMG_GD2_COMPRESSED</info>. Default is  <info>IMG_GD2_RAW</info>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd()</strong>


id: imagegetclip
type: function
doc:
<comment>Description:</comment>
  Get the clipping rectangle
  
  <strong>imagegetclip()</strong> retrieves the current clipping rectangle, i.e. the area beyond which no pixels will
  be drawn.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>array</info>  The function returns an indexed array with the coordinates of the clipping rectangle which
         has the following entries: x-coordinate of the upper left cornery-coordinate of the upper
         left cornerx-coordinate of the lower right cornery-coordinate of the lower right corner
         
         x-coordinate of the upper left corner
         
         y-coordinate of the upper left corner
         
         x-coordinate of the lower right corner
         
         y-coordinate of the lower right corner

<comment>See Also:</comment>
   * <strong>imagesetclip()</strong>


id: imagegetinterpolation
type: function
doc:
<comment>Description:</comment>
  Get the interpolation method
  
  Gets the currently set interpolation method of the <strong>$image</strong>.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the interpolation method.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagegif
type: function
doc:
<comment>Description:</comment>
  Invia l'immagine al browser o in un file
  
  <strong>imagegif()</strong> creates the GIF file in <strong>$to</strong> from the image <strong>$image</strong>. The <strong>$image</strong> argument is the return
  from the <strong>imagecreate()</strong> or <return>imagecreatefrom*</return> function.
  
  The image format will be GIF87a unless the image has been made transparent with
  <strong>imagecolortransparent()</strong>, in which case the image format will be GIF89a.

<comment>Param:</comment>
  <info>     </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                 come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to   </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene restituito
                 il flusso raw dell'immagine.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagegrabscreen
type: function
doc:
<comment>Description:</comment>
  Captures the whole screen
  
  Grabs a screenshot of the whole screen.
  
  This function is only available on Windows.

<comment>Return:</comment>
  <info>resource</info>  Returns an image resource identifier on success, <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>imagegrabwindow()</strong>


id: imagegrabwindow
type: function
doc:
<comment>Description:</comment>
  Captures a window
  
  Grabs a window or its client area using a windows handle (HWND property in COM instance)
  
  This function is only available on Windows.

<comment>Param:</comment>
  <info>int</info>  <strong>$window_handle</strong>  The HWND window ID.
  <info>int</info>  <strong>$client_area  </strong>  Include the client area of the application window.

<comment>Return:</comment>
  <info>resource</info>  Returns an image resource identifier on success, <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>imagegrabscreen()</strong>


id: imageinterlace
type: function
doc:
<comment>Description:</comment>
  Enable or disable interlace
  
  <strong>imageinterlace()</strong> turns the interlace bit on or off.
  
  If the interlace bit is set and the image is used as a JPEG image, the image is created as a
  progressive JPEG.

<comment>Param:</comment>
  <info>   </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$interlace</strong>  If non-zero, the image will be interlaced, else the interlace bit is turned off.

<comment>Return:</comment>
  <info>int</info>  Returns 1 if the interlace bit is set for the image, 0 otherwise.


id: imageistruecolor
type: function
doc:
<comment>Description:</comment>
  Finds whether an image is a truecolor image
  
  <strong>imageistruecolor()</strong> finds whether the image <strong>$image</strong> is a truecolor image.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the <strong>$image</strong> is truecolor, <info>false</info> otherwise.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagepalettetotruecolor()</strong>


id: imagejpeg
type: function
doc:
<comment>Description:</comment>
  Invia l'immagine al browser o in un file
  
  <strong>imagejpeg()</strong> creates a JPEG file from the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image  </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to     </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene restituito
                   il flusso raw dell'immagine.
  <info>int  </info>  <strong>$quality</strong>  <strong>$quality</strong> is optional, and ranges from 0 (worst quality, smaller file) to 100
                   (best quality, biggest file). The  default (<return>-1</return>) uses the default IJG quality
                   value (about 75).

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imageinterlace()</strong>
   * <strong>imagetypes()</strong>


id: imagelayereffect
type: function
doc:
<comment>Description:</comment>
  Set the alpha blending flag to use layering effects
  
  Set the alpha blending flag to use layering effects.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$effect</strong>  One of the following constants: <info>IMG_EFFECT_REPLACE</info> Use pixel replacement (equivalent
                of passing <info>true</info> to <strong>imagealphablending()</strong>) <info>IMG_EFFECT_ALPHABLEND</info> Use normal pixel
                blending (equivalent of passing <info>false</info> to <strong>imagealphablending()</strong>) <info>IMG_EFFECT_NORMAL</info>
                Same as <info>IMG_EFFECT_ALPHABLEND</info>. <info>IMG_EFFECT_OVERLAY</info> Overlay has the effect that black
                background pixels will remain black, white background pixels will remain white, but
                grey background pixels will take the colour of the foreground pixel.
                <info>IMG_EFFECT_MULTIPLY</info> Overlays with a multiply effect.
                
                Use pixel replacement (equivalent of passing <info>true</info> to <strong>imagealphablending()</strong>)
                
                Use normal pixel blending (equivalent of passing <info>false</info> to <strong>imagealphablending()</strong>)
                
                Same as <info>IMG_EFFECT_ALPHABLEND</info>.
                
                Overlay has the effect that black background pixels will remain black, white
                background pixels will remain white, but grey background pixels will take the colour
                of the foreground pixel.
                
                Overlays with a multiply effect.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imageline
type: function
doc:
<comment>Description:</comment>
  Draw a line
  
  Draws a line between the two given points.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x1   </strong>  x-coordinate for first point.
  <info>int</info>  <strong>$y1   </strong>  y-coordinate for first point.
  <info>int</info>  <strong>$x2   </strong>  x-coordinate for second point.
  <info>int</info>  <strong>$y2   </strong>  y-coordinate for second point.
  <info>int</info>  <strong>$color</strong>  The line color. A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagecolorallocate()</strong>


id: imageloadfont
type: function
doc:
<comment>Description:</comment>
  Load a new font
  
  <strong>imageloadfont()</strong> loads a user-defined bitmap and returns its identifier.

<comment>Param:</comment>
  <info>string</info>  <strong>$file</strong>  The font file format is currently binary and architecture dependent.  This means
                 you should generate the font files on the same type of CPU as the machine you are
                 running PHP on.
                 
                 Font file formatbyte positionC data typedescriptionbyte 0-3intnumber of characters
                 in the fontbyte 4-7int value of first character in the font (often 32 for space)
                 byte 8-11intpixel width of each characterbyte 12-15intpixel height of each
                 characterbyte 16-char array with character data, one byte per pixel in each
                 character, for a total of (nchars*width*height) bytes.

<comment>Return:</comment>
  <info>int</info>  The font identifier which is always bigger than 5 to avoid conflicts with built-in fonts or
       <info>false</info> on errors.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imagefontheight()</strong>


id: imageopenpolygon
type: function
doc:
<comment>Description:</comment>
  Draws an open polygon
  
  Alternative signature (as of PHP 8.0.0)
  
  <strong>imageopenpolygon()</strong> draws an open polygon on the given <strong>$image</strong>. Contrary to <strong>imagepolygon()</strong>, no line
  is drawn between the last and the first point.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$points    </strong>  An array containing the polygon's vertices, e.g.: points[0]= x0points[1]=
                      y0points[2]= x1points[3]= y1
  <info>int  </info>  <strong>$num_points</strong>  Total number of points (vertices), which must be at least 3.
                      
                      If this parameter is omitted as per the second signature, <strong>$points</strong> must have an
                      even number of elements, and <strong>$num_points</strong> is assumed to be count($points)/2.
  <info>int  </info>  <strong>$color     </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagepalettecopy
type: function
doc:
<comment>Description:</comment>
  Copy the palette from one image to another
  
  <strong>imagepalettecopy()</strong> copies the palette from the <strong>$source</strong> image to the  <strong>$destination</strong> image.

<comment>Param:</comment>
  <info>resource</info>  <strong>$destination</strong>  The destination image resource.
  <info>resource</info>  <strong>$source     </strong>  The source image resource.

<comment>Return:</comment>
  <info>void</info>  Nessun valore viene restituito.


id: imagepalettetotruecolor
type: function
doc:
<comment>Description:</comment>
  Converts a palette based image to true color
  
  Converts a palette based image, created by functions like  <strong>imagecreate()</strong> to a true color image,
  like  <strong>imagecreatetruecolor()</strong>.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the convertion was complete, or if the source image already  is a true color
        image, otherwise <info>false</info> is returned.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imageistruecolor()</strong>


id: imagepng
type: function
doc:
<comment>Description:</comment>
  Output a PNG image to either the browser or a file
  
  Outputs or saves a PNG image from the given  <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image  </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to     </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene restituito
                   il flusso raw dell'immagine.
                   
                   <info>null</info> is invalid if the <strong>$quality</strong> and <strong>$filters</strong> arguments are not used.
  <info>int  </info>  <strong>$quality</strong>  Compression level: from 0 (no compression) to 9. The default (<return>-1</return>) uses the zlib
                   compression default. For more information see the zlib manual.
  <info>int  </info>  <strong>$filters</strong>  Allows reducing the PNG file size. It is a bitmask field which may be set to any
                   combination of the <return>PNG_FILTER_XXX</return>  constants. <info>PNG_NO_FILTER</info> or  <info>PNG_ALL_FILTERS</info>
                   may also be used to respectively disable or activate all filters. The default
                   value (<return>-1</return>) disables filtering.
                   
                   The <strong>$filters</strong> parameter is ignored by system libgd.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>
   * <strong>imagesavealpha()</strong>


id: imagepolygon
type: function
doc:
<comment>Description:</comment>
  Draws a polygon
  
  Alternative signature (as of PHP 8.0.0)
  
  <strong>imagepolygon()</strong> creates a polygon in the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$points    </strong>  An array containing the polygon's vertices, e.g.: points[0]= x0points[1]=
                      y0points[2]= x1points[3]= y1
  <info>int  </info>  <strong>$num_points</strong>  Total number of points (vertices), which must be at least 3.
                      
                      If this parameter is omitted as per the second signature, <strong>$points</strong> must have an
                      even number of elements, and <strong>$num_points</strong> is assumed to be count($points)/2.
  <info>int  </info>  <strong>$color     </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagefilledpolygon()</strong>
   * <strong>imageopenpolygon()</strong>
   * <strong>imagecreate()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagerectangle
type: function
doc:
<comment>Description:</comment>
  Draw a rectangle
  
  <strong>imagerectangle()</strong> creates a rectangle starting at the specified coordinates.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x1   </strong>  Upper left x coordinate.
  <info>int</info>  <strong>$y1   </strong>  Upper left y coordinate 0, 0 is the top left corner of the image.
  <info>int</info>  <strong>$x2   </strong>  Bottom right x coordinate.
  <info>int</info>  <strong>$y2   </strong>  Bottom right y coordinate.
  <info>int</info>  <strong>$color</strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imageresolution
type: function
doc:
<comment>Description:</comment>
  Get or set the resolution of the image
  
  <strong>imageresolution()</strong> allows to set and get the resolution of an image in DPI (dots per inch). If none
  of the optional parameters is given, the current resolution is returned as indexed array. If only
  <strong>$res_x</strong> is given, the horizontal and vertical resolution are set to this value. If both optional
  parameters are given, the horizontal and vertical resolution are set to these values,
  respectively.
  
  The resolution is only used as meta information when images are read from and written to formats
  supporting this kind of information (curently PNG and JPEG). It does not affect any drawing
  operations. The default resolution for new images is 96 DPI.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$res_x</strong>  The horizontal resolution in DPI.
  <info>int</info>  <strong>$res_y</strong>  The vertical resolution in DPI.

<comment>Return:</comment>
  <info>mixed</info>  When used as getter (first signature), it returns an indexed array of the horizontal and
         vertical resolution on success,  o <info>false</info> in caso di fallimento. When used as setter (second
         signature), it returns <info>true</info> on success,  o <info>false</info> in caso di fallimento.


id: imagerotate
type: function
doc:
<comment>Description:</comment>
  Rotate an image with a given angle
  
  Rotates the <strong>$image</strong> image using the given <strong>$angle</strong> in degrees.
  
  The center of rotation is the center of the image, and the rotated image may have different
  dimensions than the original image.

<comment>Param:</comment>
  <info>     </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                     come <strong>imagecreatetruecolor()</strong>.
  <info>float</info>  <strong>$angle    </strong>  Rotation angle, in degrees. The rotation angle is interpreted as the number of
                     degrees to rotate the image anticlockwise.
  <info>int  </info>  <strong>$bgd_color</strong>  Specifies the color of the uncovered zone after the rotation
  <info>int  </info>  <strong>$dummy    </strong>  This parameter is unused.

<comment>Return:</comment>
  <info>resourcefalse</info>  Returns an image resource for the rotated image,  o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagesavealpha
type: function
doc:
<comment>Description:</comment>
  Whether to retain full alpha channel information when saving PNG images
  
  <strong>imagesavealpha()</strong> sets the flag which determines whether to retain full alpha channel information
  (as opposed to single-color transparency) when saving PNG images.
  
  Alphablending has to be disabled (imagealphablending($im, false)) to retain the alpha-channel in
  the first place.

<comment>Param:</comment>
  <info>    </info>  <strong>$image   </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>  <strong>$saveflag</strong>  Whether to save the alpha channel or not. Defaults to <info>false</info>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagealphablending()</strong>


id: imagescale
type: function
doc:
<comment>Description:</comment>
  Scale an image using the given new width and height
  
  <strong>imagescale()</strong> scales an image using the given interpolation algorithm.
  
  Unlike many of other image functions, <strong>imagescale()</strong> does not modify the passed <strong>$image</strong>; instead, a
  new image is returned.

<comment>Param:</comment>
  <info>   </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                    come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$new_width </strong>  The width to scale the image to.
  <info>int</info>  <strong>$new_height</strong>  The height to scale the image to. If omitted or negative, the aspect ratio will
                    be preserved.
  <info>int</info>  <strong>$mode      </strong>  One of <info>IMG_NEAREST_NEIGHBOUR</info>, <info>IMG_BILINEAR_FIXED</info>, <info>IMG_BICUBIC</info>, <info>IMG_BICUBIC_FIXED</info>
                    or anything else (will use two pass). <info>IMG_WEIGHTED4</info> is not yet supported.
                    
                    <info>IMG_WEIGHTED4</info> is not yet supported.

<comment>Return:</comment>
  <info>resourcefalse</info>  Return the scaled image resource on success o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagecopyresampled()</strong>


id: imagesetbrush
type: function
doc:
<comment>Description:</comment>
  Set the brush image for line drawing
  
  <strong>imagesetbrush()</strong> sets the brush image to be used by all line drawing functions (such as <strong>imageline()</strong>
  and <strong>imagepolygon()</strong>) when drawing with the special colors <info>IMG_COLOR_BRUSHED</info> or
  <info>IMG_COLOR_STYLEDBRUSHED</info>.
  
  You need not take special action when you are finished with a brush, but if you destroy the brush
  image (or let PHP destroy it), you must not use the  <info>IMG_COLOR_BRUSHED</info> or <info>IMG_COLOR_STYLEDBRUSHED</info>
  colors until you have set a new brush image!

<comment>Param:</comment>
  <info>        </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                    come <strong>imagecreatetruecolor()</strong>.
  <info>resource</info>  <strong>$brush</strong>  An image resource.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagesetclip
type: function
doc:
<comment>Description:</comment>
  Set the clipping rectangle
  
  <strong>imagesetclip()</strong> sets the current clipping rectangle, i.e. the area beyond which no pixels will be
  drawn.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x1   </strong>  The x-coordinate of the upper left corner.
  <info>int</info>  <strong>$y1   </strong>  The y-coordinate of the upper left corner.
  <info>int</info>  <strong>$x2   </strong>  The x-coordinate of the lower right corner.
  <info>int</info>  <strong>$y2   </strong>  The y-coordinate of the lower right corner.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagegetclip()</strong>


id: imagesetinterpolation
type: function
doc:
<comment>Description:</comment>
  Set the interpolation method
  
  Sets the interpolation method, setting an interpolation method affects the rendering  of various
  functions in GD, such as the <strong>imagerotate()</strong> function.

<comment>Param:</comment>
  <info>   </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$method</strong>  The interpolation method, which can be one of the following: <info>IMG_BELL</info>: Bell filter.
                <info>IMG_BESSEL</info>: Bessel filter. <info>IMG_BICUBIC</info>: Bicubic interpolation. <info>IMG_BICUBIC_FIXED</info>:
                Fixed point implementation of the bicubic interpolation. <info>IMG_BILINEAR_FIXED</info>: Fixed
                point implementation of the  bilinear interpolation (<return>default (also on image
                creation)</return>). <info>IMG_BLACKMAN</info>: Blackman window function. <info>IMG_BOX</info>: Box blur filter.
                <info>IMG_BSPLINE</info>: Spline interpolation. <info>IMG_CATMULLROM</info>: Cubic Hermite spline
                interpolation. <info>IMG_GAUSSIAN</info>: Gaussian function. <info>IMG_GENERALIZED_CUBIC</info>: Generalized
                cubic spline fractal interpolation. <info>IMG_HERMITE</info>: Hermite interpolation. <info>IMG_HAMMING</info>:
                Hamming filter. <info>IMG_HANNING</info>: Hanning filter. <info>IMG_MITCHELL</info>: Mitchell filter.
                <info>IMG_POWER</info>: Power interpolation. <info>IMG_QUADRATIC</info>: Inverse quadratic interpolation.
                <info>IMG_SINC</info>: Sinc function. <info>IMG_NEAREST_NEIGHBOUR</info>: Nearest neighbour interpolation.
                <info>IMG_WEIGHTED4</info>: Weighting filter. <info>IMG_TRIANGLE</info>: Triangle interpolation.
                
                <info>IMG_BELL</info>: Bell filter.
                
                <info>IMG_BESSEL</info>: Bessel filter.
                
                <info>IMG_BICUBIC</info>: Bicubic interpolation.
                
                <info>IMG_BICUBIC_FIXED</info>: Fixed point implementation of the bicubic interpolation.
                
                <info>IMG_BILINEAR_FIXED</info>: Fixed point implementation of the  bilinear interpolation
                (<return>default (also on image creation)</return>).
                
                <info>IMG_BLACKMAN</info>: Blackman window function.
                
                <info>IMG_BOX</info>: Box blur filter.
                
                <info>IMG_BSPLINE</info>: Spline interpolation.
                
                <info>IMG_CATMULLROM</info>: Cubic Hermite spline interpolation.
                
                <info>IMG_GAUSSIAN</info>: Gaussian function.
                
                <info>IMG_GENERALIZED_CUBIC</info>: Generalized cubic spline fractal interpolation.
                
                <info>IMG_HERMITE</info>: Hermite interpolation.
                
                <info>IMG_HAMMING</info>: Hamming filter.
                
                <info>IMG_HANNING</info>: Hanning filter.
                
                <info>IMG_MITCHELL</info>: Mitchell filter.
                
                <info>IMG_POWER</info>: Power interpolation.
                
                <info>IMG_QUADRATIC</info>: Inverse quadratic interpolation.
                
                <info>IMG_SINC</info>: Sinc function.
                
                <info>IMG_NEAREST_NEIGHBOUR</info>: Nearest neighbour interpolation.
                
                <info>IMG_WEIGHTED4</info>: Weighting filter.
                
                <info>IMG_TRIANGLE</info>: Triangle interpolation.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagegetinterpolation()</strong>


id: imagesetpixel
type: function
doc:
<comment>Description:</comment>
  Set a single pixel
  
  <strong>imagesetpixel()</strong> draws a pixel at the specified coordinate.

<comment>Param:</comment>
  <info>   </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
               come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$x    </strong>  x-coordinate.
  <info>int</info>  <strong>$y    </strong>  y-coordinate.
  <info>int</info>  <strong>$color</strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolorat()</strong>


id: imagesetstyle
type: function
doc:
<comment>Description:</comment>
  Set the style for line drawing
  
  <strong>imagesetstyle()</strong> sets the style to be used by all line drawing functions (such as <strong>imageline()</strong> and
  <strong>imagepolygon()</strong>) when drawing with the special color <info>IMG_COLOR_STYLED</info> or lines of images with color
  <info>IMG_COLOR_STYLEDBRUSHED</info>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                 come <strong>imagecreatetruecolor()</strong>.
  <info>array</info>  <strong>$style</strong>  An array of pixel colors. You can use the  <info>IMG_COLOR_TRANSPARENT</info> constant to add a
                 transparent pixel. Note that <strong>$style</strong> must not be an empty <info>array</info>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagesetbrush()</strong>
   * <strong>imageline()</strong>


id: imagesetthickness
type: function
doc:
<comment>Description:</comment>
  Set the thickness for line drawing
  
  <strong>imagesetthickness()</strong> sets the thickness of the lines drawn when drawing rectangles, polygons, arcs
  etc. to <strong>$thickness</strong> pixels.

<comment>Param:</comment>
  <info>   </info>  <strong>$image    </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>int</info>  <strong>$thickness</strong>  Thickness, in pixels.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagesettile
type: function
doc:
<comment>Description:</comment>
  Set the tile image for filling
  
  <strong>imagesettile()</strong> sets the tile image to be used by all region filling functions (such as <strong>imagefill()</strong>
  and <strong>imagefilledpolygon()</strong>) when filling with the special color <info>IMG_COLOR_TILED</info>.
  
  A tile is an image used to fill an area with a repeated pattern. Any GD image can be used as a
  tile, and by setting the transparent color index of the tile image with <strong>imagecolortransparent()</strong>, a
  tile allows certain parts of the underlying area to shine through can be created.
  
  You need not take special action when you are finished with a tile, but if you destroy the tile
  image (or let PHP destroy it), you must not use the <info>IMG_COLOR_TILED</info> color until you have set a new
  tile image!

<comment>Param:</comment>
  <info>        </info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                    come <strong>imagecreatetruecolor()</strong>.
  <info>resource</info>  <strong>$tile </strong>  The image resource to be used as a tile.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagestring
type: function
doc:
<comment>Description:</comment>
  Draw a string horizontally
  
  Draws a <strong>$string</strong> at the given coordinates.

<comment>Param:</comment>
  <info>      </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>      </info>  <strong>$font  </strong>  Può essere 1, 2, 3, 4, 5 per i font
                   interni con codifica latin2 (dove numeri più alti corrispondono a font più
                   grandi) o qualsiasi
                   identificatore di font registrato con <strong>imageloadfont()</strong>.
  <info>int   </info>  <strong>$x     </strong>  x-coordinate of the upper left corner.
  <info>int   </info>  <strong>$y     </strong>  y-coordinate of the upper left corner.
  <info>string</info>  <strong>$string</strong>  The string to be written.
  <info>int   </info>  <strong>$color </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagestringup()</strong>
   * <strong>imageloadfont()</strong>
   * <strong>imagettftext()</strong>


id: imagestringup
type: function
doc:
<comment>Description:</comment>
  Draw a string vertically
  
  Draws a <strong>$string</strong> vertically at the given coordinates.

<comment>Param:</comment>
  <info>      </info>  <strong>$image </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>      </info>  <strong>$font  </strong>  Può essere 1, 2, 3, 4, 5 per i font
                   interni con codifica latin2 (dove numeri più alti corrispondono a font più
                   grandi) o qualsiasi
                   identificatore di font registrato con <strong>imageloadfont()</strong>.
  <info>int   </info>  <strong>$x     </strong>  x-coordinate of the bottom left corner.
  <info>int   </info>  <strong>$y     </strong>  y-coordinate of the bottom left corner.
  <info>string</info>  <strong>$string</strong>  The string to be written.
  <info>int   </info>  <strong>$color </strong>  A color identifier created with <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imagestring()</strong>
   * <strong>imageloadfont()</strong>


id: imagesx
type: function
doc:
<comment>Description:</comment>
  Get image width
  
  Returns the width of the given <strong>$image</strong> resource.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Return the width of the <strong>$image</strong> or <info>false</info> on  errors.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>getimagesize()</strong>
   * <strong>imagesy()</strong>


id: imagesy
type: function
doc:
<comment>Description:</comment>
  Get image height
  
  Returns the height of the given <strong>$image</strong> resource.

<comment>Param:</comment>
  <info></info>  <strong>$image</strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
            come <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Return the height of the <strong>$image</strong> or <info>false</info> on  errors.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>getimagesize()</strong>
   * <strong>imagesx()</strong>


id: imagetruecolortopalette
type: function
doc:
<comment>Description:</comment>
  Convert a true color image to a palette image
  
  <strong>imagetruecolortopalette()</strong> converts a truecolor image to a palette image. The code for this
  function was originally drawn from the Independent JPEG Group library code, which is excellent.
  The code has been modified to preserve as much alpha channel information as possible in the
  resulting palette, in addition to preserving colors as well as possible. This does not work as
  well as might be hoped. It is usually best to simply produce a truecolor output image instead,
  which guarantees the highest output quality.

<comment>Param:</comment>
  <info>    </info>  <strong>$image  </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                  come <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>  <strong>$dither </strong>  Indicates if the image should be dithered - if it is <info>true</info> then dithering will be
                  used which will result in a more speckled image but with better color
                  approximation.
  <info>int </info>  <strong>$ncolors</strong>  Sets the maximum number of colors that should be retained in the palette.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imagettfbbox
type: function
doc:
<comment>Description:</comment>
  Give the bounding box of a text using TrueType fonts
  
  This function calculates and returns the bounding box in pixels for a TrueType text.
  
  <strong>imageftbbox()</strong> is an extended variant of <strong>imagettfbbox()</strong> which additionally supports the <strong>$extrainfo</strong>.

<comment>Param:</comment>
  <info>float </info>  <strong>$size    </strong>  La dimensione del carattere. A seconda della versione di GD, deve essere
                     specificata in pixel (GD1) o in punti (GD2).
  <info>float </info>  <strong>$angle   </strong>  Angle in degrees in which <strong>$text</strong> will be measured.
  <info>string</info>  <strong>$fontfile</strong>  The path to the TrueType font you wish to use.
                     
                     Depending on which version of the GD library PHP is using, when <strong>$fontfile</strong> does
                     not begin with a leading <return>/</return> then <return>.ttf</return> will be appended to the filename and the
                     library will attempt to search for that filename along a library-defined font
                     path.
                     
                     When using versions of the GD library lower than 2.0.18, a <return>space</return> character,
                     rather than a semicolon, was used as the 'path separator' for different font
                     files. Unintentional use of this feature will result in the warning message:
                     <return>Warning: Could not find/open font</return>. For these affected versions, the only
                     solution is moving the font to a path which does not contain spaces.
                     
                     In many cases where a font resides in the same directory as the script using it
                     the following trick will alleviate any include problems.
                     ]]>
                     
                     Note that open_basedir does not apply to <strong>$fontfile</strong>.
  <info>string</info>  <strong>$text    </strong>  The string to be measured.

<comment>Return:</comment>
  <info>array</info>  <strong>imagettfbbox()</strong> returns an array with 8 elements representing four points making the
         bounding box of the text on success and <info>false</info> on error. keycontents0lower left corner, X
         position1lower left corner, Y position2lower right corner, X position3lower right corner, Y
         position4upper right corner, X position5upper right corner, Y position6upper left corner, X
         position7upper left corner, Y position
         
         The points are relative to the text regardless of the <strong>$angle</strong>, so "upper left" means in the
         top left-hand  corner seeing the text horizontally.

<comment>See Also:</comment>
   * <strong>imagettftext()</strong>
   * <strong>imageftbbox()</strong>


id: imagettftext
type: function
doc:
<comment>Description:</comment>
  Write text to the image using TrueType fonts
  
  Writes the given <strong>$text</strong> into the image using TrueType fonts.
  
  <strong>imagefttext()</strong> is an extended variant of <strong>imagettftext()</strong> which additionally supports the <strong>$extrainfo</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$image   </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                     come <strong>imagecreatetruecolor()</strong>.
  <info>float </info>  <strong>$size    </strong>  La dimensione del carattere. A seconda della versione di GD, deve essere
                     specificata in pixel (GD1) o in punti (GD2).
  <info>float </info>  <strong>$angle   </strong>  The angle in degrees, with 0 degrees being left-to-right reading text. Higher
                     values represent a counter-clockwise rotation. For example, a  value of 90
                     would result in bottom-to-top reading text.
  <info>int   </info>  <strong>$x       </strong>  The coordinates given by <strong>$x</strong> and <strong>$y</strong> will define the basepoint of the first
                     character (roughly the lower-left corner of the character). This is different
                     from the <strong>imagestring()</strong>, where <strong>$x</strong> and <strong>$y</strong> define the upper-left corner of the
                     first character. For example, "top left" is 0, 0.
  <info>int   </info>  <strong>$y       </strong>  The y-ordinate. This sets the position of the fonts baseline, not the very
                     bottom of the character.
  <info>int   </info>  <strong>$color   </strong>  The color index. Using the negative of a color index has the effect of turning
                     off antialiasing. See <strong>imagecolorallocate()</strong>.
  <info>string</info>  <strong>$fontfile</strong>  The path to the TrueType font you wish to use.
                     
                     Depending on which version of the GD library PHP is using, when <strong>$fontfile</strong> does
                     not begin with a leading <return>/</return> then <return>.ttf</return> will be appended to the filename and the
                     library will attempt to search for that filename along a library-defined font
                     path.
                     
                     When using versions of the GD library lower than 2.0.18, a <return>space</return> character,
                     rather than a semicolon, was used as the 'path separator' for different font
                     files. Unintentional use of this feature will result in the warning message:
                     <return>Warning: Could not find/open font</return>. For these affected versions, the only
                     solution is moving the font to a path which does not contain spaces.
                     
                     In many cases where a font resides in the same directory as the script using it
                     the following trick will alleviate any include problems.
                     ]]>
                     
                     Note that open_basedir does not apply to <strong>$fontfile</strong>.
  <info>string</info>  <strong>$text    </strong>  The text string in UTF-8 encoding.
                     
                     May include decimal numeric character references (of the form: &#8364;) to
                     access characters in a font beyond position 127. The hexadecimal format (like
                     &#xA9;) is supported. Strings in UTF-8 encoding can be passed directly.
                     
                     Named entities, such as &copy;, are not supported. Consider using
                     <strong>html_entity_decode()</strong> to decode these named entities into UTF-8 strings.
                     
                     If a character is used in the string which is not supported by the font, a
                     hollow rectangle will replace the character.

<comment>Return:</comment>
  <info>array</info>  Returns an array with 8 elements representing four points making the bounding box of the
         text. The order of the points is lower left, lower  right, upper right, upper left. The
         points are relative to the text regardless of the angle, so "upper left" means in the top
         left-hand  corner when you see the text horizontally. Returns <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>imagettfbbox()</strong>
   * <strong>imagefttext()</strong>


id: imagetypes
type: function
doc:
<comment>Description:</comment>
  Return the image types supported by this PHP build
  
  Returns the image types supported by the current PHP installation.

<comment>Return:</comment>
  <info>int</info>  Returns a bit-field corresponding to the image formats supported by the version of GD linked
       into PHP.  The following bits are returned, <info>IMG_BMP</info> | <info>IMG_GIF</info> | <info>IMG_JPG</info> | <info>IMG_PNG</info> | <info>IMG_WBMP</info>
       |  <info>IMG_XPM</info> | <info>IMG_WEBP</info>.

<comment>See Also:</comment>
   * <strong>gd_info()</strong>


id: imagewbmp
type: function
doc:
<comment>Description:</comment>
  Invia l'immagine al browser o in un file
  
  <strong>imagewbmp()</strong> outputs or save a WBMP version of the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to        </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene
                      restituito il flusso raw dell'immagine.
  <info>int  </info>  <strong>$foreground</strong>  You can set the foreground color with this parameter by setting an identifier
                      obtained from <strong>imagecolorallocate()</strong>. The default foreground color is black.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>image2wbmp()</strong>
   * <strong>imagepng()</strong>
   * <strong>imagegif()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagewebp
type: function
doc:
<comment>Description:</comment>
  Output a WebP image to browser or file
  
  Outputs or saves a WebP version of the given <strong>$image</strong>.

<comment>Param:</comment>
  <info>     </info>  <strong>$image  </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                   come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$to     </strong>  Il percorso in cui salvare il file. Se non è impostato o è <info>null</info>, viene restituito
                   il flusso raw dell'immagine.
  <info>int  </info>  <strong>$quality</strong>  <strong>$quality</strong> ranges from 0 (worst quality, smaller file) to 100 (best quality,
                   biggest file).

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.


id: imagexbm
type: function
doc:
<comment>Description:</comment>
  Output an XBM image to browser or file
  
  Outputs or save an XBM version of the given  <strong>$image</strong>.
  
  <strong>imagexbm()</strong> doesn't apply any padding, so the image width has to be a multiple of 8. This
  restriction does no longer apply as of PHP 7.0.9.

<comment>Param:</comment>
  <info>     </info>  <strong>$image     </strong>  Una risorsa immagine, restituita da una delle funzioni di creazione immagine, 
                      come <strong>imagecreatetruecolor()</strong>.
  <info>mixed</info>  <strong>$filename  </strong>  The path to save the file to, given as <info>string</info>. If <info>null</info>, the raw image stream
                      will be output directly.
                      
                      The <strong>$filename</strong> (without the .xbm extension) is also used for the C identifiers
                      of the XBM, whereby non alphanumeric characters of the current locale are
                      substituted by underscores. If <strong>$filename</strong> is set to <info>null</info>, <return>image</return> is used to
                      build the C identifiers.
  <info>int  </info>  <strong>$foreground</strong>  You can set the foreground color with this parameter by setting an identifier
                      obtained from <strong>imagecolorallocate()</strong>. The default foreground color is black. All
                      other colors are treated as background.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.
        
        However, if libgd fails to output the image, this function returns <info>true</info>.


id: imagick::ALPHACHANNEL_ACTIVATE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.8 or
  higher.


id: imagick::ALPHACHANNEL_COPY
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.6 or
  higher.


id: imagick::COLORSPACE_CMY
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.2 or
  higher.


id: imagick::COMPOSITE_EXCLUSION
type: constant
doc:
<comment>Description:</comment>
  Produces an effect similar to that of imagick::COMPOSITE_DIFFERENCE, but appears as lower contrast


id: imagick::COMPRESSION_DXT1
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.0 or
  higher.


id: imagick::DISTORTION_AFFINE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.6 or
  higher.


id: imagick::EVALUATE_ADDMODULUS
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.4 or
  higher.


id: imagick::FUNCTION_POLYNOMIAL
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.9 or
  higher.


id: imagick::INTERLACE_GIF
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.4 or
  higher.


id: imagick::INTERPOLATE_AVERAGE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.2 or
  higher.


id: imagick::LAYERMETHOD_COALESCE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.2.9 or
  higher.


id: imagick::LAYERMETHOD_COMPOSITE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.0 or
  higher.


id: imagick::LAYERMETHOD_FLATTEN
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.3.7 or
  higher.


id: imagick::RESOURCETYPE_AREA
type: constant
doc:
<comment>Description:</comment>
  Set the maximum width * height of an image that can reside in the pixel cache memory.


id: imagick::RESOURCETYPE_DISK
type: constant
doc:
<comment>Description:</comment>
  Set maximum amount of disk space in bytes permitted for use by the pixel cache.


id: imagick::RESOURCETYPE_MAP
type: constant
doc:
<comment>Description:</comment>
  Set maximum amount of memory map in bytes to allocate for the pixel cache.


id: imagick::RESOURCETYPE_MEMORY
type: constant
doc:
<comment>Description:</comment>
  Set maximum amount of memory in bytes to allocate for the pixel cache from the heap.


id: imagick::RESOURCETYPE_THREAD
type: constant
doc:
<comment>Description:</comment>
  Set maximum parallel threads. Questa costante è disponibile se Imagick è stato compilato con
  ImageMagick versione 6.7.8 or higher.


id: imagick::VIRTUALPIXELMETHOD_HORIZONTALTILE
type: constant
doc:
<comment>Description:</comment>
  Questa costante è disponibile se Imagick è stato compilato con ImageMagick versione 6.4.3 or
  higher.


id: imap_8bit
type: function
doc:
<comment>Description:</comment>
  Convert an 8bit string to a quoted-printable string
  
  Convert an 8bit string to a quoted-printable string (according to RFC2045, section 6.7).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The 8bit string to convert

<comment>Return:</comment>
  <info>string</info>  Returns a quoted-printable string.

<comment>See Also:</comment>
   * <strong>imap_qprint()</strong>


id: imap_alerts
type: function
doc:
<comment>Description:</comment>
  Returns all IMAP alert messages that have occurred
  
  Returns all of the IMAP alert messages generated since the last <strong>imap_alerts()</strong> call, or the
  beginning of the page.
  
  When <strong>imap_alerts()</strong> is called, the alert stack is subsequently cleared. The IMAP specification
  requires that these messages be passed to the user.

<comment>Return:</comment>
  <info>array</info>  Returns an array of all of the IMAP alert messages generated or <info>false</info> if no alert messages
         are available.

<comment>See Also:</comment>
   * <strong>imap_errors()</strong>


id: imap_append
type: function
doc:
<comment>Description:</comment>
  Append a string message to a specified mailbox
  
  Appends a string <strong>$message</strong> to the specified <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream  </strong>  Uno stream IMAP restituito da
                          <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox      </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                          
                          Passing untrusted data to this parameter is insecure, unless
                          imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$message      </strong>  The message to be append, as a string
                          
                          When talking to the Cyrus IMAP server, you must use "\r\n" as your
                          end-of-line terminator instead of "\n" or the operation will fail
  <info>string</info>  <strong>$options      </strong>  If provided, the <strong>$options</strong> will also be written to the <strong>$mailbox</strong>
  <info>string</info>  <strong>$internal_date</strong>  If this parameter is set, it will set the INTERNALDATE on the appended
                          message.  The parameter should be a date string that conforms to the
                          rfc2060 specifications for a date_time value.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imap_base64
type: function
doc:
<comment>Description:</comment>
  Decode BASE64 encoded text
  
  Decodes the given BASE-64 encoded <strong>$text</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$text</strong>  The encoded text

<comment>Return:</comment>
  <info>string</info>  Returns the decoded message as a string.

<comment>See Also:</comment>
   * <strong>imap_binary()</strong>
   * <strong>base64_encode()</strong>
   * <strong>base64_decode()</strong>
   * RFC2045, Section 6.8


id: imap_binary
type: function
doc:
<comment>Description:</comment>
  Convert an 8bit string to a base64 string
  
  Convert an 8bit string to a base64 string according to RFC2045, Section 6.8.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The 8bit string

<comment>Return:</comment>
  <info>string</info>  Returns a base64 encoded string.

<comment>See Also:</comment>
   * <strong>imap_base64()</strong>


id: imap_body
type: function
doc:
<comment>Description:</comment>
  Read the message body
  
  <strong>imap_body()</strong> returns the body of the message, numbered <strong>$msg_number</strong> in the current mailbox.
  
  <strong>imap_body()</strong> will only return a verbatim copy of the message body. To extract single parts of a
  multipart MIME-encoded message you have to use <strong>imap_fetchstructure()</strong> to analyze its structure and
  <strong>imap_fetchbody()</strong> to extract a copy of a single body component.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number
  <info>int</info>  <strong>$options    </strong>  The optional <strong>$options</strong> are a bit mask with one or more of the following: <info>FT_UID</info>
                     - The <strong>$msg_number</strong> is a UID <info>FT_PEEK</info> - Do not set the \Seen flag if not already
                     set <info>FT_INTERNAL</info> - The return string is in internal format, will not
                     canonicalize to CRLF.
                     
                     <info>FT_UID</info> - The <strong>$msg_number</strong> is a UID
                     
                     <info>FT_PEEK</info> - Do not set the \Seen flag if not already set
                     
                     <info>FT_INTERNAL</info> - The return string is in internal format, will not canonicalize to
                     CRLF.

<comment>Return:</comment>
  <info>string</info>  Returns the body of the specified message, as a string.


id: imap_bodystruct
type: function
doc:
<comment>Description:</comment>
  Read the structure of a specified body section of a specific message
  
  Read the structure of a specified body section of a specific message.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>int   </info>  <strong>$msg_number </strong>  The message number
  <info>string</info>  <strong>$section    </strong>  The body section to read

<comment>Return:</comment>
  <info>object</info>  Returns the information in an object, for a detailed description of the object structure
          and properties see  <strong>imap_fetchstructure()</strong>.

<comment>See Also:</comment>
   * <strong>imap_fetchstructure()</strong>


id: imap_check
type: function
doc:
<comment>Description:</comment>
  Check current mailbox
  
  Checks information about the current mailbox.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>object</info>  Returns the information in an object with following properties: <info>Date</info> - current system time
          formatted according to RFC2822 <info>Driver</info> - protocol used to access this mailbox: POP3, IMAP,
          NNTP <info>Mailbox</info> - the mailbox name <info>Nmsgs</info> - number of messages in the mailbox <info>Recent</info> - number
          of recent messages in the mailbox
          
          <info>Date</info> - current system time formatted according to RFC2822
          
          <info>Driver</info> - protocol used to access this mailbox: POP3, IMAP, NNTP
          
          <info>Mailbox</info> - the mailbox name
          
          <info>Nmsgs</info> - number of messages in the mailbox
          
          <info>Recent</info> - number of recent messages in the mailbox
          
          Returns <info>false</info> on failure.


id: imap_clearflag_full
type: function
doc:
<comment>Description:</comment>
  Clears flags on messages
  
  This function causes a store to delete the specified <strong>$flag</strong> to the flags set for the messages in
  the specified <strong>$sequence</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$sequence   </strong>  A sequence of message numbers. You can enumerate desired messages with the
                        <return>X,Y</return> syntax, or retrieve all messages  within an interval with the <return>X:Y</return> syntax
  <info>string</info>  <strong>$flag       </strong>  The flags which you can unset are "\\Seen", "\\Answered", "\\Flagged",
                        "\\Deleted", and "\\Draft" (as defined by RFC2060)
  <info>int   </info>  <strong>$options    </strong>  <strong>$options</strong> are a bit mask and may contain the single option: <info>ST_UID</info> - The
                        sequence argument contains UIDs instead of sequence numbers
                        
                        <info>ST_UID</info> - The sequence argument contains UIDs instead of sequence numbers

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_setflag_full()</strong>


id: imap_close
type: function
doc:
<comment>Description:</comment>
  Close an IMAP stream
  
  Closes the imap stream.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$flag       </strong>  If set to <info>CL_EXPUNGE</info>, the function will silently expunge the mailbox before
                     closing, removing all messages marked for deletion. You can achieve the same
                     thing by using <strong>imap_expunge()</strong>

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>


id: imap_create
type: function
doc:
<comment>Description:</comment>
  Alias di imap_createmailbox
  
  Questa funzione è sinonimo di:  <strong>imap_createmailbox()</strong>.


id: imap_createmailbox
type: function
doc:
<comment>Description:</comment>
  Create a new mailbox
  
  Creates a new mailbox specified by <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information. Names containing
                        international characters should be encoded by <strong>imap_utf7_encode()</strong>
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_renamemailbox()</strong>
   * <strong>imap_deletemailbox()</strong>


id: imap_delete
type: function
doc:
<comment>Description:</comment>
  Mark a message for deletion from current mailbox
  
  Marks messages listed in <strong>$msg_number</strong> for deletion. Messages marked for deletion will stay in the
  mailbox until either <strong>imap_expunge()</strong> is called or <strong>imap_close()</strong> is called with the optional
  parameter <info>CL_EXPUNGE</info>.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number
  <info>int</info>  <strong>$options    </strong>  You can set the <info>FT_UID</info> which tells the function to treat the <strong>$msg_number</strong>
                     argument as a <return>UID</return>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>imap_undelete()</strong>
   * <strong>imap_expunge()</strong>
   * <strong>imap_close()</strong>


id: imap_deletemailbox
type: function
doc:
<comment>Description:</comment>
  Delete a mailbox
  
  Deletes the specified <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_createmailbox()</strong>
   * <strong>imap_renamemailbox()</strong>
   * <strong>imap_open()</strong> for the format of
     <strong>$mbox</strong>
    


id: imap_errors
type: function
doc:
<comment>Description:</comment>
  Returns all of the IMAP errors that have occurred
  
  Gets all of the IMAP errors (if any) that have occurred during this page request or since the
  error stack was reset.
  
  When <strong>imap_errors()</strong> is called, the error stack is subsequently cleared.

<comment>Return:</comment>
  <info>array</info>  This function returns an array of all of the IMAP error messages generated since the last
         <strong>imap_errors()</strong> call, or the beginning of the page. Returns <info>false</info> if no error messages are
         available.

<comment>See Also:</comment>
   * <strong>imap_last_error()</strong>
   * <strong>imap_alerts()</strong>


id: imap_expunge
type: function
doc:
<comment>Description:</comment>
  Delete all messages marked for deletion
  
  Deletes all the messages marked for deletion by  <strong>imap_delete()</strong>, <strong>imap_mail_move()</strong>, or
  <strong>imap_setflag_full()</strong>.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info>.


id: imap_fetch_overview
type: function
doc:
<comment>Description:</comment>
  Read an overview of the information in the headers of the given message
  
  This function fetches mail headers for the given <strong>$sequence</strong> and returns an overview of their
  contents.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$sequence   </strong>  A message sequence description. You can enumerate desired messages with the
                        <return>X,Y</return> syntax, or retrieve all messages  within an interval with the <return>X:Y</return> syntax
  <info>int   </info>  <strong>$options    </strong>  <strong>$sequence</strong> will contain a sequence of message indices or UIDs, if this
                        parameter is set to  <info>FT_UID</info>.

<comment>Return:</comment>
  <info>array</info>  Returns an array of objects describing one message header each. The object will only define
         a property if it exists. The possible properties are: <return>subject</return> - the messages subject <return>from</return> -
         who sent it <return>to</return> - recipient <return>date</return> - when was it sent <return>message_id</return> - Message-ID <return>references</return> - is
         a reference to this message id <return>in_reply_to</return> - is a reply to this message id <return>size</return> - size in
         bytes <return>uid</return> - UID the message has in the mailbox <return>msgno</return> - message sequence number in the
         mailbox <return>recent</return> - this message is flagged as recent <return>flagged</return> -  this message is flagged
         <return>answered</return> -  this message is flagged as answered <return>deleted</return> -  this message is flagged for
         deletion <return>seen</return> -  this message is flagged as already read <return>draft</return> -  this message is flagged
         as being a draft <return>udate</return> -  the UNIX timestamp of the arrival date
         
         <return>subject</return> - the messages subject
         
         <return>from</return> - who sent it
         
         <return>to</return> - recipient
         
         <return>date</return> - when was it sent
         
         <return>message_id</return> - Message-ID
         
         <return>references</return> - is a reference to this message id
         
         <return>in_reply_to</return> - is a reply to this message id
         
         <return>size</return> - size in bytes
         
         <return>uid</return> - UID the message has in the mailbox
         
         <return>msgno</return> - message sequence number in the mailbox
         
         <return>recent</return> - this message is flagged as recent
         
         <return>flagged</return> -  this message is flagged
         
         <return>answered</return> -  this message is flagged as answered
         
         <return>deleted</return> -  this message is flagged for deletion
         
         <return>seen</return> -  this message is flagged as already read
         
         <return>draft</return> -  this message is flagged as being a draft
         
         <return>udate</return> -  the UNIX timestamp of the arrival date

<comment>See Also:</comment>
   * <strong>imap_fetchheader()</strong>


id: imap_fetchbody
type: function
doc:
<comment>Description:</comment>
  Fetch a particular section of the body of the message
  
  Fetch of a particular section of the body of the specified messages.  Body parts are not decoded
  by this function.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>int   </info>  <strong>$msg_number </strong>  The message number
  <info>string</info>  <strong>$section    </strong>  The part number. It is a string of integers delimited by period which index
                        into a body part list as per the IMAP4 specification
  <info>int   </info>  <strong>$options    </strong>  A bitmask with one or more of the following: <info>FT_UID</info> - The <strong>$msg_number</strong> is a
                        UID <info>FT_PEEK</info> - Do not set the \Seen flag if not already set <info>FT_INTERNAL</info> - The
                        return string is in internal format, will not canonicalize to CRLF.
                        
                        <info>FT_UID</info> - The <strong>$msg_number</strong> is a UID
                        
                        <info>FT_PEEK</info> - Do not set the \Seen flag if not already set
                        
                        <info>FT_INTERNAL</info> - The return string is in internal format, will not canonicalize
                        to CRLF.

<comment>Return:</comment>
  <info>string</info>  Returns a particular section of the body of the specified messages as a text string.

<comment>See Also:</comment>
   * <strong>imap_savebody()</strong>
   * <strong>imap_fetchstructure()</strong>


id: imap_fetchheader
type: function
doc:
<comment>Description:</comment>
  Returns header for a message
  
  This function causes a fetch of the complete, unfiltered RFC2822 format header of the specified
  message.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number
  <info>int</info>  <strong>$options    </strong>  The possible <strong>$options</strong> are: <info>FT_UID</info> - The <strong>$msgno</strong> argument is a UID <info>FT_INTERNAL</info> -
                     The return string is in "internal" format, without any attempt to canonicalize
                     to CRLF newlines <info>FT_PREFETCHTEXT</info> - The RFC822.TEXT should be pre-fetched at the
                     same time.  This avoids an extra RTT on an IMAP connection if a full message
                     text is desired (e.g. in a "save to local file" operation)
                     
                     <info>FT_UID</info> - The <strong>$msgno</strong> argument is a UID
                     
                     <info>FT_INTERNAL</info> - The return string is in "internal" format, without any attempt to
                     canonicalize to CRLF newlines
                     
                     <info>FT_PREFETCHTEXT</info> - The RFC822.TEXT should be pre-fetched at the same time.  This
                     avoids an extra RTT on an IMAP connection if a full message text is desired
                     (e.g. in a "save to local file" operation)

<comment>Return:</comment>
  <info>string</info>  Returns the header of the specified message as a text string.

<comment>See Also:</comment>
   * <strong>imap_fetch_overview()</strong>


id: imap_fetchmime
type: function
doc:
<comment>Description:</comment>
  Fetch MIME headers for a particular section of the message
  
  Fetch the MIME headers of a particular section of the body of the specified messages.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>int   </info>  <strong>$msg_number </strong>  The message number
  <info>string</info>  <strong>$section    </strong>  The part number. It is a string of integers delimited by period which index
                        into a body part list as per the IMAP4 specification
  <info>int   </info>  <strong>$options    </strong>  A bitmask with one or more of the following: <info>FT_UID</info> - The <strong>$msg_number</strong> is a
                        UID <info>FT_PEEK</info> - Do not set the \Seen flag if not already set <info>FT_INTERNAL</info> - The
                        return string is in internal format, will not canonicalize to CRLF.
                        
                        <info>FT_UID</info> - The <strong>$msg_number</strong> is a UID
                        
                        <info>FT_PEEK</info> - Do not set the \Seen flag if not already set
                        
                        <info>FT_INTERNAL</info> - The return string is in internal format, will not canonicalize
                        to CRLF.

<comment>Return:</comment>
  <info>string</info>  Returns the MIME headers of a particular section of the body of the specified messages as
          a text string.

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>
   * <strong>imap_fetchstructure()</strong>
   * <strong>imap_fetchheader()</strong>


id: imap_fetchstructure
type: function
doc:
<comment>Description:</comment>
  Read the structure of a particular message
  
  Fetches all the structured information for a given message.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number
  <info>int</info>  <strong>$options    </strong>  This optional parameter only has a single option,  <info>FT_UID</info>, which tells the
                     function to treat the <strong>$msg_number</strong> argument as a  <return>UID</return>.

<comment>Return:</comment>
  <info>objectfalse</info>  Returns an object with properties listed in the table below,  o <info>false</info> in caso di
               fallimento.
               
                Returned Object for <strong>imap_fetchstructure()</strong> typePrimary body typeencodingBody transfer
               encodingifsubtype<info>true</info> if there is a subtype stringsubtypeMIME
               subtypeifdescription<info>true</info> if there is a description stringdescriptionContent
               description stringifid<info>true</info> if there is an identification stringidIdentification
               stringlinesNumber of linesbytesNumber of bytesifdisposition<info>true</info> if there is a
               disposition stringdispositionDisposition stringifdparameters<info>true</info> if the dparameters
               array existsdparametersAn array of objects where each object has an <return>"attribute"</return> and a
               <return>"value"</return> property corresponding to the parameters on the <return>Content-disposition</return> MIME
               header.ifparameters<info>true</info> if the parameters array existsparametersAn array of objects
               where each object has an <return>"attribute"</return> and a <return>"value"</return> property.partsAn array of objects
               identical in structure to the top-level object, each of which corresponds to a MIME
               body part.
               
               Primary body type (value may vary with used library, use of constants is
               recommended)ValueTypeConstant0textTYPETEXT1multipartTYPEMULTIPART2messageTYPEMESSAGE3applicationTYPEAPPLICATION4audioTYPEAUDIO5imageTYPEIMAGE6videoTYPEVIDEO7modelTYPEMODEL8otherTYPEOTHER
               
               Transfer encodings (value may vary with used library, use of constants is
               recommended)ValueTypeConstant07bitENC7BIT18bitENC8BIT2BinaryENCBINARY3Base64ENCBASE644Quoted-PrintableENCQUOTEDPRINTABLE5otherENCOTHER

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>
   * <strong>imap_bodystruct()</strong>


id: imap_fetchtext
type: function
doc:
<comment>Description:</comment>
  Alias di imap_body
  
  Questa funzione è sinonimo di:  <strong>imap_body()</strong>.


id: imap_gc
type: function
doc:
<comment>Description:</comment>
  Clears IMAP cache
  
  Purges the cache of entries of a specific type.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$caches     </strong>  Specifies the cache to purge. It may one or a combination of the following
                     constants:  <info>IMAP_GC_ELT</info> (message cache elements),  <info>IMAP_GC_ENV</info> (envelope and
                     bodies), <info>IMAP_GC_TEXTS</info> (texts).

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.


id: imap_get_quota
type: function
doc:
<comment>Description:</comment>
  Retrieve the quota level settings, and usage statics per mailbox
  
  Retrieve the quota level settings, and usage statics per mailbox.
  
  For a non-admin user version of this function, please see the <strong>imap_get_quotaroot()</strong> function of
  PHP.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$quota_root </strong>  <strong>$quota_root</strong> should normally be in the form of <return>user.name</return> where name is the
                        mailbox you wish to retrieve information about.

<comment>Return:</comment>
  <info>array</info>  Returns an array with integer values limit and usage for the given mailbox.  The value of
         limit represents the total amount of space allowed for this mailbox.  The usage value
         represents the mailboxes current level of capacity.  Will return <info>false</info> in the case of
         failure.
         
         As of PHP 4.3, the function more properly reflects the functionality as dictated by the
         RFC2087. The array return value has changed to support an unlimited number of returned
         resources (i.e.  messages, or sub-folders) with each named resource receiving an individual
         array key.  Each key value then contains an another array with the usage and limit values
         within it.
         
         For backwards compatibility reasons, the original access methods are still available for
         use, although it is suggested to update.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_set_quota()</strong>
   * <strong>imap_get_quotaroot()</strong>


id: imap_get_quotaroot
type: function
doc:
<comment>Description:</comment>
  Retrieve the quota settings per user
  
  Retrieve the quota settings per user. The limit value represents the total amount of space allowed
  for this user's total mailbox usage.  The usage value represents the user's current total mailbox
  capacity.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$quota_root </strong>  <strong>$quota_root</strong> should normally be in the form of which mailbox (i.e. INBOX).

<comment>Return:</comment>
  <info>array</info>  Returns an array of integer values pertaining to the specified user mailbox.  All values
         contain a key based upon the resource name, and a corresponding array with the usage and
         limit values within.
         
         This function will return <info>false</info> in the case of call failure, and an array of information
         about the connection upon an un-parsable response from the server.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_set_quota()</strong>
   * <strong>imap_get_quota()</strong>


id: imap_getacl
type: function
doc:
<comment>Description:</comment>
  Gets the ACL for a given mailbox
  
  Gets the ACL for a given mailbox.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>array</info>  Returns an associative array of "folder" =&gt; "acl" pairs.

<comment>See Also:</comment>
   * <strong>imap_setacl()</strong>


id: imap_getmailboxes
type: function
doc:
<comment>Description:</comment>
  Read the list of mailboxes, returning detailed information on each one
  
  Gets information on the mailboxes.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$ref        </strong>  <strong>$ref</strong> should normally be just the server specification as described in
                        <strong>imap_open()</strong>
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$pattern    </strong>  Specifica da dove, nella gerarchia della mailbox,
                        cominciare a cercare.
                        
                        Ci sono due caratteri speciali che si possono
                        passare all'interno di <strong>$pattern</strong>:
                        '<return>*</return>' e '<return>%</return>'.
                        '<return>*</return>' restituisce tutte le mailbox. Se si passa
                        '<return>*</return>' in <strong>$pattern</strong>, verrà
                        restituito un elenco du tutta le gerarchia della mailbox.
                        '<return>%</return>'
                        corrisponde al solo livello attuale.
                        '<return>%</return>' nel parametro <strong>$pattern</strong>
                        restituirà solo le mailbox del livello
                        superiore; '<return>~/mail/%</return>' in <return>UW_IMAPD</return> restituirà ogni mailbox nella cartella
                        ~/mail, ma non quelle nelle sue sottocartelle.

<comment>Return:</comment>
  <info>array</info>  Returns an array of objects containing mailbox information. Each object has the attributes
         <strong>$name</strong>, specifying the full name of the mailbox; <strong>$delimiter</strong>, which is the hierarchy
         delimiter for the part of the hierarchy this mailbox is in; and <strong>$attributes</strong>. <strong>$Attributes</strong> is
         a bitmask that can be tested against: <info>LATT_NOINFERIORS</info> - This mailbox not contains, and may
         not contain any "children" (there are no mailboxes below this one). Calling
         <strong>imap_createmailbox()</strong> will not work on this mailbox. <info>LATT_NOSELECT</info> - This is only a
         container, not a mailbox - you cannot open it. <info>LATT_MARKED</info> - This mailbox is marked. This
         means that it may  contain new messages since the last time it was checked. Not provided by
         all IMAP servers. <info>LATT_UNMARKED</info> - This mailbox is not marked, does not contain new
         messages.  If either <info>MARKED</info> or <info>UNMARKED</info> is provided, you can assume the IMAP server
         supports this feature for this mailbox. <info>LATT_REFERRAL</info> - This container has a referral to a
         remote mailbox. <info>LATT_HASCHILDREN</info> - This mailbox has selectable inferiors.
         <info>LATT_HASNOCHILDREN</info> - This mailbox has no selectable inferiors.
         
         <info>LATT_NOINFERIORS</info> - This mailbox not contains, and may not contain any "children" (there are
         no mailboxes below this one). Calling  <strong>imap_createmailbox()</strong> will not work on this mailbox.
         
         <info>LATT_NOSELECT</info> - This is only a container, not a mailbox - you cannot open it.
         
         <info>LATT_MARKED</info> - This mailbox is marked. This means that it may  contain new messages since
         the last time it was checked. Not provided by all IMAP servers.
         
         <info>LATT_UNMARKED</info> - This mailbox is not marked, does not contain new messages.  If either
         <info>MARKED</info> or <info>UNMARKED</info> is provided, you can assume the IMAP server  supports this feature for
         this mailbox.
         
         <info>LATT_REFERRAL</info> - This container has a referral to a remote mailbox.
         
         <info>LATT_HASCHILDREN</info> - This mailbox has selectable inferiors.
         
         <info>LATT_HASNOCHILDREN</info> - This mailbox has no selectable inferiors.

<comment>See Also:</comment>
   * <strong>imap_getsubscribed()</strong>


id: imap_getsubscribed
type: function
doc:
<comment>Description:</comment>
  List all the subscribed mailboxes
  
  Gets information about the subscribed mailboxes.
  
  Identical to <strong>imap_getmailboxes()</strong>, except that it only returns mailboxes that the user is
  subscribed to.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$ref        </strong>  <strong>$ref</strong> should normally be just the server specification as described in
                        <strong>imap_open()</strong>
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$pattern    </strong>  Specifica da dove, nella gerarchia della mailbox,
                        cominciare a cercare.
                        
                        Ci sono due caratteri speciali che si possono
                        passare all'interno di <strong>$pattern</strong>:
                        '<return>*</return>' e '<return>%</return>'.
                        '<return>*</return>' restituisce tutte le mailbox. Se si passa
                        '<return>*</return>' in <strong>$pattern</strong>, verrà
                        restituito un elenco du tutta le gerarchia della mailbox.
                        '<return>%</return>'
                        corrisponde al solo livello attuale.
                        '<return>%</return>' nel parametro <strong>$pattern</strong>
                        restituirà solo le mailbox del livello
                        superiore; '<return>~/mail/%</return>' in <return>UW_IMAPD</return> restituirà ogni mailbox nella cartella
                        ~/mail, ma non quelle nelle sue sottocartelle.

<comment>Return:</comment>
  <info>array</info>  Returns an array of objects containing mailbox information. Each object has the attributes
         <strong>$name</strong>, specifying the full name of the mailbox; <strong>$delimiter</strong>, which is the hierarchy
         delimiter for the part of the hierarchy this mailbox is in; and <strong>$attributes</strong>. <strong>$Attributes</strong> is
         a bitmask that can be tested against: <info>LATT_NOINFERIORS</info> - This mailbox has no "children"
         (there are no mailboxes below this one). <info>LATT_NOSELECT</info> - This is only a container, not a
         mailbox - you cannot open it. <info>LATT_MARKED</info> - This mailbox is marked. Only used by UW-IMAPD.
         <info>LATT_UNMARKED</info> - This mailbox is not marked. Only used by UW-IMAPD. <info>LATT_REFERRAL</info> - This
         container has a referral to a remote mailbox. <info>LATT_HASCHILDREN</info> - This mailbox has
         selectable inferiors. <info>LATT_HASNOCHILDREN</info> - This mailbox has no selectable inferiors.
         
         <info>LATT_NOINFERIORS</info> - This mailbox has no "children" (there are no mailboxes below this one).
         
         <info>LATT_NOSELECT</info> - This is only a container, not a mailbox - you cannot open it.
         
         <info>LATT_MARKED</info> - This mailbox is marked. Only used by UW-IMAPD.
         
         <info>LATT_UNMARKED</info> - This mailbox is not marked. Only used by UW-IMAPD.
         
         <info>LATT_REFERRAL</info> - This container has a referral to a remote mailbox.
         
         <info>LATT_HASCHILDREN</info> - This mailbox has selectable inferiors.
         
         <info>LATT_HASNOCHILDREN</info> - This mailbox has no selectable inferiors.


id: imap_header
type: function
doc:
<comment>Description:</comment>
  Alias di imap_headerinfo
  
  Questa funzione è sinonimo di:  <strong>imap_headerinfo()</strong>.


id: imap_headerinfo
type: function
doc:
<comment>Description:</comment>
  Read the header of the message
  
  Gets information about the given message number by reading its headers.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream  </strong>  Uno stream IMAP restituito da
                          <strong>imap_open()</strong>.
  <info>int   </info>  <strong>$msg_number   </strong>  The message number
  <info>int   </info>  <strong>$fromlength   </strong>  Number of characters for the <return>fetchfrom</return> property. Must be greater than or
                          equal to zero.
  <info>int   </info>  <strong>$subjectlength</strong>  Number of characters for the <return>fetchsubject</return> property Must be greater than or
                          equal to zero.
  <info>string</info>  <strong>$defaulthost  </strong>  

<comment>Return:</comment>
  <info>object</info>  Returns <info>false</info> on error or, if successful, the information in an object with following
          properties:  toaddress - full to: line, up to 1024 characters  to - an array of objects
          from the To: line, with the following  properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>
          fromaddress - full from: line, up to 1024 characters  from - an array of objects from the
          From: line, with the following  properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>  ccaddress -
          full cc: line, up to 1024 characters  cc - an array of objects from the Cc: line, with the
          following  properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>  bccaddress - full bcc: line, up
          to 1024 characters  bcc - an array of objects from the Bcc: line, with the following
          properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>  reply_toaddress - full Reply-To: line, up to
          1024 characters  reply_to - an array of objects from the Reply-To: line, with the
          following properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>  senderaddress - full sender: line,
          up to 1024 characters  sender - an array of objects from the Sender: line, with the
          following  properties: <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>  return_pathaddress - full
          Return-Path: line, up to 1024 characters  return_path - an array of objects from the
          Return-Path: line, with the following properties: <return>personal</return>,  <return>adl</return>, <return>mailbox</return>, and  <return>host</return>
          remail -   date - The message date as found in its headers  Date - Same as date  subject -
          The message subject  Subject - Same as subject   in_reply_to -   message_id -   newsgroups
          -   followup_to -   references -   Recent - <return>R</return> if recent and seen, <return>N</return> if recent and not
          seen, ' ' if not recent.  Unseen - <return>U</return> if not seen AND not recent, ' ' if seen OR not seen
          and recent  Flagged - <return>F</return> if flagged, ' ' if not flagged  Answered - <return>A</return> if answered, ' ' if
          unanswered  Deleted - <return>D</return> if deleted, ' ' if not deleted  Draft - <return>X</return> if draft, ' ' if not
          draft  Msgno - The message number  MailDate -   Size - The message size  udate - mail
          message date in Unix time  fetchfrom - from line formatted to fit <strong>$fromlength</strong> characters
          fetchsubject - subject line formatted to fit  <strong>$subjectlength</strong> characters
          
          toaddress - full to: line, up to 1024 characters
          
          to - an array of objects from the To: line, with the following  properties: <return>personal</return>, <return>adl</return>,
          <return>mailbox</return>, and <return>host</return>
          
          fromaddress - full from: line, up to 1024 characters
          
          from - an array of objects from the From: line, with the following  properties: <return>personal</return>,
          <return>adl</return>, <return>mailbox</return>, and <return>host</return>
          
          ccaddress - full cc: line, up to 1024 characters
          
          cc - an array of objects from the Cc: line, with the following  properties: <return>personal</return>, <return>adl</return>,
          <return>mailbox</return>, and <return>host</return>
          
          bccaddress - full bcc: line, up to 1024 characters
          
          bcc - an array of objects from the Bcc: line, with the following  properties: <return>personal</return>,
          <return>adl</return>, <return>mailbox</return>, and <return>host</return>
          
          reply_toaddress - full Reply-To: line, up to 1024 characters
          
          reply_to - an array of objects from the Reply-To: line, with the following properties:
          <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>
          
          senderaddress - full sender: line, up to 1024 characters
          
          sender - an array of objects from the Sender: line, with the following  properties:
          <return>personal</return>, <return>adl</return>, <return>mailbox</return>, and <return>host</return>
          
          return_pathaddress - full Return-Path: line, up to 1024 characters
          
          return_path - an array of objects from the Return-Path: line, with the following
          properties: <return>personal</return>,  <return>adl</return>, <return>mailbox</return>, and  <return>host</return>
          
          remail -
          
          date - The message date as found in its headers
          
          Date - Same as date
          
          subject - The message subject
          
          Subject - Same as subject
          
          in_reply_to -
          
          message_id -
          
          newsgroups -
          
          followup_to -
          
          references -
          
          Recent - <return>R</return> if recent and seen, <return>N</return> if recent and not seen, ' ' if not recent.
          
          Unseen - <return>U</return> if not seen AND not recent, ' ' if seen OR not seen and recent
          
          Flagged - <return>F</return> if flagged, ' ' if not flagged
          
          Answered - <return>A</return> if answered, ' ' if unanswered
          
          Deleted - <return>D</return> if deleted, ' ' if not deleted
          
          Draft - <return>X</return> if draft, ' ' if not draft
          
          Msgno - The message number
          
          MailDate -
          
          Size - The message size
          
          udate - mail message date in Unix time
          
          fetchfrom - from line formatted to fit <strong>$fromlength</strong> characters
          
          fetchsubject - subject line formatted to fit  <strong>$subjectlength</strong> characters

<comment>See Also:</comment>
   * <strong>imap_fetch_overview()</strong>


id: imap_headers
type: function
doc:
<comment>Description:</comment>
  Returns headers for all messages in a mailbox
  
  Returns headers for all messages in a mailbox.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>array</info>  Returns an array of string formatted with header info. One element per mail message.


id: imap_last_error
type: function
doc:
<comment>Description:</comment>
  Gets the last IMAP error that occurred during this page request
  
  Gets the full text of the last IMAP error message that occurred on the current page. The error
  stack is untouched; calling  <strong>imap_last_error()</strong> subsequently, with no intervening errors, will
  return the same error.

<comment>Return:</comment>
  <info>string</info>  Returns the full text of the last IMAP error message that occurred on the current page.
          Returns <info>false</info> if no error messages are available.

<comment>See Also:</comment>
   * <strong>imap_errors()</strong>


id: imap_list
type: function
doc:
<comment>Description:</comment>
  Read the list of mailboxes
  
  Read the list of mailboxes.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$ref        </strong>  <strong>$ref</strong> should normally be just the server specification as described in
                        <strong>imap_open()</strong>.
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$pattern    </strong>  Specifica da dove, nella gerarchia della mailbox,
                        cominciare a cercare.
                        
                        Ci sono due caratteri speciali che si possono
                        passare all'interno di <strong>$pattern</strong>:
                        '<return>*</return>' e '<return>%</return>'.
                        '<return>*</return>' restituisce tutte le mailbox. Se si passa
                        '<return>*</return>' in <strong>$pattern</strong>, verrà
                        restituito un elenco du tutta le gerarchia della mailbox.
                        '<return>%</return>'
                        corrisponde al solo livello attuale.
                        '<return>%</return>' nel parametro <strong>$pattern</strong>
                        restituirà solo le mailbox del livello
                        superiore; '<return>~/mail/%</return>' in <return>UW_IMAPD</return> restituirà ogni mailbox nella cartella
                        ~/mail, ma non quelle nelle sue sottocartelle.

<comment>Return:</comment>
  <info>array</info>  Returns an array containing the names of the mailboxes or false in case of failure.

<comment>See Also:</comment>
   * <strong>imap_getmailboxes()</strong>
   * <strong>imap_lsub()</strong>


id: imap_listmailbox
type: function
doc:
<comment>Description:</comment>
  Alias di imap_list
  
  Questa funzione è sinonimo di:  <strong>imap_list()</strong>.


id: imap_listscan
type: function
doc:
<comment>Description:</comment>
  Returns the list of mailboxes that matches the given text
  
  Returns an array containing the names of the mailboxes that have <strong>$content</strong> in the text of the
  mailbox.
  
  This function is similar to <strong>imap_listmailbox()</strong>, but it will additionally check for the presence of
  the string <strong>$content</strong> inside the mailbox data.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$ref        </strong>  <strong>$ref</strong> should normally be just the server  specification as described in
                        <strong>imap_open()</strong>
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$pattern    </strong>  Specifica da dove, nella gerarchia della mailbox,
                        cominciare a cercare.
                        
                        Ci sono due caratteri speciali che si possono
                        passare all'interno di <strong>$pattern</strong>:
                        '<return>*</return>' e '<return>%</return>'.
                        '<return>*</return>' restituisce tutte le mailbox. Se si passa
                        '<return>*</return>' in <strong>$pattern</strong>, verrà
                        restituito un elenco du tutta le gerarchia della mailbox.
                        '<return>%</return>'
                        corrisponde al solo livello attuale.
                        '<return>%</return>' nel parametro <strong>$pattern</strong>
                        restituirà solo le mailbox del livello
                        superiore; '<return>~/mail/%</return>' in <return>UW_IMAPD</return> restituirà ogni mailbox nella cartella
                        ~/mail, ma non quelle nelle sue sottocartelle.
  <info>string</info>  <strong>$content    </strong>  The searched string

<comment>Return:</comment>
  <info>array</info>  Returns an array containing the names of the mailboxes that have <strong>$content</strong> in the text of
         the mailbox.

<comment>See Also:</comment>
   * <strong>imap_listmailbox()</strong>
   * <strong>imap_search()</strong>


id: imap_listsubscribed
type: function
doc:
<comment>Description:</comment>
  Alias di imap_lsub
  
  Questa funzione è sinonimo di:  <strong>imap_lsub()</strong>.


id: imap_lsub
type: function
doc:
<comment>Description:</comment>
  List all the subscribed mailboxes
  
  Gets an array of all the mailboxes that you have subscribed.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$ref        </strong>  <strong>$ref</strong> should normally be just the server  specification as described in
                        <strong>imap_open()</strong>
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$pattern    </strong>  Specifica da dove, nella gerarchia della mailbox,
                        cominciare a cercare.
                        
                        Ci sono due caratteri speciali che si possono
                        passare all'interno di <strong>$pattern</strong>:
                        '<return>*</return>' e '<return>%</return>'.
                        '<return>*</return>' restituisce tutte le mailbox. Se si passa
                        '<return>*</return>' in <strong>$pattern</strong>, verrà
                        restituito un elenco du tutta le gerarchia della mailbox.
                        '<return>%</return>'
                        corrisponde al solo livello attuale.
                        '<return>%</return>' nel parametro <strong>$pattern</strong>
                        restituirà solo le mailbox del livello
                        superiore; '<return>~/mail/%</return>' in <return>UW_IMAPD</return> restituirà ogni mailbox nella cartella
                        ~/mail, ma non quelle nelle sue sottocartelle.

<comment>Return:</comment>
  <info>array</info>  Returns an array of all the subscribed mailboxes.

<comment>See Also:</comment>
   * <strong>imap_list()</strong>
   * <strong>imap_getmailboxes()</strong>


id: imap_mail
type: function
doc:
<comment>Description:</comment>
  Send an email message
  
  This function allows sending of emails with correct handling of Cc and Bcc receivers.
  
  The parameters <strong>$to</strong>, <strong>$cc</strong> and <strong>$bcc</strong> are all strings and are all parsed as RFC822 address lists.

<comment>Param:</comment>
  <info>string</info>  <strong>$to                </strong>  The receiver
  <info>string</info>  <strong>$subject           </strong>  The mail subject
  <info>string</info>  <strong>$message           </strong>  The mail body, see <strong>imap_mail_compose()</strong>
  <info>string</info>  <strong>$additional_headers</strong>  As string with additional headers to be set on the mail
  <info>string</info>  <strong>$cc                </strong>  
  <info>string</info>  <strong>$bcc               </strong>  The receivers specified in <strong>$bcc</strong> will get the mail, but are excluded
                               from the headers.
  <info>string</info>  <strong>$rpath             </strong>  Use this parameter to specify return path upon mail delivery failure.
                               This is useful when using PHP as a mail client for multiple users.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>mail()</strong>
   * <strong>imap_mail_compose()</strong>


id: imap_mail_compose
type: function
doc:
<comment>Description:</comment>
  Create a MIME message based on given envelope and body sections
  
  Create a MIME message based on the given <strong>$envelope</strong> and <strong>$body</strong> sections.

<comment>Param:</comment>
  <info>array</info>  <strong>$envelope</strong>  An associative array of header fields. Valid keys are: <return>"remail"</return>, <return>"return_path"</return>,
                    <return>"date"</return>, <return>"from"</return>, <return>"reply_to"</return>, <return>"in_reply_to"</return>, <return>"subject"</return>, <return>"to"</return>, <return>"cc"</return>, <return>"bcc"</return> and
                    <return>"message_id"</return>, which set the respective message headers to the given <info>string</info>. To
                    set additional headers, the key <return>"custom_headers"</return> is supported, which expects an
                    array of those headers, e.g. ["User-Agent: My Mail Client"].
  <info>array</info>  <strong>$body    </strong>  An indexed array of bodies. The first body is the main body of the message; only
                    if it has a type of <info>TYPEMULTIPART</info>, further bodies are processed; these bodies
                    constitute the bodies of the parts.
                    
                    Body Array StructureKeyTypeDescription<return>type</return><info>int</info> The MIME type. One of <info>TYPETEXT</info>
                    (default), <info>TYPEMULTIPART</info>, <info>TYPEMESSAGE</info>, <info>TYPEAPPLICATION</info>, <info>TYPEAUDIO</info>, <info>TYPEIMAGE</info>,
                    <info>TYPEMODEL</info> or <info>TYPEOTHER</info>. <return>encoding</return><info>int</info> The <return>Content-Transfer-Encoding</return>. One of
                    <info>ENC7BIT</info> (default), <info>ENC8BIT</info>, <info>ENCBINARY</info>, <info>ENCBASE64</info>, <info>ENCQUOTEDPRINTABLE</info> or
                    <info>ENCOTHER</info>. <return>charset</return><info>string</info>The charset parameter of the MIME
                    type.<return>type.parameters</return><info>array</info>An associative <info>array</info> of <return>Content-Type</return> parameter names
                    and their values.<return>subtype</return><info>string</info>The MIME subtype, e.g. <return>'jpeg'</return> for
                    <info>TYPEIMAGE</info>.<return>id</return><info>string</info>The <return>Content-ID</return>.<return>description</return><info>string</info>The
                    <return>Content-Description</return>.<return>disposition.type</return><info>string</info>The <return>Content-Disposition</return>, e.g.
                    <return>'attachment'</return>.<return>disposition</return><info>array</info>An associative <info>array</info> of <return>Content-Disposition</return>
                    parameter names and values.<return>contents.data</return><info>string</info>The payload.<return>lines</return><info>int</info>The size of
                    the payload in lines.<return>bytes</return><info>int</info>The size of the payload in bytes.<return>md5</return><info>string</info>The MD5
                    checksum of the payload.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the MIME message as <info>string</info>,  o <info>false</info> in caso di fallimento.


id: imap_mail_copy
type: function
doc:
<comment>Description:</comment>
  Copy specified messages to a mailbox
  
  Copies mail messages specified by <strong>$msglist</strong> to specified mailbox.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$msglist    </strong>  <strong>$msglist</strong> is a range not just message numbers (as described in RFC2060).
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>int   </info>  <strong>$options    </strong>  <strong>$options</strong> is a bitmask of one or more of <info>CP_UID</info> - the sequence numbers
                        contain UIDS <info>CP_MOVE</info> - Delete the messages from the current mailbox after
                        copying
                        
                        <info>CP_UID</info> - the sequence numbers contain UIDS
                        
                        <info>CP_MOVE</info> - Delete the messages from the current mailbox after copying

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_mail_move()</strong>


id: imap_mail_move
type: function
doc:
<comment>Description:</comment>
  Move specified messages to a mailbox
  
  Moves mail messages specified by <strong>$msglist</strong> to the specified <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$msglist    </strong>  <strong>$msglist</strong> is a range not just message numbers (as described in RFC2060).
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>int   </info>  <strong>$options    </strong>  <strong>$options</strong> is a bitmask and may contain the single option: <info>CP_UID</info> - the
                        sequence numbers contain UIDS
                        
                        <info>CP_UID</info> - the sequence numbers contain UIDS

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_mail_copy()</strong>


id: imap_mailboxmsginfo
type: function
doc:
<comment>Description:</comment>
  Get information about the current mailbox
  
  Checks the current mailbox status on the server. It is similar to <strong>imap_status()</strong>, but will
  additionally sum up the size of all messages in the mailbox, which will take some additional time
  to  execute.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>object</info>  Returns the information in an object with following properties: Mailbox propertiesDatedate
          of last change (current datetime)DriverdriverMailboxname of the mailboxNmsgsnumber of
          messagesRecentnumber of recent messagesUnreadnumber of unread messagesDeletednumber of
          deleted messagesSizemailbox size
          
          Returns <info>false</info> on failure.


id: imap_mime_header_decode
type: function
doc:
<comment>Description:</comment>
  Decode MIME header elements
  
  Decodes MIME message header extensions that are non ASCII text (see RFC2047).

<comment>Param:</comment>
  <info>string</info>  <strong>$text</strong>  The MIME text

<comment>Return:</comment>
  <info>array</info>  The decoded elements are returned in an array of objects, where each object has two
         properties, <return>charset</return> and  <return>text</return>.
         
         If the element hasn't been encoded, and in other words is in plain US-ASCII, the <return>charset</return>
         property of that element is set to <return>default</return>.

<comment>See Also:</comment>
   * <strong>imap_utf8()</strong>


id: imap_msgno
type: function
doc:
<comment>Description:</comment>
  Gets the message sequence number for the given UID
  
  Returns the message sequence number for the given  <strong>$uid</strong>.
  
  This function is the inverse of <strong>imap_uid()</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$uid        </strong>  The message UID

<comment>Return:</comment>
  <info>int</info>  Returns the message sequence number for the given  <strong>$uid</strong>.

<comment>See Also:</comment>
   * <strong>imap_uid()</strong>


id: imap_mutf7_to_utf8
type: function
doc:
<comment>Description:</comment>
  Decode a modified UTF-7 string to UTF-8
  
  Decode a modified UTF-7 (as specified in RFC 2060, section 5.1.3) string to UTF-8.
  
  This function is only available, if libcclient exports utf8_to_mutf7().

<comment>Param:</comment>
  <info>string</info>  <strong>$in</strong>  A string encoded in modified UTF-7.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns <strong>$in</strong> converted to UTF-8, o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_utf8_to_mutf7()</strong>


id: imap_num_msg
type: function
doc:
<comment>Description:</comment>
  Gets the number of messages in the current mailbox
  
  Gets the number of messages in the current mailbox.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>int</info>  Return the number of messages in the current mailbox, as an integer, or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>imap_num_recent()</strong>
   * <strong>imap_status()</strong>


id: imap_num_recent
type: function
doc:
<comment>Description:</comment>
  Gets the number of recent messages in current mailbox
  
  Gets the number of recent messages in the current mailbox.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of recent messages in the current mailbox, as an integer.

<comment>See Also:</comment>
   * <strong>imap_num_msg()</strong>
   * <strong>imap_status()</strong>


id: imap_open
type: function
doc:
<comment>Description:</comment>
  Open an IMAP stream to a mailbox
  
  Opens an IMAP stream to a <strong>$mailbox</strong>.
  
  This function can also be used to open streams to POP3 and NNTP servers, but some functions and
  features are only available on IMAP servers.

<comment>Param:</comment>
  <info>string</info>  <strong>$mailbox  </strong>  A mailbox name consists of a server and a mailbox path on this server. The
                      special name <return>INBOX</return> stands for the current users personal mailbox. Mailbox
                      names that contain international characters besides those in the printable
                      ASCII space have to be encoded with <strong>imap_utf7_encode()</strong>.
                      
                      Passing untrusted data to this parameter is insecure, unless
                      imap.enable_insecure_rsh is disabled.
                      
                      The server part, which is enclosed in '{' and '}', consists of the servers
                      name or ip address, an optional port (prefixed by ':'), and an optional
                      protocol specification (prefixed by '/').
                      
                      The server part is mandatory in all mailbox parameters.
                      
                      All names which start with <return>{</return> are remote names, and are in the form <return>"{"
                      remote_system_name [":" port] [flags] "}" [mailbox_name]</return> where:
                      <return>remote_system_name</return> - Internet domain name or bracketed IP address of server.
                      <return>port</return> - optional TCP port number, default is the default port for that service
                      <return>flags</return> - optional flags, see following table. <return>mailbox_name</return> - remote mailbox
                      name, default is INBOX
                      
                      <return>remote_system_name</return> - Internet domain name or bracketed IP address of server.
                      
                      <return>port</return> - optional TCP port number, default is the default port for that service
                      
                      <return>flags</return> - optional flags, see following table.
                      
                      <return>mailbox_name</return> - remote mailbox name, default is INBOX
                      
                      Optional flags for namesFlagDescription<return>/service=</return>servicemailbox access service,
                      default is "imap"<return>/user=</return>userremote user name for login on the
                      server<return>/authuser=</return>userremote authentication user; if specified this is the user
                      name whose password is used (e.g. administrator)<return>/anonymous</return>remote access as
                      anonymous user<return>/debug</return>record protocol telemetry in application's debug
                      log<return>/secure</return>do not transmit a plaintext password over the network<return>/imap</return>, <return>/imap2</return>,
                      <return>/imap2bis</return>, <return>/imap4</return>, <return>/imap4rev1</return>equivalent to <return>/service=imap</return><return>/pop3</return>equivalent to
                      <return>/service=pop3</return><return>/nntp</return>equivalent to <return>/service=nntp</return><return>/norsh</return>do not use rsh or ssh to
                      establish a preauthenticated IMAP session<return>/ssl</return>use the <return>Secure Socket Layer</return> to
                      encrypt the session<return>/validate-cert</return>validate certificates from TLS/SSL server
                      (this is the default behavior)<return>/novalidate-cert</return>do not validate certificates
                      from TLS/SSL server, needed if server uses self-signed certificates<return>/tls</return>force
                      use of <return>start-TLS</return> to encrypt the session, and reject connection to servers that
                      do not support it<return>/notls</return>do not do <return>start-TLS</return> to encrypt the session, even with
                      servers that support it<return>/readonly</return>request read-only mailbox open (IMAP only;
                      ignored on NNTP, and an error with SMTP and POP3)
  <info>string</info>  <strong>$username </strong>  The user name
  <info>string</info>  <strong>$password </strong>  The password associated with the <strong>$username</strong>
  <info>int   </info>  <strong>$options  </strong>  The <strong>$options</strong> are a bit mask with one or more of the following: <info>OP_READONLY</info> -
                      Open mailbox read-only <info>OP_ANONYMOUS</info> - Don't use or update a .newsrc for news
                      (NNTP only) <info>OP_HALFOPEN</info> - For IMAP and NNTP names, open a connection but don't
                      open a mailbox. <info>CL_EXPUNGE</info> - Expunge mailbox automatically upon mailbox close
                      (see also <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>) <info>OP_DEBUG</info> - Debug protocol
                      negotiations <info>OP_SHORTCACHE</info> - Short (<return>elt</return>-only) caching <info>OP_SILENT</info> - Don't pass
                      up events (internal use) <info>OP_PROTOTYPE</info> - Return driver prototype <info>OP_SECURE</info> -
                      Don't do non-secure authentication
                      
                      <info>OP_READONLY</info> - Open mailbox read-only
                      
                      <info>OP_ANONYMOUS</info> - Don't use or update a .newsrc for news (NNTP only)
                      
                      <info>OP_HALFOPEN</info> - For IMAP and NNTP names, open a connection but don't open a
                      mailbox.
                      
                      <info>CL_EXPUNGE</info> - Expunge mailbox automatically upon mailbox close (see also
                      <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>)
                      
                      <info>OP_DEBUG</info> - Debug protocol negotiations
                      
                      <info>OP_SHORTCACHE</info> - Short (<return>elt</return>-only) caching
                      
                      <info>OP_SILENT</info> - Don't pass up events (internal use)
                      
                      <info>OP_PROTOTYPE</info> - Return driver prototype
                      
                      <info>OP_SECURE</info> - Don't do non-secure authentication
  <info>int   </info>  <strong>$n_retries</strong>  Number of maximum connect attempts
  <info>array </info>  <strong>$params   </strong>  Connection parameters, the following (string) keys maybe used  to set one or
                      more connection parameters: <return>DISABLE_AUTHENTICATOR</return> - Disable authentication
                      properties
                      
                      <return>DISABLE_AUTHENTICATOR</return> - Disable authentication properties

<comment>Return:</comment>
  <info>resource</info>  Returns an IMAP stream on success or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>imap_close()</strong>


id: imap_ping
type: function
doc:
<comment>Description:</comment>
  Check if the IMAP stream is still active
  
  <strong>imap_ping()</strong> pings the stream to see if it's still active. It may discover new mail; this is the
  preferred method for a periodic "new mail check" as well as a "keep alive" for servers which have
  inactivity timeout.

<comment>Param:</comment>
  <info></info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                  <strong>imap_open()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the stream is still alive, <info>false</info> otherwise.


id: imap_qprint
type: function
doc:
<comment>Description:</comment>
  Convert a quoted-printable string to an 8 bit string
  
  Convert a quoted-printable string to an 8 bit string according to RFC2045, section 6.7.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  A quoted-printable string

<comment>Return:</comment>
  <info>string</info>  Returns an 8 bits string.

<comment>See Also:</comment>
   * <strong>imap_8bit()</strong>


id: imap_rename
type: function
doc:
<comment>Description:</comment>
  Alias di imap_renamemailbox
  
  Questa funzione è sinonimo di:  <strong>imap_renamemailbox()</strong>.


id: imap_renamemailbox
type: function
doc:
<comment>Description:</comment>
  Rename an old mailbox to new mailbox
  
  This function renames on old mailbox to new mailbox (see <strong>imap_open()</strong> for the format of <strong>$mbox</strong>
  names).

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$old_mbox   </strong>  The old mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$new_mbox   </strong>  The new mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_createmailbox()</strong>
   * <strong>imap_deletemailbox()</strong>


id: imap_reopen
type: function
doc:
<comment>Description:</comment>
  Reopen IMAP stream to new mailbox
  
  Reopens the specified stream to a new <strong>$mailbox</strong> on an IMAP or NNTP server.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>int   </info>  <strong>$options    </strong>  The <strong>$options</strong> are a bit mask with one or more of the following: <info>OP_READONLY</info> -
                        Open mailbox read-only <info>OP_ANONYMOUS</info> - Don't use or update a .newsrc for news
                        (NNTP only) <info>OP_HALFOPEN</info> - For IMAP and NNTP names, open a connection but
                        don't open a mailbox. <info>OP_EXPUNGE</info> - Silently expunge recycle stream
                        <info>CL_EXPUNGE</info> - Expunge mailbox automatically upon mailbox close (see also
                        <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>)
                        
                        <info>OP_READONLY</info> - Open mailbox read-only
                        
                        <info>OP_ANONYMOUS</info> - Don't use or update a .newsrc for news (NNTP only)
                        
                        <info>OP_HALFOPEN</info> - For IMAP and NNTP names, open a connection but don't open a
                        mailbox.
                        
                        <info>OP_EXPUNGE</info> - Silently expunge recycle stream
                        
                        <info>CL_EXPUNGE</info> - Expunge mailbox automatically upon mailbox close (see also
                        <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>)
  <info>int   </info>  <strong>$n_retries  </strong>  Number of maximum connect attempts

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the stream is reopened, <info>false</info> otherwise.


id: imap_rfc822_parse_adrlist
type: function
doc:
<comment>Description:</comment>
  Parses an address string
  
  Parses the address string as defined in RFC2822 and for each address.

<comment>Param:</comment>
  <info>string</info>  <strong>$address     </strong>  A string containing addresses
  <info>string</info>  <strong>$default_host</strong>  The default host name

<comment>Return:</comment>
  <info>array</info>  Returns an array of objects. The objects properties are:
         
          mailbox  - the mailbox name (username)  host - the host name  personal - the personal name
         adl - at domain source route
         
         mailbox  - the mailbox name (username)
         
         host - the host name
         
         personal - the personal name
         
         adl - at domain source route

<comment>See Also:</comment>
   * <strong>imap_rfc822_parse_headers()</strong>


id: imap_rfc822_parse_headers
type: function
doc:
<comment>Description:</comment>
  Parse mail headers from a string
  
  Gets an object of various header elements, similar to  <strong>imap_header()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$headers    </strong>  The parsed headers data
  <info>string</info>  <strong>$defaulthost</strong>  The default host name

<comment>Return:</comment>
  <info>object</info>  Returns an object similar to the one returned by <strong>imap_header()</strong>, except for the flags and
          other  properties that come from the IMAP server.

<comment>See Also:</comment>
   * <strong>imap_rfc822_parse_adrlist()</strong>


id: imap_rfc822_write_address
type: function
doc:
<comment>Description:</comment>
  Returns a properly formatted email address given the mailbox, host, and personal info
  
  Returns a properly formatted email address as defined in RFC2822 given the needed information.

<comment>Param:</comment>
  <info>string</info>  <strong>$mailbox </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                     
                     Passing untrusted data to this parameter is insecure, unless
                     imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$host    </strong>  The email host part
  <info>string</info>  <strong>$personal</strong>  The name of the account owner

<comment>Return:</comment>
  <info>string</info>  Returns a string properly formatted email address as defined in RFC2822.


id: imap_savebody
type: function
doc:
<comment>Description:</comment>
  Save a specific body section to a file
  
  Saves a part or the whole body of the specified message.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>mixed </info>  <strong>$file       </strong>  The path to the saved file as a string, or a valid file descriptor returned
                        by <strong>fopen()</strong>.
  <info>int   </info>  <strong>$msg_number </strong>  The message number
  <info>string</info>  <strong>$part_number</strong>  The part number. It is a string of integers delimited by period which index
                        into a body part list as per the IMAP4 specification
  <info>int   </info>  <strong>$options    </strong>  A bitmask with one or more of the following: <info>FT_UID</info> - The <strong>$msg_number</strong> is a
                        UID <info>FT_PEEK</info> - Do not set the \Seen flag if not already set <info>FT_INTERNAL</info> - The
                        return string is in internal format, will not canonicalize to CRLF.
                        
                        <info>FT_UID</info> - The <strong>$msg_number</strong> is a UID
                        
                        <info>FT_PEEK</info> - Do not set the \Seen flag if not already set
                        
                        <info>FT_INTERNAL</info> - The return string is in internal format, will not canonicalize
                        to CRLF.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>


id: imap_scan
type: function
doc:
<comment>Description:</comment>
  Alias di imap_listscan
  
  Questa funzione è sinonimo di:  <strong>imap_listscan()</strong>.


id: imap_search
type: function
doc:
<comment>Description:</comment>
  This function returns an array of messages matching the given search criteria
  
  This function performs a search on the mailbox currently opened in the given IMAP stream.
  
  For example, to match all unanswered messages sent by Mom, you'd use: "UNANSWERED FROM mom".
  Searches appear to be case insensitive. This list of criteria is from a reading of the UW c-client
  source code and may be incomplete or inaccurate (see also RFC1176,  section "tag SEARCH
  search_criteria").

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$criteria   </strong>  A string, delimited by spaces, in which the following keywords are allowed.
                        Any multi-word arguments (e.g. <return>FROM "joey smith"</return>) must be quoted. Results
                        will match all <strong>$criteria</strong> entries.  ALL - return all messages matching the
                        rest of the criteria  ANSWERED - match messages with the \\ANSWERED flag set
                        BCC "string" - match messages with "string" in the Bcc: field  BEFORE "date"
                        - match messages with Date: before "date"  BODY "string" - match messages
                        with "string" in the body of the message  CC "string" - match messages with
                        "string" in the Cc: field  DELETED - match deleted messages  FLAGGED - match
                        messages with the \\FLAGGED (sometimes referred to as Important or Urgent)
                        flag set  FROM "string" - match messages with "string" in the From: field
                        KEYWORD "string" - match messages with "string" as a keyword  NEW - match
                        new messages  OLD - match old messages  ON "date" - match messages with
                        Date: matching "date"  RECENT - match messages with the \\RECENT flag set
                        SEEN - match messages that have been read (the \\SEEN flag is set)  SINCE
                        "date" - match messages with Date: after "date"  SUBJECT "string" - match
                        messages with "string" in the Subject:  TEXT "string" - match messages with
                        text "string"  TO "string" - match messages with "string" in the To:
                        UNANSWERED - match messages that have not been answered  UNDELETED - match
                        messages that are not deleted  UNFLAGGED - match messages that are not
                        flagged  UNKEYWORD "string" - match messages that do not have the keyword
                        "string"  UNSEEN - match messages which have not been read yet
                        
                        ALL - return all messages matching the rest of the criteria
                        
                        ANSWERED - match messages with the \\ANSWERED flag set
                        
                        BCC "string" - match messages with "string" in the Bcc: field
                        
                        BEFORE "date" - match messages with Date: before "date"
                        
                        BODY "string" - match messages with "string" in the body of the message
                        
                        CC "string" - match messages with "string" in the Cc: field
                        
                        DELETED - match deleted messages
                        
                        FLAGGED - match messages with the \\FLAGGED (sometimes referred to as
                        Important or Urgent) flag set
                        
                        FROM "string" - match messages with "string" in the From: field
                        
                        KEYWORD "string" - match messages with "string" as a keyword
                        
                        NEW - match new messages
                        
                        OLD - match old messages
                        
                        ON "date" - match messages with Date: matching "date"
                        
                        RECENT - match messages with the \\RECENT flag set
                        
                        SEEN - match messages that have been read (the \\SEEN flag is set)
                        
                        SINCE "date" - match messages with Date: after "date"
                        
                        SUBJECT "string" - match messages with "string" in the Subject:
                        
                        TEXT "string" - match messages with text "string"
                        
                        TO "string" - match messages with "string" in the To:
                        
                        UNANSWERED - match messages that have not been answered
                        
                        UNDELETED - match messages that are not deleted
                        
                        UNFLAGGED - match messages that are not flagged
                        
                        UNKEYWORD "string" - match messages that do not have the keyword "string"
                        
                        UNSEEN - match messages which have not been read yet
  <info>int   </info>  <strong>$options    </strong>  Valid values for <strong>$options</strong> are  <info>SE_UID</info>, which causes the returned array to
                        contain UIDs instead of messages sequence numbers.
  <info>string</info>  <strong>$charset    </strong>  MIME character set to use when searching strings.

<comment>Return:</comment>
  <info>array</info>  Returns an array of message numbers or UIDs.
         
         Return <info>false</info> if it does not understand the search <strong>$criteria</strong> or no messages have been found.

<comment>See Also:</comment>
   * <strong>imap_listscan()</strong>


id: imap_set_quota
type: function
doc:
<comment>Description:</comment>
  Sets a quota for a given mailbox
  
  Sets an upper limit quota on a per mailbox basis.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$quota_root </strong>  The mailbox to have a quota set. This should follow the IMAP standard format
                        for a mailbox: <return>user.name</return>.
  <info>int   </info>  <strong>$quota_limit</strong>  The maximum size (in KB) for the <strong>$quota_root</strong>

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_get_quota()</strong>


id: imap_setacl
type: function
doc:
<comment>Description:</comment>
  Sets the ACL for a given mailbox
  
  Sets the ACL for a giving mailbox.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>string</info>  <strong>$id         </strong>  The user to give the rights to.
  <info>string</info>  <strong>$rights     </strong>  The rights to give to the user. Passing an empty string will delete acl.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_getacl()</strong>


id: imap_setflag_full
type: function
doc:
<comment>Description:</comment>
  Sets flags on messages
  
  Causes a store to add the specified <strong>$flag</strong> to the flags set for the messages in the specified
  <strong>$sequence</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$sequence   </strong>  A sequence of message numbers. You can enumerate desired messages with the
                        <return>X,Y</return> syntax, or retrieve all messages  within an interval with the <return>X:Y</return> syntax
  <info>string</info>  <strong>$flag       </strong>  The flags which you can set are <return>\Seen</return>,  <return>\Answered</return>, <return>\Flagged</return>, <return>\Deleted</return>, and
                        <return>\Draft</return> as defined by RFC2060.
  <info>int   </info>  <strong>$options    </strong>  A bit mask that may contain the single option: <info>ST_UID</info> - The sequence
                        argument contains UIDs instead of sequence numbers
                        
                        <info>ST_UID</info> - The sequence argument contains UIDs instead of sequence numbers

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_clearflag_full()</strong>


id: imap_sort
type: function
doc:
<comment>Description:</comment>
  Gets and sort messages
  
  Gets and sorts message numbers by the given parameters.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream    </strong>  Uno stream IMAP restituito da
                            <strong>imap_open()</strong>.
  <info>int   </info>  <strong>$criteria       </strong>  Criteria can be one (and only one) of the following: <info>SORTDATE</info> - message
                            Date <info>SORTARRIVAL</info> - arrival date <info>SORTFROM</info> - mailbox in first From address
                            <info>SORTSUBJECT</info> - message subject <info>SORTTO</info> - mailbox in first To address
                            <info>SORTCC</info> - mailbox in first cc address <info>SORTSIZE</info> - size of message in
                            octets
                            
                            <info>SORTDATE</info> - message Date
                            
                            <info>SORTARRIVAL</info> - arrival date
                            
                            <info>SORTFROM</info> - mailbox in first From address
                            
                            <info>SORTSUBJECT</info> - message subject
                            
                            <info>SORTTO</info> - mailbox in first To address
                            
                            <info>SORTCC</info> - mailbox in first cc address
                            
                            <info>SORTSIZE</info> - size of message in octets
  <info>int   </info>  <strong>$reverse        </strong>  Set this to 1 for reverse sorting
  <info>int   </info>  <strong>$options        </strong>  The <strong>$options</strong> are a bitmask of one or more of the following: <info>SE_UID</info> -
                            Return UIDs instead of sequence numbers <info>SE_NOPREFETCH</info> - Don't prefetch
                            searched messages
                            
                            <info>SE_UID</info> - Return UIDs instead of sequence numbers
                            
                            <info>SE_NOPREFETCH</info> - Don't prefetch searched messages
  <info>string</info>  <strong>$search_criteria</strong>  IMAP2-format search criteria string. For details see <strong>imap_search()</strong>.
  <info>string</info>  <strong>$charset        </strong>  MIME character set to use when sorting strings.

<comment>Return:</comment>
  <info>arrayfalse</info>  Returns an array of message numbers sorted by the given parameters,  o <info>false</info> in caso
              di fallimento.


id: imap_status
type: function
doc:
<comment>Description:</comment>
  Returns status information on a mailbox
  
  Gets status information about the given <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.
  <info>int   </info>  <strong>$options    </strong>  Valid flags are: <info>SA_MESSAGES</info> - set $status-&gt;messages to the number of
                        messages in the mailbox <info>SA_RECENT</info> - set $status-&gt;recent to the number of
                        recent messages in the mailbox <info>SA_UNSEEN</info> - set $status-&gt;unseen to the
                        number of unseen (new) messages in the mailbox <info>SA_UIDNEXT</info> - set
                        $status-&gt;uidnext to the next uid to be used in the mailbox <info>SA_UIDVALIDITY</info>
                        - set $status-&gt;uidvalidity to a constant that changes when uids for the
                        mailbox may no longer be valid <info>SA_ALL</info> - set all of the above
                        
                        <info>SA_MESSAGES</info> - set $status-&gt;messages to the number of messages in the
                        mailbox
                        
                        <info>SA_RECENT</info> - set $status-&gt;recent to the number of recent messages in the
                        mailbox
                        
                        <info>SA_UNSEEN</info> - set $status-&gt;unseen to the number of unseen (new) messages in
                        the mailbox
                        
                        <info>SA_UIDNEXT</info> - set $status-&gt;uidnext to the next uid to be used in the
                        mailbox
                        
                        <info>SA_UIDVALIDITY</info> - set $status-&gt;uidvalidity to a constant that changes when
                        uids for the mailbox may no longer be valid
                        
                        <info>SA_ALL</info> - set all of the above

<comment>Return:</comment>
  <info>object</info>  This function returns an object containing status information. The object has the
          following properties: <return>messages</return>, <return>recent</return>, <return>unseen</return>,  <return>uidnext</return>, and <return>uidvalidity</return>.
          
          <return>flags</return> is also set, which contains a bitmask which can be checked against any of the above
          constants.


id: imap_subscribe
type: function
doc:
<comment>Description:</comment>
  Subscribe to a mailbox
  
  Subscribe to a new mailbox.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_unsubscribe()</strong>


id: imap_thread
type: function
doc:
<comment>Description:</comment>
  Returns a tree of threaded message
  
  Gets a tree of a threaded message.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$options    </strong>  

<comment>Return:</comment>
  <info>array</info>  <strong>imap_thread()</strong> returns an associative array containing a tree of messages threaded by
         <return>REFERENCES</return>, or <info>false</info> on error.
         
         Every message in the current mailbox will be represented by three entries in the resulting
         array: $thread["XX.num"] - current message number $thread["XX.next"]$thread["XX.branch"]
         
         $thread["XX.num"] - current message number
         
         $thread["XX.next"]
         
         $thread["XX.branch"]


id: imap_timeout
type: function
doc:
<comment>Description:</comment>
  Set or fetch imap timeout
  
  Sets or fetches the imap timeout.

<comment>Param:</comment>
  <info>int</info>  <strong>$timeout_type</strong>  One of the following: <info>IMAP_OPENTIMEOUT</info>, <info>IMAP_READTIMEOUT</info>, <info>IMAP_WRITETIMEOUT</info>,
                      or <info>IMAP_CLOSETIMEOUT</info>.
  <info>int</info>  <strong>$timeout     </strong>  The timeout, in seconds.

<comment>Return:</comment>
  <info>mixed</info>  If the <strong>$timeout</strong> parameter is set, this function returns <info>true</info> on success and <info>false</info> on
         failure.
         
         If <strong>$timeout</strong>  is not provided or evaluates to -1, the current timeout value of <strong>$timeout_type</strong>
         is returned as an integer.


id: imap_uid
type: function
doc:
<comment>Description:</comment>
  This function returns the UID for the given message sequence number
  
  This function returns the UID for the given message sequence number. An UID is a unique identifier
  that will not change over time while a message sequence number may change whenever the content of
  the mailbox changes.
  
  This function is the inverse of <strong>imap_msgno()</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number.

<comment>Return:</comment>
  <info>int</info>  The UID of the given message.

<comment>See Also:</comment>
   * <strong>imap_msgno()</strong>


id: imap_undelete
type: function
doc:
<comment>Description:</comment>
  Unmark the message which is marked deleted
  
  Removes the deletion flag for a specified message, which is set by <strong>imap_delete()</strong> or
  <strong>imap_mail_move()</strong>.

<comment>Param:</comment>
  <info>   </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                     <strong>imap_open()</strong>.
  <info>int</info>  <strong>$msg_number </strong>  The message number
  <info>int</info>  <strong>$flags      </strong>  

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_delete()</strong>
   * <strong>imap_mail_move()</strong>


id: imap_unsubscribe
type: function
doc:
<comment>Description:</comment>
  Unsubscribe from a mailbox
  
  Unsubscribe from the specified <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$imap_stream</strong>  Uno stream IMAP restituito da
                        <strong>imap_open()</strong>.
  <info>string</info>  <strong>$mailbox    </strong>  The mailbox name, see <strong>imap_open()</strong> for more information
                        
                        Passing untrusted data to this parameter is insecure, unless
                        imap.enable_insecure_rsh is disabled.

<comment>Return:</comment>
  <info>bool</info>  Restituisce <info>true</info> in caso di successo, <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_subscribe()</strong>


id: imap_utf7_decode
type: function
doc:
<comment>Description:</comment>
  Decodes a modified UTF-7 encoded string
  
  Decodes modified UTF-7 <strong>$text</strong> into ISO-8859-1 string.
  
  This function is needed to decode mailbox names that contain certain characters which are not in
  range of printable ASCII characters.

<comment>Param:</comment>
  <info>string</info>  <strong>$text</strong>  A modified UTF-7 encoding string, as defined in RFC 2060, section 5.1.3 (original
                 UTF-7 was defined in RFC1642).

<comment>Return:</comment>
  <info>string</info>  Returns a string that is encoded in ISO-8859-1 and consists of the same sequence of
          characters in <strong>$text</strong>, or <info>false</info> if <strong>$text</strong> contains invalid modified UTF-7 sequence or <strong>$text</strong>
          contains a character that is not part of ISO-8859-1 character set.

<comment>See Also:</comment>
   * <strong>imap_utf7_encode()</strong>


id: imap_utf7_encode
type: function
doc:
<comment>Description:</comment>
  Converts ISO-8859-1 string to modified UTF-7 text
  
  Converts <strong>$data</strong> to modified UTF-7 text.
  
  This is needed to encode mailbox names that contain certain characters which are not in range of
  printable ASCII characters.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  An ISO-8859-1 string.

<comment>Return:</comment>
  <info>string</info>  Returns <strong>$data</strong> encoded with the modified UTF-7 encoding as defined in RFC 2060,  section
          5.1.3 (original UTF-7 was defined in RFC1642).

<comment>See Also:</comment>
   * <strong>imap_utf7_decode()</strong>


id: imap_utf8
type: function
doc:
<comment>Description:</comment>
  Converts MIME-encoded text to UTF-8
  
  Converts the given <strong>$mime_encoded_text</strong> to UTF-8, if the declared charset is known to libc-client.
  Otherwise the given text is decoded, but not converted to UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$mime_encoded_text</strong>  A MIME encoded string. MIME encoding method and the UTF-8
                              specification are described in RFC2047 and RFC2044 respectively.

<comment>Return:</comment>
  <info>string</info>  Returns the decoded string, if possible converted to UTF-8.

<comment>See Also:</comment>
   * <strong>imap_mime_header_decode()</strong>


id: imap_utf8_to_mutf7
type: function
doc:
<comment>Description:</comment>
  Encode a UTF-8 string to modified UTF-7
  
  Encode a UTF-8 string to modified UTF-7 (as specified in RFC 2060, section 5.1.3).
  
  This function is only available, if libcclient exports utf8_to_mutf7().

<comment>Param:</comment>
  <info>string</info>  <strong>$in</strong>  A UTF-8 encoded string.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns <strong>$in</strong> converted to modified UTF-7, o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>imap_mutf7_to_utf8()</strong>


id: inet_ntop
type: function
doc:
<comment>Description:</comment>
  Converts a packed internet address to a human readable representation
  
  This function converts a 32bit IPv4, or 128bit IPv6 address (if PHP was built with IPv6 support
  enabled) into an address family appropriate string representation.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  A 32bit IPv4, or 128bit IPv6 address.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string representation of the address o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>long2ip()</strong>
   * <strong>ip2long()</strong>
   * <strong>inet_pton()</strong>


id: inet_pton
type: function
doc:
<comment>Description:</comment>
  Converts a human readable IP address to its packed in_addr representation
  
  This function converts a human readable IPv4 or IPv6 address (if PHP was built with IPv6 support
  enabled) into an address family appropriate 32bit or 128bit binary structure.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  A human readable IPv4 or IPv6 address.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the <return>in_addr</return> representation of the given <strong>$ip</strong>, or <info>false</info> if a syntactically
               invalid <strong>$ip</strong> is given (for example, an IPv4 address without dots or an IPv6 address
               without colons).

<comment>See Also:</comment>
   * <strong>ip2long()</strong>
   * <strong>long2ip()</strong>
   * <strong>inet_ntop()</strong>


id: inflate_add
type: function
doc:
<comment>Description:</comment>
  Incrementally inflate encoded data
  
  Incrementally inflates encoded data in the specified <strong>$context</strong>.
  
  Limitation: header information from GZIP compressed data are not made available.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context   </strong>  A context created with <strong>inflate_init()</strong>.
  <info>string        </info>  <strong>$data      </strong>  A chunk of compressed data.
  <info>int           </info>  <strong>$flush_mode</strong>  One of <info>ZLIB_BLOCK</info>, <info>ZLIB_NO_FLUSH</info>, <info>ZLIB_PARTIAL_FLUSH</info>, <info>ZLIB_SYNC_FLUSH</info>
                               (default), <info>ZLIB_FULL_FLUSH</info>, <info>ZLIB_FINISH</info>. Normally you will want to
                               set <info>ZLIB_NO_FLUSH</info> to maximize compression, and <info>ZLIB_FINISH</info> to
                               terminate with the last chunk of data. See the zlib manual for a
                               detailed description of these constants.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a chunk of uncompressed data,  o <info>false</info> in caso di fallimento.

<comment>See Also:</comment>
   * <strong>inflate_init()</strong>


id: inflate_get_read_len
type: function
doc:
<comment>Description:</comment>
  Get number of bytes read so far
  
  Questa funzione, al momento
  non è documentata; è disponibile soltanto la lista degli argomenti.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context</strong>  

<comment>Return:</comment>
  <info>int</info>  Returns number of bytes read so far o <info>false</info> in caso di fallimento.


id: inflate_get_status
type: function
doc:
<comment>Description:</comment>
  Get decompression status
  
  Usually returns either <info>ZLIB_OK</info> or <info>ZLIB_STREAM_END</info>.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context</strong>  

<comment>Return:</comment>
  <info>int</info>  Returns decompression status o <info>false</info> in caso di fallimento.


id: inflate_init
type: function
doc:
<comment>Description:</comment>
  Initialize an incremental inflate context
  
  Initialize an incremental inflate context with the specified <strong>$encoding</strong>.

<comment>Param:</comment>
  <info>int  </info>  <strong>$encoding</strong>  One of the <info>ZLIB_ENCODING_*</info> constants.
  <info>array</info>  <strong>$options </strong>  An associative array which may contain the following elements: level The
                    compression level in range -1..9; defaults to -1. memory The compression memory
                    level in range 1..9; defaults to 8. window The zlib window size (logarithmic) in
                    range 8..15; defaults to 15. strategy One of <info>ZLIB_FILTERED</info>, <info>ZLIB_HUFFMAN_ONLY</info>,
                    <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or <info>ZLIB_DEFAULT_STRATEGY</info> (the default). dictionary A <info>string</info>
                    or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no preset dictionary).
                    
                    The compression level in range -1..9; defaults to -1.
                    
                    The compression memory level in range 1..9; defaults to 8.
                    
                    The zlib window size (logarithmic) in range 8..15; defaults to 15.
                    
                    One of <info>ZLIB_FILTERED</info>, <info>ZLIB_HUFFMAN_ONLY</info>, <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or
                    <info>ZLIB_DEFAULT_STRATEGY</info> (the default).
                    
                    A <info>string</info> or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no preset
                    dictionary).

<comment>Return:</comment>
  <info>InflateContextfalse</info>  Returns an inflate context resource (<return>zlib.inflate</return>) on success,  o <info>false</info> in
                       caso di fallimento.

<comment>See Also:</comment>
   * <strong>inflate_add()</strong>
   * <strong>deflate_init()</strong>


