LSL 101/String Concatenation

← Variables

↑̲  LSL 101  ̲↑

Functions →

---

LSL 101: The Wikibook

• A Gentle Introduction
• The Structure of a Script
  • Simple Script Skeleton
  • Comments, White-space and Formatting
• Events & Event Handlers
  • The touch start Event
• Variables
  • Strings and Simple Output
    • String Concatenation
  • Integers
  • Using Variables
    • Global vs Local Variables
    • Variable Initialization
• Functions
  • Functions That Return a Value

The End Game

• Creating a Script
• Compile Time Errors
• Logic
• Conclusion

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.

<lsl>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() + "." );
    }

}</lsl>

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.

Go back to Variables or proceed onward to Functions.