~jsvoboda/helenos/dnsr

« back to all changes in this revision

Viewing changes to kernel/generic/src/lib/str.c

  • Committer: Jiri Svoboda
  • Date: 2012-11-11 21:31:03 UTC
  • mfrom: (1527.1.178 mainline)
  • Revision ID: jiri@wiwaxia-20121111213103-314bmkettwvlwj97
MergeĀ mainlineĀ changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
455
455
/** Compare two NULL terminated strings.
456
456
 *
457
457
 * Do a char-by-char comparison of two NULL-terminated strings.
458
 
 * The strings are considered equal iff they consist of the same
459
 
 * characters on the minimum of their lengths.
 
458
 * The strings are considered equal iff their length is equal
 
459
 * and both strings consist of the same sequence of characters.
 
460
 *
 
461
 * A string S1 is less than another string S2 if it has a character with
 
462
 * lower value at the first character position where the strings differ.
 
463
 * If the strings differ in length, the shorter one is treated as if
 
464
 * padded by characters with a value of zero.
460
465
 *
461
466
 * @param s1 First string to compare.
462
467
 * @param s2 Second string to compare.
463
468
 *
464
 
 * @return 0 if the strings are equal, -1 if first is smaller,
465
 
 *         1 if second smaller.
 
469
 * @return 0 if the strings are equal, -1 if the first is less than the second,
 
470
 *         1 if the second is less than the first.
466
471
 *
467
472
 */
468
473
int str_cmp(const char *s1, const char *s2)
493
498
/** Compare two NULL terminated strings with length limit.
494
499
 *
495
500
 * Do a char-by-char comparison of two NULL-terminated strings.
496
 
 * The strings are considered equal iff they consist of the same
497
 
 * characters on the minimum of their lengths and the length limit.
 
501
 * The strings are considered equal iff
 
502
 * min(str_length(s1), max_len) == min(str_length(s2), max_len)
 
503
 * and both strings consist of the same sequence of characters,
 
504
 * up to max_len characters.
 
505
 *
 
506
 * A string S1 is less than another string S2 if it has a character with
 
507
 * lower value at the first character position where the strings differ.
 
508
 * If the strings differ in length, the shorter one is treated as if
 
509
 * padded by characters with a value of zero. Only the first max_len
 
510
 * characters are considered.
498
511
 *
499
512
 * @param s1      First string to compare.
500
513
 * @param s2      Second string to compare.
501
514
 * @param max_len Maximum number of characters to consider.
502
515
 *
503
 
 * @return 0 if the strings are equal, -1 if first is smaller,
504
 
 *         1 if second smaller.
 
516
 * @return 0 if the strings are equal, -1 if the first is less than the second,
 
517
 *         1 if the second is less than the first.
505
518
 *
506
519
 */
507
520
int str_lcmp(const char *s1, const char *s2, size_t max_len)