pub unsafe extern "C" fn svn_wc_parse_externals_description3(
externals_p: *mut *mut apr_array_header_t,
defining_directory: *const c_char,
desc: *const c_char,
canonicalize_url: svn_boolean_t,
pool: *mut apr_pool_t,
) -> *mut svn_error_t
Expand description
If @a externals_p is non-NULL, set @a *externals_p to an array of #svn_wc_external_item2_t * objects based on @a desc.
If the format of @a desc is invalid, don’t touch @a *externals_p and return #SVN_ERR_CLIENT_INVALID_EXTERNALS_DESCRIPTION. Thus, if you just want to check the validity of an externals description, and don’t care about the parsed result, pass NULL for @a externals_p.
The format of @a desc is the same as for values of the directory property #SVN_PROP_EXTERNALS. Look there for more details.
If @a canonicalize_url is @c TRUE, canonicalize the @a url member of those objects. If the @a url member refers to an absolute URL, it will be canonicalized as URL consistent with the way URLs are canonicalized throughout the Subversion API. If, however, the @a url member makes use of the recognized (SVN-specific) relative URL syntax for svn:externals, “canonicalization” is an ill-defined concept which may even result in munging the relative URL syntax beyond recognition. You’ve been warned.
Allocate the table, keys, and values in @a pool.
@a defining_directory is the path or URL of the directory on which the svn:externals property corresponding to @a desc is set. @a defining_directory is only used when constructing error strings.
@since New in 1.5.