BitLogger/docs/api/runtime-sink-file-reset-policy.md

name, group, category, update-time, description, key-word

name	group	category	update-time	description	key-word
runtime-sink-file-reset-policy	api	runtime	20260707	Reset the runtime file policy of a RuntimeSink back to its captured defaults.	runtime sink file public

Runtime-sink-file-reset-policy

Reset the runtime file policy of a RuntimeSink back to its captured defaults.

Interface

pub fn RuntimeSink::file_reset_policy(self : RuntimeSink) -> Bool {

Explanation

Detailed rules explaining key parameters and behaviors

• Plain File runtime variants restore the wrapped FileSink default policy and return true.
• QueuedFile runtime variants restore the wrapped inner FileSink default policy only when no queued records are pending.
• Non-file runtime variants return false.
• If a queued file sink still has pending records, the reset is rejected and returns false so already queued records are not later written under a different policy than the one they were queued under.

Notes

1. Use this helper when runtime file policy should return to its captured defaults.

2. On queued file sinks, clear pending records first so policy mutation does not retroactively affect already queued writes.