Partition (Función)

  • Artículo

Actualización: noviembre 2007

Devuelve una cadena que representa el intervalo calculado que contiene un número.

Public Function Partition( _
   ByVal Number As Long, _ 
   ByVal Start As Long, _ 
   ByVal Stop As Long, _ 
   ByVal Interval As Long _
) As String

Parámetros

  • Number
    Obligatorio. Long. Número entero que se desea ubicar en uno de los intervalos calculados.

  • Start
    Obligatorio. Long. Número entero que indica el inicio del conjunto de intervalos calculados. Start no puede ser menor que 0.

  • Stop
    Obligatorio. Long. Número entero que indica el final del conjunto de intervalos calculados. Stop no puede ser menor o igual que Start.

  • Interval
    Obligatorio. Long. Número entero que indica el tamaño de cada intervalo calculado entre Start y Stop. Interval no puede ser menor que 1.

Excepciones

Tipo de excepción

Número de error

Condición

ArgumentException

5

Start < 0, Stop <= Start o Interval < 1.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, debe considerarse la posibilidad de sustituir dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

La función Partition calcula un conjunto de intervalos numéricos, cada uno de los cuales contiene el número de valores especificado por Interval. El primer intervalo comienza en Start y el último intervalo finaliza en Stop. A continuación, la función Partition identifica el intervalo que contiene Number y devuelve una cadena que describe ese intervalo. El intervalo se representa en la cadena como "valorInferior:valorSuperior", donde el extremo inicial del intervalo (valorInferior) está separado del extremo final (valorSuperior) por dos puntos (:).

Si es necesario, la función Partition inserta espacios iniciales antes de valorInferior y valorSuperior para que ambos tengan el mismo número de caracteres que la representación de cadena del valor (Stop + 1). Así se asegura de que si se utiliza el resultado de la función Partition con diferentes valores de Number, el texto resultante se controlará correctamente en cualquier operación de ordenación posterior.

En la tabla siguiente se muestran algunas cadenas de ejemplo para los intervalos calculados con tres conjuntos de Start, Stop e Interval. En las columnas "Primer intervalo" y "Último intervalo" se muestran los intervalos más bajos y más altos posibles de acuerdo con los valores de Start y Stop. En las columnas "Antes del primer intervalo" y "Después del último intervalo" se muestran las cadenas devueltas para los valores de Number menores que Start y mayores que Stop, respectivamente.

Start

Stop

Interval

Antes del primer intervalo

Primer intervalo

Último intervalo

Después del último intervalo

0

99

5

"   : -1"

"  0:  4"

" 95: 99"

"100:   "

20

199

10

"   : 19"

" 20: 29"

"190:199"

"200:   "

100

1010

20

"    : 99"

" 100: 119"

"1000:1010"

"1011:    "

En la tabla anterior, la tercera línea muestra el resultado cuando Start y Stop definen un conjunto de números que no se pueden dividir exactamente por Interval. El último intervalo finaliza en Stop, con lo cual su longitud es de sólo 11 números, aunque Interval sea 20.

Si Interval es 1, el intervalo es "Number:Number", independientemente de los argumentos Start y Stop. Por ejemplo, si Number es 267, Stop es 1000 e Interval es 1, Partition devuelve " 267: 267".

La función Partition puede resultar útil cuando se crean consultas de base de datos. Puede crear una consulta SELECT que muestre cuántos pedidos se producen en distintos intervalos de valores, por ejemplo con valores de facturas de 1 a 1000, de 1001 a 2000, etc.

Ejemplo

En el siguiente ejemplo se ha definido una serie de intervalos para las décadas comprendidas entre 1950 y 2049. El valor de year se localiza en el intervalo adecuado y se devuelve un valor String que muestra el intervalo. Si el valor de year es, por ejemplo, 1984, Partition devuelve "1980:1989".

Dim year As Long = 1984
' Assume the value of year is provided by data or by user input.
Dim decade As String
decade = Partition(year, 1950, 2049, 10)
MsgBox("Year " & CStr(year) & " is in decade " & decade & ".")

Requisitos

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**Interaction

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Referencia

Miembros de la biblioteca en tiempo de ejecución de Visual Basic

Módulo Interaction (Visual Basic)