dragonleo/NSIS
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Some tidying and documentation.

Browse source 
git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@3280 212acab6-be3b-0410-9dea-997c60f758d6
This commit is contained in:
eccles 2003-12-14 01:13:32 +00:00
parent 009e409276
commit 2d8918e586
2 changed files with 53 additions and 95 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Examples/LogicLib.nsi
View file

@ -1,9 +1,9 @@
Name "NSIS LogicLib Example"
OutFile "example.exe"
OutFile "LogicLib.exe"
ShowInstDetails show
!include "sections.nsh"
!include "logiclib.nsh"
!include "Sections.nsh"
!include "LogicLib.nsh"
;!undef LOGICLIB_VERBOSITY
;!define LOGICLIB_VERBOSITY 4 ; For debugging - watch what logiclib does with your code!

142
Include/LogicLib.nsh
View file

@ -9,100 +9,58 @@
; Description:
; Provides the use of various logic statements within NSIS.
;
; Notes:
; Version 2 is a complete rewrite of the original. Here are some of the major differences:
; - Structure redesign based upon version by eccles.
; - No statement limitations.
; - Following statements are now available.
; if/unless..elseif/unless..else..endif/unless
; - Conditionally executes a group of statements, depending on the value of an expression.
; ifthen..|..|
; - Conditionally executes an inline statement, depending on the value of an expression.
; ifcmd..||..|
; - Conditionally executes an inline statement, depending on a True value of the provided NSIS function.
; select..case..case2..case3..case4..case5..caseelse..endselect
; - Executes one of several groups of statements, depending on the value of an expression.
; switch..case..default..endswitch
; - As above but with C-like features and behaviour.
; for..exitfor..continue..break..next
; - Repeats a group of statements a specified number of times.
; foreach..exitfor..continue..break..next
; - Repeats a group of statements a specified number of times stepping in order specified.
; do..exitdo..continue..break..loop
; - Repeats a block of statements until stopped.
; dowhile..exitdo..continue..break..loop
; - Repeats a block of statements while a condition is True.
; dountil..exitdo..continue..break..loop
; - Repeats a block of statements until a condition is True.
; do..exitdo..continue..break..loopwhile
; - Repeats a block of statements while a condition is True.
; do..exitdo..continue..break..loopuntil
; - Repeats a block of statements until a condition is True.
; while..exitwhile..continue..break..endwhile
; - Same as dowhile..loop.
;
; Usage:
; See example.nsi
; The following "statements" are available:
; If|Unless..{ElseIf|ElseUnless}..[Else]..EndIf|EndUnless
; - Conditionally executes a block of statements, depending on the value
; of an expression.
; IfThen..|..|
; - Conditionally executes an inline statement, depending on the value
; of an expression.
; IfCmd..||..|
; - Conditionally executes an inline statement, depending on a true
; value of the provided NSIS function.
; Select..{Case[2|3|4|5]}..[CaseElse|Default]..EndSelect
; - Executes one of several blocks of statements, depending on the value
; of an expression.
; Switch..{Case|CaseElse|Default}..EndSwitch
; - Jumps to one of several labels, depending on the value of an
; expression.
; Do[While|Until]..{ExitDo|Continue|Break}..Loop[While|Until]
; - Repeats a block of statements until stopped, or depending on the
; value of an expression.
; While..{ExitWhile|Continue|Break}..EndWhile
; - An alias for DoWhile..Loop (for backwards-compatibility)
; For[Each]..{ExitFor|Continue|Break}..Next
; - Repeats a block of statements varying the value of a variable.
;
; History:
; 1.0 - 09/19/2003 - Initial release.
; 1.1 - 09/20/2003 - Added simplified macros and removed NAME requirement.
; 1.2 - 09/21/2003 - Changed library name to LogicLib.
; - Allow for 5 statements deep without use of name variable.
; - Added If..ElseIf..Else..Endif statements.
; 1.3 - 09/22/2003 - Fixed maximum allow statements.
; - Now allows 10 statement depth.
; - Condensed code.
; 2.0 - 10/03/2003 - Inital release 2, see notes.
; 2.1 - 10/05/2003 - Added continue and break labels to repeat type statements.
; 2.2 - 10/07/2003 - Updates by eccles
; - Simplified IfThen by utilising If and EndIf.
; - Simplified For by utilising ForEach.
; - Fixed ForEach missing the final iteration.
; - Fixed a couple of Break/Continue bugs.
; 2.3 - 12/10/2003 - Much reworking and refactoring of things to help reduce
; duplication, etc. E.g. all loop varieties now go through
; a common set of macros.
; - Added built-in support for the rest of NSIS's built-in
; conditional tests (Abort, Errors, FileExists, RebootFlag,
; Silent).
; - Added ability to use any NSIS conditional command in a
; normal If type statement (no longer restricted to the
; specialised IfCmd statement).
; - Optimised the code produced by If (fewer Goto's).
; - Added statement similar to If that works in reverse:
; "Unless" executes the code in the contained block if the
; condition is false. If, Unless, ElseIf, ElseUnless, EndIf
; and ElseUnless can be used freely in any combination.
; - Fixed bug where using Continue in a Do..LoopUntil loop
; went to the top of the loop and not the loop condition.
; - Added DoWhile..Loop and Do..LoopWhile loop varieties (the
; existing While..EndWhile loop is still available and is
; identical to DoWhile..Loop).
; - Optimised the code prodiced by Select (fewer Goto's).
; - Renamed Case_Else to CaseElse (nothing else has an
; underscore so why should that one). The old name is still
; available too though (if you must).
; - CaseElse can also be called Default (for the C-minded).
; 2.4 - 12/13/2003 - Added Switch..Case*/Default..EndSwitch: similar to Select
; but behaves just like the C version. I.e.:
; - Each Case is more like a label than a block so
; execution "falls through" unless you use Break.
; - CaseElse (or Default) does not have to be the final
; case.
; - Case*/Default can appear anywhere inside the Switch
; (e.g. inside an If inside the Switch).
; (With thanks to kichik for the idea and proof-of-concept
; model).
; - Added unsigned integer comparisons U<, U>=, U> and U<=.
; - Added 64-bit integer comparisons L=, L<>, L<, L>=, L> and
; L<= (these use System.dll).
; - Added case-sensitive string tests S== and S!= (these use
; System.dll).
; - Added string comparisons (not case sensitive) S<, S>=, S>
; and S<= (these use System.dll).
; - Added section flag tests (SectionIsSelected, etc.) (to
; use these your script must include sections.nsh).
; The following "expressions" are available:
; Standard (built-in) string tests (which are case-insensitive):
; a == b; a != b
; Additional case-insensitive string tests (using System.dll):
; a S< b; a S>= b; a S> b; a S<= b
; Case-sensitive string tests (using System.dll):
; a S== b; a S!= b
; Standard (built-in) signed integer tests:
; a = b; a <> b; a < b; a >= b; a > b; a <= b
; Standard (built-in) unsigned integer tests:
; a U< b; a U>= b; a U> b; a U<= b
; 64-bit integer tests (using System.dll):
; a L= b; a L<> b; a L< b; a L>= b; a L> b; a L<= b
; Built-in NSIS flag tests:
; ${Abort}; ${Errors}; ${RebootFlag}; ${Silent}
; Built-in NSIS other tests:
; ${FileExists} a
; Any conditional NSIS instruction test:
; ${Cmd} a
; Section flag tests:
; ${SectionIsSelected} a; ${SectionIsSubSection} a;
; ${SectionIsSubSectionEnd} a; ${SectionIsBold} a;
; ${SectionIsReadOnly} a; ${SectionIsExpanded} a;
; ${SectionIsPartiallySelected} a
;
; Examples:
; See LogicLib.nsi in the Examples folder for lots of example usage.
!verbose push
!verbose 3