| Both sides previous revision Previous revision Next revision | Previous revisionLast revisionBoth sides next revision |
| scripting:start [2015/11/05 10:46] – [Advanced techniques] gawrilow | scripting:start [2019/01/25 09:27] – ↷ Links adapted because of a move operation oroehrig |
|---|
| |
| Special variables residing in the global package such as ''$_'', ''@_'', ''@ARGV'', ''@INC'', ''%ENV'', ''%SIG'', etc. don't need to be declared. The package inheritance list ''@ISA'' and sort placeholders ''$a'' and ''$b'' are also exempt from declaration. | Special variables residing in the global package such as ''$_'', ''@_'', ''@ARGV'', ''@INC'', ''%ENV'', ''%SIG'', etc. don't need to be declared. The package inheritance list ''@ISA'' and sort placeholders ''$a'' and ''$b'' are also exempt from declaration. |
| | |
| | Variables can also be declared temporarily in scripts loaded by operator ''do'': |
| | <code>declare local $bla=123;</code> |
| | After the script has been executed, the variable disappears as if it were never declared, so that this script or other ones reusing the same variable name can safely be loaded again. However, if the variable was already declared persistently beforehand, the effect of such local declaration is equivalent to a standard perl ''local'' operator, that is, its value will be temporarily changed but not the declaration status. Please beware that this is a quite exotic feature introduced primarily for testing purposes. In most cases, one-shot scripts should only create lexical variables and avoid injecting new names in namespaces. |
| |
| === Name lookup === | === Name lookup === |
| .. All ''local_XXX'' functions described above can be used in the block ''begin_locals'' .. ''end_locals'' too. | .. All ''local_XXX'' functions described above can be used in the block ''begin_locals'' .. ''end_locals'' too. |
| .. There is one session-scope guard dwelling in the variable ''$Polymake::Scope'' (aka ''$Scope'' due to namespace lookup rules). Its lifetime ends with the complete interpretation of the current input line in the interactive shell, or complete execution of the script started in [[#calling|batch mode]]. This guard is used, among others, by [[:general#preferences|prefer_now]] commands, as well as for purging temporary properties from the objects. | .. There is one session-scope guard dwelling in the variable ''$Polymake::Scope'' (aka ''$Scope'' due to namespace lookup rules). Its lifetime ends with the complete interpretation of the current input line in the interactive shell, or complete execution of the script started in [[#calling|batch mode]]. This guard is used, among others, by [[:general#preferences|prefer_now]] commands, as well as for purging temporary properties from the objects. |
| |
| === Classes === | |
| |
| ===== Most important interfaces ===== | ===== Most important interfaces ===== |
| ==== Complex objects ==== | ==== Complex objects ==== |
| |
| Some more complex objects like Graphs or Polynomials are also wrapped for directed use from perl code. Please refer to the release documentation and the [[tutorial:start|tutorials]] for more details. | Some more complex objects like Graphs or Polynomials are also wrapped for directed use from perl code. Please refer to the release documentation and the [[user_guide:start|tutorials]] for more details. |
| ===== Debugging ===== | ===== Debugging ===== |
| |