Stringlist methods syntax

The syntax for each of the Stringlist class methods is shown below.

Square brackets indicate optional elements of the method invocation. See also the notation conventions for methods and the List of Stringlist methods.

[%number=] sl:Add( string)

[%number=] sl:AddImage[( [imageName])]

[%number=] sl:AddOrdered( string)

[%number=] sl:AddOrderedUnique( string)

[%number=] sl:AddUnique( string)

[%number=] sl:AddUniqueOrdered( string)

[%rc=] sl:AppendCertificateInfo[( [certificate])]

[%rc=] sl:AppendCertificateRequest( [PrivateKey=] stringlist, - [[Country=] string], [[State=] string], - [[City=] string], - [[Organization=] string], - [[OrganizationalUnit=] string], - [[CommonName=] string])

[%rc=] sl:AppendCertificateRequestInfo( certificateRequest)

[%rc=] sl:AppendClientCertificateRequest( [PrivateKey=] stringlist, - [[Country=] string], - [[State=] string], - [[City=] string], - [[Organization=] string], - [[OrganizationalUnit=] string], - [[CommonName=] string], - [[Challenge=] string])

sl:AppendEncryptedSecurityData( sl, [Password=] string, - [[Identifier=] string])

[%count=] sl:AppendFieldImages[( [Image= string], [FirstOccurrence= number], - [MaxOccurrences= number], [Options= string], - [NullValue= string])]

[%count=] sl:AppendFieldValues[( [NameLength= number], [Fieldname= string], - [Options= string])]

sl:AppendGeneratedPrivateKey[( [[Length=] number], [[Exponent=] number], - [[Salt=] string])]

[%rc=] sl:AppendJournalData[( [[StartTime=] string], [[EndTime=] string], - [[Threads=] string], [[Options=] string], - [[Journal=] journal])]

[%rc=] sl:AppendOpenProcedure[( [numLines], [seqIncrement])]

[%number=] sl:AppendPrivateKeyInfo[( [sl], [[Password=] string])]

[%rc=] sl:AppendProcedureList( file, [pname], [accnt], [date])

[%rc=] sl:AppendSignedCertificate( [PrivateKey=] stringlist, - [Request=] stringlist, - [[Signer=] stringlist], - [[StartDate=] string], - [[EndDate=] string], - [[SerialNumber=] number])

[%rc=] sl:AppendSignedClientCertificate( [PrivateKey=] stringlist, - [Request=] stringlist, - [Signer=] stringlist, - [[StartDate=] string], - [[EndDate=] string], - [[SerialNumber=] number])

[%rc=] sl:AppendSirfactCommandOutput( command)

[%rc=] sl:AppendSirfactData( dataList)

[%count=] sl:AppendTrace[( [parms])]

%string= sl:BinaryProcedureDecode

sl:BinaryProcedureEncode( string, [base64Flag])

sl:BindImage( imageName)

[%rc=] sl:ChangeItemLength( itemNum, length)

%rc= sl:CheckCertificate( [PrivateKey=] stringlist, [[Password=] string])

%rc= sl:CheckCertificateRequest( [PrivateKey=] stringlist, - [[Password=] string])

[%outList=] sl:Compare( inList, [syncCount], [pad])

%outList= sl:Copy

sl:CopyImageBinding( boundList)

[%count=] sl:CopyItems( inList, [startItem], [numItems])

%count= sl:Count

%string= sl:CreateLines[( [delim], [AddTrailingDelimiter= boolean])]

%outList= sl:DeepCopy

[%string=] sl:Dequeue

sl:Empty

[%count=] sl:Enqueue( string)

%number= sl:Find( string, [startItem])

%number= sl:FindImageItem( imageItem, [searchValue], [startItem], [operator])

%number= sl:FindImageItemUp( imageItem, [searchValue], [startItem], - [operator])

%number= sl:FindUp( string, [startItem])

%string= sl:FirstItem

sl:GetImage( itemNum, [imageName])

[%count=] sl:Insert( itemNum, string)

[%count=] sl:InsertImage( itemNum, [imageName])

%string= sl:Item( itemNum)

%outList= sl:ItemDifferenceList( sl1, itemNum, [separator])

%length= sl:ItemLength( itemNum)

%string= sl:LastItem

%newList= %(Stringlist):List( itemList)

%count= sl:ListToItem( strList2, itemNum, [separator])

%itemNum= sl:Locate( string, [start], [startCol], [endCol], [caseFlag])

%itemNum= sl:LocateUp( string, [start], [startCol], [endCol], [caseFlag])

%max= %(Stringlist):MaxItemLength

sl:MoveFromId( listId)

sl:MoveToId( listId)

%sl= %(Stringlist):New[( [imageName])]

[%rc=] sl:Overlay( itemNum, [startCol], string)

sl:OverlayImageItem( itemNum, imageItem, [value])

sl:ParseLines( string, [delims], [StripTrailingNull= boolean])

%updList= sl:Patch( patchList, [Options= string])

%updList= sl:PatchLines( baseList, [Options= string])

%updString= sl:PatchString( baseString, [Options= string])

[%string=] sl:Pop

[%count=] sl:Print[( [[NumWidth=] number], [[LenWidth=] number], - [[Start=] number], [[MaxItems=] number])]

[%count=] sl:Push( string)

[%rc=] sl:RegexCapture( string, regex, [Options= string], [Status= %output])

[%itemNum=] sl:RegexLocate( regex, [startItem], [Options= string], - [Status= %output], [StartCol= number], - [EndCol= number])

[%itemNum=] sl:RegexLocateUp( regex, [startItem], [Options= string], - [Status= %output], [StartCol= number], - [EndCol= number])

%outString= sl:RegexReplaceCorresponding( inString, replacementList, - [Options= string], - [Status= %output])

[%number=] sl:RegexSplit( inString, regex, [Options= string], - [Status= %output], [Add= regexSplitOutputOptions])

%subsetList= sl:RegexSubset( regex, [Options= string], [Status= %output], - [StartCol= number], [EndCol= number])

[%count=] sl:RemoveItem( itemNum)

[%rc=] sl:Replace( number, string)

[%rc=] sl:ReplaceImage( itemNum, [imageName])

sl:Sort( sortOrder, [pad])

%outList= sl:SortNew( sortOrder, [pad])

%outList= sl:Subset( string, [startCol], [endCol], [caseFlag])

%outList= sl:SubsetImageItem( imageItem, [searchValue], [operator])

sl:UnbindImage

%outList= sl:Update( updList, [%status])