// -*- 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"
-#include "LString.h"
-#include "support/types.h"
+// FIXME
+#include "support/docstring.h"
-class BufferView;
-class LyXText;
+namespace lyx {
-namespace lyxfind {
-enum SearchResult {
- //
- SR_NOT_FOUND = 0,
- //
- SR_FOUND,
- //
- SR_FOUND_NOUPDATE
-};
+class Buffer;
+class BufferView;
+class DocIterator;
+class FuncRequest;
+class Text;
-int LyXReplace(BufferView * bv,
- string const &, string const &,
- bool, bool = true, bool = false,
- bool = false, bool = false);
+/** 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);
-/**
- * This function is called as a general interface to find some
- * text from the actual cursor position in whatever direction
- * we want to go. This does also update the screen.
+/** 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.
*/
-bool LyXFind(BufferView *,
- string const & searchstr, bool forward,
- bool casesens = true, bool matchwrd = false);
+docstring const replace2string(docstring const & search,
+ docstring const & replace,
+ bool casesensitive,
+ bool matchword,
+ bool all,
+ bool forward);
-/**
- * This function does search from the cursor position inside the
- * passed LyXText parameter and regards this LyXText as the root
- * LyXText. It will NOT update any screen stuff. It will however
- * set the cursor to the new position inside LyXText, before
- * returning to the calling function.
+/** 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 find(BufferView * bv, FuncRequest const & ev);
-SearchResult LyXFind(BufferView *, LyXText * text,
- string const & searchstr, bool forward,
- bool casesens = true, bool matchwrd = false);
+/** 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.
+ */
+void replace(BufferView * bv, FuncRequest const &, bool has_deleted = false);
/// find the next change in the buffer
bool findNextChange(BufferView * bv);
-
-SearchResult findNextChange(BufferView * bv, LyXText * text, lyx::pos_type & length);
-
-SearchResult nextChange(BufferView * bv, LyXText * text, lyx::pos_type & length);
-
-} // end namespace LyXFind
-
+
+/// find the previous change in the buffer
+bool findPreviousChange(BufferView * bv);
+
+/// find the change in the buffer
+/// \param next true to find the next change, otherwise the previous
+bool findChange(BufferView * bv, bool next);
+
+// Hopefully, nobody will ever replace with something like this
+#define LYX_FR_NULL_STRING "__LYX__F&R__NULL__STRING__"
+
+class FindAndReplaceOptions {
+public:
+ FindAndReplaceOptions(
+ docstring const & search,
+ bool casesensitive,
+ bool matchword,
+ bool forward,
+ bool expandmacros,
+ bool ignoreformat,
+ bool regexp,
+ docstring const & replace
+ );
+ FindAndReplaceOptions() { }
+ docstring search;
+ bool casesensitive;
+ bool matchword;
+ bool forward;
+ bool expandmacros;
+ bool ignoreformat;
+ bool regexp;
+ docstring replace;
+};
+
+/// Write a FindAdvOptions instance to a stringstream
+std::ostringstream & operator<<(std::ostringstream & os, lyx::FindAndReplaceOptions const & opt);
+
+/// Read a FindAdvOptions instance from a stringstream
+std::istringstream & operator>>(std::istringstream & is, lyx::FindAndReplaceOptions & opt);
+
+/// Dispatch a LFUN_WORD_FINDADV command request
+void findAdv(BufferView * bv, FuncRequest const & ev);
+
+/// 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 // LYXFIND_H