1 // Copyright 2021 The Pigweed Authors
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License"); you may not
4 // use this file except in compliance with the License. You may obtain a copy of
5 // the License at
6 //
7 // https://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11 // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12 // License for the specific language governing permissions and limitations under
13 // the License.
14 #pragma once
15
16 #include <cstddef>
17
18 namespace pw {
19 namespace string {
20 namespace internal {
21
22 // Calculates the length of a null-terminated string up to the specified maximum
23 // length. If str is nullptr, returns 0.
24 //
25 // This function is a constexpr version of C11's strnlen_s.
26 //
27 // WARNING: this will return a length even if the string is NOT null-terminated!
28 // ClampedCString and NullTerminatedLength are recommended which are built on
29 // top of this.
ClampedLength(const char * str,size_t max_len)30 constexpr size_t ClampedLength(const char* str, size_t max_len) {
31 size_t length = 0;
32
33 if (str != nullptr) {
34 for (; length < max_len; ++length) {
35 if (str[length] == '\0') {
36 break;
37 }
38 }
39 }
40
41 return length;
42 }
43
44 } // namespace internal
45 } // namespace string
46 } // namespace pw
47