Code Snippets

Split strings using a delimiter

Verified

Added by iNTERFACEWARE

Use the string.split() function to split a string into parts separated by a specified delimiter

Source Code

   -- split the message into individual lines "\r" separator
   local r = msg:split('\\r')
   trace(r) 

   -- allow for the \n added because we split the msg declaration over multiple lines (above)
   local r = msg:split('\\r\n')
   trace(r) 

   -- split the message into fields "|" separator
   local r = msg:split('|')
   trace(r)

Description

Use the string.split() function to split a string into parts separated by a specified delimiter

Usage Details

Use string.split() to break a string into multiple parts using a specified separator. We used an HL7 message as an example. When we declared the string the editor added newlines (\n) so our first split contained \n at the start of the split strings (which we did not want). Our second split allows for this by specifying the newline as part of the separator.

How to use the snippet:

Paste the split code into your script

Note: You may also be interested in the splitText() function which can be use to split a long reports into chunks of a specified length.

More Information

• string.split
• How to split a long report into separate fields - see splitText() function
• string - other string functions

Update a database

Added by iNTERFACEWARE

Code Snippets

Use conn:execute() to update a database table

Set file permissions

Added by iNTERFACEWARE

Code Snippets

Use os.fs.chmod() to set file permissions, using octal mode (symbolic mode does not work)

Get a child node by name

Added by iNTERFACEWARE

Code Snippets

Use node.child() to return the node of the specified name, works for all node types

Create a bzip2 or gzip file

Added by iNTERFACEWARE

Code Snippets

How to create and unzip a bzip2 or gzip file, using filter.bzip2.deflate() and filter.bzip2.inflate() or gzip.deflate() and gzip.inflate()

Raise an error

Added by iNTERFACEWARE

Code Snippets

Use the error() function to raise an error and write it to the logs

Merge into a database

Added by iNTERFACEWARE

Code Snippets

Use conn:merge{} to merge data into a database

Delete a file or directory

Added by iNTERFACEWARE

Code Snippets

Use os.remove() to delete a file or directory, only an empty directory can be deleted

Count child nodes

Added by iNTERFACEWARE

Code Snippets

Use node.childCount() to count the number of children for a specified node, works for all node types

Using hex encoding

Added by iNTERFACEWARE

Code Snippets

How to encode and decode strings with hex, using filter.hex.enc() and filter.hex.dec()

Creating log entries

Added by iNTERFACEWARE

Code Snippets

How to create Error, Warning, Informational, and Debug log entries

Prevent code from running in the editor

Added by iNTERFACEWARE

Code Snippets

Use iguana.isTest() to prevent code from running in the editor

Delete a directory

Added by iNTERFACEWARE

Code Snippets

Use os.fs.rmdir() to delete an empty directory, if the directory is not empty an error is returned

Check if a node is a primary key

Added by iNTERFACEWARE

Code Snippets

Use node.isKey() to check if a node is the primary key for a database table, this method only for table node trees

Using html encoding

Added by iNTERFACEWARE

Code Snippets

How to encode strings with html special characters, using filter.html.enc()

Read from a file

Added by iNTERFACEWARE

Code Snippets

How to open and read a file from disk, either one line at a time, or read the whole file at once

Prevent code from running in a live channel

Added by iNTERFACEWARE

Code Snippets

Use iguana.isTest() to allow code to run in the editor but not in the live channel

Create a directory

Added by iNTERFACEWARE

Code Snippets

Use os.fs.mkdir() to create a directory

Check if a node is a leaf node

Added by iNTERFACEWARE

Code Snippets

Use node.isLeaf() to check if a node is a leaf node (has no children), works for all node types

Using uri encoding

Added by iNTERFACEWARE

Code Snippets

Encode and decode strings for use in uri/url, using filter.uri.enc() and filter.uri.dec()

Conversion to string or number

Added by iNTERFACEWARE

Code Snippets

How to convert numbers and node trees to a to string representation, and how to convert a numeric strings to numbers

Code Repository

Split strings using a delimiter