nuclear@0: /*
nuclear@0: Open Asset Import Library (assimp)
nuclear@0: ----------------------------------------------------------------------
nuclear@0: 
nuclear@0: Copyright (c) 2006-2012, assimp team
nuclear@0: All rights reserved.
nuclear@0: 
nuclear@0: Redistribution and use of this software in source and binary forms, 
nuclear@0: with or without modification, are permitted provided that the 
nuclear@0: following conditions are met:
nuclear@0: 
nuclear@0: * Redistributions of source code must retain the above
nuclear@0:   copyright notice, this list of conditions and the
nuclear@0:   following disclaimer.
nuclear@0: 
nuclear@0: * Redistributions in binary form must reproduce the above
nuclear@0:   copyright notice, this list of conditions and the
nuclear@0:   following disclaimer in the documentation and/or other
nuclear@0:   materials provided with the distribution.
nuclear@0: 
nuclear@0: * Neither the name of the assimp team, nor the names of its
nuclear@0:   contributors may be used to endorse or promote products
nuclear@0:   derived from this software without specific prior
nuclear@0:   written permission of the assimp team.
nuclear@0: 
nuclear@0: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
nuclear@0: "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
nuclear@0: LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
nuclear@0: A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
nuclear@0: OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
nuclear@0: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
nuclear@0: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
nuclear@0: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
nuclear@0: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
nuclear@0: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
nuclear@0: OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
nuclear@0: 
nuclear@0: ----------------------------------------------------------------------
nuclear@0: */
nuclear@0: 
nuclear@0: 
nuclear@0: /** @file ParsingUtils.h
nuclear@0:  *  @brief Defines helper functions for text parsing 
nuclear@0:  */
nuclear@0: #ifndef AI_PARSING_UTILS_H_INC
nuclear@0: #define AI_PARSING_UTILS_H_INC
nuclear@0: 
nuclear@0: #include "StringComparison.h"
nuclear@0: namespace Assimp {
nuclear@0: 
nuclear@0: 	// NOTE: the functions below are mostly intended as replacement for
nuclear@0: 	// std::upper, std::lower, std::isupper, std::islower, std::isspace.
nuclear@0: 	// we don't bother of locales. We don't want them. We want reliable
nuclear@0: 	// (i.e. identical) results across all locales.
nuclear@0: 
nuclear@0: 	// The functions below accept any character type, but know only
nuclear@0: 	// about ASCII. However, UTF-32 is the only safe ASCII superset to
nuclear@0: 	// use since it doesn't have multibyte sequences.
nuclear@0: 
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE char_t ToLower( char_t in)
nuclear@0: {
nuclear@0: 	return (in >= (char_t)'A' && in <= (char_t)'Z') ? (char_t)(in+0x20) : in;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE char_t ToUpper( char_t in)
nuclear@0: {
nuclear@0: 	return (in >= (char_t)'a' && in <= (char_t)'z') ? (char_t)(in-0x20) : in;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsUpper( char_t in)
nuclear@0: {
nuclear@0: 	return (in >= (char_t)'A' && in <= (char_t)'Z');
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsLower( char_t in)
nuclear@0: {
nuclear@0: 	return (in >= (char_t)'a' && in <= (char_t)'z');
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsSpace( char_t in)
nuclear@0: {
nuclear@0: 	return (in == (char_t)' ' || in == (char_t)'\t');
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsLineEnd( char_t in)
nuclear@0: {
nuclear@0: 	return (in == (char_t)'\r' || in == (char_t)'\n' || in == (char_t)'\0');
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsSpaceOrNewLine( char_t in)
nuclear@0: {
nuclear@0: 	return IsSpace<char_t>(in) || IsLineEnd<char_t>(in);
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool SkipSpaces( const char_t* in, const char_t** out)
nuclear@0: {
nuclear@0: 	while (*in == (char_t)' ' || *in == (char_t)'\t')in++;
nuclear@0: 	*out = in;
nuclear@0: 	return !IsLineEnd<char_t>(*in);
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool SkipSpaces( const char_t** inout)
nuclear@0: {
nuclear@0: 	return SkipSpaces<char_t>(*inout,inout);
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: inline bool SkipLine( const char_t* in, const char_t** out)
nuclear@0: {
nuclear@0: 	while (*in != (char_t)'\r' && *in != (char_t)'\n' && *in != (char_t)'\0')in++;
nuclear@0: 
nuclear@0: 	// files are opened in binary mode. Ergo there are both NL and CR
nuclear@0: 	while (*in == (char_t)'\r' || *in == (char_t)'\n')in++;
nuclear@0: 	*out = in;
nuclear@0: 	return *in != (char_t)'\0';
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: inline bool SkipLine( const char_t** inout)
nuclear@0: {
nuclear@0: 	return SkipLine<char_t>(*inout,inout);
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: inline bool SkipSpacesAndLineEnd( const char_t* in, const char_t** out)
nuclear@0: {
nuclear@0: 	while (*in == (char_t)' ' || *in == (char_t)'\t' ||
nuclear@0: 		*in == (char_t)'\r' || *in == (char_t)'\n')in++;
nuclear@0: 	*out = in;
nuclear@0: 	return *in != '\0';
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: inline bool SkipSpacesAndLineEnd( const char_t** inout)
nuclear@0: {
nuclear@0: 	return SkipSpacesAndLineEnd<char_t>(*inout,inout);
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: inline bool GetNextLine(const char_t*& buffer, char_t out[4096])
nuclear@0: {
nuclear@0: 	if ((char_t)'\0' == *buffer)return false;
nuclear@0: 
nuclear@0: 	char* _out = out;
nuclear@0: 	char* const end = _out+4096;
nuclear@0: 	while (!IsLineEnd( *buffer ) && _out < end)
nuclear@0: 		*_out++ = *buffer++;
nuclear@0: 	*_out = (char_t)'\0';
nuclear@0: 
nuclear@0: 	while (IsLineEnd( *buffer ) && '\0' != *buffer)++buffer;
nuclear@0: 	return true;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool IsNumeric( char_t in)
nuclear@0: {
nuclear@0: 	return ( in >= '0' && in <= '9' ) || '-' == in || '+' == in;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: template <class char_t>
nuclear@0: AI_FORCE_INLINE bool TokenMatch(char_t*& in, const char* token, unsigned int len)
nuclear@0: {
nuclear@0: 	if (!::strncmp(token,in,len) && IsSpaceOrNewLine(in[len]))
nuclear@0: 	{
nuclear@0: 		in += len+1;
nuclear@0: 		return true;
nuclear@0: 	}
nuclear@0: 	return false;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: /** @brief Case-ignoring version of TokenMatch
nuclear@0:  *  @param in Input
nuclear@0:  *  @param token Token to check for
nuclear@0:  *  @param len Number of characters to check
nuclear@0:  */
nuclear@0: AI_FORCE_INLINE bool TokenMatchI(const char*& in, const char* token, unsigned int len)
nuclear@0: {
nuclear@0: 	if (!ASSIMP_strincmp(token,in,len) && IsSpaceOrNewLine(in[len]))
nuclear@0: 	{
nuclear@0: 		in += len+1;
nuclear@0: 		return true;
nuclear@0: 	}
nuclear@0: 	return false;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: AI_FORCE_INLINE void SkipToken(const char*& in)
nuclear@0: {
nuclear@0: 	SkipSpaces(&in);
nuclear@0: 	while (!IsSpaceOrNewLine(*in))++in;
nuclear@0: }
nuclear@0: // ---------------------------------------------------------------------------------
nuclear@0: AI_FORCE_INLINE std::string GetNextToken(const char*& in)
nuclear@0: {
nuclear@0: 	SkipSpacesAndLineEnd(&in);
nuclear@0: 	const char* cur = in;
nuclear@0: 	while (!IsSpaceOrNewLine(*in))++in;
nuclear@0: 	return std::string(cur,(size_t)(in-cur));
nuclear@0: }
nuclear@0: } // ! namespace Assimp
nuclear@0: #endif // ! AI_PARSING_UTILS_H_INC