The Silver Lining

Lessons & Learnings from a salesforce certified technical architect.

Lists of SObjects and Classes – By value or reference?

with 3 comments

I found a quirky bug in my code some time back, and realised that the cause of the bug was quite a useful Apex feature viz. SObjects and Apex classes are passed by reference and not value.

What does this mean you say? Let’s start by defining what passing by value means.

In a nutshell, if you pass a variable to a method and it’s a primitive type(Integer, String etc.) it will be passed by value meaning that the value of the variable and not the variable itself is passed to the method e.g.

String val = ‘Hello’;
public void byValue(String v){
v = ‘Goodbye’;
System.debug(‘New value is ‘+val);

String val = ‘Hello’;

public void byValue(String v){

System.debug(‘Value in: ‘+v);

v = ‘Goodbye’;

System.debug(‘Value out: ‘+v);



System.debug(‘Value of val: ‘+val);

Executing this piece of code(perhaps as an anonymous block) would give the following,

Value in: Hello

Value out: Goodbye

Value of val: Hello

As can be seen here, when a variable is passed by value, any changes to the variable within the method are lost after the method execution completes.

The contrary is true when working with SObjects and Apex classes e.g.

public class Value{

public String name{get;set;}

public Value(String n){

name= n;



Value val = new Value(‘Hello’);

public void byReference(Value v){

System.debug(‘Value in: ‘; = ‘Goodbye’;

System.debug(‘Value out: ‘;



System.debug(‘New value is: ‘;

This code yields,

Value in: Hello

Value out: Goodbye

New value is: Goodbye

Meaning that any changes that are made to the class(or SObject) within the method are retained even after the method finishes executing. This is passing by reference my friend and it’s used because it’s more efficient to pass pointers-to-memory-locations around than it is to pass entire objects(or lists of objects) around.

Not knowing this can be quite frustrating and I’m not sure how developers without a background in Java or C++ might realise their code is working according to these rules(Yeah I know they can RTM but how would they know what to look for huh?). That said this functionality, if used correctly, can make your code quite neat.

This might serve as a useful example:

You have a list of SObjects that you need to wrap in order to add some extra functionality to a page. You might decide to implement this so,

1. Fetch a list of records from database.

2. Create a list of wrappers using the records.

3. Display wrappers on page.

4. User edits records and clicks a ‘Save’ button.

5. Your save method fetches the records out of the wrappers and puts them into another list. It then saves this list of records.

Lo-and-behold! Armed with our new knowledge of passing by reference we now know that Step 5 is unnecessarily verbose. We replace it with,

5. Save the list you fetched in Step 1.

And we’re done! The SObjects in the first list are precisely the same as the SObjects within the list of wrappers. Well sort of. This is a bit of an educated guess but I think neither list actually ‘has’ any SObjects, instead they contain pointers to memory locations. This would be quite a bit quicker than passing the entire objects around your application and it pretty fantastic.

If you have any other situations where passing by reference might be valuable I’d be keen to hear about them.


Written by Wes

August 3, 2009 at 12:48 pm

3 Responses

Subscribe to comments with RSS.

  1. Thanks, I’m one of these: “…developers without a background in Java or C++ might realise their code is working according to these rules” and your explanation is simple yet incredibly clear. Thanks again.

    Bertie Davel

    September 16, 2009 at 9:14 am

  2. Just as a note to this I was trying to retain the values for primitive type(Integer, String etc.) when I passed them into a sub function. As you said the values when not returning to the original function. To get round this I had to declare the primitive type variables a private global variables so that the values are retained after processing has happened in the sub function.

    PS love the articles.


    January 8, 2010 at 11:55 am

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: