Main Content

discardChanges

Discard changes in Git repository

Since R2024a

    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