String.format ב-Java: printf ומפרטי עיצוב

שתי דרכים לעצב

Java מעצבת מחרוזות מתוך תבנית שמכילה מפרטי עיצוב (ממלאי המקום עם %), יחד עם הערכים שמכניסים אליה. יש שתי נקודות כניסה, ולשתיהן תחביר זהה:

• String.format(template, values...) מחזירה String חדש.
• System.out.printf(template, values...) מדפיסה את התוצאה ישירות.

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);
    }
}

שתיהן מפיקות את אותו טקסט. String.format מחזירה אותו כדי שתוכלו לשמור אותו; printf כותבת אותו לקונסול. שימו לב ל-%n בסוף התבנית של printf: זה מעבר השורה שלא תלוי בפלטפורמה (העדיפו אותו על פני \n במחרוזות עיצוב).

המפרטים הנפוצים

כל מפרט מתחיל ב-% ומסתיים באות שאומרת איזה סוג ערך לצפות לו:

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");
    }
}

שלושת היומיומיים הם %s (כל ערך, דרך ה-toString שלו), %d (מספרים שלמים) ו-%f (מספרים עשרוניים). השתמשו ב-%% כדי להדפיס סימן אחוז כפשוטו. העברת טיפוס לא נכון, למשל String ל-%d, זורקת IllegalFormatConversionException בזמן ריצה.

שליטה בספרות אחרי הנקודה

%f מציג כברירת מחדל שש ספרות אחרי הנקודה, וזה כמעט אף פעם לא מה שרוצים. שימו .N לפני ה-f כדי לקבוע את הדיוק (הערך מעוגל):

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
    }
}

הוסיפו דגל פסיק למפרידי קבוצות במספרים גדולים:

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

רוחב וריפוד

מספר בין ה-% לבין אות הטיפוס קובע רוחב שדה מינימלי, ומרפד ברווחים כדי שהעמודות יסתדרו. - בהתחלה מיישר לתחילת השדה; 0 בהתחלה מרפד מספרים באפסים:

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
    }
}

זה מה שהופך טבלאות מעוצבות ודוחות מיושרים לקריאים, במיוחד כשמדפיסים כל שורה בתוך לולאת for:

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 מיישר את השמות לתחילת עמודה ברוחב 8, ו-%5d מיישר את הציונים לסוף עמודה ברוחב 5, כך שהמספרים מסתדרים בשורה אחת בלי קשר למספר הספרות.

סדר הארגומנטים

כברירת מחדל, המפרטים צורכים ערכים לפי הסדר. אפשר לחזור על ערך או לשנות את הסדר עם N$ (אינדקס שמתחיל מ-1), וזה שימושי כשאותו ערך מופיע פעמיים:

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

%1$s מתייחס לארגומנט הראשון בשתי הפעמים, ולכן echo מודפס פעמיים.

המתודה formatted()

מאז Java 15, לכל מחרוזת יש מתודת מופע formatted: אותו מנוע כמו String.format, רק שנכתב כקריאה למתודה על התבנית:

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

היא משתלבת במיוחד טוב עם text blocks (מחרוזות מרובות שורות בשלושה מרכאות) כשבונים פלט מעוצב גדול יותר.

מתי לא להשתמש ב-String.format

לחיבורים פשוטים וחד פעמיים, שרשור רגיל עם + ברור ומהיר יותר:

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

השתמשו ב-String.format / printf כשצריך עיצוב אמיתי: מספר קבוע של ספרות אחרי הנקודה, ריפוד, יישור, קיבוץ, ולא רק הדבקה של כמה ערכים יחד.

הבא: אופרטורים

עיצוב הופך ערכים לטקסט. כדי לחשב את הערכים האלה מלכתחילה, צריך את האופרטורים של Java: חשבון, השוואה ולוגיקה. זה העמוד הבא.