İlişkili dizeler

İlişkili dizeler, F# ifadelerini bunlara eklemenizi sağlayan dizelerdir . Bunlar, bir dizenin değerinin bir değer veya ifadenin sonucuna göre değişebileceği çok çeşitli senaryolarda yararlıdır.

Sözdizimi

$"string-text {expr}"
$"string-text %format-specifier{expr}"
$@"string-text {expr}"
@$"string-text {expr}"
$"""string-text {"embedded string literal"}"""
$$"""string-text %%format-specifier{{expr}}"""

Açıklamalar

İlişkili dizeler, bir dize değişmez değeri içinde "delikler" içinde kod yazmanıza olanak sağlar. Aşağıda temel bir örnek verilmişti:

let name = "Phillip"
let age = 30
printfn $"Name: {name}, Age: {age}"

printfn $"I think {3.0 + 0.14} is close to {System.Math.PI}!"

Her {} küme ayracı çifti arasındaki içerik herhangi bir F# ifadesi olabilir.

F# 11'de dize değerli ilişkilendirme için biçimlendirilmemiş bir ifade F# dönüştürmesini string kullanır. İfade olarak değerlendirilirse nullboş bir dize kullanılır. Önceki derleyiciler bazı yalnızca dize ilişkilendirmelerini iyileştirirken, aksi takdirde printf biçimlendirmesi kullanıyordu; Biçimlendirme farklılıkları için bkz. Yerel AOT ve dize değerli ilişkilendirme .

Biçim tanımlayıcıları (veya gibi %s{expr}%d{expr}) ile yazılan ilişkilendirilmiş dizeler için dönüştürme, söz konusu biçim tanımlayıcısı için tanımlanan kurallara uyar. Bir {} küme ayracı çiftinden kaçmak için, bunlardan ikisini şöyle yazın:

let str = $"A pair of braces: {{}}"
// "A pair of braces: {}"

Yazılan ilişkilendirilmiş dizeler

İlişkili dizeler, tür güvenliğini zorlamak için F# biçim tanımlayıcılarına da sahip olabilir.

let name = "Phillip"
let age = 30

printfn $"Name: %s{name}, Age: %d{age}"

// Error: type mismatch
printfn $"Name: %s{age}, Age: %d{name}"

Önceki örnekte kod, değeri yanlışlıkla olması gereken yere age (veya tersi) geçirirname. İlişkili dizeler biçim tanımlayıcıları kullandığından, bu küçük bir çalışma zamanı hatası yerine bir derleme hatasıdır.

İlişkili dizeleri ayrıntılı olarak ifade edin

F# iki yolla tam ilişkilendirmeli dizeleri destekler:

veya $@ ön eki kullanma @$

İlişkilendirme ön ekini $ , herhangi bir sırada ayrıntılı dize ön eki @ ile birleştirebilirsiniz. Ayrıntılı dizeler kaçış dizilerini yoksayar (tırnak işaretini göstermek dışında "" ) ve birden çok satıra yayılabilir. Bu, özellikle dosya yolları veya ters eğik çizgi ve tırnak işaretleri içeren dizelerle çalışırken kullanışlıdır.

let name = "Alice"
let path = @"C:\Users\Alice\Documents"

// Using $@ prefix
printfn $@"User {name} has files in: {path}"

// Using @$ prefix (also valid)
printfn @$"User {name} has files in: {path}"

// Embedding quotes - use "" to represent a single "
let message = $@"He said ""{name}"" is here"

Üç tırnak işareti kullanma

F# ayrıca üç tırnak işaretiyle düz ilişkilendirilmiş dizeleri de destekler, böylece dize değişmez değerlerini kaçış yapmadan ekleyebilirsiniz.

let age = 30

printfn $"""Name: {"Phillip"}, Age: %d{age}"""

Biçim tanımlayıcıları

Biçim tanımlayıcıları printf stilinde veya olabilir. NET stili. Printf stili tanımlayıcılar, ayraçların önüne yerleştirilmiş düz metin biçimlendirmesiyle kapsananlardır. Örneğin:

let pi = $"%0.3f{System.Math.PI}"  // "3.142"
let code = $"0x%08x{43962}"  // "0x0000abba"

Biçim belirtici %A , yapılandırılmış F# verilerinin tanılama çıktısını üretmek için özellikle yararlıdır.

let data = [0..4]
let output = $"The data is %A{data}"  // "The data is [0; 1; 2; 3; 4]"

. NET stili tanımlayıcılar, küme ayraçlarının içinde bir'in String.Format arkasına yerleştirilen ile :kullanılabilir olanlardır. Örneğin:

let pi = $"{System.Math.PI:N4}"  // "3.1416"
let now = $"{System.DateTime.UtcNow:``yyyyMMdd``}" // for example, "20220210"

Bir ise. NET stili tanımlayıcı sıra dışı bir karakter içerdiğinden, çift backticks kullanılarak kaçılabilir:

let nowDashes = $"{System.DateTime.UtcNow:``yyyy-MM-dd``}" // for example, "2022-02-10"

İlişkili dizelerdeki ifadeleri hizalama

İlişkili dizelerin | içinde ifadeleri sola hizalayabilir veya sağa hizalayabilir ve kaç boşluk olduğunu belirtimleyebilirsiniz. Aşağıdaki ilişkilendirilmiş dize, sol ve sağ ifadeleri sırasıyla yedi boşlukla sola ve sağa hizalar.

printfn $"""|{"Left",-7}|{"Right",7}|"""
// |Left   |  Right|

İlişkili dizeler ve FormattableString biçimlendirme

Ayrıca, için kurallara FormattableStringuygun biçimlendirme uygulayabilirsiniz:

let speedOfLight = 299792.458
printfn $"The speed of light is {speedOfLight:N3} km/s."
// "The speed of light is 299,792.458 km/s."

Ayrıca, ilişkilendirilmiş bir dize de tür ek açıklaması aracılığıyla bir tür olarak FormattableString denetlenebilir:

let frmtStr = $"The speed of light is {speedOfLight:N3} km/s." : FormattableString
// Type: FormattableString
// The speed of light is 299,792.458 km/s.

Tür ek açıklamasının, ilişkilendirilmiş dize ifadesinin kendisinde olması gerektiğini unutmayın. F# örtük olarak ilişkilendirilmiş bir dizeyi içine FormattableStringdönüştürmez.

Dize ilişkilendirme için genişletilmiş söz dizimi

F# 8'den başlayarak, birden çok {veya }% karakter içeren metinlerle çalışırken, kaçış gereksinimini ortadan kaldırmak için genişletilmiş dize ilişkilendirme söz dizimini kullanabilirsiniz.

Üç tırnak dizesi değişmez değerleri birden çok $ karakterle başlayabilir ve bu da ilişkilendirmeyi açmak ve kapatmak için gereken ayraç sayısını değiştirir. Bu dize değişmez değerlerinde { ve } karakterlerin kaçılması gerekmez:

let str = $$"""A string containing some {curly braces} and an {{"F#" + " " + "expression"}}."""
// "A string containing some {curly braces} and an F# expression."
let another = $$$"""A string with pairs of {{ and }} characters and {{{ "an F# expression" }}}."""
// "A string with pairs of {{ and }} characters and an F# expression."""

Biçim tanımlayıcıları için gereken karakter sayısı % aynı şekilde etkilenir:

let percent = $$"""50% of 20 is %%.1f{{20m * 0.5m}}"""
// "50% of 20 is 10.0"

Yerel AOT ve dize değerli ilişkilendirme

Metni yansıma tabanlı biçimlendirme altyapısı olmadan biçimlendirmek için düz veya .NET biçimli deliklerle dize değerli ilişkilendirme kullanın:

let name = "Ada"
let score = 97.5
let message: string = $"{name}: {score:F1}"
printn message
// Ada: 97.5

F# 11, doğrudan dönüştürmeleri ve System.String.Concat daha fazla dize değerli ilişkilendirme için kullanır. .NET biçimli bir delik sabit String.Format kullanır ve bağımsız değişkenini kutular. Bu derleyici değişiklikleri, modern Core derlemesine gerek kalmadan Yerel AOT'yi destekler; diğer uygulama kodunun yansımaya ihtiyacı olabilir.

veya %A{record}gibi %04d{number} printf biçimlendirmesi gerektiren printf stili delikler yansıma tabanlı yolu kullanmaya devam edebilir. %sÇıplak , %c, , %d, %ive %M delikler, tür denetimlerini korur ve printf biçimlendirmesini önler. dahil olmak üzere %udiğer tanımlayıcılar bu iyileştirme kapsamında değildir. Değer olarak kullanılan ilişkilendirme PrintfFormat , sonuç türü stringolan değerden de farklıdır.

Kültür ve biçim uyumluluğu

Düz delikler F# dönüşüm kullanırstring; .NET biçimli delikler sabit biçimlendirme kullanır. Yerelleştirilmiş çıkış oluşturmak için kültürü açıkça seçin:

open System.Globalization

let value = 12.5m
let machineText: string = $"{value:F2}"
let displayText =
    value.ToString("F2", CultureInfo.GetCultureInfo("fr-FR"))

assert (machineText = "12.50")
assert (displayText = "12,50")

Yükseltme sırasında yerelleştirilmiş çıkışı denetleyin. FormattableString bu birleştirme yolunu takip etme yerine sonraki sağlayıcı tabanlı biçimlendirme için bağımsız değişkenlerini korur.

Uyarı FS3884, bir ilişkilendirme deliğinde uygulanmamış bir işlevi veya temsilciyi tanımlar. Sonucuna yönelikse işlevi uygulayın:

let weight () = 12.5m
let text: string = $"Weight: {weight ()} kg"

Standart çıkışa değer yazma

Printf biçimi olmayan bir değer yazmak için FSharp.Core 11 ve printneklerprint. Dönüştürmeyi kullanırlar string ; printn yeni bir satır ekler:

print "Parcels: "
printn 3

Yapısal %A çıkış için düz metin biçimlendirmesini kullanın.

Yansıma olmadan kayıt ve birleşim çıkışı

ile --reflectionfree, F# 11 yalnızca tür adını görüntülemek yerine kayıtlar ve birleşimler için anlamlı ToString uygulamalar oluşturabilir:

type Reading = { Sensor: string; Value: int }
type Outcome = Recorded of Reading | Unavailable

let reading = { Sensor = "north"; Value = 12 }
printn reading
printn (Recorded reading)

Örnek proje bayrağını etkinleştirir. Çıktıdan %Afarklıdır; alan türleri de uygun ToString uygulamalara ihtiyaç duyar.

Ayrıca bakınız