net.sf.jasperreports.functions.standard.TextFunctions Maven / Gradle / Ivy
/*
* JasperReports - Free Java Reporting Library.
* Copyright (C) 2001 - 2023 Cloud Software Group, Inc. All rights reserved.
* http://www.jaspersoft.com
*
* Unless you have purchased a commercial license agreement from Jaspersoft,
* the following license terms apply:
*
* This program is part of JasperReports.
*
* JasperReports is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* JasperReports is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with JasperReports. If not, see 255)){
if(log.isDebugEnabled()) {
log.debug("The number must be an integer number between 1 and 255.");
}
return null;
}
return Character.toString((char)number.intValue());
}
// ===================== CLEAN function ===================== //
/**
* Returns a new text string without non-printable characters.
*/
@Function("CLEAN")
@FunctionParameters({
@FunctionParameter("text")})
public static String CLEAN(String text){
if(text==null){
logNullTextString();
return null;
}
String cleanedString = text.replaceAll("\\p{Cntrl}", "");
return cleanedString;
}
// ===================== CODE function ===================== //
/**
* Returns the numeric code (0-255) for the first character in a string.
*/
@Function("CODE")
@FunctionParameters({
@FunctionParameter("textString")})
public static Integer CODE(String textString){
if(textString==null){
logNullTextString();
return null;
}
int firstCharAsNum = textString.charAt(0);
if(firstCharAsNum<0 || firstCharAsNum>255){
throw new JRRuntimeException("The first character of the text can not be converted to a valid numeric ASCII code.");
}
return firstCharAsNum;
}
// ===================== CONCATENATE function ===================== //
/**
* Combines a list of strings into a single one.
*/
@Function("CONCATENATE")
@FunctionParameters({
@FunctionParameter("strings")})
public static String CONCATENATE(String ...strings){
if(strings.length==0) {
if(log.isDebugEnabled()) {
log.debug("No arguments were specified.");
}
return null;
}
StringBuilder sb=new StringBuilder();
for (int i=0;i