wxMaxima
Loading...
Searching...
No Matches
EvaluationQueue.h
Go to the documentation of this file.
1// -*- mode: c++; c-file-style: "linux"; c-basic-offset: 2; indent-tabs-mode: nil -*-
2//
3// Copyright (C) 2009 Ziga Lenarcic <zigalenarcic@users.sourceforge.net>
4// (C) 2012 Doug Ilijev <doug.ilijev@gmail.com>
5// (C) 2015-2018 Gunter Königsmann <wxMaxima@physikbuch.de>
6//
7// This program is free software; you can redistribute it and/or modify
8// it under the terms of the GNU General Public License as published by
9// the Free Software Foundation; either version 2 of the License, or
10// (at your option) any later version.
11//
12// This program is distributed in the hope that it will be useful,
13// but WITHOUT ANY WARRANTY; without even the implied warranty of
14// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15// GNU General Public License for more details.
16//
17//
18// You should have received a copy of the GNU General Public License
19// along with this program; if not, write to the Free Software
20// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21//
22// SPDX-License-Identifier: GPL-2.0+
23
32#ifndef EVALUATIONQUEUE_H
33#define EVALUATIONQUEUE_H
34
35#include "precomp.h"
36#include "cells/GroupCell.h"
37#include <wx/arrstr.h>
38#include <vector>
39#include <utility>
40
43{
44private:
45 class Command{
46 public:
47 Command(const wxString &strng, int index) : m_indexStart(index), m_command(strng) {}
48 Command(Command &&o) noexcept : m_indexStart(o.m_indexStart), m_command(std::move(o.m_command)) {}
49 Command(const Command &o) : m_indexStart(o.m_indexStart), m_command(o.m_command) {}
50 Command &operator=(Command &&o) noexcept
51 {
52 m_indexStart = o.m_indexStart;
53 m_command = std::move(o.m_command);
54 return *this;
55 }
56 Command &operator=(const Command &o)
57 {
58 m_indexStart = o.m_indexStart;
59 m_command = o.m_command;
60 return *this;
61 }
62
63 const wxString &GetString() const { return m_command; }
64 void AddEnding()
65 {
66 wxString trimmed = m_command;
67 trimmed.Trim(true);
68 if (!trimmed.EndsWith(wxS(";")) && !trimmed.EndsWith(wxS("$")))
69 m_command += ";";
70 }
71 int GetIndex() const { return m_indexStart; }
72 private:
73 long m_indexStart = -1;
74 wxString m_command;
75 };
76
87 std::vector<EvaluationQueue::Command> m_commands;
89 wxString m_pendingText;
91 Configuration *m_pendingConfig = nullptr;
94 long m_cellConsumedChars = 0;
95 std::size_t m_size;
97 wxString m_userLabel;
98
101 struct QueuedCell {
103 wxString textAtEnqueue;
104 };
106 std::vector<QueuedCell> m_queue;
107
117 bool m_integrityFailure = false;
118 wxString m_integrityFailureEnqueuedText;
119 wxString m_integrityFailureCurrentText;
120
123 void AddTokens();
127 void ProduceNextCommand();
128
129public:
136 wxString GetUserLabel() const
137 { return m_userLabel; }
138
139 int GetIndex() const
140 {
141 if (!m_commands.empty())
142 return m_commands.front().GetIndex();
143 else
144 return -1;
145 }
146
147 bool m_workingGroupChanged = false;
148
150
151 void AddEnding()
152 {
153 if (!m_commands.empty())
154 m_commands.back().AddEnding();
155 }
156
157 virtual ~EvaluationQueue()
158 {};
159
161 bool IsLastInQueue(GroupCell const *gr)
162 {
163 return !m_queue.empty() && (gr == m_queue.front().cell);
164 }
165
167 bool IsInQueue(GroupCell *gr) const;
168
170 void AddToQueue(GroupCell *gr);
171
173 void Remove(GroupCell *gr);
174
176 void AddHiddenTreeToQueue(const GroupCell *gr);
177
179 void RemoveFirst();
180
186
188 bool Empty() const;
189
191 void Clear();
192
194 wxString GetCommand();
195
200 bool HasIntegrityFailure() const { return m_integrityFailure; }
203 const wxString &GetIntegrityFailureEnqueuedText() const
204 { return m_integrityFailureEnqueuedText; }
207 const wxString &GetIntegrityFailureCurrentText() const
208 { return m_integrityFailureCurrentText; }
209
211 int Size() const { return m_size; }
212
217 int CommandsLeftInCell() const;
218};
219
220
221#endif /* EVALUATIONQUEUE_H */
This file defines the class GroupCell that bundles input and output in the worksheet.
A weak non-owning pointer that becomes null whenever the observed object is destroyed.
Definition: CellPtr.h:539
The configuration storage for the current worksheet.
Definition: Configuration.h:98
A simple FIFO queue with manual removal of elements.
Definition: EvaluationQueue.h:43
void Remove(GroupCell *gr)
Remove a GroupCell from the evaluation queue.
Definition: EvaluationQueue.cpp:62
wxString GetUserLabel() const
Query for the label the user has assigned to the current command.
Definition: EvaluationQueue.h:136
bool IsLastInQueue(GroupCell const *gr)
Is GroupCell gr part of the evaluation queue?
Definition: EvaluationQueue.h:161
bool IsInQueue(GroupCell *gr) const
Is GroupCell gr part of the evaluation queue?
Definition: EvaluationQueue.cpp:56
void Clear()
Clear the queue.
Definition: EvaluationQueue.cpp:43
bool Empty() const
Is the queue empty?
Definition: EvaluationQueue.cpp:34
void AddHiddenTreeToQueue(const GroupCell *gr)
Adds all hidden cells attached to the GroupCell gr to the evaluation queue.
Definition: EvaluationQueue.cpp:103
void AddToQueue(GroupCell *gr)
Adds a GroupCell to the evaluation queue.
Definition: EvaluationQueue.cpp:79
wxString GetCommand()
Return the next command that needs to be evaluated.
Definition: EvaluationQueue.cpp:350
void RemoveFirst()
Removes the first command in the queue.
Definition: EvaluationQueue.cpp:113
GroupCell * GetCell()
Gets the cell the next command in the queue belongs to.
Definition: EvaluationQueue.cpp:343
bool HasIntegrityFailure() const
Did the cell that just became current (see GetCell()) have different text than what was captured when...
Definition: EvaluationQueue.h:200
int CommandsLeftInCell() const
Roughly how many commands are still to be run in the current cell. Because commands are tokenized laz...
Definition: EvaluationQueue.cpp:321
const wxString & GetIntegrityFailureCurrentText() const
The cell's text as AddTokens() actually read it, valid only while HasIntegrityFailure() is true for t...
Definition: EvaluationQueue.h:207
const wxString & GetIntegrityFailureEnqueuedText() const
The cell's text as it was when AddToQueue() was called, valid only while HasIntegrityFailure() is tru...
Definition: EvaluationQueue.h:203
int Size() const
Get the size of the queue [in cells].
Definition: EvaluationQueue.h:211
A cell grouping input (and, if there is one, also the output) cell to a foldable item.
Definition: GroupCell.h:88