Syntax

   @Length([REJECTABLE][,<dimension>[, <multiplier>]])
   @Length([REJECTABLE], TO_POINT, <dimension>, <point x>, <point y> [, <point z>])
   @Length([REJECTABLE], ALL_LENGTHS[, <dimension>[, <multiplier>]])
   @Length([REJECTABLE], ALL_LENGTHS_AS_MEASURES[,<dimension>[,<multiplier>[,<measure_name>,
     [<start value>]]]])

Arguments

   REJECTABLE

      Rejects features if this keyword is specified.

      Range: N/A

   <dimension> 
   
      Specifies whether the 3rd dimension is used in the length calculation. The 
      default is 2, meaning only the x and y coordinates are used in the 
      calculation. If 3 is specified and the feature has only 2 dimensions, no 
      error will be flagged and the length will be calculated on the 2 available 
      dimensions.

      If the first argument is TO_POINT then this argument is required.

      Range: 2|3  
      
   <multiplier>   
   
      By default, the length returned is in ground units. The multiplier, if 
      specified, can be used to convert to other units. The default is 1.

      Range: Real Number   
      
   <point x>   
   
      The x coordinate for the vertex upto which the length is to be calculated. 
      Used if the first argument is TO_POINT.

      Range: Real Number   
      
   <point y>   
   
      The y coordinate for the vertex upto which the length is to be calculated. 
      Used if the first argument is TO_POINT.

      Range: Real Number   
      
   <point z>   
   
      The z coordinate for the vertex upto which the length is to be calculated. 
      Used if the first argument is TO_POINT.

      Range: Real Number   
      
   <measure name> 
   
      Specifies the name of the measure to set. If left blank or omitted, the 
      default measure will be set.

      Range: String  
      
Description

   The @Length function calculates the length of features. For polygonal 
   features, the length is equal to the sum of its perimeter and the perimeter 
   of any holes within it. The optional multiplier is used to convert the 
   returned value from ground units to units more useful to the caller.

   If the first argument is TO_POINT then the function will calculate the length 
   of feature up to the vertex specified by <point x>, <point y> [, <point z>]. 
   The value returned is the length of the line up until the closest spot on the 
   feature to the point that was passed in.  For example, if there is a line 
   that goes from (0,0) to (0,100) and passes in a point (50,50), the closest 
   spot on the line would be (0,50), and the value returned would be the length 
   from (0,0) to (0,50) which is 50. Depending on the <dimension> argument, 
   either a 2D or 3D length will be calculated.

   If the first argument is ALL_LENGTHS then the function will return a comma-
   separated list of values, where each value is the distance from the start of 
   the feature up to that vertex in the feature. 

   For example, a feature has 4 points: A,B,C and D. 

   AB, BC and CD are the distance between two consecutive vertices:
   
           1          2                   3
      +-------+---------------+-----------------------+
      A       B               C                       D
    
   If AB = 1, BC = 2, and CD = 3 then the value returned by the function will be 
   0,1,3,6.

   If the first argument is ALL_LENGTHS_AS_MEASURES then the function will 
   calculate values as with the ALL_LENGTHS option, but these will be set as a 
   measure on the geometry itself. The name of the new measure can be given by 
   the <measure name> parameter; the default measure will be set if this is 
   blank or omitted.  A starting offset may be added with the <start value>
   parameter; if no value is given, no offset will be applied.