Path-based delta drivers

Path-based editor drives. More...

Typedefs
typedef svn_error_t *(*	svn_delta_path_driver_cb_func_t )(void **dir_baton, void *parent_baton, void *callback_baton, const char *path, apr_pool_t *pool)
	Callback function type for svn_delta_path_driver(). More...

Functions
svn_error_t *	svn_delta_path_driver2 (const svn_delta_editor_t *editor, void *edit_baton, const apr_array_header_t *paths, svn_boolean_t sort_paths, svn_delta_path_driver_cb_func_t callback_func, void *callback_baton, apr_pool_t *scratch_pool)
	Drive editor (with its edit_baton) to visit each path in paths. More...
svn_error_t *	svn_delta_path_driver (const svn_delta_editor_t *editor, void *edit_baton, svn_revnum_t revision, const apr_array_header_t *paths, svn_delta_path_driver_cb_func_t callback_func, void *callback_baton, apr_pool_t *scratch_pool)
	Similar to svn_delta_path_driver2, but takes an (unused) revision, and will sort the provided paths using svn_sort_compare_paths. More...

Detailed Description

Path-based editor drives.

Typedef Documentation

typedef svn_error_t*(* svn_delta_path_driver_cb_func_t)(void **dir_baton, void *parent_baton, void *callback_baton, const char *path, apr_pool_t *pool)

Callback function type for svn_delta_path_driver().

The handler of this callback is given the callback baton callback_baton, path which is a relpath relative to the root of the edit, and the parent_baton which represents path's parent directory as created by the editor passed to svn_delta_path_driver().

If path represents a directory, the handler must return a *dir_baton for path, generated from the same editor (so that the driver can later close that directory).

If, however, path represents a file, the handler should NOT return any file batons. It can close any opened or added files immediately, or delay that close until the end of the edit when svn_delta_path_driver() returns.

Finally, if parent_baton is NULL, then the root of the edit is also one of the paths passed to svn_delta_path_driver(). The handler of this callback must call the editor's open_root() function and return the top-level root dir baton in *dir_baton.

Definition at line 1224 of file svn_delta.h.

Function Documentation

svn_error_t* svn_delta_path_driver	(	const svn_delta_editor_t *	editor,
		void *	edit_baton,
		svn_revnum_t	revision,
		const apr_array_header_t *	paths,
		svn_delta_path_driver_cb_func_t	callback_func,
		void *	callback_baton,
		apr_pool_t *	scratch_pool
	)

Similar to svn_delta_path_driver2, but takes an (unused) revision, and will sort the provided paths using svn_sort_compare_paths.

Note

In versions prior to 1.8, this function would modify the order of elements in paths, despite the 'const' marker on the parameter. This has been fixed in 1.8.

Deprecated:

Provided for backward compatibility with the 1.7 API.

svn_error_t* svn_delta_path_driver2	(	const svn_delta_editor_t *	editor,
		void *	edit_baton,
		const apr_array_header_t *	paths,
		svn_boolean_t	sort_paths,
		svn_delta_path_driver_cb_func_t	callback_func,
		void *	callback_baton,
		apr_pool_t *	scratch_pool
	)

Drive editor (with its edit_baton) to visit each path in paths.

As each path is hit as part of the editor drive, use callback_func and callback_baton to allow the caller to handle the portion of the editor drive related to that path.

Each path in paths is a (const char *) relpath, relative to the root path of the edit. The editor drive will be performed in the same order as paths. The paths should be sorted using something like svn_sort_compare_paths to ensure that a depth-first pattern is observed for directory/file baton creation. If sort_paths is set, the function will sort the paths for you. Some callers may need further customization of the order (ie. libsvn_delta/compat.c).

Use scratch_pool for all necessary allocations.

Since

New in 1.8.