DiffApply [diffobj,expr]
returns the result of applying the given DiffObject to the expression expr.
DiffApply
DiffApply [diffobj,expr]
returns the result of applying the given DiffObject to the expression expr.
Details and Options
- DiffApply can transform the following types of expressions:
-
lists {…} returns differences between two liststext "text", File ["fname.txt"] returns differences in individual characters, words or lines between two blocks of textbiomolecular sequences BioSequence […] returns differences in letter strings between two biomolecular sequencesnotebooks 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 […,OverwriteTarget True ] 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 all close allBasic Examples (2)
Apply diffs to a list:
Apply diffs to a string:
Scope (2)
Apply two different changes to a common ancestor:
Apply changes one word at a time:
Applications (1)
Reconstruct an edited file by applying a DiffObject to the original file:
Possible 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:
See Also
History
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
BibTeX
@misc{reference.wolfram_2025_diffapply, author="Wolfram Research", title="{DiffApply}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/DiffApply.html}", note=[Accessed: 15-January-2026]}
BibLaTeX
@online{reference.wolfram_2025_diffapply, organization={Wolfram Research}, title={DiffApply}, year={2024}, url={https://reference.wolfram.com/language/ref/DiffApply.html}, note=[Accessed: 15-January-2026]}