esri_attributes_get (AutoLISP)

La fonction esri_attributes_get extrait une liste associée des noms de champs et de leurs valeurs attributaires.

Voici les notes d’utilisation :

• Si uniquement le nom de l’entité est spécifié, tous les champs attributaires et leurs valeurs stockés sur l’entité sont renvoyés.
• Si la valeur "FLNAME" est spécifiée, seuls les attributs appartenant à cette couche d’entités, ainsi que les valeurs par défaut, sont inclus.
• Si la valeur "FIELDNAME" est spécifiée, seuls le nom du champ spécifié et ses valeurs sont renvoyés.
• Si les valeurs "FLNAME" et FIELDNAME sont toutes les deux spécifiées, seule la valeur stockée du champ ou sa valeur par défaut est renvoyée dans une liste sous la forme d’une paire pointée, et ce, uniquement si elle appartient à la couche d’entités.

Syntaxe

(esri_attributes_get ename [attribute_settings])

Arguments

• ename | nom d’entité AutoCAD | obligatoire | Nom d’entité AutoCAD de l’objet.

• attribute_settings | liste associée | facultatif | La liste des paramètres facultatifs sous forme de paires pointées pour limiter les champs et renvoyer les valeurs par défaut appropriées est la suivante :

  Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
  "FLNAME"	chaîne	Nom de la couche d’entités. On suppose que l’entité appartient à cette couche d’entités, qu’elle n’inclura que les valeurs de champs de la couche d’entités spécifiée et renverra ses valeurs par défaut.	Facultatif
  "FIELDNAME"	chaîne	Nom d’un champ unique pour limiter la valeur renvoyée à ce seul champ. Si la valeur FLNAME est également indiquée, la valeur FIELDNAME doit exister dans la définition de cette classe d’entités.	Facultatif

Exemple d’utilisation 1

Essayer d’obtenir tous les attributs de la couche d’entités Centerlines pour l’entité sélectionnée.

(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines")))

Exemple d’utilisation du résultat 1

Renvoyer tous les attributs de la couche d’entités Centerlines pour l’entité sélectionnée en tant que liste associée :

(("EntityHandle" . "252") ("EntityType" . "LWPOLYLINE") ("StreetName" . "S Roosevelt Blvd") ("Pavement" . 6) ("Rating" . 0.6259))

Exemple d’utilisation 2

Essayer d’obtenir la valeur du champ StreetName de la couche d’entités Centerlines pour l’entité sélectionnée.

(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines") (cons "FIELDNAME" "StreetName")))

Exemple d’utilisation du résultat 2

Renvoyer la valeur du champ StreetName pour l’entité sélectionnée en tant que liste associée :

(("StreetName" . "White Street"))

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste associée de noms de champs et de valeurs sous forme de paires pointées.
• 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" . "No attributes found on entity."))

  L’entité ne comporte aucune des valeurs de champ spécifiées.

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

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

• (nil ("Error" . "Invalid associated list"))

  Le paramètre attribute_settings avait une structure incorrecte ou contenait des valeurs non valides.

• (nil ("Error" . "No fields found."))

  Un nom de champ incorrect a été fourni.

Voir aussi

esri_featurelayer_getattributes : fonction qui renvoie une liste des listes associées de tous les attributs pour toutes les entités de la couche d’entités spécifiée dans le dessin.