#include #include #include #include #include #include #include namespace DB { using namespace GatherUtils; namespace ErrorCodes { extern const int ILLEGAL_COLUMN; extern const int ILLEGAL_TYPE_OF_ARGUMENT; extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH; extern const int TOO_LARGE_STRING_SIZE; extern const int INDEX_OF_POSITIONAL_ARGUMENT_IS_OUT_OF_RANGE; } namespace { /// The maximum new padded length. constexpr ssize_t MAX_NEW_LENGTH = 1000000; /// Appends padding characters to a sink based on a pad string. /// Depending on how many padding characters are required to add /// the pad string can be copied only partly or be repeated multiple times. template class PaddingChars { public: explicit PaddingChars(const String & pad_string_) : pad_string(pad_string_) { init(); } ALWAYS_INLINE size_t numCharsInPadString() const { if constexpr (is_utf8) return utf8_offsets.size() - 1; else return pad_string.length(); } ALWAYS_INLINE size_t numCharsToNumBytes(size_t count) const { if constexpr (is_utf8) return utf8_offsets[count]; else return count; } void appendTo(StringSink & res_sink, size_t num_chars) const { if (!num_chars) return; const size_t step = numCharsInPadString(); while (true) { if (num_chars <= step) { writeSlice(StringSource::Slice{std::bit_cast(pad_string.data()), numCharsToNumBytes(num_chars)}, res_sink); break; } writeSlice(StringSource::Slice{std::bit_cast(pad_string.data()), numCharsToNumBytes(step)}, res_sink); num_chars -= step; } } private: void init() { if (pad_string.empty()) pad_string = " "; if constexpr (is_utf8) { size_t offset = 0; utf8_offsets.reserve(pad_string.length() + 1); while (true) { utf8_offsets.push_back(offset); if (offset == pad_string.length()) break; offset += UTF8::seqLength(pad_string[offset]); if (offset > pad_string.length()) offset = pad_string.length(); } } /// Not necessary, but good for performance. /// We repeat `pad_string` multiple times until it's length becomes 16 or more. /// It speeds up the function appendTo() because it allows to copy padding characters by portions of at least /// 16 bytes instead of single bytes. while (numCharsInPadString() < 16) { pad_string += pad_string; if constexpr (is_utf8) { size_t old_size = utf8_offsets.size(); utf8_offsets.reserve((old_size - 1) * 2); size_t base = utf8_offsets.back(); for (size_t i = 1; i != old_size; ++i) utf8_offsets.push_back(utf8_offsets[i] + base); } } } String pad_string; /// Offsets of code points in `pad_string`: /// utf8_offsets[0] is the offset of the first code point in `pad_string`, it's always 0; /// utf8_offsets[1] is the offset of the second code point in `pad_string`; /// utf8_offsets[2] is the offset of the third code point in `pad_string`; /// ... std::vector utf8_offsets; }; /// Returns the number of characters in a slice. template inline ALWAYS_INLINE size_t getLengthOfSlice(const StringSource::Slice & slice) { if constexpr (is_utf8) return UTF8::countCodePoints(slice.data, slice.size); else return slice.size; } /// Moves the end of a slice back by n characters. template inline ALWAYS_INLINE StringSource::Slice removeSuffixFromSlice(const StringSource::Slice & slice, size_t suffix_length) { StringSource::Slice res = slice; if constexpr (is_utf8) res.size = UTF8StringSource::skipCodePointsBackward(slice.data + slice.size, suffix_length, slice.data) - res.data; else res.size -= std::min(suffix_length, res.size); return res; } /// If `is_right_pad` - it's the rightPad() function instead of leftPad(). /// If `is_utf8` - lengths are measured in code points instead of bytes. template class FunctionPadString : public IFunction { public: static constexpr auto name = is_right_pad ? (is_utf8 ? "rightPadUTF8" : "rightPad") : (is_utf8 ? "leftPadUTF8" : "leftPad"); static FunctionPtr create(const ContextPtr) { return std::make_shared(); } String getName() const override { return name; } bool isVariadic() const override { return true; } size_t getNumberOfArguments() const override { return 0; } bool isSuitableForShortCircuitArgumentsExecution(const DataTypesWithConstInfo & /*arguments*/) const override { return true; } bool useDefaultImplementationForConstants() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { size_t number_of_arguments = arguments.size(); if (number_of_arguments != 2 && number_of_arguments != 3) throw Exception( ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "Number of arguments for function {} doesn't match: passed {}, should be 2 or 3", getName(), number_of_arguments); if (!isStringOrFixedString(arguments[0])) throw Exception( ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of the first argument of function {}, should be string", arguments[0]->getName(), getName()); if (!isInteger(arguments[1])) throw Exception( ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of the second argument of function {}, should be unsigned integer", arguments[1]->getName(), getName()); if (number_of_arguments == 3 && !isStringOrFixedString(arguments[2])) throw Exception( ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of the third argument of function {}, should be const string", arguments[2]->getName(), getName()); return arguments[0]; } ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override { auto column_string = arguments[0].column; auto column_length = arguments[1].column; String pad_string; if (arguments.size() == 3) { auto column_pad = arguments[2].column; const ColumnConst * column_pad_const = checkAndGetColumnConst(column_pad.get()); if (!column_pad_const) throw Exception( ErrorCodes::ILLEGAL_COLUMN, "Illegal column {}, third argument of function {} must be a constant string", column_pad->getName(), getName()); pad_string = column_pad_const->getValue(); } PaddingChars padding_chars{pad_string}; auto col_res = ColumnString::create(); StringSink res_sink{*col_res, input_rows_count}; if (const ColumnString * col = checkAndGetColumn(column_string.get())) executeForSource(StringSource{*col}, column_length, padding_chars, res_sink); else if (const ColumnFixedString * col_fixed = checkAndGetColumn(column_string.get())) executeForSource(FixedStringSource{*col_fixed}, column_length, padding_chars, res_sink); else if (const ColumnConst * col_const = checkAndGetColumnConst(column_string.get())) executeForSource(ConstSource{*col_const}, column_length, padding_chars, res_sink); else if (const ColumnConst * col_const_fixed = checkAndGetColumnConst(column_string.get())) executeForSource(ConstSource{*col_const_fixed}, column_length, padding_chars, res_sink); else throw Exception( ErrorCodes::ILLEGAL_COLUMN, "Illegal column {}, first argument of function {} must be a string", arguments[0].column->getName(), getName()); return col_res; } private: template void executeForSource( SourceStrings && strings, const ColumnPtr & column_length, const PaddingChars & padding_chars, StringSink & res_sink) const { if (const auto * col_const = checkAndGetColumn(column_length.get())) executeForSourceAndLength(std::forward(strings), ConstSource{*col_const}, padding_chars, res_sink); else executeForSourceAndLength(std::forward(strings), GenericValueSource{*column_length}, padding_chars, res_sink); } template void executeForSourceAndLength( SourceStrings && strings, SourceLengths && lengths, const PaddingChars & padding_chars, StringSink & res_sink) const { bool is_const_new_length = lengths.isConst(); ssize_t new_length = 0; /// Insert padding characters to each string from `strings`, write the result strings into `res_sink`. /// If for some input string its current length is greater than the specified new length then that string /// will be trimmed to the specified new length instead of padding. for (; !res_sink.isEnd(); res_sink.next(), strings.next(), lengths.next()) { auto str = strings.getWhole(); ssize_t current_length = getLengthOfSlice(str); if (!res_sink.rowNum() || !is_const_new_length) { /// If `is_const_new_length` is true we can get and check the new length only once. auto new_length_slice = lengths.getWhole(); new_length = new_length_slice.elements->getInt(new_length_slice.position); if (new_length > MAX_NEW_LENGTH) { throw Exception(ErrorCodes::TOO_LARGE_STRING_SIZE, "New padded length ({}) is too big, maximum is: {}", std::to_string(new_length), std::to_string(MAX_NEW_LENGTH)); } if (new_length < 0) { throw Exception( ErrorCodes::INDEX_OF_POSITIONAL_ARGUMENT_IS_OUT_OF_RANGE, "New padded length ({}) is negative", std::to_string(new_length)); } if (is_const_new_length) { size_t rows_count = res_sink.offsets.size(); res_sink.reserve((new_length + 1 /* zero terminator */) * rows_count); } } if (new_length == current_length) { writeSlice(str, res_sink); } else if (new_length < current_length) { str = removeSuffixFromSlice(str, current_length - new_length); writeSlice(str, res_sink); } else if (new_length > current_length) { if constexpr (!is_right_pad) padding_chars.appendTo(res_sink, new_length - current_length); writeSlice(str, res_sink); if constexpr (is_right_pad) padding_chars.appendTo(res_sink, new_length - current_length); } } } }; } REGISTER_FUNCTION(PadString) { factory.registerFunction>(); /// leftPad factory.registerFunction>(); /// leftPadUTF8 factory.registerFunction>(); /// rightPad factory.registerFunction>(); /// rightPadUTF8 factory.registerAlias("lpad", "leftPad", FunctionFactory::CaseInsensitive); factory.registerAlias("rpad", "rightPad", FunctionFactory::CaseInsensitive); } }