Kevux Git Server - fll/blob

   1 .TH fl_string_dynamic_partial_compare_except_trim_dynamic "3" "July 2023" "FLL - Featureless Linux Library 0.6.9" "Library Functions"
   2 .SH "NAME"
   3 fl_string_dynamic_partial_compare_except_trim_dynamic
   4 .SH SYNOPSIS
   5 .nf
   6 .B #include <fll/level_1/string.h>
   7 .sp
   8 \fBf_status_t fl_string_dynamic_partial_compare_except_trim_dynamic\fP(
   9     \fBconst f_string_static_t \fP\fIstring1\fP,
  10     \fBconst f_string_static_t \fP\fIstring2\fP,
  11     \fBconst f_string_range_t  \fP\fIrange2\fP,
  12     \fBconst f_array_lengths_t \fP\fIexcept1\fP,
  13     \fBconst f_array_lengths_t \fP\fIexcept2\fP
  14 );
  15 .fi
  16 .SH DESCRIPTION
  17 .PP
  18 Compare two strings, similar to strncmp(), but restricted to the given range for the second string.
  19 .PP
  20 This does not stop on NULL. NULL characters are ignored. Ignores leading and trailing whitespace. All 1-byte characters in except1 and except2 are ignored.
  21 .SH PARAMETERS
  22 .TP
  23 .B string1
  24 String to compare.
  25
  26 .TP
  27 .B string2
  28 String to compare.
  29
  30 .TP
  31 .B range2
  32 A range within the string2 to restrict the comparison to.
  33
  34 .TP
  35 .B except1
  36 A set of locations within string1 to ignore. This assumes/requires that the locations be in linear order.
  37
  38 .TP
  39 .B except2
  40 A set of locations within string2 to ignore. This assumes/requires that the locations be in linear order.
  41
  42 .SH RETURN VALUE
  43 .PP
  44 \fBF_equal_to\fP when both strings equal.
  45 .br
  46 \fBF_equal_to_not\fP when both strings do not equal.
  47 .br
  48 \fBF_parameter\fP (with error bit) if a parameter is invalid.
  49 .br
  50 \fBF_parameter\fP (with error bit) from: f_utf_is_combining().
  51 .br
  52 \fBF_parameter\fP (with error bit) from: f_utf_is_whitespace().
  53 .SH AUTHOR
  54 Written by Kevin Day.
  55 .SH COPYRIGHT
  56 .PP
  57 Copyright \(co 2007-2023 Kevin Day, GNU LGPL Version 2.1 or later.