Java String Biçimlendirme: String.format, printf ve Biçim Belirteçleri

Biçimlendirmenin İki Yolu

Java, string'leri biçim belirteçleri (% yer tutucuları) içeren bir şablon ile yerleştirilecek değerlerden biçimlendirir. İki giriş noktası vardır ve bunlar aynı söz dizimini paylaşır:

• String.format(template, values...) yeni bir String döndürür.
• System.out.printf(template, values...) sonucu doğrudan yazdırır.

public class Main {
    public static void main(String[] args) {
        String name = "Ada";
        int age = 36;

        String line = String.format("%s is %d years old", name, age);
        System.out.println(line);

        System.out.printf("%s is %d years old%n", name, age);
    }
}

İkisi de aynı metni üretir. String.format saklayabilmeniz için metni geri verir; printf ise konsola yazar. printf şablonunun sonundaki %n ifadesine dikkat edin - bu, platformdan bağımsız satır sonudur (biçim string'lerinde \n yerine bunu tercih edin).

Yaygın Belirteçler

Her belirteç % ile başlar ve ne tür bir değer beklendiğini belirten bir harfle biter:

public class Main {
    public static void main(String[] args) {
        System.out.printf("string: %s%n", "hello");
        System.out.printf("integer: %d%n", 42);
        System.out.printf("float: %f%n", 3.14);
        System.out.printf("boolean: %b%n", true);
        System.out.printf("char: %c%n", 'A');
        System.out.printf("hex: %x%n", 255);
        System.out.printf("percent sign: %%%n");
    }
}

Günlük olarak kullanılan üçü %s (herhangi bir değer, toString aracılığıyla), %d (tam sayılar) ve %f (ondalıklar) belirteçleridir. Düz bir yüzde işareti yazdırmak için %% kullanın. Yanlış tür geçmek - örneğin %d belirtecine bir String - çalışma zamanında bir IllegalFormatConversionException fırlatır.

Ondalık Basamakları Denetleme

%f varsayılan olarak altı ondalık basamak kullanır ki bu nadiren istediğiniz şeydir. Hassasiyeti sabitlemek için f harfinden önce .N koyun (değer yuvarlanır):

public class Main {
    public static void main(String[] args) {
        double price = 3.14159;

        System.out.printf("%f%n", price);     // 3.141590
        System.out.printf("%.2f%n", price);   // 3.14
        System.out.printf("%.0f%n", price);   // 3
    }
}

Büyük sayılarda gruplama ayırıcıları için virgül bayrağı ekleyin:

public class Main {
    public static void main(String[] args) {
        double total = 1234567.891;
        System.out.printf("%,.2f%n", total);   // 1,234,567.89
    }
}

Genişlik ve Dolgu

% ile tür harfi arasına yazılan bir sayı, sütunların hizalanması için boşluklarla doldurarak en az alan genişliğini belirler. Baştaki bir - sola hizalar; baştaki bir 0 sayıları sıfırlarla doldurur:

public class Main {
    public static void main(String[] args) {
        System.out.printf("[%10s]%n", "hi");    // right-aligned in 10 cols
        System.out.printf("[%-10s]%n", "hi");   // left-aligned
        System.out.printf("[%05d]%n", 42);      // zero-padded to width 5
    }
}

Biçimlendirilmiş tabloları ve hizalı raporları okunaklı kılan da budur:

public class Main {
    public static void main(String[] args) {
        String[] names = {"Ada", "Boris", "Chen"};
        int[] scores = {95, 8, 142};

        for (int i = 0; i < names.length; i++) {
            System.out.printf("%-8s %5d%n", names[i], scores[i]);
        }
    }
}

%-8s adları 8 genişliğindeki bir sütunda sola hizalar ve %5d puanları 5 genişliğindeki bir sütunda sağa hizalar; böylece sayılar basamak sayısından bağımsız olarak hizalanır.

Argüman Sırası

Varsayılan olarak belirteçler değerleri soldan sağa tüketir. Bir değeri N$ (bir tabanlı dizin) ile tekrarlayabilir veya yeniden sıralayabilirsiniz; bu, aynı değer iki kez göründüğünde işe yarar:

public class Main {
    public static void main(String[] args) {
        System.out.printf("%1$s, %1$s, hello %2$s%n", "echo", "world");
    }
}

%1$s her iki seferde de ilk argümana atıfta bulunur, dolayısıyla echo iki kez yazdırılır.

formatted() Yöntemi

Java 15'ten beri her string'in bir formatted örnek yöntemi vardır - String.format ile aynı motor, sadece şablon üzerinde bir yöntem çağrısı olarak yazılmıştır:

public class Main {
    public static void main(String[] args) {
        String msg = "%s scored %d".formatted("Ada", 95);
        System.out.println(msg);
    }
}

Daha büyük biçimlendirilmiş çıktılar oluştururken text block'larla (üç tırnaklı çok satırlı string'ler) özellikle iyi uyum sağlar.

String.format Ne Zaman Kullanılmamalı

Basit, tek seferlik birleştirmeler için + ile düz birleştirme daha açık ve daha hızlıdır:

String greeting = "Hi, " + name + "!";   // simpler than String.format here

Gerçek biçimlendirmeye ihtiyacınız olduğunda - sabit ondalık basamaklar, dolgu, hizalama, gruplama - sadece birkaç değeri yapıştırmak için değil, String.format / printf'e başvurun.

Sıradaki: Operatörler

Biçimlendirme, değerleri metne dönüştürür. Bu değerleri en baştan hesaplamak için Java'nın operatörlerine ihtiyacınız var - aritmetik, karşılaştırma ve mantıksal. İşte bir sonraki sayfa bu.