# php_manual

id: ps_hyphenate
type: function
doc:
<comment>Description:</comment>
  Hyphenates a word
  
  Hyphenates the passed word. <strong>ps_hyphenate()</strong> evaluates the value hyphenminchars (set by
  <strong>ps_set_value()</strong>) and the parameter hyphendict (set by <strong>ps_set_parameter()</strong>). hyphendict must be set
  before calling this function.
  
  This function requires the locale category LC_CTYPE to be set properly. This is done when the
  extension is initialized by using the environment variables. On Unix systems read the man page of
  locale for more information.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text </strong>  <strong>$text</strong> should not contain any non alpha characters. Possible positions for breaks
                    are returned in an array of interger numbers. Each number is the position of the
                    char in  <strong>$text</strong> after which a hyphenation can take place.

<comment>Return:</comment>
  <info>arrayfalse</info>  An array of integers indicating the position of possible breaks in the text  sau <info>false</info>
              în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_show_boxed()</strong>
   * locale(1)


id: ps_include_file
type: function
doc:
<comment>Description:</comment>
  Reads an external file with raw PostScript code
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$file </strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_lineto
type: function
doc:
<comment>Description:</comment>
  Draws a line
  
  Adds a straight line from the current point to the given coordinates to the current path. Use
  <strong>ps_moveto()</strong> to set the starting point of the line.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x    </strong>  x-coordinate of the end point of the line.
  <info>float   </info>  <strong>$y    </strong>  y-coordinate of the end point of the line.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_makespotcolor
type: function
doc:
<comment>Description:</comment>
  Create spot color
  
  Creates a spot color from the current fill color. The fill color must be defined in rgb, cmyk or
  gray colorspace. The spot color name can be an arbitrary name. A spot color can be set as any
  color with <strong>ps_setcolor()</strong>. When the document is not printed but displayed by an postscript viewer
  the given color in the specified color space is use.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  Name of the spot color, e.g. Pantone 5565.

<comment>Return:</comment>
  <info>int</info>  The id of the new spot color or 0 in case of an error.

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


id: ps_moveto
type: function
doc:
<comment>Description:</comment>
  Sets current point
  
  Sets the current point to new coordinates. If this is the first call of <strong>ps_moveto()</strong> after a
  previous path has been ended then it will start a new path. If this function is called in the
  middle of a path it will just set the current point and start a subpath.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x    </strong>  x-coordinate of the point to move to.
  <info>float   </info>  <strong>$y    </strong>  y-coordinate of the point to move to.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_new
type: function
doc:
<comment>Description:</comment>
  Creates a new PostScript document object
  
  Creates a new document instance. It does not create the file on disk or in memory, it just sets up
  everything. <strong>ps_new()</strong> is usually followed by a call of <strong>ps_open_file()</strong> to actually create the
  postscript document.

<comment>Return:</comment>
  <info>resourcefalse</info>  Resource of PostScript document sau <info>false</info> în cazul eșecului. The return value is
                 passed to all other functions as the first argument.

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


id: ps_open_file
type: function
doc:
<comment>Description:</comment>
  Opens a file for output
  
  Creates a new file on disk and writes the PostScript document into it. The file will be closed
  when <strong>ps_close()</strong> is called.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc   </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$filename</strong>  The name of the postscript file. If <strong>$filename</strong> is not passed the document will
                       be created in memory and all output will go straight to the browser.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_open_image
type: function
doc:
<comment>Description:</comment>
  Reads an image for later placement
  
  Reads an image which is already available in memory. The parameter <strong>$source</strong> is currently not
  evaluated and assumed to be <return>memory</return>. The image data is a sequence of pixels starting in th upper
  left corner and ending in the lower right corner. Each pixel consists of <strong>$components</strong> color
  components, and each component has <strong>$bpc</strong> bits.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc     </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$type      </strong>  The type of the image. Possible values are <return>png</return>, <return>jpeg</return>, or <return>eps</return>.
  <info>string  </info>  <strong>$source    </strong>  Not used.
  <info>string  </info>  <strong>$data      </strong>  The image data.
  <info>        </info>  <strong>$length    </strong>  The length of the image data.
  <info>int     </info>  <strong>$width     </strong>  The width of the image.
  <info>int     </info>  <strong>$height    </strong>  The height of the image.
  <info>int     </info>  <strong>$components</strong>  The number of components for each pixel. This can be 1 (gray scale images),
                         3 (rgb images), or 4 (cmyk, rgba images).
  <info>int     </info>  <strong>$bpc       </strong>  Number of bits per component (quite often 8).
  <info>string  </info>  <strong>$params    </strong>  

<comment>Return:</comment>
  <info>int</info>  Returns identifier of image or zero in case of an error. The identifier is a positive number
       greater than 0.

<comment>See Also:</comment>
   * <strong>ps_open_image_file()</strong>
   * <strong>ps_place_image()</strong>
   * <strong>ps_close_image()</strong>


id: ps_open_image_file
type: function
doc:
<comment>Description:</comment>
  Opens image from file
  
  Loads an image for later use.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc      </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$type       </strong>  The type of the image. Possible values are <return>png</return>, <return>jpeg</return>, or <return>eps</return>.
  <info>string  </info>  <strong>$filename   </strong>  The name of the file containing the image data.
  <info>string  </info>  <strong>$stringparam</strong>  Not used.
  <info>int     </info>  <strong>$intparam   </strong>  Not used.

<comment>Return:</comment>
  <info>int</info>  Returns identifier of image or zero in case of an error. The identifier is a positive number
       greater than 0.

<comment>See Also:</comment>
   * <strong>ps_open_image()</strong>
   * <strong>ps_place_image()</strong>
   * <strong>ps_close_image()</strong>


id: ps_open_memory_image
type: function
doc:
<comment>Description:</comment>
  Takes an GD image and returns an image for placement in a PS document
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$gd   </strong>  

<comment>Return:</comment>
  <info>int</info>  


id: ps_place_image
type: function
doc:
<comment>Description:</comment>
  Places image on the page
  
  Places a formerly loaded image on the page. The image can be scaled. If the image shall be rotated
  as well, you will have to rotate the coordinate system before with <strong>ps_rotate()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc  </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$imageid</strong>  The resource identifier of the image as returned by  <strong>ps_open_image()</strong> or
                      <strong>ps_open_image_file()</strong>.
  <info>float   </info>  <strong>$x      </strong>  x-coordinate of the lower left corner of the image.
  <info>float   </info>  <strong>$y      </strong>  y-coordinate of the lower left corner of the image.
  <info>float   </info>  <strong>$scale  </strong>  The scaling factor for the image. A scale of 1.0 will result in a resolution
                      of 72 dpi, because each pixel is equivalent to 1 point.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_open_image()</strong>
   * <strong>ps_open_image_file()</strong>


id: ps_rect
type: function
doc:
<comment>Description:</comment>
  Draws a rectangle
  
  Draws a rectangle with its lower left corner at (<strong>$x</strong>, <strong>$y</strong>). The rectangle starts and ends in its
  lower left corner. If this function is called outside a path it will start a new path. If it is
  called within a path it will add the rectangle as a subpath. If the last drawing operation does
  not end in the lower left corner then there will be a gap in the path.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x     </strong>  x-coordinate of the lower left corner of the rectangle.
  <info>float   </info>  <strong>$y     </strong>  y-coordinate of the lower left corner of the rectangle.
  <info>float   </info>  <strong>$width </strong>  The width of the image.
  <info>float   </info>  <strong>$height</strong>  The height of the image.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_arc()</strong>
   * <strong>ps_cirle()</strong>
   * <strong>ps_lineto()</strong>


id: ps_restore
type: function
doc:
<comment>Description:</comment>
  Restore previously save context
  
  Restores a previously saved graphics context. Any call of <strong>ps_save()</strong> must be accompanied by a call
  to <strong>ps_restore()</strong>. All coordinate transformations, line style settings, color settings, etc. are
  being restored to the state before the call of <strong>ps_save()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_rotate
type: function
doc:
<comment>Description:</comment>
  Sets rotation factor
  
  Sets the rotation of the coordinate system.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$rot  </strong>  Angle of rotation in degree.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_scale()</strong>
   * <strong>ps_translate()</strong>


id: ps_save
type: function
doc:
<comment>Description:</comment>
  Save current context
  
  Saves the current graphics context, containing colors, translation and rotation settings and some
  more. A saved context can be restored with <strong>ps_restore()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_scale
type: function
doc:
<comment>Description:</comment>
  Sets scaling factor
  
  Sets horizontal and vertical scaling of the coordinate system.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x    </strong>  Scaling factor in horizontal direction.
  <info>float   </info>  <strong>$y    </strong>  Scaling factor in vertical direction.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_rotate()</strong>
   * <strong>ps_translate()</strong>


id: ps_set_border_color
type: function
doc:
<comment>Description:</comment>
  Sets color of border for annotations
  
  Links added with one of the functions <strong>ps_add_weblink()</strong>, <strong>ps_add_pdflink()</strong>, etc. will be displayed
  with a surounded rectangle when the postscript document is converted to pdf and viewed in a pdf
  viewer. This rectangle is not visible in the postscript document. This function sets the color of
  the rectangle's border line.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$red  </strong>  The red component of the border color.
  <info>float   </info>  <strong>$green</strong>  The green component of the border color.
  <info>float   </info>  <strong>$blue </strong>  The blue component of the border color.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_set_border_dash()</strong>
   * <strong>ps_set_border_style()</strong>


id: ps_set_border_dash
type: function
doc:
<comment>Description:</comment>
  Sets length of dashes for border of annotations
  
  Links added with one of the functions <strong>ps_add_weblink()</strong>, <strong>ps_add_pdflink()</strong>, etc. will be displayed
  with a surounded rectangle when the postscript document is converted to pdf and viewed in a pdf
  viewer. This rectangle is not visible in the postscript document. This function sets the length of
  the black and white portion of a dashed border line.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$black</strong>  The length of the dash.
  <info>float   </info>  <strong>$white</strong>  The length of the gap between dashes.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_set_border_color()</strong>
   * <strong>ps_set_border_style()</strong>


id: ps_set_border_style
type: function
doc:
<comment>Description:</comment>
  Sets border style of annotations
  
  Links added with one of the functions <strong>ps_add_weblink()</strong>, <strong>ps_add_pdflink()</strong>, etc. will be displayed
  with a surounded rectangle when the postscript document is converted to pdf and viewed in a pdf
  viewer. This rectangle is not visible in the postscript document. This function sets the
  appearance and width of the border line.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$style</strong>  <strong>$style</strong> can be <return>solid</return> or <return>dashed</return>.
  <info>float   </info>  <strong>$width</strong>  The line width of the border.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_set_border_color()</strong>
   * <strong>ps_set_border_dash()</strong>


id: ps_set_info
type: function
doc:
<comment>Description:</comment>
  Sets information fields of document
  
  Sets certain information fields of the document. This fields will be shown as a comment in the
  header of the PostScript file. If the document is converted to pdf this fields will also be used
  for the document information.
  
  The <return>BoundingBox</return> is usually set to the value given to the first page. This only works if
  <strong>ps_findfont()</strong> has not been called before. In such cases the BoundingBox would be left unset unless
  you set it explicitly with this function.
  
  This function will have no effect anymore when the header of the postscript file has been already
  written. It must be called before the first page or the first call of <strong>ps_findfont()</strong>.

<comment>Param:</comment>
  <info>      </info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string</info>  <strong>$key  </strong>  The name of the information field to set. The values which can be set are
                  <return>Keywords</return>, <return>Subject</return>, <return>Title</return>, <return>Creator</return>, <return>Author</return>, <return>BoundingBox</return>, and <return>Orientation</return>. Be aware
                  that some of them has a meaning to PostScript viewers.
  <info>      </info>  <strong>$value</strong>  The value of the information field. The field <return>Orientation</return> can be set to either
                  <return>Portrait</return> or <return>Landscape</return>. The <return>BoundingBox</return> is a string consisting of four numbers. The
                  first two numbers are the coordinates of the lower left corner of the page. The
                  last two numbers are the coordinates of the upper right corner.
                  
                  Up to version 0.2.6 of pslib, the BoundingBox and Orientation will be overwritten
                  by <strong>ps_begin_page()</strong>, unless <strong>ps_findfont()</strong> has been called before.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_findfont()</strong>
   * <strong>ps_begin_page()</strong>


id: ps_set_parameter
type: function
doc:
<comment>Description:</comment>
  Sets certain parameters
  
  Sets several parameters which are used by many functions. Parameters are by definition string
  values.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  For a list of possible names see <strong>ps_get_parameter()</strong>.
  <info>string  </info>  <strong>$value</strong>  The value of the parameter.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_get_parameters()</strong>
   * <strong>ps_set_value()</strong>


id: ps_set_text_pos
type: function
doc:
<comment>Description:</comment>
  Sets position for text output
  
  Set the position for the next text output. You may alternatively set the x and y value separately
  by calling <strong>ps_set_value()</strong> and choosing <return>textx</return> respectively <return>texty</return> as the value name.
  
  If you want to output text at a certain position it is more convenient to use <strong>ps_show_xy()</strong> instead
  of setting the text position and calling <strong>ps_show()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x    </strong>  x-coordinate of the new text position.
  <info>float   </info>  <strong>$y    </strong>  y-coordinate of the new text position.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_set_value()</strong>
   * <strong>ps_show()</strong>


id: ps_set_value
type: function
doc:
<comment>Description:</comment>
  Sets certain values
  
  Sets several values which are used by many functions. Parameters are by definition float values.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  The <strong>$name</strong> can be one of the following: textrendering The way how text is shown.
                    textx The x coordinate for text output. texty The y coordinate for text output.
                    wordspacing The distance between words relative to the width of a space. leading
                    The distance between lines in pixels.
                    
                    The way how text is shown.
                    
                    The x coordinate for text output.
                    
                    The y coordinate for text output.
                    
                    The distance between words relative to the width of a space.
                    
                    The distance between lines in pixels.
  <info>float   </info>  <strong>$value</strong>  The value of the parameter.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_get_value()</strong>
   * <strong>ps_set_parameter()</strong>


id: ps_setcolor
type: function
doc:
<comment>Description:</comment>
  Sets current color
  
  Sets the color for drawing, filling, or both.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc     </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$type      </strong>  The parameter <strong>$type</strong> can be  <return>both</return>, <return>fill</return>, or <return>fillstroke</return>.
  <info>string  </info>  <strong>$colorspace</strong>  The colorspace should be one of <return>gray</return>, <return>rgb</return>, <return>cmyk</return>,  <return>spot</return>, <return>pattern</return>. Depending
                         on the colorspace either only the first, the first three or all parameters
                         will be used.
  <info>float   </info>  <strong>$c1        </strong>  Depending on the colorspace this is either the red component (rgb), the
                         cyan component (cmyk), the gray value (gray), the identifier of the spot
                         color or the identifier of the pattern.
  <info>float   </info>  <strong>$c2        </strong>  Depending on the colorspace this is either the green component (rgb), the
                         magenta component (cmyk).
  <info>float   </info>  <strong>$c3        </strong>  Depending on the colorspace this is either the blue component (rgb), the
                         yellow component (cmyk).
  <info>float   </info>  <strong>$c4        </strong>  This must only be set in cmyk colorspace and specifies the black component.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_setdash
type: function
doc:
<comment>Description:</comment>
  Sets appearance of a dashed line
  
  Sets the length of the black and white portions of a dashed line.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$on   </strong>  The length of the dash.
  <info>float   </info>  <strong>$off  </strong>  The length of the gap between dashes.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_setflat
type: function
doc:
<comment>Description:</comment>
  Sets flatness
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$value</strong>  The <strong>$value</strong> must be between 0.2 and 1.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_setfont
type: function
doc:
<comment>Description:</comment>
  Sets font to use for following output
  
  Sets a font, which has to be loaded before with <strong>ps_findfont()</strong>. Outputting text without setting a
  font results in an error.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$fontid</strong>  The font identifier as returned by <strong>ps_findfont()</strong>.
  <info>float   </info>  <strong>$size  </strong>  The size of the font.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_findfont()</strong>
   * <strong>ps_set_text_pos()</strong> for an example.


id: ps_setgray
type: function
doc:
<comment>Description:</comment>
  Sets gray value
  
  Sets the gray value for all following drawing operations.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$gray </strong>  The value must be between 0 (white) and 1 (black).

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_setlinecap
type: function
doc:
<comment>Description:</comment>
  Sets appearance of line ends
  
  Sets how line ends look like.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$type </strong>  The type of line ends. Possible values are <return>PS_LINECAP_BUTT</return>, <return>PS_LINECAP_ROUND</return>, or
                    <return>PS_LINECAP_SQUARED</return>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_setlinejoin()</strong>
   * <strong>ps_setlinewidth()</strong>
   * <strong>ps_setmiterlimit()</strong>


id: ps_setlinejoin
type: function
doc:
<comment>Description:</comment>
  Sets how contected lines are joined
  
  Sets how lines are joined.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$type </strong>  The way lines are joined. Possible values are <return>PS_LINEJOIN_MITER</return>,
                    <return>PS_LINEJOIN_ROUND</return>, or <return>PS_LINEJOIN_BEVEL</return>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_setlinecap()</strong>
   * <strong>ps_setlinewidth()</strong>
   * <strong>ps_setmiterlimit()</strong>


id: ps_setlinewidth
type: function
doc:
<comment>Description:</comment>
  Sets width of a line
  
  Sets the line width for all following drawing operations.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$width</strong>  The width of lines in points.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_setlinecap()</strong>
   * <strong>ps_setlinejoin()</strong>
   * <strong>ps_setmiterlimit()</strong>


id: ps_setmiterlimit
type: function
doc:
<comment>Description:</comment>
  Sets the miter limit
  
  If two lines join in a small angle and the line join is set to <return>PS_LINEJOIN_MITER</return>, then the
  resulting spike will be very long. The miter limit is the maximum ratio of the miter length (the
  length of the spike) and the line width.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$value</strong>  The maximum ratio between the miter length and the line width. Larger values
                    (&gt; 10) will result in very long spikes when two lines meet in a small angle.
                    Keep the default unless you know what you are doing.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_setlinecap()</strong>
   * <strong>ps_setlinejoin()</strong>
   * <strong>ps_setlinewidth()</strong>


id: ps_setoverprintmode
type: function
doc:
<comment>Description:</comment>
  Sets overprint mode
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$mode </strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_setpolydash
type: function
doc:
<comment>Description:</comment>
  Sets appearance of a dashed line
  
  Sets the length of the black and white portions of a dashed line. <strong>ps_setpolydash()</strong> is used to set
  more complicated dash patterns.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$arr  </strong>  <strong>$arr</strong> is a list of length elements alternately for the black and white portion.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: ps_shading
type: function
doc:
<comment>Description:</comment>
  Creates a shading for later use
  
  Creates a shading, which can be used by <strong>ps_shfill()</strong> or <strong>ps_shading_pattern()</strong>.
  
  The color of the shading can be in any color space except for <return>pattern</return>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc         </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$type          </strong>  The type of shading can be either <return>radial</return> or <return>axial</return>. Each shading starts
                             with the current fill color and ends with the given color values passed
                             in the parameters <strong>$c1</strong> to <strong>$c4</strong> (see <strong>ps_setcolor()</strong> for their meaning).
  <info>        </info>  <strong>$x0, x1, y0, y1</strong>  The coordinates <strong>$x0</strong>, <strong>$y0</strong>, <strong>$x1</strong>, <strong>$y1</strong> are the start and end point of the
                             shading. If the type of shading is <return>radial</return> the two points are the middle
                             points of a starting and ending circle.
  <info>        </info>  <strong>$c1, c2, c3, c4</strong>  See <strong>ps_setcolor()</strong> for their meaning.
  <info>string  </info>  <strong>$optlist       </strong>  If the shading is of type <return>radial</return> the <strong>$optlist</strong> must also contain the
                             parameters <return>r0</return> and <return>r1</return> with the radius of the start and end circle.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the identifier of the pattern  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_shading_pattern()</strong>
   * <strong>ps_shfill()</strong>


id: ps_shading_pattern
type: function
doc:
<comment>Description:</comment>
  Creates a pattern based on a shading
  
  Creates a pattern based on a shading, which has to be created before with <strong>ps_shading()</strong>. Shading
  patterns can be used like regular patterns.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc    </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$shadingid</strong>  The identifier of a shading previously created with <strong>ps_shading()</strong>.
  <info>string  </info>  <strong>$optlist  </strong>  This argument is not currently used.

<comment>Return:</comment>
  <info>intfalse</info>  The identifier of the pattern  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_shading()</strong>
   * <strong>ps_shfill()</strong>


id: ps_shfill
type: function
doc:
<comment>Description:</comment>
  Fills an area with a shading
  
  Fills an area with a shading, which has to be created before with <strong>ps_shading()</strong>. This is an
  alternative way to creating a pattern from a shading <strong>ps_shading_pattern()</strong> and using the pattern as
  the filling color.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc    </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$shadingid</strong>  The identifier of a shading previously created with <strong>ps_shading()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_shading()</strong>
   * <strong>ps_shading_pattern()</strong>


id: ps_show
type: function
doc:
<comment>Description:</comment>
  Output text
  
  Output a text at the current text position. The text position can be set by storing the x and y
  coordinates into the values <return>textx</return> and <return>texty</return> with the function <strong>ps_set_value()</strong>. The function will
  issue an error if a font was not set before with <strong>ps_setfont()</strong>.
  
  <strong>ps_show()</strong> evaluates the following parameters and values as set by <strong>ps_set_parameter()</strong> and
  <strong>ps_set_value()</strong>.
  
  Distance between two consecutive glyphs. If this value is unequal to zero then all ligatures will
  be resolved. Values less than zero are allowed.
  
  Setting this parameter to "false" will turn off kerning. Kerning is turned on by default.
  
  Setting this parameter to "false" will turn off the use of ligatures.  Ligatures are turned on by
  default.
  
  Setting this parameter to "true" will turn on underlining. Underlining is turned off by default.
  
  Setting this parameter to "true" will turn on overlining. Overlining is turned off by default.
  
  Setting this parameter to "true" will turn on striking out. Striking out is turned off by default.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text </strong>  The text to be output.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_continue_text()</strong>
   * <strong>ps_show_xy()</strong>
   * <strong>ps_setfont()</strong>


id: ps_show2
type: function
doc:
<comment>Description:</comment>
  Output a text at current position
  
  Output text at the current position. Do not print more than <strong>$len</strong> characters.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text </strong>  The text to be output.
  <info>int     </info>  <strong>$len  </strong>  The maximum number of characters to print.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_show_boxed
type: function
doc:
<comment>Description:</comment>
  Output text in a box
  
  Outputs a text in a given box. The lower left corner of the box is at (<strong>$left</strong>, <strong>$bottom</strong>). Line
  breaks will be inserted where needed. Multiple spaces are treated as one. Tabulators are treated
  as spaces.
  
  The text will be hyphenated if the parameter <strong>$hyphenation</strong> is set to <info>true</info> and the parameter
  <strong>$hyphendict</strong> contains a valid filename for a hyphenation file. The line spacing is taken from the
  value <return>leading</return>. Paragraphs can be separated by an empty line just like in TeX. If the value
  <return>parindent</return> is set to value &gt; 0.0 then the first n lines will be indented. The number n of lines
  is set by the parameter <return>numindentlines</return>. In order to prevent indenting of the first m paragraphs
  set the value <return>parindentskip</return> to a positive number.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc  </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text   </strong>  The text to be output into the given box.
  <info>float   </info>  <strong>$left   </strong>  x-coordinate of the lower left corner of the box.
  <info>float   </info>  <strong>$bottom </strong>  y-coordinate of the lower left corner of the box.
  <info>float   </info>  <strong>$width  </strong>  Width of the box.
  <info>float   </info>  <strong>$height </strong>  Height of the box.
  <info>string  </info>  <strong>$hmode  </strong>  The parameter <strong>$hmode</strong> can be "justify", "fulljustify", "right", "left", or
                      "center". The difference of "justify" and "fulljustify" just affects the last
                      line of the box. In fulljustify mode the last line will be left and right
                      justified unless this is also the last line of paragraph. In justify mode it
                      will always be left justified.
  <info>string  </info>  <strong>$feature</strong>  

<comment>Return:</comment>
  <info>int</info>  Number of characters that could not be written.

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


id: ps_show_xy
type: function
doc:
<comment>Description:</comment>
  Output text at given position
  
  Output a text at the given text position.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text </strong>  The text to be output.
  <info>float   </info>  <strong>$x    </strong>  x-coordinate of the lower left corner of the box surrounding the text.
  <info>float   </info>  <strong>$y    </strong>  y-coordinate of the lower left corner of the box surrounding the text.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_continue_text()</strong>
   * <strong>ps_show()</strong>


id: ps_show_xy2
type: function
doc:
<comment>Description:</comment>
  Output text at position
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: ps_string_geometry
type: function
doc:
<comment>Description:</comment>
  Gets geometry of a string
  
  This function is similar to <strong>ps_stringwidth()</strong> but returns an array of dimensions containing the
  width, ascender, and descender of the text.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text  </strong>  The text for which the geometry is to be calculated.
  <info>int     </info>  <strong>$fontid</strong>  The identifier of the font to be used. If not font is specified the current
                     font will be used.
  <info>float   </info>  <strong>$size  </strong>  The size of the font. If no size is specified the current size is used.

<comment>Return:</comment>
  <info>array</info>  An array of the dimensions of a string. The element 'width' contains the width of the
         string as returned by <strong>ps_stringwidth()</strong>. The element 'descender' contains the maximum
         descender and 'ascender' the maximum ascender of the string.

<comment>See Also:</comment>
   * <strong>ps_continue_text()</strong>
   * <strong>ps_stringwidth()</strong>


id: ps_stringwidth
type: function
doc:
<comment>Description:</comment>
  Gets width of a string
  
  Calculates the width of a string in points if it was output in the given font and font size. This
  function needs an Adobe font metrics file to calculate the precise width. If kerning is turned on,
  it will be taken into account.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>string  </info>  <strong>$text  </strong>  The text for which the width is to be calculated.
  <info>int     </info>  <strong>$fontid</strong>  The identifier of the font to be used. If not font is specified the current
                     font will be used.
  <info>float   </info>  <strong>$size  </strong>  The size of the font. If no size is specified the current size is used.

<comment>Return:</comment>
  <info>float</info>  Width of a string in points.

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


id: ps_stroke
type: function
doc:
<comment>Description:</comment>
  Draws the current path
  
  Draws the path constructed with previously called drawing functions like <strong>ps_lineto()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_closepath_stroke()</strong>
   * <strong>ps_fill()</strong>
   * <strong>ps_fill_stroke()</strong>


id: ps_symbol
type: function
doc:
<comment>Description:</comment>
  Output a glyph
  
  Output the glyph at position <strong>$ord</strong> in the font encoding vector of the current font. The font
  encoding for a font can be set when loading the font with <strong>ps_findfont()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$ord  </strong>  The position of the glyph in the font encoding vector.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_symbol_name()</strong>
   * <strong>ps_symbol_width()</strong>


id: ps_symbol_name
type: function
doc:
<comment>Description:</comment>
  Gets name of a glyph
  
  This function needs an Adobe font metrics file to know which glyphs are available.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$ord   </strong>  The parameter <strong>$ord</strong> is the position of the glyph in the font encoding vector.
  <info>int     </info>  <strong>$fontid</strong>  The identifier of the font to be used. If not font is specified the current
                     font will be used.

<comment>Return:</comment>
  <info>string</info>  The name of a glyph in the given font.

<comment>See Also:</comment>
   * <strong>ps_symbol()</strong>
   * <strong>ps_symbol_width()</strong>


id: ps_symbol_width
type: function
doc:
<comment>Description:</comment>
  Gets width of a glyph
  
  Calculates the width of a glyph in points if it was output in the given font and font size.  This
  function needs an Adobe font metrics file to calculate the precise width.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc </strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>int     </info>  <strong>$ord   </strong>  The position of the glyph in the font encoding vector.
  <info>int     </info>  <strong>$fontid</strong>  The identifier of the font to be used. If not font is specified the current
                     font will be used.
  <info>float   </info>  <strong>$size  </strong>  The size of the font. If no size is specified the current size is used.

<comment>Return:</comment>
  <info>float</info>  The width of a glyph in points.

<comment>See Also:</comment>
   * <strong>ps_symbol()</strong>
   * <strong>ps_symbol_name()</strong>


id: ps_translate
type: function
doc:
<comment>Description:</comment>
  Sets translation
  
  Sets a new initial point of the coordinate system.

<comment>Param:</comment>
  <info>resource</info>  <strong>$psdoc</strong>  Resource identifier of the postscript file as returned by <strong>ps_new()</strong>.
  <info>float   </info>  <strong>$x    </strong>  x-coordinate of the origin of the translated coordinate system.
  <info>float   </info>  <strong>$y    </strong>  y-coordinate of the origin of the translated coordinate system.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ps_scale()</strong>
   * <strong>ps_rotate()</strong>


id: pspell_add_to_personal
type: function
doc:
<comment>Description:</comment>
  Add the word to a personal wordlist
  
  <strong>pspell_add_to_personal()</strong> adds a word to the personal wordlist. If you used <strong>pspell_new_config()</strong>
  with <strong>pspell_config_personal()</strong> to open the dictionary, you can save the wordlist later with
  <strong>pspell_save_wordlist()</strong>.

<comment>Param:</comment>
  <info>int   </info>  <strong>$dictionary</strong>  
  <info>string</info>  <strong>$word      </strong>  The added word.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_add_to_session
type: function
doc:
<comment>Description:</comment>
  Add the word to the wordlist in the current session
  
  <strong>pspell_add_to_session()</strong> adds a word to the wordlist associated with the current session. It is
  very similar to <strong>pspell_add_to_personal()</strong>

<comment>Param:</comment>
  <info>int   </info>  <strong>$dictionary</strong>  
  <info>string</info>  <strong>$word      </strong>  The added word.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_check
type: function
doc:
<comment>Description:</comment>
  Check a word
  
  <strong>pspell_check()</strong> checks the spelling of a word.

<comment>Param:</comment>
  <info>int   </info>  <strong>$dictionary</strong>  
  <info>string</info>  <strong>$word      </strong>  The tested word.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the spelling is correct, <info>false</info> if not.


id: pspell_clear_session
type: function
doc:
<comment>Description:</comment>
  Clear the current session
  
  <strong>pspell_clear_session()</strong> clears the current session. The current wordlist becomes blank, and, for
  example, if you try to save it with <strong>pspell_save_wordlist()</strong>, nothing happens.

<comment>Param:</comment>
  <info>int</info>  <strong>$dictionary</strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_create
type: function
doc:
<comment>Description:</comment>
  Create a config used to open a dictionary
  
  Create a config used to open a dictionary.
  
  <strong>pspell_config_create()</strong> has a very similar syntax to <strong>pspell_new()</strong>. In fact, using
  <strong>pspell_config_create()</strong> immediately followed by <strong>pspell_new_config()</strong> will produce the exact same
  result. However, after creating a new config, you can also use <strong>pspell_config_*()</strong> functions before
  calling <strong>pspell_new_config()</strong> to take advantage of some advanced functionality.
  
  For more information and examples, check out inline manual pspell website:http://aspell.net/.

<comment>Param:</comment>
  <info>string</info>  <strong>$language</strong>  The language parameter is the language code which consists of the two letter
                     ISO 639 language code and an optional two letter ISO 3166 country code after a
                     dash or underscore.
  <info>string</info>  <strong>$spelling</strong>  The spelling parameter is the requested spelling for languages with more than
                     one spelling such as English. Known values are 'american', 'british', and
                     'canadian'.
  <info>string</info>  <strong>$jargon  </strong>  The jargon parameter contains extra information to distinguish two different
                     words lists that have the same language and spelling parameters.
  <info>string</info>  <strong>$encoding</strong>  The encoding parameter is the encoding that words are expected to be in.  Valid
                     values are 'utf-8', 'iso8859-*', 'koi8-r', 'viscii', 'cp1252', 'machine
                     unsigned 16', 'machine unsigned 32'. This parameter is largely untested, so be
                     careful when using.

<comment>Return:</comment>
  <info>int</info>  Returns a pspell config identifier, or <info>false</info> on error.


id: pspell_config_data_dir
type: function
doc:
<comment>Description:</comment>
  Location of language data files
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_dict_dir
type: function
doc:
<comment>Description:</comment>
  Location of the main word list
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_ignore
type: function
doc:
<comment>Description:</comment>
  Ignore words less than N characters long
  
  <strong>pspell_config_ignore()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>. This
  function allows short words to be skipped by the spell checker.

<comment>Param:</comment>
  <info>int</info>  <strong>$config    </strong>  
  <info>int</info>  <strong>$min_length</strong>  Words less than <strong>$min_length</strong> characters will be skipped.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_mode
type: function
doc:
<comment>Description:</comment>
  Change the mode number of suggestions returned
  
  <strong>pspell_config_mode()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>. This function
  determines how many suggestions will be returned by <strong>pspell_suggest()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$config</strong>  
  <info>int</info>  <strong>$mode  </strong>  The mode parameter is the mode in which spellchecker will work. There are several
                modes available: <info>PSPELL_FAST</info> - Fast mode (least number of suggestions) <info>PSPELL_NORMAL</info>
                - Normal mode (more suggestions) <info>PSPELL_BAD_SPELLERS</info> - Slow mode (a lot of
                suggestions)
                
                <info>PSPELL_FAST</info> - Fast mode (least number of suggestions)
                
                <info>PSPELL_NORMAL</info> - Normal mode (more suggestions)
                
                <info>PSPELL_BAD_SPELLERS</info> - Slow mode (a lot of suggestions)

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_personal
type: function
doc:
<comment>Description:</comment>
  Set a file that contains personal wordlist
  
  Set a file that contains personal wordlist. The personal wordlist will be loaded and used in
  addition to the standard one after you call <strong>pspell_new_config()</strong>. The file is also the file where
  <strong>pspell_save_wordlist()</strong> will save personal wordlist to.
  
  <strong>pspell_config_personal()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>.

<comment>Param:</comment>
  <info>int   </info>  <strong>$config  </strong>  
  <info>string</info>  <strong>$filename</strong>  The personal wordlist. If the file does not exist, it will be created. The file
                     should be writable by whoever PHP runs as (e.g. nobody).

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_repl
type: function
doc:
<comment>Description:</comment>
  Set a file that contains replacement pairs
  
  Set a file that contains replacement pairs.
  
  The replacement pairs improve the quality of the spellchecker. When a word is misspelled, and a
  proper suggestion was not found in the list, <strong>pspell_store_replacement()</strong> can be used to store a
  replacement pair and then <strong>pspell_save_wordlist()</strong> to save the wordlist along with the replacement
  pairs.
  
  <strong>pspell_config_repl()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>.

<comment>Param:</comment>
  <info>int   </info>  <strong>$config  </strong>  
  <info>string</info>  <strong>$filename</strong>  The file should be writable by whoever PHP runs as (e.g. nobody).

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_runtogether
type: function
doc:
<comment>Description:</comment>
  Consider run-together words as valid compounds
  
  This function determines whether run-together words will be treated as legal compounds.  That is,
  "thecat" will be a legal compound, although there should be a space between the two words.
  Changing this setting only affects the results returned by <strong>pspell_check()</strong>; <strong>pspell_suggest()</strong> will
  still return suggestions.
  
  <strong>pspell_config_runtogether()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>.

<comment>Param:</comment>
  <info>int </info>  <strong>$config</strong>  
  <info>bool</info>  <strong>$allow </strong>  <info>true</info> if run-together words should be treated as legal compounds, <info>false</info> otherwise.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_config_save_repl
type: function
doc:
<comment>Description:</comment>
  Determine whether to save a replacement pairs list
    along with the wordlist
  
  <strong>pspell_config_save_repl()</strong> determines whether <strong>pspell_save_wordlist()</strong> will save the replacement
  pairs along with the wordlist. Usually there is no need to use this function because if
  <strong>pspell_config_repl()</strong> is used, the replacement pairs will be saved by <strong>pspell_save_wordlist()</strong>
  anyway, and if it is not, the replacement pairs will not be saved.
  
  <strong>pspell_config_save_repl()</strong> should be used on a config before calling <strong>pspell_new_config()</strong>.

<comment>Param:</comment>
  <info>int </info>  <strong>$config</strong>  
  <info>bool</info>  <strong>$save  </strong>  <info>true</info> if replacement pairs should be saved, <info>false</info> otherwise.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_new
type: function
doc:
<comment>Description:</comment>
  Load a new dictionary
  
  <strong>pspell_new()</strong> opens up a new dictionary and returns the dictionary link identifier for use in other
  pspell functions.
  
  For more information and examples, check out inline manual pspell website:http://aspell.net/.

<comment>Param:</comment>
  <info>string</info>  <strong>$language</strong>  The language parameter is the language code which consists of the two letter
                     ISO 639 language code and an optional two letter ISO 3166 country code after a
                     dash or underscore.
  <info>string</info>  <strong>$spelling</strong>  The spelling parameter is the requested spelling for languages with more than
                     one spelling such as English. Known values are 'american', 'british', and
                     'canadian'.
  <info>string</info>  <strong>$jargon  </strong>  The jargon parameter contains extra information to distinguish two different
                     words lists that have the same language and spelling parameters.
  <info>string</info>  <strong>$encoding</strong>  The encoding parameter is the encoding that words are expected to be in.  Valid
                     values are 'utf-8', 'iso8859-*', 'koi8-r', 'viscii', 'cp1252', 'machine
                     unsigned 16', 'machine unsigned 32'. This parameter is largely untested, so be
                     careful when using.
  <info>int   </info>  <strong>$mode    </strong>  The mode parameter is the mode in which spellchecker will work. There are
                     several modes available: <info>PSPELL_FAST</info> - Fast mode (least number of suggestions)
                     <info>PSPELL_NORMAL</info> - Normal mode (more suggestions) <info>PSPELL_BAD_SPELLERS</info> - Slow mode
                     (a lot of suggestions) <info>PSPELL_RUN_TOGETHER</info> - Consider run-together words as
                     legal compounds.  That is, "thecat" will be a legal compound, although there
                     should be a space between the two words. Changing this setting only affects the
                     results returned by <strong>pspell_check()</strong>; <strong>pspell_suggest()</strong> will still return
                     suggestions.  Mode is a bitmask constructed from different constants listed
                     above. However, <info>PSPELL_FAST</info>, <info>PSPELL_NORMAL</info> and <info>PSPELL_BAD_SPELLERS</info> are mutually
                     exclusive, so you should select only one of them.
                     
                     <info>PSPELL_FAST</info> - Fast mode (least number of suggestions)
                     
                     <info>PSPELL_NORMAL</info> - Normal mode (more suggestions)
                     
                     <info>PSPELL_BAD_SPELLERS</info> - Slow mode (a lot of suggestions)
                     
                     <info>PSPELL_RUN_TOGETHER</info> - Consider run-together words as legal compounds.  That is,
                     "thecat" will be a legal compound, although there should be a space between the
                     two words. Changing this setting only affects the results returned by
                     <strong>pspell_check()</strong>; <strong>pspell_suggest()</strong> will still return suggestions.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the dictionary link identifier on success sau <info>false</info> în cazul eșecului.


id: pspell_new_config
type: function
doc:
<comment>Description:</comment>
  Load a new dictionary with settings based on a given config
    
  
  <strong>pspell_new_config()</strong> opens up a new dictionary with settings specified in a config, created with
  <strong>pspell_config_create()</strong> and modified with <strong>pspell_config_*()</strong> functions. This method provides you
  with the most flexibility and has all the functionality provided by <strong>pspell_new()</strong> and
  <strong>pspell_new_personal()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$config</strong>  The <strong>$config</strong> parameter is the one returned by <strong>pspell_config_create()</strong> when the config
                was created.

<comment>Return:</comment>
  <info>intfalse</info>  Returns a dictionary link identifier on success,  sau <info>false</info> în cazul eșecului.


id: pspell_new_personal
type: function
doc:
<comment>Description:</comment>
  Load a new dictionary with personal wordlist
  
  <strong>pspell_new_personal()</strong> opens up a new dictionary with a personal wordlist. The wordlist can be
  modified and saved with <strong>pspell_save_wordlist()</strong>, if desired. However, the replacement pairs are not
  saved. In order to save replacement pairs, you should create a config using
  <strong>pspell_config_create()</strong>, set the personal wordlist file with <strong>pspell_config_personal()</strong>, set the file
  for replacement pairs with <strong>pspell_config_repl()</strong>, and open a new dictionary with
  <strong>pspell_new_config()</strong>.
  
  For more information and examples, check out inline manual pspell website:http://aspell.net/.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  The file where words added to the personal list will be stored. It should be an
                     absolute filename beginning with '/' because otherwise it will be relative to
                     $HOME, which is "/root" for most systems, and is probably not what you want.
  <info>string</info>  <strong>$language</strong>  The language code which consists of the two letter ISO 639 language code and an
                     optional two letter ISO 3166 country code after a dash or underscore.
  <info>string</info>  <strong>$spelling</strong>  The requested spelling for languages with more than one spelling such as
                     English. Known values are 'american', 'british', and 'canadian'.
  <info>string</info>  <strong>$jargon  </strong>  Extra information to distinguish two different words lists that have the same
                     language and spelling parameters.
  <info>string</info>  <strong>$encoding</strong>  The encoding that words are expected to be in.  Valid values are <return>utf-8</return>,
                     <return>iso8859-*</return>,  <return>koi8-r</return>, <return>viscii</return>,  <return>cp1252</return>, <return>machine unsigned 16</return>,  <return>machine unsigned 32</return>.
  <info>int   </info>  <strong>$mode    </strong>  The mode in which spellchecker will work. There are several modes available:
                     <info>PSPELL_FAST</info> - Fast mode (least number of suggestions) <info>PSPELL_NORMAL</info> - Normal
                     mode (more suggestions) <info>PSPELL_BAD_SPELLERS</info> - Slow mode (a lot of suggestions)
                     <info>PSPELL_RUN_TOGETHER</info> - Consider run-together words as legal compounds.  That is,
                     "thecat" will be a legal compound, although there should be a space between the
                     two words. Changing this setting only affects the results returned by
                     <strong>pspell_check()</strong>; <strong>pspell_suggest()</strong> will still return suggestions.  Mode is a
                     bitmask constructed from different constants listed above. However,
                     <info>PSPELL_FAST</info>, <info>PSPELL_NORMAL</info> and <info>PSPELL_BAD_SPELLERS</info> are mutually exclusive, so
                     you should select only one of them.
                     
                     <info>PSPELL_FAST</info> - Fast mode (least number of suggestions)
                     
                     <info>PSPELL_NORMAL</info> - Normal mode (more suggestions)
                     
                     <info>PSPELL_BAD_SPELLERS</info> - Slow mode (a lot of suggestions)
                     
                     <info>PSPELL_RUN_TOGETHER</info> - Consider run-together words as legal compounds.  That is,
                     "thecat" will be a legal compound, although there should be a space between the
                     two words. Changing this setting only affects the results returned by
                     <strong>pspell_check()</strong>; <strong>pspell_suggest()</strong> will still return suggestions.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the dictionary link identifier for use in other pspell functions.


id: pspell_save_wordlist
type: function
doc:
<comment>Description:</comment>
  Save the personal wordlist to a file
  
  <strong>pspell_save_wordlist()</strong> saves the personal wordlist from the current session. The location of files
  to be saved specified with <strong>pspell_config_personal()</strong> and (optionally) <strong>pspell_config_repl()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$dictionary</strong>  A dictionary link identifier opened with <strong>pspell_new_personal()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_store_replacement
type: function
doc:
<comment>Description:</comment>
  Store a replacement pair for a word
  
  <strong>pspell_store_replacement()</strong> stores a replacement pair for a word, so that replacement can be
  returned by <strong>pspell_suggest()</strong> later. In order to be able to take advantage of this function, you
  have to use <strong>pspell_new_personal()</strong> to open the dictionary. In order to permanently save the
  replacement pair, you have to use <strong>pspell_config_personal()</strong> and <strong>pspell_config_repl()</strong> to set the
  path where to save your custom wordlists, and then use <strong>pspell_save_wordlist()</strong> for the changes to
  be written to disk.

<comment>Param:</comment>
  <info>int   </info>  <strong>$dictionary</strong>  A dictionary link identifier, opened with <strong>pspell_new_personal()</strong>
  <info>string</info>  <strong>$misspelled</strong>  The misspelled word.
  <info>string</info>  <strong>$correct   </strong>  The fixed spelling for the <strong>$misspelled</strong> word.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: pspell_suggest
type: function
doc:
<comment>Description:</comment>
  Suggest spellings of a word
  
  <strong>pspell_suggest()</strong> returns an array of possible spellings for the given word.

<comment>Param:</comment>
  <info>int   </info>  <strong>$dictionary</strong>  
  <info>string</info>  <strong>$word      </strong>  The tested word.

<comment>Return:</comment>
  <info>arrayfalse</info>  Returns an array of possible spellings.


id: putenv
type: function
doc:
<comment>Description:</comment>
  Sets the value of an environment variable
  
  Adds <strong>$assignment</strong> to the server environment.  The environment variable will only exist for the
  duration of the current request. At the end of the request the environment is restored to its
  original state.

<comment>Param:</comment>
  <info>string</info>  <strong>$assignment</strong>  The setting, like <return>"FOO=BAR"</return>

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>getenv()</strong>
   * <strong>apache_setenv()</strong>


id: px_close
type: function
doc:
<comment>Description:</comment>
  Closes a paradox database
  
  Closes the paradox database. This function will not close the file. You will have to call <strong>fclose()</strong>
  afterwards.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>px_open_fp()</strong>
   * The example at <strong>px_new()</strong>


id: px_create_fp
type: function
doc:
<comment>Description:</comment>
  Create a new paradox database
  
  Create a new paradox database file. The actual file has to be opened before with <strong>fopen()</strong>. Make
  sure the file is writable.
  
  Calling this functions issues a warning about an empty tablename which can be safely ignored. Just
  set the tablename afterwards with <strong>px_set_parameter()</strong>.
  
  This function is highly experimental, due to insufficient documentation of the paradox file
  format. Database files created with this function can be opened by <strong>px_open_fp()</strong> and has been
  successfully opened by the Paradox software, but your milage may vary.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc    </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>resource</info>  <strong>$file     </strong>  File handle as returned by <strong>fopen()</strong>.
  <info>array   </info>  <strong>$fielddesc</strong>  fielddesc is an array containing one element for each field specification. A
                        field specification is an array itself with either two or three elements.The
                        first element is always a string value used as the name of the field. It may
                        not be larger than ten characters. The second element contains the field
                        type which is one of the constants listed in the table Constants for field
                        types. In the case of a character field or bcd field, you will have to
                        provide a third element specifying the length respectively the precesion of
                        the field. If your field specification contains blob fields, you will have
                        to make sure to either make the field large enough for all field values to
                        fit or specify a blob file with <strong>px_set_blob_file()</strong> for storing the blobs. If
                        this is not done the field data is truncated.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>px_new()</strong>
   * <strong>px_put_record()</strong>
   * <strong>fopen()</strong>


id: px_date2string
type: function
doc:
<comment>Description:</comment>
  Converts a date into a string
    
  
  Turns a date as it stored in the paradox file into human readable format. Paradox dates are the
  number of days since 1.1.0000. This function is just for convenience. It can be easily replaced by
  some math and the calendar functions as demonstrated in the example below.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$value </strong>  Value as stored in paradox database field of type PX_FIELD_DATE.
  <info>string  </info>  <strong>$format</strong>  String format similar to the format used by <strong>date()</strong>. The placeholders support by
                     this function is a subset of those supported by <strong>date()</strong> (Y, y, m, n, d, j, L).

<comment>Return:</comment>
  <info>string</info>  Întoarce valoarea <info>true</info> în cazul
          succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>px_timestamp2string()</strong>
   * <strong>jdtogregorian()</strong>


id: px_delete
type: function
doc:
<comment>Description:</comment>
  Deletes resource of paradox database
  
  Deletes the resource of the paradox file and frees all memory.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: px_delete_record
type: function
doc:
<comment>Description:</comment>
  Deletes record from paradox database
  
  This function deletes a record from the database. It does not free the space in the database file
  but just marks it as deleted. Inserting a new record afterwards will reuse the space.
  
  This function is only available if pxlib &gt;= 0.6.0 is used.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$num  </strong>  The record number is an artificial number counting records in the order as they
                    are stored in the database. The first record has number 0.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: px_get_field
type: function
doc:
<comment>Description:</comment>
  Returns the specification of a single field

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc  </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$fieldno</strong>  Number of the field. The first field has number 0. Specifying a field number
                      less than 0 and greater or equal the number of fields will trigger an error.

<comment>Return:</comment>
  <info>array</info>  Returns the specification of the fieldno'th database field as an associated array. The
         array contains three fields named <return>name</return>, <return>type</return>, and <return>size</return>.


id: px_get_info
type: function
doc:
<comment>Description:</comment>
  Return lots of information about a paradox file

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.

<comment>Return:</comment>
  <info>array</info>  Returns an associated array with lots of information about a paradox file. This array is
         likely to be extended in the future.
         
         Version of file multiplied by 10, e.g. 70.
         
         Name of table as stored in the file. If the database was created by pxlib, then this will
         be the name of the file without the extension.
         
         Number of records in this table.
         
         Number of fields in this table.
         
         Number of bytes used for the header. This is usually 0x800.
         
         Number of bytes used for each record. This is the sum of all field sizes (available since
         version 1.4.2).
         
         This value multiplied by 0x400 is the size of a data block in bytes. The maximum number of
         records in a datablock is the integer part of (maxtablesize * 0x400 - 8) / recordsize.
         
         The number of data blocks in the file. Each data block contains a certain number of records
         which depends on the record size and the data block size (maxtablesize). Data blocks may
         not necessarily be completely filled.
         
         Number of fields used for the primary index. The fields do always start with field number
         1.
         
         The DOS codepage which was used for encoding fields with character data. If the target
         encoding is not set with <strong>px_set_targetencoding()</strong> this will be the encoding for character
         fields when records are being accessed with <strong>px_get_record()</strong> or <strong>px_retrieve_record()</strong>.

<comment>See Also:</comment>
   * <strong>px_numfields()</strong>
   * <strong>px_numrecords()</strong>


id: px_get_parameter
type: function
doc:
<comment>Description:</comment>
  Gets a parameter
  
  Gets various parameters.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  The <strong>$name</strong> can be one of the following:
                    
                    The name of the table as it will be stored in the database header.
                    
                    The encoding for the output. Data which is being read from character fields with
                    <strong>px_get_record()</strong> or <strong>px_retrieve_record()</strong> is recoded into the targetencoding. If
                    it is not set, then the data will be delivered as stored in the database file.
                    
                    The encoding of the input data which is to be stored into the database. When
                    storing data of character fields in the database, the data is expected to be
                    delivered in this encoding.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the value of the parameter sau <info>false</info> în cazul eșecului.


id: px_get_record
type: function
doc:
<comment>Description:</comment>
  Returns record of paradox database

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$num  </strong>  The record number is an artificial number counting records in the order as they
                    are stored in the database. The first record has number 0.
  <info>int     </info>  <strong>$mode </strong>  The optional <strong>$mode</strong> can be <info>PX_KEYTOLOWER</info> or <info>PX_KEYTOUPPER</info> in order to convert the
                    keys of the returned array into lower or upper case. If <strong>$mode</strong> is not passed or
                    is 0, then the key will be exactly like the field name. The element values will
                    contain the field values. NULL values will be retained and are different from
                    0.0, 0 or the empty string. Fields of type <info>PX_FIELD_TIME</info> will be returned as an
                    integer counting the number of milliseconds starting at midnight. A timestamp
                    (<info>PX_FIELD_TIMESTAMP</info>) and date (<info>PX_FIELD_DATE</info>) are floating point respectively
                    int values counting milliseconds respectively days starting at the beginning of
                    julian calendar. Use the functions <strong>px-timestamp2string()</strong> and <strong>px-date2string()</strong> to
                    convert them into a character representation.

<comment>Return:</comment>
  <info>array</info>  Returns the <strong>$num</strong>'th record from the paradox database. The record is returned as an
         associated array with its keys being the field names.

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


id: px_get_schema
type: function
doc:
<comment>Description:</comment>
  Returns the database schema
  
  <strong>px_get_schema()</strong> returns the database schema.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$mode </strong>  If the optional <strong>$mode</strong> is <info>PX_KEYTOLOWER</info> or <info>PX_KEYTOUPPER</info> the keys of the returned
                    array will be converted to lower or upper case. If <strong>$mode</strong> is 0 or not passed at
                    all, then the key name will be identical to the field name.

<comment>Return:</comment>
  <info>array</info>  Returns the schema of a database file as an associated array. The key name is equal to the
         field name. Each array element is itself an associated array containing the two fields <return>type</return>
         and <return>size</return>. <return>type</return> is one of the constants in table Constants for field types. <return>size</return> is the
         number of bytes this field consumes in the record. The total of all field sizes is equal to
         the record size as it can be retrieved with <strong>px-get-info()</strong>.


id: px_get_value
type: function
doc:
<comment>Description:</comment>
  Gets a value
  
  Gets various values.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  <strong>$name</strong> can be one of the following. numprimkeys The number of primary keys.
                    Paradox databases always use the first <return>numprimkeys</return> fields for the primary index.
                    
                    The number of primary keys. Paradox databases always use the first <return>numprimkeys</return>
                    fields for the primary index.

<comment>Return:</comment>
  <info>floatfalse</info>  Returns the value of the parameter sau <info>false</info> în cazul eșecului.


id: px_insert_record
type: function
doc:
<comment>Description:</comment>
  Inserts record into paradox database
  
  Inserts a new record into the database. The record is not necessarily inserted at the end of the
  database, but may be inserted at any position depending on where the first free slot is found.
  
  The record data is passed as an array of field values. The elements in the array must correspond
  to the fields in the database. If the array has less elements than fields in the database, the
  remaining fields will be set to null.
  
  Most field values can be passed as its equivalent php type e.g. a long value is used for fields of
  type PX_FIELD_LONG, PX_FIELD_SHORT and PX_FIELD_AUTOINC, a double values is used for fields of
  type PX_FIELD_CURRENCY and PX_FIELD_NUMBER. Field values for blob and alpha fields are passed as
  strings.
  
  Fields of type PX_FIELD_TIME and PX_FIELD_DATE both require a long value. In the first case this
  is the number of milliseconds since midnight. In the second case this is the number of days since
  1.1.0000. Below there are two examples to convert the current date or timestamp into a value
  suitable for one of paradox's date/time fields.
  
  This function is only available if pxlib &gt;= 0.6.0 is used.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>array   </info>  <strong>$data </strong>  Associated or indexed array containing the field values as e.g. returned by
                    <strong>px_retrieve_record()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns <info>false</info> on failure or the record number in case of success.


id: px_new
type: function
doc:
<comment>Description:</comment>
  Create a new paradox object
  
  Create a new paradox object. You will have to call this function before any further functions.
  <strong>px_new()</strong> does not create any file on the disk, it just creates an instance of a paradox object.
  This function must not be called if the object oriented interface is used. Use <return>new paradox_db()</return>
  instead.

<comment>Return:</comment>
  <info>resource</info>  Returns <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>px_delete()</strong>
   * <strong>px_open_fp()</strong>


id: px_numfields
type: function
doc:
<comment>Description:</comment>
  Returns number of fields in a database
  
  Get the number of fields in a database file.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of fields in a database file. The return value of this function is
       identical to the element <return>numfields</return> in the array returned by <strong>px_get_info()</strong>.


id: px_numrecords
type: function
doc:
<comment>Description:</comment>
  Returns number of records in a database
  
  Get the number of records in a database file.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of records in a database file. The return value of this function is
       identical to the element <return>numrecords</return> in the array returned by <strong>px_get_info()</strong>.


id: px_open_fp
type: function
doc:
<comment>Description:</comment>
  Open paradox database
  
  Open an existing paradox database file. The actual file has to be opened before with <strong>fopen()</strong>. This
  function can also be used to open primary index files and tread them like a paradox database. This
  is supported for those who would like to investigate a primary index. It cannot be used to
  accelerate access to a database file.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>resource</info>  <strong>$file </strong>  <strong>$file</strong> is the return value from <strong>fopen()</strong> with the actual database file as
                    parameter. Make sure the database is writable if you plan to update or insert
                    records.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>fopen()</strong>
   * The example at <strong>px_new()</strong>


id: px_put_record
type: function
doc:
<comment>Description:</comment>
  Stores record into paradox database
  
  Stores a record into a paradox database. The record is always added at the end of the database,
  regardless of any free slots. Use <strong>px_insert_record()</strong> to add a new record into the first free slot
  found in the database.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>array   </info>  <strong>$record</strong>  Associated or indexed array containing the field values as e.g. returned by
                     <strong>px_retrieve_record()</strong>.
  <info>int     </info>  <strong>$recpos</strong>  This optional parameter may be used to specify a record number greater than the
                     current number of records in the database. The function will add as many empty
                     records as needed. There is hardly any need for this parameter.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: px_retrieve_record
type: function
doc:
<comment>Description:</comment>
  Returns record of paradox database
  
  This function is very similar to <strong>px_get_record()</strong> but uses internally a different approach to
  retrieve the data. It relies on pxlib for reading each single field value, which usually results
  in support for more field types.
  
  This function is only available if pxlib &gt;= 0.6.0 is used.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>int     </info>  <strong>$num  </strong>  The record number is an artificial number counting records in the order as they
                    are stored in the database. The first record has number 0.
  <info>int     </info>  <strong>$mode </strong>  The optional <strong>$mode</strong> can be <info>PX_KEYTOLOWER</info> or <info>PX_KEYTOUPPER</info> in order to convert the
                    keys into lower or upper case. If <strong>$mode</strong> is not passed or is 0, then the key will
                    be exactly like the field name. The element values will contain the field
                    values. NULL values will be retained and are different from 0.0, 0 or the empty
                    string. Fields of type <info>PX_FIELD_TIME</info> will be returned as an integer counting the
                    number of milliseconds starting at midnight. A timestamp is a floating point
                    value also counting milliseconds starting at the beginning of julian calendar.

<comment>Return:</comment>
  <info>array</info>  Returns the <strong>$num</strong>'th record from the paradox database. The record is returned as an
         associated array with its keys being the field names.

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


id: px_set_blob_file
type: function
doc:
<comment>Description:</comment>
  Sets the file where blobs are read from
  
  Sets the name of the file where blobs are going to be read from or written into. Without calling
  this function, <strong>px_get_record()</strong> or <strong>px_retrieve_record()</strong>  will only return data in blob fields if
  the data is part of the record and not stored in the blob file. Blob data is stored in the record
  if it is small enough to fit in the size of the blob field.
  
  Calling <strong>px_put_record()</strong>, <strong>px_insert_record()</strong>, or <strong>px_update_record()</strong> without calling
  <strong>px_set_blob_file()</strong> will result in truncated blob fields unless the data fits into the database
  file.
  
  Calling this function twice will close the first blob file and open the new one.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc   </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$filename</strong>  The name of the file. Its extension should be <return>.MB</return>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: px_set_parameter
type: function
doc:
<comment>Description:</comment>
  Sets a parameter
  
  Sets various parameters.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  Depending on the parameter you want to set, <strong>$name</strong> can be one of the following.
                    
                    The name of the table as it will be stored in the database header.
                    
                    The encoding for the output. Data which is being read from character fields is
                    recoded into the targetencoding.
                    
                    The encoding of the input data which is to be stored into the database.
  <info>string  </info>  <strong>$value</strong>  The value of parameter to set. For inputencoding and targetencoding this must be
                    the name of the encoding as understood by iconv or recode, e.g. iso-8859-1,
                    utf-8, cp850.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>px_get_info()</strong> to determine the DOS code page.


id: px_set_tablename
type: function
doc:
<comment>Description:</comment>
  Sets the name of a table (deprecated)
  
  Sets the table name of a paradox database, which was created with <strong>px_create_fp()</strong>. This function is
  deprecated use <strong>px_set_parameter()</strong> instead.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc    </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>        </info>  <strong>$tablename</strong>  The name of the table. If it is not set explicitly it will be set to the
                        name of the database file.

<comment>Return:</comment>
  <info>voidfalse</info>  Returns <info>null</info> on success sau <info>false</info> în cazul eșecului.


id: px_set_targetencoding
type: function
doc:
<comment>Description:</comment>
  Sets the encoding for character fields (deprecated)
  
  Set the encoding for data retrieved from a character field. All character fields will be recoded
  to the encoding set by this function. If the encoding is not set, the character data will be
  returned in the DOS code page encoding as specified in the database file. The <strong>$encoding</strong> can be any
  string identifier known to iconv or recode. On Unix systems run <return>iconv -l</return> for a list of available
  encodings.
  
  This function is deprecated and should be replaced by calling <strong>px_set_parameter()</strong>.
  
  See also <strong>px_get_info()</strong> to determine the DOS code page as stored in the database file.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc   </strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$encoding</strong>  The encoding for the output. Data which is being read from character fields
                       is recoded into the targetencoding.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>false</info> if the encoding could not be set, e.g. the encoding is unknown, or pxlib does
        not support recoding at all. In the second case a warning will be issued.


id: px_set_value
type: function
doc:
<comment>Description:</comment>
  Sets a value
  
  Sets various values.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>string  </info>  <strong>$name </strong>  <strong>$name</strong> can be one of the following.
                    
                    The number of primary keys. Paradox databases always use the first numprimkeys
                    fields for the primary index.
  <info>float   </info>  <strong>$value</strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: px_timestamp2string
type: function
doc:
<comment>Description:</comment>
  Converts the timestamp into a string
    
  
  Turns a timestamp as it stored in the paradox file into human readable format. Paradox timestamps
  are the number of miliseconds since 0001-01-02. This function is just for convenience. It can be
  easily replaced by some math and the calendar functions as demonstrated in the following example.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc </strong>  Resource identifier of the paradox database.
  <info>float   </info>  <strong>$value </strong>  Value as stored in paradox database field of type PX_FIELD_TIME, or
                     PX_FIELD_TIMESTAMP.
  <info>string  </info>  <strong>$format</strong>  String format similar to the format used by <strong>date()</strong>. The placeholders support by
                     this function is a subset of those supported by <strong>date()</strong> (Y, y, m, n, d, j, H, h,
                     G, g, i, s, A, a, L).

<comment>Return:</comment>
  <info>string</info>  Întoarce valoarea <info>true</info> în cazul
          succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>px_date2string()</strong>
   * <strong>jdtogregorian()</strong>


id: px_update_record
type: function
doc:
<comment>Description:</comment>
  Updates record in paradox database
  
  Updates an exiting record in the database. The record starts at 0.
  
  The record data is passed as an array of field values. The elements in the array must correspond
  to the fields in the database. If the array has less elements than fields in the database, the
  remaining fields will be set to null.
  
  This function is only available if pxlib &gt;= 0.6.0 is used.

<comment>Param:</comment>
  <info>resource</info>  <strong>$pxdoc</strong>  Resource identifier of the paradox database as returned by <strong>px_new()</strong>.
  <info>array   </info>  <strong>$data </strong>  Associated array containing the field values as returned by
                    <strong>px_retrieve_record()</strong>.
  <info>int     </info>  <strong>$num  </strong>  The record number is an artificial number counting records in the order as they
                    are stored in the database. The first record has number 0.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: quoted_printable_decode
type: function
doc:
<comment>Description:</comment>
  Convert a quoted-printable string to an 8 bit string
  
  This function returns an 8-bit binary string corresponding to the decoded quoted printable string
  (according to RFC2045, section 6.7, not RFC2821, section 4.5.2, so additional periods are not
  stripped from the beginning of line).
  
  This function is similar to <strong>imap_qprint()</strong>, except this one does not require the IMAP module to
  work.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The input string.

<comment>Return:</comment>
  <info>string</info>  Returns the 8-bit binary string.

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


id: quoted_printable_encode
type: function
doc:
<comment>Description:</comment>
  Convert a 8 bit string to a quoted-printable string
  
  Returns a quoted printable string created according to RFC2045, section 6.7.
  
  This function is similar to <strong>imap_8bit()</strong>, except this one does not require the IMAP module to work.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The input string.

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

<comment>See Also:</comment>
   * <strong>quoted_printable_decode()</strong>
   * <strong>iconv_mime_encode()</strong>


id: quotemeta
type: function
doc:
<comment>Description:</comment>
  Quote meta characters
  
  Returns a version of str with a backslash character (<return>\</return>) before every character that is among
  these:  . \ + * ? [ ^ ] ( $ )

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The input string.

<comment>Return:</comment>
  <info>string</info>  Returns the string with meta characters quoted, or <info>false</info> if an empty string is given as
          <strong>$string</strong>.

<comment>See Also:</comment>
   * <strong>addslashes()</strong>
   * <strong>addcslashes()</strong>
   * <strong>htmlentities()</strong>
   * <strong>htmlspecialchars()</strong>
   * <strong>nl2br()</strong>
   * <strong>stripslashes()</strong>
   * <strong>stripcslashes()</strong>
   * <strong>ereg()</strong>
   * <strong>preg_quote()</strong>


id: rad2deg
type: function
doc:
<comment>Description:</comment>
  Converts the radian number to the equivalent number in degrees
    
  
  This function converts <strong>$num</strong> from radian to degrees.

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  A radian value

<comment>Return:</comment>
  <info>float</info>  The equivalent of <strong>$num</strong> in degrees

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


id: radius_acct_open
type: function
doc:
<comment>Description:</comment>
  Creates a Radius handle for accounting

<comment>Return:</comment>
  <info>resource</info>  Returns a handle on success, <info>false</info> on error. This function only fails if insufficient
            memory is available.


id: radius_add_server
type: function
doc:
<comment>Description:</comment>
  Adds a server
  
  <strong>radius_add_server()</strong> may be called multiple times, and it may be used together with
  <strong>radius_config()</strong>. At most 10 servers may be specified. When multiple servers are given, they are
  tried in round-robin fashion until a valid response is received, or until each server's <strong>$max_tries</strong>
  limit has been reached.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  
  <info>string  </info>  <strong>$hostname     </strong>  The <strong>$hostname</strong> parameter specifies the server host, either as a fully
                            qualified domain name or as a dotted-quad IP address in text form.
  <info>int     </info>  <strong>$port         </strong>  The <strong>$port</strong> specifies the UDP port to contact on the server. If port is
                            given as 0, the library looks up the radius/udp or radacct/udp service
                            in the network services database, and uses the port found there.  If no
                            entry is found, the library uses the standard Radius ports, 1812 for
                            authentication and 1813 for accounting.
  <info>string  </info>  <strong>$secret       </strong>  The shared secret for the server host is passed to the <strong>$secret</strong>
                            parameter. The Radius protocol ignores all but the leading 128 bytes of
                            the shared secret.
  <info>int     </info>  <strong>$timeout      </strong>  The timeout for receiving replies from the server is passed to the
                            <strong>$timeout</strong> parameter, in units of seconds.
  <info>int     </info>  <strong>$max_tries    </strong>  The maximum number of repeated requests to make before giving up is
                            passed into the <strong>$max_tries</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_auth_open
type: function
doc:
<comment>Description:</comment>
  Creates a Radius handle for authentication

<comment>Return:</comment>
  <info>resource</info>  Returns a handle on success, <info>false</info> on error. This function only fails if insufficient
            memory is available.


id: radius_close
type: function
doc:
<comment>Description:</comment>
  Frees all ressources
  
  It is not needed to call this function because php frees all resources at the end of each request.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: radius_config
type: function
doc:
<comment>Description:</comment>
  Causes the library to read the given configuration file
  
  Before issuing any Radius requests, the library must be made aware of the servers it can contact.
  The easiest way to configure the library is to call <strong>radius_config()</strong>. <strong>radius_config()</strong> causes the
  library to read a configuration file whose format is described in radius.conf.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  
  <info>string  </info>  <strong>$file         </strong>  The pathname of the configuration file is passed as the file argument to
                            <strong>radius_config()</strong>. The library can also be configured programmatically by
                            calls to <strong>radius_add_server()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_create_request
type: function
doc:
<comment>Description:</comment>
  Create accounting or authentication request
  
  A Radius request consists of a code specifying the kind of request, and zero or more attributes
  which provide additional information. To begin constructing a new request, call
  <strong>radius_create_request()</strong>.
  
  Attention: You must call this function, before you can put any attribute!

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  
  <info>int     </info>  <strong>$type         </strong>  Type is <info>RADIUS_ACCESS_REQUEST</info> or <info>RADIUS_ACCOUNTING_REQUEST</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_cvt_addr
type: function
doc:
<comment>Description:</comment>
  Converts raw data to IP-Address

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

<comment>See Also:</comment>
   * <strong>radius_cvt_int()</strong>
   * <strong>radius_cvt_string()</strong>


id: radius_cvt_int
type: function
doc:
<comment>Description:</comment>
  Converts raw data to integer

<comment>Return:</comment>
  <info>int</info>  

<comment>See Also:</comment>
   * <strong>radius_cvt_addr()</strong>
   * <strong>radius_cvt_string()</strong>


id: radius_cvt_string
type: function
doc:
<comment>Description:</comment>
  Converts raw data to string

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

<comment>See Also:</comment>
   * <strong>radius_cvt_addr()</strong>
   * <strong>radius_cvt_int()</strong>


id: radius_demangle
type: function
doc:
<comment>Description:</comment>
  Demangles data
  
  Some data (Passwords, MS-CHAPv1 MPPE-Keys) is mangled for security reasons, and must be demangled
  before you can use them.

<comment>Return:</comment>
  <info>string</info>  Returns the demangled string, or <info>false</info> on error.


id: radius_demangle_mppe_key
type: function
doc:
<comment>Description:</comment>
  Derives mppe-keys from mangled data
  
  When using MPPE with MS-CHAPv2, the send- and recv-keys are mangled (see RFC 2548), however this
  function is useless, because I don't think that there is or will be a PPTP-MPPE implementation in
  PHP.

<comment>Return:</comment>
  <info>string</info>  Returns the demangled string, or <info>false</info> on error.


id: radius_get_attr
type: function
doc:
<comment>Description:</comment>
  Extracts an attribute
  
  Like Radius requests, each response may contain zero or more attributes. After a response has been
  received successfully by <strong>radius_send_request()</strong>, its attributes can be extracted one by one using
  <strong>radius_get_attr()</strong>. Each time <strong>radius_get_attr()</strong> is called, it gets the next attribute from the
  current response.

<comment>Return:</comment>
  <info>mixed</info>  Returns an associative array containing the attribute-type and the data, or error number \<= 0.

<comment>See Also:</comment>
   * <strong>radius_put_attr()</strong>
   * <strong>radius_get_vendor_attr()</strong>
   * <strong>radius_put_vendor_attr()</strong>
   * <strong>radius_send_request()</strong>


id: radius_get_tagged_attr_data
type: function
doc:
<comment>Description:</comment>
  Extracts the data from a tagged attribute
  
  If a tagged attribute has been returned from <strong>radius_get_attr()</strong>, <strong>radius_get_tagged_attr_data()</strong> will
  return the data from the attribute.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  The tagged attribute to be decoded.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the data from the tagged attribute  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_get_attr()</strong>
   * <strong>radius_get_tagged_attr_tag()</strong>


id: radius_get_tagged_attr_tag
type: function
doc:
<comment>Description:</comment>
  Extracts the tag from a tagged attribute
  
  If a tagged attribute has been returned from <strong>radius_get_attr()</strong>, <strong>radius_get_tagged_attr_data()</strong> will
  return the tag from the attribute.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  The tagged attribute to be decoded.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the tag from the tagged attribute  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_get_attr()</strong>
   * <strong>radius_get_tagged_attr_data()</strong>


id: radius_get_vendor_attr
type: function
doc:
<comment>Description:</comment>
  Extracts a vendor specific attribute
  
  If <strong>radius_get_attr()</strong> returns <info>RADIUS_VENDOR_SPECIFIC</info>, <strong>radius_get_vendor_attr()</strong> may be called to
  determine the vendor.

<comment>Return:</comment>
  <info>array</info>  Returns an associative array containing the attribute-type, vendor and the data, or <info>false</info>
         on error.

<comment>See Also:</comment>
   * <strong>radius_get_attr()</strong>
   * <strong>radius_put_vendor_attr()</strong>


id: radius_put_addr
type: function
doc:
<comment>Description:</comment>
  Attaches an IP address attribute
  
  Attaches an IP address attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$addr         </strong>  An IPv4 address in string form, such as <return>10.0.0.1</return>.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: radius_put_attr
type: function
doc:
<comment>Description:</comment>
  Attaches a binary attribute
  
  Attaches a binary attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$value        </strong>  The attribute value, which will be treated as a raw binary string.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_get_attr()</strong>
   * <strong>radius_get_vendor_attr()</strong>
   * <strong>radius_put_vendor_attr()</strong>


id: radius_put_int
type: function
doc:
<comment>Description:</comment>
  Attaches an integer attribute
  
  Attaches an integer attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>int     </info>  <strong>$value        </strong>  The attribute value.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_put_string()</strong>
   * <strong>radius_put_vendor_int()</strong>
   * <strong>radius_put_vendor_string()</strong>


id: radius_put_string
type: function
doc:
<comment>Description:</comment>
  Attaches a string attribute
  
  Attaches a string attribute to the current RADIUS request. In general, <strong>radius_put_attr()</strong> is a more
  useful function for attaching string attributes, as it is binary safe.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$value        </strong>  The attribute value. This value is expected by the underlying library to
                            be null terminated, therefore this parameter is not binary safe.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_put_int()</strong>
   * <strong>radius_put_vendor_int()</strong>
   * <strong>radius_put_vendor_string()</strong>


id: radius_put_vendor_addr
type: function
doc:
<comment>Description:</comment>
  Attaches a vendor specific IP address attribute
  
  Attaches an IP address vendor specific attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$vendor       </strong>  ID-ul vânzătorului (producătorului).
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$addr         </strong>  An IPv4 address in string form, such as <return>10.0.0.1</return>.
  <info>        </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>        </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: radius_put_vendor_attr
type: function
doc:
<comment>Description:</comment>
  Attaches a vendor specific binary attribute
  
  Attaches a vendor specific binary attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$vendor       </strong>  ID-ul vânzătorului (producătorului).
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$value        </strong>  The attribute value, which will be treated as a raw binary string.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_put_vendor_int
type: function
doc:
<comment>Description:</comment>
  Attaches a vendor specific integer attribute
  
  Attaches a vendor specific integer attribute to the current RADIUS request.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$vendor       </strong>  ID-ul vânzătorului (producătorului).
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>int     </info>  <strong>$value        </strong>  The attribute value.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_put_vendor_string
type: function
doc:
<comment>Description:</comment>
  Attaches a vendor specific string attribute
  
  Attaches a vendor specific string attribute to the current RADIUS request. In general,
  <strong>radius_put_vendor_attr()</strong> is a more useful function for attaching string attributes, as it is
  binary safe.
  
  O interpelare trebuie să fie creată cu ajutorul
  <strong>radius_create_request()</strong>înainte ca această funcție să poată fi
  apelată.

<comment>Param:</comment>
  <info>resource</info>  <strong>$radius_handle</strong>  Resursa RADIUS.
  <info>int     </info>  <strong>$vendor       </strong>  ID-ul vânzătorului (producătorului).
  <info>int     </info>  <strong>$type         </strong>  Tipul atributului.
  <info>string  </info>  <strong>$value        </strong>  The attribute value. This value is expected by the underlying library to
                            be null terminated, therefore this parameter is not binary safe.
  <info>int     </info>  <strong>$options      </strong>  O mască de biți a
                            opțiunilor atributului. Opțiunile disponibile includ
                            <info>RADIUS_OPTION_TAGGED</info> și
                            <info>RADIUS_OPTION_SALT</info>.
  <info>int     </info>  <strong>$tag          </strong>  Eticheta atributului.
                            Acest parametru e ignorat dacă nu a fost stabilită opțiunea
                            <info>RADIUS_OPTION_TAGGED</info>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: radius_request_authenticator
type: function
doc:
<comment>Description:</comment>
  Returns the request authenticator
  
  The request authenticator is needed for demangling mangled data like passwords and
  encryption-keys.

<comment>Return:</comment>
  <info>string</info>  Returns the request authenticator as string, or <info>false</info> on error.

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


id: radius_salt_encrypt_attr
type: function
doc:
<comment>Description:</comment>
  Salt-encrypts a value
  
  Applies the RADIUS salt-encryption algorithm to the given value.
  
  In general, this is achieved automatically by providing the <info>RADIUS_OPTION_SALT</info> option to an
  attribute setter function, but this function can be used if low-level request construction is
  required.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  The data to be salt-encrypted.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the salt-encrypted data  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>radius_put_addr()</strong>
   * <strong>radius_put_attr()</strong>
   * <strong>radius_put_int()</strong>
   * <strong>radius_put_string()</strong>


id: radius_send_request
type: function
doc:
<comment>Description:</comment>
  Sends the request and waits for a reply
  
  After the Radius request has been constructed, it is sent by <strong>radius_send_request()</strong>.
  
  The <strong>radius_send_request()</strong> function sends the request and waits for a valid reply, retrying the
  defined servers in round-robin fashion as necessary.

<comment>Return:</comment>
  <info>int</info>  If a valid response is received, <strong>radius_send_request()</strong> returns the Radius code which
       specifies the type of the response. This will typically be <info>RADIUS_ACCESS_ACCEPT</info>,
       <info>RADIUS_ACCESS_REJECT</info>, or <info>RADIUS_ACCESS_CHALLENGE</info>. If no valid response is received,
       <strong>radius_send_request()</strong> returns <info>false</info>.

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


id: radius_server_secret
type: function
doc:
<comment>Description:</comment>
  Returns the shared secret
  
  The shared secret is needed as salt for demangling mangled data like passwords and
  encryption-keys.

<comment>Return:</comment>
  <info>string</info>  Returns the server's shared secret as string, or <info>false</info> on error.


id: radius_strerror
type: function
doc:
<comment>Description:</comment>
  Returns an error message
  
  If Radius-functions fail then they record an error message. This error message can be retrieved
  with this function.

<comment>Return:</comment>
  <info>string</info>  Returns error messages as string from failed radius functions.


id: rand
type: function
doc:
<comment>Description:</comment>
  Generate a random integer
  
  If called without the optional <strong>$min</strong>, <strong>$max</strong> arguments <strong>rand()</strong> returns a pseudo-random integer between
  0 and <strong>getrandmax()</strong>.  If you want a random number between 5 and 15 (inclusive), for example, use
  <return>rand(5, 15)</return>.
  
  Această funcție nu generează valori securizate din punct de vedere
  criptografic și deci nu trebuie utilizată pentru scopuri criptografice. Dacă
  aveți nevoie de o valoare securizată din punct de vedere criptografic considerați
  utilizarea <strong>random_int()</strong>, <strong>random_bytes()</strong> sau
  <strong>openssl_random_pseudo_bytes()</strong> în schimb.
  
  On some platforms (such as Windows), <strong>getrandmax()</strong> is only 32767.  If you require a range larger
  than 32767, specifying <strong>$min</strong> and <strong>$max</strong> will allow you to create a range larger than this, or
  consider using <strong>mt_rand()</strong> instead.
  
  As of PHP 7.1.0, <strong>rand()</strong> uses the same random number generator as <strong>mt_rand()</strong>. To preserve backwards
  compatibility <strong>rand()</strong> allows <strong>$max</strong> to be smaller than <strong>$min</strong> as opposed to returning <info>false</info> as
  <strong>mt_rand()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$min</strong>  The lowest value to return (default: 0)
  <info>int</info>  <strong>$max</strong>  The highest value to return (default: <strong>getrandmax()</strong>)

<comment>Return:</comment>
  <info>int</info>  A pseudo random value between <strong>$min</strong> (or 0) and <strong>$max</strong> (or <strong>getrandmax()</strong>, inclusive).

<comment>See Also:</comment>
   * <strong>srand()</strong>
   * <strong>getrandmax()</strong>
   * <strong>mt_rand()</strong>
   * <strong>random_int()</strong>
   * <strong>random_bytes()</strong>
   * <strong>openssl_random_pseudo_bytes()</strong>


id: random_bytes
type: function
doc:
<comment>Description:</comment>
  Generates cryptographically secure pseudo-random bytes
  
  Generates an arbitrary length string of cryptographic random bytes that are suitable for
  cryptographic use, such as when generating salts, keys or initialization vectors.
  
  Sursele de valori aleatorii utilizate pentru această funcție sunt următoarele:
  
  Pe Windows se va utiliza întotdeauna <strong>CryptGenRandom()</strong>. Începând cu PHP 7.2.0 se va utiliza
  întotdeauna CNG-API.
  
  Pe Linux se va utiliza apelul de sistem (syscall) getrandom(2) dacă este disponibil.
  
  Pe alte platforme se va utiliza /dev/urandom.
  
  Dacă nici una din sursele menționate nu sunt disponibile, va fi emisă o excepție <class>Exception</class>.
  
  Cu toate că această funcție a fost adăugată în PHP 7.0, o implementare în spațiul utilizatorului
  este disponibilă pentru PHP de la versiunea 5.2 până la 5.6 inclusiv.

<comment>Param:</comment>
  <info>int</info>  <strong>$length</strong>  The length of the random string that should be returned in bytes.

<comment>Return:</comment>
  <info>string</info>  Returns a string containing the requested number of cryptographically secure random bytes.

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


id: random_int
type: function
doc:
<comment>Description:</comment>
  Generates cryptographically secure pseudo-random integers
  
  Generates cryptographic random integers that are suitable for use where unbiased results are
  critical, such as when shuffling a deck of cards for a poker game.
  
  Sursele de valori aleatorii utilizate pentru această funcție sunt următoarele:
  
  Pe Windows se va utiliza întotdeauna <strong>CryptGenRandom()</strong>. Începând cu PHP 7.2.0 se va utiliza
  întotdeauna CNG-API.
  
  Pe Linux se va utiliza apelul de sistem (syscall) getrandom(2) dacă este disponibil.
  
  Pe alte platforme se va utiliza /dev/urandom.
  
  Dacă nici una din sursele menționate nu sunt disponibile, va fi emisă o excepție <class>Exception</class>.
  
  Cu toate că această funcție a fost adăugată în PHP 7.0, o implementare în spațiul utilizatorului
  este disponibilă pentru PHP de la versiunea 5.2 până la 5.6 inclusiv.

<comment>Param:</comment>
  <info>int</info>  <strong>$min</strong>  The lowest value to be returned, which must be <info>PHP_INT_MIN</info> or higher.
  <info>int</info>  <strong>$max</strong>  The highest value to be returned, which must be less than or equal to <info>PHP_INT_MAX</info>.

<comment>Return:</comment>
  <info>int</info>  Returns a cryptographically secure random integer in the range <strong>$min</strong> to <strong>$max</strong>, inclusive.

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


id: range
type: function
doc:
<comment>Description:</comment>
  Create an array containing a range of elements
  
  Create an array containing a range of elements.

<comment>Param:</comment>
  <info>stringintfloat</info>  <strong>$start</strong>  First value of the sequence.
  <info>stringintfloat</info>  <strong>$end  </strong>  The sequence is ended upon reaching the <strong>$end</strong> value.
  <info>intfloat      </info>  <strong>$step </strong>  If a <strong>$step</strong> value is given, it will be used as the increment between
                          elements in the sequence.  <strong>$step</strong> should be given as a positive number.  If
                          not specified, <strong>$step</strong> will default to 1.

<comment>Return:</comment>
  <info>array</info>  Returns an array of elements from <strong>$start</strong> to <strong>$end</strong>, inclusive.

<comment>See Also:</comment>
   * <strong>shuffle()</strong>
   * <strong>array_fill()</strong>
   * foreach


id: rar_wrapper_cache_stats
type: function
doc:
<comment>Description:</comment>
  Cache hits and misses for the URL wrapper
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

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


id: rawurldecode
type: function
doc:
<comment>Description:</comment>
  Decode URL-encoded strings
  
  Returns a string in which the sequences with percent (<return>%</return>) signs followed by two hex digits have
  been replaced with literal characters.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The URL to be decoded.

<comment>Return:</comment>
  <info>string</info>  Returns the decoded URL, as a string.

<comment>See Also:</comment>
   * <strong>rawurlencode()</strong>
   * <strong>urldecode()</strong>
   * <strong>urlencode()</strong>
   * RFC 3986


id: rawurlencode
type: function
doc:
<comment>Description:</comment>
  URL-encode according to RFC 3986
  
  Encodes the given string according to RFC 3986.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The URL to be encoded.

<comment>Return:</comment>
  <info>string</info>  Returns a string in which all non-alphanumeric characters except <return>-_.~</return> have been replaced
          with a percent (<return>%</return>) sign followed by two hex digits.  This is the encoding described in RFC
          3986 for protecting literal characters from being interpreted as special URL delimiters,
          and for protecting URLs from being mangled by transmission media with character
          conversions (like some email systems).  Prior to PHP 5.3.0, rawurlencode encoded tildes
          (<return>~</return>) as per RFC 1738.
          
          Prior to PHP 5.3.0, rawurlencode encoded tildes (<return>~</return>) as per RFC 1738.

<comment>See Also:</comment>
   * <strong>rawurldecode()</strong>
   * <strong>urldecode()</strong>
   * <strong>urlencode()</strong>
   * RFC 3986


id: read_exif_data
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru exif_read_data
  
  Această funcție este pseudonim pentru:  <strong>exif_read_data()</strong>.


id: readdir
type: function
doc:
<comment>Description:</comment>
  Read entry from directory handle
  
  Returns the name of the next entry in the directory. The entries are returned in the order in
  which they are stored by the filesystem.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dir_handle</strong>  The directory handle <info>resource</info> previously opened with <strong>opendir()</strong>. If the
                         directory handle is  not specified, the last link opened by <strong>opendir()</strong>  is
                         assumed.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the entry name on success sau <info>false</info> în cazul eșecului.
               
               Această funcție poate întoarce valoarea Boolean <info>false</info>, dar poate de
               asemenea întoarce o valoare non-Boolean care evaluează în <info>false</info>. Vă rugăm să
               citiți secțiunea despre tipul Boolean
               pentru informații suplimentare. Utilizați
               operatorul === pentru a
               verifica valoarea întoarsă de această funcție.

<comment>See Also:</comment>
   * <strong>is_dir()</strong>
   * <strong>glob()</strong>
   * <strong>opendir()</strong>
   * <strong>scandir()</strong>


id: readfile
type: function
doc:
<comment>Description:</comment>
  Outputs a file
  
  Reads a file and writes it to the output buffer.

<comment>Param:</comment>
  <info>string  </info>  <strong>$filename        </strong>  The filename being read.
  <info>bool    </info>  <strong>$use_include_path</strong>  You can use the optional second parameter and set it to <info>true</info>, if you
                               want to search for the file in the include_path, too.
  <info>resource</info>  <strong>$context         </strong>  A context stream <info>resource</info>.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the number of bytes read from the file on success, sau <info>false</info> în cazul eșecului

<comment>See Also:</comment>
   * <strong>fpassthru()</strong>
   * <strong>file()</strong>
   * <strong>fopen()</strong>
   * <strong>include()</strong>
   * <strong>require()</strong>
   * <strong>virtual()</strong>
   * <strong>file_get_contents()</strong>
   * 


id: readgzfile
type: function
doc:
<comment>Description:</comment>
  Output a gz-file
  
  Reads a file, decompresses it and writes it to standard output.
  
  <strong>readgzfile()</strong> can be used to read a file which is not in gzip format; in this case <strong>readgzfile()</strong>
  will directly  read from the file without decompression.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename        </strong>  The file name. This file will be opened from the filesystem and its
                             contents written to standard output.
  <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>intfalse</info>  Returns the number of (uncompressed) bytes read from the file on success, sau <info>false</info> în
            cazul eșecului

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


id: readline
type: function
doc:
<comment>Description:</comment>
  Reads a line
  
  Reads a single line from the user. You must add this line to the history yourself using
  <strong>readline_add_history()</strong>.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$prompt</strong>  You may specify a string with which to prompt the user.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a single string from the user. The line returned has the ending newline
               removed. If there is no more data to read, then <info>false</info> is returned.


id: readline_add_history
type: function
doc:
<comment>Description:</comment>
  Adds a line to the history
  
  This function adds a line to the command line history.

<comment>Param:</comment>
  <info>string</info>  <strong>$prompt</strong>  The line to be added in the history.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: readline_callback_handler_install
type: function
doc:
<comment>Description:</comment>
  Initializes the readline callback interface and terminal, prints the prompt and returns
  immediately
  
  Readline Callback Interface Example 10) { $prompting = false; readline_callback_handler_remove();
  } else { readline_callback_handler_install("[$c] Enter something: ", 'rl_callback'); }
  }
  
  $c = 1;
  $prompting = true;
  
  readline_callback_handler_install("[$c] Enter something: ", 'rl_callback');
  
  while ($prompting) { $w = NULL; $e = NULL; $n = stream_select($r = array(STDIN), $w, $e, null); if
  ($n && in_array(STDIN, $r)) { // read a character, will call the callback when a newline is
  entered readline_callback_read_char(); }
  }
  
  echo "Prompting disabled. All done.\n";
  ?>
  ]]>

<comment>Param:</comment>
  <info>string  </info>  <strong>$prompt  </strong>  The prompt message.
  <info>callable</info>  <strong>$callback</strong>  The <strong>$callback</strong> function takes one parameter; the user input returned.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>readline_callback_handler_remove()</strong>
   * <strong>readline_callback_read_char()</strong>
   * <strong>stream_select()</strong>


id: readline_callback_handler_remove
type: function
doc:
<comment>Description:</comment>
  Removes a previously installed callback handler and restores terminal settings
  
  Removes a previously installed callback handler and restores terminal settings.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if a previously installed callback handler was removed, or <info>false</info> if one could
        not be found.

<comment>See Also:</comment>
   * <strong>readline_callback_handler_install()</strong>
   * <strong>readline_callback_read_char()</strong>


id: readline_callback_read_char
type: function
doc:
<comment>Description:</comment>
  Reads a character and informs the readline callback interface when a line is received
  
  Reads a character of user input. When a line is received, this function informs the readline
  callback interface installed using <strong>readline_callback_handler_install()</strong> that a line is ready for
  input.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * <strong>readline_callback_handler_install()</strong>
   * <strong>readline_callback_handler_remove()</strong>


id: readline_clear_history
type: function
doc:
<comment>Description:</comment>
  Clears the history
  
  This function clears the entire command line history.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: readline_completion_function
type: function
doc:
<comment>Description:</comment>
  Registers a completion function
  
  This function registers a completion function. This is the same kind of functionality you'd get if
  you hit your tab key while using Bash.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  You must supply the name of an existing function which accepts a partial
                       command line and returns an array of possible matches.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: readline_info
type: function
doc:
<comment>Description:</comment>
  Gets/sets various internal readline variables
  
  Gets or sets various internal readline variables.

<comment>Param:</comment>
  <info>stringnull       </info>  <strong>$var_name</strong>  A variable name.
  <info>intstringboolnull</info>  <strong>$value   </strong>  If provided, this will be the new value of the setting.

<comment>Return:</comment>
  <info>mixed</info>  If called with no parameters, this function returns an array of values for all the setting
         readline uses.  The elements will be indexed by the following values: done, end,
         erase_empty_line, library_version, line_buffer, mark, pending_input, point, prompt,
         readline_name, and terminal_name.
         
         If called with one or two parameters, the old value is returned.


id: readline_list_history
type: function
doc:
<comment>Description:</comment>
  Lists the history
  
  Gets the entire command line history.

<comment>Return:</comment>
  <info>array</info>  Returns an array of the entire command line history.  The elements are indexed by integers
         starting at zero.


id: readline_on_new_line
type: function
doc:
<comment>Description:</comment>
  Inform readline that the cursor has moved to a new line
  
  Tells readline that the cursor has moved to a new line.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.


id: readline_read_history
type: function
doc:
<comment>Description:</comment>
  Reads the history
  
  This function reads a command history from a file.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$filename</strong>  Path to the filename containing the command history.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: readline_redisplay
type: function
doc:
<comment>Description:</comment>
  Redraws the display
  
  Redraws readline to redraw the display.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.


id: readline_write_history
type: function
doc:
<comment>Description:</comment>
  Writes the history
  
  This function writes the command history to a file.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$filename</strong>  Path to the saved file.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: readlink
type: function
doc:
<comment>Description:</comment>
  Returns the target of a symbolic link
  
  <strong>readlink()</strong> does the same as the readlink C function.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>  The symbolic link path.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the contents of the symbolic link path or <info>false</info> on error.
               
               The function fails if <strong>$path</strong> is not a symlink, except on Windows, where the normalized
               path will be returned.

<comment>See Also:</comment>
   * <strong>is_link()</strong>
   * <strong>symlink()</strong>
   * <strong>linkinfo()</strong>


id: realpath
type: function
doc:
<comment>Description:</comment>
  Returns canonicalized absolute pathname
  
  <strong>realpath()</strong> expands all symbolic links and resolves references to <return>/./</return>, <return>/../</return> and extra <return>/</return> characters
  in the input <strong>$path</strong> and returns the canonicalized absolute pathname.

<comment>Param:</comment>
  <info>string</info>  <strong>$path</strong>  The path being checked.  Whilst a path must be supplied, the value can be an empty
                 string. In this case, the value is interpreted as the current directory.
                 
                 Whilst a path must be supplied, the value can be an empty string. In this case, the
                 value is interpreted as the current directory.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the canonicalized absolute pathname on success. The resulting path  will have
               no symbolic link, <return>/./</return> or <return>/../</return> components. Trailing delimiters, such as <return>\</return> and <return>/</return>, are
               also removed.
               
               <strong>realpath()</strong> returns <info>false</info> on failure, e.g. if the file does not exist.
               
               The running script must have executable permissions on all directories in the
               hierarchy, otherwise <strong>realpath()</strong> will return <info>false</info>.
               
               For case-insensitive filesystems <strong>realpath()</strong> may or may not normalize the character
               case.
               
               The function <strong>realpath()</strong> will not work for a file which is inside a Phar as such path
               would be a virtual path, not a real one.
               
               On Windows, junctions and symbolic links to directories are only expanded by one
               level.
               
               Deoarece tipul întreg al PHP este cu semn și multe platforme utilizează întregi
               de 32 de biți, unele funcții ale sistemului de fișiere pot întoarce rezultate
               neașteptate pentru fișiere ce depășesc 2GB.

<comment>See Also:</comment>
   * <strong>basename()</strong>
   * <strong>dirname()</strong>
   * <strong>pathinfo()</strong>


id: realpath_cache_get
type: function
doc:
<comment>Description:</comment>
  Get realpath cache entries
  
  Get the contents of the realpath cache.

<comment>Return:</comment>
  <info>array</info>  Returns an array of realpath cache entries. The keys are original path entries, and the
         values are arrays of data items, containing the resolved path, expiration date, and other
         options kept in the cache.

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


id: realpath_cache_size
type: function
doc:
<comment>Description:</comment>
  Get realpath cache size
  
  Get the amount of memory used by the realpath cache.

<comment>Return:</comment>
  <info>int</info>  Returns how much memory realpath cache is using.

<comment>See Also:</comment>
   * <strong>realpath_cache_get()</strong>
   * 
     The realpath_cache_size
     configuration option
    


id: recode
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru recode_string
  
  Această funcție este pseudonim pentru:  <strong>recode_string()</strong>.


id: recode_file
type: function
doc:
<comment>Description:</comment>
  Recode from file to file according to recode request
  
  Recode the file referenced by file handle <strong>$input</strong> into the file referenced by file handle <strong>$output</strong>
  according to the recode <strong>$request</strong>.

<comment>Param:</comment>
  <info>string  </info>  <strong>$request</strong>  The desired recode request type
  <info>resource</info>  <strong>$input  </strong>  A local file handle <info>resource</info> for  the <strong>$input</strong>
  <info>resource</info>  <strong>$output </strong>  A local file handle <info>resource</info> for  the <strong>$output</strong>

<comment>Return:</comment>
  <info>bool</info>  Returns <info>false</info>, if unable to comply, <info>true</info> otherwise.

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


id: recode_string
type: function
doc:
<comment>Description:</comment>
  Recode a string according to a recode request
  
  Recode the string <strong>$string</strong> according to the recode request <strong>$request</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$request</strong>  The desired recode request type
  <info>string</info>  <strong>$string </strong>  The <info>string</info> to be recoded

<comment>Return:</comment>
  <info>string</info>  Returns the recoded <info>string</info> or <info>false</info>, if unable to  perform the recode request.

<comment>See Also:</comment>
   * 
     The GNU Recode documentation of your installation for detailed 
     instructions about recode requests.
    


id: register_shutdown_function
type: function
doc:
<comment>Description:</comment>
  Register a function for execution on shutdown
  
  Registers a <strong>$callback</strong> to be executed after script execution finishes or <strong>exit()</strong> is called.
  
  Multiple calls to <strong>register_shutdown_function()</strong> can be made, and each will be called in the same
  order as they were registered. If you call <strong>exit()</strong> within one registered shutdown function,
  processing will stop completely and no other registered shutdown functions will be called.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  The shutdown callback to register.
                       
                       The shutdown callbacks are executed as the part of the request, so it's
                       possible to send output from them and access output buffers.
  <info>mixed   </info>  <strong>$args    </strong>  It is possible to pass parameters to the shutdown function by passing
                       additional parameters.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * auto_append_file
   * <strong>exit()</strong>
   * The section on connection handling


id: register_tick_function
type: function
doc:
<comment>Description:</comment>
  Register a function for execution on each tick
  
  Registers the given <strong>$callback</strong> to be executed when a tick is called.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  The function to register.
  <info>mixed   </info>  <strong>$args    </strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * declare
   * <strong>unregister_tick_function()</strong>


id: rename
type: function
doc:
<comment>Description:</comment>
  Renames a file or directory
  
  Attempts to rename <strong>$oldname</strong> to <strong>$newname</strong>, moving it between directories if necessary. If renaming a
  file and <strong>$newname</strong> exists, it will be overwritten. If renaming a directory and <strong>$newname</strong> exists,
  this function will emit a warning.

<comment>Param:</comment>
  <info>string  </info>  <strong>$oldname</strong>  The old name.
                      
                      The wrapper used in <strong>$oldname</strong> must match the wrapper used in <strong>$newname</strong>.
  <info>string  </info>  <strong>$newname</strong>  The new name.  On Windows, if <strong>$newname</strong> already exists, it must be writable.
                      Otherwise <strong>rename()</strong> fails and issues <info>E_WARNING</info>.
                      
                      On Windows, if <strong>$newname</strong> already exists, it must be writable. Otherwise
                      <strong>rename()</strong> fails and issues <info>E_WARNING</info>.
  <info>resource</info>  <strong>$context</strong>  Susținrea contextelor a fost adăugată începând cu PHP 5.0.0. Pentru o
                      descriere a <return>contextelor</return>, referiți-vă la
                      .

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>copy()</strong>
   * <strong>unlink()</strong>
   * <strong>move_uploaded_file()</strong>


id: reset
type: function
doc:
<comment>Description:</comment>
  Set the internal pointer of an array to its first element
  
  <strong>reset()</strong> rewinds <strong>$array</strong>'s internal pointer to the first element and returns the value of the first
  array element.

<comment>Param:</comment>
  <info>arrayobject</info>  <strong>$array</strong>  The input array.

<comment>Return:</comment>
  <info>mixed</info>  Returns the value of the first array element, or <info>false</info> if the array is empty.
         
         Această funcție poate întoarce valoarea Boolean <info>false</info>, dar poate de
         asemenea întoarce o valoare non-Boolean care evaluează în <info>false</info>. Vă rugăm să
         citiți secțiunea despre tipul Boolean
         pentru informații suplimentare. Utilizați
         operatorul === pentru a
         verifica valoarea întoarsă de această funcție.

<comment>See Also:</comment>
   * <strong>current()</strong>
   * <strong>each()</strong>
   * <strong>end()</strong>
   * <strong>next()</strong>
   * <strong>prev()</strong>
   * <strong>array_key_first()</strong>


id: restore_error_handler
type: function
doc:
<comment>Description:</comment>
  Restabilește funcția precedentă de gestionare a erorilor
  
  Se utilizează după modificarea funcției de gestionare a erorilor cu ajutorul <strong>set_error_handler()</strong>,
  pentru a reveni la gestionarul erorilor precedent (care poate fi cel încorporat, sau o funcție
  definită de utilizator).

<comment>Return:</comment>
  <info>bool</info>  Această funcție întotdeuna întoarce <info>true</info>.

<comment>See Also:</comment>
   * <strong>error_reporting()</strong>
   * <strong>set_error_handler()</strong>
   * <strong>restore_exception_handler()</strong>
   * <strong>trigger_error()</strong>


id: restore_exception_handler
type: function
doc:
<comment>Description:</comment>
  Restores the previously defined exception handler function
    
  
  Used after changing the exception handler function using <strong>set_exception_handler()</strong>, to revert to the
  previous exception handler (which could be the built-in or a user defined function).

<comment>Return:</comment>
  <info>bool</info>  This function always returns <info>true</info>.

<comment>See Also:</comment>
   * <strong>set_exception_handler()</strong>
   * <strong>set_error_handler()</strong>
   * <strong>restore_error_handler()</strong>
   * <strong>error_reporting()</strong>


id: restore_include_path
type: function
doc:
<comment>Description:</comment>
  Restores the value of the include_path configuration option
  
  Restores the include_path configuration option back to its original master value as set in php.ini

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * <strong>ini_restore()</strong>
   * <strong>get_include_path()</strong>
   * <strong>set_include_path()</strong>
   * <strong>include()</strong>


id: rewind
type: function
doc:
<comment>Description:</comment>
  Rewind the position of a file pointer
  
  Sets the file position indicator for <strong>$stream</strong> to the beginning of the file stream.
  
  If you have opened the file in append ("a" or "a+") mode, any data you write to the file will
  always be appended, regardless of the file pointer position.

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

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>fread()</strong>
   * <strong>fseek()</strong>
   * <strong>ftell()</strong>
   * <strong>fwrite()</strong>


id: rewinddir
type: function
doc:
<comment>Description:</comment>
  Rewind directory handle
  
  Resets the directory stream indicated by <strong>$dir_handle</strong> to the beginning of the directory.

<comment>Param:</comment>
  <info>resource</info>  <strong>$dir_handle</strong>  The directory handle <info>resource</info> previously opened with <strong>opendir()</strong>. If the
                         directory handle is  not specified, the last link opened by <strong>opendir()</strong>  is
                         assumed.

<comment>Return:</comment>
  <info>void</info>  Întoarce <info>null</info> în cazul succesului sau <info>false</info> în cazul eșecului.


id: rmdir
type: function
doc:
<comment>Description:</comment>
  Removes directory
  
  Attempts to remove the directory named by <strong>$dirname</strong>. The directory must be empty, and the relevant
  permissions must permit this. A <info>E_WARNING</info> level error will be generated on failure.

<comment>Param:</comment>
  <info>string  </info>  <strong>$dirname</strong>  Path to the directory.
  <info>resource</info>  <strong>$context</strong>  Susținrea contextelor a fost adăugată începând cu PHP 5.0.0. Pentru o
                      descriere a <return>contextelor</return>, referiți-vă la
                      .

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>is_dir()</strong>
   * <strong>mkdir()</strong>
   * <strong>unlink()</strong>


id: round
type: function
doc:
<comment>Description:</comment>
  Rounds a float
  
  Returns the rounded value of <strong>$val</strong> to specified <strong>$precision</strong> (number of digits after the decimal
  point). <strong>$precision</strong> can also be negative or zero (default).

<comment>Param:</comment>
  <info>float</info>  <strong>$val      </strong>  The value to round.
  <info>int  </info>  <strong>$precision</strong>  The optional number of decimal digits to round to.
                     
                     If the <strong>$precision</strong> is positive, <strong>$val</strong> is rounded to <strong>$precision</strong> significant digits
                     after the decimal point.
                     
                     If the <strong>$precision</strong> is negative, <strong>$val</strong> is rounded to <strong>$precision</strong> significant digits
                     before the decimal point, i.e. to the nearest multiple of <return>pow(10, -precision)</return>,
                     e.g. for a <strong>$precision</strong> of -1 <strong>$val</strong> is rounded to tens, for a <strong>$precision</strong> of -2 to
                     hundreds, etc.
  <info>int  </info>  <strong>$mode     </strong>  Use one of the following constants to specify the mode in which rounding
                     occurs. ConstanteDescriere<info>PHP_ROUND_HALF_UP</info> Rounds <strong>$val</strong> away from zero when it
                     is half way there, making 1.5 into 2 and -1.5 into -2. <info>PHP_ROUND_HALF_DOWN</info>
                     Rounds <strong>$val</strong> towards zero when it is half way there, making 1.5 into 1 and -1.5
                     into -1. <info>PHP_ROUND_HALF_EVEN</info> Rounds <strong>$val</strong> towards the nearest even value when it
                     is half way there, making both 1.5 and 2.5 into 2. <info>PHP_ROUND_HALF_ODD</info> Rounds
                     <strong>$val</strong> towards the nearest odd value when it is half way there, making 1.5 into 1
                     and and 2.5 into 3.

<comment>Return:</comment>
  <info>float</info>  The value rounded to the given <strong>$precision</strong> as a <info>float</info>.

<comment>See Also:</comment>
   * <strong>ceil()</strong>
   * <strong>floor()</strong>
   * <strong>number_format()</strong>


id: rpmaddtag
type: function
doc:
<comment>Description:</comment>
  Add tag retrieved in query
  
  Add an additional retrieved tag in subsequent queries.

<comment>Param:</comment>
  <info>int</info>  <strong>$tag</strong>  One of RPMTAG_* constant, see the rpminfo constants page.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>rpminfo()</strong>
   * <strong>rpmdbinfo()</strong>
   * <strong>rpmdbsearch()</strong>


id: rpmdbinfo
type: function
doc:
<comment>Description:</comment>
  Get information from installed RPM
  
  Retrieve information about an installed package, from the system RPM database.

<comment>Param:</comment>
  <info>string</info>  <strong>$nevr</strong>  Name with optional epoch, version and release.
  <info>bool  </info>  <strong>$full</strong>  If <info>true</info> all information headers for the file are retrieved, else only a minimal
                 set.

<comment>Return:</comment>
  <info>array</info>  An <info>array</info> of <info>array</info> of information or NULL on error.

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


id: rpmdbsearch
type: function
doc:
<comment>Description:</comment>
  Search RPM packages
  
  Search packages in the system RPM database.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  Value to search for.
  <info>int   </info>  <strong>$rpmtag </strong>  Search criterion, one of RPMTAG_* constant, see the rpminfo constants page.
  <info>int   </info>  <strong>$rpmmire</strong>  Pattern type, one of RPMMIRE_* constant, see the rpminfo constants page. When
                    \< 0 the criterion must equals the value, and database index is used if possible.
  <info>bool  </info>  <strong>$full   </strong>  If <info>true</info> all information headers for the file are retrieved, else only a minimal
                    set.

<comment>Return:</comment>
  <info>array</info>  An <info>array</info> of <info>array</info> of information or NULL on error.

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


id: rpminfo
type: function
doc:
<comment>Description:</comment>
  Get information from a RPM file
  
  Retrieve information about a local file, a RPM package.

<comment>Param:</comment>
  <info>string</info>  <strong>$path </strong>  Path of the RPM file.
  <info>bool  </info>  <strong>$full </strong>  If <info>true</info> all information headers for the file are retrieved, else only a minimal
                  set.
  <info>string</info>  <strong>$error</strong>  If provided, will receive the possible error message, and will avoid a runtime
                  warning.

<comment>Return:</comment>
  <info>array</info>  An <info>array</info> of information or NULL on error.

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


id: rpmvercmp
type: function
doc:
<comment>Description:</comment>
  RPM version comparison
  
  Compare 2 RPM versions.

<comment>Param:</comment>
  <info>string</info>  <strong>$evr1</strong>  First epoch:version-release string
  <info>string</info>  <strong>$evr2</strong>  Second epoch:version-release string

<comment>Return:</comment>
  <info>int</info>  Returns
       \< 0 if evr1 is less than evr2, &gt; 0 if evr1 is greater than evr2, and 0 if they are equal.


id: rrd_create
type: function
doc:
<comment>Description:</comment>
  Creates rrd database file
  
  Creates the rdd database file.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Filename for newly created rrd file.
  <info>array </info>  <strong>$options </strong>  Options for rrd create - list of strings. See man page of rrd create for whole
                     list of options.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: rrd_error
type: function
doc:
<comment>Description:</comment>
  Gets latest error message
  
  Returns latest global rrd error message.

<comment>Return:</comment>
  <info>string</info>  Latest error message.


id: rrd_fetch
type: function
doc:
<comment>Description:</comment>
  Fetch the data for graph as array
  
  Gets data for graph output from RRD database file as array. This function has same result as
  <strong>rrd_graph()</strong>,  but fetched data are returned as array, no image file is created.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  RRD database file name.
  <info>array </info>  <strong>$options </strong>  Array of options for resolution specification.

<comment>Return:</comment>
  <info>array</info>  Returns information about retrieved graph data.


id: rrd_first
type: function
doc:
<comment>Description:</comment>
  Gets the timestamp of the first sample from rrd file
  
  Returns the first data sample from the specified RRA of the RRD file.

<comment>Param:</comment>
  <info>string</info>  <strong>$file    </strong>  RRD database file name.
  <info>int   </info>  <strong>$raaindex</strong>  The index number of the RRA that is to be examined. Default value is 0.

<comment>Return:</comment>
  <info>int</info>  Integer number of unix timestamp, <info>false</info> if some error occurs.


id: rrd_graph
type: function
doc:
<comment>Description:</comment>
  Creates image from a data
  
  Creates image for a particular data from RRD file.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  The filename to output the graph to. This will generally end in either <return>.png</return>,
                     <return>.svg</return> or <return>.eps</return>, depending on the format you want to output.
  <info>array </info>  <strong>$options </strong>  Options for generating image. See man page of rrd graph for all possible
                     options. All options (data definitions, variable defintions, etc.) are allowed.

<comment>Return:</comment>
  <info>array</info>  Array with information about generated image is returned, <info>false</info> when error occurs.


id: rrd_info
type: function
doc:
<comment>Description:</comment>
  Gets information about rrd file
  
  Returns information about particular RRD database file.

<comment>Param:</comment>
  <info></info>  <strong>$file</strong>  RRD database file name.

<comment>Return:</comment>
  <info>array</info>  Array with information about requsted RRD file, <info>false</info> when error occurs.


id: rrd_last
type: function
doc:
<comment>Description:</comment>
  Gets unix timestamp of the last sample
  
  Returns the UNIX timestamp of the most recent update of the RRD database.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  RRD database file name.

<comment>Return:</comment>
  <info>int</info>  Integer as unix timestamp of the most recent data from the RRD database.


id: rrd_lastupdate
type: function
doc:
<comment>Description:</comment>
  Gets information about last updated data
  
  Gets array of the UNIX timestamp and the values stored for each date in the most recent update of
  the RRD database file.

<comment>Param:</comment>
  <info></info>  <strong>$file</strong>  RRD database file name.

<comment>Return:</comment>
  <info>array</info>  Array of information about last update, <info>false</info> when error occurs.


id: rrd_restore
type: function
doc:
<comment>Description:</comment>
  Restores the RRD file from XML dump
  
  Restores the RRD file from the XML dump.

<comment>Param:</comment>
  <info>string</info>  <strong>$xml_file</strong>  XML filename with the dump of the original RRD database file.
  <info>string</info>  <strong>$rrd_file</strong>  Restored RRD database file name.
  <info>array </info>  <strong>$options </strong>  Array of options for restoring. See man page for rrd restore.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> on success, <info>false</info> otherwise.


id: rrd_tune
type: function
doc:
<comment>Description:</comment>
  Tunes some RRD database file header options
  
  Change some options in the RRD dabase header file. E.g. renames the source for the data etc.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  RRD database file name.
  <info>array </info>  <strong>$options </strong>  Options with RRD database file properties which will be changed. See rrd tune
                     man page for details.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> on success, <info>false</info> otherwise.


id: rrd_update
type: function
doc:
<comment>Description:</comment>
  Updates the RRD database
  
  Updates the RRD database file. The input data is time interpolated according to the properties of
  the RRD database file.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  RRD database file name. This database will be updated.
  <info>array </info>  <strong>$options </strong>  Options for updating the RRD database. This is list of strings. See man page of
                     rrd update for whole list of options.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> on success, <info>false</info> when error occurs.


id: rrd_version
type: function
doc:
<comment>Description:</comment>
  Gets information about underlying rrdtool library
  
  Returns information about underlying rrdtool library.

<comment>Return:</comment>
  <info>string</info>  String with rrdtool version number e.g. "1.4.3".


id: rrd_xport
type: function
doc:
<comment>Description:</comment>
  Exports the information about RRD database
  
  Exports the information about RRD database file. This data can be converted to XML file via user
  space PHP script and then restored back as RRD database file.

<comment>Param:</comment>
  <info>array</info>  <strong>$options</strong>  Array of options for the export, see rrd xport man page.

<comment>Return:</comment>
  <info>array</info>  Array with information about RRD database file, <info>false</info> when error occurs.


id: rrdc_disconnect
type: function
doc:
<comment>Description:</comment>
  Close any outstanding connection to rrd caching daemon
  
  Close any outstanding connection to rrd caching daemon.
  
  This function is automatically called when the whole PHP process is terminated. It depends on used
  SAPI. For example, it's called automatically at the end of command line script.
  
  It's up user whether he wants to call this function at the end of every request or otherwise.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.


id: rsort
type: function
doc:
<comment>Description:</comment>
  Sort an array in reverse order
  
  This function sorts an array in reverse order (highest to lowest).
  
  Dacă în rezultatul comparației doi membri sunt egali, ordinea lor relativă în tabloul sortat nu
  este definită.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  The input array.
  <info>int  </info>  <strong>$flags</strong>  The optional second parameter <strong>$flags</strong> may be used to modify the sorting behavior
                 using these values:
                 
                 Sorting type flags: <info>SORT_REGULAR</info> - compare items normally; the details are
                 described in the comparison operators section<info>SORT_NUMERIC</info> - compare items
                 numerically<info>SORT_STRING</info> - compare items as strings<info>SORT_LOCALE_STRING</info> - compare items
                 as strings, based on the current locale. It uses the locale, which can be changed
                 using <strong>setlocale()</strong> <info>SORT_NATURAL</info> - compare items as strings using "natural ordering"
                 like <strong>natsort()</strong> <info>SORT_FLAG_CASE</info> - can be combined (bitwise OR) with <info>SORT_STRING</info> or
                 <info>SORT_NATURAL</info> to sort strings case-insensitively
                 
                 <info>SORT_REGULAR</info> - compare items normally; the details are described in the comparison
                 operators section
                 
                 <info>SORT_NUMERIC</info> - compare items numerically
                 
                 <info>SORT_STRING</info> - compare items as strings
                 
                 <info>SORT_LOCALE_STRING</info> - compare items as strings, based on the current locale. It uses
                 the locale, which can be changed using <strong>setlocale()</strong>
                 
                 <info>SORT_NATURAL</info> - compare items as strings using "natural ordering" like <strong>natsort()</strong>
                 
                 <info>SORT_FLAG_CASE</info> - can be combined (bitwise OR) with <info>SORT_STRING</info> or <info>SORT_NATURAL</info> to
                 sort strings case-insensitively

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>arsort()</strong>
   * <strong>krsort()</strong>
   * Comparația funcțiilor de sortare a tablourilor


id: rtrim
type: function
doc:
<comment>Description:</comment>
  Strip whitespace (or other characters) from the end of a string
  
  This function returns a string with whitespace (or other characters) stripped from the end of
  <strong>$string</strong>.
  
  Without the second parameter, <strong>rtrim()</strong> will strip these characters:   " " (ASCII <return>32</return> (<return>0x20</return>)), an
  ordinary space.  "\t" (ASCII <return>9</return> (<return>0x09</return>)), a tab.  "\n" (ASCII <return>10</return> (<return>0x0A</return>)), a new line (line feed).
  "\r" (ASCII <return>13</return> (<return>0x0D</return>)), a carriage return.  "\0" (ASCII <return>0</return> (<return>0x00</return>)), the <return>NULL</return>-byte.  "\v" (ASCII <return>11</return>
  (<return>0x0B</return>)), a vertical tab.
  
  " " (ASCII <return>32</return> (<return>0x20</return>)), an ordinary space.
  
  "\t" (ASCII <return>9</return> (<return>0x09</return>)), a tab.
  
  "\n" (ASCII <return>10</return> (<return>0x0A</return>)), a new line (line feed).
  
  "\r" (ASCII <return>13</return> (<return>0x0D</return>)), a carriage return.
  
  "\0" (ASCII <return>0</return> (<return>0x00</return>)), the <return>NULL</return>-byte.
  
  "\v" (ASCII <return>11</return> (<return>0x0B</return>)), a vertical tab.

<comment>Param:</comment>
  <info>string</info>  <strong>$string    </strong>  The input string.
  <info>string</info>  <strong>$characters</strong>  You can also specify the characters you want to strip, by means of the
                       <strong>$characters</strong> parameter. Simply list all characters that you want to be
                       stripped. With <return>..</return> you can specify a range of characters.

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

<comment>See Also:</comment>
   * <strong>trim()</strong>
   * <strong>ltrim()</strong>


id: runkit7_constant_add
type: function
doc:
<comment>Description:</comment>
  Similar to define(), but allows defining in class definitions as well

<comment>Param:</comment>
  <info>string</info>  <strong>$constname    </strong>  Name of constant to declare.  Either a string to indicate a global
                          constant, or <return>classname::constname</return> to indicate a class constant.
  <info>mixed </info>  <strong>$value        </strong>  NULL, Bool, Long, Double, String, Array, or Resource value to store in the
                          new constant.
  <info>int   </info>  <strong>$newVisibility</strong>  Visibility of the constant, for class constants. Public by default. One of
                          the <info>RUNKIT7_ACC_*</info> constants.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>define()</strong>
   * <strong>runkit7_constant_redefine()</strong>
   * <strong>runkit7_constant_remove()</strong>


id: runkit7_constant_redefine
type: function
doc:
<comment>Description:</comment>
  Redefine an already defined constant

<comment>Param:</comment>
  <info>string</info>  <strong>$constname    </strong>  Constant to redefine.  Either the name of a global constant, or
                          <return>classname::constname</return> indicating class constant.
  <info>mixed </info>  <strong>$value        </strong>  Value to assign to the constant.
  <info>string</info>  <strong>$newVisibility</strong>  The new visibility of the constant, for class constants. Unchanged by
                          default. One of the <info>RUNKIT7_ACC_*</info> constants.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_constant_add()</strong>
   * <strong>runkit7_constant_remove()</strong>


id: runkit7_constant_remove
type: function
doc:
<comment>Description:</comment>
  Remove/Delete an already defined constant

<comment>Param:</comment>
  <info>string</info>  <strong>$constname</strong>  Name of the constant to remove.  Either the name of a global constant, or
                      <return>classname::constname</return> indicating a class constant.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>define()</strong>
   * <strong>runkit7_constant_add()</strong>
   * <strong>runkit7_constant_redefine()</strong>


id: runkit7_function_add
type: function
doc:
<comment>Description:</comment>
  Add a new function, similar to create_function

<comment>Param:</comment>
  <info>string </info>  <strong>$funcname           </strong>  Name of the function to be created
  <info>string </info>  <strong>$arglist            </strong>  Comma separated argument list
  <info>string </info>  <strong>$code               </strong>  Code making up the function
  <info>Closure</info>  <strong>$closure            </strong>  A <class>closure</class> that defines the function.
  <info>bool   </info>  <strong>$return_by_reference</strong>  Whether the function should return by reference.
  <info>string </info>  <strong>$doc_comment        </strong>  The doc comment of the function.
  <info>string </info>  <strong>$return_type        </strong>  The return type of the function.
  <info>bool   </info>  <strong>$is_strict          </strong>  Whether the function should behave as if it were declared in a file
                                 with <return>strict_types=1</return>

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>create_function()</strong>
   * <strong>runkit7_function_redefine()</strong>
   * <strong>runkit7_function_copy()</strong>
   * <strong>runkit7_function_rename()</strong>
   * <strong>runkit7_function_remove()</strong>
   * <strong>runkit7_method_add()</strong>


id: runkit7_function_copy
type: function
doc:
<comment>Description:</comment>
  Copy a function to a new function name

<comment>Param:</comment>
  <info>string</info>  <strong>$funcname  </strong>  Name of the existing function
  <info>string</info>  <strong>$targetname</strong>  Name of the new function to copy the definition to

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_function_add()</strong>
   * <strong>runkit7_function_redefine()</strong>
   * <strong>runkit7_function_rename()</strong>
   * <strong>runkit7_function_remove()</strong>


id: runkit7_function_redefine
type: function
doc:
<comment>Description:</comment>
  Replace a function definition with a new implementation
    
  
  Implicit numai funcții din
  spațiul utilizatorilor pot fi eliminate, redenumite sau modificate. Pentru a
  depăși (modifica) funcțiile interne, trebuie să activați parametrul
  <return>runkit.internal_override</return> din php.ini.

<comment>Param:</comment>
  <info>string </info>  <strong>$funcname           </strong>  Name of function to redefine
  <info>string </info>  <strong>$arglist            </strong>  New list of arguments to be accepted by function
  <info>string </info>  <strong>$code               </strong>  New code implementation
  <info>Closure</info>  <strong>$closure            </strong>  A <class>closure</class> that defines the function.
  <info>bool   </info>  <strong>$return_by_reference</strong>  Whether the function should return by reference.
  <info>string </info>  <strong>$doc_comment        </strong>  The doc comment of the function.
  <info>string </info>  <strong>$return_type        </strong>  The return type of the function.
  <info>string </info>  <strong>$is_strict          </strong>  Whether the function behaves as if it was declared in a file with
                                 <return>strict_types=1</return>

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_function_add()</strong>
   * <strong>runkit7_function_copy()</strong>
   * <strong>runkit7_function_rename()</strong>
   * <strong>runkit7_function_remove()</strong>
   * <strong>runkit7_method_redefine()</strong>


id: runkit7_function_remove
type: function
doc:
<comment>Description:</comment>
  Remove a function definition
    
  
  Implicit numai funcții din
  spațiul utilizatorilor pot fi eliminate, redenumite sau modificate. Pentru a
  depăși (modifica) funcțiile interne, trebuie să activați parametrul
  <return>runkit.internal_override</return> din php.ini.

<comment>Param:</comment>
  <info>string</info>  <strong>$funcname</strong>  Name of the function to be deleted

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_function_add()</strong>
   * <strong>runkit7_function_copy()</strong>
   * <strong>runkit7_function_redefine()</strong>
   * <strong>runkit7_function_rename()</strong>


id: runkit7_function_rename
type: function
doc:
<comment>Description:</comment>
  Change a function's name
    
  
  Implicit numai funcții din
  spațiul utilizatorilor pot fi eliminate, redenumite sau modificate. Pentru a
  depăși (modifica) funcțiile interne, trebuie să activați parametrul
  <return>runkit.internal_override</return> din php.ini.

<comment>Param:</comment>
  <info>string</info>  <strong>$funcname</strong>  Current function name
  <info>string</info>  <strong>$newname </strong>  New function name

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_function_add()</strong>
   * <strong>runkit7_function_copy()</strong>
   * <strong>runkit7_function_redefine()</strong>
   * <strong>runkit7_function_remove()</strong>


id: runkit7_import
type: function
doc:
<comment>Description:</comment>
  Process a PHP file importing function and class definitions, overwriting where appropriate
    
  
  Similar to <strong>include()</strong>. However, any code residing outside of a function or class is simply ignored.
  Additionally, depending on the value of <strong>$flags</strong>, any functions or classes which already exist in
  the currently running environment may be automatically overwritten by their new definitions.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Filename to import function and class definitions from
  <info>int   </info>  <strong>$flags   </strong>  Bitwise OR of the <return>RUNKIT7_IMPORT_*</return> family of constants.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: runkit7_method_add
type: function
doc:
<comment>Description:</comment>
  Dynamically adds a new method to a given class

<comment>Param:</comment>
  <info>string </info>  <strong>$classname  </strong>  The class to which this method will be added
  <info>string </info>  <strong>$methodname </strong>  The name of the method to add
  <info>string </info>  <strong>$args       </strong>  Comma-delimited list of arguments for the newly-created method
  <info>string </info>  <strong>$code       </strong>  The code to be evaluated when <strong>$methodname</strong> is called
  <info>Closure</info>  <strong>$closure    </strong>  A <class>closure</class> that defines the method.
  <info>int    </info>  <strong>$flags      </strong>  The type of method to create, can be <info>RUNKIT7_ACC_PUBLIC</info>,
                         <info>RUNKIT7_ACC_PROTECTED</info> or <info>RUNKIT7_ACC_PRIVATE</info> optionally combined via
                         bitwise OR with <info>RUNKIT7_ACC_STATIC</info>
  <info>string </info>  <strong>$doc_comment</strong>  The doc comment of the method.
  <info>string </info>  <strong>$return_type</strong>  The return type of the method.
  <info>bool   </info>  <strong>$is_strict  </strong>  Whether the method behaves as if it were declared in a file with
                         <return>strict_types=1</return>

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_method_copy()</strong>
   * <strong>runkit7_method_redefine()</strong>
   * <strong>runkit7_method_remove()</strong>
   * <strong>runkit7_method_rename()</strong>
   * <strong>runkit7_function_add()</strong>


id: runkit7_method_copy
type: function
doc:
<comment>Description:</comment>
  Copies a method from class to another

<comment>Param:</comment>
  <info>string</info>  <strong>$dClass </strong>  Destination class for copied method
  <info>string</info>  <strong>$dMethod</strong>  Destination method name
  <info>string</info>  <strong>$sClass </strong>  Source class of the method to copy
  <info>string</info>  <strong>$sMethod</strong>  Name of the method to copy from the source class. If this parameter is omitted,
                    the value of <strong>$dMethod</strong> is assumed.

<comment>Return:</comment>
  <info>bool</info>  

<comment>See Also:</comment>
   * <strong>runkit7_method_add()</strong>
   * <strong>runkit7_method_redefine()</strong>
   * <strong>runkit7_method_remove()</strong>
   * <strong>runkit7_method_rename()</strong>
   * <strong>runkit7_function_copy()</strong>


id: runkit7_method_redefine
type: function
doc:
<comment>Description:</comment>
  Dynamically changes the code of the given method

<comment>Param:</comment>
  <info>string </info>  <strong>$classname  </strong>  The class in which to redefine the method
  <info>string </info>  <strong>$methodname </strong>  The name of the method to redefine
  <info>string </info>  <strong>$args       </strong>  Comma-delimited list of arguments for the redefined method
  <info>string </info>  <strong>$code       </strong>  The new code to be evaluated when <strong>$methodname</strong> is called
  <info>Closure</info>  <strong>$closure    </strong>  A <class>closure</class> that defines the method.
  <info>int    </info>  <strong>$flags      </strong>  The redefined method can be <info>RUNKIT7_ACC_PUBLIC</info>, <info>RUNKIT7_ACC_PROTECTED</info> or
                         <info>RUNKIT7_ACC_PRIVATE</info> optionally combined via bitwise OR with
                         <info>RUNKIT7_ACC_STATIC</info>
  <info>string </info>  <strong>$doc_comment</strong>  The doc comment of the method.
  <info>string </info>  <strong>$return_type</strong>  The return type of the method.
  <info>bool   </info>  <strong>$is_strict  </strong>  Whether the method behaves as if it was declared in a file with
                         <return>strict_types=1</return>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_method_add()</strong>
   * <strong>runkit7_method_copy()</strong>
   * <strong>runkit7_method_remove()</strong>
   * <strong>runkit7_method_rename()</strong>
   * <strong>runkit7_function_redefine()</strong>


id: runkit7_method_remove
type: function
doc:
<comment>Description:</comment>
  Dynamically removes the given method
  
  Această funcție nu poate fi
  utilizată pentru a manipula metoda care la moment rulează, sau este înlănțuită.

<comment>Param:</comment>
  <info>string</info>  <strong>$classname </strong>  The class in which to remove the method
  <info>string</info>  <strong>$methodname</strong>  The name of the method to remove

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_method_add()</strong>
   * <strong>runkit7_method_copy()</strong>
   * <strong>runkit7_method_redefine()</strong>
   * <strong>runkit7_method_rename()</strong>
   * <strong>runkit7_function_remove()</strong>


id: runkit7_method_rename
type: function
doc:
<comment>Description:</comment>
  Dynamically changes the name of the given method
  
  Această funcție nu poate fi
  utilizată pentru a manipula metoda care la moment rulează, sau este înlănțuită.

<comment>Param:</comment>
  <info>string</info>  <strong>$classname </strong>  The class in which to rename the method
  <info>string</info>  <strong>$methodname</strong>  The name of the method to rename
  <info>string</info>  <strong>$newname   </strong>  The new name to give to the renamed method

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>runkit7_method_add()</strong>
   * <strong>runkit7_method_copy()</strong>
   * <strong>runkit7_method_redefine()</strong>
   * <strong>runkit7_method_remove()</strong>
   * <strong>runkit7_function_rename()</strong>


id: runkit7_object_id
type: function
doc:
<comment>Description:</comment>
  Return the integer object handle for given object
    
  
  This function returns a unique identifier for the object. The object id is unique for the lifetime
  of the object. Once the object is destroyed, its id may be reused for other objects. This behavior
  is similar to <strong>spl_object_hash()</strong>.

<comment>Param:</comment>
  <info>object</info>  <strong>$obj</strong>  Any object.

<comment>Return:</comment>
  <info>int</info>  An integer identifier that is unique for each currently existing object and is always the
       same for each object.


id: runkit7_superglobals
type: function
doc:
<comment>Description:</comment>
  Return numerically indexed array of registered superglobals

<comment>Return:</comment>
  <info>array</info>  Returns a numerically indexed array of the currently registered superglobals. i.e. _GET,
         _POST, _REQUEST, _COOKIE, _SESSION, _SERVER, _ENV, _FILES

<comment>See Also:</comment>
   * Variable Scope


id: runkit7_zval_inspect
type: function
doc:
<comment>Description:</comment>
  Returns information about the passed in value with data types, reference counts, etc

<comment>Param:</comment>
  <info>string</info>  <strong>$value</strong>  The value to return the representation of

<comment>Return:</comment>
  <info>array</info>  


id: sapi_windows_cp_conv
type: function
doc:
<comment>Description:</comment>
  Convert string from one codepage to another
  
  Convert string from one codepage to another.

<comment>Param:</comment>
  <info>intstring</info>  <strong>$in_codepage </strong>  The codepage of the <strong>$subject</strong> string. Either the codepage name or
                            identifier.
  <info>intstring</info>  <strong>$out_codepage</strong>  The codepage to convert the <strong>$subject</strong> string to. Either the codepage name
                            or identifier.
  <info>string   </info>  <strong>$subject     </strong>  The string to convert.

<comment>Return:</comment>
  <info>string</info>  The <strong>$subject</strong> string converted to <strong>$out_codepage</strong>, or <info>null</info> on failure.

<comment>See Also:</comment>
   * <strong>sapi_windows_cp_get()</strong>
   * <strong>iconv()</strong>


id: sapi_windows_cp_get
type: function
doc:
<comment>Description:</comment>
  Get current codepage
  
  Gets the current codepage.

<comment>Param:</comment>
  <info>string</info>  <strong>$kind</strong>  The kind of operating system codepage to get, either <return>'ansi'</return> or <return>'oem'</return>. Any other
                 value refers to the current codepage of the process.

<comment>Return:</comment>
  <info>int</info>  If <strong>$kind</strong> is <return>'ansi'</return>, the current ANSI code page of the operating system is returned. If <strong>$kind</strong>
       is <return>'oem'</return>, the current OEM code page of the operating system is returned. Otherwise, the
       current codepage of the process is returned.

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


id: sapi_windows_cp_is_utf8
type: function
doc:
<comment>Description:</comment>
  Indicates whether the codepage is UTF-8 compatible
  
  Indicates whether the codepage of the current process is UTF-8 compatible.

<comment>Return:</comment>
  <info>bool</info>  Returns whether the codepage of the current process is UTF-8 compatible.

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


id: sapi_windows_cp_set
type: function
doc:
<comment>Description:</comment>
  Set process codepage
  
  Set the codepage of the current process.

<comment>Param:</comment>
  <info>int</info>  <strong>$cp</strong>  A codepage identifier.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: sapi_windows_generate_ctrl_event
type: function
doc:
<comment>Description:</comment>
  Send a CTRL event to another process
  
  Sends a CTRL event to another process in the same process group.

<comment>Param:</comment>
  <info>int</info>  <strong>$event</strong>  The <return>CTRL</return> even to send; either <info>PHP_WINDOWS_EVENT_CTRL_C</info> or
               <info>PHP_WINDOWS_EVENT_CTRL_BREAK</info>.
  <info>int</info>  <strong>$pid  </strong>  The ID of the process to which to send the event to. If <return>0</return> is given, the event is sent
               to all processes of the process group.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>proc_open()</strong>
   * <strong>sapi_windows_set_ctrl_handler()</strong>


id: sapi_windows_set_ctrl_handler
type: function
doc:
<comment>Description:</comment>
  Set or remove a CTRL event handler
  
  Sets or removes a <return>CTRL</return> event handler, which allows Windows CLI processes to intercept or ignore
  <return>CTRL+C</return> and <return>CTRL+BREAK</return> events. Note that in multithreaded environments, this is only possible when
  called from the main thread.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callable</strong>  A callback function to set or remove. If set, this function will be called
                       whenever a <return>CTRL+C</return> or <return>CTRL+BREAK</return> event occurs. The function is supposed to
                       have the following signature: <info>void</info>handler<info>int</info><strong>$event</strong> <strong>$event</strong> The <return>CTRL</return> event
                       which has been received; either <info>PHP_WINDOWS_EVENT_CTRL_C</info> or
                       <info>PHP_WINDOWS_EVENT_CTRL_BREAK</info>.  Setting a <info>null</info> <strong>$callable</strong> causes the process to
                       ignore <return>CTRL+C</return> events, but not <return>CTRL+BREAK</return> events.
                       
                       The <return>CTRL</return> event which has been received; either <info>PHP_WINDOWS_EVENT_CTRL_C</info> or
                       <info>PHP_WINDOWS_EVENT_CTRL_BREAK</info>.
  <info>int     </info>  <strong>$event   </strong>  The <return>CTRL</return> event which has been received; either <info>PHP_WINDOWS_EVENT_CTRL_C</info> or
                       <info>PHP_WINDOWS_EVENT_CTRL_BREAK</info>.
  <info>bool    </info>  <strong>$add     </strong>  If <info>true</info>, the handler is set. If <info>false</info>, the handler is removed.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: sapi_windows_vt100_support
type: function
doc:
<comment>Description:</comment>
  Get or set VT100 support for the specified stream associated to an output buffer of a Windows
  console.
  
  If <strong>$enable</strong> is omitted, the function returns <info>true</info> if the stream <strong>$stream</strong> has VT100 control codes
  enabled, <info>false</info> otherwise.
  
  If <strong>$enable</strong> is specified, the function will try to enable or disable the VT100 features of the
  stream <strong>$stream</strong>. If the feature has been successfully enabled (or disabled), the function will
  return <info>true</info>, or <info>false</info> otherwise.
  
  At startup, PHP tries to enable the VT100 feature of the <info>STDOUT</info>/<info>STDERR</info> streams. By the way, if
  those streams are redirected to a file, the VT100 features may not be enabled.
  
  If VT100 support is enabled, it is possible to use control sequences as they are known from the
  VT100 terminal.  They allow the modification of the terminal's output. On Windows these sequences
  are called Console Virtual Terminal Sequences.
  
  This function uses the <info>ENABLE_VIRTUAL_TERMINAL_PROCESSING</info> flag implemented in the Windows 10 API,
  so the VT100 feature may not be available on older Windows versions.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The stream on which the function will operate.
  <info>bool    </info>  <strong>$enable</strong>  If specified, the VT100 feature will be enabled (if <info>true</info>) or disabled (if
                     <info>false</info>).

<comment>Return:</comment>
  <info>bool</info>  If <strong>$enable</strong> is not specified: returns <info>true</info> if the VT100 feature is enabled, <info>false</info> otherwise.
        
        If <strong>$enable</strong> is specified: Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: scandir
type: function
doc:
<comment>Description:</comment>
  List files and directories inside the specified path
  
  Returns an <info>array</info> of files and directories from the <strong>$directory</strong>.

<comment>Param:</comment>
  <info>string  </info>  <strong>$directory    </strong>  The directory that will be scanned.
  <info>int     </info>  <strong>$sorting_order</strong>  By default, the sorted order is alphabetical in ascending order.  If the
                            optional <strong>$sorting_order</strong> is set to <info>SCANDIR_SORT_DESCENDING</info>, then the sort
                            order is alphabetical in descending order. If it is set to
                            <info>SCANDIR_SORT_NONE</info> then the result is unsorted.
  <info>resource</info>  <strong>$context      </strong>  For a description of the <strong>$context</strong> parameter,  refer to the streams
                            section of the manual.

<comment>Return:</comment>
  <info>array</info>  Returns an <info>array</info> of filenames on success, or <info>false</info> on  failure. If <strong>$directory</strong> is not a
         directory, then  boolean <info>false</info> is returned, and an error of level  <info>E_WARNING</info> is generated.

<comment>See Also:</comment>
   * <strong>opendir()</strong>
   * <strong>readdir()</strong>
   * <strong>glob()</strong>
   * <strong>is_dir()</strong>
   * <strong>sort()</strong>


id: scoutapm_get_calls
type: function
doc:
<comment>Description:</comment>
  Returns a list of instrumented calls that have occurred
  
  Returns a list of any instrumented function calls since <strong>scoutapm_get_calls()</strong> was last called. The
  list is cleared each time the function is called.

<comment>Return:</comment>
  <info>array</info>  <strong>scoutapm_get_calls()</strong> returns an array containing a list of all recorded calls to
         instrumented function calls.


id: scoutapm_list_instrumented_functions
type: function
doc:
<comment>Description:</comment>
  List functions scoutapm will instrument.
  
  Returns a list of the functions the extension will instrument.

<comment>Return:</comment>
  <info>array</info>  <strong>scoutapm_list_instrumented_functions()</strong> returns an array containing a list of all functions
         that the scoutapm extension is able to instrument in the current installation.


id: seaslog_get_author
type: function
doc:
<comment>Description:</comment>
  Get SeasLog author.

<comment>Return:</comment>
  <info>string</info>  Return SeasLog author as string.


id: seaslog_get_version
type: function
doc:
<comment>Description:</comment>
  Get SeasLog version.

<comment>Return:</comment>
  <info>string</info>  Return SeasLog version (SEASLOG_VERSION) as string.


id: sem_acquire
type: function
doc:
<comment>Description:</comment>
  Acquire a semaphore
  
  <strong>sem_acquire()</strong> by default blocks (if necessary) until the semaphore can be acquired.  A process
  attempting to acquire a semaphore which it has already acquired will block forever if acquiring
  the semaphore would cause its maximum number of semaphore to be exceeded.
  
  After processing a request, any semaphores acquired by the process but not explicitly released
  will be released automatically and a warning will be generated.

<comment>Param:</comment>
  <info>SysvSemaphore</info>  <strong>$semaphore   </strong>  <strong>$semaphore</strong> is a semaphore obtained from <strong>sem_get()</strong>.
  <info>bool         </info>  <strong>$non_blocking</strong>  Specifies if the process shouldn't wait for the semaphore to be
                                acquired. If set to <return>true</return>, the call will return <return>false</return> immediately if
                                a semaphore cannot be immediately acquired.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>sem_get()</strong>
   * <strong>sem_release()</strong>


id: sem_get
type: function
doc:
<comment>Description:</comment>
  Get a semaphore id
  
  <strong>sem_get()</strong> returns an id that can be used to access the System V semaphore with the given <strong>$key</strong>.
  
  A second call to <strong>sem_get()</strong> for the same key will return a different semaphore identifier, but both
  identifiers access the same underlying semaphore.
  
  If <strong>$key</strong> is <return>0</return>, a new private semaphore is created for each call to <strong>sem_get()</strong>.

<comment>Param:</comment>
  <info>int </info>  <strong>$key         </strong>  
  <info>int </info>  <strong>$max_acquire </strong>  The number of processes that can acquire the semaphore simultaneously is set
                       to <strong>$max_acquire</strong>.
  <info>int </info>  <strong>$permissions </strong>  The semaphore permissions. Actually this value is set only if the process
                       finds it is the only process currently attached to the semaphore.
  <info>bool</info>  <strong>$auto_release</strong>  Specifies if the semaphore should be automatically released on request
                       shutdown.

<comment>Return:</comment>
  <info>SysvSemaphorefalse</info>  Returns a positive semaphore identifier on success, or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>sem_acquire()</strong>
   * <strong>sem_release()</strong>
   * <strong>ftok()</strong>


id: sem_release
type: function
doc:
<comment>Description:</comment>
  Release a semaphore
  
  <strong>sem_release()</strong> releases the semaphore if it is currently acquired by the calling process, otherwise
  a warning is generated.
  
  After releasing the semaphore, <strong>sem_acquire()</strong> may be called to re-acquire it.

<comment>Param:</comment>
  <info>SysvSemaphore</info>  <strong>$semaphore</strong>  A Semaphore as returned by <strong>sem_get()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>sem_get()</strong>
   * <strong>sem_acquire()</strong>


id: sem_remove
type: function
doc:
<comment>Description:</comment>
  Remove a semaphore
  
  <strong>sem_remove()</strong> removes the given semaphore.
  
  After removing the semaphore, it is no longer accessible.

<comment>Param:</comment>
  <info>SysvSemaphore</info>  <strong>$semaphore</strong>  A semaphore as returned by <strong>sem_get()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>sem_get()</strong>
   * <strong>sem_release()</strong>
   * <strong>sem_acquire()</strong>


id: serialize
type: function
doc:
<comment>Description:</comment>
  Generează o reprezentare ce poate fi stocată a unei valori
  
  Generează o reprezentare ce poate fi stocată a unei valori.
  
  Aceasta este utilă pentru păstrarea sau interpretarea valorilor PHP fără a pierde tipul sau
  structura lor.
  
  Pentru a transforma invers un string serializat într-o valoare PHP, utilizați <strong>unserialize()</strong>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  Valoarea ce trebuie serializată. <strong>serialize()</strong> prelucrează toate tipurile, cu
                 excepția <info>resource</info> și unele <info>object</info> (a se vedea nota de mai jos). Puteți chiar aplica
                 <strong>serialize()</strong> asupra tablourilor ce conțin referințe la sine însele. Referințele
                 circulare din interiorul tabloului/obiectului pe care îl serializați de asemenea
                 vor fi stocate. Orice altă referință va fi pierdută.
                 
                 La serializarea obiectelor, PHP va încerca să apeleze una din funcțiile-membru
                 __serialize() sau __sleep() înainte de serializare. Aceasta se efectuează pentru
                 a-i permite obiectului să efectueze orice curățiri, etc. înainte de a fi
                 serializat. La fel, când obiectul este restabilit cu ajutorul <strong>unserialize()</strong>
                 funcția-membru __unserialize() sau __wakeup() este apelată.
                 
                 Membrii privați ai obiectului au denumirea clasei prefixată la denumirea membrului;
                 membrii privați au un '*' prefixat la denumirea membrului. Aceste valori prefixate
                 au câte un octet nul din ambele părți.

<comment>Return:</comment>
  <info>string</info>  Întoarce un string conținând reprezentarea <strong>$value</strong> sub formă de byte-stream care poate fi
          stocată oriunde.
          
          Atrageți atenția că acesta este un șir de caractere binar, ce poate include octeți null,
          de aceea trebuie stocat și manipulat ca atare. De exemplu, rezultatele funcției
          <strong>serialize()</strong> la general ar trebui stocate într-un câmp BLOB într-o bază de date, și nu
          într-un câmp CHAR sau TEXT.

<comment>See Also:</comment>
   * <strong>unserialize()</strong>
   * <strong>var_export()</strong>
   * <strong>json_encode()</strong>
   * Serializarea Obiectelor
   * __sleep()
   * __wakeup()
   * __serialize()
   * __unserialize()


id: session_abort
type: function
doc:
<comment>Description:</comment>
  Discard session array changes and finish session
  
  <strong>session_abort()</strong> finishes session without saving data. Thus the original values in session data are
  kept.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * $_SESSION
   * 
     The session.auto_start
     configuration directive
    
   * <strong>session_start()</strong>
   * <strong>session_reset()</strong>
   * <strong>session_commit()</strong>


id: session_cache_expire
type: function
doc:
<comment>Description:</comment>
  Get and/or set current cache expire
  
  <strong>session_cache_expire()</strong> returns the current setting of <return>session.cache_expire</return>.
  
  The cache expire is reset to the default value of 180 stored in session.cache_expire at request
  startup time. Thus, you need to call <strong>session_cache_expire()</strong> for every request (and before
  <strong>session_start()</strong> is called).

<comment>Param:</comment>
  <info>intnull</info>  <strong>$value</strong>  If <strong>$value</strong> is given and not <info>null</info>, the current cache expire is replaced with
                   <strong>$value</strong>.
                   
                    Setting <strong>$value</strong> is of value only, if <return>session.cache_limiter</return> is set to a value
                   different from <return>nocache</return>.
                   
                   Setting <strong>$value</strong> is of value only, if <return>session.cache_limiter</return> is set to a value
                   different from <return>nocache</return>.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the current setting of <return>session.cache_expire</return>. The value returned should be read
            in minutes, defaults to 180. On failure to change the value, <info>false</info> is returned.

<comment>See Also:</comment>
   * session.cache_expire
   * session.cache_limiter
   * <strong>session_cache_limiter()</strong>


id: session_cache_limiter
type: function
doc:
<comment>Description:</comment>
  Get and/or set the current cache limiter
  
  <strong>session_cache_limiter()</strong> returns the name of the current cache limiter.
  
  The cache limiter defines which cache control HTTP headers are sent to the client.  These headers
  determine the rules by which the page content may be cached by the client and intermediate
  proxies.  Setting the cache limiter to <return>nocache</return> disallows any client/proxy caching. A value of
  <return>public</return> permits caching by proxies and the client, whereas <return>private</return> disallows caching by proxies and
  permits the client to cache the contents.
  
  In <return>private</return> mode, the Expire header sent to the client may cause confusion for some browsers,
  including Mozilla. You can avoid this problem by using <return>private_no_expire</return> mode. The <return>Expire</return> header
  is never sent to the client in this mode.
  
  Setting the cache limiter to <return>''</return> will turn off automatic sending of cache headers entirely.
  
  The cache limiter is reset to the default value stored in session.cache_limiter at request startup
  time. Thus, you need to call <strong>session_cache_limiter()</strong> for every request (and before <strong>session_start()</strong>
  is called).

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$value</strong>  If <strong>$value</strong> is specified and not <info>null</info>, the name of the current cache limiter is
                      changed to the new value.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the name of the current cache limiter. On failure to change the value, <info>false</info>
               is returned.

<comment>See Also:</comment>
   * session.cache_limiter


id: session_commit
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru session_write_close
  
  Această funcție este pseudonim pentru:  <strong>session_write_close()</strong>.


id: session_create_id
type: function
doc:
<comment>Description:</comment>
  Create new session id
  
  <strong>session_create_id()</strong> is used to create new session id for the current session. It returns collision
  free session id.
  
  If session is not active, collision check is omitted.
  
  Session ID is created according to php.ini settings.
  
  It is important to use the same user ID of your web server for GC task script. Otherwise, you may
  have permission problems especially with files save handler.

<comment>Param:</comment>
  <info>string</info>  <strong>$prefix</strong>  If <strong>$prefix</strong> is specified, new session id is prefixed by <strong>$prefix</strong>. Not all
                   characters are allowed within the session id.  Characters in the range <return>a-z A-Z
                   0-9 , (comma) and - (minus)</return> are allowed.

<comment>Return:</comment>
  <info>stringfalse</info>  <strong>session_create_id()</strong> returns new collision free session id for the current session. If
               it is used without active session, it omits collision check. On failure, <info>false</info> is
               returned.

<comment>See Also:</comment>
   * <strong>session_regenerate_id()</strong>
   * <strong>session_start()</strong>
   * session.use_strict_mode
   * SessionHandler::create_sid


id: session_decode
type: function
doc:
<comment>Description:</comment>
  Decodes session data from a session encoded string
  
  <strong>session_decode()</strong> decodes the serialized session data provided in <strong>$data</strong>, and populates the
  $_SESSION superglobal with the result.
  
  By default, the unserialization method used is internal to PHP, and is not the same as
  <strong>unserialize()</strong>. The serialization method can be set using session.serialize_handler.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  The encoded data to be stored.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>session_encode()</strong>
   * session.serialize_handler


id: session_destroy
type: function
doc:
<comment>Description:</comment>
  Destroys all data registered to a session
  
  <strong>session_destroy()</strong> destroys all of the data associated with the current session. It does not unset
  any of the global variables associated with the session, or unset the session cookie. To use the
  session variables again, <strong>session_start()</strong> has to be called.
  
  You do not have to call <strong>session_destroy()</strong> from usual code. Cleanup $_SESSION array rather than
  destroying session data.
  
  In order to kill the session altogether, the session ID must also be unset. If a cookie is used to
  propagate the session ID (default behavior), then the session cookie must be deleted. <strong>setcookie()</strong>
  may be used for that.
  
  When session.use_strict_mode is enabled. You do not have to remove obsolete session ID cookie
  because session module will not accept session ID cookie when there is no data associated to the
  session ID and set new session ID cookie. Enabling session.use_strict_mode is recommended for all
  sites.
  
  Immediate session deletion may cause unwanted results. When there is concurrent requests, other
  connections may see sudden session data loss. e.g. Requests from JavaScript and/or requests from
  URL links.
  
  Although current session module does not accept empty session ID cookie, but immediate session
  deletion may result in empty session ID cookie due to client(browser) side race condition. This
  will result that the client creates many session ID needlessly.
  
  To avoid these, you must set deletion time-stamp to $_SESSION and reject access while later. Or
  make sure your application does not have concurrent requests. This applies to
  <strong>session_regenerate_id()</strong> also.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * session.use_strict_mode
   * <strong>session_reset()</strong>
   * <strong>session_regenerate_id()</strong>
   * <strong>unset()</strong>
   * <strong>setcookie()</strong>


id: session_encode
type: function
doc:
<comment>Description:</comment>
  Encodes the current session data as a session encoded string
  
  <strong>session_encode()</strong> returns a serialized string of the contents of the current session data stored in
  the $_SESSION superglobal.
  
  By default, the serialization method used is internal to PHP, and is not the same as <strong>serialize()</strong>.
  The serialization method can be set using session.serialize_handler.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the contents of the current session encoded,  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>session_decode()</strong>
   * session.serialize_handler


id: session_gc
type: function
doc:
<comment>Description:</comment>
  Perform session data garbage collection
  
  <strong>session_gc()</strong> is used to perform session data GC(garbage collection). PHP does probability based
  session GC by default.
  
  Probability based GC works somewhat but it has few problems. 1) Low traffic sites' session data
  may not be deleted within the preferred duration. 2) High traffic sites' GC may be too frequent
  GC. 3) GC is performed on the user's request and the user will experience a GC delay.
  
  Therefore, it is recommended to execute GC periodically for production systems using, e.g., "cron"
  for UNIX-like systems. Make sure to disable probability based GC by setting
  session.gc_probability  to 0.

<comment>Return:</comment>
  <info>intfalse</info>  <strong>session_gc()</strong> returns number of deleted session data for success, <info>false</info> for failure.
            
            Old save handlers do not return number of deleted session data, but  only
            success/failure flag. If this is the case, number of deleted session data became 1
            regardless of actually deleted data.

<comment>See Also:</comment>
   * <strong>session_start()</strong>
   * <strong>session_destroy()</strong>
   * session.gc_probability


id: session_get_cookie_params
type: function
doc:
<comment>Description:</comment>
  Get the session cookie parameters
  
  Gets the session cookie parameters.

<comment>Return:</comment>
  <info>array</info>  Returns an array with the current session cookie information, the array contains the
         following items: "lifetime" -  The lifetime of the cookie in seconds. "path" -  The path
         where information is stored. "domain" -  The domain of the cookie. "secure" -  The cookie
         should only be sent over secure connections. "httponly" - The cookie can only be accessed
         through the HTTP protocol. "samesite" - Controls the cross-domain sending of the cookie.
         
         "lifetime" -  The lifetime of the cookie in seconds.
         
         "path" -  The path where information is stored.
         
         "domain" -  The domain of the cookie.
         
         "secure" -  The cookie should only be sent over secure connections.
         
         "httponly" - The cookie can only be accessed through the HTTP protocol.
         
         "samesite" - Controls the cross-domain sending of the cookie.

<comment>See Also:</comment>
   * session.cookie_lifetime
   * session.cookie_path
   * session.cookie_domain
   * session.cookie_secure
   * session.cookie_httponly
   * session.cookie_samesite
   * <strong>session_set_cookie_params()</strong>


id: session_id
type: function
doc:
<comment>Description:</comment>
  Get and/or set the current session id
  
  <strong>session_id()</strong> is used to get or set the session id for the current session.
  
  The constant <info>SID</info> can also be used to retrieve the current name and session id as a string suitable
  for adding to URLs. See also Session handling.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$id</strong>  If <strong>$id</strong> is specified and not <info>null</info>, it will replace the current session id.
                   <strong>session_id()</strong> needs to be called before <strong>session_start()</strong> for that purpose.
                   Depending on the session handler, not all characters are allowed within the
                   session id. For example, the file session handler only allows characters in the
                   range <return>a-z A-Z 0-9 , (comma) and - (minus)</return>!
                   
                   When using session cookies, specifying an <strong>$id</strong> for <strong>session_id()</strong> will always send a
                   new cookie when <strong>session_start()</strong> is called, regardless if the current session id
                   is identical to the one being set.

<comment>Return:</comment>
  <info>stringfalse</info>  <strong>session_id()</strong> returns the session id for the current session or the empty string (<return>""</return>)
               if there is no current session (no current session id exists). On failure, <info>false</info> is
               returned.

<comment>See Also:</comment>
   * <strong>session_regenerate_id()</strong>
   * <strong>session_start()</strong>
   * <strong>session_set_save_handler()</strong>
   * session.save_handler


id: session_is_registered
type: function
doc:
<comment>Description:</comment>
  Find out whether a global variable is registered in a session
  
  Finds out whether a global variable is registered in a session.
  
  Această facilitate a fost
  ÎNVECHITĂ începând cu PHP 5.3.0 și
  ELIMINATĂ începând cu PHP 5.4.0.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>  The variable name.

<comment>Return:</comment>
  <info>bool</info>  <strong>session_is_registered()</strong> returns <info>true</info> if there is a global variable with the name <strong>$name</strong>
        registered in the current session, <info>false</info> otherwise.


id: session_module_name
type: function
doc:
<comment>Description:</comment>
  Get and/or set the current session module
  
  <strong>session_module_name()</strong> gets the name of the current session module, which is also known as
  session.save_handler.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$module</strong>  If <strong>$module</strong> is specified and not <info>null</info>, that module will be used instead.
                       Passing <return>"user"</return> to this parameter is forbidden. Instead
                       <strong>session_set_save_handler()</strong> has to be called to set a user defined session
                       handler.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the name of the current session module,  sau <info>false</info> în cazul eșecului.


id: session_name
type: function
doc:
<comment>Description:</comment>
  Get and/or set the current session name
  
  <strong>session_name()</strong> returns the name of the current session. If <strong>$name</strong> is given, <strong>session_name()</strong> will
  update the session name and return the old session name.
  
  If a new session <strong>$name</strong> is supplied, <strong>session_name()</strong> modifies the HTTP cookie (and output content
  when <return>session.transid</return> is enabled). Once the HTTP cookie is sent, <strong>session_name()</strong> raises error.
  <strong>session_name()</strong> must be called before <strong>session_start()</strong> for the session to work properly.
  
  The session name is reset to the default value stored in <return>session.name</return> at request startup time.
  Thus, you need to call <strong>session_name()</strong> for every request (and before <strong>session_start()</strong> is called).

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$name</strong>  The session name references the name of the session, which is  used in cookies
                     and URLs (e.g. <return>PHPSESSID</return>). It should contain only alphanumeric characters; it
                     should be short and descriptive (i.e. for users with enabled cookie warnings).
                     If <strong>$name</strong> is specified and not <info>null</info>, the name of the current session is changed
                     to its value.
                     
                      The session name can't consist of digits only, at least one letter must be
                     present. Otherwise a new session id is generated every time.
                     
                     The session name can't consist of digits only, at least one letter must be
                     present. Otherwise a new session id is generated every time.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the name of the current session. If <strong>$name</strong> is given and function updates the
               session name, name of the old session is returned,  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * 
     The session.name configuration
     directive
    


id: session_regenerate_id
type: function
doc:
<comment>Description:</comment>
  Update the current session id with a newly generated one
    
  
  <strong>session_regenerate_id()</strong> will replace the current session id with a new one, and keep the current
  session information.
  
  When session.use_trans_sid is enabled, output must be started after <strong>session_regenerate_id()</strong> call.
  Otherwise, old session ID is used.
  
  Currently, session_regenerate_id does not handle an unstable network well, e.g. Mobile and WiFi
  network. Therefore, you may experience a lost session by calling session_regenerate_id.
  
  You should not destroy old session data immediately, but should use destroy time-stamp and control
  access to old session ID. Otherwise, concurrent access to page may result in inconsistent state,
  or you may have lost session, or it may cause client(browser) side race condition and may create
  many session ID needlessly. Immediate session data deletion disables session hijack attack
  detection and prevention also.

<comment>Param:</comment>
  <info>bool</info>  <strong>$delete_old_session</strong>  Whether to delete the old associated session file or not. You should
                             not delete old session if you need to avoid races caused by deletion or
                             detect/avoid session hijack attacks.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>session_id()</strong>
   * <strong>session_create_id()</strong>
   * <strong>session_start()</strong>
   * <strong>session_destroy()</strong>
   * <strong>session_reset()</strong>
   * <strong>session_name()</strong>


id: session_register
type: function
doc:
<comment>Description:</comment>
  Register one or more global variables with the current session
  
  <strong>session_register()</strong> accepts a variable number of arguments, any of which can be either a string
  holding the name of a variable or an array consisting of variable names or other arrays. For each
  name, <strong>session_register()</strong> registers the global variable with that name in the current session.
  
  You can also create a session variable by simply setting the appropriate member of the $_SESSION
  array.
  ]]>
  
  If <strong>session_start()</strong> was not called before this function is called, an implicit call to
  <strong>session_start()</strong> with no parameters will be made.  $_SESSION does not mimic this behavior and
  requires <strong>session_start()</strong> before use.
  
  Această facilitate a fost
  ÎNVECHITĂ începând cu PHP 5.3.0 și
  ELIMINATĂ începând cu PHP 5.4.0.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$name </strong>  A string holding the name of a variable or an array consisting of variable names or
                 other arrays.
  <info>mixed</info>  <strong>$names</strong>  

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>session_is_registered()</strong>
   * <strong>session_unregister()</strong>
   * $_SESSION


id: session_register_shutdown
type: function
doc:
<comment>Description:</comment>
  Session shutdown function
  
  Registers <strong>session_write_close()</strong> as a shutdown function.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.


id: session_reset
type: function
doc:
<comment>Description:</comment>
  Re-initialize session array with original values
  
  <strong>session_reset()</strong> reinitializes a session with original values stored in session storage. This
  function requires an active session and discards changes in $_SESSION.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * $_SESSION
   * 
     The session.auto_start
     configuration directive
    
   * <strong>session_start()</strong>
   * <strong>session_abort()</strong>
   * <strong>session_commit()</strong>


id: session_save_path
type: function
doc:
<comment>Description:</comment>
  Get and/or set the current session save path
  
  <strong>session_save_path()</strong> returns the path of the current directory used to save session data.

<comment>Param:</comment>
  <info>stringnull</info>  <strong>$path</strong>  Session data path. If specified and not <info>null</info>, the path to which data is saved
                     will be changed. <strong>session_save_path()</strong> needs to be called before <strong>session_start()</strong>
                     for that purpose.
                     
                      On some operating systems, you may want to specify a path on a filesystem that
                     handles lots of small files efficiently. For example, on Linux, reiserfs may
                     provide better performance than ext2fs.
                     
                     On some operating systems, you may want to specify a path on a filesystem that
                     handles lots of small files efficiently. For example, on Linux, reiserfs may
                     provide better performance than ext2fs.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the path of the current directory used for data storage,  sau <info>false</info> în cazul
               eșecului.

<comment>See Also:</comment>
   * 
     The session.save_path
     configuration directive
    


id: session_set_cookie_params
type: function
doc:
<comment>Description:</comment>
  Set the session cookie parameters
  
  Alternative signature available as of PHP 7.3.0:
  
  Set cookie parameters defined in the php.ini file. The effect of this function only lasts for the
  duration of the script. Thus, you need to call <strong>session_set_cookie_params()</strong> for every request and
  before <strong>session_start()</strong> is called.
  
  This function updates the runtime ini values of the corresponding PHP ini configuration keys which
  can be retrieved with the <strong>ini_get()</strong>.

<comment>Param:</comment>
  <info>int       </info>  <strong>$lifetime_or_options</strong>  When using the first signature, lifetime of the session cookie,
                                    defined in seconds.
                                    
                                    When using the second signature, an associative <info>array</info> which may
                                    have any of the keys <return>lifetime</return>, <return>path</return>, <return>domain</return>, <return>secure</return>, <return>httponly</return>
                                    and <return>samesite</return>. The values have the same meaning as described for
                                    the parameters with the same name. The value of the <return>samesite</return>
                                    element should be either <return>Lax</return> or <return>Strict</return>. If any of the allowed
                                    options are not given, their default values are the same as the
                                    default values of the explicit parameters. If the <return>samesite</return>
                                    element is omitted, no SameSite cookie attribute is set.
  <info>stringnull</info>  <strong>$path               </strong>  Path on the domain where the cookie will work. Use a single
                                    slash ('/') for all paths on the domain.
  <info>stringnull</info>  <strong>$domain             </strong>  Cookie domain, for example 'www.php.net'. To make cookies
                                    visible on all subdomains then the domain must be prefixed with
                                    a dot like '.php.net'.
  <info>boolnull  </info>  <strong>$secure             </strong>  If <info>true</info> cookie will only be sent over secure connections.
  <info>boolnull  </info>  <strong>$httponly           </strong>  If set to <info>true</info> then PHP will attempt to send the httponly flag
                                    when setting the session cookie.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * session.cookie_lifetime
   * session.cookie_path
   * session.cookie_domain
   * session.cookie_secure
   * session.cookie_httponly
   * session.cookie_samesite
   * <strong>session_get_cookie_params()</strong>


id: session_set_save_handler
type: function
doc:
<comment>Description:</comment>
  Sets user-level session storage functions
  
  Since PHP 5.4 it is possible to register the following prototype:
  
  <strong>session_set_save_handler()</strong> sets the user-level session storage functions which are used for
  storing and retrieving data associated with a session.  This is most useful when a storage method
  other than those supplied by PHP sessions is preferred, e.g. storing the session data in a local
  database.

<comment>Param:</comment>
  <info>object  </info>  <strong>$sessionhandler   </strong>  An instance of a class implementing SessionHandlerInterface, and
                                optionally SessionIdInterface and/or
                                SessionUpdateTimestampHandlerInterface, such as <class>SessionHandler</class>, to
                                register as the session handler. Since PHP 5.4 only.
  <info>bool    </info>  <strong>$register_shutdown</strong>  Register <strong>session_write_close()</strong> as a <strong>register_shutdown_function()</strong>
                                function.
  <info>callable</info>  <strong>$open             </strong>  A callable with the following signature:
                                <info>bool</info>open<info>string</info><strong>$savePath</strong><info>string</info><strong>$sessionName</strong>
                                
                                The open callback works like a constructor in classes and is
                                executed when the session is being opened.  It is the first callback
                                function executed when the session is started automatically or
                                manually with <strong>session_start()</strong>. Return value is <info>true</info> for success,
                                <info>false</info> for failure.
  <info>callable</info>  <strong>$close            </strong>  A callable with the following signature: <info>bool</info>close
                                
                                The close callback works like a destructor in classes and is
                                executed after the session write callback has been called. It is
                                also invoked when <strong>session_write_close()</strong> is called. Return value
                                should be <info>true</info> for success, <info>false</info> for failure.
  <info>callable</info>  <strong>$read             </strong>  A callable with the following signature: <info>string</info>read<info>string</info><strong>$sessionId</strong>
                                
                                The <strong>$read</strong> callback must always return a session encoded (serialized)
                                string, or an empty string if there is no data to read.
                                
                                This callback is called internally by PHP when the session starts or
                                when <strong>session_start()</strong> is called.  Before this callback is invoked PHP
                                will invoke the <strong>$open</strong> callback.
                                
                                The value this callback returns must be in exactly the same
                                serialized format that was originally passed for storage to the
                                <strong>$write</strong> callback.  The value returned will be unserialized
                                automatically by PHP and used to populate the $_SESSION superglobal.
                                While the data looks similar to <strong>serialize()</strong> please note it is a
                                different format which is specified in the session.serialize_handler
                                ini setting.
  <info>callable</info>  <strong>$write            </strong>  A callable with the following signature:
                                <info>bool</info>write<info>string</info><strong>$sessionId</strong><info>string</info><strong>$data</strong>
                                
                                The <strong>$write</strong> callback is called when the session needs to be saved and
                                closed. This callback receives the current session ID a serialized
                                version the $_SESSION superglobal.  The serialization method used
                                internally by PHP is specified in the session.serialize_handler ini
                                setting.
                                
                                The serialized session data passed to this callback should be stored
                                against the passed session ID. When retrieving this data, the <strong>$read</strong>
                                callback must return the exact value that was originally passed to
                                the <strong>$write</strong> callback.
                                
                                This callback is invoked when PHP shuts down or explicitly when
                                <strong>session_write_close()</strong> is called.  Note that after executing this
                                function PHP will internally execute the <strong>$close</strong> callback.  The
                                "write" handler is not executed until after the output stream is
                                closed.  Thus, output from debugging statements in the "write"
                                handler will never be seen in the browser.  If debugging output is
                                necessary, it is suggested that the debug output be written to a
                                file instead.
                                
                                The "write" handler is not executed until after the output stream is
                                closed.  Thus, output from debugging statements in the "write"
                                handler will never be seen in the browser.  If debugging output is
                                necessary, it is suggested that the debug output be written to a
                                file instead.
  <info>callable</info>  <strong>$destroy          </strong>  A callable with the following signature: <info>bool</info>destroy<info>string</info><strong>$sessionId</strong>
                                
                                This callback is executed when a session is destroyed with
                                <strong>session_destroy()</strong> or with <strong>session_regenerate_id()</strong> with the destroy
                                parameter set to <info>true</info>. Return value should be <info>true</info> for success,
                                <info>false</info> for failure.
  <info>callable</info>  <strong>$gc               </strong>  A callable with the following signature: <info>bool</info>gc<info>int</info><strong>$lifetime</strong>
                                
                                The garbage collector callback is invoked internally by PHP
                                periodically in order to purge old session data.  The frequency is
                                controlled by session.gc_probability and session.gc_divisor. The
                                value of lifetime which is passed to this callback can be set in
                                session.gc_maxlifetime. Return value should be <info>true</info> for success,
                                <info>false</info> for failure.
  <info>callable</info>  <strong>$create_sid       </strong>  A callable with the following signature: <info>string</info>create_sid
                                
                                This callback is executed when a new session ID is required. No
                                parameters are provided, and the return value should be a string
                                that is a valid session ID for your handler.
  <info>callable</info>  <strong>$validate_sid     </strong>  A callable with the following signature: <info>bool</info>validate_sid<info>string</info><strong>$key</strong>
                                
                                This callback is executed when a session is to be started, a session
                                ID is supplied and session.use_strict_mode is enabled. The <strong>$key</strong> is
                                the session ID to validate. A session ID is valid, if a session with
                                that ID already exists. The return value should be <info>true</info> for success,
                                <info>false</info> for failure.
  <info>callable</info>  <strong>$update_timestamp </strong>  A callable with the following signature:
                                <info>bool</info>update_timestamp<info>string</info><strong>$key</strong><info>string</info><strong>$val</strong>
                                
                                This callback is executed when a session is updated. <strong>$key</strong> is the
                                session ID, <strong>$val</strong> is the session data. The return value should be
                                <info>true</info> for success, <info>false</info> for failure.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * 
     The session.save_handler
     configuration directive
    
   * 
     The session.serialize_handler
     configuration directive.
    
   * The <strong>register_shutdown_function()</strong>
   * The <strong>session_register_shutdown()</strong> for PHP 5.4.0+
   * 
     Refer to save_handler.inc
     for a full procedural reference implementation
    


id: session_start
type: function
doc:
<comment>Description:</comment>
  Start new or resume existing session
  
  <strong>session_start()</strong> creates a session or resumes the current one based on a session identifier passed
  via a GET or POST request, or passed via a cookie.
  
  When <strong>session_start()</strong> is called or when a session auto starts, PHP will call the open and read
  session save handlers.  These will either be a built-in save handler provided by default or by PHP
  extensions (such as SQLite or Memcached); or can be custom handler as defined by
  <strong>session_set_save_handler()</strong>. The read callback will retrieve any existing session data (stored in a
  special serialized format) and will be unserialized and used to automatically populate the
  $_SESSION superglobal when the read callback returns the saved session data back to PHP session
  handling.
  
  To use a named session, call <strong>session_name()</strong> before calling <strong>session_start()</strong>.
  
  When session.use_trans_sid is enabled, the <strong>session_start()</strong> function will register an internal
  output handler for URL rewriting.
  
  If a user uses <return>ob_gzhandler</return> or similar with <strong>ob_start()</strong>, the function order is important for proper
  output.  For example, <return>ob_gzhandler</return> must be registered before starting the session.

<comment>Param:</comment>
  <info>array</info>  <strong>$options</strong>  If provided, this is an associative array of options that will override the
                   currently set session configuration directives. The keys should not include the
                   <return>session.</return> prefix.
                   
                   In addition to the normal set of configuration directives, a <return>read_and_close</return>
                   option may also be provided. If set to <info>true</info>, this will result in the session
                   being closed immediately after being read, thereby avoiding unnecessary locking
                   if the session data won't be changed.

<comment>Return:</comment>
  <info>bool</info>  This function returns <info>true</info> if a session was successfully started, otherwise <info>false</info>.

<comment>See Also:</comment>
   * $_SESSION
   * 
     The session.auto_start
     configuration directive
    
   * <strong>session_id()</strong>


id: session_status
type: function
doc:
<comment>Description:</comment>
  Returns the current session status
  
  <strong>session_status()</strong> is used to return the current session status.

<comment>Return:</comment>
  <info>int</info>  <info>PHP_SESSION_DISABLED</info> if sessions are disabled.<info>PHP_SESSION_NONE</info> if sessions are enabled, but
       none exists.<info>PHP_SESSION_ACTIVE</info> if sessions are enabled, and one exists.
       
       <info>PHP_SESSION_DISABLED</info> if sessions are disabled.
       
       <info>PHP_SESSION_NONE</info> if sessions are enabled, but none exists.
       
       <info>PHP_SESSION_ACTIVE</info> if sessions are enabled, and one exists.

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


id: session_unregister
type: function
doc:
<comment>Description:</comment>
  Unregister a global variable from the current session
  
  <strong>session_unregister()</strong> unregisters the global variable named <strong>$name</strong> from the current session.
  
  Această facilitate a fost
  ÎNVECHITĂ începând cu PHP 5.3.0 și
  ELIMINATĂ începând cu PHP 5.4.0.

<comment>Param:</comment>
  <info>string</info>  <strong>$name</strong>  The variable name.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: session_unset
type: function
doc:
<comment>Description:</comment>
  Free all session variables
  
  The <strong>session_unset()</strong> function frees all session variables currently registered.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: session_write_close
type: function
doc:
<comment>Description:</comment>
  Write session data and end session
  
  End the current session and store session data.
  
  Session data is usually stored after your script terminated without the need to call
  <strong>session_write_close()</strong>, but as session data is locked to prevent concurrent writes only one script
  may operate on a session at any time. When using framesets together with sessions you will
  experience the frames loading one by one due to this locking. You can reduce the time needed to
  load all the frames by ending the session as soon as all changes to session variables are done.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * 
     The <strong>session_register_shutdown()</strong>
    


id: set_error_handler
type: function
doc:
<comment>Description:</comment>
  Stabilește o funcție definită de utilizator pentru prelucrarea erorilor
  
  Stabilește o funcție a utilizatorului (<strong>$error_handler</strong>) pentru a prelucra erorile într-un script.
  
  Această funcție poate fi utilizată pentru definirea propriului dumneavoastră mod de a prelucra
  erorile în timpul rulării, spre exemplu în aplicații în care este nevoie de a efectua curățirea
  datelor / fișierelor atunci când survine o eroare critică, sau când aveți nevoie să declanșați o
  eroare în anumite circumstanțe (utilizând <strong>trigger_error()</strong>).
  
  Este important de a ține minte că funcția standardă de prelucrare a erorii a PHP este ocolită
  complet pentru tipurile de erori specificate în <strong>$error_types</strong> dacă funcția de apel invers nu
  întoarce <info>false</info>. Setările <strong>error_reporting()</strong> nu vor avea nici un efect și funcția dumneavoastră de
  prelucrare a erorii va fi apelată în orice caz - însă puteți totuși citi valoarea curentă a
  error_reporting și să acționați corespunzător. Merită de menționat că această valoare va fi 0 dacă
  instrucțiunea care a cauzat eroarea a fost prefixată cu operatorul de control al erorii @.
  
  De asemenea observați ca este responsabilitatea dumneavoastră să efectuați <strong>die()</strong> dacă este
  necesar. Dacă funcția de prelucrare a erorii întoarce controlul execuției, execuția scriptului
  continuă cu următoarea instrucțiune după acea care a cauzat eroarea.
  
  Următoarele tipuri de erori nu pot fi prelucrate de o funcție definită de utilizator: <info>E_ERROR</info>,
  <info>E_PARSE</info>, <info>E_CORE_ERROR</info>, <info>E_CORE_WARNING</info>, <info>E_COMPILE_ERROR</info>, <info>E_COMPILE_WARNING</info>, indiferent de locul
  unde au fost emise și majoritatea <info>E_STRICT</info> ce survin în fișier, unde <strong>set_error_handler()</strong> este
  apelat.
  
  Dacă erorile survin înainte de execuția script-ului (de ex. la încărcarea fișierelor), funcțiile
  proprii de prelucrare a erorilor nu pot fi apelate, deoarece încă nu sunt înregistrate la acel
  moment.

<comment>Param:</comment>
  <info>callable</info>  <strong>$error_handler</strong>  O funcție de apel invers cu următoarea semnătură <info>null</info> poate fi transmisă
                            pentru a restabili acest handler la starea sa implicită. În loc de
                            denumirea funcției, un tablou ce conține o referință la obiect și
                            denumirea metodei pot fi furnizate.
                            
                            
                            <info>bool</info>handler<info>int</info><strong>$errno</strong><info>string</info><strong>$errstr</strong><info>string</info><strong>$errfile</strong><info>int</info><strong>$errline</strong><info>array</info><strong>$errcontext</strong><strong>$errno</strong>
                            Primul parametru, <strong>$errno</strong>, conține nivelul erorii (tip integer). <strong>$errstr</strong>
                            Al doilea parametru, <strong>$errstr</strong>, conține mesajul de eroare (tip string).
                            <strong>$errfile</strong> Al treilea parametru opțional, <strong>$errfile</strong>, conține denumirea
                            fișierului în care a avut loc eroarea (tip string). <strong>$errline</strong> Al patrulea
                            parametru opțional, <strong>$errline</strong>, conține numărul liniei unde a avut loc
                            eroarea (tip integer). <strong>$errcontext</strong> Al cincilea parametru opțional,
                            <strong>$errcontext</strong>, este un tablou ce indică spre tabelul de simboluri activ la
                            momentul când a avut loc eroarea. Cu alte cuvinte, <strong>$errcontext</strong> va
                            conține un tablou cu toate variabilele ce au existat în contextul în
                            care s-a produs eroarea. Funcția de prelucrare a erorii definită de
                            utilizator nu trebuie să modifice contextul erorii.  Acest parametru
                            este ÎNVECHIT începând cu PHP 7.2.0. Utilizarea acestuia este foarte
                            descurajată.
                            
                            Primul parametru, <strong>$errno</strong>, conține nivelul erorii (tip integer).
                            
                            Al doilea parametru, <strong>$errstr</strong>, conține mesajul de eroare (tip string).
                            
                            Al treilea parametru opțional, <strong>$errfile</strong>, conține denumirea fișierului în
                            care a avut loc eroarea (tip string).
                            
                            Al patrulea parametru opțional, <strong>$errline</strong>, conține numărul liniei unde a
                            avut loc eroarea (tip integer).
                            
                            Al cincilea parametru opțional, <strong>$errcontext</strong>, este un tablou ce indică
                            spre tabelul de simboluri activ la momentul când a avut loc eroarea. Cu
                            alte cuvinte, <strong>$errcontext</strong> va conține un tablou cu toate variabilele ce
                            au existat în contextul în care s-a produs eroarea. Funcția de
                            prelucrare a erorii definită de utilizator nu trebuie să modifice
                            contextul erorii.
                            
                            Acest parametru este ÎNVECHIT începând cu PHP 7.2.0. Utilizarea acestuia
                            este foarte descurajată.
                            
                            Dacă funcția întoarce <info>false</info>, atunci funcția normală de gestiune a erorii
                            continuă.
  <info>int     </info>  <strong>$errno        </strong>  Primul parametru, <strong>$errno</strong>, conține nivelul erorii (tip integer).
  <info>string  </info>  <strong>$errstr       </strong>  Al doilea parametru, <strong>$errstr</strong>, conține mesajul de eroare (tip string).
  <info>string  </info>  <strong>$errfile      </strong>  Al treilea parametru opțional, <strong>$errfile</strong>, conține denumirea fișierului în
                            care a avut loc eroarea (tip string).
  <info>int     </info>  <strong>$errline      </strong>  Al patrulea parametru opțional, <strong>$errline</strong>, conține numărul liniei unde a
                            avut loc eroarea (tip integer).
  <info>array   </info>  <strong>$errcontext   </strong>  Al cincilea parametru opțional, <strong>$errcontext</strong>, este un tablou ce indică
                            spre tabelul de simboluri activ la momentul când a avut loc eroarea. Cu
                            alte cuvinte, <strong>$errcontext</strong> va conține un tablou cu toate variabilele ce
                            au existat în contextul în care s-a produs eroarea. Funcția de
                            prelucrare a erorii definită de utilizator nu trebuie să modifice
                            contextul erorii.
                            
                            Acest parametru este ÎNVECHIT începând cu PHP 7.2.0. Utilizarea acestuia
                            este foarte descurajată.
  <info>int     </info>  <strong>$error_types  </strong>  Poate fi utilizat pentru a masca declanșarea funcției <strong>$error_handler</strong> în
                            mod asemănător cum setarea ini error_reporting controlează care erori
                            sunt afișate. Fără această mască stabilită <strong>$error_handler</strong> va fi apelată
                            la orice eroare, indiferent de setările error_reporting.

<comment>Return:</comment>
  <info>mixed</info>  Întoarce un string conținând funcția de prelucrare a erorii definită anterior (dacă
         există). Dacă se utilizează funcția implicită de prelucrare a erorii, va fi întors <info>null</info>.
         <info>null</info> este întors de asemenea și în cazul unei erori, cum ar fi o funcție de prelucrare a
         erorii invalidă. Dacă funcția precedentă de prelucrare a erorii era o metodă a unei clase,
         această funcție va întoarce un tablou indexat, incluzând clasa și denumirea metodei.

<comment>See Also:</comment>
   * <class>ErrorException</class>
   * <strong>error_reporting()</strong>
   * <strong>restore_error_handler()</strong>
   * <strong>trigger_error()</strong>
   * constantele nivelelor de erori


id: set_exception_handler
type: function
doc:
<comment>Description:</comment>
  Sets a user-defined exception handler function 
    
  
  Sets the default exception handler if an exception is not caught within a try/catch block.
  Execution will stop after the <strong>$exception_handler</strong> is called.

<comment>Param:</comment>
  <info>callable</info>  <strong>$exception_handler</strong>  Name of the function to be called when an uncaught exception occurs.
                                This handler function needs to accept one parameter, which will be
                                the exception object that was thrown. This is the handler signature
                                before PHP 7:
                                
                                <info>void</info>handler<info>Exception</info><strong>$ex</strong>
                                
                                Since PHP 7, most errors are reported by throwing <class>Error</class> exceptions,
                                which will be caught by the handler as well. Both <class>Error</class> and
                                <class>Exception</class> implements the <class>Throwable</class> interface. This is the handler
                                signature since PHP 7:
                                
                                <info>void</info>handler<info>Throwable</info><strong>$ex</strong>
                                
                                <info>null</info> may be passed instead, to reset this handler to its default
                                state.
                                
                                Note that providing an explicit <class>Exception</class> type hint for the <strong>$ex</strong>
                                parameter in your callback will cause issues with the changed
                                exception hierarchy in PHP 7.

<comment>Return:</comment>
  <info>callable</info>  Returns the name of the previously defined exception handler, or <info>null</info> on error. If no
            previous handler was defined, <info>null</info> is also returned.

<comment>See Also:</comment>
   * <strong>restore_exception_handler()</strong>
   * <strong>restore_error_handler()</strong>
   * <strong>error_reporting()</strong>
   * PHP 5 Exceptions


id: set_file_buffer
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru stream_set_write_buffer
  
  Această funcție este pseudonim pentru:  <strong>stream_set_write_buffer()</strong>.


id: set_include_path
type: function
doc:
<comment>Description:</comment>
  Sets the include_path configuration option
  
  Sets the include_path configuration option for the duration of the script.

<comment>Param:</comment>
  <info>string</info>  <strong>$include_path</strong>  The new value for the include_path

<comment>Return:</comment>
  <info>stringfalse</info>  Returns the old include_path on success sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>ini_set()</strong>
   * <strong>get_include_path()</strong>
   * <strong>restore_include_path()</strong>
   * <strong>include()</strong>


id: set_time_limit
type: function
doc:
<comment>Description:</comment>
  Limits the maximum execution time
  
  Set the number of seconds a script is allowed to run. If this is reached, the script returns a
  fatal error. The default limit is 30 seconds or, if it exists, the <return>max_execution_time</return> value
  defined in the php.ini.
  
  When called, <strong>set_time_limit()</strong> restarts the timeout counter from zero. In other words, if the
  timeout is the default 30 seconds, and 25 seconds into script execution a call such as
  <return>set_time_limit(20)</return> is made, the script will run for a total of 45 seconds before timing out.

<comment>Param:</comment>
  <info>int</info>  <strong>$seconds</strong>  The maximum execution time, in seconds. If set to zero, no time limit is imposed.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> on success, or <info>false</info> on failure.

<comment>See Also:</comment>
   * max_execution_time
   * max_input_time


id: setcookie
type: function
doc:
<comment>Description:</comment>
  Send a cookie
  
  Alternative signature available as of PHP 7.3.0:
  
  <strong>setcookie()</strong> defines a cookie to be sent along with the rest of the HTTP headers. Like other
  headers, cookies must be sent before any output from your script (this is a protocol restriction).
  This requires that you place calls to this function prior to any output, including <return>\<html&gt;</return> and <return>\<head&gt;</return> tags as well as any whitespace.
  
  Once the cookies have been set, they can be accessed on the next page load with the $_COOKIE
  array. Cookie values may also exist in $_REQUEST.

<comment>Param:</comment>
  <info>string</info>  <strong>$name    </strong>  The name of the cookie.
  <info>string</info>  <strong>$value   </strong>  The value of the cookie.  This value is stored on the clients computer; do not
                     store sensitive information.  Assuming the <strong>$name</strong> is <return>'cookiename'</return>, this value is
                     retrieved through $_COOKIE['cookiename']
  <info>int   </info>  <strong>$expires </strong>  The time the cookie expires.  This is a Unix timestamp so is in number of
                     seconds since the epoch.  In other words, you'll most likely set this with the
                     <strong>time()</strong> function plus the number of seconds before you want it to expire.  Or
                     you might use <strong>mktime()</strong>. <return>time()+60*60*24*30</return> will set the cookie to expire in 30
                     days. If set to 0, or omitted, the cookie will expire at the end of the session
                     (when the browser closes).
                     
                      You may notice the <strong>$expires</strong> parameter takes on a Unix timestamp, as opposed to
                     the date format <return>Wdy, DD-Mon-YYYY HH:MM:SS GMT</return>, this is because PHP does this
                     conversion internally.
                     
                     You may notice the <strong>$expires</strong> parameter takes on a Unix timestamp, as opposed to
                     the date format <return>Wdy, DD-Mon-YYYY HH:MM:SS GMT</return>, this is because PHP does this
                     conversion internally.
  <info>string</info>  <strong>$path    </strong>  The path on the server in which the cookie will be available on. If set to <return>'/'</return>,
                     the cookie will be available within the entire <strong>$domain</strong>.  If set to <return>'/foo/'</return>, the
                     cookie will only be available within the <return>/foo/</return> directory and all
                     sub-directories such as <return>/foo/bar/</return> of <strong>$domain</strong>.  The default value is the current
                     directory that the cookie is being set in.
  <info>string</info>  <strong>$domain  </strong>  The (sub)domain that the cookie is available to. Setting this to a subdomain
                     (such as <return>'www.example.com'</return>) will make the cookie available to that subdomain
                     and all other sub-domains of it (i.e. w2.www.example.com). To make the cookie
                     available to the whole domain (including all subdomains of it), simply set the
                     value to the domain name (<return>'example.com'</return>, in this case).
                     
                     Older browsers still implementing the deprecated RFC 2109 may require a leading
                     <return>.</return> to match all subdomains.
  <info>bool  </info>  <strong>$secure  </strong>  Indicates that the cookie should only be transmitted over a secure HTTPS
                     connection from the client. When set to <info>true</info>, the cookie will only be set if a
                     secure connection exists. On the server-side, it's on the programmer to send
                     this kind of cookie only on secure connection (e.g. with respect to
                     $_SERVER["HTTPS"]).
  <info>bool  </info>  <strong>$httponly</strong>  When <info>true</info> the cookie will be made accessible only through the HTTP protocol.
                     This means that the cookie won't be accessible by scripting languages, such as
                     JavaScript. It has been suggested that this setting can effectively help to
                     reduce identity theft through XSS attacks (although it is not supported by all
                     browsers), but that claim is often disputed. <info>true</info> or <info>false</info>
  <info>array </info>  <strong>$options </strong>  An associative <info>array</info> which may have any of the keys <return>expires</return>, <return>path</return>, <return>domain</return>,
                     <return>secure</return>, <return>httponly</return> and <return>samesite</return>. If any other key is present an error of level
                     <info>E_WARNING</info> is generated. The values have the same meaning as described for the
                     parameters with the same name. The value of the <return>samesite</return> element should be
                     either <return>None</return>, <return>Lax</return> or <return>Strict</return>. If any of the allowed options are not given, their
                     default values are the same as the default values of the explicit parameters.
                     If the <return>samesite</return> element is omitted, no SameSite cookie attribute is set.

<comment>Return:</comment>
  <info>bool</info>  If output exists prior to calling this function, <strong>setcookie()</strong> will fail and return <info>false</info>. If
        <strong>setcookie()</strong> successfully runs, it will return <info>true</info>. This does not indicate whether the user
        accepted the cookie.

<comment>See Also:</comment>
   * <strong>header()</strong>
   * <strong>setrawcookie()</strong>
   * cookies section
   * RFC 6265
   * RFC 2109


id: setlocale
type: function
doc:
<comment>Description:</comment>
  Set locale information
  
  Sets locale information.
  
  The locale information is maintained per process, not per thread. If you are running PHP on a
  multithreaded server API , you may experience sudden changes in locale settings while a script is
  running, though the script itself never called  <strong>setlocale()</strong>. This happens due to other scripts
  running in different threads of the same process at the same time, changing the process-wide
  locale using <strong>setlocale()</strong>. On Windows, locale information is maintained per thread as of PHP 5.6.20
  and PHP 7.0.5, respectively.

<comment>Param:</comment>
  <info>int   </info>  <strong>$category</strong>  <strong>$category</strong> is a named constant specifying the category of the functions affected
                     by the locale setting: <info>LC_ALL</info> for all of the below <info>LC_COLLATE</info> for string
                     comparison, see <strong>strcoll()</strong> <info>LC_CTYPE</info> for character classification and conversion,
                     for example <strong>strtoupper()</strong> <info>LC_MONETARY</info> for <strong>localeconv()</strong> <info>LC_NUMERIC</info> for decimal
                     separator (See also <strong>localeconv()</strong>) <info>LC_TIME</info> for date and time formatting with
                     <strong>strftime()</strong> <info>LC_MESSAGES</info> for system responses (available if PHP was compiled with
                     <return>libintl</return>)
                     
                     <info>LC_ALL</info> for all of the below
                     
                     <info>LC_COLLATE</info> for string comparison, see <strong>strcoll()</strong>
                     
                     <info>LC_CTYPE</info> for character classification and conversion, for example <strong>strtoupper()</strong>
                     
                     <info>LC_MONETARY</info> for <strong>localeconv()</strong>
                     
                     <info>LC_NUMERIC</info> for decimal separator (See also <strong>localeconv()</strong>)
                     
                     <info>LC_TIME</info> for date and time formatting with <strong>strftime()</strong>
                     
                     <info>LC_MESSAGES</info> for system responses (available if PHP was compiled with <return>libintl</return>)
  <info>string</info>  <strong>$locale  </strong>  If <strong>$locale</strong> is <info>null</info> or the empty string <return>""</return>, the locale names will be set from
                     the values of environment variables with the same names as the above
                     categories, or from "LANG".
                     
                     If <strong>$locale</strong> is <return>"0"</return>, the locale setting is not affected, only the current setting
                     is returned.
                     
                     If <strong>$locale</strong> is an array or followed by additional parameters then each array
                     element or parameter is tried to be set as new locale until success. This is
                     useful if a locale is known under different names on different systems or for
                     providing a fallback for a possibly not available locale.
  <info>string</info>  <strong>$locales </strong>  (Optional string or array parameters to try as locale settings until success.)

<comment>Return:</comment>
  <info>string</info>  Returns the new current locale, or <info>false</info> if the locale functionality is not implemented on
          your platform, the specified locale does not exist or the category name is invalid.
          
          An invalid category name also causes a warning message. Category/locale names can be found
          in RFC 1766 and ISO 639. Different systems have different naming schemes for locales.
          
          The return value of <strong>setlocale()</strong> depends on the system that PHP is running.  It returns
          exactly what the system <return>setlocale</return> function returns.


id: setproctitle
type: function
doc:
<comment>Description:</comment>
  Set the process title
  
  Sets the process title of the current process.

<comment>Param:</comment>
  <info>string</info>  <strong>$title</strong>  The title to use as the process title.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * <strong>cli_set_process_title()</strong>
   * <strong>pcntl_fork()</strong>
   * <strong>setthreadtitle()</strong>


id: setrawcookie
type: function
doc:
<comment>Description:</comment>
  Send a cookie without urlencoding the cookie value
  
  Alternative signature available as of PHP 7.3.0:
  
  <strong>setrawcookie()</strong> is exactly the same as <strong>setcookie()</strong> except that the cookie value will not be
  automatically urlencoded when sent to the browser.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: setthreadtitle
type: function
doc:
<comment>Description:</comment>
  Set the thread title
  
  Sets the thread title.

<comment>Param:</comment>
  <info>string</info>  <strong>$title</strong>  The title to use as the thread title.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>pcntl_fork()</strong>
   * <strong>setproctitle()</strong>


id: settype
type: function
doc:
<comment>Description:</comment>
  Stabilește tipul unei variabile
  
  Stabilește tipul variabilei <strong>$var</strong> în <strong>$type</strong>.

<comment>Param:</comment>
  <info>mixed </info>  <strong>$var </strong>  Variabila ce este convertită.
  <info>string</info>  <strong>$type</strong>  Valorile posibile ale <strong>$type</strong> sunt:  "boolean" sau "bool"  "integer" sau "int"
                 "float" sau "double"  "string"  "array"  "object"  "null"
                 
                 "boolean" sau "bool"
                 
                 "integer" sau "int"
                 
                 "float" sau "double"
                 
                 "string"
                 
                 "array"
                 
                 "object"
                 
                 "null"

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>gettype()</strong>
   * Transformarea tipurilor
   * Manipularea tipurilor


id: sha1
type: function
doc:
<comment>Description:</comment>
  Calculate the sha1 hash of a string
  
  Calculates the sha1 hash of <strong>$string</strong> using the US Secure Hash Algorithm 1.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  The input string.
  <info>bool  </info>  <strong>$binary</strong>  If the optional <strong>$binary</strong> is set to <info>true</info>, then the sha1 digest is instead returned
                   in raw binary format with a length of 20, otherwise the returned value is a
                   40-character hexadecimal number.

<comment>Return:</comment>
  <info>string</info>  Returns the sha1 hash as a string.

<comment>See Also:</comment>
   * <strong>sha1_file()</strong>
   * <strong>crc32()</strong>
   * <strong>md5()</strong>
   * <strong>hash()</strong>
   * <strong>crypt()</strong>
   * <strong>password_hash()</strong>


id: sha1_file
type: function
doc:
<comment>Description:</comment>
  Calculate the sha1 hash of a file
  
  Calculates the sha1 hash of the file specified by <strong>$filename</strong> using the US Secure Hash Algorithm 1,
  and returns that hash. The hash is a 40-character hexadecimal number.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  The filename of the file to hash.
  <info>bool  </info>  <strong>$binary  </strong>  When <info>true</info>, returns the digest in raw binary format with a length of 20.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns a string on success, <info>false</info> otherwise.

<comment>See Also:</comment>
   * <strong>sha1()</strong>
   * <strong>md5_file()</strong>
   * <strong>crc32()</strong>


id: shell_exec
type: function
doc:
<comment>Description:</comment>
  Execute command via shell and return the complete output as a string
  
  This function is identical to the backtick operator.
  
  On Windows, the underlying pipe is opened in text mode which can cause the function to fail for
  binary output. Consider to use <strong>popen()</strong> instead for such cases.

<comment>Param:</comment>
  <info>string</info>  <strong>$cmd</strong>  The command that will be executed.

<comment>Return:</comment>
  <info>string</info>  The output from the executed command or <info>null</info> if an error occurred or the command produces
          no output.
          
          This function can return <info>null</info> both when an error occurs or the program produces no output.
          It is not possible to detect execution failures using this function. <strong>exec()</strong> should be used
          when access to the program exit code is required.

<comment>See Also:</comment>
   * <strong>exec()</strong>
   * <strong>escapeshellcmd()</strong>


id: shm_attach
type: function
doc:
<comment>Description:</comment>
  Creates or open a shared memory segment
  
  <strong>shm_attach()</strong> returns an id that can be used to access the System V shared memory with the given
  <strong>$key</strong>, the first call creates the shared memory segment with  <strong>$size</strong> and the optional perm-bits
  <strong>$permissions</strong>.
  
  A second call to <strong>shm_attach()</strong> for the same <strong>$key</strong> will return a different <class>SysvSharedMemory</class> instance,
  but both instances access the same underlying shared memory. <strong>$size</strong> and <strong>$permissions</strong> will be
  ignored.

<comment>Param:</comment>
  <info>int    </info>  <strong>$key        </strong>  A numeric shared memory segment ID
  <info>intnull</info>  <strong>$size       </strong>  The memory size. If not provided, default to the <return>sysvshm.init_mem</return> in the
                         php.ini, otherwise 10000 bytes.
  <info>int    </info>  <strong>$permissions</strong>  The optional permission bits. Default to 0666.

<comment>Return:</comment>
  <info>SysvSharedMemoryfalse</info>  Returns a <class>SysvSharedMemory</class> instance on success,  sau <info>false</info> în cazul
                         eșecului.

<comment>See Also:</comment>
   * <strong>shm_detach()</strong>
   * <strong>ftok()</strong>


id: shm_detach
type: function
doc:
<comment>Description:</comment>
  Disconnects from shared memory segment
  
  <strong>shm_detach()</strong> disconnects from the shared memory given by the <strong>$shm</strong> created by <strong>shm_attach()</strong>.
  Remember, that shared memory still exist in the Unix system and the data is still present.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm</strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>shm_attach()</strong>
   * <strong>shm_remove()</strong>
   * <strong>shm_remove_var()</strong>


id: shm_get_var
type: function
doc:
<comment>Description:</comment>
  Returns a variable from shared memory
  
  <strong>shm_get_var()</strong> returns the variable with a given <strong>$key</strong>, in the given shared memory segment. The
  variable is still present in the shared memory.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm</strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.
  <info>int             </info>  <strong>$key</strong>  The variable key.

<comment>Return:</comment>
  <info>mixed</info>  Returns the variable with the given key.

<comment>See Also:</comment>
   * <strong>shm_has_var()</strong>
   * <strong>shm_put_var()</strong>


id: shm_has_var
type: function
doc:
<comment>Description:</comment>
  Check whether a specific entry exists
  
  Checks whether a specific key exists inside a shared memory segment.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm</strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.
  <info>int             </info>  <strong>$key</strong>  The variable key.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the entry exists, otherwise <info>false</info>

<comment>See Also:</comment>
   * <strong>shm_get_var()</strong>
   * <strong>shm_put_var()</strong>


id: shm_put_var
type: function
doc:
<comment>Description:</comment>
  Inserts or updates a variable in shared memory
  
  <strong>shm_put_var()</strong> inserts or updates the <strong>$value</strong> with the given <strong>$key</strong>.
  
  Warnings (<info>E_WARNING</info> level) will be issued if <strong>$shm</strong> is not a valid SysV shared memory index or if
  there was not enough shared memory remaining to complete your request.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm  </strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.
  <info>int             </info>  <strong>$key  </strong>  The variable key.
  <info>mixed           </info>  <strong>$value</strong>  The variable. All variable types that <strong>serialize()</strong> supports may be used:
                            generally this means all types except for resources and some internal
                            objects that cannot be serialized.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>shm_get_var()</strong>
   * <strong>shm_has_var()</strong>


id: shm_remove
type: function
doc:
<comment>Description:</comment>
  Removes shared memory from Unix systems
  
  <strong>shm_remove()</strong> removes the shared memory <strong>$shm</strong>. All data will be destroyed.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm</strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: shm_remove_var
type: function
doc:
<comment>Description:</comment>
  Removes a variable from shared memory
    
  
  Removes a variable with a given <strong>$key</strong> and frees the occupied memory.

<comment>Param:</comment>
  <info>SysvSharedMemory</info>  <strong>$shm</strong>  A shared memory segment obtained from <strong>shm_attach()</strong>.
  <info>int             </info>  <strong>$key</strong>  The variable key.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: shmop_close
type: function
doc:
<comment>Description:</comment>
  Close shared memory block
  
  <strong>shmop_close()</strong> is used to close a shared memory block.

<comment>Param:</comment>
  <info>Shmop</info>  <strong>$shmop</strong>  The shared memory block resource created by  <strong>shmop_open()</strong>

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

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


id: shmop_delete
type: function
doc:
<comment>Description:</comment>
  Delete shared memory block
  
  <strong>shmop_delete()</strong> is used to delete a shared memory block.

<comment>Param:</comment>
  <info>Shmop</info>  <strong>$shmop</strong>  The shared memory block resource created by  <strong>shmop_open()</strong>

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: shmop_open
type: function
doc:
<comment>Description:</comment>
  Create or open shared memory block
  
  <strong>shmop_open()</strong> can create or open a shared memory block.

<comment>Param:</comment>
  <info>int   </info>  <strong>$key        </strong>  System's id for the shared memory block. Can be passed as a decimal or hex.
  <info>string</info>  <strong>$mode       </strong>  The flags that you can use:  "a" for access (sets SHM_RDONLY for shmat) use
                        this flag when you need to open an existing shared memory segment for read
                        only  "c" for create (sets IPC_CREATE) use this flag when you need to create
                        a new shared memory segment or if a segment with the same key exists, try to
                        open it for read and write  "w" for read & write access use this flag when
                        you need to read and write to a shared memory segment, use this flag in most
                        cases.  "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) use this
                        flag when you want to create a new shared memory segment but if one already
                        exists with the same flag, fail. This is useful for security purposes, using
                        this you can prevent race condition exploits.
                        
                        "a" for access (sets SHM_RDONLY for shmat) use this flag when you need to
                        open an existing shared memory segment for read only
                        
                        "c" for create (sets IPC_CREATE) use this flag when you need to create a new
                        shared memory segment or if a segment with the same key exists, try to open
                        it for read and write
                        
                        "w" for read & write access use this flag when you need to read and write to
                        a shared memory segment, use this flag in most cases.
                        
                        "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) use this flag
                        when you want to create a new shared memory segment but if one already
                        exists with the same flag, fail. This is useful for security purposes, using
                        this you can prevent race condition exploits.
  <info>int   </info>  <strong>$permissions</strong>  The permissions that you wish to assign to your memory segment, those are
                        the same as permission for a file. Permissions need to be passed in octal
                        form, like for example <return>0644</return>
  <info>int   </info>  <strong>$size       </strong>  The size of the shared memory block you wish to create in bytes

<comment>Return:</comment>
  <info>Shmopfalse</info>  On success <strong>shmop_open()</strong> will return a <class>Shmop</class> instance that you can use to access the
              shared memory segment you've created. <info>false</info> is returned on failure.

<comment>See Also:</comment>
   * <strong>shmop_close()</strong>
   * <strong>shmop_delete()</strong>


id: shmop_read
type: function
doc:
<comment>Description:</comment>
  Read data from shared memory block
  
  <strong>shmop_read()</strong> will read a string from shared memory block.

<comment>Param:</comment>
  <info>Shmop</info>  <strong>$shmop </strong>  The shared memory block identifier created by  <strong>shmop_open()</strong>
  <info>int  </info>  <strong>$offset</strong>  Offset from which to start reading
  <info>int  </info>  <strong>$size  </strong>  The number of bytes to read. <return>0</return> reads shmop_size($shmid) - $start bytes.

<comment>Return:</comment>
  <info>string</info>  Returns the data sau <info>false</info> în cazul eșecului.

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


id: shmop_size
type: function
doc:
<comment>Description:</comment>
  Get size of shared memory block
  
  <strong>shmop_size()</strong> is used to get the size, in bytes of the shared memory block.

<comment>Param:</comment>
  <info>Shmop</info>  <strong>$shmop</strong>  The shared memory block identifier created by  <strong>shmop_open()</strong>

<comment>Return:</comment>
  <info>int</info>  Returns an int, which represents the number of bytes the shared memory block occupies.


id: shmop_write
type: function
doc:
<comment>Description:</comment>
  Write data into shared memory block
  
  <strong>shmop_write()</strong> will write a string into shared memory block.

<comment>Param:</comment>
  <info>Shmop </info>  <strong>$shmop </strong>  The shared memory block identifier created by  <strong>shmop_open()</strong>
  <info>string</info>  <strong>$data  </strong>  A string to write into shared memory block
  <info>int   </info>  <strong>$offset</strong>  Specifies where to start writing data inside the shared memory segment.

<comment>Return:</comment>
  <info>int</info>  The size of the written <strong>$data</strong>.

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


id: show_source
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru highlight_file
  
  Această funcție este pseudonim pentru:  <strong>highlight_file()</strong>.


id: shuffle
type: function
doc:
<comment>Description:</comment>
  Shuffle an array
  
  This function shuffles (randomizes the order of the elements in) an array. It uses a pseudo random
  number generator that is not suitable for cryptographic purposes.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  The array.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>array_rand()</strong>
   * Comparația funcțiilor de sortare a tablourilor


id: similar_text
type: function
doc:
<comment>Description:</comment>
  Calculate the similarity between two strings
  
  This calculates the similarity between two strings as described in Programming Classics:
  Implementing the World's Best Algorithms by Oliver (ISBN 0-131-00413-1). Note that this
  implementation does not use a stack as in Oliver's pseudo code, but recursive calls which may or
  may not speed up the whole process. Note also that the complexity of this algorithm is O(N**3)
  where N is the length of the longest string.

<comment>Param:</comment>
  <info>string</info>  <strong>$string1</strong>  The first string.
  <info>string</info>  <strong>$string2</strong>  The second string.
                    
                    Swapping the <strong>$string1</strong> and <strong>$string2</strong> may yield a different result; see the example
                    below.
  <info>float </info>  <strong>$percent</strong>  By passing a reference as third argument, <strong>similar_text()</strong> will calculate the
                    similarity in percent, by dividing the result of <strong>similar_text()</strong> by the average
                    of the lengths of the given strings times <return>100</return>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of matching chars in both strings.
       
       The number of matching characters is calculated by finding the longest first common
       substring, and then doing this for the prefixes and the suffixes, recursively. The lengths of
       all found common substrings are added.

<comment>See Also:</comment>
   * <strong>levenshtein()</strong>
   * <strong>soundex()</strong>


id: simplexml_import_dom
type: function
doc:
<comment>Description:</comment>
  Get a SimpleXMLElement object from a DOM node
  
  This function takes a node of a DOM document and makes it into a SimpleXML node. This new object
  can then be used as a native SimpleXML element.

<comment>Param:</comment>
  <info>DOMNode</info>  <strong>$node      </strong>  A DOM Element node
  <info>string </info>  <strong>$class_name</strong>  You may use this optional parameter so that <strong>simplexml_import_dom()</strong> will
                        return an object of  the specified class. That class should extend the
                        <info>SimpleXMLElement</info> class.

<comment>Return:</comment>
  <info>SimpleXMLElementfalse</info>  Returns a <info>SimpleXMLElement</info> sau <info>false</info> în cazul eșecului.
                         
                         Această funcție poate întoarce valoarea Boolean <info>false</info>, dar poate de
                         asemenea întoarce o valoare non-Boolean care evaluează în <info>false</info>. Vă rugăm
                         să
                         citiți secțiunea despre tipul Boolean
                         pentru informații suplimentare. Utilizați
                         operatorul === pentru a
                         verifica valoarea întoarsă de această funcție.

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


id: simplexml_load_file
type: function
doc:
<comment>Description:</comment>
  Interprets an XML file into an object
    
  
  Convert the well-formed XML document in the given file to an object.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename  </strong>  Path to the XML file
                       
                       Libxml 2 unescapes the URI, so if you want to pass e.g. <return>b&c</return> as the URI
                       parameter <return>a</return>, you have to call
                       <return>simplexml_load_file(rawurlencode('http://example.com/?a=' .
                       urlencode('b&c')))</return>. Since PHP 5.1.0 you don't need to do this because PHP
                       will do it for you.
  <info>string</info>  <strong>$class_name</strong>  You may use this optional parameter so that <strong>simplexml_load_file()</strong> will return
                       an object of  the specified class. That class should extend the
                       <info>SimpleXMLElement</info> class.
  <info>int   </info>  <strong>$options   </strong>  Since PHP 5.1.0 and Libxml 2.6.0, you may also use the <strong>$options</strong> parameter to
                       specify additional Libxml parameters.
  <info>string</info>  <strong>$ns        </strong>  Namespace prefix or URI.
  <info>bool  </info>  <strong>$is_prefix </strong>  <info>true</info> if <strong>$ns</strong> is a prefix, <info>false</info> if it's a URI; defaults to <info>false</info>.

<comment>Return:</comment>
  <info>SimpleXMLElementfalse</info>  Returns an <info>object</info> of class <info>SimpleXMLElement</info> with properties containing the
                         data held within the XML document, sau <info>false</info> în cazul eșecului.
                         
                         Această funcție poate întoarce valoarea Boolean <info>false</info>, dar poate de
                         asemenea întoarce o valoare non-Boolean care evaluează în <info>false</info>. Vă rugăm
                         să
                         citiți secțiunea despre tipul Boolean
                         pentru informații suplimentare. Utilizați
                         operatorul === pentru a
                         verifica valoarea întoarsă de această funcție.

<comment>See Also:</comment>
   * <strong>simplexml_load_string()</strong>
   * SimpleXMLElement::__construct
   * 
   * <strong>libxml_use_internal_errors()</strong>
   * 


id: simplexml_load_string
type: function
doc:
<comment>Description:</comment>
  Interprets a string of XML into an object
    
  
  Takes a well-formed XML string and returns it as an object.

<comment>Param:</comment>
  <info>string</info>  <strong>$data      </strong>  A well-formed XML string
  <info>string</info>  <strong>$class_name</strong>  You may use this optional parameter so that <strong>simplexml_load_string()</strong> will
                       return an object of  the specified class. That class should extend the
                       <info>SimpleXMLElement</info> class.
  <info>int   </info>  <strong>$options   </strong>  Since PHP 5.1.0 and Libxml 2.6.0, you may also use the <strong>$options</strong> parameter to
                       specify additional Libxml parameters.
  <info>string</info>  <strong>$ns        </strong>  Namespace prefix or URI.
  <info>bool  </info>  <strong>$is_prefix </strong>  <info>true</info> if <strong>$ns</strong> is a prefix, <info>false</info> if it's a URI; defaults to <info>false</info>.

<comment>Return:</comment>
  <info>SimpleXMLElementfalse</info>  Returns an <info>object</info> of class <info>SimpleXMLElement</info> with properties containing the
                         data held within the xml document, sau <info>false</info> în cazul eșecului.
                         
                         Această funcție poate întoarce valoarea Boolean <info>false</info>, dar poate de
                         asemenea întoarce o valoare non-Boolean care evaluează în <info>false</info>. Vă rugăm
                         să
                         citiți secțiunea despre tipul Boolean
                         pentru informații suplimentare. Utilizați
                         operatorul === pentru a
                         verifica valoarea întoarsă de această funcție.

<comment>See Also:</comment>
   * <strong>simplexml_load_file()</strong>
   * SimpleXMLElement::__construct
   * 
   * <strong>libxml_use_internal_errors()</strong>
   * 


id: sin
type: function
doc:
<comment>Description:</comment>
  Sine
  
  <strong>sin()</strong> returns the sine of the <strong>$num</strong> parameter.  The <strong>$num</strong> parameter is in radians.

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  A value in radians

<comment>Return:</comment>
  <info>float</info>  The sine of <strong>$num</strong>

<comment>See Also:</comment>
   * <strong>asin()</strong>
   * <strong>sinh()</strong>
   * <strong>cos()</strong>
   * <strong>tan()</strong>
   * <strong>deg2rad()</strong>


id: sinh
type: function
doc:
<comment>Description:</comment>
  Hyperbolic sine
  
  Returns the hyperbolic sine of <strong>$num</strong>, defined as <return>(exp(num) - exp(-num))/2</return>.

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  The argument to process

<comment>Return:</comment>
  <info>float</info>  The hyperbolic sine of <strong>$num</strong>

<comment>See Also:</comment>
   * <strong>sin()</strong>
   * <strong>asinh()</strong>
   * <strong>cosh()</strong>
   * <strong>tanh()</strong>


id: sizeof
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru count
  
  Această funcție este pseudonim pentru:  <strong>count()</strong>.


id: sleep
type: function
doc:
<comment>Description:</comment>
  Delay execution
  
  Delays the program execution for the given number of <strong>$seconds</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$seconds</strong>  Halt time in seconds.

<comment>Return:</comment>
  <info>int</info>  Returns zero on success, or <info>false</info> on error.
       
       If the call was interrupted by a signal, <strong>sleep()</strong> returns a non-zero value. On Windows, this
       value will always be <return>192</return> (the value of the <info>WAIT_IO_COMPLETION</info> constant within the Windows
       API). On other platforms, the return value will be the number of seconds left to sleep.

<comment>See Also:</comment>
   * <strong>usleep()</strong>
   * <strong>time_nanosleep()</strong>
   * <strong>time_sleep_until()</strong>
   * <strong>set_time_limit()</strong>


id: snmp2_get
type: function
doc:
<comment>Description:</comment>
  Fetch an SNMP object
  
  The <strong>snmp2_get()</strong> function is used to read the value of an SNMP object specified by the <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The SNMP agent.
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error.

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


id: snmp2_getnext
type: function
doc:
<comment>Description:</comment>
  Fetch the SNMP object which follows the given object id
  
  The <strong>snmp2_get_next()</strong> function is used to read the value of the SNMP object that follows the
  specified <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id which precedes the wanted one.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error. In case of an
                           error, an E_WARNING message is shown.

<comment>See Also:</comment>
   * <strong>snmp2_get()</strong>
   * <strong>snmp2_walk()</strong>


id: snmp2_real_walk
type: function
doc:
<comment>Description:</comment>
  Return all objects including their respective object ID within the specified one
  
  The <strong>snmp2_real_walk()</strong> function is used to traverse over a number of SNMP objects starting from
  <strong>$object_id</strong> and return not only their values but also their object ids.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id which precedes the wanted one.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an associative array of the SNMP object ids and their values on success or
             <info>false</info> on error. In case of an error, an E_WARNING message is shown.

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


id: snmp2_set
type: function
doc:
<comment>Description:</comment>
  Set the value of an SNMP object
  
  <strong>snmp2_set()</strong> is used to set the value of an SNMP object specified by the <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The write community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id.
  <info>arraystring</info>  <strong>$type     </strong>  Regulile MIB definesc tipul fiecărui identificator al obiectului. El
                           trebuie specificat printr-un singur caracter din lista ce urmează.
                           
                           Dacă a fost definit <info>OPAQUE_SPECIAL_TYPES</info> la compilarea bibliotecii SNMP,
                           următoarele de asemenea sunt valide:
                           
                           Majoritatea acestora vor utiliza tipul cel mai evident în corespondență
                           cu ASN.1. 's', 'x', 'd' și 'b' sunt toate diferite modalități de a
                           specifica o valoare OCTET STRING, iar tipul 'u' fără semn este utilizat
                           și pentru a menține valori Gauge32.
                           
                           Dacă fișierele MIB sunt încărcate în arborele MIB cu "snmp_read_mib" sau
                           specificându-le în configurația libsnmp, '=' poate fi utilizat în
                           calitate de parametru <strong>$type</strong> pentru toate identificatoarele obiectelor,
                           deoarece tipul poate fi apoi citit automat din MIB.
                           
                           Atrageți atenția că există două modalități de a stabili o variabilă de
                           tip BITS ca de exemplu "SYNTAX    BITS {telnet(0), ftp(1), http(2),
                           icmp(3), snmp(4), ssh(5), https(6)}":
                           
                           Utilizând tipul "b" și o listă de numere-biți. Această metodă nu este
                           recomandată deoarece o interpelare GET pentru același OID va întoarce de
                           ex. 0xF8.
                           
                           Utilizând tipul "x" și un număr hexadecimal, dar fără(!) prefixul
                           obișnuit "0x".
                           
                           Vedeți secțiunea cu exemple pentru mai multe detalii.
  <info>arraystring</info>  <strong>$value    </strong>  The new value.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Întoarce valoarea <info>true</info> în cazul
             succesului sau <info>false</info> în cazul eșecului.
             
             If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in
             packet. Reason: (badValue) The value given has the wrong type or length." is shown. If
             an unknown or invalid OID is specified the warning probably reads "Could not add
             variable".

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


id: snmp2_walk
type: function
doc:
<comment>Description:</comment>
  Fetch all the SNMP objects from an agent
  
  <strong>snmp2_walk()</strong> function is used to read all the values from an SNMP agent specified by the
  <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  If <info>null</info>, <strong>$object_id</strong> is taken as the root of the SNMP objects tree and all
                           objects under that tree are returned as an array.
                           
                           If <strong>$object_id</strong> is specified, all the SNMP objects below that <strong>$object_id</strong>
                           are returned.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an array of SNMP object values starting from the <strong>$object_id</strong> as root or <info>false</info> on
             error.

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


id: snmp3_get
type: function
doc:
<comment>Description:</comment>
  Fetch an SNMP object
  
  The <strong>snmp3_get()</strong> function is used to read the value of an SNMP object specified by the <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname          </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$security_name     </strong>  the security name, usually some kind of username
  <info>string     </info>  <strong>$security_level    </strong>  the security level (noAuthNoPriv|authNoPriv|authPriv)
  <info>string     </info>  <strong>$auth_protocol     </strong>  the authentication protocol (MD5 or SHA)
  <info>string     </info>  <strong>$auth_passphrase   </strong>  the authentication pass phrase
  <info>string     </info>  <strong>$privacy_protocol  </strong>  the privacy protocol (DES or AES)
  <info>string     </info>  <strong>$privacy_passphrase</strong>  the privacy pass phrase
  <info>arraystring</info>  <strong>$object_id         </strong>  The SNMP object id.
  <info>int        </info>  <strong>$timeout           </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries           </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error.

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


id: snmp3_getnext
type: function
doc:
<comment>Description:</comment>
  Fetch the SNMP object which follows the given object id
  
  The <strong>snmp3_getnext()</strong> function is used to read the value of the SNMP object that follows the
  specified <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname          </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$security_name     </strong>  the security name, usually some kind of username
  <info>string     </info>  <strong>$security_level    </strong>  the security level (noAuthNoPriv|authNoPriv|authPriv)
  <info>string     </info>  <strong>$auth_protocol     </strong>  the authentication protocol (MD5 or SHA)
  <info>string     </info>  <strong>$auth_passphrase   </strong>  the authentication pass phrase
  <info>string     </info>  <strong>$privacy_protocol  </strong>  the privacy protocol (DES or AES)
  <info>string     </info>  <strong>$privacy_passphrase</strong>  the privacy pass phrase
  <info>arraystring</info>  <strong>$object_id         </strong>  The SNMP object id.
  <info>int        </info>  <strong>$timeout           </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries           </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error. In case of an
                           error, an E_WARNING message is shown.

<comment>See Also:</comment>
   * <strong>snmp3_get()</strong>
   * <strong>snmp3_walk()</strong>


id: snmp3_real_walk
type: function
doc:
<comment>Description:</comment>
  Return all objects including their respective object ID within the specified one
  
  The <strong>snmp3_real_walk()</strong> function is used to traverse over a number of SNMP objects starting from
  <strong>$object_id</strong> and return not only their values but also their object ids.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname          </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$security_name     </strong>  the security name, usually some kind of username
  <info>string     </info>  <strong>$security_level    </strong>  the security level (noAuthNoPriv|authNoPriv|authPriv)
  <info>string     </info>  <strong>$auth_protocol     </strong>  the authentication protocol (MD5 or SHA)
  <info>string     </info>  <strong>$auth_passphrase   </strong>  the authentication pass phrase
  <info>string     </info>  <strong>$privacy_protocol  </strong>  the privacy protocol (DES or AES)
  <info>string     </info>  <strong>$privacy_passphrase</strong>  the privacy pass phrase
  <info>arraystring</info>  <strong>$object_id         </strong>  The SNMP object id.
  <info>int        </info>  <strong>$timeout           </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries           </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an associative array of the SNMP object ids and their values on success or
             <info>false</info> on error. In case of an error, an E_WARNING message is shown.

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


id: snmp3_set
type: function
doc:
<comment>Description:</comment>
  Set the value of an SNMP object
  
  <strong>snmp3_set()</strong> is used to set the value of an SNMP object specified by the <strong>$object_id</strong>.
  
  Even if the security level does not use an auth or priv protocol/password valid values have to be
  specified.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname          </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$security_name     </strong>  the security name, usually some kind of username
  <info>string     </info>  <strong>$security_level    </strong>  the security level (noAuthNoPriv|authNoPriv|authPriv)
  <info>string     </info>  <strong>$auth_protocol     </strong>  the authentication protocol (MD5 or SHA)
  <info>string     </info>  <strong>$auth_passphrase   </strong>  the authentication pass phrase
  <info>string     </info>  <strong>$privacy_protocol  </strong>  the privacy protocol (DES or AES)
  <info>string     </info>  <strong>$privacy_passphrase</strong>  the privacy pass phrase
  <info>arraystring</info>  <strong>$object_id         </strong>  The SNMP object id.
  <info>arraystring</info>  <strong>$type              </strong>  Regulile MIB definesc tipul fiecărui identificator al
                                    obiectului. El trebuie specificat printr-un singur caracter din
                                    lista ce urmează.
                                    
                                    Dacă a fost definit <info>OPAQUE_SPECIAL_TYPES</info> la compilarea
                                    bibliotecii SNMP, următoarele de asemenea sunt valide:
                                    
                                    Majoritatea acestora vor utiliza tipul cel mai evident în
                                    corespondență cu ASN.1. 's', 'x', 'd' și 'b' sunt toate diferite
                                    modalități de a specifica o valoare OCTET STRING, iar tipul 'u'
                                    fără semn este utilizat și pentru a menține valori Gauge32.
                                    
                                    Dacă fișierele MIB sunt încărcate în arborele MIB cu
                                    "snmp_read_mib" sau specificându-le în configurația libsnmp, '='
                                    poate fi utilizat în calitate de parametru <strong>$type</strong> pentru toate
                                    identificatoarele obiectelor, deoarece tipul poate fi apoi citit
                                    automat din MIB.
                                    
                                    Atrageți atenția că există două modalități de a stabili o
                                    variabilă de tip BITS ca de exemplu "SYNTAX    BITS {telnet(0),
                                    ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
                                    
                                    Utilizând tipul "b" și o listă de numere-biți. Această metodă nu
                                    este recomandată deoarece o interpelare GET pentru același OID
                                    va întoarce de ex. 0xF8.
                                    
                                    Utilizând tipul "x" și un număr hexadecimal, dar fără(!)
                                    prefixul obișnuit "0x".
                                    
                                    Vedeți secțiunea cu exemple pentru mai multe detalii.
  <info>arraystring</info>  <strong>$value             </strong>  The new value
  <info>int        </info>  <strong>$timeout           </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries           </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Întoarce valoarea <info>true</info> în cazul
             succesului sau <info>false</info> în cazul eșecului.
             
             If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in
             packet. Reason: (badValue) The value given has the wrong type or length." is shown. If
             an unknown or invalid OID is specified the warning probably reads "Could not add
             variable".


id: snmp3_walk
type: function
doc:
<comment>Description:</comment>
  Fetch all the SNMP objects from an agent
  
  <strong>snmp3_walk()</strong> function is used to read all the values from an SNMP agent specified by the
  <strong>$hostname</strong>.
  
  Even if the security level does not use an auth or priv protocol/password valid values have to be
  specified.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname          </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$security_name     </strong>  the security name, usually some kind of username
  <info>string     </info>  <strong>$security_level    </strong>  the security level (noAuthNoPriv|authNoPriv|authPriv)
  <info>string     </info>  <strong>$auth_protocol     </strong>  the authentication protocol (MD5 or SHA)
  <info>string     </info>  <strong>$auth_passphrase   </strong>  the authentication pass phrase
  <info>string     </info>  <strong>$privacy_protocol  </strong>  the privacy protocol (DES or AES)
  <info>string     </info>  <strong>$privacy_passphrase</strong>  the privacy pass phrase
  <info>arraystring</info>  <strong>$object_id         </strong>  If <info>null</info>, <strong>$object_id</strong> is taken as the root of the SNMP objects
                                    tree and all objects under that tree are returned as an array.
                                    
                                    If <strong>$object_id</strong> is specified, all the SNMP objects below that
                                    <strong>$object_id</strong> are returned.
  <info>int        </info>  <strong>$timeout           </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries           </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an array of SNMP object values starting from the <strong>$object_id</strong> as root or <info>false</info> on
             error.

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


id: snmp_get_quick_print
type: function
doc:
<comment>Description:</comment>
  Fetches the current value of the NET-SNMP library's quick_print setting
    
  
  Returns the current value stored in the NET-SNMP Library for quick_print.   quick_print is off by
  default.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if quick_print is on, <info>false</info> otherwise.

<comment>See Also:</comment>
   * <strong>snmp_set_quick_print()</strong> for a full description
     of what quick_print does.


id: snmp_get_valueretrieval
type: function
doc:
<comment>Description:</comment>
  Return the method how the SNMP values will be returned

<comment>Return:</comment>
  <info>int</info>  OR-ed combitantion of constants ( <info>SNMP_VALUE_LIBRARY</info> or <info>SNMP_VALUE_PLAIN</info> ) with possible
       SNMP_VALUE_OBJECT set.

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


id: snmp_read_mib
type: function
doc:
<comment>Description:</comment>
  Reads and parses a MIB file into the active MIB tree
    
  
  This function is used to load additional, e.g. vendor specific, MIBs so that human readable OIDs
  like VENDOR-MIB::foo.1 instead of error prone numeric OIDs can be used.
  
  The order in which the MIBs are loaded does matter as the underlying Net-SNMP libary will print
  warnings if referenced objects cannot be resolved.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  The filename of the MIB.

<comment>Return:</comment>
  <info>bool</info>  


id: snmp_set_enum_print
type: function
doc:
<comment>Description:</comment>
  Return all values that are enums with their enum value instead of the raw integer
    
  
  This function toggles if snmpwalk/snmpget etc. should automatically lookup enum values in the MIB
  and return them together with their human readable string.

<comment>Param:</comment>
  <info>bool</info>  <strong>$enable</strong>  As the value is interpreted as boolean by the Net-SNMP library, it can only be "0"
                 or "1".

<comment>Return:</comment>
  <info>bool</info>  


id: snmp_set_oid_numeric_print
type: function
doc:
<comment>Description:</comment>
  Set the OID output format
    
  
  Această funcție este pseudonim pentru:  <strong>snmp_set_oid_output_format()</strong>.

<comment>Return:</comment>
  <info>bool</info>  

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


id: snmp_set_oid_output_format
type: function
doc:
<comment>Description:</comment>
  Set the OID output format
    
  
  <strong>snmp_set_oid_output_format()</strong> sets the output format to be full or numeric.

<comment>Param:</comment>
  <info>int</info>  <strong>$format</strong>  Begining from PHP 5.4.0 four additional constants available:
                <info>SNMP_OID_OUTPUT_MODULE</info>DISMAN-EVENT-MIB::sysUpTimeInstance<info>SNMP_OID_OUTPUT_SUFFIX</info>sysUpTimeInstance<info>SNMP_OID_OUTPUT_UCD</info>system.sysUpTime.sysUpTimeInstance<info>SNMP_OID_OUTPUT_NONE</info>Undefined

<comment>Return:</comment>
  <info>bool</info>  Nu este întoarsă nici o valoare.


id: snmp_set_quick_print
type: function
doc:
<comment>Description:</comment>
  Set the value of enable within the NET-SNMP library
    
  
  Sets the value of <strong>$enable</strong> within the NET-SNMP library.  When this is set (1), the SNMP library
  will return 'quick printed' values.  This means that just the value will be printed.  When <strong>$enable</strong>
  is not enabled (default) the NET-SNMP library prints extra information including the type of the
  value (i.e. IpAddress or OID).  Additionally,  if quick_print is not enabled, the library prints
  additional hex values  for all strings of three characters or less.
  
  By default the NET-SNMP library returns verbose values, quick_print is used to return only the
  value.
  
  Currently strings are still returned with extra quotes, this will be corrected in a later release.

<comment>Param:</comment>
  <info>bool</info>  <strong>$enable</strong>  

<comment>Return:</comment>
  <info>bool</info>  Nu este întoarsă nici o valoare.

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


id: snmp_set_valueretrieval
type: function
doc:
<comment>Description:</comment>
  Specify the method how the SNMP values will be returned

<comment>Param:</comment>
  <info>int</info>  <strong>$method</strong>  

<comment>Return:</comment>
  <info>bool</info>  

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


id: snmpget
type: function
doc:
<comment>Description:</comment>
  Fetch an SNMP object
  
  The <strong>snmpget()</strong> function is used to read the value of an SNMP object specified by the <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The SNMP agent.
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error.

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


id: snmpgetnext
type: function
doc:
<comment>Description:</comment>
  Fetch the SNMP object which follows the given object id
    
  
  The <strong>snmpgetnext()</strong> function is used to read the value of the SNMP object that follows the specified
  <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id which precedes the wanted one.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>stdClassarraystringbool</info>  Returns SNMP object value on success or <info>false</info> on error. In case of an
                           error, an E_WARNING message is shown.

<comment>See Also:</comment>
   * <strong>snmpget()</strong>
   * <strong>snmpwalk()</strong>


id: snmprealwalk
type: function
doc:
<comment>Description:</comment>
  Return all objects including their respective object ID within the specified one
    
  
  The <strong>snmprealwalk()</strong> function is used to traverse over a number of SNMP objects starting from
  <strong>$object_id</strong> and return not only their values but also their object ids.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id which precedes the wanted one.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an associative array of the SNMP object ids and their values on success or
             <info>false</info> on error. In case of an error, an E_WARNING message is shown.

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


id: snmpset
type: function
doc:
<comment>Description:</comment>
  Set the value of an SNMP object
  
  <strong>snmpset()</strong> is used to set the value of an SNMP object specified by the <strong>$object_id</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The hostname of the SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The write community.
  <info>arraystring</info>  <strong>$object_id</strong>  The SNMP object id.
  <info>arraystring</info>  <strong>$type     </strong>  Regulile MIB definesc tipul fiecărui identificator al obiectului. El
                           trebuie specificat printr-un singur caracter din lista ce urmează.
                           
                           Dacă a fost definit <info>OPAQUE_SPECIAL_TYPES</info> la compilarea bibliotecii SNMP,
                           următoarele de asemenea sunt valide:
                           
                           Majoritatea acestora vor utiliza tipul cel mai evident în corespondență
                           cu ASN.1. 's', 'x', 'd' și 'b' sunt toate diferite modalități de a
                           specifica o valoare OCTET STRING, iar tipul 'u' fără semn este utilizat
                           și pentru a menține valori Gauge32.
                           
                           Dacă fișierele MIB sunt încărcate în arborele MIB cu "snmp_read_mib" sau
                           specificându-le în configurația libsnmp, '=' poate fi utilizat în
                           calitate de parametru <strong>$type</strong> pentru toate identificatoarele obiectelor,
                           deoarece tipul poate fi apoi citit automat din MIB.
                           
                           Atrageți atenția că există două modalități de a stabili o variabilă de
                           tip BITS ca de exemplu "SYNTAX    BITS {telnet(0), ftp(1), http(2),
                           icmp(3), snmp(4), ssh(5), https(6)}":
                           
                           Utilizând tipul "b" și o listă de numere-biți. Această metodă nu este
                           recomandată deoarece o interpelare GET pentru același OID va întoarce de
                           ex. 0xF8.
                           
                           Utilizând tipul "x" și un număr hexadecimal, dar fără(!) prefixul
                           obișnuit "0x".
                           
                           Vedeți secțiunea cu exemple pentru mai multe detalii.
  <info>arraystring</info>  <strong>$value    </strong>  The new value.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Întoarce valoarea <info>true</info> în cazul
             succesului sau <info>false</info> în cazul eșecului.
             
             If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in
             packet. Reason: (badValue) The value given has the wrong type or length." is shown. If
             an unknown or invalid OID is specified the warning probably reads "Could not add
             variable".

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


id: snmpwalk
type: function
doc:
<comment>Description:</comment>
  Fetch all the SNMP objects from an agent
  
  <strong>snmpwalk()</strong> function is used to read all the values from an SNMP agent specified by the <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The SNMP agent (server).
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  If <info>null</info>, <strong>$object_id</strong> is taken as the root of the SNMP objects tree and all
                           objects under that tree are returned as an array.
                           
                           If <strong>$object_id</strong> is specified, all the SNMP objects below that <strong>$object_id</strong>
                           are returned.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an array of SNMP object values starting from the <strong>$object_id</strong> as root or <info>false</info> on
             error.

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


id: snmpwalkoid
type: function
doc:
<comment>Description:</comment>
  Query for a tree of information about a network entity
    
  
  <strong>snmpwalkoid()</strong> function is used to read all object ids and their respective values from an SNMP
  agent specified by   <strong>$hostname</strong>.
  
  The existence of <strong>snmpwalkoid()</strong> and <strong>snmpwalk()</strong> has historical reasons.  Both functions are provided
  for backward compatibility. Use <strong>snmprealwalk()</strong> instead.

<comment>Param:</comment>
  <info>string     </info>  <strong>$hostname </strong>  The SNMP agent.
  <info>string     </info>  <strong>$community</strong>  The read community.
  <info>arraystring</info>  <strong>$object_id</strong>  If <info>null</info>, <strong>$object_id</strong> is taken as the root of the SNMP objects tree and all
                           objects under that tree are returned as an array.
                           
                           If <strong>$object_id</strong> is specified, all the SNMP objects below that <strong>$object_id</strong>
                           are returned.
  <info>int        </info>  <strong>$timeout  </strong>  The number of microseconds until the first timeout.
  <info>int        </info>  <strong>$retries  </strong>  The number of times to retry if timeouts occur.

<comment>Return:</comment>
  <info>arraybool</info>  Returns an associative array with object ids and their respective object value starting
             from the <strong>$object_id</strong> as root or <info>false</info> on error.

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


id: socket_accept
type: function
doc:
<comment>Description:</comment>
  Accepts a connection on a socket
  
  After the socket <strong>$socket</strong> has been created using <strong>socket_create()</strong>, bound to a name with
  <strong>socket_bind()</strong>, and told to listen for connections with <strong>socket_listen()</strong>, this function will accept
  incoming connections on that socket. Once a successful connection is made, a new socket resource
  is returned, which may be used for communication. If there are multiple connections queued on the
  socket, the first will be used. If there are no pending connections, <strong>socket_accept()</strong> will block
  until a connection becomes present. If <strong>$socket</strong> has been made non-blocking using
  <strong>socket_set_blocking()</strong> or <strong>socket_set_nonblock()</strong>, <info>false</info> will be returned.
  
  The socket resource returned by <strong>socket_accept()</strong> may not be used to accept new connections. The
  original listening socket <strong>$socket</strong>, however, remains open and may be reused.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong>.

<comment>Return:</comment>
  <info>resource</info>  Returns a new socket resource on success, or <info>false</info> on error. The actual error code can
            be retrieved by calling <strong>socket_last_error()</strong>. This error code may be passed to
            <strong>socket_strerror()</strong> to get a textual explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_create()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_strerror()</strong>


id: socket_addrinfo_bind
type: function
doc:
<comment>Description:</comment>
  Create and bind to a socket from a given addrinfo
  
  Create a Socket resource, and bind it to the provided AddrInfo resource.  The return value of this
  function may be used with <strong>socket_listen()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$addr</strong>  Resource created from <strong>socket_addrinfo_lookup()</strong>.

<comment>Return:</comment>
  <info>resource</info>  Returns a Socket resource on success or <info>null</info> on failure.

<comment>See Also:</comment>
   * <strong>socket_addrinfo_connect()</strong>
   * <strong>socket_addrinfo_explain()</strong>
   * <strong>socket_addrinfo_lookup()</strong>
   * <strong>socket_listen()</strong>


id: socket_addrinfo_connect
type: function
doc:
<comment>Description:</comment>
  Create and connect to a socket from a given addrinfo
  
  Create a Socket resource, and connect it to the provided AddrInfo resource.  The return value of
  this function may be used with the rest of the socket functions.

<comment>Param:</comment>
  <info>resource</info>  <strong>$addr</strong>  Resource created from <strong>socket_addrinfo_lookup()</strong>

<comment>Return:</comment>
  <info>resource</info>  Returns a Socket resource on success or <info>null</info> on failure.

<comment>See Also:</comment>
   * <strong>socket_addrinfo_bind()</strong>
   * <strong>socket_addrinfo_explain()</strong>
   * <strong>socket_addrinfo_lookup()</strong>


id: socket_addrinfo_explain
type: function
doc:
<comment>Description:</comment>
  Get information about addrinfo
  
  <strong>socket_addrinfo_explain()</strong> exposed the underlying <return>addrinfo</return> structure.

<comment>Param:</comment>
  <info>resource</info>  <strong>$addr</strong>  Resource created from <strong>socket_addrinfo_lookup()</strong>

<comment>Return:</comment>
  <info>array</info>  Returns an array containing the fields in the <return>addrinfo</return> structure.

<comment>See Also:</comment>
   * <strong>socket_addrinfo_bind()</strong>
   * <strong>socket_addrinfo_connect()</strong>
   * <strong>socket_addrinfo_lookup()</strong>


id: socket_addrinfo_lookup
type: function
doc:
<comment>Description:</comment>
  Get array with contents of getaddrinfo about the given hostname
  
  Lookup different ways we can connect to <strong>$host</strong>.  The returned array contains a set of resources
  that we can bind to using <strong>socket_addrinfo_bind()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$host   </strong>  Hostname to search.
  <info>string</info>  <strong>$service</strong>  The service to connect to.  If service is a name, it is translated to the
                    corresponding port number.
  <info>array </info>  <strong>$hints  </strong>  Hints provide criteria for selecting addresses returned.  You may specify the
                    hints as defined by getadrinfo.

<comment>Return:</comment>
  <info>array</info>  Returns an array of AddrInfo resource handles that can be used with the other
         socket_addrinfo functions.

<comment>See Also:</comment>
   * <strong>socket_addrinfo_bind()</strong>
   * <strong>socket_addrinfo_connect()</strong>
   * <strong>socket_addrinfo_explain()</strong>


id: socket_bind
type: function
doc:
<comment>Description:</comment>
  Binds a name to a socket
  
  Binds the name given in <strong>$address</strong> to the socket described by <strong>$socket</strong>. This has to be done before a
  connection is be established using <strong>socket_connect()</strong> or <strong>socket_listen()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  A valid socket resource created with <strong>socket_create()</strong>.
  <info>string  </info>  <strong>$address</strong>  If the socket is of the <info>AF_INET</info> family, the <strong>$address</strong> is an IP in dotted-quad
                      notation (e.g. <return>127.0.0.1</return>).
                      
                      If the socket is of the <info>AF_UNIX</info> family, the <strong>$address</strong> is the path of a
                      Unix-domain socket (e.g. /tmp/my.sock).
  <info>int     </info>  <strong>$port   </strong>  The <strong>$port</strong> parameter is only used when binding an <info>AF_INET</info> socket, and
                      designates the port on which to listen for connections.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.
        
        The error code can be retrieved with <strong>socket_last_error()</strong>. This code may be passed to
        <strong>socket_strerror()</strong> to get a textual explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_create()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_clear_error
type: function
doc:
<comment>Description:</comment>
  Clears the error on the socket or the last error code
  
  This function clears the error code on the given socket or the global last socket error if no
  socket is specified.
  
  This function allows explicitly resetting the error code value either of a socket or of the
  extension global last error code. This may be useful to detect within a part of the application if
  an error occurred or not.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong>.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_close
type: function
doc:
<comment>Description:</comment>
  Closes a socket resource
  
  <strong>socket_close()</strong> closes the socket resource given by <strong>$socket</strong>. This function is specific to sockets
  and cannot be used on any other type of resources.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.

<comment>See Also:</comment>
   * <strong>socket_bind()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_create()</strong>
   * <strong>socket_strerror()</strong>


id: socket_cmsg_space
type: function
doc:
<comment>Description:</comment>
  Calculate message buffer size
  
  Calculates the size of the buffer that should be allocated for receiving the ancillary data.
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>int</info>  <strong>$level</strong>  
  <info>int</info>  <strong>$type </strong>  

<comment>Return:</comment>
  <info>int</info>  

<comment>See Also:</comment>
   * <strong>socket_recvmsg()</strong>
   * <strong>socket_sendmsg()</strong>


id: socket_connect
type: function
doc:
<comment>Description:</comment>
  Initiates a connection on a socket
  
  Initiate a connection to <strong>$address</strong> using the socket resource <strong>$socket</strong>, which must be a valid socket
  resource created with <strong>socket_create()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  
  <info>string  </info>  <strong>$address</strong>  The <strong>$address</strong> parameter is either an IPv4 address in dotted-quad notation (e.g.
                      <return>127.0.0.1</return>) if  <strong>$socket</strong> is <info>AF_INET</info>, a valid  IPv6 address (e.g. <return>::1</return>) if IPv6
                      support is enabled and  <strong>$socket</strong> is <info>AF_INET6</info> or the pathname of a Unix domain
                      socket, if the socket family is <info>AF_UNIX</info>.
  <info>int     </info>  <strong>$port   </strong>  The <strong>$port</strong> parameter is only used and is mandatory when connecting to an
                      <info>AF_INET</info> or an  <info>AF_INET6</info> socket, and designates the port on the remote host to
                      which a connection should be made.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului. The error code can be retrieved with
        <strong>socket_last_error()</strong>. This code may be passed to <strong>socket_strerror()</strong> to get a textual
        explanation of the error.
        
        If the socket is non-blocking then this function returns <info>false</info> with an error <return>Operation now
        in progress</return>.

<comment>See Also:</comment>
   * <strong>socket_bind()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_create()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_create
type: function
doc:
<comment>Description:</comment>
  Create a socket (endpoint for communication)
  
  Creates and returns a socket resource, also referred to as an endpoint of communication. A typical
  network connection is made up of 2 sockets, one performing the role of the client, and another
  performing the role of the server.

<comment>Param:</comment>
  <info>int</info>  <strong>$domain  </strong>  The <strong>$domain</strong> parameter specifies the protocol family to be used by the socket.
  <info>int</info>  <strong>$type    </strong>  The <strong>$type</strong> parameter selects the type of communication to be used by the socket.
  <info>int</info>  <strong>$protocol</strong>  The <strong>$protocol</strong> parameter sets the specific protocol within the specified <strong>$domain</strong> to
                  be used when communicating on the returned socket. The proper value can be
                  retrieved by name by using <strong>getprotobyname()</strong>. If the desired protocol is TCP, or
                  UDP the corresponding constants <info>SOL_TCP</info>, and <info>SOL_UDP</info> can also be used.

<comment>Return:</comment>
  <info>resource</info>  <strong>socket_create()</strong> returns a socket resource on success, or <info>false</info> on error. The actual
            error code can be retrieved by calling <strong>socket_last_error()</strong>. This error code may be
            passed to <strong>socket_strerror()</strong> to get a textual explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_accept()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_create_listen
type: function
doc:
<comment>Description:</comment>
  Opens a socket on port to accept connections 
  
  <strong>socket_create_listen()</strong> creates a new socket resource of type <info>AF_INET</info> listening on all local
  interfaces on the given port waiting for new connections.
  
  This function is meant to ease the task of creating a new socket which only listens to accept new
  connections.

<comment>Param:</comment>
  <info>int</info>  <strong>$port   </strong>  The port on which to listen on all interfaces.
  <info>int</info>  <strong>$backlog</strong>  The <strong>$backlog</strong> parameter defines the maximum length the queue of pending connections
                 may grow to. <info>SOMAXCONN</info> may be passed as <strong>$backlog</strong> parameter, see <strong>socket_listen()</strong> for
                 more information.

<comment>Return:</comment>
  <info>resource</info>  <strong>socket_create_listen()</strong> returns a new socket resource on success or <info>false</info> on error. The
            error code can be retrieved with <strong>socket_last_error()</strong>. This code may be passed to
            <strong>socket_strerror()</strong> to get a textual explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_create()</strong>
   * <strong>socket_create_pair()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_create_pair
type: function
doc:
<comment>Description:</comment>
  Creates a pair of indistinguishable sockets and stores them in an array
  
  <strong>socket_create_pair()</strong> creates two connected and indistinguishable sockets, and stores them in <strong>$fd</strong>.
  This function is commonly used in IPC (InterProcess Communication).

<comment>Param:</comment>
  <info>int  </info>  <strong>$domain  </strong>  The <strong>$domain</strong> parameter specifies the protocol family to be used by the socket.
                    See <strong>socket_create()</strong> for the full list.
  <info>int  </info>  <strong>$type    </strong>  The <strong>$type</strong> parameter selects the type of communication to be used by the socket.
                    See <strong>socket_create()</strong> for the  full list.
  <info>int  </info>  <strong>$protocol</strong>  The <strong>$protocol</strong> parameter sets the specific protocol within the specified <strong>$domain</strong>
                    to be used when communicating on the returned socket. The proper value can be
                    retrieved by name by using <strong>getprotobyname()</strong>. If the desired protocol is TCP, or
                    UDP the corresponding constants <info>SOL_TCP</info>, and <info>SOL_UDP</info> can also be used.
                    
                    See <strong>socket_create()</strong> for the full list of supported  protocols.
  <info>array</info>  <strong>$fd      </strong>  Reference to an array in which the two socket resources will be inserted.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>socket_create()</strong>
   * <strong>socket_create_listen()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_export_stream
type: function
doc:
<comment>Description:</comment>
  Export a socket extension resource into a stream that encapsulates a socket
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  

<comment>Return:</comment>
  <info>resourcefalse</info>  Return resource sau <info>false</info> în cazul eșecului.


id: socket_get_option
type: function
doc:
<comment>Description:</comment>
  Gets socket options for the socket 
  
  The <strong>socket_get_option()</strong> function retrieves the value for the option specified by the <strong>$optname</strong>
  parameter for the specified <strong>$socket</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.
  <info>int     </info>  <strong>$level  </strong>  The <strong>$level</strong> parameter specifies the protocol level at which the option resides.
                      For example, to retrieve options at the socket level, a <strong>$level</strong> parameter of
                      <info>SOL_SOCKET</info> would be used. Other levels, such as <info>TCP</info>, can be used by specifying
                      the protocol number of that level. Protocol numbers can be found by using the
                      <strong>getprotobyname()</strong> function.
  <info>int     </info>  <strong>$optname</strong>  Reports whether the <strong>$socket</strong> lingers on  <strong>socket_close()</strong> if data is present. By
                      default,  when the socket is closed, it attempts to send all unsent data. In
                      the case of a connection-oriented socket,  <strong>socket_close()</strong> will wait for its
                      peer to acknowledge the data.
                      
                      If l_onoff is non-zero and  l_linger is zero, all the  unsent data will be
                      discarded and RST (reset) is sent to the  peer in the case of a
                      connection-oriented socket.
                      
                      On the other hand, if l_onoff is  non-zero and l_linger is non-zero,
                      <strong>socket_close()</strong> will block until all the data  is sent or the time specified in
                      l_linger elapses. If the socket is non-blocking,  <strong>socket_close()</strong> will fail and
                      return an error.

<comment>Return:</comment>
  <info>mixed</info>  Returns the value of the given option, or <info>false</info> on errors.

<comment>See Also:</comment>
   * <strong>socket_create_listen()</strong>
   * <strong>socket_set_option()</strong>


id: socket_get_status
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru stream_get_meta_data
  
  Această funcție este pseudonim pentru:  <strong>stream_get_meta_data()</strong>.


id: socket_getopt
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru socket_get_option
  
  Această funcție este pseudonim pentru:  <strong>socket_get_option()</strong>.


id: socket_getpeername
type: function
doc:
<comment>Description:</comment>
  Queries the remote side of the given socket which may either result in host/port or in a Unix
  filesystem path, dependent on its type
  
  Queries the remote side of the given socket which may either result in host/port or in a Unix
  filesystem path, dependent on its type.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.
  <info>string  </info>  <strong>$address</strong>  If the given socket is of type <info>AF_INET</info> or <info>AF_INET6</info>, <strong>socket_getpeername()</strong> will
                      return the peers (remote) IP address in appropriate notation (e.g. <return>127.0.0.1</return>
                      or <return>fe80::1</return>) in the <strong>$address</strong> parameter and, if the optional <strong>$port</strong> parameter is
                      present, also the associated port.
                      
                      If the given socket is of type <info>AF_UNIX</info>, <strong>socket_getpeername()</strong> will return the
                      Unix filesystem path (e.g. <return>/var/run/daemon.sock</return>) in the <strong>$address</strong> parameter.
  <info>int     </info>  <strong>$port   </strong>  If given, this will hold the port associated to <strong>$address</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului. <strong>socket_getpeername()</strong> may also return <info>false</info> if the
        socket type is not any of <info>AF_INET</info>, <info>AF_INET6</info>, or <info>AF_UNIX</info>, in which case the last socket error
        code is not updated.

<comment>See Also:</comment>
   * <strong>socket_getsockname()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_getsockname
type: function
doc:
<comment>Description:</comment>
  Queries the local side of the given socket which may either result in host/port or in a Unix
  filesystem path, dependent on its type
  
  <strong>socket_getsockname()</strong> should not be used with <info>AF_UNIX</info> sockets created with <strong>socket_connect()</strong>. Only
  sockets created with <strong>socket_accept()</strong> or a primary server socket following a call to <strong>socket_bind()</strong>
  will return meaningful values.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong>  or <strong>socket_accept()</strong>.
  <info>string  </info>  <strong>$addr  </strong>  If the given socket is of type <info>AF_INET</info> or <info>AF_INET6</info>, <strong>socket_getsockname()</strong> will
                     return the local IP address in appropriate notation (e.g. <return>127.0.0.1</return> or <return>fe80::1</return>)
                     in the <strong>$address</strong> parameter and, if the optional <strong>$port</strong> parameter is present, also
                     the associated port.
                     
                     If the given socket is of type <info>AF_UNIX</info>, <strong>socket_getsockname()</strong> will return the
                     Unix filesystem path (e.g. <return>/var/run/daemon.sock</return>) in the <strong>$address</strong> parameter.
  <info>int     </info>  <strong>$port  </strong>  If provided, this will hold the associated port.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului. <strong>socket_getsockname()</strong> may also return <info>false</info> if the
        socket type is not any of <info>AF_INET</info>, <info>AF_INET6</info>, or <info>AF_UNIX</info>, in which case the last socket error
        code is not updated.

<comment>See Also:</comment>
   * <strong>socket_getpeername()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_import_stream
type: function
doc:
<comment>Description:</comment>
  Import a stream
  
  Imports a stream that encapsulates a socket into a socket extension resource.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  The stream resource to import.

<comment>Return:</comment>
  <info>resource</info>  Returns <info>false</info> or <info>null</info> on failure.

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


id: socket_last_error
type: function
doc:
<comment>Description:</comment>
  Returns the last error on the socket 
  
  If a socket resource is passed to this function, the last error which occurred on this particular
  socket is returned. If the socket resource is omitted, the error code of the last failed socket
  function is returned. The latter is particularly helpful for functions like <strong>socket_create()</strong> which
  don't return a socket on failure and <strong>socket_select()</strong> which can fail for reasons not directly tied
  to a particular socket.  The error code is suitable to be fed to <strong>socket_strerror()</strong> which returns a
  string describing the given error code.
  
  If no error had occurred, or the error had been cleared with <strong>socket_clear_error()</strong>, the function
  returns <return>0</return>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong>.

<comment>Return:</comment>
  <info>int</info>  This function returns a socket error code.


id: socket_listen
type: function
doc:
<comment>Description:</comment>
  Listens for a connection on a socket
  
  After the socket <strong>$socket</strong> has been created using <strong>socket_create()</strong> and bound to a name with
  <strong>socket_bind()</strong>, it may be told to listen for incoming connections on <strong>$socket</strong>.
  
  <strong>socket_listen()</strong> is applicable only to sockets of type <info>SOCK_STREAM</info> or <info>SOCK_SEQPACKET</info>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_addrinfo_bind()</strong>
  <info>int     </info>  <strong>$backlog</strong>  A maximum of <strong>$backlog</strong> incoming connections will be queued for processing. If a
                      connection request arrives with the queue full the client may receive an error
                      with an indication of <return>ECONNREFUSED</return>, or, if the underlying protocol supports
                      retransmission, the request may be ignored so that retries may succeed.
                      
                      The maximum number passed to the <strong>$backlog</strong> parameter highly depends on the
                      underlying platform. On Linux, it is silently truncated to <info>SOMAXCONN</info>. On
                      win32, if passed <info>SOMAXCONN</info>, the underlying service provider responsible for
                      the socket will set the backlog to a maximum reasonable value. There is no
                      standard provision to find out the actual backlog value on this platform.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului. The error code can be retrieved with
        <strong>socket_last_error()</strong>. This code may be passed to <strong>socket_strerror()</strong> to get a textual
        explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_accept()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_connect()</strong>
   * <strong>socket_create()</strong>
   * <strong>socket_strerror()</strong>
   * <strong>socket_addrinfo_bind()</strong>


id: socket_read
type: function
doc:
<comment>Description:</comment>
  Reads a maximum of length bytes from a socket
  
  The function <strong>socket_read()</strong> reads from the socket resource <strong>$socket</strong> created by the <strong>socket_create()</strong>
  or <strong>socket_accept()</strong> functions.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.
  <info>int     </info>  <strong>$length</strong>  The maximum number of bytes read is specified by the <strong>$length</strong> parameter.
                     Otherwise you can use <info>\r</info>, <info>\n</info>, or <info>\0</info> to end reading (depending on the <strong>$type</strong>
                     parameter, see below).
  <info>int     </info>  <strong>$type  </strong>  Optional <strong>$type</strong> parameter is a named constant: <info>PHP_BINARY_READ</info> (Default) - use
                     the system <return>recv()</return> function. Safe for reading binary data. <info>PHP_NORMAL_READ</info> -
                     reading stops at <return>\n</return> or <return>\r</return>.
                     
                     <info>PHP_BINARY_READ</info> (Default) - use the system <return>recv()</return> function. Safe for reading
                     binary data.
                     
                     <info>PHP_NORMAL_READ</info> - reading stops at <return>\n</return> or <return>\r</return>.

<comment>Return:</comment>
  <info>string</info>  <strong>socket_read()</strong> returns the data as a string on success, or <info>false</info> on error (including if the
          remote host has closed the connection). The error code can be retrieved with
          <strong>socket_last_error()</strong>. This code may be passed to <strong>socket_strerror()</strong> to get a textual
          representation of the error.
          
          <strong>socket_read()</strong> returns a zero length string ("") when there is no more data to read.

<comment>See Also:</comment>
   * <strong>socket_accept()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>
   * <strong>socket_write()</strong>


id: socket_recv
type: function
doc:
<comment>Description:</comment>
  Receives data from a connected socket 
  
  The <strong>socket_recv()</strong> function receives <strong>$len</strong> bytes of data in <strong>$buf</strong> from <strong>$socket</strong>. <strong>socket_recv()</strong> can be
  used to gather data from connected sockets. Additionally, one or more flags can be specified to
  modify the behaviour of the function.
  
  <strong>$buf</strong> is passed by reference, so it must be specified as a variable in the argument list. Data read
  from <strong>$socket</strong> by <strong>socket_recv()</strong> will be returned in <strong>$buf</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  The <strong>$socket</strong> must be a socket resource previously created by socket_create().
  <info>string  </info>  <strong>$buf   </strong>  The data received will be fetched to the variable specified with <strong>$buf</strong>. If an
                     error occurs, if the connection is reset, or if no data is available, <strong>$buf</strong> will
                     be set to <info>null</info>.
  <info>int     </info>  <strong>$len   </strong>  Up to <strong>$len</strong> bytes will be fetched from remote host.
  <info>int     </info>  <strong>$flags </strong>  The value of <strong>$flags</strong> can be any combination of  the following flags, joined with
                     the binary OR (<return>|</return>) operator.

<comment>Return:</comment>
  <info>int</info>  <strong>socket_recv()</strong> returns the number of bytes received, or <info>false</info> if there was an error. The
       actual error code can be retrieved by  calling <strong>socket_last_error()</strong>. This error code may be
       passed to <strong>socket_strerror()</strong> to get a textual explanation of the error.


id: socket_recvfrom
type: function
doc:
<comment>Description:</comment>
  Receives data from a socket whether or not it is connection-oriented
  
  The <strong>socket_recvfrom()</strong> function receives <strong>$len</strong> bytes of data in <strong>$buf</strong> from <strong>$name</strong> on port <strong>$port</strong> (if
  the socket is not of type <info>AF_UNIX</info>) using <strong>$socket</strong>. <strong>socket_recvfrom()</strong> can be used to gather data
  from both connected and unconnected sockets. Additionally, one or more flags can be specified to
  modify the behaviour of the function.
  
  The <strong>$name</strong> and <strong>$port</strong> must be passed by reference. If the socket is not connection-oriented, <strong>$name</strong>
  will be set to the internet protocol address of the remote host or the path to the UNIX socket. If
  the socket is connection-oriented, <strong>$name</strong> is <info>null</info>. Additionally, the <strong>$port</strong> will contain the port of
  the remote host in the case of an unconnected <info>AF_INET</info> or <info>AF_INET6</info> socket.
  
  Această funcție acceptă și date binare.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  The <strong>$socket</strong> must be a socket resource previously created by socket_create().
  <info>string  </info>  <strong>$buf   </strong>  The data received will be fetched to the variable specified with <strong>$buf</strong>.
  <info>int     </info>  <strong>$len   </strong>  Up to <strong>$len</strong> bytes will be fetched from remote host.
  <info>int     </info>  <strong>$flags </strong>  The value of <strong>$flags</strong> can be any combination of  the following flags, joined with
                     the binary OR (<return>|</return>) operator.
  <info>string  </info>  <strong>$name  </strong>  If the socket is of the type <info>AF_UNIX</info> type, <strong>$name</strong> is the path to the file. Else,
                     for unconnected sockets, <strong>$name</strong> is the IP address of, the remote host, or <info>null</info>
                     if the socket is connection-oriented.
  <info>int     </info>  <strong>$port  </strong>  This argument only applies to <info>AF_INET</info> and <info>AF_INET6</info> sockets, and specifies the
                     remote port from which the data is received. If the socket is
                     connection-oriented, <strong>$port</strong> will be <info>null</info>.

<comment>Return:</comment>
  <info>int</info>  <strong>socket_recvfrom()</strong> returns the number of bytes received, or <info>false</info> if there was an error. The
       actual error code can be retrieved by  calling <strong>socket_last_error()</strong>. This error code may be
       passed to <strong>socket_strerror()</strong> to get a textual explanation of the error.

<comment>See Also:</comment>
   * <strong>socket_recv()</strong>
   * <strong>socket_send()</strong>
   * <strong>socket_sendto()</strong>
   * <strong>socket_create()</strong>


id: socket_recvmsg
type: function
doc:
<comment>Description:</comment>
  Read a message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  
  <info>array   </info>  <strong>$message</strong>  
  <info>int     </info>  <strong>$flags  </strong>  

<comment>Return:</comment>
  <info>int</info>  

<comment>See Also:</comment>
   * <strong>socket_sendmsg()</strong>
   * <strong>socket_cmsg_space()</strong>


id: socket_select
type: function
doc:
<comment>Description:</comment>
  Runs the select() system call on the given arrays of sockets with a specified timeout
  
  <strong>socket_select()</strong> accepts arrays of sockets and waits for them to change status. Those coming with
  BSD sockets background will recognize that those socket resource arrays are in fact the so-called
  file descriptor sets. Three independent arrays of socket resources are watched.

<comment>Param:</comment>
  <info>array</info>  <strong>$read   </strong>  The sockets listed in the <strong>$read</strong> array will be watched to see if characters become
                   available for reading (more precisely, to see if a read will not block - in
                   particular, a socket resource is also ready on end-of-file, in which case a
                   <strong>socket_read()</strong> will return a zero length string).
  <info>array</info>  <strong>$write  </strong>  The sockets listed in the <strong>$write</strong> array will be watched to see if a write will not
                   block.
  <info>array</info>  <strong>$except </strong>  The sockets listed in the <strong>$except</strong> array will be watched for exceptions.
  <info>int  </info>  <strong>$tv_sec </strong>  The <strong>$tv_sec</strong> and <strong>$tv_usec</strong> together form the <return>timeout</return> parameter. The <return>timeout</return> is an
                   upper bound on the amount of time elapsed before <strong>socket_select()</strong> return. <strong>$tv_sec</strong>
                   may be zero , causing <strong>socket_select()</strong> to return immediately. This is useful for
                   polling. If <strong>$tv_sec</strong> is <info>null</info> (no timeout), <strong>socket_select()</strong> can block indefinitely.
  <info>int  </info>  <strong>$tv_usec</strong>  

<comment>Return:</comment>
  <info>int</info>  On success <strong>socket_select()</strong> returns the number of socket resources contained in the modified
       arrays, which may be zero if the timeout expires before anything interesting happens. On
       error <info>false</info> is returned. The error code can be retrieved with <strong>socket_last_error()</strong>.
       
       Be sure to use the <return>===</return> operator when checking for an error. Since the <strong>socket_select()</strong> may
       return 0 the comparison with <return>==</return> would evaluate to <info>true</info>: Understanding <strong>socket_select()</strong>'s
       result
       ]]>

<comment>See Also:</comment>
   * <strong>socket_read()</strong>
   * <strong>socket_write()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_strerror()</strong>


id: socket_send
type: function
doc:
<comment>Description:</comment>
  Sends data to a connected socket
  
  The function <strong>socket_send()</strong> sends <strong>$len</strong> bytes to the socket <strong>$socket</strong> from <strong>$buf</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.
  <info>string  </info>  <strong>$buf   </strong>  A buffer containing the data that will be sent to the remote host.
  <info>int     </info>  <strong>$len   </strong>  The number of bytes that will be sent to the remote host from  <strong>$buf</strong>.
  <info>int     </info>  <strong>$flags </strong>  The value of <strong>$flags</strong> can be any combination of  the following flags, joined with
                     the binary OR (<return>|</return>) operator. Possible values for <strong>$flags</strong><info>MSG_OOB</info> Send OOB
                     (out-of-band) data. <info>MSG_EOR</info> Indicate a record mark. The sent data completes the
                     record. <info>MSG_EOF</info> Close the sender side of the socket and include an appropriate
                     notification of this at the end of the sent data. The sent data completes the
                     transaction. <info>MSG_DONTROUTE</info> Bypass routing, use direct interface.

<comment>Return:</comment>
  <info>int</info>  <strong>socket_send()</strong> returns the number of bytes sent, or <info>false</info> on error.

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


id: socket_sendmsg
type: function
doc:
<comment>Description:</comment>
  Send a message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  
  <info>array   </info>  <strong>$message</strong>  
  <info>int     </info>  <strong>$flags  </strong>  

<comment>Return:</comment>
  <info>intfalse</info>  Returns the number of bytes sent,  sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>socket_recvmsg()</strong>
   * <strong>socket_cmsg_space()</strong>


id: socket_sendto
type: function
doc:
<comment>Description:</comment>
  Sends a message to a socket, whether it is connected or not 
  
  The function <strong>socket_sendto()</strong> sends <strong>$len</strong> bytes from <strong>$buf</strong> through the socket <strong>$socket</strong> to the <strong>$port</strong> at
  the address <strong>$addr</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created using <strong>socket_create()</strong>.
  <info>string  </info>  <strong>$buf   </strong>  The sent data will be taken from buffer <strong>$buf</strong>.
  <info>int     </info>  <strong>$len   </strong>  <strong>$len</strong> bytes from <strong>$buf</strong> will be sent.
  <info>int     </info>  <strong>$flags </strong>  The value of <strong>$flags</strong> can be any combination of  the following flags, joined with
                     the binary OR (<return>|</return>) operator. Possible values for <strong>$flags</strong><info>MSG_OOB</info> Send OOB
                     (out-of-band) data. <info>MSG_EOR</info> Indicate a record mark. The sent data completes the
                     record. <info>MSG_EOF</info> Close the sender side of the socket and include an appropriate
                     notification of this at the end of the sent data. The sent data completes the
                     transaction. <info>MSG_DONTROUTE</info> Bypass routing, use direct interface.
  <info>string  </info>  <strong>$addr  </strong>  IP address of the remote host.
  <info>int     </info>  <strong>$port  </strong>  <strong>$port</strong> is the remote port number at which the data will be sent.

<comment>Return:</comment>
  <info>int</info>  <strong>socket_sendto()</strong> returns the number of bytes sent to the remote host, or <info>false</info> if an error
       occurred.

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


id: socket_set_block
type: function
doc:
<comment>Description:</comment>
  Sets blocking mode on a socket resource
  
  The <strong>socket_set_block()</strong> function removes the  <info>O_NONBLOCK</info> flag on the socket specified by the
  <strong>$socket</strong> parameter.
  
  When an operation (e.g. receive, send, connect, accept, ...) is performed on  a blocking socket,
  the script will pause its execution until it receives a signal or it can perform the operation.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>socket_set_nonblock()</strong>
   * <strong>socket_set_option()</strong>


id: socket_set_blocking
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru stream_set_blocking
  
  Această funcție este pseudonim pentru:  <strong>stream_set_blocking()</strong>.


id: socket_set_nonblock
type: function
doc:
<comment>Description:</comment>
  Sets nonblocking mode for file descriptor fd 
  
  The <strong>socket_set_nonblock()</strong> function sets the  <info>O_NONBLOCK</info> flag on the socket specified by the
  <strong>$socket</strong> parameter.
  
  When an operation (e.g. receive, send, connect, accept, ...) is performed on  a non-blocking
  socket, the script will not pause its execution until it receives a  signal or it can perform the
  operation. Rather, if the operation would result in a block, the called function will fail.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>socket_set_block()</strong>
   * <strong>socket_set_option()</strong>
   * <strong>stream_set_blocking()</strong>


id: socket_set_option
type: function
doc:
<comment>Description:</comment>
  Sets socket options for the socket
  
  The <strong>socket_set_option()</strong> function sets the option specified by the <strong>$optname</strong> parameter, at the
  specified protocol <strong>$level</strong>, to the value pointed to by the <strong>$optval</strong> parameter for the  <strong>$socket</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket </strong>  A valid socket resource created with <strong>socket_create()</strong> or <strong>socket_accept()</strong>.
  <info>int     </info>  <strong>$level  </strong>  The <strong>$level</strong> parameter specifies the protocol level at which the option resides.
                      For example, to retrieve options at the socket level, a <strong>$level</strong> parameter of
                      <info>SOL_SOCKET</info> would be used. Other levels, such as TCP, can be used by specifying
                      the protocol number of that level.  Protocol numbers can be found by using the
                      <strong>getprotobyname()</strong> function.
  <info>int     </info>  <strong>$optname</strong>  The available socket options are the same as those for the <strong>socket_get_option()</strong>
                      function.
  <info>mixed   </info>  <strong>$optval </strong>  The option value.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

<comment>See Also:</comment>
   * <strong>socket_create()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_strerror()</strong>
   * <strong>socket_last_error()</strong>
   * <strong>socket_get_option()</strong>


id: socket_set_timeout
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru stream_set_timeout
  
  Această funcție este pseudonim pentru:  <strong>stream_set_timeout()</strong>.


id: socket_setopt
type: function
doc:
<comment>Description:</comment>
  Pseudonim pentru socket_set_option
  
  Această funcție este pseudonim pentru:  <strong>socket_set_option()</strong>.


id: socket_shutdown
type: function
doc:
<comment>Description:</comment>
  Shuts down a socket for receiving, sending, or both
  
  The <strong>socket_shutdown()</strong> function allows you to stop incoming, outgoing or all data (the default)
  from being sent through the <strong>$socket</strong>
  
  The associated buffer, or buffers, may or may not be emptied.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  A valid socket resource created with <strong>socket_create()</strong>.
  <info>int     </info>  <strong>$how   </strong>  The value of <strong>$how</strong> can be one of the following: possible values for <strong>$how</strong><return>0</return>
                     Shutdown socket reading <return>1</return> Shutdown socket writing <return>2</return> Shutdown socket reading and
                     writing

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.


id: socket_strerror
type: function
doc:
<comment>Description:</comment>
  Return a string describing a socket error
  
  <strong>socket_strerror()</strong> takes as its <strong>$errno</strong> parameter a socket error code as returned by
  <strong>socket_last_error()</strong> and returns the corresponding explanatory text.
  
  Although the error messages generated by the socket extension are in  English, the system messages
  retrieved with this function will appear depending on the current locale (<info>LC_MESSAGES</info>).

<comment>Param:</comment>
  <info>int</info>  <strong>$errno</strong>  A valid socket error number, likely produced by  <strong>socket_last_error()</strong>.

<comment>Return:</comment>
  <info>string</info>  Returns the error message associated with the <strong>$errno</strong> parameter.

<comment>See Also:</comment>
   * <strong>socket_accept()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_create()</strong>


id: socket_write
type: function
doc:
<comment>Description:</comment>
  Write to a socket
  
  The function <strong>socket_write()</strong> writes to the <strong>$socket</strong> from the given <strong>$buffer</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket</strong>  
  <info>string  </info>  <strong>$buffer</strong>  The buffer to be written.
  <info>int     </info>  <strong>$length</strong>  The optional parameter <strong>$length</strong> can specify an alternate length of bytes written
                     to the socket. If this length is greater than the buffer length, it is silently
                     truncated to the length of the buffer.

<comment>Return:</comment>
  <info>intfalse</info>  Returns the number of bytes successfully written to the socket sau <info>false</info> în cazul
            eșecului. The error code can be retrieved with <strong>socket_last_error()</strong>. This code may be
            passed to <strong>socket_strerror()</strong> to get a textual explanation of the error.
            
            It is perfectly valid for <strong>socket_write()</strong> to return zero which means no bytes have been
            written. Be sure to use the <return>===</return> operator to check for <info>false</info> in case of an error.

<comment>See Also:</comment>
   * <strong>socket_accept()</strong>
   * <strong>socket_bind()</strong>
   * <strong>socket_connect()</strong>
   * <strong>socket_listen()</strong>
   * <strong>socket_read()</strong>
   * <strong>socket_strerror()</strong>


id: socket_wsaprotocol_info_export
type: function
doc:
<comment>Description:</comment>
  Exports the WSAPROTOCOL_INFO Structure
  
  Exports the <return>WSAPROTOCOL_INFO</return> structure into shared memory and returns an identifier to be used
  with <strong>socket_wsaprotocol_info_import()</strong>. The exported ID is only valid for the given <strong>$target_pid</strong>.
  
  This function is available only on Windows.

<comment>Param:</comment>
  <info>resource</info>  <strong>$socket    </strong>  A valid socket resource.
  <info>int     </info>  <strong>$target_pid</strong>  The ID of the process which will import the socket.

<comment>Return:</comment>
  <info>stringfalse</info>  Returns an identifier to be used for the import,  sau <info>false</info> în cazul eșecului

<comment>See Also:</comment>
   * <strong>socket_wsaprotocol_info_import()</strong>
   * <strong>socket_wsaprotocol_info_release()</strong>


id: socket_wsaprotocol_info_import
type: function
doc:
<comment>Description:</comment>
  Imports a Socket from another Process
  
  Imports a socket which has formerly been exported from another process.
  
  This function is available only on Windows.

<comment>Param:</comment>
  <info>string</info>  <strong>$info_id</strong>  The ID which has been returned by a former call to
                    <strong>socket_wsaprotocol_info_export()</strong>.

<comment>Return:</comment>
  <info>resourcefalse</info>  Returns the socket resource,  sau <info>false</info> în cazul eșecului

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


id: socket_wsaprotocol_info_release
type: function
doc:
<comment>Description:</comment>
  Releases an exported WSAPROTOCOL_INFO Structure
  
  Releases the shared memory corresponding to the given <strong>$info_id</strong>.
  
  This function is available only on Windows.

<comment>Param:</comment>
  <info>string</info>  <strong>$info_id</strong>  The ID which has been returned by a former call to
                    <strong>socket_wsaprotocol_info_export()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Întoarce valoarea <info>true</info> în cazul
        succesului sau <info>false</info> în cazul eșecului.

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


id: sodium_add
type: function
doc:
<comment>Description:</comment>
  Add large numbers
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$string1</strong>  
  <info>string</info>  <strong>$string2</strong>  

<comment>Return:</comment>
  <info>void</info>  Nu este întoarsă nici o valoare.


id: sodium_base642bin
type: function
doc:
<comment>Description:</comment>
  Description
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  
  <info>int   </info>  <strong>$id    </strong>  
  <info>string</info>  <strong>$ignore</strong>  

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


id: sodium_bin2base64
type: function
doc:
<comment>Description:</comment>
  Description
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  
  <info>int   </info>  <strong>$id    </strong>  

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


id: sodium_bin2hex
type: function
doc:
<comment>Description:</comment>
  Encode to hexadecimal
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  

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


id: sodium_compare
type: function
doc:
<comment>Description:</comment>
  Compare large numbers
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$string1</strong>  
  <info>string</info>  <strong>$string2</strong>  

<comment>Return:</comment>
  <info>int</info>  


id: sodium_crypto_aead_aes256gcm_decrypt
type: function
doc:
<comment>Description:</comment>
  Decrypt in combined mode with precalculation
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$ciphertext     </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

<comment>Return:</comment>
  <info>stringfalse</info>  


id: sodium_crypto_aead_aes256gcm_encrypt
type: function
doc:
<comment>Description:</comment>
  Encrypt in combined mode with precalculation
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$message        </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

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


id: sodium_crypto_aead_aes256gcm_is_available
type: function
doc:
<comment>Description:</comment>
  Check if hardware supports AES256-GCM
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Return:</comment>
  <info>bool</info>  


id: sodium_crypto_aead_aes256gcm_keygen
type: function
doc:
<comment>Description:</comment>
  Get random bytes for key
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

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


id: sodium_crypto_aead_chacha20poly1305_decrypt
type: function
doc:
<comment>Description:</comment>
  Verify that the ciphertext includes a valid tag
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$ciphertext     </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

<comment>Return:</comment>
  <info>stringfalse</info>  


id: sodium_crypto_aead_chacha20poly1305_encrypt
type: function
doc:
<comment>Description:</comment>
  Encrypt a message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$message        </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

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


id: sodium_crypto_aead_xchacha20poly1305_ietf_decrypt
type: function
doc:
<comment>Description:</comment>
  Description
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$ciphertext     </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

<comment>Return:</comment>
  <info>stringfalse</info>  


id: sodium_crypto_aead_xchacha20poly1305_ietf_encrypt
type: function
doc:
<comment>Description:</comment>
  Description
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$message        </strong>  
  <info>string</info>  <strong>$additional_data</strong>  
  <info>string</info>  <strong>$nonce          </strong>  
  <info>string</info>  <strong>$key            </strong>  

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


id: sodium_crypto_aead_xchacha20poly1305_ietf_keygen
type: function
doc:
<comment>Description:</comment>
  Description
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

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


id: sodium_crypto_auth
type: function
doc:
<comment>Description:</comment>
  Compute a tag for the message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$message</strong>  
  <info>string</info>  <strong>$key    </strong>  

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


id: sodium_crypto_auth_verify
type: function
doc:
<comment>Description:</comment>
  Verifies that the tag is valid for the message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$mac    </strong>  
  <info>string</info>  <strong>$message</strong>  
  <info>string</info>  <strong>$key    </strong>  

<comment>Return:</comment>
  <info>bool</info>  


id: sodium_crypto_box
type: function
doc:
<comment>Description:</comment>
  Encrypt a message
  
  Această funcție nu este documentată în prezent; este disponibilă numai
  lista sa de argumente.

<comment>Param:</comment>
  <info>string</info>  <strong>$message </strong>  
  <info>string</info>  <strong>$nonce   </strong>  
  <info>string</info>  <strong>$key_pair</strong>  

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


