java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

javax.print.attribute
类 SetOfIntegerSyntax

java.lang.Object
  继承者 javax.print.attribute.SetOfIntegerSyntax
所有已实现的接口:
Serializable, Cloneable
直接已知子类:
CopiesSupported, JobImpressionsSupported, JobKOctetsSupported, JobMediaSheetsSupported, NumberUpSupported, PageRanges

public abstract class SetOfIntegerSyntax
extends Object
implements Serializable, Cloneable

类 SetOfIntegerSyntax 是一种抽象的基类,它提供其值是非负整数集合的所有属性的公共实现。这包括其值是一个整数范围的属性和其值是一组整数范围的属性。

可以用“字符串形式”构造一个 SetOfIntegerSyntax 的实例。字符串由零或多个用逗号分隔的整数组组成。每个整数组由一个整数、连字符 (-) 分隔的两个整数,或冒号 (:) 分隔的两个整数组成。每个整数由一个或多个十进制数字(09)组成。空格字符不能在整数中显示,否则被忽略。例如: "", "1", "5-10", "1:2, 4".

也可以使用“数组形式”构造一个 SetOfIntegerSyntax 的实例。数组形式由零个或多个整数组的数组组成,其中每个整数组是长度为 1 或长度为 2 的 int 数组;例如,int[0][]int[][]{{1}}int[][]{{5,10}}int[][]{{1,2},{4}}

在字符串形式和数组形式中,每个连续的整数组都提供一系列在集合中包括的整数。每组中的第一个整数提供该范围的下边界;第二个整数提供该范围的上边界;如果在组中仅有一个整数,则上边界与下边界相同。如果上边界小于下边界,则它表示一个 null 范围(无值)。如果上边界等于下边界,则它表示由单个值组成的范围。如果上边界大于下边界,则它表示由多个值组成的范围。该范围可以按任意顺序显示,并允许重叠。所有范围的并集给出该集合的内容。一旦构造 SetOfIntegerSyntax 实例之后,其值就是不可变的。

SetOfIntegerSyntax 对象的值实际上以“规范 数组形式”存储。除没有任何 null 范围外,这与数组形式相同;用尽可能少的范围(即:合并重叠范围)表示集合的成员;范围按升序显示;并且将每个范围按形式 {下边界, 上边界} 表示为长度为 2 的 int 数组。将空集表示为零长度数组。

类 SetOfIntegerSyntax 可以进行以下操作:以规范数组形式返回集合的成员、测试给定的整数是否为集合的成员,迭代集合的成员。

另请参见:
序列化表格

构造方法摘要
protected SetOfIntegerSyntax(int member)
          构造一个包含单个整数的新整数集属性。
protected SetOfIntegerSyntax(int[][] members)
          使用以字符串形式给定的成员构造一个新的整数集属性。
protected SetOfIntegerSyntax(int lowerBound, int upperBound)
          构造一个包含单一整数范围的新整数集属性。
protected SetOfIntegerSyntax(String members)
          使用以字符串形式给定的成员构造一个新的整数集属性。
 
方法摘要
 boolean contains(int x)
          确定此整数集属性是否包含给定的值。
 boolean contains(IntegerSyntax attribute)
          确定此整数集属性是否包含给定的整数属性的值。
 boolean equals(Object object)
          返回此整数集属性是否等效于传入的对象。
 int[][] getMembers()
          获取规范数组形式的此整数集属性的成员。
 int hashCode()
          返回此整数集属性的哈希码值。
 int next(int x)
          确定此整数集属性中的最小整数是否大于给定值。
 String toString()
          返回对应于此整数集属性的字符串值。
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

SetOfIntegerSyntax

protected SetOfIntegerSyntax(String members)
使用以字符串形式给定的成员构造一个新的整数集属性。

参数:
members - 字符串形式的集合成员。如果为 null,则构造一个空集。
抛出:
IllegalArgumentException - (未经检查的异常)如果 members 不遵循正确的语法,则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int[][] members)
使用以字符串形式给定的成员构造一个新的整数集属性。

参数:
members - 数组形式的集合成员。如果为 null,则构造一个空集。
抛出:
NullPointerException - (未经检查的异常)如果 members 的任何元素为 null,则抛出该异常。
IllegalArgumentException - (未经检查的异常)如果 members 的任何元素不是长度为 1 或长度为 2 的数组,或者如果 members 中任何非 null 范围的下边界小于零,则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int member)
构造一个包含单个整数的新整数集属性。

参数:
member - 集合成员。
抛出:
IllegalArgumentException - (未经检查的异常)如果 member 小于零,则抛出该异常。

SetOfIntegerSyntax

protected SetOfIntegerSyntax(int lowerBound,
                             int upperBound)
构造一个包含单一整数范围的新整数集属性。如果下边界大于上边界(null 范围),则构造一个空集。

参数:
lowerBound - 范围的下边界。
upperBound - 范围的上边界。
抛出:
IllegalArgumentException - (未经检查的异常)如果范围为非 null,并且 lowerBound 小于零,则抛出该异常。
方法详细信息

getMembers

public int[][] getMembers()
获取规范数组形式的此整数集属性的成员。返回的数组是“安全的”;客户机可以在不影响此整数集属性的情况下对它进行更改。

返回:
规范数组形式的此整数集属性的成员。

contains

public boolean contains(int x)
确定此整数集属性是否包含给定的值。

参数:
x - 整数值。
返回:
如果此整数集属性包含值 x,则返回 True,否则返回 false。

contains

public boolean contains(IntegerSyntax attribute)
确定此整数集属性是否包含给定的整数属性的值。

参数:
attribute - 整数属性。
返回:
如果此整数集属性包含 theAttribute 的值,则返回 True,否则返回 false。

next

public int next(int x)
确定此整数集属性中的最小整数是否大于给定值。如果此整数集属性中没有任何整数大于给定值,则返回 -1。(由于整数集属性只包含非负值,所以该集合中始终不显示 -1。)可以使用 next() 方法按升序迭代整数集属性中的整数值,如下所示:
     SetOfIntegerSyntax attribute = . . .;
     int i = -1;
     while ((i = attribute.next (i)) != -1)
         {
         foo (i);
         }
 

参数:
x - 整数值。
返回:
此整数集属性中大于 x 的最小整数,如果此整数集属性中没有任何整数大于 x,则返回 -1

equals

public boolean equals(Object object)
返回此整数集属性是否等效于传入的对象。若要等效,以下所有条件都必须为 true:
  1. object 不为 null。
  2. object 是类 SetOfIntegerSyntax 的一个实例。
  3. 此整数集属性的成员和 object 的成员相同。

覆盖:
Object 中的 equals
参数:
object - 要比较的对象。
返回:
如果 object 等效于此整数集属性,则返回 True,否则返回 false。
另请参见:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
返回此整数集属性的哈希码值。哈希码是规范数组形式的范围的上边界和下边界的总数,0 表示空集。

覆盖:
Object 中的 hashCode
返回:
此对象的一个哈希码值。
另请参见:
Object.equals(java.lang.Object), Hashtable

toString

public String toString()
返回对应于此整数集属性的字符串值。如果此集合为空,则字符串值为零长度字符串。否则,字符串值是规范数组形式的范围的逗号分隔的列表,其中,如果下边界等于上边界,则可以将每个范围表示为 "i",否则表示为 "i-j"

覆盖:
Object 中的 toString
返回:
该对象的字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策