W3cubDocs

/WordPress

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.

Parameters

$table

(string) (Required) Table name.

$column

(string) (Required) Column name.

$value

(string) (Required) The text to check.

Return

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

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

Changelog

Version Description
4.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wpdb/strip_invalid_text_for_column