Merge remote-tracking branch 'tcm/master'

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [staabm, shish, OskarStark]

generated/curl.php

@@ -57,7 +57,7 @@ function curl_escape(\CurlHandle $handle, string $string): string
  * stdout and returns TRUE.
  * However, if the CURLOPT_RETURNTRANSFER
  * option is set, it will return
- * the result on success, FALSE on failure.
+ * the result on success.
  * @throws CurlException
  *
  */
@@ -284,7 +284,7 @@ function curl_init(?string $url = null): \CurlHandle
  * @param \CurlMultiHandle $multi_handle A cURL multi handle returned by
  * curl_multi_init.
  * @param int|null $queued_messages Number of messages that are still in the queue
- * @return array On success, returns an associative array for the message, FALSE on failure.
+ * @return array On success, returns an associative array for the message.
  *
  *
  * Contents of the returned array

generated/datetime.php

@@ -899,7 +899,7 @@ function strptime(string $timestamp, string $format): array
  * @param string $datetime A date/time string. Valid formats are explained in Date and Time Formats.
  * @param int $baseTimestamp The timestamp which is used as a base for the calculation of relative
  * dates.
- * @return int Returns a timestamp on success, FALSE otherwise.
+ * @return int Returns a timestamp on success.
  * @throws DatetimeException
  *
  */

generated/functionsList.php

@@ -422,6 +422,7 @@
     'imap_unsubscribe',
     'imap_utf8_to_mutf7',
     'inet_ntop',
+    'inet_pton',
     'inflate_add',
     'inflate_get_read_len',
     'inflate_init',

generated/image.php

@@ -755,17 +755,18 @@ function imagecreate(int $width, int $height)
  * representing the image obtained from the given filename.
  *
  * @param string $filename Path to the AVIF raster image.
- * @return  Returns an image object on success, FALSE on errors.
+ * @return \GdImage Returns an image object on success, FALSE on errors.
  * @throws ImageException
  *
  */
-function imagecreatefromavif(string $filename): void
+function imagecreatefromavif(string $filename): \GdImage
 {
     error_clear_last();
     $safeResult = \imagecreatefromavif($filename);
     if ($safeResult === false) {
         throw ImageException::createFromPhpError();
     }
+    return $safeResult;
 }
 
 
@@ -939,17 +940,18 @@ function imagecreatefromstring(string $data)
  * representing the image obtained from the given filename.
  *
  * @param string $filename Path to the Truevision TGA image.
- * @return  Returns an image object on success, FALSE on errors.
+ * @return \GdImage Returns an image object on success, FALSE on errors.
  * @throws ImageException
  *
  */
-function imagecreatefromtga(string $filename): void
+function imagecreatefromtga(string $filename): \GdImage
 {
     error_clear_last();
     $safeResult = \imagecreatefromtga($filename);
     if ($safeResult === false) {
         throw ImageException::createFromPhpError();
     }
+    return $safeResult;
 }
 
 
@@ -1825,7 +1827,7 @@ function imagegif($image, $file = null): void
 /**
  * Grabs a screenshot of the whole screen.
  *
- * @return resource Returns an image object on success, FALSE on failure.
+ * @return resource Returns an image object on success.
  * @throws ImageException
  *
  */
@@ -1845,7 +1847,7 @@ function imagegrabscreen()
  *
  * @param int $handle The HWND window ID.
  * @param bool $client_area Include the client area of the application window.
- * @return \GdImage Returns an image object on success, FALSE on failure.
+ * @return \GdImage Returns an image object on success.
  * @throws ImageException
  *
  */

generated/info.php

@@ -274,7 +274,7 @@ function ini_get(string $option): string
  * ini_set. There is a list of all available options
  * in the appendix.
  * @param string $value The new value for the option.
- * @return string Returns the old value on success, FALSE on failure.
+ * @return string Returns the old value on success.
  * @throws InfoException
  *
  */

generated/libxml.php

@@ -8,7 +8,7 @@
  * Retrieve last error from libxml.
  *
  * @return \LibXMLError Returns a LibXMLError object if there is any error in the
- * buffer, FALSE otherwise.
+ * buffer.
  * @throws LibxmlException
  *
  */

generated/misc.php

@@ -54,7 +54,7 @@ function define(string $constant_name, $value, bool $case_insensitive = false):
  * highlighted code.
  * @return string|bool If return is set to TRUE, returns the highlighted
  * code as a string instead of printing it out. Otherwise, it will return
- * TRUE on success, FALSE on failure.
+ * TRUE on success.
  * @throws MiscException
  *
  */
@@ -216,7 +216,7 @@ function sapi_windows_set_ctrl_handler($handler, bool $add = true): void
 
 
 /**
- * If enable is NULL, the function returns TRUE if the stream stream has VT100 control codes enabled, FALSE otherwise.
+ * If enable is NULL, the function returns TRUE if the stream stream has VT100 control codes enabled.
  *
  * If enable is a bool, the function will try to enable or disable the VT100 features of the stream stream.
  * If the feature has been successfully enabled (or disabled).

generated/network.php

@@ -415,6 +415,30 @@ function inet_ntop(string $ip): string
 }
 
 
+/**
+ * This function converts a human readable IPv4 or IPv6 address (if PHP
+ * was built with IPv6 support enabled) into an address family appropriate
+ * 32bit or 128bit binary structure.
+ *
+ * @param string $ip A human readable IPv4 or IPv6 address.
+ * @return string Returns the in_addr representation of the given
+ * ip, or FALSE if a syntactically invalid
+ * ip is given (for example, an IPv4 address
+ * without dots or an IPv6 address without colons).
+ * @throws NetworkException
+ *
+ */
+function inet_pton(string $ip): string
+{
+    error_clear_last();
+    $safeResult = \inet_pton($ip);
+    if ($safeResult === false) {
+        throw NetworkException::createFromPhpError();
+    }
+    return $safeResult;
+}
+
+
 /**
  * Returns an enumeration of network interfaces (adapters) on the local machine.
  *