1 /* $NetBSD: aliaslist.h,v 1.4 2014/12/10 04:37:55 christos Exp $ */ 2 3 /* Id: aliaslist.h,v 1.1 2003/06/04 00:25:34 marka Exp */ 4 /* 5 * Copyright (c) 2002 Japan Network Information Center. All rights reserved. 6 * 7 * By using this file, you agree to the terms and conditions set forth bellow. 8 * 9 * LICENSE TERMS AND CONDITIONS 10 * 11 * The following License Terms and Conditions apply, unless a different 12 * license is obtained from Japan Network Information Center ("JPNIC"), 13 * a Japanese association, Kokusai-Kougyou-Kanda Bldg 6F, 2-3-4 Uchi-Kanda, 14 * Chiyoda-ku, Tokyo 101-0047, Japan. 15 * 16 * 1. Use, Modification and Redistribution (including distribution of any 17 * modified or derived work) in source and/or binary forms is permitted 18 * under this License Terms and Conditions. 19 * 20 * 2. Redistribution of source code must retain the copyright notices as they 21 * appear in each source code file, this License Terms and Conditions. 22 * 23 * 3. Redistribution in binary form must reproduce the Copyright Notice, 24 * this License Terms and Conditions, in the documentation and/or other 25 * materials provided with the distribution. For the purposes of binary 26 * distribution the "Copyright Notice" refers to the following language: 27 * "Copyright (c) 2000-2002 Japan Network Information Center. All rights reserved." 28 * 29 * 4. The name of JPNIC may not be used to endorse or promote products 30 * derived from this Software without specific prior written approval of 31 * JPNIC. 32 * 33 * 5. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY JPNIC 34 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 35 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 36 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JPNIC BE LIABLE 37 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 38 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 39 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 40 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 41 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 42 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 43 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 44 */ 45 46 #ifndef IDN_ALIASLIST_H 47 #define IDN_ALIASLIST_H 1 48 49 #include <idn/result.h> 50 51 #ifdef __cplusplus 52 extern "C" { 53 #endif 54 55 typedef struct idn__aliaslist *idn__aliaslist_t; 56 57 /* 58 * Create a list. 59 * 60 * Returns: 61 * idn_success -- ok. 62 * idn_nomemory -- malloc failed. 63 */ 64 extern idn_result_t 65 idn__aliaslist_create(idn__aliaslist_t *listp); 66 67 /* 68 * Delete a list created by 'idn__aliaslist_create'. 69 */ 70 extern void 71 idn__aliaslist_destroy(idn__aliaslist_t list); 72 73 /* 74 * Parse alias information file and set items to the list. 75 * 76 * Returns: 77 * idn_success -- ok. 78 * idn_nofile -- no such file. 79 * idn_invalid_syntax -- file is malformed. 80 * idn_nomemory -- malloc failed. 81 */ 82 extern idn_result_t 83 idn__aliaslist_aliasfile(idn__aliaslist_t list, const char *path); 84 85 /* 86 * Add an item to the list. 87 * 88 * If top is 0, item is placed as the last item of the alias list. 89 * Otherwise, it is done as the first item. 90 * 91 * Returns: 92 * idn_success -- ok. 93 * idn_nomemory -- malloc failed. 94 */ 95 extern idn_result_t 96 idn__aliaslist_additem(idn__aliaslist_t list, 97 const char *pattern, const char *encoding, 98 int first_item); 99 100 /* 101 * Find the encoding name with the specified pattern by wildcard 102 * match. 103 * 104 * Returns: 105 * idn_success -- ok. found. 106 * idn_noentry -- not found. 107 */ 108 extern idn_result_t 109 idn__aliaslist_find(idn__aliaslist_t list, 110 const char *pattern, char **encodingp); 111 112 #ifdef __cplusplus 113 } 114 #endif 115 116 #endif /* IDN_ALIASLIST_H */ 117