spss.Cursor Clase (Python)

spss.Cursor (var, accessType, cvtDates, isBinary ). Proporciona la posibilidad de leer casos, añadir casos y añadir nuevas variables al conjunto de datos activo.

  • El argumento opcional var especifica una tupla o una lista de valores de índice de variables que representan la posición en el conjunto de datos activo, empezando por 0 para la primera variable en orden de archivo. Este argumento se utiliza en modalidad de lectura o escritura para especificar un subconjunto de variables a devolver al leer datos de caso del conjunto de datos activo. Si se omite el argumento, se devuelven todas las variables. El argumento no tiene ningún efecto si se utiliza en modalidad de adición.
  • El argumento opcional accessType especifica una de las tres modalidades de uso: lectura ('r '), escritura ('w') y adición ('a '). El valor predeterminado es la modalidad de lectura.
  • El argumento opcional cvtDates especifica un conjunto de variables IBM® SPSS® Statistics con formatos de fecha o fecha y hora para convertir a objetos Python datetime.datetime al leer datos de IBM SPSS Statistics. El argumento es una secuencia de valores de índice de variables que representan la posición en el conjunto de datos activo, empezando por 0 para la primera variable en orden de archivo. Si se especifica el argumento opcional var , cvtDates debe ser un subconjunto de los valores de índice especificados para var. Puede especificar convertir todas las variables de formato de fecha o fecha y hora con cvtDates='ALL', o estableciendo cvtDates en una lista o tupla con el único elemento 'ALL', como en cvtDates=['ALL']. Cuando se especifica 'ALL' junto con var, hace referencia a todas las variables especificadas en var. Si se omite cvtDates , no se realizará ninguna conversión. Las variables incluidas en cvtDates que no tienen un formato de fecha o fecha y hora se ignoran en términos de la conversión. cvtDates se aplica a la modalidad de lectura y escritura y no se puede utilizar en la modalidad de adición.

    Nota: Los valores de las variables con formatos de fecha o fecha y hora que no se convierten con cvtDates se devuelven como enteros que representan el número de segundos a partir del 14 de octubre de 1582.

  • El argumento booleano opcional isBinary (introducido en la versión 22) especifica el método que utiliza la clase Cursor para trabajar con los datos del conjunto de datos activo. No tiene ningún efecto en la funcionalidad de Cursor . De forma predeterminada, isBinary se establece en True, que normalmente proporciona el mejor rendimiento, pero puede necesitar más espacio de disco temporal. Cuando isBinary se establece en False, la clase Cursor utiliza el mismo método para trabajar con los datos que en las versiones anteriores a la versión 22.
  • No puede utilizar la función spss.Submit mientras esté abierto un cursor de datos. Primero debe cerrar o suprimir el cursor.
  • Sólo un cursor de datos puede estar abierto en cualquier punto del bloque de programa. Para definir un cursor de datos nuevo, primero debe cerrar o suprimir el anterior. Si necesita trabajar simultáneamente con los datos de varios conjuntos de datos, considere la posibilidad de utilizar la clase Dataset .
  • Las instancias de la clase Cursor se suprimen implícitamente al final de un bloque BEGIN PROGRAM-END PROGRAM y, por lo tanto, no persisten en los bloques BEGIN PROGRAM-END PROGRAM .
  • La clase Cursor respeta los filtros de mayúsculas y minúsculas especificados con los mandatos FILTER o USE .