git.saurik.com Git - apple/icu.git/blame_incremental - icuSources/tools/toolutil/toolutil.h

... / ...

Commit	Line	Data
	1	/*
	2	*******************************************************************************
	3	*
	4	* Copyright (C) 1999-2005, International Business Machines
	5	* Corporation and others. All Rights Reserved.
	6	*
	7	*******************************************************************************
	8	* file name: toolutil.h
	9	* encoding: US-ASCII
	10	* tab size: 8 (not used)
	11	* indentation:4
	12	*
	13	* created on: 1999nov19
	14	* created by: Markus W. Scherer
	15	*
	16	* This file defines utility functions for ICU tools like genccode.
	17	*/
	18
	19	#ifndef __TOOLUTIL_H__
	20	#define __TOOLUTIL_H__
	21
	22	#include "unicode/utypes.h"
	23
	24	/*
	25	* For Windows, a path/filename may be the short (8.3) version
	26	* of the "real", long one. In this case, the short one
	27	* is abbreviated and contains a tilde etc.
	28	* This function returns a pointer to the original pathname
	29	* if it is the "real" one itself, and a pointer to a static
	30	* buffer (not thread-safe) containing the long version
	31	* if the pathname is indeed abbreviated.
	32	*
	33	* On platforms other than Windows, this function always returns
	34	* the input pathname pointer.
	35	*
	36	* This function is especially useful in tools that are called
	37	* by a batch file for loop, which yields short pathnames on Win9x.
	38	*/
	39	U_CAPI const char * U_EXPORT2
	40	getLongPathname(const char *pathname);
	41
	42	/*
	43	* Find the basename at the end of a pathname, i.e., the part
	44	* after the last file separator, and return a pointer
	45	* to this part of the pathname.
	46	* If the pathname only contains a basename and no file separator,
	47	* then the pathname pointer itself is returned.
	48	*/
	49	U_CAPI const char * U_EXPORT2
	50	findBasename(const char *filename);
	51
	52	/*
	53	* Creates a diretory with pathname.
	54	*
	55	* @param status Set to an error code when mkdir failed.
	56	*/
	57	U_CAPI void U_EXPORT2
	58	uprv_mkdir(const char pathname, UErrorCode status);
	59
	60	/*
	61	* UToolMemory is used for generic, custom memory management.
	62	* It is allocated with enough space for count*size bytes starting
	63	* at array.
	64	* The array is declared with a union of large data types so
	65	* that its base address is aligned for any types.
	66	* If size is a multiple of a data type size, then such items
	67	* can be safely allocated inside the array, at offsets that
	68	* are themselves multiples of size.
	69	*/
	70	struct UToolMemory;
	71	typedef struct UToolMemory UToolMemory;
	72
	73	/**
	74	* Open a UToolMemory object for allocation of initialCapacity to maxCapacity
	75	* items with size bytes each.
	76	*/
	77	U_CAPI UToolMemory * U_EXPORT2
	78	utm_open(const char *name, int32_t initialCapacity, int32_t maxCapacity, int32_t size);
	79
	80	/**
	81	* Close a UToolMemory object.
	82	*/
	83	U_CAPI void U_EXPORT2
	84	utm_close(UToolMemory *mem);
	85
	86	/**
	87	* Get the pointer to the beginning of the array of items.
	88	* The pointer becomes invalid after allocation of new items.
	89	*/
	90	U_CAPI void * U_EXPORT2
	91	utm_getStart(UToolMemory *mem);
	92
	93	/**
	94	* Get the current number of items.
	95	*/
	96	U_CAPI int32_t U_EXPORT2
	97	utm_countItems(UToolMemory *mem);
	98
	99	/**
	100	* Allocate one more item and return the pointer to its start in the array.
	101	*/
	102	U_CAPI void * U_EXPORT2
	103	utm_alloc(UToolMemory *mem);
	104
	105	/**
	106	* Allocate n items and return the pointer to the start of the first one in the array.
	107	*/
	108	U_CAPI void * U_EXPORT2
	109	utm_allocN(UToolMemory *mem, int32_t n);
	110
	111	#endif