Software Venture Consulting

FileMaker Pro downloads & Resources
FileMaker Custom Functions
FileMaker Web Viewer Examples
FileMaker Pro & Lasso Consulting
Training
FileMaker Books
FileMaker Articles
FileMaker Error Reference

Free Web Tools
Free FileMaker Tools

Personal Pages
Videos
Adventures
Links

Shopping Cart
Shopping Cart

Search:

Free Newsletter
Signup


Contact


Privacy Policy



FileMaker is a registered trademark of FileMaker, Inc. in the U.S. and other countries.

 

 FileMaker Pro Custom Functions

List  |  Show Random  |  Upload  |  Add This to Your Site

DistributeExpression ( Expression ; Variable ; Values ; Separator ; Eval )

Rate this function:  

RatingRatingRatingRatingRating
  Average rating: 4.3  (18 votes)
  Discuss this Custom Function

Travis Preister, Denver, CO
http://www.bitgambit.com

This function will apply a specified expression to any list of values, one at a time.

Sample Input:
DistributeExpression ( "Lower ( x )" ; "x" ; "Apple¶B¶3" ; "¶" ; 1 )
Sample Output:
apple¶b¶3


 Then copy & paste into FileMaker Advanced's Edit Custom Function window.

Click here to copy To Clip Manager if you have myFMbutler's Clip Manager installed

Description:

This function will apply a specified expression to any list of values, one at a time.

Parameters:

1. Expression (text): The calculation we want to apply to each of the Values.
2. Variable (text): A string of characters from inside Expression.
3. Values (text): A list of values (separated by the ¶ character), each of which should be run inside Expression.
4. Separator (text): A string of characters to use between each Expression.
5. Eval (boolean): When true, the output of DistributeExpression is evaluated using FM's built-in Evaluate function.

Notes:

1. Expression, Variable, Values, and Separator are all text, and must be enclosed in quotes.
2. As with all text strings, you must use the backslash character to escape enclosed special characters.
3. The ¶ character and double quotation marks are common examples of special characters in FileMaker.
4. There may be zero, one, or more than one instance of Variable inside Expression.
5. It is often useful to reference a List of related or repeating fields, or an ESQL query, as Values.
6. If you're receiving an error, it's often helpful to examine the output of this function with Eval = 0.

Examples:

DistributeExpression ( "x" ; "x" ; "Apple¶B¶3" ; "¶" ; 0 )
= "Apple" & "¶" & "B" & "¶" & "3"

Evaluate ( DistributeExpression ( "x" ; "x" ; "Apple¶B¶3" ; "¶" ; 0 ) )
= Apple¶B¶3

DistributeExpression ( "x" ; "x" ; "Apple¶B¶3" ; "¶" ; True )
= Apple¶B¶3

DistributeExpression ( "Lower ( x )" ; "x" ; "Apple¶B¶3" ; "¶" ; 1 )
= apple¶b¶3

DistributeExpression ( "Ceiling ( num ) + num" ; "num" ; "0.2¶1¶1.5¶2¶2.1¶3¶3.9¶4" ; ", " ; 1 )
= 1.2, 2, 3.5, 4, 5.1, 6, 7.9, 8

DistributeExpression ( "If ( num >= 3 ; num & \¶ )" ; "num" ; "0.2¶1¶1.5¶2¶2.1¶3¶3.9¶4" ; "" ; 1 )
= 3¶3.9¶4¶

DistributeExpression ( "GetValue ( " & Quote ( "A¶B¶C¶D¶E¶F¶G¶H" ) & " ; x )" ; "x" ; "3¶5¶7" ; "¶" ; 1 )
= C¶E¶G

DistributeExpression ( "Func & \" ( Pi )\"" ; "Func" ; "Floor¶Abs¶Evaluate¶Ceiling¶Cos" ; " & \¶ & " ; 1 )
= Floor ( Pi ) & ¶ & Abs ( Pi ) & ¶ & Evaluate ( Pi ) & ¶ & Ceiling ( Pi ) & ¶ & Cos ( Pi )

Evaluate ( DistributeExpression ( "x & \" ( Pi )\"" ; "x" ; "Floor¶Abs¶Evaluate¶Ceiling¶Cos" ; " & \¶ & " ; 1 ) )
= 3¶3.1415926535897932¶3.1415926535897932¶4¶-1

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

This is my Custom Function and I want to edit it

Discuss:

There are no comments yet. Be the first to post a comment about this Custom Function! Please try to keep it brief & to the point. Anyone can post:

Your Name:
City/Location:
Comment:
characters left. If you paste in more than 1500 characters, it will be truncated. Discuss the function - advertisements and other useless posts will be deleted.
Answer 7 + 5 =
Search for Custom Functions:

Custom Functions Widget
Download the Custom Function Dashboard Widget for OS X
Keep all the latest Custom Functions right at your fingertips!

Newest Custom Functions:

1. decFromHex ( hexValue )
  (Mon, Oct 16, 12:34pm)
2. MonthYearList ( startmonth ; startyear ; numbermonth ; short )
  (Mon, Oct 16, 3:38am)
3. ErrorDescription ( errorNumber )
  (Wed, Sep 27, 2:51am)
4. decodeEntities (text)
  (Wed, Sep 27, 1:22am)
5. HexidecimalToNumber ( HexidecimalValue ; counter )
  (Mon, Sep 25, 12:39pm)
6. FixedFieldConverter ( Fieldname ; f1 ; f2 ; f3 ; f4 ; f5 ; f6 ; f7 ; f8 ; f9 ; f10 ; f11 ; f12 ; f13 ; f14 ; f15 ; f16 ; f17 ; f18 ; f1
  (Fri, Sep 15, 12:34pm)
7. ShannonEntropy ( text )
  (Thu, Sep 07, 5:59am)
8. LetterCount ( text ; summary )
  (Thu, Sep 07, 5:53am)

RSS Feed of Custom Functions