PeopleCode

Supported Functions

PeopleCode supports the following types of functions:

Built-in: The standard set of PeopleCode functions. These can be called without being declared.

Internal: Functions that are defined (using the Function statement) within the PeopleCode program in which they are called.

External PeopleCode: PeopleCode functions defined outside the calling program. These are generally contained in record definitions that serve as function libraries.

External non-PeopleCode: Functions stored in external (C-callable) libraries.

In addition, PeopleCode supports methods. The main differences between a built-in function and a method are:

-A built-in function, in your code, is on a line by itself, and does not (generally) have any dependencies.

-You do not have to instantiate an object before you can use the function.

-A method can only be executed by an object (using dot notation).

-You must instantiate the object first.

Describing Application Class Structure

Import any classes that will be used by a class, including the superclass this class extends

Import PackageName:Superclassname;

A class is defined using the Class construct.

Class Classname [Extends SuperClassname] [Method_declarations] [Property_declarations] [Private [Method_declaration] [Instance_decalarion] Constant declaration End-class;

The first set of declarations are the properties and methods that are part of the public, external interface.

Property datatype PropertyName [get][set]; Method MethodName ([parameter_list])

The private instance variables, constants, and the methods are declared following the keyword Private.

Private Instance DataType &InstanceName; Constant &Constant = {Number | String | True | False | Null };

The keyword end-class follows the declarations of properties, methods, instances, and constants.

After the end-class keyword and before get and set definitions or method definitions, declare any variable and functions that will be used by methods.

Get and set methods corresponds to properties declared with the get and set keywords.

Use a get method definition to execute PeopleCode that will return a value.

get Propertyname Return &Value; end-get;

Use a set method definition to execute PeopleCode that will change a value.

set PropertyName end-set;

Method definitions are similar to function definitions.

method Methodname statements; end-method;

A special case of a method definition is the constructor.

A constructor has the same name as the class and will always run when the class is instantiated.

A class that does not extend some other class does not need any constructor.

A class that does extend another class must have a constructor, and in the constructor, it must initialize its superclass.

Executing SQL in PeopleCode

Where a SQLExec(built-in function) only delivers a single row, using the SQL class you can retrieve and process multiple rows.

Instantiate a SQL object with the CreateSQL built-in function.

Use CreateSQL("SQLString") when you pass a text string to your SQL object.

Use GetSQL(SQL.sqlname) when you get the SQL from a SQL definition.

&SQL = CreateSQL("SQL Statement",[bind values]);

You can also choose to omit the values for the bind variables and supply those values later. For Insert, Update, or Delete commands these values would be supplied using Execute method. (If you supply all the necessary input values, the SQL is executed immediately.)

&SQL = CreateSQL("SQL Statement"); &SQL.Execute([bind_values]);

For a SQL object containing a Select statement, the Fetch method is used to retrieve the next row from the cursor.

PeopleCode Functions, retrieved 2008-12-14