Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/consolecommands3/src/libraries/core/command/CommandEvaluation.cc @ 7233

Last change on this file since 7233 was 7233, checked in by landauf, 14 years ago
  • console commands "setMMSoundPath" and "printObjects" are now hidden.
  • added "unhide" command to show hidden commands
  • extended auto-completion capability by allowing multi-word ArgumentCompleter and more
  • added new auto-completion function that allows other commands as argument for a command (for example "delay [time] [command]")
  • Property svn:eol-style set to native
File size: 13.8 KB
Line 
1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
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 *   Author:
23 *      Fabian 'x3n' Landau
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29#include "CommandEvaluation.h"
30
31#include "util/StringUtils.h"
32#include "CommandExecutor.h"
33#include "ConsoleCommand.h"
34
35namespace orxonox
36{
37    CommandEvaluation::CommandEvaluation()
38    {
39        this->initialize("");
40    }
41
42    void CommandEvaluation::initialize(const std::string& command)
43    {
44        this->execCommand_ = 0;
45        this->hintCommand_ = 0;
46        this->string_ = command;
47        this->execArgumentsOffset_ = 0;
48        this->hintArgumentsOffset_ = 0;
49        this->bPossibleArgumentsRetrieved_ = false;
50        this->possibleArguments_.clear();
51        this->bEvaluatedParams_ = false;
52        this->bTriedToEvaluatedParams_ = false;
53        this->numberOfEvaluatedParams_ = 0;
54
55        this->tokens_.split(command, " ", SubString::WhiteSpaces, false, '\\', true, '"', true, '(', ')', true, '\0');
56    }
57
58    unsigned int CommandEvaluation::getNumberOfArguments() const
59    {
60        unsigned int count = this->tokens_.size();
61        if (count > 0 && this->string_[this->string_.size() - 1] != ' ')
62            return count;
63        else
64            return count + 1;
65    }
66
67    const std::string& CommandEvaluation::getLastArgument() const
68    {
69        if (this->tokens_.size() > 0 && this->string_[this->string_.size() - 1] != ' ')
70            return this->tokens_.back();
71        else
72            return BLANKSTRING;
73    }
74
75    const std::string& CommandEvaluation::getToken(unsigned int i) const
76    {
77        if (i < this->tokens_.size())
78            return this->tokens_[i];
79        else
80            return BLANKSTRING;
81    }
82
83    int CommandEvaluation::execute()
84    {
85        int error;
86        this->query(&error);
87        return error;
88    }
89
90    MultiType CommandEvaluation::query(int* error)
91    {
92        if (error)
93        {
94            *error = CommandExecutor::Success;
95
96            if (!this->execCommand_)
97                *error = CommandExecutor::Error;
98            else if (!this->execCommand_->isActive())
99                *error = CommandExecutor::Deactivated;
100            else if (!this->execCommand_->hasAccess())
101                *error = CommandExecutor::Denied;
102
103            if (*error != CommandExecutor::Success)
104                return MT_Type::Null;
105        }
106
107        if (this->execCommand_ && this->execCommand_->isActive() && this->execCommand_->hasAccess())
108        {
109            if (!this->bTriedToEvaluatedParams_)
110                this->evaluateParams(false);
111
112            if (this->bEvaluatedParams_)
113            {
114                COUT(6) << "CE_execute (evaluation): " << this->execCommand_->getName() << " with " << this->numberOfEvaluatedParams_ << " params: " << this->param_[0] << ' ' << this->param_[1] << ' ' << this->param_[2] << ' ' << this->param_[3] << ' ' << this->param_[4] << std::endl;
115                switch (this->numberOfEvaluatedParams_)
116                {
117                    case 0:  return (*this->execCommand_->getExecutor())();
118                    case 1:  return (*this->execCommand_->getExecutor())(this->param_[0]);
119                    case 2:  return (*this->execCommand_->getExecutor())(this->param_[0], this->param_[1]);
120                    case 3:  return (*this->execCommand_->getExecutor())(this->param_[0], this->param_[1], this->param_[2]);
121                    case 4:  return (*this->execCommand_->getExecutor())(this->param_[0], this->param_[1], this->param_[2], this->param_[3]);
122                    case 5:
123                    default: return (*this->execCommand_->getExecutor())(this->param_[0], this->param_[1], this->param_[2], this->param_[3], this->param_[4]);
124                }
125            }
126            else
127            {
128                COUT(5) << "CE_execute: " << this->string_ << "\n";
129                return this->execCommand_->getExecutor()->parse(this->tokens_.subSet(this->execArgumentsOffset_), error, " ");
130            }
131        }
132        else
133            return MT_Type::Null;
134    }
135
136    int CommandEvaluation::evaluateParams(bool bPrintError)
137    {
138        this->bTriedToEvaluatedParams_ = true;
139
140        if (!this->execCommand_)
141        {
142            if (bPrintError)
143                COUT(1) << "Error: Can't evaluate params, no console command assigned." << std::endl;
144            return CommandExecutor::Error;
145        }
146
147        int error;
148        this->numberOfEvaluatedParams_ = this->execCommand_->getExecutor()->evaluateParams(this->tokens_.subSet(this->execArgumentsOffset_), this->param_, &error, " ");
149        if (!error)
150            this->bEvaluatedParams_ = true;
151        else if (bPrintError)
152            COUT(1) << "Error: Can't evaluate params, not enough arguments given." << std::endl;
153
154        return error;
155    }
156
157    void CommandEvaluation::setEvaluatedParameter(unsigned int index, const MultiType& param)
158    {
159        if (index < MAX_FUNCTOR_ARGUMENTS)
160            this->param_[index] = param;
161    }
162
163    MultiType CommandEvaluation::getEvaluatedParameter(unsigned int index) const
164    {
165        if (index < MAX_FUNCTOR_ARGUMENTS)
166            return this->param_[index];
167
168        return MT_Type::Null;
169    }
170
171    std::string CommandEvaluation::complete()
172    {
173        if (!this->hintCommand_ || !this->hintCommand_->isActive())
174            return this->string_;
175
176        if (!this->bPossibleArgumentsRetrieved_)
177            this->retrievePossibleArguments();
178
179        if (CommandEvaluation::getSize(this->possibleArguments_) == 0)
180        {
181            return this->string_;
182        }
183        else
184        {
185            std::string output = this->string_.substr(0, this->string_.find_last_of(' ') + 1);
186            output += CommandEvaluation::getCommonBegin(this->possibleArguments_);
187            return output;
188        }
189    }
190
191    std::string CommandEvaluation::hint()
192    {
193        if (!this->hintCommand_ || !this->hintCommand_->isActive())
194            return "";
195
196        if (!this->bPossibleArgumentsRetrieved_)
197            this->retrievePossibleArguments();
198
199        if (!this->possibleArguments_.empty())
200            return CommandEvaluation::dump(this->possibleArguments_);
201
202        if (this->isValid())
203        {
204            return CommandEvaluation::dump(this->hintCommand_);
205        }
206        else
207        {
208            if (this->getNumberOfArguments() > 2)
209            {
210                return std::string("Error: There is no command with name \"") + this->getToken(0) + " " + this->getToken(1) + "\".";
211            }
212            else
213            {
214                std::string groupLC = getLowercase(this->getToken(0));
215                std::map<std::string, std::map<std::string, _ConsoleCommand*> >::const_iterator it_group = _ConsoleCommand::getCommands().begin();
216                for ( ; it_group != _ConsoleCommand::getCommands().end(); ++it_group)
217                    if (getLowercase(it_group->first) == groupLC)
218                        return std::string("Error: There is no command in group \"") + this->getToken(0) + "\" starting with \"" + this->getToken(1) + "\".";
219
220                return std::string("Error: There is no command starting with \"") + this->getToken(0) + "\".";
221            }
222        }
223    }
224
225    void CommandEvaluation::retrievePossibleArguments()
226    {
227        this->bPossibleArgumentsRetrieved_ = true;
228        unsigned int argumentID = std::min(this->getNumberOfArguments() - this->hintArgumentsOffset_, this->hintCommand_->getExecutor()->getParamCount());
229        ArgumentCompleter* ac = this->hintCommand_->getArgumentCompleter(argumentID - 1);
230
231        if (ac)
232        {
233            MultiType param[MAX_FUNCTOR_ARGUMENTS];
234
235            size_t max = this->hintArgumentsOffset_ + this->hintCommand_->getExecutor()->getParamCount();
236
237            for (size_t i = 0; i < argumentID; ++i)
238                param[i] = this->getToken(std::min(this->getNumberOfArguments(), max) - i - 1);
239
240            if (this->getNumberOfArguments() > max)
241            {
242                if (ac->useMultipleWords())
243                {
244                    std::string surplusArguments = this->tokens_.subSet(max - 1).join();
245                    if (this->string_[this->string_.size() - 1] == ' ')
246                        surplusArguments += ' ';
247
248                    this->possibleArguments_ = (*ac)(surplusArguments, param[1], param[2], param[3], param[4]);
249                    CommandEvaluation::strip(this->possibleArguments_, this->getToken(this->getNumberOfArguments() - 1));
250                }
251            }
252            else
253            {
254                this->possibleArguments_ = (*ac)(param[0], param[1], param[2], param[3], param[4]);
255                CommandEvaluation::strip(this->possibleArguments_, param[0]);
256            }
257        }
258    }
259
260    /* static */ void CommandEvaluation::strip(ArgumentCompletionList& list, const std::string& fragment)
261    {
262        std::string fragmentLC = getLowercase(fragment);
263
264        for (ArgumentCompletionList::iterator it = list.begin(); it != list.end(); )
265        {
266            const std::string& entry = it->getComparable();
267
268            if (entry == "")
269            {
270                ++it;
271                continue;
272            }
273
274            if (entry.size() < fragmentLC.size())
275            {
276                list.erase(it++);
277            }
278            else
279            {
280                bool bErase = false;
281                for (size_t i = 0; i < fragmentLC.size(); ++i)
282                {
283                    if (fragmentLC[i] != entry[i])
284                    {
285                        bErase = true;
286                        break;
287                    }
288                }
289
290                if (bErase)
291                    list.erase(it++);
292                else
293                    ++it;
294            }
295        }
296    }
297
298    /* static */ size_t CommandEvaluation::getSize(const ArgumentCompletionList& list)
299    {
300        size_t count = 0;
301        for (ArgumentCompletionList::const_iterator it = list.begin(); it != list.end(); ++it)
302            if (it->getComparable() != "")
303                ++count;
304        return count;
305    }
306
307    /* static */ std::string CommandEvaluation::dump(const ArgumentCompletionList& list)
308    {
309        std::string output;
310        for (ArgumentCompletionList::const_iterator it = list.begin(); it != list.end(); ++it)
311        {
312            output += it->getDisplay();
313
314            if (it->getComparable() != "")
315                output += ' ';
316        }
317        return output;
318    }
319
320    /* static */ std::string CommandEvaluation::dump(const _ConsoleCommand* command)
321    {
322        std::string output = command->getName();
323        if (command->getExecutor()->getParamCount() > 0)
324            output += ": ";
325
326        for (unsigned int i = 0; i < command->getExecutor()->getParamCount(); i++)
327        {
328            if (i != 0)
329                output += ' ';
330
331            if (command->getExecutor()->defaultValueSet(i))
332                output += '[';
333            else
334                output += '{';
335
336            output += command->getExecutor()->getTypenameParam(i);
337
338            if (command->getExecutor()->defaultValueSet(i))
339                output += '=' + command->getExecutor()->getDefaultValue(i).getString() + ']';
340            else
341                output += '}';
342        }
343        return output;
344    }
345
346    /* static */ std::string CommandEvaluation::getCommonBegin(const ArgumentCompletionList& list)
347    {
348        if (CommandEvaluation::getSize(list) == 0)
349        {
350            return "";
351        }
352        else if (CommandEvaluation::getSize(list) == 1)
353        {
354            for (ArgumentCompletionList::const_iterator it = list.begin(); it != list.end(); ++it)
355            {
356                if (it->getComparable() != "")
357                {
358                    if (it->hasDisplay())
359                        return (it->getString());
360                    else
361                        return (it->getString() + ' ');
362                }
363            }
364
365            return "";
366        }
367        else
368        {
369            std::string output;
370            for (unsigned int i = 0; true; i++)
371            {
372                char tempComparable = 0;
373                char temp = 0;
374                for (ArgumentCompletionList::const_iterator it = list.begin(); it != list.end(); ++it)
375                {
376                    const std::string& argumentComparable = it->getComparable();
377                    const std::string& argument = it->getString();
378
379                    if (argumentComparable == "")
380                        continue;
381
382                    if (argument.size() > i)
383                    {
384                        if (tempComparable == 0)
385                        {
386                            tempComparable = argumentComparable[i];
387                            temp = argument[i];
388                        }
389                        else
390                        {
391                            if (tempComparable != argumentComparable[i])
392                                return output;
393                            else if (temp != argument[i])
394                                temp = tempComparable;
395                        }
396                    }
397                    else
398                    {
399                        return output;
400                    }
401                }
402                output += temp;
403            }
404            return output;
405        }
406    }
407}
Note: See TracBrowser for help on using the repository browser.