Converts a value to array type. If the value is a string and it is
in the form (a,b,c) then an array consisting of each of the elements
will be returned. If the value is a string and it is not in this form
then an array consisting of just the string will be returned. If the value
is not a string then
public static ensureArray ( $value ) : array | ||
Résultat | array |
/** * Validates if the parameter is a valid data source. * If it is a string or an array, it will be converted as a TList object. * @param Traversable|array|string data source to be validated * @return Traversable the data that is traversable * @throws TInvalidDataTypeException if the data is neither null nor Traversable */ protected function validateDataSource($value) { if (is_string($value)) { $list = new TList(); foreach (TPropertyValue::ensureArray($value) as $key => $value) { if (is_array($value)) { $list->add($value); } else { $list->add(array($value, is_string($key) ? $key : $value)); } } return $list; } else { if (is_array($value)) { return new TMap($value); } else { if ($value instanceof TDbDataReader) { // read array from TDbDataReader since it's forward-only stream and can only be traversed once return $value->readAll(); } else { if ($value instanceof \Traversable || $value === null) { return $value; } else { throw new TInvalidDataTypeException('databoundcontrol_datasource_invalid', get_class($this)); } } } } }
/** * Sets the interval such that those rating values within the interval * will be considered as a half star rating. * @param array rating display half value interval, default is array(0.3, 0.7); */ public function setHalfRatingInterval($value) { $this->setViewState('HalfRating', TPropertyValue::ensureArray($value), array(0.3, 0.7)); }
/** * @param array Active Record primary key value to be edited. */ public function setRecordPk($value) { $this->clearRecordObject(); $val = TPropertyValue::ensureArray($value); $this->setViewState('PK', count($val) > 0 ? $val : null); }
/** * Sets the Css class name that this container can accept. * @param string comma delimited css class names. */ public function setAcceptCssClass($value) { $this->setViewState('Accepts', TPropertyValue::ensureArray($value), ''); }
public function setCustomTranslations($value) { return $this->setViewState('CustomTranslations', TPropertyValue::ensureArray($value)); }
/** * @param array search parameters */ public function setSearchParameters($value) { $this->setViewState('SearchParameters', TPropertyValue::ensureArray($value), array()); }
/** * Sets the possible values that the slider can take. * If this is set, {@link setStepSize StepSize} will be ignored. The latter * generates a set of evenly distributed candidate values. * @param array list of allowed values the slider can take */ public function setValues($value) { $this->setViewState('Values', TPropertyValue::ensureArray($value), array()); }