From 34fd857a23ba247f95fb9989b86d5e13433db2df Mon Sep 17 00:00:00 2001
From: cherierm <cherierm@48e7efb5-ca39-0410-a469-dd3cf9ba447f>
Date: Wed, 11 Apr 2007 14:27:42 +0000
Subject: [PATCH] the trim.c file header

git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/simgrid/simgrid/trunk@3372 48e7efb5-ca39-0410-a469-dd3cf9ba447f
---
 include/xbt/trim.h | 85 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 include/xbt/trim.h

diff --git a/include/xbt/trim.h b/include/xbt/trim.h
new file mode 100644
index 0000000000..243be327a5
--- /dev/null
+++ b/include/xbt/trim.h
@@ -0,0 +1,85 @@
+/* xbt/trim.h -- Declarations of the functions ltrim(), rtrim() and trim()	*/
+
+/* Copyright (c) 2007 Cherier Malek. All rights reserved.					*/
+
+/* This program is free software; you can redistribute it and/or modify it
+ * under the terms of the license (GNU LGPL) which comes with this package. */
+
+
+#ifndef XBT_TRIM_H
+#define XBT_TRIM_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**  @brief Strip whitespace (or other characters) from the end of a string.
+ *
+ * The function rtrim() returns a string with whitespace stripped from the end of s. 
+ * By default (without the second parameter char_list), rtrim() will strip these characters :
+ * 	
+ *	- " "		(ASCII 32	(0x20))	space. 
+ *	- "\t"		(ASCII 9	(0x09))	tab. 
+ *	- "\n"		(ASCII 10	(0x0A))	line feed. 
+ *	- "\r"		(ASCII 13	(0x0D))	carriage return. 
+ *	- "\0"		(ASCII 0	(0x00))	NULL. 
+ *	- "\x0B"	(ASCII 11	(0x0B))	vertical tab. 
+ *
+ * @param s The string to strip.
+ * @param char_list A string which contains the characters you want to strip.
+ *
+ * @return If the specified is NULL the function returns NULL. Otherwise the
+ * function returns the string with whitespace stripped from the end.
+ */
+char*
+rtrim(char* s, const char* char_list);
+
+/**  @brief Strip whitespace (or other characters) from the beginning of a string.
+ *
+ * The function ltrim() returns a string with whitespace stripped from the beginning of s. 
+ * By default (without the second parameter char_list), ltrim() will strip these characters :
+ * 	
+ *	- " "		(ASCII 32	(0x20))	space. 
+ *	- "\t"		(ASCII 9	(0x09))	tab. 
+ *	- "\n"		(ASCII 10	(0x0A))	line feed. 
+ *	- "\r"		(ASCII 13	(0x0D))	carriage return. 
+ *	- "\0"		(ASCII 0	(0x00))	NULL. 
+ *	- "\x0B"	(ASCII 11	(0x0B))	vertical tab. 
+ *
+ * @param s The string to strip.
+ * @param char_list A string which contains the characters you want to strip.
+ *
+ * @return If the specified is NULL the function returns NULL. Otherwise the
+ * function returns the string with whitespace stripped from the beginning.
+ */
+char*
+ltrim( char* s, const char* char_list);
+
+
+/**  @brief Strip whitespace (or other characters) from the end and the begining of a string.
+ *
+ * The function trim() returns a string with whitespace stripped from the end and the begining of s. 
+ * By default (without the second parameter char_list), trim() will strip these characters :
+ * 	
+ *	- " "		(ASCII 32	(0x20))	space. 
+ *	- "\t"		(ASCII 9	(0x09))	tab. 
+ *	- "\n"		(ASCII 10	(0x0A))	line feed. 
+ *	- "\r"		(ASCII 13	(0x0D))	carriage return. 
+ *	- "\0"		(ASCII 0	(0x00))	NULL. 
+ *	- "\x0B"	(ASCII 11	(0x0B))	vertical tab. 
+ *
+ * @param s The string to strip.
+ * @param char_list A string which contains the characters you want to strip.
+ *
+ * @return If the specified is NULL the function returns NULL. Otherwise the
+ * function returns the string with whitespace stripped from the end and the begining.
+ */
+char* 
+trim(char* s, const char* char_list);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* !XBT_TRIM_H */ 
\ No newline at end of file
-- 
2.20.1