Skip To Content

esri_docfeaturelayer_rename (AutoLISP)

Syntax

(esri_docfeaturelayer_rename flname new_flname)

Arguments

  • flname | string | required | A valid document feature layer name in the drawing.
  • new_flname | string | required | The new document feature layer name.

Example usage

Attempt to rename the Streets document feature layer to Roads:

(esri_docfeaturelayer_rename "Streets" "Roads")

Result example usage

Renames the Streets document feature layer to Roads and returns a list with the new document feature layer name:

("Roads")

Return values

  • If successful, returns a list containing the new document feature layer name.
  • If failed, returns a list with the first value of nil and then an associated list 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" . "Feature layer not found."))

    The specified document feature layer was not found within the drawing.

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

    One of the required arguments was not supplied.

See Also

(esri_docfeaturelayer_copy) | Copies a document feature layer definition.