Updating functions list with new documentation

Author: moufmouf

generated/filesystem.php

@@ -755,7 +755,8 @@ function fopen(string $filename, string $mode, bool $use_include_path = false, $
  * @param string $enclosure The optional enclosure parameter sets the field
  * enclosure (one character only).
  * @param string $escape_char The optional escape_char parameter sets the
- * escape character (one character only).
+ * escape character (at most one character).
+ * An empty string ("") disables the proprietary escape mechanism.
  * @return int Returns the length of the written string  .
  * @throws FilesystemException
  *
@@ -1305,10 +1306,6 @@ function tempnam(string $dir, string $prefix): string
  * the file handle returned by tmpfile), or when the
  * script ends.
  *
- * For details, consult your system documentation on the
- * tmpfile(3) function, as well as the
- * stdio.h header file.
- *
  * @return resource Returns a file handle, similar to the one returned by
  * fopen, for the new file .
  * @throws FilesystemException

generated/funchand.php

@@ -87,19 +87,16 @@ function forward_static_call_array(callable $function, array $parameters)
  * @param callable $function The function or method to be called. This parameter may be an array,
  * with the name of the class, and the method, or a string, with a function
  * name.
- * @param mixed $parameter Zero or more parameters to be passed to the function.
- * @param mixed $params
+ * @param mixed $params Zero or more parameters to be passed to the function.
  * @return mixed Returns the function result, .
  * @throws FunchandException
  *
  */
-function forward_static_call(callable $function, $parameter = null, ...$params)
+function forward_static_call(callable $function, ...$params)
 {
     error_clear_last();
     if ($params !== []) {
-        $result = \forward_static_call($function, $parameter, ...$params);
-    } elseif ($parameter !== null) {
-        $result = \forward_static_call($function, $parameter);
+        $result = \forward_static_call($function, ...$params);
     } else {
         $result = \forward_static_call($function);
     }
@@ -115,18 +112,15 @@ function forward_static_call(callable $function, $parameter = null, ...$params)
  *
  * @param callable $function The function name as a string, or an array consisting of an object and
  * a method.
- * @param mixed $arg
  * @param mixed $params
  * @throws FunchandException
  *
  */
-function register_tick_function(callable $function, $arg = null, ...$params): void
+function register_tick_function(callable $function, ...$params): void
 {
     error_clear_last();
     if ($params !== []) {
-        $result = \register_tick_function($function, $arg, ...$params);
-    } elseif ($arg !== null) {
-        $result = \register_tick_function($function, $arg);
+        $result = \register_tick_function($function, ...$params);
     } else {
         $result = \register_tick_function($function);
     }

generated/functionsList.php

@@ -297,7 +297,6 @@
     'imagepng',
     'imagepolygon',
     'imagerectangle',
-    'imageresolution',
     'imagerotate',
     'imagesavealpha',
     'imagescale',
@@ -379,11 +378,14 @@
     'inotify_rm_watch',
     'json_encode',
     'json_last_error_msg',
+    'ldap_add_ext',
     'ldap_add',
+    'ldap_bind_ext',
     'ldap_bind',
     'ldap_control_paged_result_response',
     'ldap_control_paged_result',
     'ldap_count_entries',
+    'ldap_delete_ext',
     'ldap_delete',
     'ldap_exop_passwd',
     'ldap_exop_whoami',
@@ -399,14 +401,18 @@
     'ldap_get_values_len',
     'ldap_get_values',
     'ldap_list',
+    'ldap_mod_add_ext',
     'ldap_mod_add',
+    'ldap_mod_del_ext',
     'ldap_mod_del',
+    'ldap_mod_replace_ext',
     'ldap_mod_replace',
     'ldap_modify_batch',
     'ldap_next_attribute',
     'ldap_parse_exop',
     'ldap_parse_result',
     'ldap_read',
+    'ldap_rename_ext',
     'ldap_rename',
     'ldap_sasl_bind',
     'ldap_search',
@@ -568,8 +574,10 @@
     'oci_rollback',
     'oci_server_version',
     'oci_set_action',
+    'oci_set_call_timeout',
     'oci_set_client_identifier',
     'oci_set_client_info',
+    'oci_set_db_operation',
     'oci_set_edition',
     'oci_set_module_name',
     'oci_set_prefetch',

generated/image.php

@@ -603,12 +603,11 @@ function imagecrop($image, array $rect)
  * @param float $threshold
  * @param int $color
  * @return resource Returns a cropped image resource on success .
- * If no cropping would occur, or the complete image would be cropped, that is
- * treated as failure, i.e. imagecrop returns FALSE.
+ * If the complete image was cropped, imagecrop returns FALSE.
  * @throws ImageException
  *
  */
-function imagecropauto($image, int $mode = -1, float $threshold = .5, int $color = -1)
+function imagecropauto($image, int $mode = IMG_CROP_DEFAULT, float $threshold = .5, int $color = -1)
 {
     error_clear_last();
     $result = \imagecropauto($image, $mode, $threshold, $color);
@@ -1155,11 +1154,7 @@ function imagegd2($image, $to = null, int $chunk_size = 128, int $type = IMG_GD2
 function imagegif($image, $to = null): void
 {
     error_clear_last();
-    if ($to !== null) {
-        $result = \imagegif($image, $to);
-    } else {
-        $result = \imagegif($image);
-    }
+    $result = \imagegif($image, $to);
     if ($result === false) {
         throw ImageException::createFromPhpError();
     }
@@ -1211,25 +1206,16 @@ function imagegrabwindow(int $window_handle, int $client_area = 0)
  * @param resource $image An image resource, returned by one of the image creation functions,
  * such as imagecreatetruecolor.
  * @param mixed $to The path or an open stream resource (which is automatically being closed after this function returns) to save the file to. If not set or NULL, the raw image stream will be outputted directly.
- *
- * To skip this argument in order to provide the
- * quality parameter, use NULL.
  * @param int $quality quality is optional, and ranges from 0 (worst
  * quality, smaller file) to 100 (best quality, biggest file). The
- * default is the default IJG quality value (about 75).
+ * default (-1) uses the default IJG quality value (about 75).
  * @throws ImageException
  *
  */
-function imagejpeg($image, $to = null, int $quality = null): void
+function imagejpeg($image, $to = null, int $quality = -1): void
 {
     error_clear_last();
-    if ($quality !== null) {
-        $result = \imagejpeg($image, $to, $quality);
-    } elseif ($to !== null) {
-        $result = \imagejpeg($image, $to);
-    } else {
-        $result = \imagejpeg($image);
-    }
+    $result = \imagejpeg($image, $to, $quality);
     if ($result === false) {
         throw ImageException::createFromPhpError();
     }
@@ -1447,28 +1433,22 @@ function imageopenpolygon($image, array $points, int $num_points, int $color): v
  *
  * NULL is invalid if the quality and
  * filters arguments are not used.
- * @param int $quality Compression level: from 0 (no compression) to 9. The current default is 6.
+ * @param int $quality Compression level: from 0 (no compression) to 9.
+ * The default (-1) uses the zlib compression default.
  * For more information see the zlib manual.
  * @param int $filters Allows reducing the PNG file size. It is a bitmask field which may be
  * set to any combination of the PNG_FILTER_XXX
  * constants. PNG_NO_FILTER or
  * PNG_ALL_FILTERS may also be used to respectively
  * disable or activate all filters.
+ * The default value (-1) disables filtering.
  * @throws ImageException
  *
  */
-function imagepng($image, $to = null, int $quality = null, int $filters = null): void
+function imagepng($image, $to = null, int $quality = -1, int $filters = -1): void
 {
     error_clear_last();
-    if ($filters !== null) {
-        $result = \imagepng($image, $to, $quality, $filters);
-    } elseif ($quality !== null) {
-        $result = \imagepng($image, $to, $quality);
-    } elseif ($to !== null) {
-        $result = \imagepng($image, $to);
-    } else {
-        $result = \imagepng($image);
-    }
+    $result = \imagepng($image, $to, $quality, $filters);
     if ($result === false) {
         throw ImageException::createFromPhpError();
     }
@@ -1544,48 +1524,6 @@ function imagerectangle($image, int $x1, int $y1, int $x2, int $y2, int $color):
 }
 
 
-/**
- * imageresolution allows to set and get the resolution of
- * an image in DPI (dots per inch). If none of the optional parameters is given,
- * the current resolution is returned as indexed array. If only
- * res_x is given, the horizontal and vertical resolution
- * are set to this value. If both optional parameters are given, the horizontal
- * and vertical resolution are set to these values, respectively.
- *
- * The resolution is only used as meta information when images are read from and
- * written to formats supporting this kind of information (curently PNG and
- * JPEG). It does not affect any drawing operations. The default resolution
- * for new images is 96 DPI.
- *
- * @param resource $image An image resource, returned by one of the image creation functions,
- * such as imagecreatetruecolor.
- * @param int $res_x The horizontal resolution in DPI.
- * @param int $res_y The vertical resolution in DPI.
- * @return mixed When used as getter (that is without the optional parameters), it returns
- * TRUE on success,  .
- * When used as setter (that is with one or both optional parameters given),
- * it returns an indexed array of the horizontal and vertical resolution on
- * success,  .
- * @throws ImageException
- *
- */
-function imageresolution($image, int $res_x = null, int $res_y = null)
-{
-    error_clear_last();
-    if ($res_y !== null) {
-        $result = \imageresolution($image, $res_x, $res_y);
-    } elseif ($res_x !== null) {
-        $result = \imageresolution($image, $res_x);
-    } else {
-        $result = \imageresolution($image);
-    }
-    if ($result === false) {
-        throw ImageException::createFromPhpError();
-    }
-    return $result;
-}
-
-
 /**
  * Rotates the image image using the given
  * angle in degrees.
@@ -2258,10 +2196,8 @@ function imagewbmp($image, $to = null, int $foreground = null): void
     error_clear_last();
     if ($foreground !== null) {
         $result = \imagewbmp($image, $to, $foreground);
-    } elseif ($to !== null) {
-        $result = \imagewbmp($image, $to);
     } else {
-        $result = \imagewbmp($image);
+        $result = \imagewbmp($image, $to);
     }
     if ($result === false) {
         throw ImageException::createFromPhpError();
@@ -2310,7 +2246,7 @@ function imagewebp($image, $to = null, int $quality = 80): void
  * @throws ImageException
  *
  */
-function imagexbm($image, ?string $filename, int $foreground = null): void
+function imagexbm($image, ?string $filename = null, int $foreground = null): void
 {
     error_clear_last();
     if ($foreground !== null) {

generated/json.php

@@ -30,6 +30,7 @@
  * JSON_PRESERVE_ZERO_FRACTION,
  * JSON_UNESCAPED_UNICODE,
  * JSON_PARTIAL_OUTPUT_ON_ERROR,
+ * JSON_UNESCAPED_LINE_TERMINATORS,
  * JSON_THROW_ON_ERROR. The behaviour of these
  * constants is described on the
  * JSON constants page.