LSL 101/String Concatenation

From Second Life Wiki
Jump to: navigation, search
← Strings and Simple Output ↑̲  LSL 101  ̲↑ Integers →

String concatenation allows us to combine two or more strings into a single string, as if they were simply pasted together. Here's an example where we use string concatenation to put the region name into a complete sentence.

default
{
     state_entry()
     {
          // Let the object's owner know the script is working
          llOwnerSay( "Congratulations! Your script has started to execute." );
     }
 
     touch_start( integer num_detected )
     {
          // Announce the region where the script is running
          llOwnerSay( "Welcome to " + llGetRegionName() + "." );
     }
}

The + sign, when used with strings, indicates concatenation. This is analogous to the use of + with integers to denote integer addition.

As in the previous example, the server executes llGetRegionName and reduces the line to the equivalent of

    llOwnerSay( "Welcome to " + "Ganymede" + "." );

It then concatenates the three strings, so it is equivalent to

    llOwnerSay( "Welcome to Ganymede." );

You might be thinking that an alternative to using string concatenation could be

    llOwnerSay( "Welcome to ", llGetRegionName(), "." );

But this won't work, because llOwnerSay expects only one string. Another alternative,

    llOwnerSay( "Welcome to ");
    llOwnerSay( llGetRegionName() );
    llOwnerSay( "." );

is legal, but it produces three separate lines of chat instead of one.

Even if everything you read here seems completely clear, your understanding will be much better if you actually write scripts as you go along. So here's a suggested exercise. The built-in function llGetDate returns a string representing today's date. Write and test a script that announces the date whenever it is clicked on.

Proceed onward to Integers or go back to Strings and Simple Output.