Buffers are used to hold the contents of files that are being visited; there may also be buffers that are not visiting files.
(Info-goto-node "(elisp)Buffers")include Ecaml_value.Value.Subtype with type t = Ecaml_value__.Value0.tWe expose private value for free identity conversions when the value is nested in some covariant type, e.g. (symbols : Symbol.t list :> Value.t list) rather than List.map symbols ~f:Symbol.to_value.
val sexp_of_t : t -> Ppx_sexp_conv_lib.Sexp.teq t1 t2 = Value.eq (to_value t1) (to_value t2), i.e. eq checks whether the Emacs values underlying t1 and t2 are physically equal. This is different than phys_equal t1 t2, because we don't always wrap eq Emacs values in phys_equal OCaml values. I.e. phys_equal t1 t2 implies eq t1 t2, but not the converse.
val is_in_subtype : Ecaml_value.Value.t -> boolval of_value_exn : Ecaml_value__.Value0.t -> tval to_value : t -> Ecaml_value__.Value0.tval type_ : t Ecaml_value.Value.Type.ttype buffer = tinclude Core_kernel.Equal.S with type t := tval equal : t Base.Equal.equalmodule Compare_by_name : Core_kernel.Comparable.S_plain with type t = tAccessors
val file_name : t -> string option(describe-function 'buffer-file-name)val is_live : t -> bool(describe-function 'buffer-live-p) val name : t -> string option(describe-function 'buffer-name) val process : t -> Ecaml_value__.Value0.t option(describe-function 'get-buffer-process)val process_exn : t -> Ecaml_value__.Value0.tval all_live : unit -> t listall_live returns a list of all live buffers. (describe-function 'buffer-list).
val create : name:string -> tcreate ~name creates a new buffer with name name, adjusting the name if necessary to make the buffer's name unique. (describe-function 'generate-new-buffer).
val find : name:string -> t optionfind ~name returns the live buffer whose name is name, if any. (describe-function 'get-buffer).
val find_visiting : file:Filename.t -> t option(describe-function 'get-file-buffer). (Info-goto-node "(elisp)Buffer File Name")
val find_or_create : name:string -> tfind ~name returns the live buffer whose name is name, and if there is no such buffer, creates it. (describe-function 'get-buffer-create).
val kill : t -> unitkill t kills t, so that not (is_live t). (describe-function 'kill-buffer).
val displayed_in : ?current_frame_only:bool -> t -> Ecaml_value__.Value0.t listReturn a list of all windows on the current terminal that are displaying the given buffer.
(describe-function 'get-buffer-window-list)
val display : t -> unit(Info-goto-node "(elisp)Choosing Window") (describe-function 'display-buffer)
(describe-function 'buffer-local-value) (Info-goto-node "(elisp)Creating Buffer-Local")
val buffer_local_variables : t -> (Symbol.t * Ecaml_value.Value.t option) list(describe-function 'buffer-local-variables) (Info-goto-node "(elisp)Creating Buffer-Local")
val find_file_noselect : Filename.t -> t(describe-function 'find-file-noselect) (Info-goto-node "(elisp)Visiting Functions")
See also Selected_window.find_file.
val is_internal_or_dead : t -> boolFrom (Info-goto-node "(emacs)Select Buffer"):
Emacs uses buffer names that start with a space for internal purposes. It treats these buffers specially in minor ways---for example, by default they do not record undo information. It is best to avoid using such buffer names yourself.
As dead buffers have no names, it is unknown whether a dead buffer was internal.
module Which_buffers : sig ... endval save_some : ?query:bool -> ?which_buffers:Which_buffers.t -> unit -> unit(describe-function 'save-some-buffers) (Info-goto-node "(elisp)Saving Buffers")
val with_temp_buffer : (t -> 'a) -> 'a