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).

13.6.3.4.8 Voir aussi

×
nouveauté