Make Quoted String

Summary

The following are the RPG/LE fully free-form definitions and instructions needed for using the Make Quoted String service procedure. This service procedure simply allows the caller to create a single-quoted string out of another character string that may or may not have embedded single quotes in it.

Rule of Thumb

Sometimes, having a service procedure is simply a means of making code more self-documenting (i.e., easier for others to understand).

Service Prototype

Place the following in a separate copybook for inclusion in both the caller and the service program source members.

**free

//==============================================================================
// This procedure returns the supplied string as a single-quoted string
// with any embedded single-quotes appropriately doubled.
//==============================================================================
dcl-pr GenUtl_MakeQuotedString    varchar(4096) rtnparm;
  pString                         varchar(3000) const;
end-pr;

Service Procedure

Place the following in a service program source member.

**free
ctl-opt NoMain AlwNull(*UsrCtl) Debug Option(*SrcStmt:*NoDebugIo)
        DatFmt(*ISO) TimFmt(*ISO) DftActGrp(*No) ActGrp(*Caller);

//==============================================================================
// This procedure returns the supplied string as a single-quoted string
// with any embedded single-quotes appropriately doubled.
//==============================================================================
dcl-proc GenUtl_MakeQuotedString  export;
  dcl-pi *n                       varchar(4096) rtnparm;
    pString                       varchar(3000) const;
  end-pi;

  return ( ''''
         + GenUtl_ScanAndReplace('''': %trimr(pString): '''''')
         + '''' );                     // return resulting entry
end-proc;

References

• GenUtl_ScanAndReplace service procedure