Concatenate Files

Updated on 14 May 2021
1 Minute to read

Print
Dark
Light
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

This is generated from the built in components of BuildMaster 7.0.0, and may be different than what you have installed (especially if you have extensions); go to [User Icon] -> Documentation within your BuildMaster instance to see exactly what operations are available.

Concatenate Files

Concatenates files on a server.

Script usage:

Concatenate-Files(
	File: <text>,
	[Directory: <text>],
	[Include: <@(text)>],
	[Exclude: <@(text)>],
	[Encoding: <text>],
	[Separator: <text>]
);

This operation may be prefixed with Files::, although this is a built-in namespace and isn't really necessary.

Arguments:

Name	Format	Script Usage	Usage Notes
☆ Output file	text	File	This argument is required.
Directory	text	Directory
Include	@(text)	Include	See KB#1119 to learn more about masking syntax.
Exclude	@(text)	Exclude	See KB#1119 to learn more about masking syntax.
Encoding	text	Encoding
Separator	text	Separator

Example:

# concatenates all SQL files in the working directory into a 
# single file, each script separated by a GO statement
Concatenate-Files(
    File: all.sql,
    Include: *.sql,
    Separator: >>
GO
>>
);

Was this article helpful?

What's Next

Create File

Table of contents

Concatenate Files