aboutsummaryrefslogtreecommitdiff
path: root/examples/dte/buffer.h
blob: 4450a8f305ef2a04724e3ee4c8d4e2709958b467 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
#ifndef BUFFER_H
#define BUFFER_H

#include <limits.h>
#include <stdbool.h>
#include <stdint.h>
#include <sys/types.h>
#include <time.h>
#include "block-iter.h"
#include "change.h"
#include "encoding.h"
#include "options.h"
#include "syntax/syntax.h"
#include "util/list.h"
#include "util/macros.h"
#include "util/ptr-array.h"
#include "util/string-view.h"
#include "util/string.h"

// Subset of stat(3) struct
typedef struct {
    dev_t dev;
    ino_t ino;
    mode_t mode;
    uid_t uid;
    gid_t gid;
    off_t size;
    struct timespec mtime;
} FileInfo;

// A representation of a specific file, as it pertains to editing,
// including text contents, filename (if saved), undo history and
// some file-specific metadata and options.
typedef struct Buffer {
    ListHead blocks;
    Change change_head;
    Change *cur_change;
    Change *saved_change; // Used to determine if buffer is modified
    FileInfo file;
    unsigned long id; // Needed for identifying buffers whose filename is NULL
    size_t nl;
    PointerArray views; // Views pointing to this buffer
    char *display_filename;
    char *abs_filename;
    bool readonly;
    bool temporary;
    bool stdout_buffer;
    bool locked;
    bool setup;
    bool crlf_newlines;
    bool bom;
    Encoding encoding; // Encoding of the file (buffer always contains UTF-8)
    LocalOptions options;
    Syntax *syn;
    long changed_line_min;
    long changed_line_max;
    // Index 0 is always syn->states.ptrs[0].
    // Lowest bit of an invalidated value is 1.
    PointerArray line_start_states;
} Buffer;

static inline void mark_all_lines_changed(Buffer *buffer)
{
    buffer->changed_line_min = 0;
    buffer->changed_line_max = LONG_MAX;
}

static inline bool buffer_modified(const Buffer *buffer)
{
    return buffer->saved_change != buffer->cur_change && !buffer->temporary;
}

static inline BlockIter block_iter(Buffer *buffer)
{
    return (BlockIter) {
        .blk = BLOCK(buffer->blocks.next),
        .head = &buffer->blocks,
        .offset = 0
    };
}

struct EditorState;

void buffer_mark_lines_changed(Buffer *buffer, long min, long max) NONNULL_ARGS;
void buffer_set_encoding(Buffer *buffer, Encoding encoding, bool utf8_bom) NONNULL_ARGS;
const char *buffer_filename(const Buffer *buffer) NONNULL_ARGS_AND_RETURN;
void set_display_filename(Buffer *buffer, char *name) NONNULL_ARG(1);
void update_short_filename_cwd(Buffer *buffer, const StringView *home, const char *cwd) NONNULL_ARG(1, 2);
void update_short_filename(Buffer *buffer, const StringView *home) NONNULL_ARGS;
Buffer *find_buffer(const PointerArray *buffers, const char *abs_filename) NONNULL_ARGS;
Buffer *find_buffer_by_id(const PointerArray *buffers, unsigned long id) NONNULL_ARGS;
Buffer *buffer_new(PointerArray *buffers, const GlobalOptions *gopts, const Encoding *encoding) RETURNS_NONNULL NONNULL_ARG(1, 2);
Buffer *open_empty_buffer(PointerArray *buffers, const GlobalOptions *gopts) NONNULL_ARGS_AND_RETURN;
void free_buffer(Buffer *buffer) NONNULL_ARGS;
void remove_and_free_buffer(PointerArray *buffers, Buffer *buffer) NONNULL_ARGS;
void free_blocks(Buffer *buffer) NONNULL_ARGS;
bool buffer_detect_filetype(Buffer *buffer, const PointerArray *filetypes) NONNULL_ARGS;
void buffer_update_syntax(struct EditorState *e, Buffer *buffer) NONNULL_ARGS;
void buffer_setup(struct EditorState *e, Buffer *buffer) NONNULL_ARGS;
void buffer_count_blocks_and_bytes(const Buffer *buffer, uintmax_t counts[2]) NONNULL_ARGS;
String dump_buffer(const Buffer *buffer) NONNULL_ARGS;

#endif