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 <wx/stopwatch.h>
39#include <vector>
40#include <utility>
41
44{
45private:
46 class Command{
47 public:
56 Command(const wxString &strng, long start, long index)
57 : m_start(start), m_indexStart(index), m_command(strng) {}
58
59 const wxString &GetString() const { return m_command; }
60 void AddEnding()
61 {
62 wxString trimmed = m_command;
63 trimmed.Trim(true);
64 if (!trimmed.EndsWith(wxS(";")) && !trimmed.EndsWith(wxS("$")))
65 m_command += ";";
66 }
68 int GetIndex() const { return m_indexStart; }
70 long GetStart() const { return m_start; }
71 private:
72 long m_start = -1;
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
108 wxStopWatch m_commandStopwatch;
111 bool m_commandTimerRunning = false;
112
115 struct QueuedCell {
117 wxString textAtEnqueue;
118 };
120 std::vector<QueuedCell> m_queue;
121
131 bool m_integrityFailure = false;
132 wxString m_integrityFailureEnqueuedText;
133 wxString m_integrityFailureCurrentText;
134
137 void AddTokens();
141 void ProduceNextCommand();
142
143public:
150 wxString GetUserLabel() const
151 { return m_userLabel; }
152
153 int GetIndex() const
154 {
155 if (!m_commands.empty())
156 return m_commands.front().GetIndex();
157 else
158 return -1;
159 }
160
181 static long CommandPositionInCell(const wxString &cellText, long start,
182 long end, std::size_t offset,
183 Configuration *configuration);
184
185 long GetCommandStart() const
186 {
187 if (!m_commands.empty())
188 return m_commands.front().GetStart();
189 else
190 return -1;
191 }
192
193 bool m_workingGroupChanged = false;
194
196
197 void AddEnding()
198 {
199 if (!m_commands.empty())
200 m_commands.back().AddEnding();
201 }
202
203 virtual ~EvaluationQueue()
204 {};
205
207 bool IsLastInQueue(GroupCell const *gr)
208 {
209 return !m_queue.empty() && (gr == m_queue.front().cell);
210 }
211
213 bool IsInQueue(GroupCell *gr) const;
214
216 void AddToQueue(GroupCell *gr);
217
219 void Remove(GroupCell *gr);
220
222 void AddHiddenTreeToQueue(const GroupCell *gr);
223
225 void RemoveFirst();
226
232
234 bool Empty() const;
235
237 void Clear();
238
240 wxString GetCommand();
241
246 bool HasIntegrityFailure() const { return m_integrityFailure; }
249 const wxString &GetIntegrityFailureEnqueuedText() const
250 { return m_integrityFailureEnqueuedText; }
253 const wxString &GetIntegrityFailureCurrentText() const
254 { return m_integrityFailureCurrentText; }
255
257 int Size() const { return m_size; }
258
263 int CommandsLeftInCell() const;
264
269 {
270 m_commandStopwatch.Start();
271 m_commandTimerRunning = true;
272 }
273
278 {
279 return m_commandTimerRunning ? m_commandStopwatch.Time() : -1;
280 }
281};
282
283
284#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:101
A simple FIFO queue with manual removal of elements.
Definition: EvaluationQueue.h:44
void Remove(GroupCell *gr)
Remove a GroupCell from the evaluation queue.
Definition: EvaluationQueue.cpp:64
wxString GetUserLabel() const
Query for the label the user has assigned to the current command.
Definition: EvaluationQueue.h:150
bool IsLastInQueue(GroupCell const *gr)
Is GroupCell gr part of the evaluation queue?
Definition: EvaluationQueue.h:207
long GetCommandElapsedMilliseconds() const
Milliseconds since MarkCommandSent() was last called for the command currently in flight,...
Definition: EvaluationQueue.h:277
bool IsInQueue(GroupCell *gr) const
Is GroupCell gr part of the evaluation queue?
Definition: EvaluationQueue.cpp:58
void Clear()
Clear the queue.
Definition: EvaluationQueue.cpp:44
bool Empty() const
Is the queue empty?
Definition: EvaluationQueue.cpp:35
void AddHiddenTreeToQueue(const GroupCell *gr)
Adds all hidden cells attached to the GroupCell gr to the evaluation queue.
Definition: EvaluationQueue.cpp:105
void AddToQueue(GroupCell *gr)
Adds a GroupCell to the evaluation queue.
Definition: EvaluationQueue.cpp:81
wxString GetCommand()
Return the next command that needs to be evaluated.
Definition: EvaluationQueue.cpp:397
void RemoveFirst()
Removes the first command in the queue.
Definition: EvaluationQueue.cpp:115
static long CommandPositionInCell(const wxString &cellText, long start, long end, std::size_t offset, Configuration *configuration)
Where in its cell the current command starts.
Definition: EvaluationQueue.cpp:341
GroupCell * GetCell()
Gets the cell the next command in the queue belongs to.
Definition: EvaluationQueue.cpp:390
bool HasIntegrityFailure() const
Did the cell that just became current (see GetCell()) have different text than what was captured when...
Definition: EvaluationQueue.h:246
int CommandsLeftInCell() const
Roughly how many commands are still to be run in the current cell. Because commands are tokenized laz...
Definition: EvaluationQueue.cpp:368
const wxString & GetIntegrityFailureCurrentText() const
The cell's text as AddTokens() actually read it, valid only while HasIntegrityFailure() is true for t...
Definition: EvaluationQueue.h:253
const wxString & GetIntegrityFailureEnqueuedText() const
The cell's text as it was when AddToQueue() was called, valid only while HasIntegrityFailure() is tru...
Definition: EvaluationQueue.h:249
int Size() const
Get the size of the queue [in cells].
Definition: EvaluationQueue.h:257
void MarkCommandSent()
Call exactly once, right after the current command's text is actually written to Maxima's socket – st...
Definition: EvaluationQueue.h:268
A cell grouping input (and, if there is one, also the output) cell to a foldable item.
Definition: GroupCell.h:88