DiffApply
DiffApply[diffobj,expr]
returns the result of applying the given DiffObject to the expression expr.
Details and Options
![](Files/DiffApply.en/details_1.png)
- DiffApply can transform the following types of expressions:
-
lists {…} returns differences between two lists text "text", File["fname.txt"] returns differences in individual characters, words or lines between two blocks of text biomolecular sequences BioSequence[…] returns differences in letter strings between two biomolecular sequences cells Cell[…], CellObject[…] returns differences in content, styles and options between two cells notebooks Notebook[…], NotebookObject[…], File["fname.nb"] returns differences in cells and options between two notebooks - diffobj must be a DiffObject that was generated from the same type of expression as expr.
- DiffApply[Diff[old,new],old] returns new, assuming that old and new are supported for diffing.
- If a DiffObject was generated by Diff3, DiffApply will merge all changes into a single result, as long as there are no conflicts.
- When writing the output to a file, existing files are not overwritten by default. Use DiffApply[…,OverwriteTargetTrue] to force an existing file to be overwritten.
- If DiffApply returns a Failure object, the following tags are used:
-
"InvalidDiffObject" diffobj is not a valid DiffObject "DiffObjectContainsConflicts" diffobj contains conflict markers "WrongType" the expression type of diffobj is different from expr "DiffApplyFailure" diffobj contains changes that do not map onto expr "CantOverwriteFile" "file" exists and the OverwriteTarget setting does not allow it to be overwritten
Examples
open allclose allPossible Issues (2)
Applying a DiffObject that includes conflicts will return a Failure object:
A DiffObject can only be applied to the same kind of expression that generated it:
Wolfram Research (2024), DiffApply, Wolfram Language function, https://reference.wolfram.com/language/ref/DiffApply.html.
Text
Wolfram Research (2024), DiffApply, Wolfram Language function, https://reference.wolfram.com/language/ref/DiffApply.html.
CMS
Wolfram Language. 2024. "DiffApply." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/DiffApply.html.
APA
Wolfram Language. (2024). DiffApply. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DiffApply.html