就业培训     下载中心     Wiki     联络 登录   注册

---

Strings are also registered in resource files. Each of these strings has an ID in cd4_symbols.h and is defined in a * .str file in the string folder of a specific language. This way a plugin can easily be localized by adding str files for each supported language.

• GeLoadString() : Returns a string from the resource files. Different versions of GeLoadString() allow to replace the placeholders in the string with custom content.

注意

A plugin must load its resources in PluginMessage() to use GeLoadString() 。见 初始化资源 .

If it is needed that the user enters or edits a String a special dialog can be used:

• RenameDialog() : Opens a dialog that presents a String and allows the user to edit this String .

拷贝

A String can be copied with the default operator:

• String::operator=() : Assigns the content of the String to the other String 对象。

Combine

Multiple String objects can be combined with the usual operators:

• String::operator+() : Combines two strings and returns the result string.
• String::operator+=() : Concatenates the strings and sets the left-hand operand to the result.

Find String

The String class provides functions to find substrings in a given string or character:

• String::FindFirst : Searches the string for the first match of a given substring.
• String::FindFirstUpper() : Searches the string for the first match of the upper-case substring.
• String::FindLast() : Searches the string for the last match of the substring.
• String::FindLastUpper() : Searches the string for the last match of the upper-case substring.

// search for substring "Bar" if (fooBar. FindFirst ( "Bar" , &pos)) ApplicationOutput ( "Found at position " + String::IntToString (pos));

Substrings

The String class provides functions to return substrings of a given string:

• String::SubStr() : Returns a substring from the string.
• String::Left() : Returns a substring from the left of the string.
• String::Right() : Returns a substring from the right of the string.
• String::Delete() : Removes a section from the string.

// prints "Alice" ApplicationOutput (aliceBob.Left(5));

// prints "Bob" ApplicationOutput (aliceBob.Right(3));

// prints "and" ApplicationOutput (aliceBob.SubStr(6, 3));

// removes "and" aliceBob.Delete(6, 3);

// adds a "+" aliceBob.Insert(6, '+' ) iferr_return ;

// prints "Alice + Bob" ApplicationOutput (aliceBob);

It is also possible to accesses a single character directly:

• String::operator[]() : Sets or gets a constant Unicode character from the string at the given position.

比较

The String class provides functions to compare to String objects:

• String::Compare() : Compare the strings and returns their relationship.
• String::ComparePart() : Compares a part of the string.
• String::LexCompare() : Compares the String object with another string and returns their relationship.
• String::LexComparePart() : Compares a part of the string with the given string and returns their relationship

转换

注意

MAXON API data types typically implement a ToString() 函数。

To Numbers

A string can be converted to a number when the stored characters describe a number. This might be useful for example to handle user input:

• String::ParseToFloat() : Converts the string into a Float 值。
• String::ParseToInt32() : Converts the string into an Int32 值。
• String::ToInt32() : Converts the string to an Int32 值。
• String::ToInt64() : Converts the string to an Int64 值。
• String::ToUInt32() : Converts the string to a UInt32 值。
• String::ToUInt64() : Converts the string to a UInt64 值。
• String::ToFloat() : Converts the string to a Float 值。
• String::ToInt() : Converts the string to an Int 值。
• String::ToUInt() : Converts the string to a UInt 值。

Also a more generic function is available:

• StringToNumber() : Converts a string to a data value of type Float , Int32 or BaseTime .

From Numbers

Several static functions can be used to convert both 32 and 64 bit numbers to strings:

• String::MemoryToString() : Converts the number to a memory size.
• String::HexToString() : Converts the number to a hexadecimal representation.
• String::IntToString() : Converts the given integer value to a string.
• String::UIntToString() : Converts the given unsigned integer value to a string.
• String::FloatToString() : Converts the given float value to a string.
• String::VectorToString() : Converts the given vector to a string.

Also:

• FormatNumber() : Converts a Float , Int32 or BaseTime to a formatted string.

Upper and Lower Case

A typical string operation is to convert all characters to upper or lowercase characters. These functions only work with ANSI characters less than character code 128, all other characters remain unchanged:

• String::ToUpper() : Returns the string converted to upper case characters.
• String::ToLower() : Returns the string converted to lower case characters.

C string

Sometimes strings must be communicated with other libraries. In this case it is needed to convert a Cinema 4D String into a standard string:

• String::GetCStringLen() : Gets the expected length of the string after encoding.
• String::GetCString() : Gets the string after encoding.
• String::GetCStringCopy() : Gets the encoded string as a copy.
• String::SetCString() : Sets the string from a given standard C string.

// convert to c string and insert into std string. Char * cstring = string . GetCStringCopy (); std::string stdString { cstring }; DeleteMem (cstring);

Filename

The Filename class is used to handle filenames and paths. Its content can be defined with strings and be converted to strings:

• Filename::GetString() : Returns the full filename as a String .
• Filename::SetString() : Sets the filename with the given String .
• Filename::GetFileString() : Returns the file part of the filename as a String .
• Filename::GetSuffix() : Returns the file suffix as a String .

另请参阅 Filename Manual .

// open file selector dialog if (selectFile. FileSelect ( FILESELECTTYPE::ANYTHING , FILESELECT::LOAD , "Select File" _s)) { ApplicationOutput ( "File selected: " + selectFile. GetString ()); ApplicationOutput ( "File: " + selectFile. GetFileString ()); ApplicationOutput ( "Suffix: " + selectFile. GetSuffix ()); }

Date & Time

类 DateTimeParser can be used to parse and create date time strings.

Similar functionality is also provided by functions of the datetime library:

• ParseTimeString() : Parses the time defined in the given String .
• ParseDateString() : Parses the date defined in the given String .
• FormatTime() : Returns a String with the formatted time. It uses the same arguments as the asctime() function of the standard library.
• TimeToString() : Returns a String with the formatted time.
• DateToString() : Returns a String with the formatted date.
• GetMonthName() : Returns a String with the name of the given month.

Disc I/O

A String object can be stored in a BaseFile 或 HyperFile using:

• BaseFile::ReadString() : Reads a String 从 BaseFile .
• BaseFile::WriteString() : Writes a String into the BaseFile .

// open BaseFile to write if (!bf-> Open (filename, FILEOPEN::WRITE , FILEDIALOG::ANY )) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); bf-> WriteString ( string ); bf-> 关闭 ();

// This example reads a String form the given BaseFile. AutoAlloc<BaseFile> bf; if (bf == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// open BaseFile to read if (!bf-> Open (filename, FILEOPEN::READ , FILEDIALOG::ANY )) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); String string; bf-> ReadString (& string ); ApplicationOutput ( "String from BaseFile: " + string ); bf-> 关闭 ();

• HyperFile::ReadString() : Reads a String 从 HyperFile .
• HyperFile::WriteString() : Writes a String into the HyperFile .

// open HyperFile to write if (hf-> Open (789, filename, FILEOPEN::WRITE , FILEDIALOG::ANY )) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); hf-> WriteString ( string ); hf-> 关闭 ();

// This example reads a String from the given HyperFile. AutoAlloc<HyperFile> hf; if (hf == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// open HyperFile to read if (!hf-> Open (789, filename, FILEOPEN::READ , FILEDIALOG::ANY )) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); String string; hf-> ReadString (& string ); ApplicationOutput ( "String from HyperFile: " + string ); hf-> 关闭 ();

另请参阅 BaseFile Manual on String and HyperFile Manual on String .

Regular Expressions

Regular expressions are used to check if a given string matches a certain pattern. The class RegularExprParser provides basic functionality to parse for simple expressions:

• RegularExprParser::Alloc() : Allocates a regular expression parser.
• RegularExprParser::Free() : Frees a regular expression parser.

The parser is used with these functions:

• RegularExprParser::Init() : Initializes the parser with the given regular expression.
• RegularExprParser::FindFirst() : Performs a search using the regular expression passed to RegularExprParser::Init() in the given string and returns the position of the first match.
• RegularExprParser::FindNext() : Returns the position of further matches.
• RegularExprParser::CleanUp() : Cleans the memory allocated by RegularExprParser::Init() .

// define expression const String anyChar = String (1, ANY_CHAR ); String expression( "(" + anyChar + "*)(.jpg)" ); regEx-> Init (expression);

// check string if (regEx-> FindFirst (filename, REGPARSEMODE::CONTAINS , false , pos, strSerial)) ApplicationOutput (strSerial); else ApplicationOutput ( "Expression does not match." );

Special Characters

Some symbols may be OS depended. These functions exist to get the correct symbol in each environment:

• GeGetDegreeChar() : Returns the degree character.
• GeGetPercentChar() : Returns the percent character.
• GeGetLineEnd() : Returns a string that contains the type of line ending characters for the running OS.

延伸阅读

• GeData Manual
• BaseContainer Manual
• Primitive Data Types Manual (Classic)
• Vector Manual (Classic)
• Matrix Manual (Classic)
• Filename Manual