D Documentation  
[ Home ][ Up ]
  1. Introduction
    1. A simple tutorial
    2. Switching to D
    3. An advanced tutorial
  2. Language Reference
    1. General syntax
    2. Statements
    3. Types
    4. Error Handling
    5. Memory Management
  3. Std. runtime library (Phobos)
    1. std.base64
    2. std.boxer
    3. std.compiler
    4. std.conv
    5. std.ctype
    6. std.date
    7. std.file
    8. std.format
    9. std.gc
    10. std.intrinsic
    11. std.math
    12. std.md5
    13. std.mmfile
    14. std.outbuffer
    15. std.path
    16. std.process
    17. std.random
    18. std.recls
    19. std.regexp
      1. find
      2. rfind
      3. search
      4. split
      5. sub
      6. Regexp.replace
    20. std.socket
    21. std.socketstream
    22. std.stdint
    23. std.stdio
    24. std.stream
    25. std.string
    26. std.system
    27. std.thread
    28. std.uri
    29. std.utf
    30. std.zip
    31. std.zlib
  4. Libraries and Tools
    1. mango
    2. Build
  5. Related Links
  6. About this documentation
sub 
char[] sub(char[] string, char[] pattern, char[] format, char[] attributes = null)
char[] sub(char[] string, char[] pattern, char[] delegate(RegExp) dg, char[] attributes = null)

Searches string for matches with regular expression pattern with attributes and replaces those matches with a new string composed of format merged with the result of the matches.

If the multiple line attribute is set, ^ and $ represent the start and end of a line. If the multiple line attribute is not set, ^ and $ represent the start and end of the entire string.

If the global attribute is set, replace all matches. Otherwise, replace the first match.

Example:
import std.stdio;
import std.regexp;

int main() {
  // replace numbers with #
  char[] phone = "905-555-1234";
  phone = sub(phone,"[0-9]","#","g"); // global
  writefln("%s",phone);
  
  char[] str;
  // wrap all vowels with brackets
  str = sub("Hello","([aeiou])","[$1]","gi"); // global, ignore case
  writefln("%s",str);
  
  // $` is the stuff left of the match
  // $' is the stuff right of the match
  // $& is the match itself
  // remember $` is left because ` is on the left side of the keyobard
  str = sub("Hello","[aeiou]","($`$&$')","i"); // ignore case
  writefln("%s",str);
  
  return 0;
}

Output:
###-###-####
H[e]ll[o]
H(Hello)llo
Created using PHP docwiki written by Markus Dangl. Best viewed with Mozilla Firefox.