Code Block programming Enhancements

Top 

In addition to the new object oriented coding techniques, many code block variables and functions have been added in this release.  New functions, documented in the Programming Code Blocks chapter, include:

 

•arrset() updates an array with text values at specified positions, similar to the set() and mset() functions that update the page print stream text array
•basename() returns the file name from a full path
•cdate() converts text data into a date value (a Julian number)
•clientenv() now works in subjobs
•cstrans() translates text between two character sets or symbol sets
•deliver() executes a fax or email delivery of a document
•dirname() returns the directory portion of a full path
•entityencode(), entitydecode() encode and decode HTML entity values in text
•fileext() returns the extension of a filename
•fromuc() translates text from unicode
•getaddress() retrieves an address from an address book
•getcolumn() slices a column of fields out of a series of text lines
•getpaircount() returns the number of name=value pairs in a string
•getpairvalue() parses strings of name=value pairs
•getpatternvalue() locates text patterns in text strings or arrays
•imgx(), imgy() returns an images width and height
•logwarn() logs a message to the warning messages written to a job's temp/*.err file and to the design tool
•pdfpages() returns the  number of pages in a PDF file
•putaddress() writes an entry into an address book
•setlogin() sets login/password values when using the library object
•tempfile() generates a temporary file that is automatically removed when the job completes
•textimage() generates an image with unicode text, using Image Magick
•touc() translates text to unicode

 

New variables include:

 

•coverargs$ specifies command line options for a cover page subjob
•coverfile$ names a rule file containing coverset$
•coverset$ sets a rule set to use for a cover page
•nocover=1 turns off cover page generation
•noemail=1 turns of the email command
•uf.parent contains the job ID of the parent job, helpful for logging
•uf.login$ contains the -arclogin user ID