applyFilter
Syntax
Description
newr = applyFilter(
applies the coverage filters r
,f
)f
to the code coverage results
r. The method returns the new coverage results as a matlab.coverage.Result
vector.
Input Arguments
r
— Code coverage results
matlab.coverage.Result
vector
Code coverage results, specified as a matlab.coverage.Result
vector.
f
— Coverage filters to apply
matlabtest.coverage.Justification
array
Coverage filters to apply to the code coverage results, specified as a matlabtest.coverage.Justification
array.
Examples
Update Coverage Results Using Justifications
Create a justification to filter a block of code that must be covered by a method other than automated testing, for instance, by interactive testing. Then, use the justification to create new coverage results.
First, open this example to access the required files.
openExample("matlabtest/UpdateCoverageResultsUsingJustificationsExample")
When you open the example, these files appear in your current folder:
logToFile
function — This function appends a string to a file. The function throws a system-dependent error if it cannot open the file.LoggingTest
test class — This test class contains a test to verify that thelogToFile
function adds the expected string to a specified file. However, the test class does not test thelogToFile
function in the case of system-dependent errors because there is a plan to test the errors interactively.collectCoverage
script — This script provides programmatic access to the statement, function, and decision coverage information for the source code in the filelogToFile.m
and generates an interactive HTML code coverage report from the produced coverage result.
Run the collectCoverage
script to collect code coverage information and produce an interactive code coverage report. Because the test does not achieve a decision outcome in the source code, the code coverage report includes a missed statement and a missed decision outcome.
collectCoverage
Running LoggingTest . Done LoggingTest __________
result = Result with properties: Filename: "C:\work\logToFile.m" CreationDate: 18-Jul-2024 16:10:59 Filter: [0×0 matlabtest.coverage.Justification] Coverage summary (HTML report): Function: 1/1 (100%) Statement: 5/6 (83.33%) Decision: 1/2 (50%) Use coverageSummary to retrieve information from the coverage results.
Justify the missing code coverage by following these steps:
With
Decision
selected from the Currently viewing list on the code coverage report, click theif fileID < 0
branching statement in the Source Details section.In the dialog box that appears, enter a reason for the justification, and then click OK.
Using your system file browser, save the justification to a MAT file named
myFilter.mat
in your current folder. The testing framework saves the justification as amatlabtest.coverage.Justification
object assigned to a variable namedFilters
inmyFilter.mat
.
After creating the Justification
object, you can use the applyFilter
and resetFilter
methods to create new coverage results. For example, this code creates a coverage result that incorporates the justified outcomes and then generates an interactive code coverage report from the new result.
S = load("myFilter.mat");
result1 = result.applyFilter(S.Filters)
generateHTMLReport(result1)
This code creates another coverage result by removing the justification applied to result1
.
result2 = result1.resetFilter
Version History
Introduced in R2024b
Commande MATLAB
Vous avez cliqué sur un lien qui correspond à cette commande MATLAB :
Pour exécuter la commande, saisissez-la dans la fenêtre de commande de MATLAB. Les navigateurs web ne supportent pas les commandes MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)