00001 /* Copyright 2005 The Apache Software Foundation or its licensors, as 00002 * applicable. 00003 * 00004 * Licensed under the Apache License, Version 2.0 (the "License"); 00005 * you may not use this file except in compliance with the License. 00006 * You may obtain a copy of the License at 00007 * 00008 * http://www.apache.org/licenses/LICENSE-2.0 00009 * 00010 * Unless required by applicable law or agreed to in writing, software 00011 * distributed under the License is distributed on an "AS IS" BASIS, 00012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 00013 * See the License for the specific language governing permissions and 00014 * limitations under the License. 00015 */ 00016 00017 /** 00018 * @file lcn_fielddata.h 00019 * @brief Routines for manipulating a segment's field data file 00020 */ 00021 00022 #ifndef _LCN_FIELDDATA_H 00023 #define _LCN_FIELDDATA_H 00024 00025 #include "lcn_types.h" 00026 #include "lcn_directory.h" 00027 #include "lcn_field.h" 00028 00029 #include <apr_tables.h> 00030 00031 #ifdef __cplusplus 00032 extern "C" { 00033 #endif /* __cplusplus */ 00034 00035 /** Opaque structure representing a segment's field data. */ 00036 typedef struct lcn_fielddata_t lcn_fielddata_t; 00037 00038 /** Return the field data @a fd for segment @a s in directory @a d, allocated 00039 * within @a pool. 00040 */ 00041 lcn_error_t * 00042 lcn_fielddata_open (lcn_fielddata_t **fd, 00043 const lcn_directory_t *d, 00044 const lcn_char_t *s, 00045 apr_pool_t *pool); 00046 00047 /** Returns in @a doc an array of @c lcn_field_t pointers associated with 00048 * document number @a doc_num, allocated within @a pool. 00049 */ 00050 lcn_error_t * 00051 lcn_fielddata_get_doc (apr_array_header_t **doc, 00052 lcn_fielddata_t *fd, 00053 apr_uint32_t doc_num, 00054 apr_pool_t *pool); 00055 00056 #ifdef __cplusplus 00057 } 00058 #endif /* __cplusplus */ 00059 00060 #endif