2.6.1 Objetos IC

Los objetos IC tienen un interfaz tipo diccionario, por lo que para obtener la dirección de correo, basta con obtener ic['MailAddress']. Es posible la asignación, que cambia la opción en el fichero de configuración.

Este módulo puede tratar con varios tipos de datos y convierte la representación interna de IC a una estructura de datos Python ``lógica''. Si se ejecuta el módulo ic mismo, se lanza un programa de pruebas que enumera todas las claves y valores de la base de datos IC. Se puede tomar esto como documentación.

Si el módulo no puede representar los datos, devuelve una instancia de tipo ICOpaqueData que contiene los datos en bruto en su atributo data. Los objetos de este tipo son valores aceptables para asignarlos.

Además del interfaz por claves, los objetos IC poseen los siguientes métodos:

launchurl (url[, hint]): Analiza la URL dada, lanza la aplicación adecuada y le pasa la URL. El parámetro opcional hint puede ser un nombre de esquema, tal como 'mailto:', en cuyo caso se completan las URLs incompletas con dicho esquema. Si no se proporciona hint, se consideran incorrectas las direcciones incompletas.

parseurl (data[, start[, end[, hint]]]): Localiza una URL en algún lugar de data y devuelve la posición inicial de dicha URL, su final y la URL. Se puede usar los argumentos opcionales start (inicio) y end (fin) para delimitar la búsqueda. De este modo, si el usuario hace clic en un campo de texto largo, se puede pasar el campo de texto completo y la posición del clic en start; la rutina devolverá la URL completa en la que hizo clic el usuario. Del mismo modo que se explicó antes, hint es un esquema opcional para completar URLs incompletas.

mapfile (file): Devuelve una entrada de correspondencias del fichero file dado, que se puede pasar como nombre de fichero o como resultado de una función macfs.FSSpec(), y que no es necesario que exista.
La entrada de correspondencias se devuelve como una tupla (version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname), donde version es el número de versión de la entrada, type es el tipo de fichero de 4 caracteres, creator es el tipo de creador de 4 caracteres, postcreator es el código de creador de 4 caracteres de una aplicación opcional para post-procesar el fichero tras la descarga. flags son varios bits que especifican si la transferencia es en binario y similares, extension es la extensión de fichero de este tipo de fichero, appname es el nombre imprimible de la aplicación a la que pertenece este fichero, postappname es el nombre de la aplicación de post-proceso, mimetype es el tipo MIME del fichero y entryname es el nombre de la entrada.

maptypecreator (type, creator[, filename]): Devuelve la entrada de correspondencia de los ficheros con el tipo type y código de creador creator de 4 caracteres dados. Puede especificarse el nombre de fichero filename opcional para ayuda adicional para encontrar la entrada correcta (si el código de creador es '????', por ejemplo).
La entrada de correspondencia se devuelve en el mismo formato que mapfile.

settypecreator (file): Dado un fichero file existente, especificado como nombre de fichero o como resultado de macfs.FSSpec(), establece su creador y tipo correctos, basándose en su extensión. Se le notifica a finder el cambio, por lo que el icono se actualizará rápidamente.

Ver Sobre este documento... para obtener información sobre sugerencias.