Home > Support > NI Product Manuals > LabVIEW Communications System Design Suite 1.0 Manual

Scans text in a file for data that matches a specified format, returning these matches as a specified data type.

connector_pane_image
datatype_icon

format string

A string that includes a format specifier for each output along with any additional text that you know appears in the input string but that you do not want to appear in an output. A format specifier is a series of characters, initiated by a %, that indicates how to convert a series of characters into an output.

Each format specifier uses the following general syntax:

% width specifier

This input accepts a maximum of 255 characters.

Specifiers

Syntax for Matching Literal Text That You Do Not Want To Output

Default: Empty string — Causes this node to scan the text according to the default behavior for the data types of the wired outputs.

datatype_icon

input file

The file that this node uses.

This input can be a reference to a file or an absolute file path. In both cases, this node opens the specified file without requiring you to call Open/Create/Replace File first.

If you specify an empty path, a relative path, or a path to a non-existent file, this node returns an error.

Default: No value — Displays a file dialog box that prompts you to select a file.

datatype_icon

error in

Error conditions that occur before this node runs. The node responds to this input according to standard error behavior.

Default: no error

datatype_icon

default value

Default data type and default value for the corresponding output parameter. The node uses this information only if you do not wire a string constant to format string. If you do wire a string constant to format string, the node uses the format specifiers in that constant to determine the data type of each output.

Each default value can be a string, path, Boolean, enumerated type, timestamp, or numeric value. You cannot use arrays and clusters with this node.

Implications of Using an Enumerated Type

Default: 0, double-precision floating point or empty string, string, depending on the output data type defined by format string

datatype_icon

file out

Refnum of the file that the node read.

datatype_icon

error out

Error information. The node produces this output according to standard error behavior.

datatype_icon

output

Output data obtained from a single format specifier in format string.

The data type of this parameter matches the data type specified by the corresponding format specifier in format string or the corresponding default value. Possible data types include strings, paths, enumerated types, timestamps, and numerics, but not arrays and clusters. If you scan a string that does not fit into the numeric representation you specify, this node returns the largest number that fits into that representation.