IBMi (AS400) fans only - Discover the power of the %SPLIT BIF in RPG

By -

In RPG, we often need to manage strings, split them into substrings, and manipulate them efficiently. The %SPLIT BIF is a powerful and useful tool to handle this task.

 

But what exactly is %SPLIT? 🤔

 

%SPLIT

divides a string into multiple parts using a specified delimiter. It can return an array of values based on the delimiter you choose, making it easier to handle complex data or composite strings.

 

Here’s a practical code example to understand it better:

 

 

**FREE
Dcl-s stringa   Varchar(100) Inz('apple,banana,orange');
Dcl-s array     Varchar(20) Dim(10);
Dcl-s delimiter Varchar(1) Inz(',');
Dcl-s i         Int(10); // Index for the loop
// *****************************************************
// PGM start
// *****************************************************

array = %Split(stringa : delimiter);

*inlr = *on;

For i = 1 to %Elem(array);
  Dsply array(i);
EndFor;

 

In this example, the string 'apple,banana,orange' is split into three elements in the array using a comma as the delimiter. Very simple and effective!

 

Here’s a more complex example 

with a different delimiter, like the `|` (pipe) character:

 

**FREE

Dcl-s stringa   Varchar(200) Inz('A|00013582|1|0|GRAFENE SYMON BOUTIQUE|475, AVENUE VICTOR HERNANDEZ| +

75555|PARIS|FR|51| |FR|123456789012|');

Dcl-s array     Varchar(50) Dim(20);

Dcl-s delimiter Varchar(1) Inz('|');

Dcl-s i         Int(10); // Index for the loop

// *****************************************************
// PGM start
// *****************************************************

array = %Split(stringa : delimiter);

*inlr = *on;
For i = 1 to %Elem(array);
  Dsply array(i);
EndFor;


In this case, the string is split using the `|` character, and the extracted data will be:

 1. A
 2. 00013582
 3. 1
 4. 0
 5. GRAFENE SIMON BOUTIQUE
 6. 475, AVENUE VICTOR HERNANDEZ
 7. 75555
 8. PARIS
 9. FR
10. 51
11. (Empty space)
12. FR
13. 123456789012

 

As you can see, %SPLIT simplifies handling complex strings and allows you to work with data more efficiently!

 

Some tips to use it effectively?

What do you think? Have you used %SPLIT in your RPG projects?

Comments

  1. AnonymousSeptember 16, 2024 at 7:03 PM

    The problem with using a CSV string as an example is that the original version of %SPLIT does not handle this well in the real world. Typical CSVs often include "empty" entires like so: ABC,XYZ,,25,,100
    %SPLIT will not process this correctly as it ignores consective delimiters. So that string returns only 4 elements instead of the 6 that are intended (and as Excel for example would treat it)>

    You need to add the new (2023) optional third parameter *ALLSep to have the CSV processed correctly.

    ReplyDelete
    Replies
    1. Aldo SUCCISeptember 17, 2024 at 9:09 AM

      Thank you for pointing that out! You're absolutely correct
      Personally, when dealing with CSV files, I prefer using the command `CPYFRMIMPF`.
      However, `%SPLIT` with the `*ALLSep` parameter now offers an alternative for those who want to handle such data directly within their RPG code.

      Thanks again for your valuable input!

      Best,
      Aldo

      Delete
  2. Aldo SUCCISeptember 19, 2024 at 3:56 PM

    for those who are looking for an alternative to handling CSV files, I have another post on my blog that might interest you. Check out this page

    https://rpgfreeibm.blogspot.com/2021/05/how-to-import-csv-file-into-db2.html

    where I demonstrate how to use the CPYFRMIMPF command to import a CSV file directly into DB2.

    ReplyDelete

Post a Comment

Popular posts from this blog

IBMi (AS400) fans only ' Efficient WRKSPLF with WSF - How to Search string into spooled files, Sort, and Generate PDFs on IBMi

By -
Image
Searching Spooled Files Made Easy: A Unique Solution Managing spooled files efficiently is crucial for users dealing with numerous rows of print data. IBM's WRKSPLF command provides a standard way to interact with spooled files, but it lacks certain features that can significantly enhance user experience. In this article, we'll delve into a powerful functionality that IBM doesn't offer — the ability to search among spooled file lists. Our goal is to highlight the advantages of this capability and introduce a practical solution. The Limitations of Standard WRKSPLF While the WRKSPLF command is a handy tool for working with spooled files, it falls short in certain aspects. One prominent limitation is the inability to search efficiently through the list of spooled file rows. Users often find it challenging to quickly locate specific files based on criteria like creation date, status, or content. Introducing a Unique Solution: WSF (WorkSpooledFiles) To address the limitations of
Read more

IBMi (AS400) fans only - How to Sniff User Access

By -
Image
If you need to monitor user access on your IBM i system, you can use SQL to query the history log. Note: At the end of this post, you'll find a request directly addressed to you, the readers. Here’s a simple example of how you can do this: SELECT MESSAGE_ID,        MESSAGE_TIMESTAMP,        FROM_USER,        MESSAGE_TEXT     FROM TABLE (             QSYS2.HISTORY_LOG_INFO()         )     WHERE message_id IN ('CPF1164', 'CPF1124')           AND FROM_USER IN ('QSECOFR', 'QSYS', 'QSYSOPR')     ORDER BY MESSAGE_TIMESTAMP In this query: - QSYS2.HISTORY_LOG_INFO(): This function retrieves information from the history log. -  message_id IN ('CPF1164', 'CPF1124') : Filters the results to include only specific message IDs, which indicate sign-on and sign-off events. - FROM_USER in ('QSECOFR', 'QSYS', 'QSYSOPR'): Filters the results to include only messages from specific users. Update 28/07/2024: A Smart Enhancem
Read more

IBMi (AS400) fans only ' SQLCODE values: Dear readers, unleash your suggestions!

By -
Image
This RPG code uses a DOU loop to fetch data from a cursor named C1 until the SQLCODE is not equal to 0, indicating the end of the recordset. Inside the loop, it clears a data structure (RecordDsC1), fetches data into it, and then checks if the fetch was successful. If successful, it assigns values and writes to an output file. After the loop, it checks if the SQLCODE is not 100, indicating unexpected termination, and displays a warning message if needed. // Loop until SQLCODE is not equal to 0 dow sqlCode = 0 ;   // Clear the data structure RecordDsC1   clear RecordDsC1;   // Fetch data into RecordDsC1 using cursor C1   exec sql fetch C1 into :RecordDsC1;   // If fetch was successful (SQLCODE = 0)   if sqlcode = 0 ;     // Assign values and write to output     W1QUEU = rDsW1QUEU;     write W1SF1;   endif; enddo; // Check if SQLCODE is not 100 (indicating unexpected termination) if sqlCode <> 100;   // Build a warning message   wMsg='Warning: +    The selection has terminated
Read more