Quellcode-Bibliothek

^© Kompilation durch diese Firma

[Weder Korrektheit noch Funktionsfähigkeit der Software werden zugesichert.]

Datei: Format.java Sprache: JAVA

/*
* Copyright (c) 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/

package jdk.test.lib.format;

/**
* A collection of formatting utilities
*/
public class Format {

    /**
     * Formats character as literal, using C-style escaping for unprintable symbols
     *
     * @param c character to format
     * @return formatted string representation of the character
     */
    public static String asLiteral(char c) {
        StringBuilder sb = new StringBuilder();
        appendCharToSb(c, sb);
        return sb.toString();
    }

    /**
     * Escapes String in C-style
     *
     * @param src source string
     * @return C-style escaped source string
     */
    public static String escapeString(String src) {
        StringBuilder sb = new StringBuilder();
        src.chars().forEachOrdered(
                (c) -> appendCharToSb((char) c, sb));
        return sb.toString();
    }

    /**
     * Formats Object as literal, using its String representation C-style escaped.
     *
     * @param o object to format
     * @return C-style escaped String representation of the object
     */
    public static String asLiteral(Object o) {
        if (o instanceof String) {
            return '"' + escapeString((String)o) + '"';
        } else if (o instanceof Character) {
            return asLiteral((char) o);
        } else if (o instanceof Byte) {
            return String.valueOf(o);
        } else {
            return escapeString(String.valueOf(o));
        }
    }

    /**
     * Formats a difference between two arrays with index of the first mismatch element,
     * and slices of arrays necessary to understand the problem, along with a failure mark.
     *
     * @param first first array to compare
     * @param second second array to compare
     * @return the difference, generated by the {@link ArrayDiff ArrayDiff}
     */
    public static String arrayDiff(Object first, Object second) {
        return ArrayDiff.of(first, second).format();
    }

    /**
     * Formats a difference between two arrays with index of the first mismatch element,
     * and slices of arrays necessary to understand the problem, along with a failure mark.
     * Takes into account maximum allowed width and context (in elements) before the mismatch.
     *
     * @param first first array to compare
     * @param second second array to compare
     * @param width the maximum allowed width in characters for the formatting
     * @param contextBefore maximum number of elements to print before those that differ
     * @return the difference, generated by the {@link ArrayDiff ArrayDiff}
     */
    public static String arrayDiff(Object first, Object second, int width, int contextBefore) {
        return ArrayDiff.of(first, second, width, contextBefore).format();
    }

    /**
     * Returns a string of spaces with length specified.
     *
     * @param width number of spaces in the resulting string
     * @return Padding string of spaces
     */
    public static String paddingForWidth(int width) {
        return " ".repeat(width);
    }

    private static void appendCharToSb(char c, StringBuilder sb) {
        if (c == 10) {
            sb.append("\\n");
        } else if (c == 13) {
            sb.append("\\r");
        } else if (c == 92) {
            sb.append("\\\\");
        } else if (c == 34) {
            sb.append("\\\"");
        } else if (c < 32 || c > 126) {
            sb.append("\\u" + String.format("%04X", (int) c));
        } else {
            sb.append(c);
        }
    }
}

¤ Dauer der Verarbeitung: 0.1 Sekunden (vorverarbeitet) ¤

Download des Quellennavigators
Download des sprechenden Kalenders
in der Quellcodebibliothek suchen

Haftungshinweis

Die Informationen auf dieser Webseite wurden nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit, noch Qualität der bereit gestellten Informationen zugesichert.

Bemerkung:

Die farbliche Syntaxdarstellung ist noch experimentell.