Module `Email_message_kernel.Headers`Source

Sourcemodule Normalize : sig ... end

Normalize specifies how to handle header values. It is used in two contexts:

Sourcemodule Name : sig ... end

Case insensitive

Sourcemodule Common : sig ... end

This is just a list of commonly used header field names for simple reuse

Sourcemodule Value : sig ... end

Sourcetype t

include Ppx_compare_lib.Comparable.S with type t := t

Sourceval compare : t -> t -> int

include Ppx_hash_lib.Hashable.S with type t := t

Sourceval hash_fold_t : Base.Hash.state -> t -> Base.Hash.state

Sourceval hash : t -> Base.Hash.hash_value

Sourceval sexp_of_t : t -> Sexplib0.Sexp.t

include Ppx_compare_lib.Equal.S with type t := t

Sourceval equal : t -> t -> bool

Sourceval to_string_monoid : ?eol:Lf_or_crlf.t -> t -> String_monoid.t

eol defaults to `LF

Sourceval to_string : ?eol:Lf_or_crlf.t -> t -> string

Sourceval empty : t

Sourceval append : t -> t -> t

Sourceval of_list : normalize:Normalize.encode -> (Name.t * Value.t) list -> t

Sourceval to_list : ?normalize:Normalize.decode -> t -> (Name.t * Value.t) list

Sourceval last : ?normalize:Normalize.decode -> t -> Name.t -> Value.t option

Sourceval any : ?normalize:Normalize.decode -> t -> Name.t -> Value.t option

Sourceval find_all : ?normalize:Normalize.decode -> t -> Name.t -> Value.t list

Sourceval names : t -> Name.t list

Sourceval add : ?normalize:Normalize.encode -> t -> name:Name.t -> value:Value.t -> t

Source

val add_at_bottom : 
  ?normalize:Normalize.encode ->
  t ->
  name:Name.t ->
  value:Value.t ->
  t

Source

val add_if_missing : 
  ?normalize:Normalize.encode ->
  t ->
  name:Name.t ->
  value:Value.t ->
  t

Source

val add_at_bottom_if_missing : 
  ?normalize:Normalize.encode ->
  t ->
  name:Name.t ->
  value:Value.t ->
  t

Sourceval set : ?normalize:Normalize.encode -> t -> name:Name.t -> value:Value.t -> t

Source

val set_at_bottom : 
  ?normalize:Normalize.encode ->
  t ->
  name:Name.t ->
  value:Value.t ->
  t

Sourceval add_all : ?normalize:Normalize.encode -> t -> (Name.t * Value.t) list -> t

Source

val add_all_at_bottom : 
  ?normalize:Normalize.encode ->
  t ->
  (Name.t * Value.t) list ->
  t

Source

val smash_and_add : 
  ?normalize:Normalize.encode ->
  t ->
  name:Name.t ->
  value:Value.t ->
  t

If headers with this name already exist, concatenates the values for all separated by a comma, and appends the new value. Otherwise, creates a new header.

Source

val filter : 
  ?normalize:Normalize.decode ->
  t ->
  f:(name:Name.t -> value:Value.t -> bool) ->
  t

Source

val map : 
  ?normalize:Normalize.decode ->
  t ->
  f:(name:Name.t -> value:Value.t -> Value.t) ->
  t

rewrite header values, preserving original whitespace where possible.

normalize is used to Value.of_string ?normalize the ~value before passing to f, and again to Value.to_string ?normalize the result. If the ~value and f ~name ~value are the same no change will be made (white space is preserved).

Particularly the following is an identity transform: map ~normalize:`Whitespace ~f:(fun ~name:_ ~value -> Value.of_string ~normalize:`Whitespace value) . By contrast the following will 'normalize' the whitespace on all headers. map ~normalize:`None ~f:(fun ~name:_ ~value -> Value.of_string ~normalize:`Whitespace value) .

Source

val map' : 
  ?normalize:Normalize.decode ->
  t ->
  f:(name:Name.t -> value:Value.t -> Name.t * Value.t) ->
  t

Sourcemodule Stable : sig ... end

Install

Dune Dependency

Authors

Maintainers

Sources

doc/email_message.kernel/Email_message_kernel/Headers/index.html

Module `Email_message_kernel.Headers`Source

package email_message

Install

Dune Dependency

Authors

Maintainers

Sources

doc/email_message.kernel/Email_message_kernel/Headers/index.html

Module Email_message_kernel.HeadersSource

Module `Email_message_kernel.Headers`Source