labelizepattern(
labelizepattern(
LABEL
,
VALUE
,
PATTERN
)

The labelizepattern( function formats a text value using a label and a pattern.

Parameters

This function has three parameters:

label – is a label identifying the value.

value – is the value to be formatted.

pattern – is the pattern that will be used. If this parameter is omitted, a default pattern will be used (see below).

Description

This function formats a text value using a label and a pattern. It is used internally to create functions like labelizeformula( and labelizeinfo(, but can also be used independently. In its simplest form, this function takes a label and a value, and combines them using a default pattern.

    labelizepattern("Sum",2+2) ☞ Sum: 4
    labelizepattern("Database",info("databasename")) ☞ Database: Contacts
    labelizepattern("NAME",upper(Name) ☞ NAME: BOB WILSON

If the value contains more than one line, a different default pattern is used. Suppose you have a field named Full Address that contains an entire address. In that situation, the formula:

    labelizepattern("OPEN DATABASES",info("files"))

will return a result like this:

    === OPEN DATABASES ============
    Contacts
    Orders
    Products
    === END OF OPEN DATABASES ============

### Custom Patterns

If the standard pattern doesn’t meet your needs, you can add a third parameter to supply your own custom pattern. This pattern must contain `«label»` where you want the label to appear, and `«value»` where you want the value to appear. Here’s an example where using a custom pattern reveals that the city name has an extra space on the end.

    labelizepattern("City",upper(City),"«label» >>>«value»<<<") ☞ City >>>FRESNO <<<

This is such a common situation that there is a special shortcut pattern set up for this situation, `><`.

    labelizepattern("City",upper(City),"><") ☞ City -->FRESNO <--

Note: The default patterns built into the labelizepattern( function are:

    "«label»: «value»"

and

    "=== «label» ============"+cr()+"«value»"+cr()+"=== END OF «label» ============"

for multi-line values.

See Also

- Client/Server Debug Instrumentation -- using instrumentation with Panorama X server and clients.
- Coding with Debug Instrumentation -- modifying your code to generate debug instrumentation output.
- Crash Proof Debug Instrumentation Monitoring -- real time crash-proof instrumentation monitoring
- Customizing Debug Instrumentation Coverage -- specifying what code is being debugged at the moment.
- Debug Instrumentation -- conditional logging of the internal state of Panorama program code.
- Debug Instrumentation Log Window -- dynamically monitor debug instrumentation output as your program runs.
- Debug Instrumentation Monitoring using an External Program -- monitoring debug instrumentation with an external program (Terminal.app, BBEdit.app).
- Debug Instrumentation Text File -- configuring and accessing the debug instrumentation log (text) file.
- info("runningunderterminal") -- returns the name of the terminal program if Panorama was launched under one, otherwise it returns empty text.
- labelize( -- returns the value of a field or variable along with a label. This saves typing when you need to display fields or variables when logging and debugging.
- labelizeformula( -- returns the value of a formula along with the formula itself as a label.
- labelizeinfo( -- returns the value of an info( function, along with the function itself as a label.
- Recording Code Triggers in Debug Instrumentation -- the code triggers option automatically tracks whenever any code is triggered, whether from a menu, a button, or implicitly (for example when data is entered).
- Recording Control Flow in Debug Instrumentation -- configure debug instrumentation to automatically log when control flow is non-linear, for example a call, return, goto, etc.
- setzlog -- turns instrumentation coverage on or off for a specific procedure (or all procedures within a database).
- zlog -- outputs a message to the instrumentation log (if instrumentation is enabled).
- zlogalways -- unconditionally outputs a message to the instrumentation log.
- zlogcoverage -- allows instrumentation coverage to be turned on or off within a procedure.
- zlogdictionary -- outputs a data dictionary to the instrumentation log (if instrumentation is enabled).
- zlogging( -- returns true if zlogging is enabled for the current database and procedure, otherwise false.

History

Version | Status | Notes
10.2 | New | New in this version.