| OLD | NEW |
| 1 // Copyright (c) 2010 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2010 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ | 5 #ifndef PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ |
| 6 #define PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ | 6 #define PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ |
| 7 | 7 |
| 8 #include "ppapi/c/pp_bool.h" | 8 #include "ppapi/c/pp_bool.h" |
| 9 #include "ppapi/c/pp_instance.h" | 9 #include "ppapi/c/pp_instance.h" |
| 10 #include "ppapi/c/pp_macros.h" |
| 10 #include "ppapi/c/pp_stdint.h" | 11 #include "ppapi/c/pp_stdint.h" |
| 11 #include "ppapi/c/pp_var.h" | 12 #include "ppapi/c/pp_var.h" |
| 12 | 13 |
| 13 #define PPB_URLUTIL_DEV_INTERFACE "PPB_UrlUtil(Dev);0.2" | 14 #define PPB_URLUTIL_DEV_INTERFACE "PPB_UrlUtil(Dev);0.3" |
| 14 | 15 |
| 15 // A component specifies the range of the part of the URL. The begin specifies | 16 // A component specifies the range of the part of the URL. The begin specifies |
| 16 // the index into the string of the first character of that component. The len | 17 // the index into the string of the first character of that component. The len |
| 17 // specifies the length of that component. | 18 // specifies the length of that component. |
| 18 // | 19 // |
| 19 // This range does not include any special delimiter for that component, so | 20 // This range does not include any special delimiter for that component, so |
| 20 // the scheme doesn't include the trailing colon, the username and password | 21 // the scheme doesn't include the trailing colon, the username and password |
| 21 // don't include the @ and :, the port doesn't include the colon, the query | 22 // don't include the @ and :, the port doesn't include the colon, the query |
| 22 // doesn't include the ?, and the ref doesn't include the #. | 23 // doesn't include the ?, and the ref doesn't include the #. |
| 23 // | 24 // |
| 24 // The exception is that the path *does* include the first /, since that's an | 25 // The exception is that the path *does* include the first /, since that's an |
| 25 // integral part of the path. | 26 // integral part of the path. |
| 26 // | 27 // |
| 27 // If the component is not present at all, begin will be 0 and len will be -1. | 28 // If the component is not present at all, begin will be 0 and len will be -1. |
| 28 // If the component is present but empty, the length will be 0 instead. Example: | 29 // If the component is present but empty, the length will be 0 instead. Example: |
| 29 // http://foo/search -> query = (0, -1) | 30 // http://foo/search -> query = (0, -1) |
| 30 // http://foo/search? -> query = (18, 0) | 31 // http://foo/search? -> query = (18, 0) |
| 31 struct PP_UrlComponent_Dev { | 32 struct PP_UrlComponent_Dev { |
| 32 int32_t begin; | 33 int32_t begin; |
| 33 int32_t len; | 34 int32_t len; |
| 34 }; | 35 }; |
| 36 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_UrlComponent_Dev, 8); |
| 35 | 37 |
| 36 struct PP_UrlComponents_Dev { | 38 struct PP_UrlComponents_Dev { |
| 37 struct PP_UrlComponent_Dev scheme; | 39 struct PP_UrlComponent_Dev scheme; |
| 38 struct PP_UrlComponent_Dev username; | 40 struct PP_UrlComponent_Dev username; |
| 39 struct PP_UrlComponent_Dev password; | 41 struct PP_UrlComponent_Dev password; |
| 40 struct PP_UrlComponent_Dev host; | 42 struct PP_UrlComponent_Dev host; |
| 41 struct PP_UrlComponent_Dev port; | 43 struct PP_UrlComponent_Dev port; |
| 42 struct PP_UrlComponent_Dev path; | 44 struct PP_UrlComponent_Dev path; |
| 43 struct PP_UrlComponent_Dev query; | 45 struct PP_UrlComponent_Dev query; |
| 44 struct PP_UrlComponent_Dev ref; | 46 struct PP_UrlComponent_Dev ref; |
| 45 }; | 47 }; |
| 48 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_UrlComponents_Dev, 64); |
| 46 | 49 |
| 47 // URL encoding: URLs are supplied to this interface as NULL-terminated 8-bit | 50 // URL encoding: URLs are supplied to this interface as NULL-terminated 8-bit |
| 48 // strings. You can pass non-ASCII characters which will be interpreted as | 51 // strings. You can pass non-ASCII characters which will be interpreted as |
| 49 // UTF-8. Canonicalized URL strings returned by these functions will be ASCII | 52 // UTF-8. Canonicalized URL strings returned by these functions will be ASCII |
| 50 // except for the reference fragment (stuff after the '#') which will be | 53 // except for the reference fragment (stuff after the '#') which will be |
| 51 // encoded as UTF-8. | 54 // encoded as UTF-8. |
| 52 struct PPB_UrlUtil_Dev { | 55 struct PPB_UrlUtil_Dev { |
| 53 // Canonicalizes the given URL string according to the rules of the host | 56 // Canonicalizes the given URL string according to the rules of the host |
| 54 // browser. If the URL is invalid or the var is not a string, this will | 57 // browser. If the URL is invalid or the var is not a string, this will |
| 55 // return a Null var and the components structure will be unchanged. | 58 // return a Null var and the components structure will be unchanged. |
| (...skipping 46 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 102 | 105 |
| 103 // Checks whether the document containing the |active| plugin instance can | 106 // Checks whether the document containing the |active| plugin instance can |
| 104 // access the document containing the |target| plugin instance according to | 107 // access the document containing the |target| plugin instance according to |
| 105 // the security policy of the browser. This includes the same origin policy | 108 // the security policy of the browser. This includes the same origin policy |
| 106 // and any cross-origin capabilities enabled by the document. If either of | 109 // and any cross-origin capabilities enabled by the document. If either of |
| 107 // the plugin instances are invalid, returns PP_FALSE. | 110 // the plugin instances are invalid, returns PP_FALSE. |
| 108 PP_Bool (*DocumentCanAccessDocument)(PP_Instance active, PP_Instance target); | 111 PP_Bool (*DocumentCanAccessDocument)(PP_Instance active, PP_Instance target); |
| 109 }; | 112 }; |
| 110 | 113 |
| 111 #endif // PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ | 114 #endif // PPAPI_C_DEV_PPB_URL_UTIL_DEV_H_ |
| OLD | NEW |