b = fileconcat(『dictionary_name,』 output_file_name, file_name1『, ..., file_nameN』);
- Concatenate cases: Reads cases from each input file and writes them to the output file, skipping invalid and duplicate cases. This mode requires a data dictionary that describes the format of the input and output data files so that cases may be validated and duplicates may be identified. Concatenate cases mode may be used with data files in either text or CSPro DB format.
- Concatenate file contents: Simply appends one file to the end of another regardless of the file contents. This mode will not work for data files in the newer CSPro DB format.
To peform a case concatenation, you must specify a dictionary_name that specifies the layout of the data files being concatenated. When the dictionary is specified, the files are combined by reading each case from each of the input files and writing them to the output file. In this mode, invalid cases and duplicate cases are automatically removed from the output file.
To perform content concatenation, do not specify a dictionary. In this case, the input files are appended together without examining their contents. This will be faster but will not eliminate duplicates or invalid cases.
is a string expression giving the name of the output file that will contain the concatenated data. The arguments file_name1
are either string expressions or string lists
that contain the names of specific files or a wildcard specification of a group of files.
The function returns a logical value of 1 (true) if successful and 0 (false) otherwise.
fileconcat("DMV.txt", "District of Columbia.txt", "Maryland.txt", "Virginia.txt");
fileconcat(CENSUS_DICT, "14combined.csdb", "../Data/14*.csdb");