Objects.Names Property (FPScript)

21.09.2021

Read access to the names of the objects in a folder.

Syntax

Folder.Objects[(Select)].Names

The syntax of the Objects.Names property consists of the following elements:

Element

Description

Folder

The folder being accessed.

Select

Optional. A string with a regular expression or a data series including strings with several regular expressions that determine the object names to be found.

The string is interpreted as a regular expression if it contains at least one of the following characters: '^', '$', '*', '+', '?', '{' or '}'. All objects are found whose name plus extension matches the regular expression specified. In regular expressions, special characters and sequences are used to represent a search pattern. The following table describes these characters and sequences and provides some examples.

Character

Description

^

Finds the beginning of the string.

$

Finds the end of the string.

*

Never finds the preceding character or finds it several times. For example, "zo*" finds "z" or "zoo".

+

Finds the preceding character once or several times. For example, "zo+" finds "zo", but not "z".

?

Finds the preceding character zero times or once. For example, "b?ig?" finds "ig" in "signal".

.

Finds every single character.

x|y

Finds either x or y. For example, "z|wood" finds "z" or "wood". "(z|w)oo" finds "zoo" or "wood".

{n}

n is a non-negative integer. Finds exactly n times. For example, "o{2}" does not find the "o" in "Bob", but it does find the first two o’s in "foooood".

{n,}

n is a non-negative integer. Finds at least n times. For example, "o{2,}" does not find the "o" in "Bob", but finds all o’s in "foooood." "o{1,}" is equivalent to "o+". "o{0,}" is equivalent to "o*".

{n,m}

m and n are non-negative integers. Finds at least n and at most m times. For example, "o{1,3}" finds the first three o’s in "fooooood." "o{0,1}" is equivalent to "o?".

[xyz]

A group of characters. Finds every one of the characters included. For example, "[abc]" finds the "a" in "signal".

[^xyz]

A group of excluded characters. Finds every character not included. For example, "[^abc]" finds the "s" in "signal".

[a-z]

A range of characters. Finds every character in the range. For example, "[a-z]" finds every alphabetical character from "a" to "z".

[^m-z]

A range of excluded characters. Finds every character not in this range. For example, "[m-z]" finds every character that does not lie between "m" and "z".

\b

Finds a word limit, i.e. the position between a word and a space character. For example, "al\b" finds the "al" in "signal", but not the "al" in "signals".

\B

Finds a non-word limit. "ea*r\B" finds "ear" in "never early".

\d

Finds a number. Equivalent to [0-9].

\D

Finds a non-numeric character. Equivalent to [^0-9].

\s

Finds a space character. Equivalent to "[ ]".

\S

Finds everything but space characters. Equivalent to "[^ ]".

\w

Finds every word character including underline. Equivalent to "[A-Za-z0-9_]".

\W

Finds every character that does not belong to a word. Equivalent to "[^A-Za-z0-9_]".

In a regular expression, the various object types are differentiated using their name extensions. In this case, name extensions are also used for formulas, data sets, analysis objects and data link objects. The following table shows the valid name extensions:

Object

File name extension

2D Diagram

.2D

3D Diagram

.3D

Analysis Object Derivation/Integral

.SAN

ANOVA Analysis Object

.ANV

Goodness-of-Fit Test Analysis Object

.ADJ

2D-Approximation Analysis Object

.AP2

Approximation Analysis Object

.APX

Outlier Correction Analysis Object

.RFR

Outlier Test Analysis Object

.FRT

Acceleration Hyperbola Family Analysis Object

.AHP

Cepstrum Analysis Object

.CEP

CFC Filter Analysis Object

.CFC

Speed Synchronous Order Tracking Analysis Object

.SOA

Speed Synchronous Order Filter Analysis Object

.SOF

Envelope Analysis Object

.ENV

Event Isolation Analysis Object

.EVI

Excel Workbook Analysis Object

.XLD

Convolution Analysis Object

.CNV

FFT Analysis Object

.FFT

FIR Filter Analysis Object (Equiripple Method)

.FI3

FIR Filter Analysis Object (Window Method)

.FI2

Fourier Spectrum Analysis Object

.FSP

Uneven Data Fourier Spectral Analysis Object

.UFS

Human Body Vibration Analysis Object

.HBV

Split Order Analysis Object

.SOR

Hand-Transmitted Vibration Analysis Object

.HTV

Harmonic Estimation Analysis Object

.HSP

Histogram Analysis Object

.HST

High-performance Frequency Estimation Analysis Object

.HFE

IFFT Analysis Object

.IFT

IIR Filter Analysis Object

.FI1

Count Analysis Object

.CNT

Count Matrix Analysis Object

.CMX

Correlation Analysis Object

.CCF

Circle Approximation Analysis Object

.CAP

Cross Spectrum Analysis Object

.CSP

Curve Transformation Analysis Object

.CVT

Loudness Analysis Object

.LDS

Linear Interpolation Analysis Object

.LPL

Instantaneous Quantities Analysis Object

.INQ

Non-linear Curve Fit Analysis Object

.NLF

Surface Interpolation Analysis Object

.SP2

Octave Analysis Object

.OCT

Order Tracking Analysis Object

.ODA

Parametric Spline Interpolation Analysis Object

.PSP

Rainflow Count Analysis Object

.RFC

Regression Analysis Object

.RGS

Rosette Transformation Analysis Object

.ROT

Sound Power Analysis Object

.SPW

Sound Level Analysis Object

.SVL

Sharpness Analysis Object

.SHS

Signal Analysis Object

.SIG

Signal Sampling Analysis Object

.SIS

Signal Filter Analysis Object

.IIR

Signal Smoothing Analysis Object

.SMT

Signal Correction Analysis Object

.CLN

Signal Scaling Analysis Object

.SCL

Spline Interpolation Analysis Object

.SPL

Statistical Quantity Analysis Object

.STQ

Shock Response Spectrum Analysis Object

.SRS

Variance Test Analysis Object

.VRT

Compound Count Analysis Object

.CCN

Distribution Analysis Object

.DIS

Confidence Interval Analysis Object

.CIV

Time-Frequency Spectrum Analysis Object

.TFS

Worksheet

.WKS

Control panel

.CPN

Binary Data Link

.BIN

Data Query

.DQY

Data Set

.DAT

ASAM ODS Data Link

.ODS

Data Link, Astro-Med Dash 18 Data

.DCR

Data Link, B+S ME 3 Data

.BUS

Data Link, BMCSAD Data

.BMC

Data Link, File Data

.FIP

Data Link, Gould Oscilloscope Data

.GSC

Data Link, Imtec INSIGHT Data

.IST

Data Link, IMTEC PC-Scope Data

.PCS

Data Link, IOtech Data

.IOT

Data Link, LeCroy Waveform Data

.LCS

Data Link, The MathWorks MATLAB Data

.MAT

Data Link, Meyer and Heinen EDAS Data

.EDS

Data Link, NASA CDF Data

.CDF

Data Link, NI DASYLab Data

.DST

Data Link, NI DIAdem Data

.DAG

Data Link, Nicolet TEAM Data

.TEM

Data Link, Nicolet WFT Data

.WFT

Data Link, ODBC Data

.ODC

Data Link, OROS Wave Data

.OWV

Data Link, SEFRAM Recorder Data

.SF1

Data Link, SPSS Data

.SPS

Data Link, Stemmer TurboLab Data

.TBL

Data Link, SYSTAT Data

.STT

Data Link, TEAC TAFFmat Data

.TFM

Data Link, Tektronix DPO Data

.DPO

Data Link, Tektronix TDS Data

.TDS

Data Link, Wave Data

.WVE

Data Link, Yokogawa ORM/ORP Data

.ORP

Data Link, Ziegler Signalys Data

.SGL

Document

.DOC

Excel File Data Link

.EXC

Excel Data Link

.XDL

Formula

.FML

Media

.MED

OLE Data Link

.OLE

Folder

.FLD

Column table / Row table

.TAB

Text

.TXT

Text Data Link (obsolete)

.ASC

Text Data Link

.TEX

Cell Table

.TTB

Available in

FlexPro Basic, Professional, Developer Suite

Examples

\Measurement1\.Objects("^sig.*\\.dat$").Names

Finds all data set objects in the folder "\Measurement1" with names beginning with "sig".

The regular expression is structured as follows:

Sequence

Meaning

"^sig"

Specifies that the object name must start with "sig".

".*"

Represents a string of any length, consisting of any characters.

"\.dat$"

Specifies that the object name must end in ".dat", i.e. that the object must be a data set.

.\.Objects({".*\\.dat", ".*\\.fml"}).Names

Finds all formulas and data sets in the folder containing the actual formula.

\.Objects.Names

Lists all objects in the root folder of the project database.

Dim List, Result, Path, i

List = Measurement1\.Objects.Names

Path = Measurement1\.FullName : "\\"

For Each Row i in List Do

    Result = Result : Mean($Path : List$)

End

Calculates the mean values for all objects in the subfolder "Measurement1", assuming that this folder contains only data objects.

Share article or send as email:

You might be interested in these articles