Main Content

discardChanges

Discard changes in Git repository

Since R2024a

collapse all in page

    Syntax

    discardChanges(repo,files)

    Description

    discardChanges(repo,files) discards changes in the specified files or folders files in the Git™ repository repo.

    example

    Examples

    collapse all

    Navigate to your repository folder and create a repository object.

    repo = gitrepo;

    Discard all changes in the repository.

    discardChanges(repo,repo.ModifiedFiles);

    Open the Times Table App project repository and create a repository object.

    openExample("matlab/TimesTableProjectExample")
repo = gitrepo;

    Delete a file from disk.

    file = fullfile(pwd,"requirements","TimesTableRequirements.mlx");
delete(file);

    Deleting a file from disk does not remove it from source control. Display the status of the repository using the status function. The file status is Missing.

    repoStatus = status(repo)

    repoStatus =

  2×1 table

                                                                                                        Status        
                                                                                                       _____________________
      
    C:\Workspace\TimesTableProjectExample\TimesTableApp\requirements\TimesTableRequirements.mlx         Missing              
    C:\Workspace\TimesTableProjectExample\TimesTableProjectExample.m                                    NotUnderSourceControl

    Restore the missing file by reverting the local deletion.

    discardChanges(repo,file);

    Input Arguments

    collapse all

    Git repository, specified as a matlab.git.GitRepository object.

    Files or folders to restore, specified as a string array, character vector, or cell array of character vectors. If you specify a folder, the function recursively discards changes to all modified files.

    Example: "modifiedFile.m", "my_folder_hierarchy"

    Data Types: char | string | cell

    Version History

    Introduced in R2024a

    See Also

    | |

    Topics