/[drupal]/contributions/modules/node_import/node_import.inc

Diff of /contributions/modules/node_import/node_import.inc

Parent Directory | Revision Log | View Revision Graph Revision Graph | View Patch Patch

-revision 1.1.2.22,
Tue Dec 16 22:12:23 2008 UTC
+revision 1.1.2.23,
Thu Jan  1 09:49:31 2009 UTC
 Line 1
  <?php
- // $Id: node_import.inc,v 1.1.2.21 2008/12/16 13:55:06 robrechtj Exp $
+ // $Id: node_import.inc,v 1.1.2.22 2008/12/16 22:12:23 robrechtj Exp $
  /**
   * @file
 Line 1045 
 function node_import_check_node(&$value,
   */
  /**
+  * @defgroup node_import_util Various node import utility functions.
+  * @{
+  */
+ /**
+  * Store an object-id in the node_import cache.
+  *
+  * As some string->object-id lookups can be expensive (in db queries) and
+  * most of the time the same strings are looked up (eg users), we have a
+  * cache of object-ids we already have looked up.
+  *
+  * This function is used to store an object-id in the cache.
+  *
+  * @param $type
+  *   String. The type of object (eg 'user').
+  *
+  * @param $value
+  *   String or array. The value we haved looked up.
+  *
+  * @param $oid
+  *   Integer. The looked-up object-id. If NULL, the currently stored
+  *   object-id is returned without setting the $type/$value to NULL.
+  *   If you want to reset (eg make it NULL) a value, use
+  *   @code
+  *   node_import_set_object($type, $value, NULL, TRUE);
+  *   @endcode
+  *
+  * @param $reset
+  *   Boolean. Whether to reset the cache. If $type is NULL, the whole
+  *   cache is reset. If $value is not NULL only the cache for that
+  *   specific $type/$value is reset.
+  *
+  * @return
+  *   Integer. The looked-up object-id.
+  *
+  * @see node_import_get_object().
+  */
+ function node_import_set_object($type, $value, $oid = NULL, $reset = FALSE) {
+   static $cache;
+   if (!isset($cache)) {
+     $cache = array();
+   }
+   if (isset($type) && !isset($cache[$type])) {
+     $cache[$type] = array();
+   }
+   $stored_value = NULL;
+   if (isset($value)) {
+     $stored_value = is_array($value) ? implode("\n", array_map('drupal_strtolower', $value)) : drupal_strtolower($value);
+   }
+   if ($reset) {
+     if (isset($type)) {
+       if (isset($value)) {
+         unset($cache[$type][$stored_value]);
+       }
+       else {
+         $cache[$type] = array();
+       }
+     }
+     else {
+       $cache = array();
+     }
+     return;
+   }
+   if (isset($oid)) {
+     $cache[$type][$stored_value] = $oid;
+   }
+   return $cache[$type][$stored_value];
+ }
+ /**
+  * Get an object-id from the node_import cache.
+  *
+  * @param $type
+  *   String. The type of object (eg 'user').
+  *
+  * @param $value
+  *   String or array. The value to get the object-id of.
+  *
+  * @return
+  *   NULL if not yet in cache. Otherwise an integer.
+  *
+  * @see node_import_set_object().
+  */
+ function node_import_get_object($type, $value) {
+   return node_import_set_object($type, $value);
+ }
+ /**
   * Get a property from each element of an array.
   *
   * @param $array
-Line 1109 
 function node_import_input_error($messag
+Line 1202 
 function node_import_input_error($messag
  }
  /**
+  * @}
+  */
+ /**
   * @defgroup node_import_files Node import file functions
   * @{
+  */
  /**
   * Returns a list of available files.

 Legend:



Removed from v.1.1.2.22
 


changed lines


 
Added in v.1.1.2.23
 Legend:



Removed from v.1.1.2.22
 


changed lines


 
Added in v.1.1.2.23
-Removed from v.1.1.2.22
+Added in v.1.1.2.23

	ViewVC Help
Powered by ViewVC 1.1.2