Manipulate strings. More...

#include <MString.h>

Public Member Functions
	MString ()
	The Class constructor. More...

	MString (const char *charString)
	Class constructor. More...

	MString (const wchar_t *charString)
	Class constructor. More...

	MString (const char *charString, int charLength)
	Class constructor. More...

	MString (const wchar_t *charString, int wcharLength)
	Class constructor. More...

	MString (const MString &other)
	Copy constructor. More...

	~MString ()
	The class destructor.

MString &	operator+= (const MString &other)
	In-place addition with another MString. More...

MString &	operator+= (const char *other)
	In-place addition with a C++ string. More...

MString &	operator+= (double other)
	In-place addition with a double value. More...

MString &	operator+= (int other)
	In-place addition with an int value. More...

MString &	operator+= (unsigned int other)
	In-place addition with an unsigned int value. More...

MString &	operator+= (float other)
	In-place addition with a float value. More...

MString &	operator= (const MString &other)
	Assignment operator. More...

MString &	operator= (const char *other)
	Assignment operator. More...

MString &	operator= (double value)
	Assignment operator. More...

bool	operator== (const MString &other) const
	Equality operator. More...

bool	operator== (const char *other) const
	Equality operator. More...

bool	operator!= (const MString &other) const
	Inequality operator. More...

bool	operator!= (const char *other) const
	Inequality operator. More...

MString	operator+ (const MString &other) const
	Addition with another MString. More...

MString	operator+ (const char *other) const
	Addition with a C++ string. More...

MString	operator+ (double value) const
	Addition with a double value. More...

MStatus	set (const char *charString)
	Set the value of the string in this MString instance. More...

MStatus	setUTF8 (const char *utf8String)
	Set the value of the string in this MString instance using a null-terminated utf-8 encoded character string. More...

MStatus	setWChar (const wchar_t *wcharString)
	Set the value of the string in this MString instance using a null-terminated wide character string. More...

MStatus	set (const char *charString, int charLength)
	Set the value of the string in this MString instance to the value of the character buffer passed. More...

MStatus	setWChar (const wchar_t *wcharString, int wcharLength)
	Set the value of the string in this MString instance using a wide string and its length. More...

MStatus	set (double value)
	Set the value of the string in this MString instance. More...

MStatus	set (double value, int precision)
	Set the value of the string in this MString instance, with the given precision. More...

const char *	asChar () const
	Return the current string in this MString instance as a C++ char* pointer. More...

const char *	asChar (int &charLength) const
	Return the current string in this MString instance as a C++ char* pointer. More...

const char *	asUTF8 () const
	Return the current string in this MString instance as a C++ char* pointer to a null-terminated utf-8 encoded string. More...

const char *	asUTF8 (int &utf8Length) const
	Return the current string in this MString instance as a C++ char* pointer to a null-terminated utf-8 encoded string. More...

const wchar_t *	asWChar () const
	Return the current string in this MString instance as pointer to a null terminated wide character (wchar_t) buffer. More...

const wchar_t *	asWChar (int &numChars) const
	Return the current string in this MString instance as pointer to a null terminated wide character (wchar_t) buffer. More...

unsigned int	length () const
	Returns the length of the string buffer in this MString instance. More...

unsigned int	numChars () const
	Returns the number of characters in the MString instance. More...

void	clear ()
	Clears the contents of this MString instance and sets it value to the empty string.

bool	isEmpty () const
	Introduced in 2023.0 More...

int	index (char) const
	Returns the position of the first occurrence of the character searchChar in the string or -1 if the character is not found. More...

int	indexW (char) const
	Returns the position of the first occurrence of the character searchChar in the string or -1 if the character is not found. More...

int	indexW (wchar_t) const
	Returns the position of the first occurrence of the wide character searchChar in the string or -1 if the character is not found. More...

int	indexW (const MString &) const
	Returns the position of the first occurrence of the searchString in the string or -1 if it is not found. More...

int	rindex (char) const
	Returns the position of the last occurrence of the character searchChar in the string or -1 if the character is not found. More...

int	rindexW (char) const
	Returns the position of the last occurrence of the character searchChar in the string or -1 if the character is not found. More...

int	rindexW (wchar_t) const
	Returns the position of the last occurrence of the wide character searchChar in the string or -1 if the character is not found. More...

int	rindexW (const MString &) const
	Returns the position of the last occurrence of the searchString in the string or -1 if it is not found. More...

MStatus	split (char, MStringArray &) const
	Split the string up at each occurrence of theChar and place the separate strings into theArray. More...

MStatus	split (wchar_t, MStringArray &) const
	Split the string up at each occurrence of the given wide character and place the separate strings into theArray. More...

MString	substring (int start, int end) const
	Return a new MString instance that contains the characters from start to end inclusive. More...

MString	substringW (int start, int end) const
	Return a new MString instance that contains the characters from start to end inclusive. More...

MString &	toUpperCase ()
	Modify the current instance of the string replacing all lower case characters in the corresponding upper case characters. More...

MString &	toLowerCase ()
	Modify the current instance of the string replacing all lower case characters in the corresponding upper case characters. More...

bool	isShort () const
	Returns true if the string represents a valid short, and false otherwise. More...

short	asShort () const
	Returns the value of the string in this MString instance converted to a short. More...

bool	isInt () const
	Returns true if the string represents a valid int, and false otherwise. More...

int	asInt () const
	Returns the value of the string in this MString instance converted to an integer. More...

bool	isUnsigned () const
	Returns true if the string represents a valid unsigned int, and false otherwise. More...

unsigned int	asUnsigned () const
	Returns the value of the string in this MString instance converted to an unsigned integer. More...

bool	isFloat () const
	Returns true if the string represents a valid float, and false otherwise. More...

float	asFloat () const
	Returns the value of the string in this MString instance converted to a float. More...

bool	isDouble () const
	Returns true if the string represents a valid double, and false otherwise. More...

double	asDouble () const
	Returns the value of the string in this MString instance converted to a double. More...

MString	expandEnvironmentVariablesAndTilde (MStatus *ReturnStatus=NULL) const
	Returns a new string constructed by duplicating the current string with all environment variables expanded (and on UNIX, tilde characaters ("~") are also expanded. More...

MString	expandFilePath (MStatus *ReturnStatus=NULL) const
	Returns a new string constructed by duplicating the current string with all environment variables expanded (and on UNIX, tilde characaters ("~") are also expanded. More...

MStatus	format (const MString &fmt, const MStringArray &args)
	Format the string value using a format specifier and an array of positional arguments. More...

MStatus	format (const MString &fmt, const MString &arg1=MString::argUnused, const MString &arg2=MString::argUnused, const MString &arg3=MString::argUnused, const MString &arg4=MString::argUnused, const MString &arg5=MString::argUnused, const MString &arg6=MString::argUnused, const MString &arg7=MString::argUnused, const MString &arg8=MString::argUnused, const MString &arg9=MString::argUnused, const MString &arg10=MString::argUnused)
	Format the string value using a format specifier and positional arguments. More...

MStatus	substitute (const MString &src, const MString &target)
	Replace all occurrences of src in this string with target. More...

MStatus	substituteFirst (const MString &src, const MString &target)
	Replace the first occurrence of src in this string with target. More...

Friends
OPENMAYA_EXPORT std::ostream &	operator<< (std::ostream &, const MString &)
	NO SCRIPT SUPPORT. More...

OPENMAYA_EXPORT MString	operator+ (const char *, const MString &)
	NO SCRIPT SUPPORT. More...

Detailed Description

Manipulate strings.

The MString class implements a string class, and is used to pass all string arguments to Maya API methods.

The MString class supports localized strings. Use of the MString class to store and manipulate strings largely insulates the code from locale-dependent processing. Code that uses the class and its methods will in most cases operate seamlessly in both multibyte and single-byte environments. Knowledge of the underlying string storage mechanism or encoding is not required to use the class, and assumptions about this should not be made by the calling code.

Unless otherwise indicated, MString methods accepting or returning string contents via character buffers (char *) use the convention that the string contents are in the locale's native multibyte encoding. Methods which explicitly support other common encodings and representations such as UTF-8 and wchar_t are also provided. Code that manipulates string contents should use the multibyte-safe methods provided by the class. Refer to documentation on individual MString methods for more information.

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/AbcWriteJob.cpp, AbcBullet/AttributesWriter.cpp, AbcBullet/MayaTransformCollectionWriter.cpp, AbcBullet/MayaTransformCollectionWriter.h, AbcBullet/MayaTransformWriter.cpp, AbcBullet/MayaTransformWriter.h, AbcBullet/MayaUtility.cpp, AbcBullet/MayaUtility.h, AbcExport/AbcExport.cpp, AbcExport/AbcWriteJob.cpp, AbcExport/AttributesWriter.cpp, AbcExport/MayaCameraWriter.cpp, AbcExport/MayaLocatorWriter.cpp, AbcExport/MayaMeshWriter.cpp, AbcExport/MayaNurbsCurveWriter.cpp, AbcExport/MayaNurbsSurfaceWriter.cpp, AbcExport/MayaPointPrimitiveWriter.cpp, AbcExport/MayaTransformWriter.cpp, AbcExport/MayaUtility.cpp, AbcExport/MayaUtility.h, AbcImport/AbcImport.cpp, AbcImport/AbcImportStrings.cpp, AbcImport/AbcImportStrings.h, AbcImport/AlembicImportFileTranslator.cpp, AbcImport/AlembicImportFileTranslator.h, AbcImport/AlembicNode.cpp, AbcImport/AlembicNode.h, AbcImport/CameraHelper.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/CreateSceneHelper.h, AbcImport/LocatorHelper.cpp, AbcImport/main.cpp, AbcImport/MeshHelper.cpp, AbcImport/NodeIteratorVisitorHelper.cpp, AbcImport/NodeIteratorVisitorHelper.h, AbcImport/NurbsCurveHelper.cpp, AbcImport/NurbsSurfaceHelper.cpp, AbcImport/util.cpp, AbcImport/util.h, animExportUtil/animExportUtil.cpp, animExportUtil/animExportUtil.h, animExportUtil/animFileExport.cpp, animExportUtil/animFileExport.h, animImportExport/animFileUtils.cpp, animImportExport/animFileUtils.h, animImportExport/animImportExport.cpp, animImportExport/animImportExport.h, animInfoCmd/animInfoCmd.cpp, anisotropicShader/anisotropicShader.cpp, apiDirectionalLightShape/apiDirectionalLightShape.cpp, apiDirectionalLightShape/apiDirectionalLightShape.h, apiMeshShape/apiMeshData.cpp, apiMeshShape/apiMeshData.h, apiMeshShape/apiMeshGeometryOverride.cpp, apiMeshShape/apiMeshGeometryOverride.h, apiMeshShape/apiMeshShape.cpp, apiMeshShape/apiMeshShape.h, apiMeshShape/apiMeshSubSceneOverride.cpp, apiMeshShape/apiMeshSubSceneOverride.h, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomAnimLayers.h, atomImportExport/atomCachedPlugs.cpp, atomImportExport/atomCachedPlugs.h, atomImportExport/atomFileUtils.cpp, atomImportExport/atomFileUtils.h, atomImportExport/atomImportExport.cpp, atomImportExport/atomImportExport.h, atomImportExport/atomNodeNameReplacer.cpp, atomImportExport/atomNodeNameReplacer.h, autoLoader/moduleLogic.cpp, autoLoader/moduleLogic.h, autoLoader/threadData.h, backfillShader/backfillShader.cpp, basicMorphNode/basicMorphNode.cpp, blast2Cmd/blast2Cmd.cpp, blindComplexDataCmd/blindComplexDataCmd.cpp, blindDataShader/blindDataPluginMain.cpp, blindDataShader/blindDataShaderOverride.cpp, blindDataShader/blindDataShaderOverride.h, blindDoubleDataCmd/blindDoubleDataCmd.cpp, blindShortDataCmd/blindShortDataCmd.cpp, brickShader/brickShader.cpp, cameraMessageCmd/cameraMessageCmd.cpp, cameraSetSubclass/testExCameraSetCmd.cpp, cameraSetSubclass/testExCameraSetCmd.h, captureViewRenderCmd/captureViewRenderCmd.cpp, cellShader/cellShader.cpp, cgFx/cgfxAttrDef.cpp, cgFx/cgfxAttrDef.h, cgFx/cgfxEffectDef.cpp, cgFx/cgfxEffectDef.h, cgFx/cgfxFindImage.cpp, cgFx/cgfxFindImage.h, cgFx/cgfxPassStateSetter.cpp, cgFx/cgfxProfile.cpp, cgFx/cgfxProfile.h, cgFx/cgfxShaderCmd.cpp, cgFx/cgfxShaderCmd.h, cgFx/cgfxShaderNode.cpp, cgFx/cgfxShaderNode.h, cgFx/cgfxTextureCache.cpp, cgFx/cgfxTextureCache.h, cgFx/pluginMain.cpp, checkerShader/checkerShader.cpp, cleanPerFaceAssignment/cleanPerFaceAssignmentCmd.cpp, clearcoat.cpp, closestPointCmd/closestPointCmd.cpp, closestPointOnCurve/closestPointOnCurveCmd.cpp, closestPointOnCurve/closestPointOnCurveCmd.h, closestPointOnNurbsSurfaceCmd/closestPointOnNurbsSurfaceCmd.cpp, colorTransformData/colorTransformData.cpp, componentScaleManip/componentScaleManip.cpp, compositingShader/compositingShader.cpp, conditionTest/conditionTest.cpp, constraintEvaluator/constraintEvaluator.cpp, contrastShader/contrastShader.cpp, convertBumpCmd/convertBumpCmd.cpp, convertEdgesToFacesCmd/convertEdgesToFacesCmd.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, convertVerticesToFacesCmd/convertVerticesToFacesCmd.cpp, createClipCmd/createClipCmd.cpp, customAttrManip/customAttrManip.cpp, customComponentTagNode/customComponentTagNode.cpp, customImagePlane/customImagePlane.cpp, customSpriteShader/customSpriteShader.cpp, customTextureShader/customTextureShader.cpp, customTextureShader/customTextureShader.h, customTextureShader/customTextureShaderMainMaya.cpp, customTextureShader/customTextureShaderOverride.cpp, customTextureShader/customTextureShaderOverride.h, cvColorNode/cvColorNode.cpp, cvPosCmd/cvPosCmd.cpp, dagMessageCmd/dagMessageCmd.cpp, dagPoseInfoCmd/dagPoseInfoCmd.cpp, ddsFloatReader.cpp, deletedMsgCmd/deletedMsgCmd.cpp, depthShader/depthShader.cpp, displacementShader/displacementShader.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11Shader.h, dx11Shader/dx11ShaderCmd.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, dx11Shader/dx11ShaderCompileHelper.h, dx11Shader/dx11ShaderOverride.cpp, dx11Shader/dx11ShaderOverride.h, dx11Shader/dx11ShaderPluginMain.cpp, dx11Shader/dx11ShaderStrings.cpp, dx11Shader/dx11ShaderStrings.h, dx11Shader/dx11ShaderUniformParamBuilder.cpp, dx11Shader/dx11ShaderUniformParamBuilder.h, dynExprField/dynExprField.cpp, evaluationPruningEvaluator/evaluationPruningEvaluator.cpp, eventTest/eventTest.cpp, exampleFalloff/smoothFalloffNode.cpp, exampleFalloff/smoothFalloffNode.h, exampleRampAttribute/exampleMRampAttribute.cpp, exportJointClusterDataCmd/exportJointClusterDataCmd.cpp, exportSkinClusterDataCmd/exportSkinClusterDataCmd.cpp, externalDropCallback/externalDropCallback.cpp, fileIOMsgCmd/fileIOMsgCmd.cpp, fileTexture/fileTexture.cpp, filteredAsciiFile/filteredAsciiFile.cpp, findFileTexturesCmd/findFileTexturesCmd.cpp, findTexturesPerPolygonCmd/findTexturesPerPolygonCmd.cpp, flameShader/flameShader.cpp, fluidInfoCmd/fluidInfoCmd.cpp, footPrintManip/footPrintManip.cpp, footPrintNode/footPrintNode.cpp, footPrintNode_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp, footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp, footPrintNode_SubSceneOverride/footPrintNode_SubSceneOverride.cpp, fragmentDumper/fragmentDumper.cpp, gammaShader/gammaShader.cpp, geometryCacheConverter/geometryCacheBlockBase.cpp, geometryCacheConverter/geometryCacheBlockBase.h, geometryCacheConverter/geometryCacheBlockDVAData.cpp, geometryCacheConverter/geometryCacheBlockDVAData.h, geometryCacheConverter/geometryCacheBlockFVAData.cpp, geometryCacheConverter/geometryCacheBlockFVAData.h, geometryCacheConverter/geometryCacheBlockIntData.cpp, geometryCacheConverter/geometryCacheBlockIntData.h, geometryCacheConverter/geometryCacheBlockStringData.cpp, geometryCacheConverter/geometryCacheBlockStringData.h, geometryCacheConverter/geometryCacheConverter.cpp, geometryCacheConverter/geometryCacheFile.cpp, geometryCacheConverter/geometryCacheFile.h, geometryOverrideExample1/geometryOverrideExample1.cpp, geometryOverrideExample2/geometryOverrideExample2.cpp, geometryReplicator/geometryReplicator.cpp, geomShader/geomShader.cpp, getAttrAffectsCmd/getAttrAffectsCmd.cpp, glslShader/GLSLShader.cpp, glslShader/GLSLShader.h, glslShader/GLSLShaderCmd.cpp, glslShader/GLSLShaderMainMaya.cpp, glslShader/GLSLShaderOverride.cpp, glslShader/GLSLShaderOverride.h, glslShader/GLSLShaderStrings.cpp, glslShader/GLSLShaderStrings.h, gpuCache/CacheReader.cpp, gpuCache/CacheReader.h, gpuCache/CacheReaderAlembic.cpp, gpuCache/CacheReaderAlembic.h, gpuCache/CacheWriter.cpp, gpuCache/CacheWriter.h, gpuCache/CacheWriterAlembic.cpp, gpuCache/CacheWriterAlembic.h, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheConfig.cpp, gpuCache/gpuCacheConfig.h, gpuCache/gpuCacheDrawOverride.cpp, gpuCache/gpuCacheGeometry.cpp, gpuCache/gpuCacheGeometry.h, gpuCache/gpuCacheMaterial.cpp, gpuCache/gpuCacheMaterial.h, gpuCache/gpuCacheMaterialBakers.cpp, gpuCache/gpuCacheMaterialNodes.cpp, gpuCache/gpuCacheMaterialNodes.h, gpuCache/gpuCachePluginMain.cpp, gpuCache/gpuCacheSample.cpp, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheShapeNode.h, gpuCache/gpuCacheSpatialSubdivision.cpp, gpuCache/gpuCacheSpatialSubdivision.h, gpuCache/gpuCacheSubSceneOverride.cpp, gpuCache/gpuCacheUtil.h, gpuCache/gpuCacheVramQuery.cpp, gpuCache/gpuCacheVramQuery.h, grabUVMain.cpp, helix2Cmd/helix2Cmd.cpp, helixCmd/helixCmd.cpp, helixQtCmd.cpp, helixQtCmd.h, helixTool/helixTool.cpp, hlslShader/hlslPluginMain.cpp, hlslShader/hlslShader.cpp, hlslShader/hlslShader.h, hwApiTextureTest/hwApiTextureTest.cpp, hwApiTextureTest/hwApiTextureTestStrings.cpp, hwApiTextureTest/hwApiTextureTestStrings.h, hwApiTextureTest/hwRendererHelper.cpp, hwApiTextureTest/hwRendererHelperDX.cpp, hwPhongShader/hwPhongShader.cpp, hwPhongShader/hwPhongShaderBehavior.cpp, identityNode/identityNode.cpp, iffInfoCmd/iffInfoCmd.cpp, iffInfoCmd/iffreader.cpp, iffInfoCmd/iffreader.h, iffPixelCmd/iffPixelCmd.cpp, iffPixelCmd/iffreader.cpp, iffPixelCmd/iffreader.h, iffPpmCmd/iffPpmCmd.cpp, iffPpmCmd/iffreader.cpp, iffPpmCmd/iffreader.h, ik2Bsolver/ik2Bsolver.cpp, instancerListCmd/instancerListCmd.cpp, interpShader/interpShader.cpp, intersectCmd/intersectCmd.cpp, intersectOnNurbsSurfaceCmd/intersectOnNurbsSurfaceCmd.cpp, lambertShader/lambertShader.cpp, lambertShader/lambertShaderOverride.cpp, lambertShader/lambertShaderOverride.h, latticeNoise/latticeNoiseCmd.cpp, lavaShader/lavaShader.cpp, lensDistortionCallback/lensDistortionCallback.cpp, lensDistortionCallback/lensDistortionCallback.h, lepTranslator/lepTranslator.cpp, lightShader/lightShader.cpp, lineManip/lineManip.cpp, lineManipContainer/lineManipContainer.cpp, listRichSelectionCmd/listRichSelectionCmd.cpp, lockEvent/lockEvent.cpp, manipOverride/customTriadManip.cpp, manipOverride/manipOverride.cpp, maTranslator/maTranslator.cpp, MayaPluginForSpreticle/spReticleLoc.cpp, MayaPluginForSpreticle/spReticleLoc.h, meshOpCmd/polyModifierCmd.cpp, meshOpCmd/polyModifierCmd.h, MetadataSample/createMetadataCmd.cpp, MetadataSample/createMetadataCmd.h, MetadataSample/exportMetadataCmd.cpp, MetadataSample/importMetadataCmd.cpp, MetadataSample/importMetadataCmd.h, MetadataSample/metadataBase.cpp, MetadataXML/associationsSerializerXML.cpp, MetadataXML/channelSerializerXML.cpp, MetadataXML/streamSerializerXML.cpp, MetadataXML/structureSerializerXML.cpp, mixtureShader/mixtureShader.cpp, motionTraceCmd/motionTraceCmd.cpp, moveManip/moveManip.cpp, moveNumericTool/moveNumericTool.cpp, moveTool/moveTool.cpp, nameFilter/NameFilter.cpp, nameFilter/NameFilter.h, narrowPolyRenderOverride/narrowPolyRenderOverride.cpp, narrowPolyRenderOverride/narrowPolyRenderOverride.h, nodeCreatedCBCmd/nodeCreatedCBCmd.cpp, nodeCreatedCBCmd/nodeCreatedCBCmd.h, nodeIconCmd/nodeIconCmd.cpp, nodeInfoCmd/nodeInfoCmd.cpp, noiseShader/noiseShader.cpp, objExport/objExport.cpp, offsetNode/offsetNode.cpp, onbShader/onbShader.cpp, onbShader/onbShaderOverride.cpp, onbShader/onbShaderOverride.h, OpenEXR.cpp, particlePathsCmd/particlePathsCmd.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, peltOverlapCmd/peltOverlapCmd.cpp, pfxInfoCmd/pfxInfoCmd.cpp, phongShader/phongShader.cpp, phongShader/phongShaderOverride.cpp, phongShader/phongShaderOverride.h, pickCmd/pickCmd.cpp, pointManip/pointManip.cpp, pointOnMeshInfo/pointOnMeshCmd.cpp, pointOnMeshInfo/pointOnMeshCmd.h, polyPrimitiveCmd/polyPrimitiveCmd.cpp, polyRawExporter/polyExporter.cpp, polyRawExporter/polyExporter.h, polyRawExporter/polyRawExporter.cpp, polyRawExporter/polyRawExporter.h, polyRawExporter/polyRawWriter.cpp, polyRawExporter/polyRawWriter.h, polyRawExporter/polyWriter.cpp, polyRawExporter/polyWriter.h, polyX3DExporter/polyExporter.cpp, polyX3DExporter/polyExporter.h, polyX3DExporter/polyWriter.cpp, polyX3DExporter/polyWriter.h, polyX3DExporter/polyX3DExporter.cpp, polyX3DExporter/polyX3DExporter.h, polyX3DExporter/polyX3DWriter.cpp, polyX3DExporter/polyX3DWriter.h, progressWindowCmd/progressWindowCmd.cpp, qtForms.cpp, qtForms.h, randomizerDevice/randomizerDevice.cpp, rawfootPrintNode/rawfootPrintNode.cpp, referenceQueryCmd/referenceQueryCmd.cpp, renderAccessNode/renderAccessNode.cpp, richSelectionTool/richSelectionTool.cpp, rockingTransform/rockingTransformMain.cpp, rotateManip/rotateManip.cpp, sampleCmd/sampleCmd.cpp, sampleParticles/sampleParticles.cpp, saveSwatchesCmd.cpp, saveSwatchesCmd.h, scanDagCmd/scanDagCmd.cpp, scanDagSyntax/scanDagSyntax.cpp, sceneAssembly/adskPrepareRenderGlobals.cpp, sceneAssembly/adskPrepareRenderGlobals.h, sceneAssembly/adskRepresentationCmd.cpp, sceneAssembly/adskRepresentationCmd.h, sceneAssembly/adskRepresentationFactory.h, sceneAssembly/adskRepresentations.cpp, sceneAssembly/adskRepresentations.h, sceneAssembly/adskSceneMetadataCmd.cpp, sceneAssembly/adskSceneMetadataCmd.h, sceneAssembly/assemblyDefinition.cpp, sceneAssembly/assemblyDefinition.h, sceneAssembly/assemblyDefinitionFileCache.cpp, sceneAssembly/assemblyDefinitionFileCache.h, sceneAssembly/assemblyReference.cpp, sceneAssembly/assemblyReference.h, sceneAssembly/assemblyReferenceInitialRep.cpp, sceneAssembly/assemblyReferenceInitialRep.h, sceneAssembly/sceneAssemblyPluginMain.cpp, shadowMatteShader/shadowMatteShader.cpp, shellNode/shellNode.cpp, shiftNode/shiftNode.cpp, simpleEvaluationDraw/simpleEvaluationDraw.cpp, simpleImageFile/simpleImageFile.cpp, simpleNoiseShader/simpleNoiseShader.cpp, simpleNoiseShader/simpleNoiseShaderOverride.cpp, simpleNoiseShader/simpleNoiseShaderOverride.h, simplePhysicsEngine/simplePhysicsEngine.cpp, simpleSolverNode/simpleSolverNode.cpp, skinClusterWeights/skinClusterWeights.cpp, slopeShader/slopeShader.cpp, slopeShader/slopeShaderBehavior.cpp, solidCheckerShader/solidCheckerShader.cpp, spiralAnimCurveCmd/spiralAnimCurveCmd.cpp, splitUVCmd/polyModifierCmd.cpp, splitUVCmd/polyModifierCmd.h, splitUVCmd/splitUVFtyAction.cpp, squareScaleManip/squareScaleManip.cpp, squareScaleManip/squareScaleManip.h, squareScaleManipContext/squareScaleManipContext.cpp, squareScaleManipContext/squareScaleManipContext.h, squaresNode_noDepthTest/squaresNode_noDepthTest.cpp, stringFormatNode/stringFormatNode.cpp, surfaceBumpManip/surfaceBumpManip.cpp, swissArmyManip/swissArmyManip.cpp, tessellatedQuad/TessellatedQuadGeomOverride.cpp, tessellatedQuad/TessellatedQuadNode.cpp, tessellatedQuad/TessellatedQuadNode.h, testCameraSetCmd/testCameraSetCmd.cpp, testFailureNode/testFailureNode.cpp, testMTopologyEvaluator/testMTopologyEvaluator.cpp, testNobjectNode/testNobjectNode.cpp, testNpassiveNode/testNpassiveNode.cpp, testNsolverNode/testNsolverNode.cpp, testNucleusNode/testNucleusNode.cpp, threadingLockTests/threadingLockTests.cpp, threadTestCmd/threadTestCmd.cpp, threadTestWithLocksCmd/threadTestWithLocksCmd.cpp, tiffFloatReader.cpp, topologyTrackingNode/topologyTrackingNode.cpp, transformDrawNode/transformDrawNode.cpp, udpDevice/udpDevice.cpp, uiDrawManager/uiDrawManager.cpp, undoRedoMsgCmd/undoRedoMsgCmd.cpp, userMsgCmd/userMsgCmd.cpp, vertexBufferGenerator/vertexBufferGenerator.cpp, viewCallbackTest/viewCallbackTest.cpp, viewCaptureCmd/viewCaptureCmd.cpp, viewDX11DeviceAccess/viewDX11DeviceAccess.cpp, viewImageBlitOverride/viewImageBlitOverride.cpp, viewImageBlitOverride/viewImageBlitOverride.h, viewMRenderOverride/viewMRenderOverride.cpp, viewObjectFilter/viewObjectFilter.cpp, viewObjectSetOverride/viewObjectSetOverride.cpp, viewOverrideSimple/viewOverrideSimple.cpp, viewOverrideSimple/viewOverrideSimple.h, viewOverrideTrackTexture/viewOverrideTrackTexture.cpp, viewOverrideTrackTexture/viewOverrideTrackTexture.h, viewRenderOverride/viewRenderOverride.cpp, viewRenderOverride/viewRenderOverride.h, viewRenderOverride/viewRenderOverrideOperations.cpp, viewRenderOverride/viewRenderOverrideUserOperation.cpp, viewRenderOverrideFrameCache/viewRenderOverrideFrameCache.cpp, viewRenderOverrideFrameCache/viewRenderOverrideFrameCache.h, viewRenderOverrideFrameCache/viewRenderOverrideFrameCacheMain.cpp, viewRenderOverrideMRT/viewRenderOverrideMRT.cpp, viewRenderOverrideMRT/viewRenderOverrideMRT.h, viewRenderOverridePointLightShadows/viewRenderOverridePointLightShadows.cpp, viewRenderOverridePointLightShadows/viewRenderOverridePointLightShadows.h, viewRenderOverridePostColor/viewRenderOverridePostColor.cpp, viewRenderOverridePostColor/viewRenderOverridePostColor.h, viewRenderOverrideShadows/viewRenderOverrideShadows.cpp, viewRenderOverrideShadows/viewRenderOverrideShadows.h, viewRenderOverrideTargets/viewRenderOverrideTargets.cpp, viewRenderOverrideTargets/viewRenderOverrideTargets.h, volumeLightCmd/volumeLightCmd.cpp, volumeShader/volumeShader.cpp, vp2BlinnShader/vp2BlinnShader.cpp, whatisCmd/whatisCmd.cpp, workspaceControlCmd.cpp, workspaceControlCmd.h, XmlGeometryCache/XmlGeometryCache.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

Constructor & Destructor Documentation

OPENMAYA_MAJOR_NAMESPACE_OPEN MString ( )

The Class constructor.

Initializes the new MString instance to the empty string.

MString ( const char * charString )

Class constructor.

Create a new instance of an MString and initialize it to the given null-terminated character string.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] charString the initial string value (null-terminated)

MString ( const wchar_t * wcharString )

Class constructor.

Create a new instance of an MString and initialize it with the null-terminated wide character string.

Parameters

[in] wcharString the initial string value (null-terminated).

MString	(	const char *	charString,
		int	charLength
	)

Class constructor.

Create a new instance of an MString and initialize it with the character buffer passed, to the specified length. The length value is the length in bytes of the character buffer passed.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in]	charString	the initial string value.
[in]	charLength	the initial string length.

MString	(	const wchar_t *	wcharString,
		int	wcharLength
	)

Class constructor.

Create a new instance of an MString and initialize it to the given wide character string of specified length.

The length value corresponds to the number of wide characters in the initialization string.

Parameters

[in]	wcharString	the initial string value.
[in]	wcharLength	the initial string length (number of characters).

MString ( const MString & other )

Copy constructor.

Create a new MString instance and initialize is with the same string as the given one.

Parameters

[in] other the MString to copy from.

Member Function Documentation

MString & operator+= ( const MString & other )

In-place addition with another MString.

The MString on the right is appended to the MString on the left and the result is placed in the left MString.

Parameters

[in] other Right operand.

MString & operator+= ( const char * other )

In-place addition with a C++ string.

The character string on the right is appended to the MString on the left and the result is placed in the MString.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] other Right operand.

MString & operator+= ( double other )

In-place addition with a double value.

The double value on the right is converted to string representation and appended to the MString on the left. The result is placed in the MString.

Parameters

[in] other Right operand.

MString & operator+= ( int other )

In-place addition with an int value.

The int value on the right is converted to string representation and appended to the MString on the left. The result is placed in the MString.

Parameters

[in] other Right operand.

MString & operator+= ( unsigned int other )

In-place addition with an unsigned int value.

The unsigned int value on the right is converted to string representation and appended to the MString on the left. The result is placed in the MString.

Parameters

[in] other Right operand.

MString & operator+= ( float other )

In-place addition with a float value.

The float value on the right is converted to string representation and appended to the MString on the left. The result is placed in the MString.

Parameters

[in] other Right operand.

MString & operator= ( const MString & other )

Assignment operator.

Allows assignment between MString instances.

Parameters

[in] other Value to be assigned.

MString & operator= ( const char * other )

Assignment operator.

Allows assignment of the contents of a character buffer to this MString.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] other Value to be converted to MString and assigned.

MString & operator= ( double value )

Assignment operator.

Allows assignment of a number to this MString.

Parameters

[in] value Value to be converted to MString and assigned.

bool operator== ( const MString & other ) const

Equality operator.

Allows two MStrings to be compared to see if they contain identical strings.

Parameters

[in] other Right operand.

bool operator== ( const char * other ) const

Equality operator.

Allows an MString and the contents of a character buffer to be compared to see if they contain identical strings.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] other Right operand.

bool operator!= ( const MString & other ) const

Inequality operator.

Allows two MStrings to be compared to see if they differ.

Parameters

[in] other Right operand.

bool operator!= ( const char * other ) const

Inequality operator.

Allows an MString to be compared with the contents of a character buffer to see if the two strings differ.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] other Right operand.

MString operator+ ( const MString & other ) const

Addition with another MString.

The MString on the right is appended to the MString on the left and the result is returned in a new MString. Neither of the operands is modified.

Parameters

[in] other Right operand.

MString operator+ ( const char * other ) const

Addition with a C++ string.

The character string on the right is appended to the MString on the left and the result is returned in a new MString. Neither of the operands is modified.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] other Right operand.

MString operator+ ( double value ) const

Addition with a double value.

The double value on the right is converted to string representation and appended to the MString on the left. The result is returned in a new MString. The MString on the left is not modified.

Parameters

[in] value Right operand.

MStatus set ( const char * charString )

Set the value of the string in this MString instance.

to the value of the null-terminated character string.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in] charString new string value (null-terminated).

Returns: MS::kSuccess for success, otherwise MS::kFailure

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/AbcWriteJob.cpp, AbcExport/AbcWriteJob.cpp, animExportUtil/animFileExport.cpp, animImportExport/animFileUtils.cpp, atomImportExport/atomFileUtils.cpp, cgFx/cgfxShaderNode.cpp, dx11Shader/dx11Shader.cpp, grabUVMain.cpp, helixTool/helixTool.cpp, latticeNoise/latticeNoiseCmd.cpp, lepTranslator/lepTranslator.cpp, nodeInfoCmd/nodeInfoCmd.cpp, offsetNode/offsetNode.cpp, richSelectionTool/richSelectionTool.cpp, stringFormatNode/stringFormatNode.cpp, threadTestWithLocksCmd/threadTestWithLocksCmd.cpp, viewDX11DeviceAccess/viewDX11DeviceAccess.cpp, and viewRenderOverride/viewRenderOverride.h.

MStatus setUTF8 ( const char * utf8String )

Set the value of the string in this MString instance using a null-terminated utf-8 encoded character string.

Note: conversion errors may occur if the multibyte encoding of the current locale cannot represent the utf-8 characters in the assignment string.

Parameters

[in] utf8String null-terminated utf-8 character string buffer.

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus setWChar ( const wchar_t * wcharString )

Set the value of the string in this MString instance using a null-terminated wide character string.

Parameters

[in] wcharString null-terminated wide character string buffer.

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus set	(	const char *	charString,
		int	charLength
	)

Set the value of the string in this MString instance to the value of the character buffer passed.

The length value is the length in bytes of the character buffer.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in]	charString	new string value.
[in]	charLength	new string length.

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus setWChar	(	const wchar_t *	wcharString,
		int	wcharLength
	)

Set the value of the string in this MString instance using a wide string and its length.

The length value corresponds to the number of wide characters in the input string.

Parameters

[in]	wcharString	New wide character string value.
[in]	wcharLength	New string length (number of wide characters)

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus set ( double value )

Set the value of the string in this MString instance.

The numeric value will be converted to a character string.

Parameters

[in] value new number.

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus set	(	double	value,
		int	precision
	)

Set the value of the string in this MString instance, with the given precision.

The numeric value will be converted to a character string.

Parameters

[in]	value	new number.
[in]	precision	the precision (number of decimal places).

Returns: MS::kSuccess for success, otherwise MS::kFailure

const char * asChar ( ) const

Return the current string in this MString instance as a C++ char* pointer.

The string will be returned as a null-terminated buffer of type char.

In a localized environment, the string will contain a buffer of multibyte characters in the locale's native encoding.

The length of this representation of the string can be obtained by calling the alternate version of this method that returns the string length, or by calling MString::length().

NOTE: The string should be duplicated if it will be re-used.

Returns: The char* pointer to the string in this MString instance.

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/AbcWriteJob.cpp, AbcBullet/AttributesWriter.cpp, AbcBullet/MayaTransformCollectionWriter.cpp, AbcBullet/MayaUtility.h, AbcExport/AbcExport.cpp, AbcExport/AbcWriteJob.cpp, AbcExport/AttributesWriter.cpp, AbcExport/MayaCameraWriter.cpp, AbcExport/MayaLocatorWriter.cpp, AbcExport/MayaMeshWriter.cpp, AbcExport/MayaNurbsSurfaceWriter.cpp, AbcExport/MayaPointPrimitiveWriter.cpp, AbcExport/MayaTransformWriter.cpp, AbcExport/MayaUtility.h, AbcImport/AlembicNode.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/util.cpp, affectsNode/affectsNode.cpp, animExportUtil/animExportUtil.cpp, animImportExport/animFileUtils.cpp, animImportExport/animImportExport.cpp, animInfoCmd/animInfoCmd.cpp, apiMeshShape/apiMeshGeometryOverride.cpp, apiMeshShape/apiMeshShape.cpp, apiMeshShape/apiMeshSubSceneOverride.cpp, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, autoLoader/moduleLogic.cpp, blast2Cmd/blast2Cmd.cpp, cgFx/cgfxAttrDef.cpp, cgFx/cgfxEffectDef.cpp, cgFx/cgfxFindImage.cpp, cgFx/cgfxShaderCmd.cpp, cgFx/cgfxShaderNode.cpp, cgFx/cgfxTextureCache.cpp, cgFx/pluginMain.cpp, colorTransformData/colorTransformData.cpp, dagPoseInfoCmd/dagPoseInfoCmd.cpp, ddsFloatReader.cpp, depthShader/depthShader.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, dx11Shader/dx11ShaderOverride.cpp, exportJointClusterDataCmd/exportJointClusterDataCmd.cpp, exportSkinClusterDataCmd/exportSkinClusterDataCmd.cpp, findTexturesPerPolygonCmd/findTexturesPerPolygonCmd.cpp, footPrintNode/footPrintNode.cpp, footPrintNode_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp, footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp, fragmentDumper/fragmentDumper.cpp, geometryCacheConverter/geometryCacheFile.cpp, glslShader/GLSLShader.cpp, gpuCache/CacheReader.cpp, gpuCache/CacheReaderAlembic.cpp, gpuCache/CacheWriter.cpp, gpuCache/CacheWriterAlembic.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheDrawOverride.cpp, gpuCache/gpuCacheMaterial.h, gpuCache/gpuCacheMaterialBakers.cpp, gpuCache/gpuCacheSample.h, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheVramQuery.cpp, helloCmd/helloCmd.cpp, hlslShader/hlslShader.cpp, hwPhongShader/hwPhongShader.cpp, hwPhongShader/hwPhongShaderBehavior.cpp, iffInfoCmd/iffreader.cpp, iffPixelCmd/iffreader.cpp, iffPpmCmd/iffreader.cpp, instancerListCmd/instancerListCmd.cpp, lepTranslator/lepTranslator.cpp, listLightLinksCmd/listLightLinksCmd.cpp, maTranslator/maTranslator.cpp, MayaPluginForSpreticle/spReticleLoc.cpp, MetadataSample/importMetadataCmd.cpp, MetadataSample/metadataBase.cpp, MetadataXML/associationsSerializerXML.cpp, MetadataXML/channelSerializerXML.cpp, MetadataXML/streamSerializerXML.cpp, MetadataXML/structureSerializerXML.cpp, objExport/objExport.cpp, OpenEXR.cpp, particleSystemInfoCmd/particleSystemInfoCmd.cpp, pickCmd/pickCmd.cpp, polyRawExporter/polyExporter.cpp, polyX3DExporter/polyExporter.cpp, rawfootPrintNode/rawfootPrintNode.cpp, renderViewRenderCmd/renderViewRenderCmd.cpp, renderViewRenderRegionCmd/renderViewRenderRegionCmd.cpp, sampleCmd/sampleCmd.cpp, saveSwatchesCmd.cpp, sceneAssembly/adskRepresentationCmd.cpp, sceneAssembly/adskSceneMetadataCmd.cpp, sceneAssembly/assemblyDefinition.cpp, sceneAssembly/assemblyDefinitionFileCache.cpp, simpleEvaluator/simpleEvaluator.cpp, testMTopologyEvaluator/testMTopologyEvaluator.cpp, tiffFloatReader.cpp, viewCallbackTest/viewCallbackTest.cpp, viewCaptureCmd/viewCaptureCmd.cpp, viewDX11DeviceAccess/viewDX11DeviceAccess.cpp, viewMRenderOverride/viewMRenderOverride.cpp, viewRenderOverride/viewRenderOverride.cpp, viewRenderOverride/viewRenderOverride.h, viewRenderOverride/viewRenderOverrideOperations.cpp, viewRenderOverride/viewRenderOverrideUserOperation.cpp, viewRenderOverridePointLightShadows/viewRenderOverridePointLightShadows.cpp, viewRenderOverrideShadows/viewRenderOverrideShadows.cpp, whatisCmd/whatisCmd.cpp, XmlGeometryCache/XmlGeometryCache.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

const char * asChar ( int & charLength ) const

Return the current string in this MString instance as a C++ char* pointer.

The string will be returned as a null-terminated buffer of type char.

In a localized environment, the string will contain a buffer of multibyte characters in the locale's native encoding.

The argument passed will be used to return the length of the character buffer returned in bytes (excluding the trailing null).

NOTE: the length value corresponds to the string's character length in bytes, which can differ from the number of characters in the string when running in a localized environment.

NOTE: The string should be duplicated if it will be re-used.

Parameters

[out] charLength value which will be set to the length of the character buffer returned

Returns: The char* pointer to the string in this MString instance.

const char * asUTF8 ( ) const

Return the current string in this MString instance as a C++ char* pointer to a null-terminated utf-8 encoded string.

The length of this buffer can be obtained by calling the alternate form of MString::asUTF8 which returns the length value.

NOTE: The string should be duplicated if it will be re-used.

Returns: The char* pointer to the utf-8 encoded string

Examples:: colorTransformData/colorTransformData.cpp.

const char * asUTF8 ( int & utf8Length ) const

Return the current string in this MString instance as a C++ char* pointer to a null-terminated utf-8 encoded string.

The integer argument passed will be used to return the length of this buffer (in bytes) excluding the trailing null.

NOTE: The string should be duplicated if it will be re-used.

Parameters

[out] utf8Length Value which will be set to the length of the character buffer returned.

Returns: The char* pointer to the utf-8 encoded string

const wchar_t * asWChar ( ) const

Return the current string in this MString instance as pointer to a null terminated wide character (wchar_t) buffer.

The number of characters in this buffer will be equivalent to MString::numChars, or can be determined by using the alternate form of MString::awWChar which returns the buffer length.

NOTE: wchar_t types are not portable between platforms and are not recommended for persistent data. A portable multibyte format such as UTF-8 is recommended for file I/O.

NOTE: The string should be duplicated if it will be re-used.

Returns: The wchar_t* pointer to the string in this MString instance.

Examples:: dx11Shader/dx11ShaderCompileHelper.cpp, gpuCache/CacheWriterAlembic.h, gpuCache/gpuCacheUtil.h, viewRenderOverridePointLightShadows/viewRenderOverridePointLightShadows.cpp, and viewRenderOverrideShadows/viewRenderOverrideShadows.cpp.

const wchar_t * asWChar ( int & wcharLength ) const

Return the current string in this MString instance as pointer to a null terminated wide character (wchar_t) buffer.

The length value returned corresponds to the number of wide characters in the buffer returned (excluding the trailing null).

NOTE: wchar_t types are not portable between platforms and are not recommended for persistent data. A portable multibyte format such as UTF-8 is recommended for file I/O.

NOTE: The string should be duplicated if it will be re-used.

Parameters

[out] wcharLength number of wide characters in buffer returned

Returns: The wchar_t* pointer to the string in this MString instance.

unsigned int length ( ) const

Returns the length of the string buffer in this MString instance.

This value corresponds to the length, in bytes, of the charcter buffer returned from the MString::asChar method, excluding the trailing null.

NOTE: When running in a localized (multibyte) environment, the MString::asChar method will return a multibyte buffer, in which the number of characters in the string may not correspond to the number of bytes in the multibyte representation. The use of the MString::numChars method is recommended in place of MString::length for determining the number of individual characters in the string.

Returns: Unsigned integer value giving the string's character buffer length.

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/MayaTransformCollectionWriter.cpp, AbcBullet/MayaTransformWriter.cpp, AbcExport/AbcExport.cpp, AbcExport/MayaMeshWriter.cpp, AbcExport/MayaUtility.cpp, AbcImport/AbcImport.cpp, AbcImport/AlembicNode.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/MeshHelper.cpp, animImportExport/animFileUtils.cpp, animImportExport/animImportExport.cpp, atomImportExport/atomAnimLayers.cpp, atomImportExport/atomFileUtils.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, autoLoader/moduleLogic.cpp, blast2Cmd/blast2Cmd.cpp, cgFx/cgfxAttrDef.cpp, cgFx/cgfxEffectDef.cpp, cgFx/cgfxFindImage.cpp, cgFx/cgfxShaderCmd.cpp, cgFx/cgfxShaderNode.cpp, cgFx/cgfxTextureCache.cpp, cgFx/pluginMain.cpp, customSpriteShader/customSpriteShader.cpp, cvPosCmd/cvPosCmd.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, dx11Shader/dx11ShaderUniformParamBuilder.cpp, externalDropCallback/externalDropCallback.cpp, fragmentDumper/fragmentDumper.cpp, glslShader/GLSLShader.cpp, gpuCache/CacheReader.cpp, gpuCache/CacheReaderAlembic.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheMaterial.h, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, gpuCache/gpuCacheUtil.h, gpuCache/gpuCacheVramQuery.cpp, hlslShader/hlslShader.cpp, hwApiTextureTest/hwApiTextureTest.cpp, lepTranslator/lepTranslator.cpp, maTranslator/maTranslator.cpp, MetadataXML/streamSerializerXML.cpp, nameFilter/NameFilter.cpp, nodeCreatedCBCmd/nodeCreatedCBCmd.cpp, objExport/objExport.cpp, rawfootPrintNode/rawfootPrintNode.cpp, sceneAssembly/assemblyReference.cpp, stringFormatNode/stringFormatNode.cpp, viewImageBlitOverride/viewImageBlitOverride.cpp, XmlGeometryCache/XmlGeometryCache.cpp, and XmlGeometryCacheDesc/XmlGeometryCacheDesc.cpp.

unsigned int numChars ( ) const

Returns the number of characters in the MString instance.

NOTE: this value corresponds to the number of actual characters in the string, not its character buffer length. It is suitable for localized environments as it correctly handles multibyte characters.

Returns: Unsigned integer value giving the number of characters in the string.

Examples:: AbcBullet/AbcBullet.cpp, AbcExport/AbcExport.cpp, AbcImport/AlembicImportFileTranslator.cpp, atomImportExport/atomNodeNameReplacer.cpp, glslShader/GLSLShader.cpp, gpuCache/gpuCacheUtil.h, sceneAssembly/adskRepresentations.cpp, sceneAssembly/assemblyDefinition.cpp, sceneAssembly/assemblyReference.cpp, viewRenderOverridePointLightShadows/viewRenderOverridePointLightShadows.cpp, and viewRenderOverrideShadows/viewRenderOverrideShadows.cpp.

bool isEmpty ( ) const

Introduced in 2023.0

Returns true if the string is empty.

2023.0:: Introduced in this version.

int index ( char searchChar ) const

Returns the position of the first occurrence of the character searchChar in the string or -1 if the character is not found.

The position value returned from index is a byte-based charcter position corresponding to the location in the asChar() form of the string.

NOTE: since this version of index works on the char form of the string it is not reliable within localized (multibyte) environments as the positions returned may not correctly match character boundaries in the multibyte buffer. Use of MString::indexW is recommended instead.

Parameters

[in] searchChar the character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

Examples:: cgFx/cgfxFindImage.cpp, cgFx/cgfxShaderNode.cpp, convertVerticesToEdgesCmd/convertVerticesToEdgesCmd.cpp, hlslShader/hlslShader.cpp, and sceneAssembly/assemblyDefinition.cpp.

int indexW ( char searchChar ) const

Returns the position of the first occurrence of the character searchChar in the string or -1 if the character is not found.

The position value returned from indexW is a character-based position and correctly handles strings in localized (multibyte) environments. Use of MString::indexW over MString::index is recommended.

Parameters

[in] searchChar the character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

Examples:: dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderUniformParamBuilder.cpp, glslShader/GLSLShader.cpp, lepTranslator/lepTranslator.cpp, and nameFilter/NameFilter.cpp.

int indexW ( wchar_t searchChar ) const

Returns the position of the first occurrence of the wide character searchChar in the string or -1 if the character is not found.

The position value returned from indexW is a character-based position and correctly handles strings in localized (multibyte) environments. Use of MString::indexW over MString::index is recommended.

Parameters

[in] searchChar the wide character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

int indexW ( const MString & searchStr ) const

Returns the position of the first occurrence of the searchString in the string or -1 if it is not found.

The position value returned from indexW is a character-based position and correctly handles strings in localized (multibyte) environments.

Parameters

[in] searchStr The string to search for.

Returns: The starting position of searchString in the string, or -1 if it is not found

int rindex ( char searchChar ) const

Returns the position of the last occurrence of the character searchChar in the string or -1 if the character is not found.

The position value returned from rindex is a byte-based character position corresponding to the location in the asChar() form of the string.

NOTE: since this version of rindex works on the char form of the string it is not reliable within localized (multibyte) environments as the positions returned may not correctly match character boundaries in the multibyte buffer. Use of MString::rindexW is recommended instead.

Parameters

[in] searchChar the character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

Examples:: AbcBullet/MayaTransformCollectionWriter.cpp, autoLoader/moduleLogic.cpp, cgFx/cgfxEffectDef.cpp, cgFx/cgfxFindImage.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, and hlslShader/hlslShader.cpp.

int rindexW ( char searchChar ) const

Returns the position of the last occurrence of the character searchChar in the string or -1 if the character is not found.

The position value returned from rindexW is a character-based position and correctly handles strings in localized (multibyte) environments. Use of MString::indexW over MString::index is recommended.

Parameters

[in] searchChar the character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

Examples:: dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, glslShader/GLSLShader.cpp, gpuCache/CacheReader.cpp, gpuCache/CacheReaderAlembic.cpp, and hwApiTextureTest/hwApiTextureTest.cpp.

int rindexW ( wchar_t searchChar ) const

Returns the position of the last occurrence of the wide character searchChar in the string or -1 if the character is not found.

The position value returned from rindexW is a character-based position and correctly handles strings in localized (multibyte) environments. Use of MString::indexW over MString::index is recommended.

Parameters

[in] searchChar the character to search for

Returns: The position of searchChar in the string, or -1 if the searchChar is not found

int rindexW ( const MString & searchStr ) const

Returns the position of the last occurrence of the searchString in the string or -1 if it is not found.

The position value returned from indexW is a character-based position and correctly handles strings in localized (multibyte) environments.

Parameters

[in] searchStr the string to search for

Returns: The position of searchString in the string, or -1 if it is not found

MStatus split	(	char	theChar,
		MStringArray &	theArray
	)		const

Split the string up at each occurrence of theChar and place the separate strings into theArray.

The current string instance is not modified.

NOTE: for compatibilty in localized environments an alternate form of of MString::split that accept wide-characters is also provided.

Parameters

[in]	theChar	the character on which to split
[out]	theArray	the MStringArray to populate

Returns: MS::kSuccess on success, and MS::kFailure on failure

Examples:: AbcBullet/MayaTransformCollectionWriter.cpp, AbcBullet/MayaUtility.cpp, AbcExport/MayaUtility.cpp, AbcImport/CreateSceneHelper.cpp, AbcImport/util.cpp, animImportExport/animImportExport.cpp, atomImportExport/atomImportExport.cpp, atomImportExport/atomNodeNameReplacer.cpp, cgFx/cgfxAttrDef.cpp, cgFx/cgfxShaderNode.cpp, dx11Shader/dx11Shader.cpp, externalDropCallback/externalDropCallback.cpp, filteredAsciiFile/filteredAsciiFile.cpp, glslShader/GLSLShader.cpp, gpuCache/CacheReaderAlembic.cpp, gpuCache/gpuCacheSubSceneOverride.cpp, gpuCache/gpuCacheUtil.h, gpuCache/gpuCacheVramQuery.cpp, hwApiTextureTest/hwApiTextureTest.cpp, lepTranslator/lepTranslator.cpp, nameFilter/NameFilter.cpp, objExport/objExport.cpp, and sceneAssembly/adskRepresentations.cpp.

MStatus split	(	wchar_t	theWChar,
		MStringArray &	theArray
	)		const

Split the string up at each occurrence of the given wide character and place the separate strings into theArray.

The current string instance is not modified.

NOTE: this method accepts a wide character type and is the preferred format for compatibility in localized environments.

Parameters

[in]	theWChar	the character on which to split
[out]	theArray	the MStringArray to populate

Returns: MS::kSuccess on success, and MS::kFailure on failure

MString substring	(	int	start,
		int	end
	)		const

Return a new MString instance that contains the characters from start to end inclusive.

Start and end are byte-based positions corresponding to the asChar() form of the string.

NOTE: since this version of substring works on the char form of the string it is not compatible with localized (multibyte) environments as the positions specified may not correctly match character boundaries in the multibyte buffer. Use of MString::substringW is recommended instead.

Parameters

[in]	start	the index of the first character to copy
[in]	end	the index of the last character to copy

Returns: An MString containing the substring.

Examples:: animImportExport/animFileUtils.cpp, atomImportExport/atomFileUtils.cpp, autoLoader/moduleLogic.cpp, cgFx/cgfxEffectDef.cpp, cgFx/cgfxFindImage.cpp, cgFx/cgfxShaderNode.cpp, cgFx/pluginMain.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, externalDropCallback/externalDropCallback.cpp, geometryCacheConverter/geometryCacheFile.cpp, glslShader/GLSLShader.cpp, hlslShader/hlslShader.cpp, hwApiTextureTest/hwApiTextureTest.cpp, sceneAssembly/assemblyDefinition.cpp, and stringFormatNode/stringFormatNode.cpp.

MString substringW	(	int	start,
		int	end
	)		const

Return a new MString instance that contains the characters from start to end inclusive.

Start and end are character-based positions and correctly deal with multibyte strings in localized environments.

NOTE: use of MString::substringW over MString::substring is recommended

Parameters

[in]	start	the index of the first character to copy
[in]	end	the index of the last character to copy

Returns: An MString containing the substring.

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/MayaTransformCollectionWriter.cpp, AbcExport/AbcExport.cpp, AbcImport/AlembicImportFileTranslator.cpp, atomImportExport/atomNodeNameReplacer.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, glslShader/GLSLShader.cpp, gpuCache/CacheReader.cpp, and gpuCache/CacheReaderAlembic.cpp.

MString & toUpperCase ( )

Modify the current instance of the string replacing all lower case characters in the corresponding upper case characters.

Returns: A reference to the current, modified MString instance

MString & toLowerCase ( )

Modify the current instance of the string replacing all lower case characters in the corresponding upper case characters.

Returns: A reference to the current, modified MString instance

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/AttributesWriter.cpp, AbcExport/AbcExport.cpp, AbcExport/AttributesWriter.cpp, AbcImport/AlembicImportFileTranslator.cpp, apiMeshShape/apiMeshGeometryOverride.cpp, cgFx/cgfxEffectDef.cpp, cgFx/cgfxShaderNode.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderCompileHelper.cpp, dx11Shader/dx11ShaderUniformParamBuilder.cpp, glslShader/GLSLShader.cpp, and hwApiTextureTest/hwApiTextureTest.cpp.

bool isShort ( ) const

Returns true if the string represents a valid short, and false otherwise.

Returns: True or false

short asShort ( ) const

Returns the value of the string in this MString instance converted to a short.

If the string does contain a valid string representation of a short, then the results of this operation are undefined.

Returns: The value of the current string converted to a short.

bool isInt ( ) const

Returns true if the string represents a valid int, and false otherwise.

Returns: True or false

int asInt ( ) const

Returns the value of the string in this MString instance converted to an integer.

If the string does contain a valid string representation of an integer, then the results of this operation are undefined.

Returns: The value of the current string converted to an integer.

bool isUnsigned ( ) const

Returns true if the string represents a valid unsigned int, and false otherwise.

Returns: True or false

Examples:: AbcBullet/MayaUtility.h, AbcExport/MayaUtility.h, and gpuCache/gpuCacheVramQuery.cpp.

unsigned int asUnsigned ( ) const

Returns the value of the string in this MString instance converted to an unsigned integer.

If the string does contain a valid string representation of an unsigned integer, then the results of this operation are undefined.

Returns: The value of the current string converted to an integer.

Examples:: gpuCache/gpuCacheVramQuery.cpp, and sceneAssembly/assemblyDefinition.cpp.

bool isFloat ( ) const

Returns true if the string represents a valid float, and false otherwise.

Returns: True or false

Examples:: AbcBullet/MayaUtility.h, and AbcExport/MayaUtility.h.

float asFloat ( ) const

Returns the value of the string in this MString instance converted to a float.

If the string does contain a valid string representation of a float, then the results of this operation are undefined.

Returns: The value of the current string converted to a float.

bool isDouble ( ) const

Returns true if the string represents a valid double, and false otherwise.

Returns: True or false

Examples:: animImportExport/animImportExport.cpp, and atomImportExport/atomImportExport.cpp.

double asDouble ( ) const

Returns the value of the string in this MString instance converted to a double.

If the string does contain a valid string representation of a double, then the results of this operation are undefined.

Returns: The value of the current string converted to a double.

MString expandEnvironmentVariablesAndTilde ( MStatus * ReturnStatus = NULL ) const

Returns a new string constructed by duplicating the current string with all environment variables expanded (and on UNIX, tilde characaters ("~") are also expanded.

Environment variables may be of the form $ENV_VAR or ${ENV_VAR}. On Windows, ENV_VAR, ENV_VAR% and %{ENV_VAR}% are also accepted. If no environment variable in the system matches that given, the unexpanded variable is copied verbatim into the result string. On UNIX, any tilde characters ("~") will also be expanded according to the standard UNIX convention. If the user name associated with a tilde is undefined, the tilde and name which follows it are copied verbatim into the result string. Notes (1) when any error occurs, processing continues such that all subsequent environment variable and tilde occurences are processed and the resulting string can be displayed to the user to help diagnose the undefined entities (2) escape sequences using backslash characters are not supported.

Parameters

[out] ReturnStatus Status code

Returns: A new string containing the value of the original string with environment variable (and tilde characters on UNIX) which were defined expanded. All undefined environment variables and tildes are copied into the result string unexpanded.

Status Codes:

MS::kSuccess All expansions succeeded.
MS::kNotFound One or more expansion failed.

Examples:: dx11Shader/dx11ShaderCompileHelper.cpp, glslShader/GLSLShader.cpp, and gpuCache/gpuCacheConfig.cpp.

MString expandFilePath ( MStatus * ReturnStatus = NULL ) const

Returns a new string constructed by duplicating the current string with all environment variables expanded (and on UNIX, tilde characaters ("~") are also expanded.

Environment variables may be of the form $ENV_VAR or ${ENV_VAR}. On Windows, ENV_VAR, ENV_VAR% and %{ENV_VAR}% are also accepted. If no environment variable in the system matches that given, the unexpanded variable is copied verbatim into the result string. On UNIX, any tilde characters ("~") will also be expanded according to the standard UNIX convention. If the user name associated with a tilde is undefined, the tilde and name which follows it are copied verbatim into the result string. Notes (1) when any error occurs, processing continues such that all subsequent environment variable and tilde occurences are processed and the resulting string can be displayed to the user to help diagnose the undefined entities (2) escape sequences using backslash characters are not supported.

This does some file-path specific expansion. So if we have an invalid sequence like $A;;$B or $A::$B (on Mac/Linux), it will be collapsed to $A;$B or $A:$B respectively, then expanded.

We also do file-path specific nested environment variable expansion. So if you have $A/foo, and $A = "A;a", this will result in, A/foo;a/foo instead of A;a/foo. If you want A;a/foo, use MString::expandEnvironmentVariablesAndTilde

Parameters

[out] ReturnStatus Status code

Returns: A new string containing the value of the original string with environment variable (and tilde characters on UNIX) which were defined expanded. All undefined environment variables and tildes are copied into the result string unexpanded.

Status Codes:

MS::kSuccess All expansions succeeded.
MS::kNotFound One or more expansion failed.

MStatus format	(	const MString &	fmt,
		const MStringArray &	args
	)

Format the string value using a format specifier and an array of positional arguments.

A maximum of 10 arguments may be specified in the array passed. The number of arguments must match exactly the number of arguments expected by the format statement.

All arguments are passed as MStrings (any numeric data for example must already be formatted by the caller into an MString).

Format specifiers determine the relative position and ordering of arguments in the string using specifiers of the form: ^1s ^2s ^3s etc. See also the mel format command.

Parameters

[in]	fmt	format string (up to 10 positional argument specifiers)
[in]	args	array of arguments to be positioned in the format string

Returns: MS::kSuccess for success, otherwise MS::kFailure

Examples:: AbcBullet/AbcBullet.cpp, AbcBullet/MayaTransformCollectionWriter.cpp, AbcBullet/MayaTransformWriter.cpp, AbcExport/AbcExport.cpp, AbcExport/MayaMeshWriter.cpp, AbcImport/AbcImport.cpp, AbcImport/AlembicImportFileTranslator.cpp, AbcImport/CreateSceneHelper.cpp, animImportExport/animFileUtils.cpp, atomImportExport/atomFileUtils.cpp, autoLoader/moduleLogic.cpp, blast2Cmd/blast2Cmd.cpp, closestPointOnCurve/closestPointOnCurveCmd.cpp, depthShader/depthShader.cpp, dx11Shader/dx11Shader.cpp, dx11Shader/dx11ShaderStrings.cpp, glslShader/GLSLShaderStrings.cpp, gpuCache/CacheWriterAlembic.cpp, gpuCache/gpuCacheCmd.cpp, gpuCache/gpuCacheShapeNode.cpp, gpuCache/gpuCacheUtil.h, hwApiTextureTest/hwApiTextureTest.cpp, hwApiTextureTest/hwApiTextureTestStrings.cpp, MetadataSample/createMetadataCmd.cpp, MetadataSample/exportMetadataCmd.cpp, MetadataSample/importMetadataCmd.cpp, MetadataSample/metadataBase.cpp, nodeInfoCmd/nodeInfoCmd.cpp, sceneAssembly/adskSceneMetadataCmd.cpp, sceneAssembly/assemblyDefinition.cpp, sceneAssembly/assemblyReference.cpp, and sceneAssembly/sceneAssemblyPluginMain.cpp.

MStatus format	(	const MString &	fmt,
		const MString &	arg1 = `MString::argUnused`,
		const MString &	arg2 = `MString::argUnused`,
		const MString &	arg3 = `MString::argUnused`,
		const MString &	arg4 = `MString::argUnused`,
		const MString &	arg5 = `MString::argUnused`,
		const MString &	arg6 = `MString::argUnused`,
		const MString &	arg7 = `MString::argUnused`,
		const MString &	arg8 = `MString::argUnused`,
		const MString &	arg9 = `MString::argUnused`,
		const MString &	arg10 = `MString::argUnused`
	)

Format the string value using a format specifier and positional arguments.

A maximum of 10 argument strings may be passed in the argument list. This routine accepts a variable number of arguments in the argument list. Unused arguments should not be passed. (i.e. if 3 arguments are required by the format statement, exactly 3 arguments should be passed when calling MString::format).

All arguments are passed as MStrings (any numeric data for example must already be converted by the caller to an MString).

Format specifiers determine the relative position and ordering of arguments in the string using specifiers of the form: ^1s ^2s ^3s etc. See also the mel format command for more information.

Parameters

[in]	fmt	format string (up to 10 positional arguments)
[in]	arg1	argument to be positioned in the format string
[in]	arg2	argument to be positioned in the format string
[in]	arg3	argument to be positioned in the format string
[in]	arg4	argument to be positioned in the format string
[in]	arg5	argument to be positioned in the format string
[in]	arg6	argument to be positioned in the format string
[in]	arg7	argument to be positioned in the format string
[in]	arg8	argument to be positioned in the format string
[in]	arg9	argument to be positioned in the format string
[in]	arg10	argument to be positioned in the format string

Returns: MS::kSuccess for success, otherwise MS::kFailure

MStatus substitute	(	const MString &	src,
		const MString &	target
	)

Replace all occurrences of src in this string with target.

Parameters

[in]	src	The string to search for
[in]	target	The replacement string

Returns: MS::kSuccess for success, otherwise MS::kFailure

Examples:: glslShader/GLSLShader.cpp.

MStatus substituteFirst	(	const MString &	src,
		const MString &	target
	)

Replace the first occurrence of src in this string with target.

Parameters

[in]	src	The string to search for
[in]	target	The replacement string

Returns: MS::kSuccess for success, otherwise MS::kFailure

Friends And Related Function Documentation

OPENMAYA_EXPORT std::ostream& operator<<	(	std::ostream &	s,
		const MString &	str
	)

friend

NO SCRIPT SUPPORT.

Parameters

[in]	s	the ostream to print to
[in]	str	the MString whose value is to be printed

Returns: The ostream reference, s, provided as the first parameter.

OPENMAYA_EXPORT MString operator+	(	const char *	first,
		const MString &	second
	)

friend

NO SCRIPT SUPPORT.

The MString on the right is appended to the character string on the left and the result is returned in a new MString. Neither of the operands is modified.

NOTE: in multibyte locales, the character buffer encoding is assumed to be the native multibyte encoding of the current locale.

Parameters

[in]	first	Left operand.
[in]	second	Right operand.

The documentation for this class was generated from the following files:

MString.h
MString.cpp

Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation