/usr/include/t3/widget/t3widget/findcontext.h is in libt3widget-dev 0.6.2-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /* Copyright (C) 2011-2012,2018 G.P. Halkes
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3, as
published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef T3_WIDGET_FINDCONTEXT_H
#define T3_WIDGET_FINDCONTEXT_H
#include <pcre.h>
#include <string>
#include <t3widget/stringmatcher.h>
#include <t3widget/util.h>
#include <t3widget/widget_api.h>
namespace t3_widget {
/** A struct holding the result of a find operation.
In the current situation, find operations work on a single line. Therefore
this struct does not contain line references.
*/
struct T3_WIDGET_API find_result_t {
text_coordinate_t start, end;
};
/** Class holding the context of a find operation. */
class T3_WIDGET_API finder_t {
private:
static void call_pcre_free(pcre *);
/** Flags indicating what type of search was requested. */
int flags;
/** Pointer to a string_matcher_t, if a non-regex search was requested. */
cleanup_ptr<string_matcher_t>::t matcher;
/* PCRE context and data */
/** Pointer to a compiled regex. */
cleanup_func_ptr<pcre, call_pcre_free>::t regex;
/** Array to hold sub-matches information. */
int ovector[30];
/** The number of sub-matches captured. */
int captures;
bool found; /**< Boolean indicating whether the regex match was successful. */
/** Replacement string. */
cleanup_ptr<std::string>::t replacement;
/** Space to store the case-folded representation of a single character. */
cleanup_free_ptr<char>::t folded;
/** Size of the finder_t::folded buffer. */
size_t folded_size;
/** Get the next position of a UTF-8 character. */
static int adjust_position(const std::string *str, int pos, int adjust);
/** Check if the start and end of a match are on word boundaries.
@param str The string to check.
@param match_start The position of the start of the match in @p str.
@param match_end The position of the end of the match in @p str.
*/
bool check_boundaries(const std::string *str, int match_start, int match_end);
public:
/** Create a new empty finder_t. */
finder_t();
/** Create a new finder_t for a specific search.
May throw a @c const @c char pointer holding an error message. Caller
of this constructor remains owner of passed objects.
*/
finder_t(const std::string *needle, int flags, const std::string *replacement = nullptr);
/** Destroy a finder_t instance. */
virtual ~finder_t();
/** Assign the value of another finder_t to this finder_t.
Assignment using this operator is destructive to @p other. I.e. this
finder_t instance will take ownership of all objects allocated by
@p other, and set @p other's object pointers to nullptr.
*/
finder_t &operator=(finder_t &other);
/** Set the search parameters.
May throw a @c const @c char pointer holding an error message. Caller
of this function remains owner of passed objects.
*/
void set_context(const std::string *needle, int flags, const std::string *replacement = nullptr);
/** Try to find the previously set @c needle in a string. */
bool match(const std::string *haystack, find_result_t *result, bool reverse);
/** Retrieve the flags set when setting the search context. */
int get_flags();
/** Retrieve the replacement string.
Returns a newly allocated string, for which the caller will have
ownership.
*/
std::string *get_replacement(const std::string *haystack);
};
}; // namespace
#endif
|