// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of "Eclipse Public License v1.0"

 // which accompanies this distribution, and is available

 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 // Abstraction for "an environment" holding pairs of C strings (name, value)

 // 

 //

 #include <e32std.h>

 #include <e32base.h>

 #include <stddef.h> //for wchar_t

 class CEnvironment;

 class TEnvVar

 /**

 @internalComponent

 */

 	{

 	friend class CEnvironment;	// who manages my storage

 public:

 	void Release();

 	void ConstructL(const TDesC16& aName, const wchar_t* aValue);

 	TInt SetValue(const wchar_t* aValue);

 	HBufC16* Match(const TDesC16& aName);

 	TUint Length() const;

 	const TInt NotEmpty() const { return (TInt)iValue; };

 	static TInt Externalize(const wchar_t* aPair, TDes16& aBuffer);

 	TInt Externalize(TDes16& aBuffer);

 	void ConstructL(const TText16*& aPtr);

 private:

 	static TPtrC16 ValuePtr(const wchar_t* aValue);

 	HBufC16* iName;

 	HBufC16* iValue;		// data is zero terminated

 	};

 NONSHARABLE_CLASS(CEnvironment) : public CBase

 /**

 @internalComponent

 */

 	{

 public:

 	CEnvironment() {};

 	~CEnvironment();

 	wchar_t* getenv(const wchar_t* aName) const;

 	int setenv(const wchar_t* aName, const wchar_t* aValue, int aReplace, int& anErrno);

 	void unsetenv(const wchar_t* aName);

 	void ConstructL(TUint aCount, TDes16& aBuffer);

 	HBufC16* ExternalizeLC(TUint& aCount);

 	HBufC16* ExternalizeLC(TUint& aCount, wchar_t** envp);

 private:

 	TUint iCount;

 	TEnvVar* iVars;

 	};