Struct NSFileManagerResumeSyncBehavior 

#[repr(transparent)]
pub struct NSFileManagerResumeSyncBehavior(pub NSInteger);

Available on crate feature NSFileManager only.

The behaviors the file manager can apply to resolve conflicts when resuming a sync.

You use this type when calling FileManager/resumeSyncForUbiquitousItem(at:with:completionHandler:) to resume synchronizing. In most situations, the NSFileManagerResumeSyncBehavior/preserveLocalChanges behavior is the best choice to avoid risk of data loss.

See also Apple’s documentation

Tuple Fields

0: NSInteger

Implementations

impl NSFileManagerResumeSyncBehavior

pub const PreserveLocalChanges: Self

Resumes synchronizing by uploading the local version of the file.

If the server has a newer version, the server may create a conflict copy of the file, or may automatically pick the winner of the conflict. Apps can choose to implement conflict handling themselves by passing NSFileManagerResumeSyncBehaviorAfterUploadWithFailOnConflict.

pub const AfterUploadWithFailOnConflict: Self

Resumes sync by first uploading the local version of the file, failing if the provider detects a conflict.

If the upload succeeds, the sync resumes with the preserveLocalChanges behavior.

If the provider detects a conflict, the upload fails with an NSFileWriteUnknownError-enum.case, with the underlying error of <doc ://com.apple.documentation/documentation/FileProvider/NSFileProviderError/localVersionConflictingWithServer>. In this case, the app needs to call FileManager/fetchLatestRemoteVersionOfItem(at:completionHandler:), rebase local changes on top of the newly fetched version to resolve the conflict, and try again to resume sync. This scenario is only available on paused items for which the file provider supports the fail-on-conflict behavior. To check that the file provider supports the behavior, get the NSURLUbiquitousItemSupportedSyncControlsKey URL resource and verify that NSFileManagerSupportedSyncControls/failUploadOnConflict is true.

pub const DropLocalChanges: Self

Resumes synchronizing by overwriting any local changes with the remote version of the file.

If a conflict occurs, the file manager stores the local changes as an alternate version. Only use this behavior if you provide a separate means of resolving and merging conflicts.

Trait Implementations

impl Clone for NSFileManagerResumeSyncBehavior

fn clone(&self) -> NSFileManagerResumeSyncBehavior

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NSFileManagerResumeSyncBehavior

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Encode for NSFileManagerResumeSyncBehavior

const ENCODING: Encoding = NSInteger::ENCODING

The Objective-C type-encoding for this type.

impl Hash for NSFileManagerResumeSyncBehavior

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for NSFileManagerResumeSyncBehavior

fn cmp(&self, other: &NSFileManagerResumeSyncBehavior) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for NSFileManagerResumeSyncBehavior

fn eq(&self, other: &NSFileManagerResumeSyncBehavior) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for NSFileManagerResumeSyncBehavior

fn partial_cmp( &self, other: &NSFileManagerResumeSyncBehavior, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl RefEncode for NSFileManagerResumeSyncBehavior

const ENCODING_REF: Encoding

The Objective-C type-encoding for a reference of this type.

impl Copy for NSFileManagerResumeSyncBehavior

impl Eq for NSFileManagerResumeSyncBehavior

impl StructuralPartialEq for NSFileManagerResumeSyncBehavior