OutputFile

Top  Previous  Next

The OutputFile section determines what you want to name the files output by the filter's modifications. This section is defined as follows:

 

<OutputFile>

 <Name>

         See Values and Description

 </Name>

</OutputFile>

 

Flag

Values and Description

Name

Values: InputFile or Static Input File Name

 

This tag determines the names of the files that you want the filter to output after it has modified the data read from the input file.

 

The value InputFile (this is case sensitive) tells the filter that the file output should mirror the original input file's name. So, for example, if the file read was named example.txt, then the file output would also be called example.txt

 

Alternatively, you can specify a static naming convention for the output files. This value also supports the following variables:

%InputFileName%

%InputFileNameBase%

%InputFileNameExtension%

%InputFilePathAndName%

%InputFilePath%

 

So, for example, you could specify this as the value: c:\PageGateData\ASCII\%InputFileNameBase%.asc

 

That would tell the filter that it should use the original name of the file read but the output file should have the extension .asc instead of the extension on the original file.

 

As an important note, due to the way this script is programmed, certain characters are treated as command characters instead of literal text characters. The following characters represent certain command functions in the script:

Character

Function

~

~ as first character means start of section/file, ~ as last character means end of section/file. For example, ~123~ would only find 123 and not 01234 or 1237, etc. ~123 would find 12340 but would not find 01234. 123~ would find 0123 but would not find 01234.

?

Single character wildcard.

*

Multiple character wildcard.

\

IMPORTANT

ASCII value prefix (Ex: \013 for a carriage return, \010 for a line feed). The \ must be followed by a three digit code to indicate the character to be output.

 

This character is used when you want to represent a character as represented by its ASCII Decimal value. For example, since the filter directly references the character ~ in its function, if you want to use the ~ character in your text, you'll need to represent it with its ascii value. The ascii value of ~ is \126.