wpdb::process_field_formats( array $data, mixed $format )

Prepares arrays of value/format pairs as passed to wpdb CRUD methods.

Parameters

$data

(array) (Required) Array of fields to values.

$format

(mixed) (Required) Formats to be mapped to the values in $data.

Return

(array) Array, keyed by field names with values being an array of 'value' and 'format' keys.

Source

File: wp-includes/wp-db.php

protected function process_field_formats( $data, $format ) {
		$formats          = (array) $format;
		$original_formats = $formats;

		foreach ( $data as $field => $value ) {
			$value = array(
				'value'  => $value,
				'format' => '%s',
			);

			if ( ! empty( $format ) ) {
				$value['format'] = array_shift( $formats );
				if ( ! $value['format'] ) {
					$value['format'] = reset( $original_formats );
				}
			} elseif ( isset( $this->field_types[ $field ] ) ) {
				$value['format'] = $this->field_types[ $field ];
			}

			$data[ $field ] = $value;
		}

		return $data;
	}

Changelog

Version Description
4.2.0 Introduced.

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