13.6.3.4 Doc::arrayToRawValue()
La méthode arrayToRawValue permet de sérialiser un ensemble de valeurs pour
les utiliser dans un attribut faisant partie d'un array ou un
attribut multi-valué.
13.6.3.4.1 Description
string arrayToRawValue ( array(string) $v, string $br = "<BR>" )
La métode arrayToRawValue permet de sérialiser un ensemble de valeurs sous la
forme d'une chaîne de caractères qui peut ensuite être utilisée pour
positionner la valeur d'un attribut faisant partie d'un array,
ou d'un attribut multi-valué, avec la méthode
Doc::setValue.
Les valeurs sont sérialisées par une concaténation avec le caractère \n
utilisé comme séparateur.
13.6.3.4.1.1 Avertissements
La méthode arrayToRawValue est une méthode de bas niveau que vous ne devriez
utiliser qu'en dernier recours.
Il faut privilégier l'utilisation de la méthode
setAttributeValue qui prend en charge
automatiquement ces opérations de sérialisation.
13.6.3.4.2 Liste des paramètres
- (array(string))
v - Une liste de chaînes de caractères.
- (string)
br -
brpermet de spécifier la chaîne de caractère utilisée pour substituer le caractère retour à la ligne\ndans les valeurs à sérialiser.Par défaut, la chaîne de caractères de substitution est la chaîne
<BR>.
13.6.3.4.3 Valeur de retour
La méthode arrayToRawValue retourne une chaîne de caractères correspondant à
la sérialisation des valeurs fournies.
13.6.3.4.4 Erreurs / Exceptions
Aucune.
13.6.3.4.5 Historique
13.6.3.4.5.1 Release 3.2.5
La méthode arrayToRawValue remplace la méthode précédemment nommée
_array2val.
L'utilisation de _array2val est obsolète depuis la version 3.2.5 de
dynacase-core.
13.6.3.4.6 Exemples
-
Exemple #1
L'attribut
PHOTO_KEYWORDSest un attribut de type texte multi-valué (option multiple).$motsCles = array( 'Tour Eiffel', 'Champ de Mars', 'Paris', 'France' ); $photo->setValue( \Dcp\AttributeIdentifiers\MyPhoto:photo_keywords, $doc->arrayToRawValue($motCles) );
13.6.3.4.7 Notes
Les valeurs de la liste doivent être des scalaires (string, int, float).