From ed240e087e2a12de9d7576f5ad1ee2393344a9e9 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Sun, 17 Jan 2021 16:38:06 +0000 Subject: [PATCH] Docs: Correct description for `wp_slash()` and `wp_unslash()`. The array received or returned by these functions is not always an array of strings, for example when slashing or unslashing an array of arrays. Follow-up to [47400], [48441], [49926]. Props johnbillion. See #51800. Built from https://develop.svn.wordpress.org/trunk@49968 git-svn-id: http://core.svn.wordpress.org/trunk@49669 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/formatting.php | 12 ++++++------ wp-includes/version.php | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/wp-includes/formatting.php b/wp-includes/formatting.php index c3e1d42433..d0c560198b 100644 --- a/wp-includes/formatting.php +++ b/wp-includes/formatting.php @@ -5515,7 +5515,7 @@ function sanitize_trackback_urls( $to_ping ) { } /** - * Add slashes to a string or array of strings, in a recursive manner. + * Adds slashes to a string or recursively adds slashes to strings within an array. * * This should be used when preparing data for core API that expects slashed data. * This should not be used to escape data going directly into an SQL query. @@ -5523,8 +5523,8 @@ function sanitize_trackback_urls( $to_ping ) { * @since 3.6.0 * @since 5.5.0 Non-string values are left untouched. * - * @param string|string[] $value String or array of strings to slash. - * @return string|string[] Slashed $value. + * @param string|array $value String or array of data to slash. + * @return string|array Slashed $value. */ function wp_slash( $value ) { if ( is_array( $value ) ) { @@ -5539,15 +5539,15 @@ function wp_slash( $value ) { } /** - * Remove slashes from a string or array of strings. + * Removes slashes from a string or recursively removes slashes from strings within an array. * * This should be used to remove slashes from data passed to core API that * expects data to be unslashed. * * @since 3.6.0 * - * @param string|array $value String or array of strings to unslash. - * @return string|array Unslashed $value + * @param string|array $value String or array of data to unslash. + * @return string|array Unslashed $value. */ function wp_unslash( $value ) { return stripslashes_deep( $value ); diff --git a/wp-includes/version.php b/wp-includes/version.php index fa2b743c1a..791937ebf6 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.7-alpha-49967'; +$wp_version = '5.7-alpha-49968'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.