WordPress at a glance

wp_unslash() WP 3.6.0

Removes slashes from a string or from strings of an array, or properties of an object. The array can be of any nesting level.

For example, this function should be used when adding $_POST data to the database using $wpdb->insert() because $wpdb->insert() expects unslashed data, whereas the data in $_POST is always slashed in WP.

This function is used in API functions such as update_post_meta(), wp_update_post(), wp_insert_post(), etc. All these functions expect passed data to be slashed. The exception is the options functions: update_option(), add_option() etc.

Use this function instead of stripslashes_deep().

If, on the contrary, you need to add slashes, use wp_slash().

✈ 1 time = 0.000027s = very fast | 50000 times = 0.21s = very fast | PHP 7.0.5, WP 4.5.2

No Hooks.

Return

String/String[]. Unslashed $value

Usage

wp_unslash( $value );
$value(string/string[]) (required)
String or array of strings to unslash.

Examples

#1. Remove slashes from a string

$val = 'Jerome D\'ambrosio - unknown driver.';
$val = wp_unslash( $val );
echo $val;

// returns:
// Jerome D'ambrosio - unknown driver.

#2. Remove slashes from array elements

This function can be used instead of stripslashes_deep(). Since this is a recursive function, it will remove slashes from all nested arrays.

$arr = array(
	"Did you read \'the man in the case\'?",
	array( 
		"\'the man in the case\' very interesting story"
	)
);

$arr = wp_unslash( $arr );
/*
 return: 
 array(
	"Did you read 'the man in the case'?",
	array( 
		"'the man in the case' very interesting story"
	)
 );
*/

Changelog

Since 3.6.0 Introduced.

Code of wp unslash: wp-includes/formatting.php WP 5.4.2

<?php
function wp_unslash( $value ) {
	return stripslashes_deep( $value );
}

Related Functions

From category: Helper Functions

No comments
        Log In . Register