since: 2.0.7 -

since: 2.1.3 -

since: 2.1.3 -

since: 2.1.2 -

since: 2.1.3 -

 public PdfName(String name) 
{
    
    // constructors
        this(name, true);
}

Constructs a new PdfName. The name length will be checked.

Parameters:

name - the new name

 public PdfName(byte[] bytes) 
{
        super(PdfObject.NAME, bytes);
}

Constructs a PdfName.

Parameters:

bytes - the byte representation of the name

 public PdfName(String name,
    boolean lengthCheck) 
{
        super(PdfObject.NAME);
        // The minimum number of characters in a name is 0, the maximum is 127 (the '/' not included)
        int length = name.length();
        if (lengthCheck && length  > 127) {
            throw new IllegalArgumentException("The name '" + name + "' is too long (" + length + " characters).");
        }
        // The name has to be checked for illegal characters
        // every special character has to be substituted
        ByteBuffer pdfName = new ByteBuffer(length + 20);
        pdfName.append('/");
        char character;
        char chars[] = name.toCharArray();
        // loop over all the characters
        for (int index = 0; index <  length; index++) {
            character = (char)(chars[index] & 0xff);
            // special characters are escaped (reference manual p.39)
            switch (character) {
                case ' ":
                case '%":
                case '(":
                case ')":
                case '< ":
                case ' >":
                case '[":
                case ']":
                case '{":
                case '}":
                case '/":
                case '#":
                    pdfName.append('#");
                    pdfName.append(Integer.toString(character, 16));
                    break;
                default:
                    if (character  > 126 || character <  32) {
                        pdfName.append('#");
                        if (character <  16)
                            pdfName.append('0");
                        pdfName.append(Integer.toString(character, 16));
                    }
                    else
                        pdfName.append(character);
                    break;
            }
        }
        bytes = pdfName.toByteArray();
}

Constructs a new PdfName.

Parameters:

name - the new name

lengthCheck - if true check the length validity, if false the name can have any length

 public int compareTo(Object object) 
{
        PdfName name = (PdfName) object;
        byte myBytes[] = bytes;
        byte objBytes[] = name.bytes;
        int len = Math.min(myBytes.length, objBytes.length);
        for(int i=0; i< len; i++) {
            if(myBytes[i]  > objBytes[i])
                return 1;
            if(myBytes[i] <  objBytes[i])
                return -1;
        }
        if (myBytes.length <  objBytes.length)
            return -1;
        if (myBytes.length  > objBytes.length)
            return 1;
        return 0;
}

Compares this object with the specified object for order. Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

 public static String decodeName(String name) 
{
        StringBuffer buf = new StringBuffer();
        try {
            int len = name.length();
            for (int k = 1; k <  len; ++k) {
                char c = name.charAt(k);
                if (c == '#") {
                    c = (char)((PRTokeniser.getHex(name.charAt(k + 1)) < <  4) + PRTokeniser.getHex(name.charAt(k + 2)));
                    k += 2;
                }
                buf.append(c);
            }
        }
        catch (IndexOutOfBoundsException e) {
            // empty on purpose
        }
        return buf.toString();
}

Decodes an escaped name in the form "/AB#20CD" into "AB CD".

 public boolean equals(Object obj) 
{
        if (this == obj)
            return true;
        if (obj instanceof PdfName)
            return compareTo(obj) == 0;
        return false;
}

Indicates whether some other object is "equal to" this one.

 public int hashCode() 
{
        int h = hash;
        if (h == 0) {
            int ptr = 0;
            int len = bytes.length;
            for (int i = 0; i <  len; i++)
                h = 31*h + (bytes[ptr++] & 0xff);
            hash = h;
        }
        return h;
}

Returns a hash code value for the object. This method is supported for the benefit of hashtables such as those provided by java.util.Hashtable.