wpdb::strip_invalid_text_for_column( string $table, string $column, string $value ): string|WP_Error

In this article

Strips any invalid characters from the string for a given table and column.

Parameters

$tablestringrequired
Table name.
$columnstringrequired
Column name.
$valuestringrequired
The text to check.

Return

string|WP_Error The converted string, or a WP_Error object if the conversion fails.

Source

public function strip_invalid_text_for_column( $table, $column, $value ) {
	if ( ! is_string( $value ) ) {
		return $value;
	}

	$charset = $this->get_col_charset( $table, $column );
	if ( ! $charset ) {
		// Not a string column.
		return $value;
	} elseif ( is_wp_error( $charset ) ) {
		// Bail on real errors.
		return $charset;
	}

	$data = array(
		$column => array(
			'value'   => $value,
			'charset' => $charset,
			'length'  => $this->get_col_length( $table, $column ),
		),
	);

	$data = $this->strip_invalid_text( $data );
	if ( is_wp_error( $data ) ) {
		return $data;
	}

	return $data[ $column ]['value'];
}

Changelog

VersionDescription
4.2.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.