Colored suit symbols in Google Docs

suitsymbols.gs

function replaceStringAndSetColor(body, str, replacement, color) {
    var foundElement = body.findText(str);
    while (foundElement != null) {
      var foundText = foundElement.getElement().asText();
      var start = foundElement.getStartOffset();
      var end = foundElement.getEndOffsetInclusive();
      foundText.setForegroundColor(start, end, color);
      foundElement = body.findText(str, foundElement);
    }
    body.replaceText(str, replacement);
}

function suitSymbols() {
  var body = DocumentApp.getActiveDocument().getBody();
  
  replaceStringAndSetColor(body, "!c", "♣", "#0000ff");
  replaceStringAndSetColor(body, "!d", "♦", "#ffa500");
  replaceStringAndSetColor(body, "!h", "♥", "#ff0000");
  replaceStringAndSetColor(body, "!s", "♠", "#000000");
}

When this script is run it will replace !c !d !h and !s with colored suit symbols.