// -*- C++ -*-
+/**
+ * \file lyxfind.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Lars Gullik Bjønnes
+ * \author John Levon
+ * \author Jürgen Vigna
+ * \author Alfredo Braunstein
+ * \author Tommaso Cucinotta
+ *
+ * Full author contact details are available in file CREDITS.
+ */
+
#ifndef LYXFIND_H
#define LYXFIND_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "support/strfwd.h"
+
+// FIXME
+#include "support/docstring.h"
+
+namespace lyx {
-#include "LString.h"
-#include "lyxparagraph.h"
+
+class Buffer;
+class Cursor;
class BufferView;
+class DocIterator;
+class FuncRequest;
+class Text;
+
+/** Encode the parameters needed to find \c search as a string
+ * that can be dispatched to the LyX core in a FuncRequest wrapper.
+ */
+docstring const find2string(docstring const & search,
+ bool casesensitive,
+ bool matchword,
+ bool forward);
+
+/** Encode the parameters needed to replace \c search with \c replace
+ * as a string that can be dispatched to the LyX core in a FuncRequest
+ * wrapper.
+ */
+docstring const replace2string(docstring const & replace,
+ docstring const & search,
+ bool casesensitive,
+ bool matchword,
+ bool all,
+ bool forward,
+ bool findnext = true);
+
+/** Parse the string encoding of the find request that is found in
+ * \c ev.argument and act on it.
+ * The string is encoded by \c find2string.
+ * \return true if the string was found.
+ */
+bool lyxfind(BufferView * bv, FuncRequest const & ev);
+
+/** Parse the string encoding of the replace request that is found in
+ * \c ev.argument and act on it.
+ * The string is encoded by \c replace2string.
+ * \return whether we did anything
+ */
+bool lyxreplace(BufferView * bv,
+ FuncRequest const &, bool has_deleted = false);
+
+/// find the next change in the buffer
+bool findNextChange(BufferView * bv);
+
+/// find the previous change in the buffer
+bool findPreviousChange(BufferView * bv);
+
+/// select change under the cursor
+bool selectChange(Cursor & cur, bool forward = true);
+
-int LyXReplace(BufferView * bv, string const &, string const &,
- bool const &, bool const &, bool const &, bool const & = false);
+class FindAndReplaceOptions {
+public:
+ typedef enum {
+ S_BUFFER,
+ S_DOCUMENT,
+ S_OPEN_BUFFERS,
+ S_ALL_MANUALS
+ } SearchScope;
+ typedef enum {
+ R_EVERYTHING,
+ R_ONLY_MATHS
+ } SearchRestriction;
+ FindAndReplaceOptions(
+ docstring const & find_buf_name,
+ bool casesensitive,
+ bool matchword,
+ bool forward,
+ bool expandmacros,
+ bool ignoreformat,
+ docstring const & repl_buf_name,
+ bool keep_case,
+ SearchScope scope = S_BUFFER,
+ SearchRestriction restr = R_EVERYTHING
+ );
+ FindAndReplaceOptions() : casesensitive(false), matchword(false), forward(false),
+ expandmacros(false), ignoreformat(false) {}
+ docstring find_buf_name;
+ bool casesensitive;
+ bool matchword;
+ bool forward;
+ bool expandmacros;
+ bool ignoreformat;
+ /// This is docstring() if no replace was requested
+ docstring repl_buf_name;
+ bool keep_case;
+ SearchScope scope;
+ SearchRestriction restr;
+};
-bool LyXFind(BufferView * bv, string const &, bool const &, bool const &,
- bool const &);
+/// Write a FindAdvOptions instance to a stringstream
+std::ostringstream & operator<<(std::ostringstream & os, lyx::FindAndReplaceOptions const & opt);
-/// returns true if the specified string is at the specified position
-bool IsStringInText(LyXParagraph * par, LyXParagraph::size_type pos,
- string const & str, bool const & = true,
- bool const & = false);
+/// Read a FindAdvOptions instance from a stringstream
+std::istringstream & operator>>(std::istringstream & is, lyx::FindAndReplaceOptions & opt);
-/// if the string is found: return true and set the cursor to the new position
-bool SearchForward(BufferView *, string const & str, bool const & = true,
- bool const & = false);
-///
-bool SearchBackward(BufferView *, string const & str, bool const & = true,
- bool const & = false);
+/// Perform a FindAdv operation.
+bool findAdv(BufferView * bv, FindAndReplaceOptions const & opt);
+
+/** Computes the simple-text or LaTeX export (depending on opt) of buf starting
+ ** from cur and ending len positions after cur, if len is positive, or at the
+ ** paragraph or innermost inset end if len is -1.
+ **
+ ** This is useful for computing opt.search from the SearchAdvDialog controller (ControlSearchAdv).
+ ** Ideally, this should not be needed, and the opt.search field should become a Text const &.
+ **/
+docstring stringifyFromForSearch(
+ FindAndReplaceOptions const & opt,
+ DocIterator const & cur,
+ int len = -1);
+} // namespace lyx
-#endif
+#endif // LYXFIND_H