Skip To Content

esri_feature_SetMValue (AutoLISP)

The esri_feature_SetMValue function sets the m-value of the vertex. It can overwrite an existing value.

Syntax

(esri_feature_SetMValue ename mValue)

Arguments

  • ename | AutoCAD entity name | required | The AutoCAD entity name of the 2D or 3D polyline vertex subentity of a feature.
  • mValue | double | required | The new value as a double for the vertex m-value.

Example usage

Set the m-value for the first vertex of the selected feature to 1.96.

(esri_feature_setmvalue (caar (esri_feature_mvalues (car (entsel)))) 1.96)

Result example usage

Set the m-value for the first vertex of the selected feature and return a list of true.

(T)

Return values

The following are the possible return values:

  • If successful, it returns a list of true: (T).
  • If failed, it returns a list with the first value of nil; then, an associated list is returned containing the key value Error and an associated error message as a string: (nil ("Error" . "<message>")).

Failed return values

A failed return value can occur for any of the following reasons:

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

    One or more of the required arguments were not supplied.

  • (nil ("Error" . " Incorrect argument."))

    The provided argument type was unexpected.

See also

esri_feature_MValues—An AutoLISP function that returns an associated list of vertex subentity names and m-values.