Function libyml::api::yaml_document_start_event_initialize

source ·
pub unsafe fn yaml_document_start_event_initialize(
    event: *mut YamlEventT,
    version_directive: *mut YamlVersionDirectiveT,
    tag_directives_start: *mut YamlTagDirectiveT,
    tag_directives_end: *mut YamlTagDirectiveT,
    implicit: bool,
) -> Success
Expand description

Create the DOCUMENT-START event.

The implicit argument is considered as a stylistic parameter and may be ignored by the emitter.

§Safety

  • event must be a valid, non-null pointer to a YamlEventT struct that can be safely written to.
  • version_directive, if not null, must point to a valid YamlVersionDirectiveT struct.
  • tag_directives_start and tag_directives_end must be valid pointers to YamlTagDirectiveT structs, or both must be null.
  • If tag_directives_start and tag_directives_end are not null, the range they define must contain valid YamlTagDirectiveT structs with non-null handle and prefix members, and the handle and prefix strings must be valid UTF-8.
  • The YamlEventT, YamlVersionDirectiveT, and YamlTagDirectiveT structs must be properly aligned and have the expected memory layout.
  • The caller is responsible for freeing any dynamically allocated memory associated with the event using yaml_event_delete.