Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
substring - extract a substring from a string
Calling Sequence
substring(string, range)
Parameters
string
-
string or symbol
range
range m..n, or an integer m
Description
The substring function extracts a substring from a string or symbol. If applied to a string, a string is returned. If applied to a symbol, a symbol is returned.
If a range is specified for range, and m and n evaluate to integers then substring will extract a substring from string starting with the mth character and ending with the nth character.
Specifying a single integer m for range is equivalent to specifying the range m..m.
Negative values for m and/or n stand for positions counted leftwards from the right end of the string. The range 1..-1 refers to the entire string. The range -20..-1 refers to the last 20 characters of the string.
If n is greater than the length of string then substring returns a string from the mth character to the end of string. If m is equal to n + 1 then substring returns the null string.
Zero values for m and/or n are not permitted, except for the case m = 1 and n = 0, which returns the null string as described above.
If either m or n fails to evaluate to an integer, then substring remains unevaluated.
Thread Safety
The substring command is thread-safe as of Maple 15.
For more information on thread safety, see index/threadsafe.
Examples
See Also
cat, length, searchtext, SearchText, selection, string, StringTools, StringTools[SubString], symbol
Download Help Document