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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
#ifndef TEXT_MOTIONS_H
#define TEXT_MOTIONS_H
/* these functions all take a position in bytes from the start of the file,
* perform a certain movement and return the new position. If the movement
* is not possible the original position is returned unchanged. */
#include "text.h"
#include "text-regex.h"
/* char refers to a grapheme (might skip over multiple Unicode codepoints) */
VIS_INTERNAL size_t text_char_next(Text*, size_t pos);
VIS_INTERNAL size_t text_char_prev(Text*, size_t pos);
VIS_INTERNAL size_t text_codepoint_next(Text*, size_t pos);
VIS_INTERNAL size_t text_codepoint_prev(Text*, size_t pos);
/* find the given substring either in forward or backward direction.
* does not wrap around at file start / end. If no match is found return
* original position */
VIS_INTERNAL size_t text_find_next(Text*, size_t pos, const char *s);
VIS_INTERNAL size_t text_find_prev(Text*, size_t pos, const char *s);
/* same as above but limit searched range to the line containing pos */
VIS_INTERNAL size_t text_line_find_next(Text*, size_t pos, const char *s);
VIS_INTERNAL size_t text_line_find_prev(Text*, size_t pos, const char *s);
/* begin finish next
* v v v
* \n I am a line! \n
* ^ ^ ^
* prev start end
*/
VIS_INTERNAL size_t text_line_prev(Text*, size_t pos);
VIS_INTERNAL size_t text_line_begin(Text*, size_t pos);
VIS_INTERNAL size_t text_line_start(Text*, size_t pos);
VIS_INTERNAL size_t text_line_finish(Text*, size_t pos);
VIS_INTERNAL size_t text_line_end(Text*, size_t pos);
VIS_INTERNAL size_t text_line_next(Text*, size_t pos);
VIS_INTERNAL size_t text_line_offset(Text*, size_t pos, size_t off);
/* get grapheme count of the line upto `pos' */
VIS_INTERNAL int text_line_char_get(Text*, size_t pos);
/* get position of the `count' grapheme in the line containing `pos' */
VIS_INTERNAL size_t text_line_char_set(Text*, size_t pos, int count);
/* get display width of line upto `pos' */
VIS_INTERNAL int text_line_width_get(Text*, size_t pos);
/* get position of character being displayed at `width' in line containing `pos' */
VIS_INTERNAL size_t text_line_width_set(Text*, size_t pos, int width);
/* move to the next/previous grapheme on the same line */
VIS_INTERNAL size_t text_line_char_next(Text*, size_t pos);
VIS_INTERNAL size_t text_line_char_prev(Text*, size_t pos);
/* move to start of next/previous blank line */
VIS_INTERNAL size_t text_line_blank_next(Text*, size_t pos);
VIS_INTERNAL size_t text_line_blank_prev(Text*, size_t pos);
/* move to same offset in previous/next line */
VIS_INTERNAL size_t text_line_up(Text*, size_t pos);
VIS_INTERNAL size_t text_line_down(Text*, size_t pos);
/* functions to iterate over all line beginnings in a given range */
VIS_INTERNAL size_t text_range_line_first(Text*, Filerange*);
VIS_INTERNAL size_t text_range_line_next(Text*, Filerange*, size_t pos);
/*
* A longword consists of a sequence of non-blank characters, separated with
* white space. TODO?: An empty line is also considered to be a word.
* This is equivalent to a WORD in vim terminology.
*/
VIS_INTERNAL size_t text_longword_end_next(Text*, size_t pos);
VIS_INTERNAL size_t text_longword_end_prev(Text*, size_t pos);
VIS_INTERNAL size_t text_longword_start_next(Text*, size_t pos);
VIS_INTERNAL size_t text_longword_start_prev(Text*, size_t pos);
/*
* A word consists of a sequence of letters, digits and underscores, or a
* sequence of other non-blank characters, separated with white space.
* TODO?: An empty line is also considered to be a word.
* This is equivalent to a word (lowercase) in vim terminology.
*/
VIS_INTERNAL size_t text_word_end_next(Text*, size_t pos);
VIS_INTERNAL size_t text_word_end_prev(Text*, size_t pos);
VIS_INTERNAL size_t text_word_start_next(Text*, size_t pos);
VIS_INTERNAL size_t text_word_start_prev(Text*, size_t pos);
/*
* More general versions of the above, define your own word boundaries.
*/
VIS_INTERNAL size_t text_customword_start_next(Text*, size_t pos, int (*isboundary)(int));
VIS_INTERNAL size_t text_customword_start_prev(Text*, size_t pos, int (*isboundary)(int));
VIS_INTERNAL size_t text_customword_end_next(Text*, size_t pos, int (*isboundary)(int));
VIS_INTERNAL size_t text_customword_end_prev(Text*, size_t pos, int (*isboundary)(int));
/* TODO: implement the following semantics
* A sentence is defined as ending at a '.', '!' or '?' followed by either the
* end of a line, or by a space or tab. Any number of closing ')', ']', '"'
* and ''' characters may appear after the '.', '!' or '?' before the spaces,
* tabs or end of line. A paragraph and section boundary is also a sentence
* boundary.
*/
VIS_INTERNAL size_t text_sentence_next(Text*, size_t pos);
VIS_INTERNAL size_t text_sentence_prev(Text*, size_t pos);
/* TODO: implement the following semantics
* A paragraph begins after each empty line. A section boundary is also a
* paragraph boundary. Note that a blank line (only containing white space)
* is NOT a paragraph boundary.
*/
VIS_INTERNAL size_t text_paragraph_next(Text*, size_t pos);
VIS_INTERNAL size_t text_paragraph_prev(Text*, size_t pos);
/* A section begins after a form-feed in the first column.
size_t text_section_next(Text*, size_t pos);
size_t text_section_prev(Text*, size_t pos);
*/
VIS_INTERNAL size_t text_block_start(Text*, size_t pos);
VIS_INTERNAL size_t text_block_end(Text*, size_t pos);
VIS_INTERNAL size_t text_parenthesis_start(Text*, size_t pos);
VIS_INTERNAL size_t text_parenthesis_end(Text*, size_t pos);
/* search corresponding '(', ')', '{', '}', '[', ']', '>', '<', '"', ''' */
VIS_INTERNAL size_t text_bracket_match(Text*, size_t pos, const Filerange *limits);
/* same as above but explicitly specify symbols to match */
VIS_INTERNAL size_t text_bracket_match_symbol(Text*, size_t pos, const char *symbols, const Filerange *limits);
/* search the given regex pattern in either forward or backward direction,
* starting from pos. Does wrap around if no match was found. */
VIS_INTERNAL size_t text_search_forward(Text *txt, size_t pos, Regex *regex);
VIS_INTERNAL size_t text_search_backward(Text *txt, size_t pos, Regex *regex);
/* is c a special symbol delimiting a word? */
VIS_INTERNAL int is_word_boundary(int c);
#endif
|
