The API reference links in this article will take you to MSDN. The docs.microsoft.com API reference is not complete.
string type represents immutable text as a sequence of Unicode characters.
string is an alias for
System.String in the .NET Framework.
String literals are delimited by the quotation mark (") character. The backslash character () is used to encode certain special characters. The backslash and the next character together are known as an escape sequence. Escape sequences supported in F# string literals are shown in the following table.
|Unicode character||\uXXXX or \UXXXXXXXX (where X indicates a hexadecimal digit)|
If preceded by the @ symbol, the literal is a verbatim string. This means that any escape sequences are ignored, except that two quotation mark characters are interpreted as one quotation mark character.
Additionally, a string may be enclosed by triple quotes. In this case, all escape sequences are ignored, including double quotation mark characters. To specify a string that contains an embedded quoted string, you can either use a verbatim string or a triple-quoted string. If you use a verbatim string, you must specify two quotation mark characters to indicate a single quotation mark character. If you use a triple-quoted string, you can use the single quotation mark characters without them being parsed as the end of the string. This technique can be useful when you work with XML or other structures that include embedded quotation marks.
// Using a verbatim string let xmlFragment1 = @"<book author=""Milton, John"" title=""Paradise Lost"">" // Using a triple-quoted string let xmlFragment2 = """<book author="Milton, John" title="Paradise Lost">"""
In code, strings that have line breaks are accepted and the line breaks are interpreted literally as newlines, unless a backslash character is the last character before the line break. Leading whitespace on the next line is ignored when the backslash character is used. The following code produces a string
str1 that has value
"abc\n def" and a string
str2 that has value
let str1 = "abc def" let str2 = "abc\ def"
You can access individual characters in a string by using array-like syntax, as follows.
printfn "%c" str1.
The output is
Or you can extract substrings by using array slice syntax, as shown in the following code.
printfn "%s" (str1.[0..2]) printfn "%s" (str2.[3..5])
The output is as follows.
You can represent ASCII strings by arrays of unsigned bytes, type
byte. You add the suffix
B to a string literal to indicate that it is an ASCII string. ASCII string literals used with byte arrays support the same escape sequences as Unicode strings, except for the Unicode escape sequences.
// "abc" interpreted as a Unicode string. let str1 : string = "abc" // "abc" interpreted as an ASCII byte array. let bytearray : byte = "abc"B
There are two ways to concatenate strings: by using the
+ operator or by using the
^ operator. The
+ operator maintains compatibility with the .NET Framework string handling features.
The following example illustrates string concatenation.
let string1 = "Hello, " + "world"
Because the string type in F# is actually a .NET Framework
System.String type, all the
System.String members are available. This includes the
+ operator, which is used to concatenate strings, the
Length property, and the
Chars property, which returns the string as an array of Unicode characters. For more information about strings, see
By using the
Chars property of
System.String, you can access the individual characters in a string by specifying an index, as is shown in the following code.
let printChar (str : string) (index : int) = printfn "First character: %c" (str.Chars(index))
Additional functionality for string handling is included in the
String module in the
FSharp.Core namespace. For more information, see Core.String Module.