esri_fielddef_get (AutoLISP)

Cette fonction obtient les propriétés de champ d’une couche d’entités sous forme d’une liste associée.

Syntaxe

(esri_fielddef_get flname field [subtype])

Arguments

• flname | chaîne | obligatoire | Nom de couche d’entités existant dans le dessin.
• field | chaîne | obligatoire | Nom du champ.
• subtype |Chaîne | facultatif | Le nom du sous-type est requis pour obtenir les définitions de champ appropriées pour le sous-type cible, qui peuvent être différentes de celles de la couche d’entités parent.

Exemple d’utilisation

Essayer d’obtenir les propriétés de champ pour le champ PoleType du sous-type steel de la couche d’entités UtilityPoles.

(esri_fielddef_get "UtilityPoles" "PoleType" "steel")

Exemple d’utilisation du résultat

Renvoie les propriétés de champ pour le champ PoleType du sous-type steel de la couche d’entités UtilityPoles sous forme de liste associée.

(("NAME" . "PoleType") ("TYPE" . "Short") ("READONLY" . 0) ("LENGTH" . -1) ("VALUE" . 0) ("DOMAIN" . "UtilityPoles_TypeDomain"))

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, renvoie les propriétés de champ sous forme de liste associée de paires pointées définies comme suit :
  • "NAME"| chaîne | Renvoie le nom de champ.
  • "TYPE" | chaîne | Renvoie la valeur du type de champ {"Double", "Integer", "Short", "String"}.
  • "READONLY" | chaîne | indique si le champ est en lecture seule {1= yes, 0 = no}.
  • "LENGTH" | Entier | Renvoie la longueur du champ.
  • "VALUE" | Variante | Renvoie la valeur par défaut de la définition de champ. Si le champ présente un domaine de valeurs précodées, il s’agit de la valeur d’index et non de la valeur descriptive.
  • "DOMAIN" | chaîne | Nom de la définition de domaine pour le champ.
• En cas d’échec, renvoie une liste avec la première valeur nil, puis une liste associée contenant la valeur principale "Error" et un message d’erreur associé sous forme de chaîne : (nil ( "Error" . "<message>")).

Valeurs d’échec renvoyées

Des valeurs d’échec peuvent être renvoyées dans l’un des cas suivants :

• (nil ("Error" . "Field not found"))

  Le champ spécifié est introuvable dans la couche d’entités spécifiée.

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

  La valeur de la couche d’entités spécifiée n’est pas une couche d’entités valide dans le dessin.

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

  L’argument requis n’a pas été fourni.