esri_attributes_uniquevalues (AutoLISP)

La fonction esri_attributes_uniquevalues renvoie une liste de valeurs uniques pour un champ donné.

Syntaxe

(esri_attributes_uniquevalues flname subtype field)

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• subtype | chaîne | obligatoire | Nom de couche d’entités de sous-type existant dans le dessin. Utilisez une chaîne vide "" en l’absence de sous-type.
• field | chaîne | obligatoire | Nom de champ existant dans la couche d’entités.

Exemple d’utilisation

Demander les valeurs uniques du champ SUB_REGION de la couche d’entités USA_States_GENERALIZED (aucun sous-type) :

(esri_attributes_uniquevalues "USA_States_GENERALIZED" "" "SUB_REGION")

Exemple d’utilisation du résultat

Renvoyer une liste simple de valeurs de champ uniques pour le nom de champ SUB_REGION indiqué :

("East North Central" "South Atlantic" "New England" "East South Central" "Middle Atlantic" "Mountain" "West South Central" "West North Central" "Pacific")

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste simple de valeurs de champ uniques du même type que le type de champ spécifié.
• En cas d’échec, elle renvoie une liste avec la première valeur nil, puis une liste associée contenant la valeur de clé "Error" et un message d’erreur associé sous forme de chaîne : (nil ( "Error" . "<message>")).

Valeurs d’échec renvoyées

Un échec peut être dû par exemple aux raisons suivantes :

• (nil ("Error" . "Missing required argument."))

  Un ou plusieurs des arguments requis n’a pas été fourni.

• (nil ("Error" . "Feature layer not found."))

  La couche d’entités spécifiée n’existe pas dans le fichier.