GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing en.wikipedia.org — String interpolation - Wikipedia

In computer programming, string interpolation (or variable interpolation, variable substitution, or variable expansion) is the process of evaluating a string literal containing one or more placeholders, yielding a result in which the placeholders are replaced with their corresponding values. It is a form of simple template processing^[1] or, in formal terms, a form of quasi-quotation (or logic substitution interpretation). The placeholder may be a variable name, or in some languages an arbitrary expression, in either case evaluated in the current context.

String interpolation is an alternative to building a string via concatenation, which requires repeat quoting and unquoting;^[2] or substituting into a printf format string, where the variable is far from where it is used. Consider this example in Ruby:

apples = 4
puts "I have #{apples} apples." # string interpolation
puts "I have " + String(apples) + " apples." # string concatenation
puts "I have %d apples." % apples # format string

Two types of literal expression are usually offered: one with interpolation enabled, the other without. Non-interpolated strings may also escape sequences, in which case they are termed a raw string, though in other cases this is separate, yielding three classes of raw string, non-interpolated (but escaped) string, interpolated (and escaped) string. For example, in Unix shells, single-quoted strings are raw, while double-quoted strings are interpolated. Placeholders are usually represented by a bare or a named sigil (typically $ or %), e.g. $apples or %apples, or with braces, e.g. {apples}, sometimes both, e.g. ${apples}. In some cases, additional formatting specifiers can be used (as in printf), e.g. {apples:3}, and in some cases the formatting specifiers themselves can be interpolated, e.g. {apples:width}. Expansion of the string usually occurs at run time.

Language support for string interpolation varies widely. Some languages do not offer string interpolation, instead using concatenation, simple formatting functions, or template libraries. String interpolation is common in many programming languages which make heavy use of string representations of data, such as Apache Groovy, Julia, Kotlin, Perl, PHP, Python, Ruby, Scala, Swift, Tcl and most Unix shells.

Algorithms

There are two main types of variable-expanding algorithms for variable interpolation:^[3]

Replace and expand placeholders: creating a new string from the original one, by find–replace operations. Find variable reference (placeholder), replace it with its variable value. This algorithm offers no cache strategy.
Split and join string: splitting the string into an array, merging it with the corresponding array of values, then joining items by concatenation. The split string can be cached for reuse.

Security issues

Examples

ABAP

Main article: ABAP

DATA(apples) = 4.
WRITE |I have { apples } apples|.

The output will be:

I have 4 apples

Bash

Main article: Bash (Unix shell)

apples=4
echo "I have $apples apples"
# or
echo "I have ${apples} apples"

The output will be:

I have 4 apples

Boo

Main article: Boo (programming language)

apples = 4
print("I have $(apples) apples")
# or
print("I have {0} apples" % apples)

The output will be:

I have 4 apples

C

Main article: C (programming language)

C does not have interpolated strings, but they can be approximated using sprintf() and related functions from <stdio.h>.

C++

Main article: C++

While interpolated strings do not exist in C++, some proposals for the feature exist^[5]^[6]; currently, they can be approximated using std::format and std::print functions.

C#

Main article: C Sharp (programming language)

using System;

int apples = 4;
int bananas = 3;

Console.WriteLine($"I have {apples} apples");
Console.WriteLine($"I have {apples + bananas} fruits");

^[7]

The output will be:

I have 4 apples
I have 7 fruits

ColdFusion Markup Language

Main article: ColdFusion Markup Language

ColdFusion Markup Language (CFML) script syntax:

apples = 4;
writeOutput("I have #apples# apples");

Tag syntax:

<cfset apples = 4>
<cfoutput>I have #apples# apples</cfoutput>

The output will be:

I have 4 apples

CoffeeScript

Main article: CoffeeScript

apples = 4
console.log "I have #{apples} apples"

The output will be:

I have 4 apples

Dart

Main article: Dart (programming language)

int apples = 4, bananas = 3;
print('I have $apples apples.');
print('I have ${apples+bananas} fruits.');

The output will be:

I have 4 apples.
I have 7 fruits.

Go

Main article: Go (programming language)

While there have been some proposals for string interpolation (which have been rejected),^[8]^[9]^[10] As of 2025 Go does not have interpolated strings. However, they can be approximated using fmt.Sprintf().

Groovy

Main article: Groovy (programming language)

In groovy, interpolated strings are known as GStrings:^[11]

def quality = "superhero"
final age = 52
def sentence = "A developer is a $quality if he is ${age <= 42 ? 'young' : 'seasoned'}"
println sentence

The output will be:

A developer is a superhero if he is seasoned

Haxe

Main article: Haxe

var apples = 4;
var bananas = 3;
trace('I have $apples apples.');
trace('I have ${apples+bananas} fruits.');

The output will be:^[12]

I have 4 apples.
I have 7 fruits.

Java

Main article: Java (programming language)

Java had interpolated strings as a preview feature in Java 21 and Java 22 (see java.lang.StringTemplate). They were removed in Java 23 due to design issues.^[13] They can otherwise be approximated using java.lang.String's format() static method or formatted() instance method, or java.text.MessageFormat.

JavaScript/TypeScript

Main articles: JavaScript and TypeScript

JavaScript and TypeScript, as of the ECMAScript 2015 (ES6) standard, support string interpolation using backticks ``. This feature is called template literals.^[14] Here is an example:

const apples: number = 4;
const bananas: number = 3;
console.log(`I have ${apples} apples`);
console.log(`I have ${apples + bananas} fruits`);

The output will be:

I have 4 apples
I have 7 fruits

Julia

Main article: Julia (programming language)

apples = 4
bananas = 3
print("I have $apples apples and $bananas bananas, making $(apples + bananas) pieces of fruit in total.")

The output will be:

I have 4 apples and 3 bananas, making 7 pieces of fruit in total.

Kotlin

Main article: Kotlin (programming language)

fun main() {
    val quality: String = "superhero"
    val apples: Int = 4
    val bananas: Int = 3
    val sentence: String = "A developer is a $quality. I have ${apples + bananas} fruits"
    println(sentence)
}

The output will be:

A developer is a superhero. I have 7 fruits

Nemerle

Main article: Nemerle

def apples = 4;
def bananas = 3;
Console.WriteLine($"I have $apples apples.");
Console.WriteLine($"I have $(apples + bananas) fruit.");

It also supports advanced formatting features, such as:

def fruit = ["apple", "banana"];
Console.WriteLine($<#I have ..$(fruit; "\n"; f => f + "s")#>);

The output will be:

apples
bananas

Nim

Main article: Nim (programming language)

Nim provides formatted string literals via the strformat module. The fmt template verifies that the format string is well-formed and well-typed, and then expands it into Nim source code at compile-time.

import strformat
var apples = 4
echo fmt"I have {apples} apples"
echo fmt"I have {apples + bananas} fruits"

The output will be:

I have 4 apples
I have 7 fruits

Nix

Main article: Nix package manager

let numberOfApples = "4";
in "I have ${numberOfApples} apples"

The output will be:

I have 4 apples

ParaSail

Main article: ParaSail (programming language)

const Apples := 4
const Bananas := 3
Println ("I have `(Apples) apples.\n")
Println ("I have `(Apples+Bananas) fruits.\n")

The output will be:

I have 4 apples.
I have 7 fruits.

Perl

Main article: Perl

my $apples = 4;
my $bananas = 3;
print "I have $apples apples.\n";
print "I have @{[$apples+$bananas]} fruit.\n";  # Uses the Perl array (@) interpolation.

The output will be:

I have 4 apples.
I have 7 fruit.

PHP

Main article: PHP

<?php
$apples = 5;
$bananas = 3;
echo "There are $apples apples and $bananas bananas.\n";
echo "I have {$apples} apples and {$bananas} bananas.";

The output will be:

There are 5 apples and 3 bananas.
I have 5 apples and 3 bananas.

Python

Main article: Python (programming language)

Python supports string interpolation as of version 3.6, referred to as "formatted string literals" or "f-strings".^[15]^[16]^[17] Such a literal begins with an f or F before the opening quote, and uses braces for placeholders:

apples: int = 4
bananas: int = 3

print(f"I have {apples} apples and {bananas} bananas")

The output will be:

I have 4 apples and 3 bananas

Ruby/Crystal

Main articles: Ruby (programming language) and Crystal (programming language)

apples = 4
puts "I have #{apples} apples"
# Format string applications for comparison:
puts "I have %s apples" % apples
puts "I have %{a} apples" % {a: apples}

The output will be:

I have 4 apples

Rust

Main article: Rust (programming language)

Rust does not have general string interpolation, but provides similar functionality via macros, referred to as "Captured identifiers in format strings", introduced in version 1.58.0, released 2022-01-13.^[18]

Rust provides formatting via the std::fmt module, which is interfaced with through various macros such as format!(), write!(), and print!(). These macros are converted into Rust source code at compile-time, whereby each argument interacts with a std::fmt::Formatter. The formatter supports positional parameters, named parameters, argument types, defining various formatting traits, and capturing identifiers from the environment.

fn main() {
    let (apples, bananas): (i32, i32) = (4, 3);
    // println! captures the identifiers when formatting: the string itself isn't interpolated by Rust.
    println!("There are {apples} apples and {bananas} bananas.");

    // alternatively, with format!():
    let sentence: String = format!("There are {0} apples and {1} bananas.", apples, bananas);
    println!(sentence);
}

The output will be:

There are 4 apples and 3 bananas.

Scala

Main article: Scala (programming language)

Scala provides a general facility to allow arbitrary processing of a string literal, and supports string interpolation using the included s and f string interpolators (introduced in Scala 2.10). It is also possible to write custom ones or override the standard ones.

The f interpolator is a compiler macro that rewrites a format string with embedded expressions as an invocation of String.format. It verifies that the format string is well-formed and well-typed.

Scala's string interpolation allows embedding variable references directly in processed string literals. Here is an example:

val apples = 4
val bananas = 3
println(s"I have $apples apples")
println(s"I have ${apples + bananas} fruits")
println(f"I have $apples%d apples")

The output will be:

I have 4 apples
I have 7 fruits
I have 4 apples

Sciter (tiscript)

In Sciter any function with name starting from $ is considered as interpolating function and so interpolation is customizable and context sensitive:

var apples = 4
var bananas = 3
var domElement = ...;

domElement.$content(<p>I have {apples} apples</p>);
domElement.$append(<p>I have {apples + bananas} fruits</p>);

Where

domElement.$content(<p>I have {apples} apples</p>);

gets compiled to this:

domElement.html = "<p>I have " + apples.toHtmlString() + " apples</p>";

Swift

Main article: Swift (programming language)

In Swift, a new String value can be created from a mix of constants, variables, literals, and expressions by including their values inside a string literal.^[19] Each item inserted into the string literal is wrapped in a pair of parentheses, prefixed by a backslash.

let apples = 4
print("I have \(apples) apples")

The output will be:

I have 4 apples

Tcl

Main article: Tcl (programming language)

The Tool Command Language has always supported string interpolation in all quote-delimited strings.

set apples 4
puts "I have $apples apples."

The output will be:

I have 4 apples.

In order to actually format – and not simply replace – the values, there is a formatting function.

set apples 4
puts [format "I have %d apples." $apples]

Visual Basic .NET

As of Visual Basic 14, string interpolation is supported in Visual Basic.^[20]

name = "Tom"
Console.WriteLine($"Hello, {name}")

The output will be:

Hello, Tom

Notes

↑ "Enforcing Strict Model-View Separation in Template Engines", T. Parr (2004), WWW2004 conference.
↑ "Interpolation in Perl". perlmeme.org. Hardware Haven. 12 December 2024. Retrieved 30 June 2026. This is much tidier than repeat uses of the . concatenation operator.
↑ "smallest-template-system/Simplest algorithms", an online tutorial for placeholder-template-systems.
↑ "Secure String Interpolation". google-caja.googlecode.com. Archived from the original on 2012-10-19.
↑ Bengt Gustafsson, Victor Zverovich (14 October 2024). "String interpolation - p3412r0" (PDF). open-std.org. WG21.
↑ Barry Revzin (15 March 2026). "String Interpolation with Template Strings". open-std.org. WG21.
↑ "Strings - C# Programming Guide". 15 March 2024.
↑ "proposal: Go 2: string interpolation #34174". GitHub.
↑ "proposal: Go 2: string interpolation evaluating to string and list of expressions #50554". GitHub.
↑ "proposal: spec: add simple string interpolation similar to Swift · Issue #57616 · golang/go". GitHub. Retrieved 2025-05-19.
↑ "The Apache Groovy programming language - Syntax". groovy-lang.org. Retrieved 2021-06-20.
↑ "Haxe - Manual - String interpolation". Haxe - The Cross-platform Toolkit. Retrieved 2017-09-12.
↑ "Significant Changes in the JDK".
↑ "Template literals (Template strings) - JavaScript | MDN". 31 May 2024.
↑ "The Python Tutorial: 7.1.1. Formatted String Literals".
↑ "The Python Language Reference: 2.4.3. Formatted string literals".
↑ "PEP 498 -- Literal String Interpolation".
↑ "Announcing Rust 1.58.0: Captured identifiers in format strings". 2022-01-13.
↑ "Strings and Characters — The Swift Programming Language (Swift 5.5)". docs.swift.org. Retrieved 2021-06-20.
↑ KathleenDollard. "Interpolated Strings - Visual Basic". docs.microsoft.com. Retrieved 2021-06-20.

Retrieved from "https://en.wikipedia.org/w/index.php?title=String_interpolation&oldid=1385035216"

Categories:

Hidden categories:

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.

GeezerVison

Algorithms

Security issues

Examples

ABAP

Bash

Boo

C

C++

C#

ColdFusion Markup Language

CoffeeScript

Dart

Go

Groovy

Haxe

Java

JavaScript/TypeScript

Julia

Kotlin

Nemerle

Nim

Nix

ParaSail

Perl

PHP

Python

Ruby/Crystal

Rust

Scala

Sciter (tiscript)

Swift

Tcl

Visual Basic .NET

See also

Notes