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
-
br
permet de spécifier la chaîne de caractère utilisée pour substituer le caractère retour à la ligne\n
dans 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_KEYWORDS
est 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).