Skip to content

[libc] Implemented wcsncmp #142429

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 2, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions libc/config/linux/x86_64/entrypoints.txt
Original file line number Diff line number Diff line change
Expand Up @@ -366,6 +366,7 @@ set(TARGET_LIBC_ENTRYPOINTS
libc.src.wchar.wctob
libc.src.wchar.wmemset
libc.src.wchar.wcschr
libc.src.wchar.wcsncmp
libc.src.wchar.wcscmp
libc.src.wchar.wcspbrk
libc.src.wchar.wcsrchr
Expand Down
8 changes: 8 additions & 0 deletions libc/include/wchar.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,14 @@ functions:
arguments:
- type: const wchar_t *
- type: wchar_t
- name: wcsncmp
standards:
- stdc
return_type: int
arguments:
- type: const wchar_t *
- type: const wchar_t *
- type: size_t
- name: wcscmp
standards:
- stdc
Expand Down
11 changes: 11 additions & 0 deletions libc/src/wchar/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,17 @@ add_entrypoint_object(
libc.hdr.wchar_macros
)

add_entrypoint_object(
wcsncmp
SRCS
wcsncmp.cpp
HDRS
wcsncmp.h
DEPENDS
libc.hdr.wchar_macros
libc.hdr.types.size_t
)

add_entrypoint_object(
wcsspn
SRCS
Expand Down
37 changes: 37 additions & 0 deletions libc/src/wchar/wcsncmp.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
//===-- Implementation of wcsncmp -----------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#include "src/wchar/wcsncmp.h"

#include "hdr/types/size_t.h"
#include "hdr/types/wchar_t.h"
#include "src/__support/common.h"
#include "src/__support/macros/null_check.h"

namespace LIBC_NAMESPACE_DECL {

LLVM_LIBC_FUNCTION(int, wcsncmp,
(const wchar_t *left, const wchar_t *right, size_t n)) {
LIBC_CRASH_ON_NULLPTR(left);
LIBC_CRASH_ON_NULLPTR(right);

if (n == 0)
return 0;

auto comp = [](wchar_t l, wchar_t r) -> int { return l - r; };

for (; n > 1; --n, ++left, ++right) {
wchar_t lc = *left;
if (!comp(lc, '\0') || comp(lc, *right))
break;
}
return comp(*reinterpret_cast<const wchar_t *>(left),
*reinterpret_cast<const wchar_t *>(right));
}

} // namespace LIBC_NAMESPACE_DECL
22 changes: 22 additions & 0 deletions libc/src/wchar/wcsncmp.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
//===-- Implementation header for wcsncmp ---------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#ifndef LLVM_LIBC_SRC_WCHAR_WCSNCMP_H
#define LLVM_LIBC_SRC_WCHAR_WCSNCMP_H

#include "hdr/types/size_t.h"
#include "hdr/types/wchar_t.h"
#include "src/__support/macros/config.h"

namespace LIBC_NAMESPACE_DECL {

int wcsncmp(const wchar_t *left, const wchar_t *right, size_t n);

} // namespace LIBC_NAMESPACE_DECL

#endif // LLVM_LIBC_SRC_WCHAR_WCSNCMP_H
10 changes: 10 additions & 0 deletions libc/test/src/wchar/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,16 @@ add_libc_test(
libc.src.wchar.wcschr
)

add_libc_test(
wcsncmp_test
SUITE
libc_wchar_unittests
SRCS
wcsncmp_test.cpp
DEPENDS
libc.src.wchar.wcsncmp
)

add_libc_test(
wcscmp_test
SUITE
Expand Down
169 changes: 169 additions & 0 deletions libc/test/src/wchar/wcsncmp_test.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,169 @@
//===-- Unittests for wcsncmp ---------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#include "src/wchar/wcsncmp.h"
#include "test/UnitTest/Test.h"

// This group is just copies of the wcscmp tests, since all the same cases still
// need to be tested.

TEST(LlvmLibcWcsncmpTest, EmptyStringsShouldReturnZeroWithSufficientLength) {
const wchar_t *s1 = L"";
const wchar_t *s2 = L"";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 1);
ASSERT_EQ(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 1);
ASSERT_EQ(result, 0);
}

TEST(LlvmLibcWcsncmpTest,
EmptyStringShouldNotEqualNonEmptyStringWithSufficientLength) {
const wchar_t *empty = L"";
const wchar_t *s2 = L"abc";
int result = LIBC_NAMESPACE::wcsncmp(empty, s2, 3);
ASSERT_LT(result, 0);

// Similar case if empty string is second argument.
const wchar_t *s3 = L"123";
result = LIBC_NAMESPACE::wcsncmp(s3, empty, 3);
ASSERT_GT(result, 0);
}

TEST(LlvmLibcWcsncmpTest, EqualStringsShouldReturnZeroWithSufficientLength) {
const wchar_t *s1 = L"abc";
const wchar_t *s2 = L"abc";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 3);
ASSERT_EQ(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 3);
ASSERT_EQ(result, 0);
}

TEST(LlvmLibcWcsncmpTest,
ShouldReturnResultOfFirstDifferenceWithSufficientLength) {
const wchar_t *s1 = L"___B42__";
const wchar_t *s2 = L"___C55__";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 8);
ASSERT_LT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 8);
ASSERT_GT(result, 0);
}

TEST(LlvmLibcWcsncmpTest,
CapitalizedLetterShouldNotBeEqualWithSufficientLength) {
const wchar_t *s1 = L"abcd";
const wchar_t *s2 = L"abCd";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 4);
ASSERT_GT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 4);
ASSERT_LT(result, 0);
}

TEST(LlvmLibcWcsncmpTest,
UnequalLengthStringsShouldNotReturnZeroWithSufficientLength) {
const wchar_t *s1 = L"abc";
const wchar_t *s2 = L"abcd";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 4);
ASSERT_LT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 4);
ASSERT_GT(result, 0);
}

TEST(LlvmLibcWcsncmpTest, StringArgumentSwapChangesSignWithSufficientLength) {
const wchar_t *a = L"a";
const wchar_t *b = L"b";
int result = LIBC_NAMESPACE::wcsncmp(b, a, 1);
ASSERT_GT(result, 0);

result = LIBC_NAMESPACE::wcsncmp(a, b, 1);
ASSERT_LT(result, 0);
}

#if defined(LIBC_ADD_NULL_CHECKS) && !defined(LIBC_HAS_SANITIZER)
TEST(LlvmLibcWcsncmpTest, NullptrCrash) {
// Passing in a nullptr should crash the program.
EXPECT_DEATH([] { LIBC_NAMESPACE::wcsncmp(L"aaaaaaaaaaaaaa", nullptr, 3); },
WITH_SIGNAL(-1));
EXPECT_DEATH([] { LIBC_NAMESPACE::wcsncmp(nullptr, L"aaaaaaaaaaaaaa", 3); },
WITH_SIGNAL(-1));
}
#endif // LIBC_HAS_ADDRESS_SANITIZER

// This group is actually testing wcsncmp functionality

TEST(LlvmLibcWcsncmpTest, NonEqualStringsEqualWithLengthZero) {
const wchar_t *s1 = L"abc";
const wchar_t *s2 = L"def";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 0);
ASSERT_EQ(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 0);
ASSERT_EQ(result, 0);
}

TEST(LlvmLibcWcsncmpTest, NonEqualStringsNotEqualWithLengthOne) {
const wchar_t *s1 = L"abc";
const wchar_t *s2 = L"def";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 1);
ASSERT_LT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 1);
ASSERT_GT(result, 0);
}

TEST(LlvmLibcWcsncmpTest, NonEqualStringsEqualWithShorterLength) {
const wchar_t *s1 = L"___B42__";
const wchar_t *s2 = L"___C55__";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 3);
ASSERT_EQ(result, 0);

// This should return 'B' - 'C' = -1.
result = LIBC_NAMESPACE::wcsncmp(s1, s2, 4);
ASSERT_LT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 3);
ASSERT_EQ(result, 0);

// This should return 'C' - 'B' = 1.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 4);
ASSERT_GT(result, 0);
}

TEST(LlvmLibcWcsncmpTest, StringComparisonEndsOnNullByteEvenWithLongerLength) {
const wchar_t *s1 = L"abc\0def";
const wchar_t *s2 = L"abc\0abc";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 7);
ASSERT_EQ(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 7);
ASSERT_EQ(result, 0);
}

TEST(LlvmLibcWcsncmpTest, Case) {
const wchar_t *s1 = L"aB";
const wchar_t *s2 = L"ab";
int result = LIBC_NAMESPACE::wcsncmp(s1, s2, 2);
ASSERT_LT(result, 0);

// Verify operands reversed.
result = LIBC_NAMESPACE::wcsncmp(s2, s1, 2);
ASSERT_GT(result, 0);
}
Loading