https://nsis.sourceforge.io/mediawiki/index.php?action=history&feed=atom&title=StrCount
StrCount - Revision history
2026-08-13T04:26:11Z
Revision history for this page on the wiki
MediaWiki 1.39.17
https://nsis.sourceforge.io/mediawiki/index.php?title=StrCount&diff=23194&oldid=prev
Seki: creation
2013-04-24T09:58:20Z
<p>creation</p>
<p><b>New page</b></p><div>{{PageAuthor|seki}}<br />
<br />
== Description ==<br />
<br />
'''Requires:''' [[LogicLib header file]].<br />
<br />
'''Version:''' 1.0.<br />
<br />
This function returns the number of occurrences of a substring (that can be a single character) in a string.<br />
<br />
== How To Use ==<br />
<br />
=== Syntax ===<br />
<br />
<highlight-nsis><br />
${StrCount} String SubString sensitiveness<br />
Pop ResultVar<br />
</highlight-nsis><br />
or<br />
<highlight-nsis><br />
Push String<br />
Push SubString<br />
Push sensitiveness<br />
Call StrCount<br />
Pop ResultVar<br />
</highlight-nsis><br />
<br />
=== Parameters ===<br />
<br />
; String<br />
: The string where we want to search for ''SubString''.<br />
<br />
; SubString<br />
: Character(s) to find in ''String'', a single char or a substring.<br />
<br />
; sensitiveness<br />
: can be ''s'' for a case-sensitive search or anything else for case-insensitive search.<br />
<br />
; ResultVar<br />
: The variable that will get the number of occurrences.<br />
<br />
=== Examples ===<br />
<br />
<highlight-nsis><br />
Push AbABABa<br />
Push Ba<br />
Push "i"<br />
Call StrCount<br />
Pop $0 ;$0=3<br />
</highlight-nsis><br />
<br />
<highlight-nsis><br />
${StrCount} abcdefcd c i<br />
Pop $0 ;$0=2<br />
</highlight-nsis><br />
<br />
== Function Code ==<br />
<br />
<highlight-nsis><br />
!define StrCount "!insertmacro StrCount"<br />
<br />
!macro StrCount str look si<br />
Push ${str}<br />
Push ${look}<br />
Push ${si}<br />
Call StrCount<br />
!macroend<br />
<br />
Function StrCount <br />
;takes the following parameters by the stack:<br />
; case sensitive ('s') or insensitive<br />
; string to lookup<br />
; string where to search<br />
<br />
Exch $2 ;Stack = ($2 test str)<br />
Exch ;Stack = (test $2 str)<br />
Exch $1 ;Stack = ($1 $2 str)<br />
Exch ;Stack = ($2 $1 str)<br />
Exch 2 ;Stack = (str $1 $2)<br />
Exch $0 ;Stack = ($0 $1 $2)<br />
Exch 2 ;Stack = ($2 $1 $0) just to pop in natural order<br />
Push $3<br />
Push $4<br />
Push $5 <br />
Push $6 ;Stack = ($6 $5 $4 $3 $2 $1 $0)<br />
<br />
StrLen $4 $1 <br />
StrCpy $5 0<br />
StrCpy $6 0<br />
<br />
;now $0=str, $1=test, $2=s/i, $3=tmp str, $4=lookup len, $5=index, $6=count<br />
<br />
loop:<br />
StrCpy $3 $0 $4 $5<br />
StrCmp $3 "" end<br />
${if} $2 == 's'<br />
StrCmpS $3 $1 count ignore<br />
${else}<br />
StrCmp $3 $1 count ignore<br />
${endif}<br />
count:<br />
IntOp $6 $6 + 1 ;count++<br />
ignore:<br />
IntOp $5 $5 + 1 ;index++<br />
goto loop<br />
end:<br />
<br />
Exch 6 ;Stack = ($0 $5 $4 $3 $2 $1 $6)<br />
Pop $0<br />
Pop $5<br />
Pop $4<br />
Pop $3<br />
Pop $2<br />
Pop $1 ;Stack = ($6)<br />
Exch $6 ;count is on top stack<br />
FunctionEnd<br />
</highlight-nsis><br />
<br />
== Versions History ==<br />
<br />
;1.0<br />
:Initial release.<br />
<br />
== Credits ==<br />
Author: Sébastien Kirche ([[User:seki|seki]]).<br><br />
Wiki page based on [[StrTok function|StrTok]] documentation.<br />
<br />
[[Category:String Functions]]</div>
Seki