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

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


Description Description


Parameters Parameters

$table

(string) (Required) Table name.

$column

(string) (Required) Column name.

$value

(string) (Required) The text to check.


Top ↑

Return Return

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


Top ↑

Source Source

File: wp-includes/wp-db.php

	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'];
	}

Top ↑

Changelog Changelog

Changelog
Version Description
4.2.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

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