Subversion Repositories mkgmap

/*
 * Copyright (C) 2006,2014 Steve Ratcliffe
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License version 2 as
 *  published by the Free Software Foundation.
 *
 *  This program 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 for more details.
 *
 *
 * Author: Steve Ratcliffe
 * Create date: 10-Jan-2007
 */
package uk.me.parabola.imgfmt.app;

import java.util.regex.Pattern;

/**
 * Labels are used for names of roads, points of interest etc.
 *
 * There are different storage formats.
 *
 * 1. A 6 bit compact uppercase ascii format, that has escape codes for some
 * special characters.
 *
 * 2. An 8 bit format.  This seems to be a fairly straightforward latin-1 like
 * encoding with no tricks to reduce the amount of space required.
 *
 * 3. A multi-byte format. For unicode, cp932 etc.
 *
 * @author Steve Ratcliffe
 */
public class Label {
        public static final Label NULL_LABEL = new Label("");
        public static final Label NULL_OUT_LABEL = new Label(new char[0]);

        private final String text;
        private final char[] encText;

        // The offset in to the data section.
        private int offset;

        public Label(String text) {
                this.text = text;
                this.encText = null;
        }

        public Label(char[] encText) {
                this.encText = encText;
                this.text = null;
        }

        /**
         * @return a value > 0 if this label is not empty. TODO: replace by isEmpty()
         */
        public int getLength() {
                if (text != null)
                        return text.length();
                if (encText != null)
                        return encText.length;
                return 0;
        }

        public String getText() {
                assert text != null;
                return text;
        }

        public char[] getEncText() {
                return encText;
        }

        // highway shields and "thin" separators
        public final static Pattern SHIELDS = Pattern.compile("[\u0001-\u0006\u001b-\u001c]");

        // "fat" separators
        private final static Pattern SEPARATORS = Pattern.compile("[\u001d-\u001f]");

        // two or more whitespace characters
        private final static Pattern SQUASH_SPACES = Pattern.compile("\\s\\s+");

        // DEL character
        public final static Pattern SQASH_DEL = Pattern.compile("[\u007f]");

        public static String stripGarminCodes(String s) {
                if(s == null)
                        return null;
                s = SHIELDS.matcher(s).replaceAll(""); // remove
                s = SEPARATORS.matcher(s).replaceAll(" "); // replace with a space
                s = SQUASH_SPACES.matcher(s).replaceAll(" "); // replace with a space
                // a leading separator would have turned into a space so trim it
                return s.trim();
        }

        /**
         * two or more whitespace characters are replaced by a single space
         * @param s string to trim
         * @return the trimmed string or null if s is null or empty
         */
        public static String squashSpaces(String s) {
                if(s == null || s.isEmpty())
                        return null;
                return SQUASH_SPACES.matcher(s).replaceAll(" "); // replace with single space
        }

        public static String squashDel(String s) {
                if(s == null || s.isEmpty())
                        return null;
                return SQASH_DEL.matcher(s).replaceAll(""); // remove 0x7f=DEL character
        }

        /**
         * The offset of this label in the LBL file.  The first byte of this file
         * is zero and an offset of zero means that the label has a zero length/is
         * empty.
         *
         * @return The offset within the LBL file of this string.
         */
        public int getOffset() {
                return offset;
        }

        public void setOffset(int offset) {
                this.offset = offset;
        }

        /**
         * String version of the label, for diagnostic purposes.
         */
        public String toString() {
                return text != null ? text : "[" + offset + "]";
        }

        public boolean equals(Object o) {
                if (this == o) return true;
                if (o == null || getClass() != o.getClass()) return false;

                return offset == ((Label) o).offset;
        }

        public int hashCode() {
                return offset;
        }
}