esri_attributes_get (AutoLISP)

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

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 | Liste des paramètres facultatifs sous forme de paires pointées pour limiter les champs et renvoyer les valeurs par défaut appropriées.

  Etiquette associée	Type de valeur	Description de la valeur	Requis/facultatif
  "FLNAME"	chaîne	Nom de la couche d’entités. Suppose que l’entité appartient à cette couche d’entités et 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 spécifié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

Renvoie 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 Steetname de n’importe quelle couche d’entités 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

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

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

Valeurs renvoyées

Cette fonction renvoie une valeur.

• En cas de réussite, renvoie une liste associée de noms de champs et de valeurs sous forme de paires pointées.
• En cas d’échec, renvoie une liste avec la première valeur nil, puis une liste associée contenant la valeur principaleError 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" . "Invalid associated list"))

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

• (nil ("Error" . "Optional field value not found on entity."))

  L’entité ne comporte pas la valeur de champ spécifiée.

Voir aussi

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