Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function
assert_checkfilesequal
Check that two files are equal.
Syntax
flag = assert_checkfilesequal ( filecomp , fileref ) flag = assert_checkfilesequal ( filecomp , fileref , compfun ) [flag,errmsg] = assert_checkfilesequal ( ... )
Parameters
- filecomp :
a 1-by-1 matrix of strings, the computed file.
- fileref :
a 1-by-1 matrix of strings, the reference file.
- compfun :
a function or a list, the comparison function (default compfun = []). If no comparison function is used, the equality operator "==" is used. See below for details.
- flag :
a 1-by-1 matrix of boolean, %t if computed is close to expected, %f if not
- errmsg :
a 1-by-1 matrix of strings, the error message. If flag==%t, then errormsg=="". If flag==%f, then errmsg contains the error message.
Description
Performs silently if the files are equal. Generates an error if filecomp or fileref do not exist. Generates an error if the content of the files are not equal.
If the files are not equal,
if the errmsg output variable is not used, an error is generated,
if the errmsg output variable is used, no error is generated.
If the comparison function compfun is a function, it should have header areequal = compfun ( txtcomp , txtref ) where txtcomp is the content of the computed file, txtref is the content of the reference file and areequal is a boolean. The areequal boolean is true if the two contents are equal. If compfun is a list, it should be list (cf,a1,a2,...), where cf is a comparison function, and the arguments a1, a2, will be automatically be appended as parameters when calling cf.
Examples
// // Prepare data for the tests // fileref1 : three lines of text. // filecomp1 : == fileref1 // filecomp2 : <> fileref1 fileref1 = fullfile(TMPDIR,"fileref.txt"); txt1 = [ "Line #1" "Line #2" "Line #3" ]; fd = mopen(fileref1,"w"); mputl(txt1,fd); mclose(fd); filecomp1 = fullfile(TMPDIR,"filecomp1.txt"); fd = mopen(filecomp1,"w"); mputl(txt1,fd); mclose(fd); filecomp2 = fullfile(TMPDIR,"filecomp2.txt"); txt2 = [ "Line #1" "Line #4" "Line #3" ]; fd = mopen(filecomp2,"w"); mputl(txt2,fd); mclose(fd); // A test which pass flag = assert_checkfilesequal ( filecomp1 , fileref1 ) [flag,errmsg] = assert_checkfilesequal ( filecomp1 , fileref1 ) // Failure: filecomp2 <> fileref1 // Error generated flag = assert_checkfilesequal ( filecomp2 , fileref1 ) // No error generated [flag,errmsg] = assert_checkfilesequal ( filecomp2 , fileref1 ) // Prepare data for the tests // fileref2 == filecomp3, given that comment lines are ignored. // fileref2 <> filecomp4, given that comment lines are ignored. // Notice that the comments are inserted at different positions in the files: // sometimes at the beginning, sometimes in the middle. fileref2 = fullfile(TMPDIR,"fileref2.txt"); txt = [ "// bla 2" "Line #1" "// bla 2" "Line #2" "Line #3" ]; fd = mopen(fileref2,"w"); mputl(txt,fd); mclose(fd); filecomp3 = fullfile(TMPDIR,"filecomp3.txt"); txt = [ "Line #1" "// bla 5168" "Line #2" "Line #3" "// bla oups" ]; fd = mopen(filecomp3,"w"); mputl(txt,fd); mclose(fd); filecomp4 = fullfile(TMPDIR,"filecomp4.txt"); txt = [ "// bla 3" "Line #1" "Line #4" "// bla 5168" "Line #3" "// bla oups" ]; fd = mopen(filecomp4,"w"); mputl(txt,fd); mclose(fd); // A test with a comparison function which ignores comment lines. function otxt=myfilter(itxt) nr = size(itxt,"r") // This is the pattern for a comment line of the form "// blabla" pattern = "/\/\/.*/" k = 1 for i = 1 : nr start = regexp(itxt(i),pattern) if ( start == [] ) then otxt(k) = itxt(i) k = k + 1 end end endfunction function areequal=mycompfun(ctxt, etxt) ctxt = myfilter ( ctxt ) etxt = myfilter ( etxt ) areequal = ( ctxt == etxt ) endfunction // // A test which pass [flag,errmsg] = assert_checkfilesequal ( filecomp3 , fileref2 , mycompfun ) // A test which fails [flag,errmsg] = assert_checkfilesequal ( filecomp4 , fileref2 , mycompfun )
History
| Version | Description |
| 5.4.0 | Function introduced |
| Report an issue | ||
| << assert_checkfalse | Assert | assert_checktrue >> |